级联 （预览版）
Cascade 是一个基于云的战略规划和执行平台，供团队在一个位置规划、执行、衡量和调整其策略。 将 Cascade 工作区连接到其余工具，以始终具有与策略相关的最 up-to日期和相关数据。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | 级联支持 |
| URL | https://help.cascade.app |
| support@cascade.app |
| 连接器元数据 | |
|---|---|
| 发布者 | Cascade |
| 网站 | https://www.cascade.app |
| 隐私策略 | https://www.cascade.app/privacy-policy |
| 类别 | 业务管理;协作 |
Cascade 的 Power Automate 连接器是一种极其强大的工具，可将 Cascade 实例连接到技术堆栈中的其他应用程序。 你能够创建真正自动化的工作流，以便将数据从其他工具管道传输到 Cascade，甚至提取数据。 级联目标、任务、风险和更新有完整的功能。 你希望作那些你能够与 Power Automate 一起缝合工作流以满足你的需求的方式。
先决条件
需要使用 Cascade Enterprise 计划才能使用 Power Automate。
如何获取凭据
若要获取凭据，请单击屏幕左下角部分的首字母缩写。 单击“系统”，然后单击“安全性”。 在这里，你将单击“添加令牌”，将其颁发给个人，并确保在令牌的“作用域”中包含所有选项。 然后，单击“添加令牌”，此时会显示在帐户的 API 令牌列表中。
只需复制令牌并将其用于在 Power Automate 中创建连接。 在 Power Automate 中创建连接时，请确保在令牌前面包含文本“Bearer”。 例如：
Bearer 1D22717FAF450E414523DAA4E48976SDF87SDFS8
连接器入门
由于 Cascade 连接器只有作，因此需要从其他应用程序、即时云流或计划的云流触发流。
大多数用例将围绕创建或更新 Cascade 目标与存储在另一个应用程序中的数据（例如，Microsoft SharePoint、Power BI 等）有关。 使用此功能，你将能够完全自动传输数据，因此不需要手动或双重工作。 只需级联目标的 ID，才能使用所需的信息对其进行更新。 可以将目标 ID 硬编码到流中直接更改 Cascade 目标，也可以将多个 Cascade 目标 ID 存储在数据中，以便能够在单个流中循环访问和更新多个目标。
你将选择所需的触发器，然后将 Cascade 的连接器工作到流中。 通常，你将从另一个软件中采购信息。 你将能够从前面的步骤中动态拉取数据，以自动填充 Cascade 连接器中的字段！
已知问题和限制
若要进行身份验证，需要使用 API 令牌。 若要了解如何生成令牌，请转到此链接。 如何生成 API 访问令牌
某些字段需要某些数据类型。 例如，对于所有日期字段，预期日期采用 Unix 时间或ISO8601格式。 请访问 我们的 API 文档 ，了解每个字段的预期数据类型。
必须使用 Cascade 连接器的每个步骤包含实例名称。 Cascade 实例名称 https://{yourInstanceName}.executestrategy.net/
目标、任务、风险或更新所有者由其角色 ID 决定。 这是分配给 Cascade 中特定角色的数值。 然后，将用户分配到该角色。 若要弄清楚某个用户拥有哪些角色 ID，需要向 Cascade 实例的 API 终结点（https://{yourInstanceName}.executestrategy.net/api/v2/users）发送 GET 请求。 还可以联系 Cascade 的支持电子邮件或聊天机器人，Cascade 员工可以提供该数据。
有关如何使用 Cascade 的 Power Automate 连接器的确切说明，请访问 Cascade 的帮助文章。 访问 help.cascade.app 并搜索 Power Automate
常见错误和补救措施
- 如果收到 422 不可处理的实体错误代码，则表示数据类型与预期不匹配。 或者输入了无效的数据（例如，提供帐户中不存在的角色 ID）。
FAQ
有关如何使用 Cascade 的 Power Automate 连接器的说明，请访问 Cascade 的帮助文章。 访问 help.cascade.app 并搜索 Power Automate
有关 API 的示例和文档，请访问 我们的 API 文档 。
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| API 密钥 | securestring | 此 API 的 API 密钥 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 创建任务 |
在现有级联目标上创建新任务。 |
| 创建更新 |
在现有级联目标上创建新的更新。 |
| 创建目标 |
在实例中创建新的目标。 |
| 创建风险 |
为现有级联目标创建新的风险。 |
| 删除任务 |
根据任务 ID 删除任务。 |
| 删除更新 |
根据更新 ID 删除更新。 |
| 删除目标 |
根据目标 ID 删除目标。 |
| 删除风险 |
根据风险 ID 删除风险。 |
| 更新任务 |
根据任务 ID 更新现有任务的详细信息。 |
| 更新更新 |
根据更新 ID 修改现有更新的详细信息。 |
| 更新目标 |
根据目标 ID 更新现有目标的详细信息。 |
| 更新风险 |
根据现有风险 ID 更新现有风险的详细信息。 |
| 获取单个任务 |
基于其任务 ID 返回单个任务。 |
| 获取单个更新 |
根据更新 ID 返回单个更新。 |
| 获取单个目标 |
根据目标 ID 返回单个目标。 |
| 获取单个风险 |
根据风险 ID 返回单个风险。 |
| 获取所有任务 |
返回实例中的所有任务。 |
| 获取所有更新 |
返回实例中的所有更新。 |
| 获取所有目标 |
返回实例中的所有目标。 |
| 获取所有风险 |
返回实例中的所有风险。 |
创建任务
在现有级联目标上创建新任务。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
|
任务
|
task | True | string |
任务的标题 |
|
Description
|
comment | string |
任务的说明 |
|
|
已完成
|
is_complete | integer |
任务是否已完成 |
|
|
角色 ID
|
role_id | integer |
创建任务的角色的 ID |
|
|
目标 ID
|
goal_id | True | integer |
任务关联的目标 ID |
|
开始日期
|
start_date | string |
任务的预定开始日期，采用 Unix 时间或 ISO 8601 格式 |
|
|
截止日期
|
due_date | string |
任务的预定截止日期，采用 Unix 时间或 ISO 8601 格式 |
|
|
权重 ID
|
weight_id | integer |
任务的优先级的权重。 最高优先级为 1。 最低为 4。 |
|
|
实体模板 ID
|
entity_template_id | integer |
任务模板的 ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
tasks.id | integer |
任务的 ID |
|
任务
|
tasks.task | string |
任务的标题 |
|
Description
|
tasks.comment | string |
任务的说明 |
|
已完成
|
tasks.is_complete | integer |
任务是否已完成 |
|
用户 ID
|
tasks.user_id | integer |
创建任务的用户的 ID |
|
角色 ID
|
tasks.role_id | integer |
创建任务的角色的 ID |
|
已完成的用户 ID
|
tasks.completed_user_id | string |
已完成任务的用户的 ID |
|
目标 ID
|
tasks.goal_id | integer |
任务关联的目标 ID |
|
开始日期
|
tasks.start_date | string |
任务的预定开始日期，采用 Unix 时间或 ISO 8601 格式 |
|
截止日期
|
tasks.due_date | string |
任务的预定截止日期，采用 Unix 时间或 ISO 8601 格式 |
|
权重 ID
|
tasks.weight_id | integer |
任务的优先级的权重。 最高优先级为 1。 最低为 4。 |
|
实体模板 ID
|
tasks.entity_template_id | integer |
任务模板的 ID |
创建更新
在现有级联目标上创建新的更新。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
|
注释
|
comment | True | string |
与更新关联的注释 |
|
目标 ID
|
goal_id | True | integer |
更新与 |
|
实体模板 ID
|
entity_template_id | integer |
更新模板的 ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
update.id | string |
更新的 ID |
|
类型
|
update.type | string |
更新类型 |
|
注释
|
update.comment | string |
与更新关联的注释 |
|
创建时间
|
update.created_at | string |
创建更新的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已更新时间
|
update.updated_at | string |
上次更新的日期，采用 Unix 时间或 ISO 8601 格式 |
|
用户 ID
|
update.user_id | integer |
创建更新的用户的 ID |
|
目标 ID
|
update.goal_id | integer |
更新与 |
|
已删除
|
update.deleted | integer |
是否已删除更新 |
|
实体模板 ID
|
update.entity_template_id | integer |
更新模板的 ID |
创建目标
在实例中创建新的目标。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
|
角色 ID
|
role_id | integer |
目标所属角色的 ID |
|
|
创建者 ID
|
creator_id | integer |
创建目标的用户的 ID |
|
|
状态
|
status | string |
说明目标是活动、存档还是草稿形式 |
|
|
完成条件
|
completion_criteria | string |
确定目标何时完成的条件 |
|
|
目标流
|
target_flow | string |
目标的跟踪方向 |
|
|
Action
|
action | True | string |
目标标题的第一个词 - 这通常是作词 |
|
详细信息
|
details | True | string |
提醒目标标题 - “作” 之后 |
|
初始
|
initial | double |
目标进度的初始值 |
|
|
进展
|
progress | double |
目标当前进度 |
|
|
目标
|
target | double |
目标的预期目标 |
|
|
开始时间
|
start_time | True | string |
目标的预期开始时间，采用 Unix 时间或 ISO 8601 格式 |
|
结束时间
|
end_time | True | string |
目标的预期结束时间，采用 Unix 时间或 ISO 8601 格式 |
|
权重 ID
|
weight_id | True | integer |
任务的优先级的权重。 最高优先级为 1。 最低为 4。 |
|
专用
|
is_private | integer |
目标是否为专用 |
|
|
跟踪类型
|
tracking_type | string |
用于跟踪目标的跟踪架构 |
|
|
实体模板 ID
|
entity_template_id | integer |
目标模板的 ID |
|
|
direct_focus_area_ids
|
direct_focus_area_ids | array of integer |
direct_focus_area_ids |
|
|
aligned_from_ids
|
aligned_from_ids | array of integer |
aligned_from_ids |
|
|
aligned_to_ids
|
aligned_to_ids | array of integer |
aligned_to_ids |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
角色 ID
|
goal.role_id | integer |
目标所属角色的 ID |
|
创建者 ID
|
goal.creator_id | integer |
创建目标的用户的 ID |
|
状态
|
goal.status | string |
说明目标是活动、存档还是草稿形式 |
|
完成条件
|
goal.completion_criteria | string |
确定目标何时完成的条件 |
|
目标流
|
goal.target_flow | string |
目标的跟踪方向 |
|
Action
|
goal.action | string |
目标标题的第一个词 - 这通常是作词 |
|
详细信息
|
goal.details | string |
提醒目标标题 - “作” 之后 |
|
初始
|
goal.initial | double |
目标进度的初始值 |
|
进展
|
goal.progress | double |
目标当前进度 |
|
目标
|
goal.target | double |
目标的预期目标 |
|
开始时间
|
goal.start_time | string |
目标的预期开始时间，采用 Unix 时间或 ISO 8601 格式 |
|
结束时间
|
goal.end_time | string |
目标的预期结束时间，采用 Unix 时间或 ISO 8601 格式 |
|
权重 ID
|
goal.weight_id | integer |
目标优先级的权重。 最高优先级为 1。 最低为 4。 |
|
专用
|
goal.is_private | integer |
目标是否为专用 |
|
跟踪类型
|
goal.tracking_type | string |
用于跟踪目标的跟踪架构 |
|
创建时间
|
goal.created_at | string |
创建目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已更新时间
|
goal.updated_at | string |
上次更新目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
实体模板 ID
|
goal.entity_template_id | integer |
目标模板的 ID |
|
direct_focus_area_ids
|
goal.direct_focus_area_ids | array of integer |
direct_focus_area_ids |
|
inherited_focus_area_ids
|
goal.inherited_focus_area_ids | array of integer |
inherited_focus_area_ids |
|
aligned_from_ids
|
goal.aligned_from_ids | array of integer |
aligned_from_ids |
|
aligned_to_ids
|
goal.aligned_to_ids | array of integer |
aligned_to_ids |
|
Title
|
goal.title | string |
目标的完整标题和截止日期 |
|
ancestor_ids
|
goal.ancestor_ids | array of integer |
ancestor_ids |
|
descendant_ids
|
goal.descendant_ids | array of integer |
descendant_ids |
|
issue_ids
|
goal.issue_ids | array of integer |
issue_ids |
|
task_ids
|
goal.task_ids | array of integer |
task_ids |
创建风险
为现有级联目标创建新的风险。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
|
問题
|
issue | True | string |
风险标题 |
|
关键
|
is_critical | integer |
风险是否关键 |
|
|
已解决
|
is_resolved | integer |
是否解决风险 |
|
|
角色 ID
|
role_id | integer |
创建风险的角色的 ID |
|
|
目标 ID
|
goal_id | True | integer |
与风险关联的目标 ID |
|
截止日期
|
due_date | string |
创建目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
|
实体模板 ID
|
entity_template_id | integer |
目标模板的 ID |
|
|
可能性
|
CA1573011281053 | integer |
风险的可能性 |
|
|
后果
|
CA1573011296755 | integer |
风险的后果 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
风险 ID
|
issue.id | string |
风险 ID |
|
問题
|
issue.issue | string |
风险标题 |
|
关键
|
issue.is_critical | integer |
风险是否关键 |
|
已解决
|
issue.is_resolved | integer |
是否解决风险 |
|
用户 ID
|
issue.user_id | integer |
创建风险的用户的 ID |
|
角色 ID
|
issue.role_id | integer |
创建风险的角色的 ID |
|
目标 ID
|
issue.goal_id | integer |
与风险关联的目标 ID |
|
截止日期
|
issue.due_date | string |
创建目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
实体模板 ID
|
issue.entity_template_id | integer |
目标模板的 ID |
|
可能性
|
issue.custom_attributes.CA1573011281053 | integer |
风险的可能性 |
|
后果
|
issue.custom_attributes.CA1573011296755 | integer |
风险的后果 |
删除任务
根据任务 ID 删除任务。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
任务 ID
|
id | True | string |
要删除的任务的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
消息
|
message | string |
消息 |
|
代码
|
code | integer |
代码 |
|
状态
|
status | string |
状态 |
删除更新
根据更新 ID 删除更新。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
更新 ID
|
id | True | string |
要删除的更新的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
消息
|
message | string |
消息 |
|
代码
|
code | integer |
代码 |
|
状态
|
status | string |
状态 |
删除目标
根据目标 ID 删除目标。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
目标 ID
|
id | True | string |
要删除的目标的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
消息
|
message | string |
消息 |
|
代码
|
code | integer |
代码 |
|
状态
|
status | string |
状态 |
删除风险
根据风险 ID 删除风险。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
风险 ID
|
id | True | string |
要删除的风险的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
消息
|
message | string |
消息 |
|
代码
|
code | integer |
代码 |
|
状态
|
status | string |
状态 |
更新任务
根据任务 ID 更新现有任务的详细信息。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
任务 ID
|
id | True | string |
要更新的任务的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
|
任务
|
task | string |
任务的标题 |
|
|
Description
|
comment | string |
任务的说明 |
|
|
已完成
|
is_complete | integer |
任务是否已完成 |
|
|
角色 ID
|
role_id | integer |
创建任务的角色的 ID |
|
|
目标 ID
|
goal_id | integer |
任务关联的目标 ID |
|
|
开始日期
|
start_date | string |
任务的预定开始日期，采用 Unix 时间或 ISO 8601 格式 |
|
|
截止日期
|
due_date | string |
任务的预定截止日期，采用 Unix 时间或 ISO 8601 格式 |
|
|
权重 ID
|
weight_id | integer |
任务的优先级的权重。 最高优先级为 1。 最低为 4。 |
|
|
实体模板 ID
|
entity_template_id | integer |
任务模板的 ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
task.id | integer |
任务的 ID |
|
任务标题
|
task.task | string |
任务标题 |
|
注释
|
task.comment | string |
批注的文本 |
|
创建时间
|
task.created_at | string |
创建任务的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已完成
|
task.is_complete | integer |
任务是否完成。 0 = 否;1 = 是 |
|
已完成时间
|
task.completed_at | string |
任务完成时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已更新时间
|
task.updated_at | string |
上次更新任务时，采用 Unix 时间或 ISO 8601 格式 |
|
用户 ID
|
task.user_id | integer |
拥有任务的用户的 ID |
|
角色 ID
|
task.role_id | integer |
拥有任务的角色的 ID |
|
已完成的用户 ID
|
task.completed_user_id | integer |
已完成任务的用户的 ID |
|
目标 ID
|
task.goal_id | integer |
任务所在的目标 ID |
|
开始日期
|
task.start_date | string |
目标的预期开始日期，采用 Unix 时间或 ISO 8601 格式 |
|
截止日期
|
task.due_date | string |
任务到期日期（采用 Unix 时间或 ISO 8601 格式） |
|
权重 ID
|
task.weight_id | integer |
任务优先级的权重。 最高优先级为 1。 最低为 4。 |
|
实体模板 ID
|
task.entity_template_id | integer |
任务模板的 ID |
更新更新
根据更新 ID 修改现有更新的详细信息。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
更新 ID
|
id | True | string |
要修改的更新的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
|
注释
|
comment | string |
与更新关联的注释 |
|
|
创建时间
|
created_at | string |
创建更新的日期，采用 Unix 时间或 ISO 8601 格式 |
|
|
已更新时间
|
updated_at | string |
上次更新的日期，采用 Unix 时间或 ISO 8601 格式 |
|
|
目标 ID
|
goal_id | integer |
更新与 |
|
|
已删除
|
deleted | integer |
是否已删除更新 |
|
|
实体模板 ID
|
entity_template_id | integer |
更新模板的 ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
update.id | integer |
更新的 ID |
|
类型
|
update.type | string |
更新类型 |
|
注释
|
update.comment | string |
与更新关联的注释 |
|
创建时间
|
update.created_at | string |
创建更新的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已更新时间
|
update.updated_at | string |
上次更新的日期，采用 Unix 时间或 ISO 8601 格式 |
|
用户 ID
|
update.user_id | integer |
创建更新的用户的 ID |
|
目标 ID
|
update.goal_id | integer |
更新与 |
|
已删除
|
update.deleted | integer |
是否已删除更新 |
|
实体模板 ID
|
update.entity_template_id | integer |
更新模板的 ID |
更新目标
根据目标 ID 更新现有目标的详细信息。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
目标 ID
|
id | True | string |
要更新的目标的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
|
角色 ID
|
role_id | integer |
目标所属角色的 ID |
|
|
创建者 ID
|
creator_id | integer |
创建目标的用户的 ID |
|
|
状态
|
status | string |
说明目标是活动、存档还是草稿形式 |
|
|
完成条件
|
completion_criteria | string |
确定目标何时完成的条件 |
|
|
目标流
|
target_flow | string |
目标的跟踪方向 |
|
|
Action
|
action | string |
目标标题的第一个词 - 这通常是作词 |
|
|
详细信息
|
details | string |
提醒目标标题 - “作” 之后 |
|
|
初始
|
initial | double |
目标进度的初始值 |
|
|
进展
|
progress | double |
目标当前进度 |
|
|
目标
|
target | double |
目标的预期目标 |
|
|
开始时间
|
start_time | string |
目标的预期开始时间，采用 Unix 时间或 ISO 8601 格式 |
|
|
结束时间
|
end_time | string |
目标的预期结束时间，采用 Unix 时间或 ISO 8601 格式 |
|
|
权重 ID
|
weight_id | integer |
任务的优先级的权重。 最高优先级为 1。 最低为 4。 |
|
|
专用
|
is_private | integer |
目标是否为专用 |
|
|
跟踪类型
|
tracking_type | string |
用于跟踪目标的跟踪架构 |
|
|
实体模板 ID
|
entity_template_id | integer |
目标模板的 ID |
|
|
direct_focus_area_ids
|
direct_focus_area_ids | array of integer |
direct_focus_area_ids |
|
|
inherited_focus_area_ids
|
inherited_focus_area_ids | array of integer |
inherited_focus_area_ids |
|
|
aligned_from_ids
|
aligned_from_ids | array of integer |
aligned_from_ids |
|
|
aligned_to_ids
|
aligned_to_ids | array of integer |
aligned_to_ids |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
目标 ID
|
goal.id | integer |
目标 ID |
|
角色 ID
|
goal.role_id | integer |
目标所属角色的 ID |
|
创建者 ID
|
goal.creator_id | integer |
创建目标的用户的 ID |
|
状态
|
goal.status | string |
说明目标是活动、存档还是草稿形式 |
|
完成条件
|
goal.completion_criteria | string |
确定目标何时完成的条件 |
|
目标流
|
goal.target_flow | string |
目标的跟踪方向 |
|
Action
|
goal.action | string |
目标标题的第一个词 - 这通常是作词 |
|
详细信息
|
goal.details | string |
提醒目标标题 - “作” 之后 |
|
初始
|
goal.initial | double |
目标进度的初始值 |
|
进展
|
goal.progress | double |
目标当前进度 |
|
目标
|
goal.target | double |
目标的预期目标 |
|
开始时间
|
goal.start_time | string |
目标的预期开始时间，采用 Unix 时间或 ISO 8601 格式 |
|
结束时间
|
goal.end_time | string |
目标的预期结束时间，采用 Unix 时间或 ISO 8601 格式 |
|
权重 ID
|
goal.weight_id | integer |
目标优先级的权重。 最高优先级为 1。 最低为 4。 |
|
专用
|
goal.is_private | integer |
目标是否为专用 |
|
跟踪类型
|
goal.tracking_type | string |
用于跟踪目标的跟踪架构 |
|
创建时间
|
goal.created_at | string |
创建目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已更新时间
|
goal.updated_at | string |
上次更新目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
实体模板 ID
|
goal.entity_template_id | integer |
目标模板的 ID |
|
direct_focus_area_ids
|
goal.direct_focus_area_ids | array of integer |
direct_focus_area_ids |
|
inherited_focus_area_ids
|
goal.inherited_focus_area_ids | array of integer |
inherited_focus_area_ids |
|
aligned_from_ids
|
goal.aligned_from_ids | array of integer |
aligned_from_ids |
|
aligned_to_ids
|
goal.aligned_to_ids | array of integer |
aligned_to_ids |
|
Title
|
goal.title | string |
目标的完整标题和截止日期 |
|
ancestor_ids
|
goal.ancestor_ids | array of integer |
ancestor_ids |
|
descendant_ids
|
goal.descendant_ids | array of integer |
descendant_ids |
|
issue_ids
|
goal.issue_ids | array of integer |
issue_ids |
|
task_ids
|
goal.task_ids | array of integer |
task_ids |
更新风险
根据现有风险 ID 更新现有风险的详细信息。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
风险 ID
|
id | True | string |
要更新的风险的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
|
問题
|
issue | string |
风险标题 |
|
|
关键
|
is_critical | integer |
风险是否关键 |
|
|
已解决
|
is_resolved | integer |
是否解决风险 |
|
|
角色 ID
|
role_id | integer |
创建风险的角色的 ID |
|
|
截止日期
|
due_date | string |
创建目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
|
实体模板 ID
|
entity_template_id | integer |
风险模板的 ID |
|
|
可能性
|
CA1573011281053 | integer |
风险的可能性 |
|
|
后果
|
CA1573011296755 | integer |
风险的后果 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
問题
|
issue.issue | integer |
风险标题 |
|
关键
|
issue.is_critical | integer |
风险是否关键 |
|
已解决
|
issue.is_resolved | integer |
是否解决风险 |
|
用户 ID
|
issue.user_id | integer |
创建风险的用户的 ID |
|
角色 ID
|
issue.role_id | integer |
创建风险的角色的 ID |
|
目标 ID
|
issue.goal_id | integer |
与风险关联的目标 ID |
|
截止日期
|
issue.due_date | string |
创建目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
实体模板 ID
|
issue.entity_template_id | integer |
目标模板的 ID |
|
可能性
|
issue.custom_attributes.CA1573011281053 | integer |
风险的可能性 |
|
后果
|
issue.custom_attributes.CA1573011296755 | integer |
风险的后果 |
获取单个任务
基于其任务 ID 返回单个任务。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
任务 ID
|
id | True | string |
要检索的任务的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
task.id | integer |
任务的 ID |
|
任务标题
|
task.task | string |
任务标题 |
|
Description
|
task.comment | string |
任务的说明 |
|
创建时间
|
task.created_at | string |
创建任务的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已完成
|
task.is_complete | integer |
任务是否完成。 0 = 否;1 = 是 |
|
已完成时间
|
task.completed_at | string |
任务完成时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已更新时间
|
task.updated_at | string |
上次更新任务时，采用 Unix 时间或 ISO 8601 格式 |
|
用户 ID
|
task.user_id | integer |
拥有任务的用户的 ID |
|
角色 ID
|
task.role_id | integer |
拥有任务的角色的 ID |
|
已完成的用户 ID
|
task.completed_user_id | integer |
已完成任务的用户的 ID |
|
目标 ID
|
task.goal_id | integer |
任务所在的目标 ID |
|
开始日期
|
task.start_date | string |
目标的预期开始日期，采用 Unix 时间或 ISO 8601 格式 |
|
截止日期
|
task.due_date | string |
任务到期日期（采用 Unix 时间或 ISO 8601 格式） |
|
权重 ID
|
task.weight_id | integer |
任务优先级的权重。 最高优先级为 1。 最低为 4。 |
|
实体模板 ID
|
task.entity_template_id | integer |
任务模板的 ID |
获取单个更新
根据更新 ID 返回单个更新。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
更新 ID
|
id | True | string |
要检索的更新的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
update.id | integer |
更新的 ID |
|
类型
|
update.type | string |
更新类型 |
|
注释
|
update.comment | string |
与更新关联的注释 |
|
创建时间
|
update.created_at | string |
创建更新的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已更新时间
|
update.updated_at | string |
上次更新的日期，采用 Unix 时间或 ISO 8601 格式 |
|
用户 ID
|
update.user_id | integer |
创建更新的用户的 ID |
|
目标 ID
|
update.goal_id | integer |
更新与 |
|
已删除
|
update.deleted | integer |
是否已删除更新 |
|
实体模板 ID
|
update.entity_template_id | integer |
更新模板的 ID |
获取单个目标
根据目标 ID 返回单个目标。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
目标 ID
|
id | True | string |
要检索的目标的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
目标 ID
|
goal.id | integer |
目标 ID |
|
角色 ID
|
goal.role_id | integer |
目标所属角色的 ID |
|
创建者 ID
|
goal.creator_id | integer |
创建目标的用户的 ID |
|
状态
|
goal.status | string |
说明目标是活动、存档还是草稿形式 |
|
完成条件
|
goal.completion_criteria | string |
确定目标何时完成的条件 |
|
目标流
|
goal.target_flow | string |
目标的跟踪方向 |
|
Action
|
goal.action | string |
目标标题的第一个词 - 这通常是作词 |
|
详细信息
|
goal.details | string |
提醒目标标题 - “作” 之后 |
|
初始
|
goal.initial | double |
目标进度的初始值 |
|
进展
|
goal.progress | double |
目标当前进度 |
|
目标
|
goal.target | double |
目标的预期目标 |
|
开始时间
|
goal.start_time | string |
目标的预期开始时间，采用 Unix 时间或 ISO 8601 格式 |
|
结束时间
|
goal.end_time | string |
目标的预期结束时间，采用 Unix 时间或 ISO 8601 格式 |
|
权重 ID
|
goal.weight_id | integer |
目标优先级的权重。 最高优先级为 1。 最低为 4。 |
|
专用
|
goal.is_private | integer |
目标是否为专用 |
|
跟踪类型
|
goal.tracking_type | string |
用于跟踪目标的跟踪架构 |
|
创建时间
|
goal.created_at | string |
创建目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已更新时间
|
goal.updated_at | string |
上次更新目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
实体模板 ID
|
goal.entity_template_id | integer |
目标模板的 ID |
|
direct_focus_area_ids
|
goal.direct_focus_area_ids | array of integer |
direct_focus_area_ids |
|
inherited_focus_area_ids
|
goal.inherited_focus_area_ids | array of integer |
inherited_focus_area_ids |
|
aligned_from_ids
|
goal.aligned_from_ids | array of integer |
aligned_from_ids |
|
aligned_to_ids
|
goal.aligned_to_ids | array of integer |
aligned_to_ids |
|
Title
|
goal.title | string |
目标的完整标题和截止日期 |
|
ancestor_ids
|
goal.ancestor_ids | array of integer |
ancestor_ids |
|
descendant_ids
|
goal.descendant_ids | array of integer |
descendant_ids |
|
issue_ids
|
goal.issue_ids | array of integer |
issue_ids |
|
task_ids
|
goal.task_ids | array of integer |
task_ids |
获取单个风险
根据风险 ID 返回单个风险。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
风险 ID
|
id | True | string |
要检索的风险的 ID。 |
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
风险 ID
|
issue.id | integer |
风险 ID |
|
Title
|
issue.issue | string |
风险标题 |
|
关键
|
issue.is_critical | integer |
风险是否关键 |
|
已解决
|
issue.is_resolved | integer |
是否解决风险 |
|
创建时间
|
issue.created_at | string |
创建风险的日期，采用 Unix 时间或 ISO 8601 格式 |
|
用户 ID
|
issue.user_id | integer |
创建风险的用户的 ID |
|
角色 ID
|
issue.role_id | integer |
与创建风险关联的角色的 ID |
|
目标 ID
|
issue.goal_id | integer |
与风险关联的目标 ID |
|
截止日期
|
issue.due_date | string |
风险的预期截止日期，采用 Unix 时间或 ISO 8601 格式 |
|
实体模板 ID
|
issue.entity_template_id | integer |
风险模板的 ID |
|
可能性
|
issue.custom_attributes.CA1573011281053 | integer |
风险的可能性 |
|
后果
|
issue.custom_attributes.CA1573011296755 | integer |
风险后果 |
获取所有任务
返回实例中的所有任务。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
任务
|
tasks | array of object |
任务 |
|
ID
|
tasks.id | integer |
任务的 ID |
|
任务
|
tasks.task | string |
任务的标题 |
|
Description
|
tasks.comment | string |
任务的说明 |
|
已完成
|
tasks.is_complete | integer |
任务是否已完成 |
|
用户 ID
|
tasks.user_id | integer |
创建任务的用户的 ID |
|
角色 ID
|
tasks.role_id | integer |
创建任务的角色的 ID |
|
已完成的用户 ID
|
tasks.completed_user_id | integer |
已完成任务的用户的 ID |
|
目标 ID
|
tasks.goal_id | integer |
任务关联的目标 ID |
|
开始日期
|
tasks.start_date | string |
任务的预定开始日期，采用 Unix 时间或 ISO 8601 格式 |
|
截止日期
|
tasks.due_date | string |
任务的预定截止日期，采用 Unix 时间或 ISO 8601 格式 |
|
权重 ID
|
tasks.weight_id | integer |
任务的优先级的权重。 最高优先级为 1。 最低为 4。 |
|
实体模板 ID
|
tasks.entity_template_id | integer |
任务模板的 ID |
获取所有更新
返回实例中的所有更新。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
update.id | integer |
更新的 ID |
|
类型
|
update.type | string |
更新类型 |
|
注释
|
update.comment | string |
与更新关联的注释 |
|
创建时间
|
update.created_at | string |
创建更新的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已更新时间
|
update.updated_at | string |
上次更新的日期，采用 Unix 时间或 ISO 8601 格式 |
|
用户 ID
|
update.user_id | integer |
创建更新的用户的 ID |
|
目标 ID
|
update.goal_id | integer |
更新与 |
|
已删除
|
update.deleted | integer |
是否已删除更新 |
|
实体模板 ID
|
update.entity_template_id | integer |
更新模板的 ID |
获取所有目标
返回实例中的所有目标。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
目标 ID
|
goal.id | integer |
目标 ID |
|
角色 ID
|
goal.role_id | integer |
目标所属角色的 ID |
|
创建者 ID
|
goal.creator_id | integer |
创建目标的用户的 ID |
|
状态
|
goal.status | string |
说明目标是活动、存档还是草稿形式 |
|
完成条件
|
goal.completion_criteria | string |
确定目标何时完成的条件 |
|
目标流
|
goal.target_flow | string |
目标的跟踪方向 |
|
Action
|
goal.action | string |
目标标题的第一个词 - 这通常是作词 |
|
详细信息
|
goal.details | string |
提醒目标标题 - “作” 之后 |
|
初始
|
goal.initial | double |
目标进度的初始值 |
|
进展
|
goal.progress | double |
目标当前进度 |
|
目标
|
goal.target | double |
目标的预期目标 |
|
开始时间
|
goal.start_time | string |
目标的预期开始时间，采用 Unix 时间或 ISO 8601 格式 |
|
结束时间
|
goal.end_time | string |
目标的预期结束时间，采用 Unix 时间或 ISO 8601 格式 |
|
权重 ID
|
goal.weight_id | integer |
目标优先级的权重。 最高优先级为 1。 最低为 4。 |
|
专用
|
goal.is_private | integer |
目标是否为专用 |
|
跟踪类型
|
goal.tracking_type | string |
用于跟踪目标的跟踪架构 |
|
创建时间
|
goal.created_at | string |
创建目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
已更新时间
|
goal.updated_at | string |
上次更新目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
实体模板 ID
|
goal.entity_template_id | integer |
目标模板的 ID |
|
direct_focus_area_ids
|
goal.direct_focus_area_ids | array of integer |
direct_focus_area_ids |
|
inherited_focus_area_ids
|
goal.inherited_focus_area_ids | array of integer |
inherited_focus_area_ids |
|
aligned_from_ids
|
goal.aligned_from_ids | array of integer |
aligned_from_ids |
|
aligned_to_ids
|
goal.aligned_to_ids | array of integer |
aligned_to_ids |
|
Title
|
goal.title | string |
目标的完整标题和截止日期 |
|
ancestor_ids
|
goal.ancestor_ids | array of integer |
ancestor_ids |
|
descendant_ids
|
goal.descendant_ids | array of integer |
descendant_ids |
|
issue_ids
|
goal.issue_ids | array of integer |
issue_ids |
|
task_ids
|
goal.task_ids | array of integer |
task_ids |
获取所有风险
返回实例中的所有风险。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
级联实例
|
Instance | True | string |
https://{instance}.executestrategy.net - 级联实例名称是网站 URL 的子域部分。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
风险 ID
|
issue.id | integer |
风险的 ID |
|
問题
|
issue.issue | string |
风险标题 |
|
关键
|
issue.is_critical | integer |
风险是否关键 |
|
已解决
|
issue.is_resolved | integer |
是否解决风险 |
|
用户 ID
|
issue.user_id | integer |
创建风险的用户的 ID |
|
角色 ID
|
issue.role_id | integer |
创建风险的角色的 ID |
|
目标 ID
|
issue.goal_id | integer |
与风险关联的目标 ID |
|
截止日期
|
issue.due_date | string |
创建目标时的日期，采用 Unix 时间或 ISO 8601 格式 |
|
实体模板 ID
|
issue.entity_template_id | integer |
目标模板的 ID |
|
可能性
|
issue.custom_attributes.CA1573011281053 | integer |
风险的可能性 |
|
后果
|
issue.custom_attributes.CA1573011296755 | integer |
风险的后果 |