全新开发Flow

Fow为可视化流程编排，以API的形式对外提供服务。

场景描述

本节中介绍如何创建名为“GetResourceListFlow”的Flow，由Script封装而来，用于生成资源列表中的数据，模拟用户可下载的资源。

另一个场景是通过Flow订阅事件，具体操作请参考订阅事件。

前提条件

• 已创建名为“Approved Resource”的Object，用于存储资源数据。

  该对象中需要包含如下字段。

  字段标签	字段名称 （系统自动生成）	字段类型	取值	读写权限	是否加入界面布局	含义
  ownerId	ownerId__CST	文本	长度：255	全选	不勾选	资源拥有者ID
  ResourceName	ResourceName__CST	文本	长度：255	全选	不勾选	资源名称
  Type	Type__CST	选项列表	枚举值如下： File Folder	全选	不勾选	资源类型
  SubmitDate	SubmitDate__CST	日期/时间	不涉及	全选	不勾选	资源提交时间
  ApproveDate	ApproveDate__CST	日期/时间	不涉及	全选	不勾选	资源审批时间
  Status	Status__CST	选项列表	枚举值如下： Waiting Submitted Approved	全选	不勾选	审批状态

• 已创建场景描述中的脚本。该脚本根据对象的数据生成资源列表数据，用于前台数据呈现。示例脚本为ResourceListScript.zip，可供下载参考。

操作步骤

1. 鼠标放在APP下的Logic文件夹旁会出现加号，单击加号，选择“流”。

2. 系统弹出“添加流程”的对话框，选择“创建一个新的流”，填入Flow名称等信息，单击“添加”。

   “添加流程”页面参数如下：

   • 标签：Flow展示名称。
   • 名称：输入“标签”值后单击该参数的输入框，系统会自动名称。
   • 类型：Flow类型，分为Autolaunched Flow（无界面输出的图元）、和Event Trigger（事件触发）。这里选择“Autolaunched Flow”。
   • 描述：可选参数，Flow描述信息。

   图 1 单击“Create New”
   

3. 创建该Flow的入参和出参变量。由于该Flow封装的是“ResourceListScript”脚本，则该Flow的入参和出参的字段类型和字段名与“ResourceListScript”脚本保持一致。

   此步骤需要创建如下变量。

   表 1 Flow变量

   变量类型	参数名	Data Type	Input/Output Type
   普通变量Variable	ownerId	text	Input Only
   	limit	number	Input Only
   	offset	number	Input Only
   	totalCount	number	Output Only
   结构体变量Struct	resource	struct	Output Only

   1. 在Flow编辑器页面右侧选择。在私有结构体页面单击“新增”。

      创建输出参数结构体类型变量“resource”前，首先需要创建私有结构体类型。

      图 2 添加私有结构体类型
      

   2. 设置页面参数。

      • 在“基本信息”中输入结构体名字、描述信息。
      • 在“结构体成员”中设置自定义成员变量，包括设置成员变量的名称、数据类型、是否必填、是否是集合、描述信息等。单击“新增”可增加成员变量。成员变量需要和“ResourceListScript”脚本中定义的出参“resource”成员变量保持一致。

      创建私有结构体后，您可创建私有结构体变量。

      图 3 配置私有结构体
      

   3. 在Flow编辑器页面右侧选择。在全局上下文页面单击“对象变量”后的加号。

   4. 选择“私有结构体”，设置页面参数。

      图 4 配置私有结构体变量
      

      表 2 私有结构体变量参数说明

      参数名称	解释说明
      名称	该结构体变量名称，与“ResourceListScript”脚本中定义的出参命名保持一致。 配置为“resource”。
      私有结构体	选择刚创建的结构体类型名称“resourcestruct”。
      默认值	变量的默认取值。
      描述	该变量的描述说明。
      是否为数组	是否为数组型变量即集合变量。请勾选。

   5. 在Flow编辑器页面右侧选择。在全局上下文页面单击“变量”后的加号。

      图 5 创建变量
      

   6. 单击新增变量后的“...”，选择“设置”。

      图 6 设置变量
      

   7. 配置普通变量“ownerId”。

      图 7 配置变量
      

      表 3 普通变量参数说明

      参数名称	解释说明
      名称	变量名称，必填。
      数据类型	变量的数据类型。必填。支持以下几种。 文本 数字 货币 日期 日期/时间 复选框
      默认值	变量的默认取值。
      描述	该变量的描述说明。
      是否为数组	是否为数组型变量即集合变量。

   8. 参考3.e~3.g步骤配置表1中其他普通变量。

   9. 在Flow编辑器页面右侧选择，按照表1从全局上下文页面中拖曳参数到相应的入参和出参区域。设置Flow的入参和出参。

      图 8 设置Flow的入参和出参
      

1. 拖拽“基本”下“脚本”图标至画布中，松开鼠标左键。

2. 如图9所示设置页面参数。将Flow中的变量赋值给脚本中的输入参数，脚本中的输出参数赋值给Flow中的变量。

   图 9 配置脚本
   

   表 4 脚本配置参数说明

   参数	说明
   脚本	调用的脚本名称，选择“ResourceListScript”。 只有在激活状态下的脚本才能被Flow调用。
   输入参数/目标	脚本的输入参数名称，在下拉框中选择输入参数的名称。
   输入参数/源	Flow中的变量，为目标赋值。请从“全局上下文”中拖曳之前创建的Flow输入变量。
   输出参数/源	脚本的输出参数名称。
   输出参数/目标	Flow中的变量，脚本中的输出参数赋值给Flow中的变量。请从“全局上下文”中拖曳之前创建的Flow输出变量。

   说明：
   若有多个输入参数或者输出参数，单击“新增行”进行添加。

3. 连接所有元素。

   

4. 单击，保存Flow。

5. 单击，输入入参后运行Flow。

   在“输入参数”中输入如下参数：

   { 
      "ownerId":"123", 
      "limit":3, 
      "offset":1
   }
   

6. 检查输出页签的结果是否符合预期。

   {
     "interviewId": "002N000000P4ApgMJOM4",
     "outputs": {
       "resource": [
         {
           "ownerId": "123",
           "resourceName": "Folder01",
           "status": "Waiting",
           "type": "Folder"
         },
         {
           "ownerId": "123",
           "resourceName": "File02",
           "status": "Waiting",
           "type": "File"
         },
         {
           "ownerId": "123",
           "resourceName": "Folder02",
           "status": "Waiting",
           "type": "Folder"
         }
       ],
       "totalCount": 100
     }
   }
   

7. 单击Flow编辑器页面上方图标，激活Flow。