配置工作流

文本由 Phrase Language AI 从英语机器翻译而得。

要继续示例工作流，需要进行配置。

可以通过点击编辑参数在配置选项卡上，或右键单击块并选择编辑参数来打开编辑参数窗口，访问块配置。一旦块有了参数，添加参数按钮会切换为编辑参数。

要配置示例的块，请按照以下步骤操作：

打开编辑参数窗口以进行列出区域操作。

访问令牌和项目字段将需要在运行时解析的动态值。

点击的链接图标以获取访问令牌字段，并选择获取访问令牌操作。

链接变为绿色，字段可以被编辑。
访问引用触发器或操作属性的语法为：
```
{{$.path.to.value}}
```
对于获取访问令牌的输出为：
```
{ "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }
```
使得访问令牌字段所需的表达式为{{$.tokens.strings_token}}。
点击的链接图标以获取项目字段，并选择上传：创建触发器。

链接变为绿色，字段可以被编辑。

上传：创建触发器的输出类似于：

{
  "branch": {
    "name": "my_branch"
  },
  "event": "uploads:create",
  "message": "用户-1 初始化文件上传 file.yml 在项目 name_1672734591_11 中的分支 my_branch\n",
  "project": {
    "created_at": "2023-01-03 08:29:51 UTC",
    "id": "abcdabcdabcdabcd-11",
    "main_format": "yml",
    "name": "name_1672734591_10",
    "point_of_contact": null,
    "project_image_url": null,
    "slug": "name_1672734591_10",
    "updated_at": "2023-01-03 08:29:51 UTC"
  },
  "upload": {
    "created_at": "2023-01-03 08:29:48 UTC",
    "filename": "file.yml",
    "format": "yml",
    "id": "upload-1",
    "state": "initialized",
    "summary": {},
    "tag": null,
    "updated_at": "2023-01-03 08:29:48 UTC"
  },
  "user": {
    "gravatar_uid": "29a2d1baa67d4ea524cf0f247f7bbb94",
    "id": "9c365b9a6f77c247c3de959f6152b231",
    "name": "乔·六包",
    "username": "user-1"
  }
}

使得项目字段所需的表达式为{{$.project.id}}。

点击保存。

编辑参数窗口关闭，操作的参数被保存。

项目的默认区域是创建工作的必要条件，通过将ID传递给创建工作操作。使用jq转换JSON操作接受JSON输入，应用指定的筛选器，然后再次输出JSON。
1. 在操作选项卡的工作流块窗口中，搜索phrase-jq。
  
  将使用jq转换JSON操作块拖放到列出区域操作下方以连接它们。
2. 打开编辑参数窗口以配置使用jq转换JSON操作。
3. 从输入类型下拉字段中选择JSON。
4. 单击的链接图标以获取输入字段，并选择列出区域操作。
  
  链接变为绿色，字段可以被编辑。
5. 输入字段接受JSON输入。一个特殊的固定表达式（@而不是$）确保引用操作的整个输出被传递到该字段中。
  
  在输入字段中输入表达式{{@.outputs.result}}。
6. 单击的链接图标以获取Jq字段，并选择列出区域操作。
  
  链接变为绿色，字段可以被编辑。
7. 一个筛选器，用于列出区域的列表，返回一个新列表，包含所有默认属性为true的元素，这是必需的。
  
  每个项目只能有一个默认区域，并且列表中有一个可识别且必需的元素。该元素可以通过.[0]数组语法直接访问。
  
  在Jq字段中输入表达式map(select(.default))|.[0]。
8. 点击保存。
  
  编辑参数窗口关闭，操作的参数被保存。
创建工作操作现在可以配置，并将使用之前块中的模式。
1. 点击的链接图标以获取访问令牌字段，并选择获取访问令牌操作。
  
  链接变为绿色，字段可以被编辑。
  
  输入表达式{{$.tokens.strings_token}}。
2. 点击的链接图标以获取项目字段，并选择上传：创建触发器。
  
  链接变为绿色，字段可以被编辑。
  
  输入表达式{{$.project.id}}。
3. 单击的链接图标以获取源区域字段，并选择使用jq转换JSON操作。
  
  链接变为绿色，字段可以被编辑。
  
  输入表达式{{@.outputs.result}}。
4. 截止日期可以通过sprig或Expr函数计算，但为了本示例的目的，将使用API理解的硬编码日期。
  
  在截止日期字段中，输入2023-12-31T12:00:00Z。
5. 点击保存。
  
  配置已保存，详细信息可以在配置选项卡中查看。
每个操作可以有一个或多个条件，结合逻辑与和或。这些条件在运行时进行评估，只有当条件评估为真时，操作及其子项才会执行。

在示例中，选择创建工作操作时，点击编辑条件从条件选项卡，或右键单击该块并选择编辑条件。

编辑条件窗口打开。
1. 按照之前块的模式，将变量字段链接到上传：创建触发器，并输入表达式{{$.upload.tag}}。
2. 从第一个下拉列表中选择非以反转语句。
3. 从比较下拉列表中选择为空。
4. 点击保存。
  
  条件显示在条件选项卡上。
如果上传不包含标签（意味着没有新的/更新的键/翻译），工作流将在此处停止。
现在工作需要目标区域。为了示例的目的，将创建两个区域；一个用于西班牙语（es-ES），一个用于德语（de-DE）。区域将添加到使用jq转换JSON操作中的两个编辑参数窗口中，如步骤3所示。
1. 在两个操作的输入字段中，输入表达式{{@.outputs.result}}，链接到列出区域操作并保存参数。
2. 在一个操作的Jg字段中，输入表达式map(select(.name == "es-ES"))|.[0]并链接到列出区域操作。
  
  保存参数。
3. 在第二个操作中，输入表达式map(select(.name == "de-DE"))|.[0]并链接到列出区域操作。
  
  保存参数。
区域现在将应用于工作创建。

使用之前定义的相同模式配置两个将目标区域添加到工作操作。
工作现在可以开始。

使用与之前定义的相同模式配置开始一个工作操作。