获取项目操作从已连接的 Jira 应用程序中检索特定项目或所有项目的详细信息。 该操作检索用户可访问的项目的详细信息。
概览
获取项目操作包含过滤器选项,允许您定义过滤器条件,该操作根据这些条件检索详细信息。 当您指定项目密钥时,该操作会检索指定项目密钥的详细信息。 如果项目密钥留空,该操作会检索用户可访问的所有项目的详细信息。 可用的过滤器包括查询、类型密钥和展开。 该操作会将检索到的信息存储在指定变量中,以便在自动化会话中的下游操作中使用。
注: 确保在继续配置获取项目操作之前,先添加并配置连接操作,因为连接操作会为自动化会话提供身份验证上下文。
设置
以下设置适用于此操作:
- 会话名称(可选)
- 指定连接操作创建的会话名称。 会话名称用作该操作的身份验证上下文。 根据连接设置选择以下两个选项之一。
- 会话名称: 选择存储会话名称的字符串变量,或在文本框中手动输入会话名称。 当您添加该操作时,该操作会将 Default 设置为会话名称。
- 变量: 选择会话变量。
- 项目密钥(可选)
- 指定要检索的项目的密钥。 例如 PROJ。 将此字段留空,以检索用户可访问的所有项目。
- 查询(可选)
- 指定用于根据项目名称或项目密钥筛选项目的字符串。 该操作检索名称或密钥包含指定字符串的项目的详细信息。 例如,指定 mobile 以检索名称包含字符串
mobile的项目的详细信息。 - 类型密钥(可选)
- 指定基于项目类型密钥的过滤器。 该过滤器支持以下值:business service_desk 和 software。
- 展开(可选)
- 指定要检索并包含在响应数据中的附加信息。 该过滤器支持以下附加参数:
- description - 添加此选项会包含项目的描述。
- projectKeys - 添加此选项会包含项目的密钥。
- lead - 添加此选项会包含项目负责人的详细信息。
- issueTypes - 添加此选项会包含与项目关联的所有问题类型的详细信息。
- url - 添加此选项会包含与项目关联的 URL。
- insights - 添加此选项会包含洞察详情,例如总问题数以及与项目关联的最后一个问题的更新时间。
- 最大结果数(可选)
- 指定该操作在单次响应中检索的项目的最大数量。 默认值为 50,最大值为 100。
- 开始位置(可选)
- 指定分页偏移索引。 该操作会跳过从 0 到指定数字的已索引的项目,并返回其余结果。 该过滤器与最大结果数选项配合使用。 例如,在一个包含 50 个项目的 Jira 应用程序中,如果您指定 10,该操作会跳过前 10 个项目(索引 0 到 9),并检索从索引 10 开始直到最大结果数中指定值结束的项目的详细信息。 默认值为 0。
- 将响应分配到变量
- 指定在操作检索项目详细信息后用于存储响应数据的输出变量。 以下密钥在响应数据中可用:
-
projectList- 此密钥包含项目密钥中指定的项目的全部详细信息。 -
totalCount- 此密钥包含基于已定义过滤器的项目总数。
您可以使用以下两个选项之一来存储响应数据:
-
多个变量: 创建并指定单独的变量以存储特定的响应数据。
使用添加变量映射选项来指定键和值对应的变量类型,以存储特定的响应数据。
- 字典: 创建并指定一个字典变量以存储完整的响应数据。
-