共用方式為

敏捷點 NX

AgilePoint 是一個開放雙向通訊的平台，為更大、更具可擴展性的跨組織自動化中的流程提供本機支援。 現在，您可以將 Microsoft 生態系統中執行的重要日常工作包含在 AgilePoint 中的整體流程中。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 AgilePoint 支援團隊
URL https://helpdesk.agilepoint.com
Email helpdesk@agilepoint.com
連接器中繼資料
Publisher 敏捷點公司
網站 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 應用程式開發平台，該平台在雲端或內部部署系統中執行。 提供 AgilePoint NX 應用程序開發平台的 30 天免費試用。 持續使用 AgilePoint NX 需要有效訂閱。

如何取得認證

如果您沒有有效的 AgilePoint NX 訂閱，您可以通過填寫您的信息 https://agilepoint.com來註冊 AgilePoint NX 的 30 天免費試用。 您也可以透過聯絡 sales@agilepoint.com來獲得試用訂閱。 一旦您的試用訂閱請求獲得批准，您將收到一封來自 AgilePoint 的電子郵件，其中包含有關如何完成試用註冊的說明。 請在註冊新訂閱時選擇 AgilePoint ID 身份驗證類型，這將允許您指定所需的用戶名和密碼。

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有區域 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
用戶名稱 securestring 輸入agilepoint nx伺服器的使用者名稱（domain\username）。 對
密碼 securestring 輸入 agilepoint nx 伺服器的密碼。 對
AgilePoint NX 伺服器 URL （REST） 字串 輸入 agilepoint nx 伺服器 URL。 對

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

儲存資料

將程序屬性 （自訂屬性） 清單設定為指定自訂屬性 ID 的指定值。
取得使用者

擷取指定註冊使用者的設定檔資訊。
取得流程模型

擷取所有流程模型 （流程定義） 的所有版本。
取得程序實例

擷取指定程序實例的相關資訊。
取得資料

擷取具有指定處理程序屬性 ID 和處理程序屬性名稱的處理程序屬性 （自訂屬性）。
啟動程序實例

為指定的程序實例 ID 和參數建立程序實例。
完成人類任務

完成指定的人工作業 （手動工作項目） ，並在資料庫中將其狀態變更為 已完成。
完成系統工作

完成指定的系統活動 （自動工作項目）。
產生新的 Guid

擷取 AgilePoint Server 所產生的 UUID。

儲存資料

作業識別碼：
SetCustomAttrs

將程序屬性 （自訂屬性） 清單設定為指定自訂屬性 ID 的指定值。

參數

名稱 機碼 必要 類型 Description
ID
 CUSTOMID True string

輸入自訂 ID。
名稱
 Name string

輸入屬性名稱。
價值觀
 Value string

輸入屬性值。

取得使用者

作業識別碼：
GetRegisteredUserbyName

擷取指定註冊使用者的設定檔資訊。

參數

名稱 機碼 必要 類型 Description
用戶名稱
 userName True string

以 （Domain\Username） 格式輸入使用者名稱。

傳回

名稱 路徑 類型 Description
部門
 Department string

使用者的部門名稱。
Disabled
 Disabled boolean

指定使用者是否已停用。
電子郵件地址
 EMailAddress string

使用者的電子郵件地址。
全名
 FullName string

使用者的完整名稱。
Locale
 Locale string

用戶端裝置的地區設定。
經理
 Manager string

使用者管理員的全名。
在線聯繫
 OnlineContact string

擷取使用者的線上聯絡人。
參考標識碼
 RefID string

使用者的參考 ID。
註冊日期
 RegisteredDate string

擷取使用者在 AgilePoint NX 中註冊的日期。
支援的語言
 SupportedLanguage string

擷取支援的語言清單。
時區
 TimeZone string

使用者的時區。
Title
 Title string

使用者的職稱。
使用者工作階段到期
UALExpirationDate string

使用者工作階段到期的日期和時間。
使用者工作階段永不過期
 UALNeverExpires boolean

指定使用者的工作階段是否永遠不會過期 （亦即，使用者具有具名授權基座）。
UserName
 UserName string

執行個體的限定使用者名稱。
使用者組織資訊
 UserOrgInfo string

擷取使用者組織的相關資訊，例如描述。
工作行事曆識別碼
 WorkCalendarID string

組織工作行事曆的唯一識別碼。

取得流程模型

作業識別碼：
ProcessDefinition

擷取所有流程模型 （流程定義） 的所有版本。

傳回

名稱 路徑 類型 Description
GetProcDefs結果
 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

應用程式的描述。
Diagnostic
 GetProcDefsResult.Diagnostic boolean

指定在程序完成之後，是否要從資料庫中刪除程序資料。
文件參考
 GetProcDefsResult.DocRef string

指定文件的 URL。 這通常用於流程設計人員的內部文件。
營業時間
 GetProcDefsResult.ExpectedTime.BusinessTime boolean

指定系統是否使用您的工作時間行事曆來計算工期。
長度
 GetProcDefsResult.ExpectedTime.Length string

指定持續時間的長度。
價值觀
 GetProcDefsResult.ExpectedTime.Unit.Value integer

單位的價值。
程序發起人
GetProcDefsResult.InitiateConstraint integer

指定程序實例是由 eForm、Event Services 或其他程序實例起始。
允許的會話數上限
 GetProcDefsResult.MaximumSessionAllowed integer

配置程序實例中活動的階段作業數目上限。 如果活動執行的次數超過階段作業上限，則會暫停處理程序。
完成時
 GetProcDefsResult.OnComplete integer

程序實例完成時要執行的動作。
所有者
 GetProcDefsResult.Owner string

應用程式擁有者的使用者名稱。
先前版本
 GetProcDefsResult.PreVersion string

應用程式的先前版本號碼。
發行日期
 GetProcDefsResult.ReleaseDate string

擷取應用程式發行的日期。
GetProcDefsResult.Status string

流程模型的狀態。
版本
 GetProcDefsResult.Version string

應用程式的版本號碼。

取得程序實例

作業識別碼：
GetProcessInstance

擷取指定程序實例的相關資訊。

參數

名稱 機碼 必要 類型 Description
程序實例 ID
 processInstanceID True string

輸入程序實例 ID。

傳回

名稱 路徑 類型 Description
應用程式名稱
 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

程序實例的識別碼，該識別碼是程序型應用程式的程序階層頂端。
版本
 GetProcInstResult.Version string

程序模型的版本號碼。
工作物件 ID
 GetProcInstResult.WorkObjectID string

與程序實例相關聯之物件 （例如文件） 的 ID。
工作對象信息
 GetProcInstResult.WorkObjectInfo string

通常此參數用來在程序實例內保存工作物件的補充資訊，例如文件的 URL。

取得資料

作業識別碼：
GetCustomAttr

擷取具有指定處理程序屬性 ID 和處理程序屬性名稱的處理程序屬性 （自訂屬性）。

參數

名稱 機碼 必要 類型 Description
ID
 CUSTOMID True string

輸入自訂 ID。
屬性名稱
 attrName True string

輸入屬性名稱。

啟動程序實例

作業識別碼：
CreateProcInst

為指定的程序實例 ID 和參數建立程序實例。

參數

名稱 機碼 必要 類型 Description
流程定義
 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 string

輸入屬性名稱。
價值觀
 Value string

輸入屬性值。

傳回

名稱 路徑 類型 Description
活動實例ID
 ActivityInstID string

活動執行個體的唯一 ID。
自動啟動
 AutoStart boolean

指定程序是否在建立後立即啟動。
Variables
 CustomAttributes array of object

XML 格式的變數。
Diagnostic
 Diagnostic boolean

指定在程序完成之後，是否要從資料庫中刪除程序資料。
結束日期
 EndDate string

委派的完成日期。
Entries
 Entries integer

擷取事件的轉送時間。
錯誤
 Error string

擷取並設定事件的錯誤訊息。
事件識別碼
 EventID string

事件的唯一識別碼。
事件名稱
 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

事件的傳送日期。
來源工作識別碼
 SourceWorkItemID string

代表原始或來源任務的 ID。
地位
 Status string

事件的狀態。
租戶識別碼
 TenantID string

AgilePoint NX 租用戶的唯一識別碼。
使用者識別碼
 UserID string

使用者的唯一識別碼。
工作識別碼
 WorkItemID string

代表工作的唯一識別碼。
工作物件 ID
 WorkObjectID string

與程序實例相關聯之物件 （例如文件） 的 ID。
工作對象信息
 WorkObjectInfo string

通常此參數用來在程序實例內保存工作物件的補充資訊，例如文件的 URL。

完成人類任務

作業識別碼：
CompleteManualWorkItem

完成指定的人工作業 （手動工作項目） ，並在資料庫中將其狀態變更為 已完成。

參數

名稱 機碼 必要 類型 Description
工作識別碼
 workItemID True string

輸入工作專案識別碼。
客戶資料
 clientData True string

輸入客戶資料。

傳回

名稱 路徑 類型 Description
活動實例ID
 ActivityInstID string

活動執行個體的唯一 ID。
自動啟動
 AutoStart boolean

指定程序是否在建立後立即啟動。
Variables
 CustomAttributes string

XML 格式的變數。
Diagnostic
 Diagnostic boolean

指定在程序完成之後，是否要從資料庫中刪除程序資料。
結束日期
 EndDate string

委派的完成日期。
Entries
 Entries integer

擷取事件的轉送時間。
錯誤
 Error string

擷取並設定事件的錯誤訊息。
事件識別碼
 EventID string

事件的唯一識別碼。
事件名稱
 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

事件的傳送日期。
來源工作識別碼
 SourceWorkItemID string

代表原始或來源任務的 ID。
地位
 Status string

事件的狀態。
租戶識別碼
 TenantID string

AgilePoint NX 租用戶的唯一識別碼。
使用者識別碼
 UserID string

使用者的唯一識別碼。
工作識別碼
 WorkItemID string

代表工作的唯一識別碼。
工作物件 ID
 WorkObjectID string

與程序實例相關聯之物件 （例如文件） 的 ID。
工作對象信息
 WorkObjectInfo string

通常此參數用來在程序實例內保存工作物件的補充資訊，例如文件的 URL。

完成系統工作

作業識別碼：
CompleteAutoWorkItem

完成指定的系統活動 （自動工作項目）。

參數

名稱 機碼 必要 類型 Description
工作識別碼
 WORKITEMID True string

輸入工作專案識別碼。

傳回

名稱 路徑 類型 Description
活動實例ID
 ActivityInstID string

活動執行個體的唯一 ID。
自動啟動
 AutoStart boolean

指定程序是否在建立後立即啟動。
Variables
 CustomAttributes array of object

XML 格式的變數。
Diagnostic
 Diagnostic boolean

指定在程序完成之後，是否要從資料庫中刪除程序資料。
結束日期
 EndDate string

委派的完成日期。
Entries
 Entries integer

擷取事件的轉送時間。
錯誤
 Error string

擷取並設定事件的錯誤訊息。
事件識別碼
 EventID string

事件的唯一識別碼。
事件名稱
 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

事件的傳送日期。
來源工作識別碼
 SourceWorkItemID string

代表原始或來源任務的 ID。
地位
 Status string

事件的狀態。
租戶識別碼
 TenantID string

AgilePoint NX 租用戶的唯一識別碼。
使用者識別碼
 UserID string

使用者的唯一識別碼。
工作識別碼
 WorkItemID string

代表工作的唯一識別碼。
工作物件 ID
 WorkObjectID string

與程序實例相關聯之物件 （例如文件） 的 ID。
工作對象信息
 WorkObjectInfo string

通常此參數用來在程序實例內保存工作物件的補充資訊，例如文件的 URL。

產生新的 Guid

作業識別碼：
GetUUID

擷取 AgilePoint Server 所產生的 UUID。

傳回

名稱 路徑 類型 Description
擷取 UUID 結果
 GetUUIDResult string

Agilepoint Server 產生的 UUID。

觸發程序

啟動程序實例時

當 AgilePoint 程序實例啟動時觸發。
執行觸發流程流程活動時

依 AgilePoint 活動觸發。

啟動程序實例時

作業識別碼：
TriggerByAgilePointProcessInstanceCreation

當 AgilePoint 程序實例啟動時觸發。

參數

名稱 機碼 必要 類型 Description
名稱
 Name True string

輸入 Webhook 名稱。
觸發器
 Triggers True array of string

觸發器。
目標應用
 TargetApplications True array of string

TargetApplications。

傳回

名稱 路徑 類型 Description
程序實例 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。

執行觸發流程流程活動時

作業識別碼：
TriggeryByAgilePointActivity

依 AgilePoint 活動觸發。

參數

名稱 機碼 必要 類型 Description
名稱
 Name string

輸入 Webhook 名稱。
觸發器
 Triggers True array of string

觸發器。
目標應用
 TargetApplications True array of string

TargetApplications。
名稱
 Name string

輸入參數名稱。
類型
 Value string

選取參數類型。

傳回

名稱 路徑 類型 Description
是非同步的
 needCallback boolean

指定是否要等待流程完成。
程序實例 ID
 processInstanceID string

程序實例的唯一 ID。
工作識別碼
 workItemID string

代表工作的唯一識別碼。
工作物件 ID
 workObjectId string

與程序實例相關聯之物件 （例如文件） 的 ID。
活動實例ID
 activityInstanceid string

活動執行個體的唯一 ID。