AgilePoint NX

AgilePoint は、双方向通信を開いて、より大規模でスケーラブルな組織間自動化内のフローのネイティブ サポートを提供するプラットフォームです。 これにより、Microsoft エコシステム内で実行される重要な日常業務を、AgilePoint に格納されている大局的なプロセスに含めることができるようになりました。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 AgilePoint サポート チーム
[URL] https://helpdesk.agilepoint.com
メール helpdesk@agilepoint.com
Connector Metadata
発行者 AgilePoint Inc
Web サイト https://agilepoint.com/
プライバシー ポリシー https://agilepoint.com/privacy-statement/
カテゴリー 生産性; ビジネス管理

AgilePoint NX Power Automate コネクタは双方向の統合であり、両方のプラットフォームのユーザーに次の柔軟性を提供します:

  • AgilePoint プロセスを実行し、Power Automate フローまたは Logic Apps からさまざまなビジネス プロセス管理アクションを実行します。
  • 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 認証の種類を選択してください。これにより、目的のユーザー名とパスワードを指定できます。

接続の作成

コネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 内容 必要
ユーザー名 securestring agilepoint nx サーバーのユーザー名 (domain\username) を入力します。
パスワード securestring agilepoint nx サーバーのパスワードを入力します。 True
AgilePoint NX サーバー URL (REST) string agilepoint nx サーバーの URL を入力します。 True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

システム タスクの完了

指定されたシステム活動 (自動作業項目) を完了します。

データの保存

プロセス属性 (カスタム属性) の一覧を、指定されたカスタム属性 ID の指定された値に設定します。

データの取得

指定されたプロセス属性 ID とプロセス属性名を持つプロセス属性 (カスタム属性) を取得します。

ヒューマン タスクの完了

指定されたヒューマン タスク (手作業項目) を完了し、データベースでその状態を完了に変更します。

プロセス インスタンスの取得

指定されたプロセス インスタンスに関する情報を取得します。

プロセス インスタンスの開始

指定されたプロセス インスタンス ID とパラメータのプロセス インスタンスを作成します。

プロセス モデルの取得

すべてのプロセス モデル (プロセス定義) のすべてのバージョンを取得します。

ユーザーの取得

指定した登録済みユーザーのプロファイル情報を取得します。

新しい GUID の生成

AgilePoint サーバーによって生成された UUID を取得します。

システム タスクの完了

指定されたシステム活動 (自動作業項目) を完了します。

パラメーター

名前 キー 必須 説明
タスク ID
WORKITEMID True string

作業項目 ID を入力します。

戻り値

名前 パス 説明
活動インスタンス ID
ActivityInstID string

活動インスタンスを表す一意識別子です。

自動起動
AutoStart boolean

プロセスが作成された直後に開始するかどうかを指定します。

変数
CustomAttributes array of object

XML 形式の変数です。

診断
Diagnostic boolean

プロセスの完了後にプロセス データをデータベースから削除するかどうかを指定します。

終了日
EndDate string

委任の完了日です。

エントリ
Entries integer

イベントのリレー時間を取得します。

エラー
Error string

イベントのエラー メッセージを取得して設定します。

イベント ID
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
Status string

イベントの状態です。

Tenant ID
TenantID string

AgilePoint NX テナントの一意 ID。

User ID
UserID string

ユーザーの一意の ID です。

Task ID
WorkItemID string

タスクを表す一意の ID です。

作業オブジェクト ID
WorkObjectID string

プロセス インスタンスに関連付けられている、ドキュメントなどのオブジェクトの ID です。

作業オブジェクトの情報
WorkObjectInfo string

通常、このパラメーターは、プロセス インスタンス内のドキュメントの URL など、作業オブジェクトに関する補足情報を保持するために使用されます。

データの保存

プロセス属性 (カスタム属性) の一覧を、指定されたカスタム属性 ID の指定された値に設定します。

パラメーター

名前 キー 必須 説明
ID
CUSTOMID True string

カスタム ID を入力します。

件名
Name string

属性名を入力します。

Value string

属性値を入力します。

戻り値

データの取得

指定されたプロセス属性 ID とプロセス属性名を持つプロセス属性 (カスタム属性) を取得します。

パラメーター

名前 キー 必須 説明
ID
CUSTOMID True string

カスタマー ID を入力します。

属性名
attrName True string

属性名を入力します。

戻り値

ヒューマン タスクの完了

指定されたヒューマン タスク (手作業項目) を完了し、データベースでその状態を完了に変更します。

パラメーター

名前 キー 必須 説明
タスク ID
workItemID True string

作業項目 ID を入力します。

クライアント データ
clientData True string

クライアント ID を入力します。

戻り値

名前 パス 説明
活動インスタンス ID
ActivityInstID string

活動インスタンスを表す一意識別子です。

自動起動
AutoStart boolean

プロセスが作成された直後に開始するかどうかを指定します。

変数
CustomAttributes string

XML 形式の変数です。

診断
Diagnostic boolean

プロセスの完了後にプロセス データをデータベースから削除するかどうかを指定します。

終了日
EndDate string

委任の完了日です。

エントリ
Entries integer

イベントのリレー時間を取得します。

エラー
Error string

イベントのエラー メッセージを取得して設定します。

イベント ID
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
Status string

イベントの状態です。

Tenant ID
TenantID string

AgilePoint NX テナントの一意 ID。

User ID
UserID string

ユーザーの一意の ID です。

Task ID
WorkItemID string

タスクを表す一意の ID です。

作業オブジェクト ID
WorkObjectID string

プロセス インスタンスに関連付けられている、ドキュメントなどのオブジェクトの ID です。

作業オブジェクトの情報
WorkObjectInfo string

通常、このパラメーターは、プロセス インスタンス内のドキュメントの URL など、作業オブジェクトに関する補足情報を保持するために使用されます。

プロセス インスタンスの取得

指定されたプロセス インスタンスに関する情報を取得します。

パラメーター

名前 キー 必須 説明
プロセス インスタンス 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 とパラメータのプロセス インスタンスを作成します。

パラメーター

名前 キー 必須 説明
プロセス定義
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

属性値を入力します。

戻り値

名前 パス 説明
活動インスタンス ID
ActivityInstID string

活動インスタンスを表す一意識別子です。

自動起動
AutoStart boolean

プロセスが作成された直後に開始するかどうかを指定します。

変数
CustomAttributes array of object

XML 形式の変数です。

診断
Diagnostic boolean

プロセスの完了後にプロセス データをデータベースから削除するかどうかを指定します。

終了日
EndDate string

委任の完了日です。

エントリ
Entries integer

イベントのリレー時間を取得します。

エラー
Error string

イベントのエラー メッセージを取得して設定します。

イベント ID
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
Status string

イベントの状態です。

Tenant ID
TenantID string

AgilePoint NX テナントの一意 ID。

User ID
UserID string

ユーザーの一意の ID です。

Task ID
WorkItemID string

タスクを表す一意の ID です。

作業オブジェクト ID
WorkObjectID string

プロセス インスタンスに関連付けられている、ドキュメントなどのオブジェクトの ID です。

作業オブジェクトの情報
WorkObjectInfo string

通常、このパラメーターは、プロセス インスタンス内のドキュメントの URL など、作業オブジェクトに関する補足情報を保持するために使用されます。

プロセス モデルの取得

すべてのプロセス モデル (プロセス定義) のすべてのバージョンを取得します。

戻り値

名前 パス 説明
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

プロセス モデルの表示名です。

内容
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、Event Services、または別のプロセス インスタンスによって開始されたかどうかを指定します。

最大許容セッション数
GetProcDefsResult.MaximumSessionAllowed integer

プロセス インスタンス内の活動の最大セッション数を構成します。 活動が最大セッション数よりも多く実行される場合、プロセスは一時停止されます。

OnComplete
GetProcDefsResult.OnComplete integer

プロセス インスタンスが完了したときに実行するアクションです。

担当者
GetProcDefsResult.Owner string

アプリ所有者のユーザー名です。

以前のバージョン
GetProcDefsResult.PreVersion string

アプリの以前のバージョン番号です。

リリース日
GetProcDefsResult.ReleaseDate string

アプリがリリースされた日付を取得します。

GetProcDefsResult.Status string

プロセス モデルの状態です。

バージョン
GetProcDefsResult.Version string

アプリのバージョン番号です。

ユーザーの取得

指定した登録済みユーザーのプロファイル情報を取得します。

パラメーター

名前 キー 必須 説明
ユーザー名
userName True string

ユーザー名を (Domain\Username) 形式で入力します。

戻り値

名前 パス 説明
部署
Department string

ユーザーの部署名です。

いいえ
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 string

ユーザーの役職です。

ユーザー セッションの有効期限
UALExpirationDate string

ユーザー セッションの有効期限が切れる日時です。

ユーザー セッション有効期限なし
UALNeverExpires boolean

ユーザーのセッションが有効期限なしになるかどうかを指定します (例 : ユーザーが名前付きライセンス シートを持っている)。

ユーザー名
UserName string

インスタンスの修飾ユーザー名です。

ユーザー組織の情報
UserOrgInfo string

ユーザーの組織に関する情報 (説明など) を取得します。

作業カレンダー ID
WorkCalendarID string

組織の作業カレンダーの一意の ID です。

新しい GUID の生成

AgilePoint サーバーによって生成された UUID を取得します。

戻り値

名前 パス 説明
UUID 結果の取得
GetUUIDResult string

AgilePoint サーバーによって生成された UUID です。

トリガー

トリガー フロー プロセス活動が実行されるとき

AgilePoint 活動によりトリガーされます。

プロセス インスタンスが開始されるとき

AgilePoint プロセス インスタンスが開始したときにトリガーします。

トリガー フロー プロセス活動が実行されるとき

AgilePoint 活動によりトリガーされます。

パラメーター

名前 キー 必須 説明
件名
Name string

webhook 名を入力します。

トリガー
Triggers True array of string

トリガー。

TargetApplications
TargetApplications True array of string

TargetApplications。

件名
Name string

パラメーター名を入力します。

タイプ
Value string

パラメーターの種類を選択します。

戻り値

名前 パス 説明
非同期
needCallback boolean

フローが完了するのを待つかどうかを指定します。

プロセス インスタンス ID
processInstanceID string

プロセス インスタンスの一意の ID です。

タスク ID
workItemID string

タスクを表す一意の ID です。

作業オブジェクト ID
workObjectId string

プロセス インスタンスに関連付けられている、ドキュメントなどのオブジェクトの ID です。

活動インスタンス ID
activityInstanceid string

活動インスタンスを表す一意識別子です。

プロセス インスタンスが開始されるとき

AgilePoint プロセス インスタンスが開始したときにトリガーします。

パラメーター

名前 キー 必須 説明
件名
Name True string

webhook 名を入力します。

トリガー
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 です。