npm 包 @steedos/standard-objects 使用教程

阅读时长 9 分钟读完

介绍

@steedos/standard-objects 是一款基于 Node.js 平台的 npm 包,能够帮助前端开发者更加方便地使用标准业务对象。该包中预置了许多业务对象模板,开发者只需要根据实际场景进行二次开发即可快速构建出符合自己需求的业务对象。

安装

在终端执行以下命令进行安装:

使用教程

引用模块

在项目中使用该模块时,需要先引用模块,如下所示:

创建业务对象

创建业务对象需要使用 create 方法,如下所示:

-- -------------------- ---- -------
----- ------ - ----- ------------------------------------- --------------- -
    ------- -
        -
            ------------- -----------------
            ---------- -------
            ------ --------------
            ------------- ---
            ---------- ----
            --------- -----
            ------- -----
        -
        -- ---------
    --
    -- ----------
---

以上示例中,object_name 为业务对象的名称,object_label 为业务对象的标签。

fields 数组中为当前业务对象预置的字段,其中:

  • fieldApiName: 字段的 API 名称,必须唯一。

  • fieldType: 字段的类型,支持的类型如下表所示:

    类型 描述
    text 文本类型,支持文本、数字和日期类型的字段
    email 电子邮件类型
    phone 电话号码类型
    url URL 类型
    picklist 下拉列表类型,支持单选列表和多选列表,需要在 picklistOptions 属性中添加选项值
    checkbox 复选框类型,只能取值 truefalse
    lookup 查找类型,支持关联其他业务对象或系统用户。
  • label: 字段的标签名称。

  • defaultValue: 字段默认值。

  • maxLength: 字段最大长度。

  • required: 字段是否必填。

  • unique: 字段是否唯一。

除了 fields 之外,还可以添加其他配置项:

  • description: 对象的描述信息。
  • icon_name: 对象图标名称。
  • enable_bulk_api: 是否开启批量 API。
  • enable_change_log: 是否启用数据变更记录。

添加记录

在业务对象创建完成并进行配置之后,就可以往对象中添加新的记录了,如下所示:

其中,field_api_name 为业务对象中的字段 API 名称,field_value 为该字段对应的值。

查询记录

从业务对象中查询记录时,可以使用 find 方法,如下所示:

-- -------------------- ---- -------
----- ------- - ----- -------------
    ------- -
        --------------- -------------
        -- -----------
    --
    ------ ---
    ----- -
        --------------- ----- -- ---- ----- -- ------
        -- -----------
    -
---

其中,filter 用于设置查询条件,limit 用于限制返回结果的数量,sort 用于设置排序方式。

修改记录

要修改业务对象中的现有记录,需要使用 update 方法,如下所示:

其中,record._id 为需要修改的记录 ID。

删除记录

要从业务对象中删除记录,可以使用 remove 方法,如下所示:

其中,record._id 为需要删除的记录 ID。

示例代码

下面是一个完整的示例代码,实现了一个简单的任务管理系统:

-- -------------------- ---- -------
----- --------------- - ---------------------------------------

-- ------
----- ---------- - ----- ------------------------------ ----- -
    ------- -
        -
            ------------- -------
            ---------- -------
            ------ -------
            ------------- ---
            ---------- ----
            --------- -----
            ------- -----
        --
        -
            ------------- --------------
            ---------- -------
            ------ -------
            ------------- ---
            ---------- -----
            --------- ------
            ------- -----
        --
        -
            ------------- -----------
            ---------- -----------
            ------ ------
            ------------- ---------
            ---------- ----
            --------- -----
            ------- ------
            ---------------- -
                - ------ --------- ------ ---- --
                - ------ ------- ------ --- --
                - ------ --------- ------ ---- -
            -
        --
        -
            ------------- ---------
            ---------- -----------
            ------ -----
            ------------- ------
            ---------- ----
            --------- -----
            ------- ------
            ---------------- -
                - ------ ------ ------ ---- --
                - ------ -------------- ------ ----- --
                - ------ ------------ ------ ----- -
            -
        -
    --
    ------------------ ----
---

-- -----
----- ------- - ----- -----------------
    ----- -------
    ------------ ------- - --------
    --------- -------
    ------- -----
---

-- ------
----- -------- - ----- -----------------
    ------- -
        --------- ------
    --
    ------ ---
    ----- -
        ----------- -----
    -
---

-- ----
----- ------------------------------ -
    ------------ ------- - -------
---

-- ----
----- -------------------------------

总结

通过以上使用教程和示例代码,相信读者已经掌握了 npm 包 @steedos/standard-objects 的使用方法。该包能够帮助开发者快速构建出符合自己需求的业务对象,提高开发效率。如果您在使用过程中遇到了问题,欢迎在下方评论区留言,笔者会及时回复。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/205758