PREVIEW

处理应用程序任务

本教程将指导您完成构建应用程序任务的过程，该过程涉及以下阶段：

• 创建操作定义并将其上传到 Action Center。
• 在 Apps 中开发操作应用程序，并为操作定义中定义的每个属性设置字段。
• 使用“创建应用程序任务”活动在 Studio 网页版或 Studio 桌面版中发布应用程序并创建工作流。

1. 创建并上传操作定义

要将操作字段链接到应用程序，您必须创建一个 JSON 架构，称为操作定义。 此定义概述了必填操作字段，并指定完成操作时可用的允许操作。

1. 准备操作定义：
   1. 首先添加左大括号以指明 JSON 对象的开头。
   2. 在 JSON 对象中，将Name和Description属性及其值定义为字符串。

      "Name": "Validate Document",
          "Description": "Validate and approve invoice",

   3. 添加Allowed Actions属性作为字符串数组，以指定您可以在操作末尾执行的允许操作。 这些值应等于“完成”或“拒绝”。

      "AllowedActions": [
              "Yes",
              "No"
          ],

   4. 添加Schema属性，并为其分配一个符合 JSON 架构标准的对象： http://json-schema.org/draft-07/schema# 。

      "Schema": {
              "$schema": "http://json-schema.org/draft-07/schema#",
              "type": "object",

   5. 在“ properties ”对象中，定义要包含在架构中的每个属性。 为每个属性指定其type和description 。
      Schema中的每个属性都等效于您将在“应用程序”操作中添加的输入字段。

      "properties": {
                  "Description": {
                      "type": "string",
                      "direction": "in",
                      "description": "Validation message"
                  },
                  "invoice_document": {
                      "type": "string",
                      "direction": "in",
                      "description": "Document file."
                  },
                  "Comments": {
                      "type": "string",
                      "direction": "inout",
                      "description": "Approval or rejection comments"
                  }
              }

      注意：如果未定义direction属性，则其默认值为inout ( In/Out )。
   6. 如果某些属性是必需的，请包括一个required数组，您可以在其中列出要在操作中标记为必需的属性。
   7. 通过添加右大括号将 JSON 对象括起。
2. 将操作定义上传到 Action Center：
   1. 打开 Action Center，导航到“管理员设置” ，然后选择 “租户”。
   2. 在 “操作定义”选项卡中，选择“添加操作定义” 。
   3. 选择“下载操作定义示例”以下载示例 JSON 架构，以帮助您准备操作定义。
   4. 选择“从文件导入” ，然后选择您之前准备的 JSON 文件。
   5. 输入操作定义的适当名称和说明，然后选择“创建” 。

2. 创建 Actions 应用程序

使用操作集成创建的 Apps 专为在长时间运行的工作流中使用而设计，最终用户只能通过与生成的操作进行交互来访问这些应用程序。

1. 在您上传了操作定义的组织中打开 Apps。
2. 从头开始创建新应用程序，或选择适合您需求的预制模板。
3. 在“添加控件” 旁边，选择“添加任何”，然后选择“操作” 。
   此步骤允许您指定此应用程序的操作定义。 在此示例中，我们使用Validate Document操作定义。
4. 选择您先前上传了操作定义的租户，然后选择“下一步” 。
5. 在“添加操作”对话框的左侧，选择已创建的操作定义，然后单击“添加” 。
   
   

   

   
   

   访问在应用程序中引用操作定义，详细了解如何在 Action Apps 中使用操作定义。

6. 现在，您可以开始向应用程序添加控件。
   确保应用程序控件的名称与操作定义的 JSON 架构中使用的名称完全一致。 例如，如果包含一个文档查看器控件来显示操作定义中的invoice_document属性，请将该控件命名为invoice_document 。
   可以使用以下语法将操作的输入或输出参数绑定到任何应用程序控件： Actions.<referenced_action_name>.<action_parameter_name>
   1. 创建一个空白页面并向其中添加布局。
   2. 在“布局” 中，添加一个“容器”，您可以在其中添加文本框和图像控件，以显示验证文档的公司的客户名称和徽标。
   3. 在“布局” 中，添加一个“容器” ，以在其中放置“文档查看器”控件。
   4. 创建一个名为var_invoice_file 的变量，并将其添加为“ 文档查看器” 控件的“ 来源 ”活动。
   5. 在布局中添加另一个容器，您可以在其中的左侧添加一个文本区域。 在以下表达式中的“默认”文本中键入： Actions.Validate_Document.Comments 。
   6. 添加两个负责完成操作的“按钮”控件，并配置规则以提交操作，这与操作定义中指定的Allowed Actions相对应：
      1. 转到“事件”，然后选择“创建规则”。
      2. 从下拉列表菜单中，选择 “提交操作”。
      3. 在“操作结果”下，选择希望按钮在单击时触发的允许操作： Yes或No 。

      访问规则：提交操作以了解此特定规则。

7. 建立指向存储桶的链接，您将在其中上传文档，然后将其作为操作的一部分转发。
8. 发布应用程序，使其可以在 Studio 工作流中使用。

   访问发布 Actions 应用程序，详细了解发布 Actions 应用程序的流程。

注意：（可选）如果要替换用于应用程序的操作，请访问替换操作。

3. 在工作流中创建应用程序任务

在 Studio 网页版或 Studio 桌面版中创建工作流，以通过 Google 云端硬盘帐户下载发票文档。 将下载的文档上传到绑定到操作应用程序的存储桶。 接下来，添加“用户操作” /“应用程序操作”活动，以显示特定文档以供用户批准或拒绝。 将任务分配给用户，等待操作完成，然后继续执行工作流。 记录详细说明用户对文档的验证决策的消息。

1. 在 Studio 中创建一个新项目。
2. 添加“下载文件”活动。
   1. 在活动中建立与 Google 云端硬盘的连接。
   2. 在“要下载的文件”字段中，指定要下载的文件的名称。
   3. 在“输出”部分下，创建一个变量以存储下载的文件。
      对于此示例，将变量命名为downloadFile 。
3. 添加“上传存储文件”活动，以将文件上传到与操作应用程序关联的存储桶中。
   1. 从“ Orchestrator 文件夹路径” 和“存储桶名称” 中，选择要上传文件的 Orchestrator 文件夹路径和存储桶。
   2. 在“文件” 字段中，输入将下载的文件存储到的变量。
      在此示例中，输入downloadFile 。
   3. 在“上传位置”/“路径”字段中，输入表达式downloadFile.FullName.toString以将文件保存在存储桶中。
      提示：您可以将此表达式存储在变量中。
   
   

   

   
   
4. 添加“创建应用程序任务”活动以创建操作。
   1. 相应地设置“标题” 和“优先级”。
   2. 对于Apps ，选择本教程前面创建的 Action 应用程序。
   3. 使用适当的变量填充生成的字段。
   4. 在输出部分下，创建一个UserActionData变量，以存储与生成的操作相关的数据。
      在此示例中，将变量命名为taskID 。
5. 添加“分配任务”活动，以将任务分配给组织内的用户。
   1. 在“任务 ID ” 字段中，输入一个表达式，该表达式从在步骤 4 的子步骤 d 中创建的输出变量中检索任务 ID。
      在此示例中，输入以下表达式： taskID.Id.Value 。
   2. 在“用户名或电子邮件” 字段中，输入要将此操作分配给的用户的用户名或电子邮件地址。
   
   

   

   
   
6. 添加“等待应用程序任务然后继续”活动，以等待用户完成操作，然后继续工作流。
   1. 在“创建的应用程序任务” 字段中，输入在步骤 4 的子步骤 d 中创建的输出变量。
   2. 在“采取的操作”字段中，创建一个变量（例如： userActionTaken ），以存储用户为完成任务而采取的操作类型。
7. 添加“日志消息”活动，以打印用户为完成任务而采取的操作类型。 使用"The action that user used to complete the Validate Invoice action was " + userActionTaken.ToString等表达式
   
   

   

   
   

工作流示例

要按照步骤自行尝试本教程，请在此处下载示例 Studio 桌面项目。 如要在 Studio Web 中打开该项目，请将项目保存到 Cloud，然后在 Studio Web 中查看该项目以将其打开。