通过

AgilePoint NX

AgilePoint 是一个平台，可打开双向通信，为大型、更具可缩放的跨组织自动化中的流提供本机支持。 现在，你可以在 AgilePoint 中的大局流程中包括Microsoft生态系统中执行的重要日常任务。

此连接器在以下产品和区域中可用：

服务 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 AgilePoint 支持团队
URL https://helpdesk.agilepoint.com
Email helpdesk@agilepoint.com
连接器元数据
发布者 AgilePoint Inc
网站 https://agilepoint.com/
隐私策略 https://agilepoint.com/privacy-statement/
类别 生产力;业务管理

AgilePoint NX Power Automate 连接器是双向集成，使两个平台的用户能够灵活地：

  • 执行 AgilePoint 流程，并从 Power Automate 流或逻辑应用执行各种业务流程管理作。
  • 从 AgilePoint 启动 Power Automate 流。

借助这一新连接器，AgilePoint 客户可以利用 Power Automate 的大型连接器和触发器生态系统，使许多云事件（包括物联网和业务线事件）无需代码即可与 AgilePoint 交互。

同时，Power Automate 用户有权在 Power Automate 流设计器中访问对 AgilePoint NX 企业级低代码业务流程管理功能的更本机支持。 这种合作关系提供强大的协同效应，为客户提供了巨大的机会。

先决条件

AgilePoint NX 连接器需要订阅 AgilePoint NX 应用开发平台，该平台在云或本地系统中运行。 可以使用 30 天免费试用版 AgilePoint NX 应用开发平台。 持续使用 AgilePoint NX 需要有效的订阅。

如何获取凭据

如果没有有效的 AgilePoint NX 订阅，可以通过填写相关信息 https://agilepoint.com注册 30 天的 AgilePoint NX 免费试用版。 还可以通过联系获取 sales@agilepoint.com试用订阅。 试用订阅请求获得批准后，你将收到来自 AgilePoint 的电子邮件，其中包含有关如何完成试用注册的说明。 请在注册新订阅时选择 AgilePoint ID 身份验证类型，以便指定所需的用户名和密码。

创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
用户名 securestring 输入 agilepoint nx 服务器的用户名（域\用户名）。 True
密码 securestring 输入 agilepoint nx 服务器的密码。 True
AgilePoint NX 服务器 URL （REST） 字符串 输入 agilepoint nx 服务器 URL。 True

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

保存数据

将进程属性（自定义属性）的列表设置为指定自定义属性 ID 的指定值。
启动进程实例

为指定的进程实例 ID 和参数创建进程实例。
完成人工任务

完成指定的人工任务（手动工作项），并将其状态更改为数据库中的“已完成”。
完成系统任务

完成指定的系统活动（自动工作项）。
生成新 Guid

检索 AgilePoint Server 生成的 UUID。
获取数据

检索具有指定进程属性 ID 和进程属性名称的进程属性（自定义属性）。
获取用户

检索指定注册用户的配置文件信息。
获取进程实例

检索有关指定进程实例的信息。
获取进程模型

检索所有进程模型的所有版本（进程定义）。

保存数据

操作 ID:
SetCustomAttrs

将进程属性（自定义属性）的列表设置为指定自定义属性 ID 的指定值。

参数

名称 密钥 必需 类型 说明
ID
 CUSTOMID True string

输入自定义 ID。
Name
 Name string

输入属性名称。
价值
 Value string

输入属性值。

启动进程实例

操作 ID:
CreateProcInst

为指定的进程实例 ID 和参数创建进程实例。

参数

名称 密钥 必需 类型 说明
进程定义
 ProcessID True string

选择进程定义名称。
进程实例 ID
 ProcessInstID string

输入进程实例 ID。
进程实例名称
 ProcInstName True string

输入进程实例名称。
工作对象 ID
 WorkObjID True string

输入工作对象 ID。
工作对象信息
 WorkObjInfo string

输入对象信息。
父进程实例 ID
 SuperProcInstID string

输入父进程实例 ID。
进程发起程序
 Initiator True string

输入进程发起程序名称。
ID
 CustomID string

输入自定义 ID。
立即启动
 blnStartImmediately boolean

选择值。
Name
 Name string

输入属性名称。
价值
 Value string

输入属性值。

返回

名称 路径 类型 说明
活动实例 ID
 ActivityInstID string

活动实例的唯一 ID。
自动启动
 AutoStart boolean

指定进程是否在创建后立即启动。
Variables
 CustomAttributes array of object

XML 格式的变量。
诊断
 Diagnostic boolean

指定进程完成后是否将从数据库中删除进程数据。
结束日期
 EndDate string

委派的完成日期。
Entries
 Entries integer

检索事件的中继时间。
错误
 Error string

检索并设置事件的错误消息。
事件编号
 EventID string

事件的唯一 ID。
事件名称
 EventName string

事件名称。
高优先级
 HighPriority boolean

指定任务标记为高优先级。
XML 参数
 ParamsXml string

检索参数并将其设置为 XML。
父进程实例 ID
 ParentProcInstID string

一个进程实例 ID，充当要创建的进程实例的父进程实例。
进程模型 ID
 ProcDefID string

进程模型的唯一 ID。
进程实例 ID
 ProcInstID string

进程实例的唯一 ID。
进程实例名称
 ProcInstName string

与进程实例关联的唯一名称。
发送方
 Sender string

事件的发送方。
发送日期
 SentDate string

事件的发送日期。
源任务 ID
 SourceWorkItemID string

表示原始任务或源任务的 ID。
状态
 Status string

事件的状态。
租户 ID
 TenantID string

AgilePoint NX 租户的唯一 ID。
用户 ID
 UserID string

用户的唯一 ID。
任务 ID
 WorkItemID string

表示任务的唯一 ID。
工作对象 ID
 WorkObjectID string

与进程实例关联的对象（如文档）的 ID。
工作对象信息
 WorkObjectInfo string

通常，此参数用于在进程实例中保存有关工作对象的补充信息，例如文档的 URL。

完成人工任务

操作 ID:
CompleteManualWorkItem

完成指定的人工任务（手动工作项），并将其状态更改为数据库中的“已完成”。

参数

名称 密钥 必需 类型 说明
任务 ID
 workItemID True string

输入工作项 ID。
客户端数据
 clientData True string

输入客户端数据。

返回

名称 路径 类型 说明
活动实例 ID
 ActivityInstID string

活动实例的唯一 ID。
自动启动
 AutoStart boolean

指定进程是否在创建后立即启动。
Variables
 CustomAttributes string

XML 格式的变量。
诊断
 Diagnostic boolean

指定进程完成后是否将从数据库中删除进程数据。
结束日期
 EndDate string

委派的完成日期。
Entries
 Entries integer

检索事件的中继时间。
错误
 Error string

检索并设置事件的错误消息。
事件编号
 EventID string

事件的唯一 ID。
事件名称
 EventName string

事件名称。
高优先级
 HighPriority boolean

指定任务标记为高优先级。
XML 参数
 ParamsXml string

检索参数并将其设置为 XML。
父进程实例 ID
 ParentProcInstID string

一个进程实例 ID，充当要创建的进程实例的父进程实例。
进程模型 ID
 ProcDefID string

进程模型的唯一 ID。
进程实例 ID
 ProcInstID string

进程实例的唯一 ID。
进程实例名称
 ProcInstName string

与进程实例关联的唯一名称。
发送方
 Sender string

事件的发送方。
发送日期
 SentDate string

事件的发送日期。
源任务 ID
 SourceWorkItemID string

表示原始任务或源任务的 ID。
状态
 Status string

事件的状态。
租户 ID
 TenantID string

AgilePoint NX 租户的唯一 ID。
用户 ID
 UserID string

用户的唯一 ID。
任务 ID
 WorkItemID string

表示任务的唯一 ID。
工作对象 ID
 WorkObjectID string

与进程实例关联的对象（如文档）的 ID。
工作对象信息
 WorkObjectInfo string

通常，此参数用于在进程实例中保存有关工作对象的补充信息，例如文档的 URL。

完成系统任务

操作 ID:
CompleteAutoWorkItem

完成指定的系统活动（自动工作项）。

参数

名称 密钥 必需 类型 说明
任务 ID
 WORKITEMID True string

输入工作项 ID。

返回

名称 路径 类型 说明
活动实例 ID
 ActivityInstID string

活动实例的唯一 ID。
自动启动
 AutoStart boolean

指定进程是否在创建后立即启动。
Variables
 CustomAttributes array of object

XML 格式的变量。
诊断
 Diagnostic boolean

指定进程完成后是否将从数据库中删除进程数据。
结束日期
 EndDate string

委派的完成日期。
Entries
 Entries integer

检索事件的中继时间。
错误
 Error string

检索并设置事件的错误消息。
事件编号
 EventID string

事件的唯一 ID。
事件名称
 EventName string

事件名称。
高优先级
 HighPriority boolean

指定任务标记为高优先级。
XML 参数
 ParamsXml string

检索参数并将其设置为 XML。
父进程实例 ID
 ParentProcInstID string

一个进程实例 ID，充当要创建的进程实例的父进程实例。
进程模型 ID
 ProcDefID string

进程模型的唯一 ID。
进程实例 ID
 ProcInstID string

进程实例的唯一 ID。
进程实例名称
 ProcInstName string

与进程实例关联的唯一名称。
发送方
 Sender string

事件的发送方。
发送日期
 SentDate string

事件的发送日期。
源任务 ID
 SourceWorkItemID string

表示原始任务或源任务的 ID。
状态
 Status string

事件的状态。
租户 ID
 TenantID string

AgilePoint NX 租户的唯一 ID。
用户 ID
 UserID string

用户的唯一 ID。
任务 ID
 WorkItemID string

表示任务的唯一 ID。
工作对象 ID
 WorkObjectID string

与进程实例关联的对象（如文档）的 ID。
工作对象信息
 WorkObjectInfo string

通常，此参数用于在进程实例中保存有关工作对象的补充信息，例如文档的 URL。

生成新 Guid

操作 ID:
GetUUID

检索 AgilePoint Server 生成的 UUID。

返回

名称 路径 类型 说明
检索 UUID 结果
 GetUUIDResult string

由 Agilepoint Server 生成的 UUID。

获取数据

操作 ID:
GetCustomAttr

检索具有指定进程属性 ID 和进程属性名称的进程属性（自定义属性）。

参数

名称 密钥 必需 类型 说明
ID
 CUSTOMID True string

输入自定义 ID。
属性名称
 attrName True string

输入属性名称。

获取用户

操作 ID:
GetRegisteredUserbyName

检索指定注册用户的配置文件信息。

参数

名称 密钥 必需 类型 说明
用户名
 userName True string

输入用户名（域\用户名）格式。

返回

名称 路径 类型 说明
Department
 Department string

用户的部门名称。
Disabled
 Disabled boolean

指定是否禁用用户。
电子邮件地址
 EMailAddress string

用户的电子邮件地址。
完整姓名
 FullName string

用户的全名。
区域设置
 Locale string

客户端设备的区域设置。
经理
 Manager string

用户的经理的完整名称。
联机联系人
 OnlineContact string

检索用户的联机联系人。
引用 ID
 RefID string

用户的引用 ID。
已注册日期
 RegisteredDate string

检索用户在 AgilePoint NX 中注册的日期。
支持的语言
 SupportedLanguage string

检索支持的语言列表。
时区
 TimeZone string

用户的时区。
Title
 Title string

用户的职务。
用户会话过期
UALExpirationDate string

用户会话过期的日期和时间。
用户会话永不过期
 UALNeverExpires boolean

指定用户的会话是否永不过期（即用户具有命名的许可证席位）。
UserName
 UserName string

实例的限定用户名。
用户组织信息
 UserOrgInfo string

检索有关用户组织的信息，例如说明。
工作日历 ID
 WorkCalendarID string

组织工作日历的唯一 ID。

获取进程实例

操作 ID:
GetProcessInstance

检索有关指定进程实例的信息。

参数

名称 密钥 必需 类型 说明
进程实例 ID
 processInstanceID True string

输入进程实例 ID。

返回

名称 路径 类型 说明
应用名称
 GetProcInstResult.ApplName string

应用的唯一名称。
应用显示名称
 GetProcInstResult.ApplicationDisplayName string

AgilePoint NX 应用的显示名称。
已完成日期
 GetProcInstResult.CompletedDate string

进程实例完成的日期和时间。
进程模型 ID
 GetProcInstResult.DefID string

进程模型的唯一 ID。
进程模型名称
 GetProcInstResult.DefName string

进程模型的显示名称。
截止日期数据
 GetProcInstResult.DueDate string

进程实例应完成的日期。
上次修改者
 GetProcInstResult.LastModifiedBy string

上次更新或修改该项目的用户。
上次修改日期
 GetProcInstResult.LastModifiedDate string

上次修改对进程实例的日期和时间。
上次运行结束时间
 GetProcInstResult.LastRunningEndTime string

进程实例上次停止运行的日期。
上次运行的开始时间
 GetProcInstResult.LastRunningStartTime string

上次启动或恢复进程实例的日期。
上次交换日期
 GetProcInstResult.LastSwapDate string

上次交换进程实例以释放资源。
进程发起程序
 GetProcInstResult.ProcInitiator string

启动（启动）进程的用户。
进程发起程序位置
 GetProcInstResult.ProcInitiatorLoc string

发起进程实例的用户的 IP 地址。
进程实例 ID
 GetProcInstResult.ProcInstID string

进程实例的唯一 ID。
进程实例名称
 GetProcInstResult.ProcInstName string

与进程实例关联的唯一名称。
进程模型显示名称
 GetProcInstResult.ProcessDefinitionDisplayName string

进程模型的名称。
进程发起程序
 GetProcInstResult.ProcessInitiator string

启动（启动）进程的用户。
进程发起程序位置
 GetProcInstResult.ProcessInitiatorLocation string

发起进程实例的用户的 IP 地址。
源进程实例 ID
 GetProcInstResult.SourceProcInstID string

原始进程实例或源实例的 ID。
开始日期
 GetProcInstResult.StartedDate string

启动进程实例的日期和时间（启动）。
状态
 GetProcInstResult.Status string

进程实例的状态。
父进程实例 ID
 GetProcInstResult.SuperProcInstID string

一个进程实例 ID，充当要创建的进程实例的父进程实例。
目标进程实例 ID
 GetProcInstResult.TargetProcInstID string

目标或目标进程实例的 ID。
顶级进程实例 ID
 GetProcInstResult.ToplevelProcInstID string

进程实例的 ID，该实例是基于进程的应用的进程层次结构的顶部。
版本
 GetProcInstResult.Version string

进程模型的版本号。
工作对象 ID
 GetProcInstResult.WorkObjectID string

与进程实例关联的对象（如文档）的 ID。
工作对象信息
 GetProcInstResult.WorkObjectInfo string

通常，此参数用于在进程实例中保存有关工作对象的补充信息，例如文档的 URL。

获取进程模型

操作 ID:
ProcessDefinition

检索所有进程模型的所有版本（进程定义）。

返回

名称 路径 类型 说明
GetProcDefsResult
 GetProcDefsResult array of object

所有进程模型（进程定义）的所有版本的结果。
应用名称
 GetProcDefsResult.ApplName string

AgilePoint NX 应用的显示名称。
程序集名称
 GetProcDefsResult.AssemblyName string

获取和设置程序集的全名。
审核级别
 GetProcDefsResult.AuditLevel integer

指定为进程记录的进程相关数据量。 可以在进程级别或单个活动级别设置此属性。 此属性允许你根据日志中记录的进程相关数据量来控制粒度级别。
基本定义 ID
 GetProcDefsResult.BaseDefID string

具有指定进程模型名称的基本进程模型 ID。
签出者
 GetProcDefsResult.CheckedOutBy string

上次签出应用的用户。
签出日期
 GetProcDefsResult.CheckedOutDate string

上次签出应用的日期。
类名
 GetProcDefsResult.ClassName string

获取和设置类名，包括命名空间。
创建者
 GetProcDefsResult.CreatedBy string

创建进程模型的用户名称。
创建日期
 GetProcDefsResult.CreatedDate string

创建进程模型的日期。
进程模型 ID
 GetProcDefsResult.DefID string

进程模型的唯一 ID。
进程模型名称
 GetProcDefsResult.DefName string

进程模型的显示名称。
Description
 GetProcDefsResult.Description string

应用的说明。
诊断
 GetProcDefsResult.Diagnostic boolean

指定进程完成后是否将从数据库中删除进程数据。
文档参考
 GetProcDefsResult.DocRef string

指定文档的 URL。 这通常用于进程设计器的内部文档。
业务时间
 GetProcDefsResult.ExpectedTime.BusinessTime boolean

指定系统是否使用业务时间日历计算持续时间。
长度
 GetProcDefsResult.ExpectedTime.Length string

指定持续时间的长度。
价值
 GetProcDefsResult.ExpectedTime.Unit.Value integer

单位的值。
进程启动者
GetProcDefsResult.InitiateConstraint integer

指定进程实例是由 eForm、事件服务还是另一个进程实例启动。
允许的最大会话数
 GetProcDefsResult.MaximumSessionAllowed integer

为进程实例中的活动配置最大会话数。 如果活动运行的次数超过最大会话数，则进程将暂停。
OnComplete
 GetProcDefsResult.OnComplete integer

在进程实例完成时要执行的作。
所有者
 GetProcDefsResult.Owner string

应用所有者的用户名。
以前的版本
 GetProcDefsResult.PreVersion string

应用的以前版本号。
发布日期
 GetProcDefsResult.ReleaseDate string

检索应用发布时的日期。
GetProcDefsResult.Status string

进程模型的状态。
版本
 GetProcDefsResult.Version string

应用的版本号。

触发器

启动进程实例时

启动 AgilePoint 进程实例时触发。
执行触发器流进程活动时

由 AgilePoint 活动触发。

启动进程实例时

操作 ID:
TriggerByAgilePointProcessInstanceCreation

启动 AgilePoint 进程实例时触发。

参数

名称 密钥 必需 类型 说明
Name
 Name True string

输入 Webhook 名称。
Triggers
 Triggers True array of string

触发器。
TargetApplications
 TargetApplications True array of string

TargetApplications。

返回

名称 路径 类型 说明
进程实例 ID
 Source.ProcInstID string

进程实例的唯一 ID。
进程实例名称
 Source.ProcInstName string

与进程实例关联的唯一名称。
进程发起程序
 Source.ProcessInitiator string

启动（启动）进程的用户。
进程开始日期
 Source.StartedDate string

进程实例启动的日期。
进程模型名称
 Source.DefName string

进程模型的显示名称。
应用版本
 Source.Version string

应用的版本号。
父进程实例 ID
 Source.SuperProcInstID string

一个进程实例 ID，充当要创建的进程实例的父进程实例。
工作对象 ID
 Source.WorkObjectID string

与进程实例关联的对象（如文档）的 ID。

执行触发器流进程活动时

操作 ID:
TriggeryByAgilePointActivity

由 AgilePoint 活动触发。

参数

名称 密钥 必需 类型 说明
Name
 Name string

输入 Webhook 名称。
Triggers
 Triggers True array of string

触发器。
TargetApplications
 TargetApplications True array of string

TargetApplications。
Name
 Name string

输入参数名称。
类型
 Value string

选择参数类型。

返回

名称 路径 类型 说明
是异步的
 needCallback boolean

指定是否等待流完成。
进程实例 ID
 processInstanceID string

进程实例的唯一 ID。
任务 ID
 workItemID string

表示任务的唯一 ID。
工作对象 ID
 workObjectId string

与进程实例关联的对象（如文档）的 ID。
活动实例 ID
 activityInstanceid string

活动实例的唯一 ID。