作業キュー アクション

Power Automate の作業キューを使用すると、プロセスに関連するデータを保存できるほか、複雑なプロセスと自動化を分離し、非同期で通信させる手段を提供します。

作業キューは、自動化の効率性、スケーラビリティ、回復性を向上させる上で重要な役割を果たし、作業の優先順位付けに役立ちます。 作業キューを使用すると、デジタル ワーカー、ヒューマン ワーカー、または統合によって処理されているかどうかに関係なく、最も優先度の高い項目を最初に完了できます。

作業キュー項目を処理する

作業キュー項目を処理するアクションは、コンピューターが 1 つ以上の作業キュー項目を処理する準備ができていることをキュー オーケストレーターに示します。 新しい項目を要求するユーザー コンテキストは、作業キューを処理するために、作業キューおよび作業キュー項目テーブルに対する十分な権限を持っている必要があります。

前のアクションで参照された 作業キュー は、キュー オーケストレーターによって使用され、その作業キュー内で キュー登録済み 状態にある、次に使用可能な項目を決定します。 デスクトップ フローが、このアクションがレンダリングする作業キュー項目を処理するループ内のアクションを処理するとき、プロパティ .Value とともにアクションに指定した変数を利用して、値を呼び出すことができます。 この場合、変数 %WorkQueueItem.Value% を使用して作業キュー項目の値を呼び出すことができます

Processworkqueueitemaction

作業キュー項目のアクションを処理する アクションには次の引数が必要です。

入力パラメーター

生成される変数

例外

FetchXML クエリとは何ですか?

Microsoft Dataverse FetchXML は、 Dataverse データベースからデータを取得するために使用される言語です。 簡単に作成、使用、理解できるように設計されています。 たとえば、オーケストレーターに、先入れ先出し (FIFO) とは異なる順序で、特定の有効期限内にアイテムを処理するように要求する場合があります。

FetchXML クエリのサポートを作業キューの項目の処理に限定するため、FetchXML の用語および式のうち、限定されたセットのみがサポートされています。 これらの用語には、フィルター、条件、順序付け式が含まれますが、すべて作業キュー項目テーブル (workqueueitem) に制限されます。 Queued 状態にあるアイテムのみが返されます。

FetchXML クエリの例

以下は、name でフィルター処理し、最初に期限切れになるレコード (FEFO) で結果を並べ替える方法を示すクエリ式の例です。

<filter type="and">
  <condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
  <condition attribute="name" operator="eq" value="MyNonUniqueNameString" />
</filter>
<order attribute="expirydate" descending="false" />

クエリサポートの詳細と参照データ

• 使用可能な クエリ演算子 のリスト。on-or-before、between、last-month などの演算子が含まれます。
• 作業キュー項目 テーブルで使用可能な属性のリスト。

作業キュー項目を更新する

作業キュー項目を更新するアクションを使用すると、ユーザーは選択した作業キュー項目の状態と処理結果を変更できます。

Updateworkqueueitemaction

作業キュー項目のアクションを更新する アクションには次の引数が必要です。

例外

作業キュー項目を追加する

作業キュー項目を追加するアクションでは、デスクトップ フロー ユーザーは、フロー ポータルで設定されている作業キューに作業キュー項目を追加できます。

Enqueueworkqueueitemaction

作業キュー項目の追加 アクションには次の引数が必要です。

入力パラメーター

生成される変数

例外

複数の作業キュー項目を追加する

複数の作業キュー項目の追加 アクションを使用すると、作業キュー項目データ テーブルとして提供されたデータに基づいて、1 つ以上の作業キュー項目を作業キューに追加できます。

このアクションには、1 つ以上の作業キュー項目を保持するカスタム データ テーブルが必要です。 データ テーブルには 8 つの列があり、次のスキーマに準拠している必要があります。

データテーブルを作成するための Robin コードスニペット

以下の例は、Power Automate デスクトップ デザイナー ウィンドウに直接コピーして貼り付けることができる、ロビンコード (従来のフローで使用される) のスニペットです。 このスニペットは、予想されるフィールド セットを含む 新しいデータ テーブルの作成 アクションをフローに追加します。

Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable

データ テーブルを作成するための PowerFx コード スニペット

以下の例は、Power Automate デスクトップ のデザイナー ウィンドウに直接コピーして貼り付けることができる PowerFx のコード スニペットです。 このスニペットは、予想されるフィールド セットを含む 新しいデータ テーブルの作成 アクションをフローに追加します。

Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx''] } DataTable=> DataTable

Batchenqueueworkqueueitemsaction

作業キュー項目を複数追加する アクションには、次の引数が必要です。

入力パラメーター

生成される変数

例外

遅延した項目を再キューに入れる

遅延した項目を再キューに入れる アクションを使用すると、ユーザーはデスクトップ フローで処理中のキュー項目を元のキューに再度追加できます。 さらに、キューに入れられた項目は、定義された時間まで保留および解放することができます。

Requeueworkqueueitemaction

遅延を伴う項目の再キュー アクションには、以下の引数が必要です。

入力パラメーター

例外

作業キュー項目の処理中のメモを更新する

作業キュー項目の処理中のメモを更新する アクションを使用すると、ユーザーは選択した作業キュー項目の状態やその他のプロパティを変更せずに、処理中のメモを更新またはクリアできます。

updateprocessingnotesaction

作業キュー項目の処理中のメモを更新するアクション アクションには、次の引数が必要です。

例外

フィルターで作業キュー項目を取得する

フィルターで作業キューの品目を取得するアクションを使用すると、FetchXML フィルター式に基づいて、1つまたは複数の作業キューの項目を取得できます。

Getworkqueueitemsaction

フィルターによる作業キュー項目の取得 アクションには、次の引数が必要です。

入力パラメーター

生成される変数

例外

FetchXML クエリとは何ですか?

Microsoft Dataverse FetchXML は、 Dataverse データベースからデータを取得するために使用される言語です。 簡単に作成、使用、理解できるように設計されています。 たとえば、Dataverse に対して、IT Exception 状態にあるすべての作業キュー項目のリストを取得するようリクエストしたい場合などです。

FetchXml クエリのサポートを作業キュー項目の取得に制限するために、FetchXml 用語と式の限定されたセットのみをサポートします。 これらの用語と式には、属性、フィルター、条件、順序付け式が含まれますが、すべて作業キュー項目テーブル (workqueueitem) に限定されます。 作業キュー項目テーブルから返すプロパティと、希望する並べ替え順序を明示的に指定する必要があります。

FetchXML クエリの例

次の例は、複数のプロパティを取得し、IT Exceptions としてマークされたエラー項目をフィルター処理し、最初に期限切れになるレコード (FEFO) で結果を並べ替える方法を示すクエリ式です。

<attribute name="statecode" />
<attribute name="uniqueidbyqueue" />
<attribute name="createdon" />
<attribute name="completedon" />
<attribute name="workqueueitemid" />
<attribute name="executioncontext" />
<attribute name="name" />
<attribute name="expirydate" />
<attribute name="processingresult" />
<attribute name="priority" />
<attribute name="statuscode" />
<attribute name="modifiedon" />
<attribute name="processingstarttime" />
<attribute name="retrycount" />
<attribute name="requeuecount" />
<attribute name="input" />
<attribute name="delayuntil" />
<filter type="and">
    <condition attribute="statecode" operator="eq" value="4" />
    <condition attribute="statuscode" operator="eq" value="5" />
    <condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
</filter>
<order attribute="expirydate" descending="false" />

クエリサポートの詳細と参照データ

• 使用可能な クエリ演算子 のリスト。on-or-before、between、last-month などの演算子が含まれます。
• 作業キュー項目 テーブルで使用可能な属性のリスト。

状態 (statecode)

ステータス (statuscode)

関連情報

• 作業キューの概要
• 作業キューの管理
• 作業キュー データの一括インポート
• 作業キューのトリガー
• 作業キューの処理