作業キュー アクション
Power Automate の 作業キュー を使用すると、プロセス関連データを保存し、複雑なプロセスと自動化を分離して非同期的に通信できます。
作業キューは、自動化の効率性、スケーラビリティ、回復性を向上させる上で重要な役割を果たし、作業の優先順位付けに役立ちます。 作業キューを使用すると、デジタル ワーカー、ヒューマン ワーカー、または統合によって処理されているかどうかに関係なく、最も優先度の高い項目を最初に完了できます。
注意
- 作業キュー関連アクションの最初のセットに対する運用レベルのサポートには、Power Automate デスクトップ バージョン 2.37 以降が必要です。
- デスクトップ用 Power Automate の作業キュー アクションは、Power Automate サブスクリプション が必要なプレミアム機能です。
- 現在、作業キュー項目の処理と作業キュー項目の更新アクションのみ、データの消失防止 (DLP) ポリシーにより、分類し、許可または制限できます。他のアクションも間もなく可能になります。 クラウド フローベースの作業キューの使用は、DLP ポリシーによって制限できないことに注意してください。
作業キュー項目を処理する
作業キュー項目を処理するアクションは、コンピューターが 1 つ以上の作業キュー項目を処理する準備ができていることをキュー オーケストレーターに示します。 新しい項目を要求するユーザー コンテキストは、作業キューを処理するために、作業キューおよび作業キュー項目テーブルに対する十分な権限を持っている必要があります。
前のアクションで参照された 作業キュー は、キュー オーケストレーターによって使用され、その作業キュー内で キュー登録済み 状態にある、次に使用可能な項目を決定します。 デスクトップ フローが、このアクションがレンダリングする作業キュー項目を処理するループ内のアクションを処理するとき、プロパティ .Value とともにアクションに指定した変数を利用して、値を呼び出すことができます。 この場合、変数 %WorkQueueItem.Value% を使用して作業キュー項目の値を呼び出すことができます
Processworkqueueitemaction
作業キュー項目のアクションを処理する アクションには次の引数が必要です。
パラメーターの入力
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| 作業キュー | いいえ | Text | 処理する項目を含む作業キューの作業キュー ID |
生成される変数
| 引数 | タイプ | Description |
|---|---|---|
| WorkQueueItem | いいえ | 処理中の作業キュー項目に保存されている情報 |
例外
| 例外 | Description |
|---|---|
| 作業キューが見つかりません | 作業キュー パラメーターに入力された値が無効です |
| 作業キューを処理できませんでした | 不正なリクエスト - クエリ構文のエラー |
作業キュー項目を更新する
作業キュー項目を更新するアクションを使用すると、ユーザーは選択した作業キュー項目の状態と処理結果を変更できます。
Updateworkqueueitemaction
作業キュー項目のアクションを更新する アクションには次の引数が必要です。
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| 作業キュー項目 | いいえ | Text | キュー オーケストレーターによって以前に返された作業キュー項目変数 | |
| 状況 | いいえ | 処理済み、汎用例外 | 処理済み | オプションのリストから状態を使用して、処理中の作業キュー項目を更新します。 |
| 処理メモ | はい | Text | 処理中のキュー項目に追加するカスタムの処理中のメモまたは値。 | |
| 処理中のメモをクリア | はい | ブール値 | False | 有効にすると、この画面の処理中のメモのフィールドが非表示またはクリアされ、この項目に対して以前に取得されたすべての処理中のメモがデータベースから削除されます。 |
例外
| 引数 | プロパティ |
|---|---|
| 作業キュー項目が見つかりません | 処理中の作業キュー項目が削除されているか、呼び出し元のキューに属していません。 |
| 保留中の作業キュー項目 | 処理中の作業キュー項目には、キュー オーケストレーターで on hold の状態が含まれており、更新できなくなりました。 |
| 作業キュー項目を更新できませんでした | 更新中の作業キュー項目で予期しないエラーが発生しました。 詳細については、エラー メッセージを確認してください。 |
作業キュー項目を追加する
作業キュー項目を追加するアクションでは、デスクトップ フロー ユーザーは、フロー ポータルで設定されている作業キューに作業キュー項目を追加できます。
Addworkqueueitem アクション
作業キュー項目の追加 アクションには次の引数が必要です。
パラメーターの入力
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| 作業キュー | いいえ | テキスト値 | 項目を追加する作業キュー項目 | |
| 優先順位 | いいえ | 高、中、低 | 正常 | 作業キュー項目を設定する優先度 |
| 件名 | いいえ | テキスト値、数値 | 新しい作業キュー項目のカスタムな名前または ID | |
| 入力 | いいえ | テキスト値、数値 | 処理する値列に属するデータ | |
| 有効期限 | はい | Datetime | キュー項目を期限切れにするように設定された datetime 値。それ以外の場合は、キューに設定されている場合はデフォルト値が採用されます | |
| 処理メモ | はい | テキスト値、数値 | 新しいキュー項目に追加されるカスタム処理メモ | |
| 一意の ID または参照を設定する | はい | テキスト値、数値 | 有効にすると、このキュー内で一意の値を指定する必要があります。 空のままにすると、system-<GUID> 形式の一意の値がシステムによって自動的に提供されます |
生成される変数
| 引数 | タイプ | プロパティ |
|---|---|---|
| WorkQueueItem | いいえ | 追加する作業キュー項目に保存されている情報 |
例外
| 引数 | Description |
|---|---|
| 作業キューが見つかりません | 作業キュー パラメーターに入力された値が無効です |
| 項目を作業キューに追加できませんでした | 作業キュー項目を作業キューに追加できませんでした。 不正なリクエスト - クエリ構文のエラー |
遅延した項目を再度キューに入れる
遅延した項目を再度キューに入れる アクションを使用すると、ユーザーはデスクトップ フローで処理中のキュー項目を元のキューに再度追加できます。 さらに、キューに入れられた項目は、定義された時間まで保留および解放することができます。
Requeueworkqueueitemaction
遅延を伴う項目の再キュー アクションには、以下の引数が必要です。
パラメーターの入力
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| 作業キュー項目 | いいえ | 作業キュー項目 | 項目を追加する作業キュー項目 | |
| 延期期限 | いいえ | DateTime 値 | 正常 | キュー項目を遅延させるために適用される datetime 値 |
| 有効期限 | はい | DateTime 値 | 再度キューに入れられる項目のカスタム有効期限 | |
| 処理メモ | はい | テキスト値、数値 | 新しいキュー項目に追加されるカスタム処理メモ | |
| 処理中のメモをクリア | はい | ブール値 | False | 有効にすると、この画面の処理中のメモのフィールドが非表示またはクリアされ、この項目に対して以前に取得されたすべての処理中のメモがデータベースから削除されます |
例外
| 引数 | プロパティ |
|---|---|
| 作業キューが見つかりません | 作業キュー パラメーターに入力された値が無効です |
| 作業キュー項目が見つかりません | キュー項目の値が無効です |
| 作業キュー項目をキューに再登録できませんでした | 作業キュー項目を作業キューに追加できませんでした。 不正なリクエスト - クエリ構文のエラー |
作業キュー項目の処理中のメモを更新する
作業キュー項目の処理中のメモを更新する アクションを使用すると、ユーザーは選択した作業キュー項目の状態やその他のプロパティを変更せずに、処理中のメモを更新またはクリアできます。
updateprocessingnotesaction
作業キュー項目の処理中のメモを更新するアクション アクションには、次の引数が必要です。
| 引数 | オプション | 受入 | Default Value | プロパティ |
|---|---|---|---|---|
| 作業キュー項目 | いいえ | Text | キュー オーケストレーターによって以前に返された作業キュー項目変数 | |
| 処理メモ | はい | Text | 処理されたキュー項目に追加するカスタムの処理結果または値 | |
| 処理中のメモをクリア | はい | ブール値 | False | 有効にすると、この画面の処理中のメモのフィールドが非表示またはクリアされ、この項目に対して以前に取得された処理中のメモがデータベースから削除されます |
例外
| 引数 | プロパティ |
|---|---|
| 作業キューが見つかりません | 項目に関連付けられた作業キューは削除されたか、アクセスできなくなりました |
| 作業キュー項目が見つかりません | 作業キュー項目が無効です |
| 処理結果を追加できませんでした | 更新中の作業キュー項目で予期しないエラーが発生しました。 詳細については、エラー メッセージを確認してください。 |