[作業項目を更新] actionの使用

[作業項目を更新] actionでは、自動実行の一部として、キュー名および作業項目 ID に基づいて作業項目を柔軟に更新できます。

[作業項目を更新] actionの使用に関する以下の考慮事項を確認してください。
  • 次のいずれかのオプションを使用して、オートメーションを実行します。
    • すぐに実行
    • スケジュール
    • イベント トリガーで実行
    注: 作業項目を更新する Bot Runner ユーザーは、キューの所有者または参加者のいずれかのロールに関連付けられている必要があります。
  • [作業項目を更新] actionを使用して、オートメーションでの複雑なワークフローを管理するには、複数のキューからの作業項目を追加します。
  • 次のフィールドが正しく更新されない場合は、実行時にエラーが表示され、オートメーションに失敗します。
    • [キュー名] フィールドに誤った名前が入力されています。
    • [レコード] タブの場合:
      • 列の順序が正しくありません。

        たとえば、作業項目の構造が ColumnA、ColumnB、および ColumnC の場合。[レコード] タブで列の順序として ColumnA、ColumnC、ColumnB を入力すると、オートメーションは失敗します。

      • 列のデータ型が正しくありません。

        たとえば、作業項目構造に文字列のデータ型が含まれているが、入力レコード構造が数値である場合などです。

      • レコード構造内のいずれかの列が欠落している場合。

        たとえば、作業項目に 3 つの列があり、そのうちの 1 つを削除するとします。ただし、入力レコードは 3 列に対して設定されています。

      • [日時] 値が将来の日付と時刻に設定されていません。
        たとえば、システムの日時が 2024 年 5 月 10 日 14:00 の場合、[日時] を将来の日付と時刻の値に設定してください。
        注: 作業項目を保留にしたときに、[日時] 値 が将来の日付と時刻に設定されていない

手順

  1. [オートメーション] ページで、[作成] アイコンをクリックするか、既存のTask Bot をクリックして、エディター画面を開きます。
  2. [アクション] パレットで、Workload内の使用可能な [作業項目を更新] actionをダブルクリックまたはドラッグします。
  3. [キュー名] フィールドに、作業項目を更新するキューの名前を入力します。
    注: 指定されたキューが存在しない場合は、オートメーションの実行時にエラーが表示されるため、正しい名前を入力してください。
    (任意) [値を挿入] アイコンをクリックして、キュー名を保存するために使用した可能性のある既存の変数を選択します。
  4. [作業項目 ID] フィールドに、更新する作業項目の ID を入力します。
    (任意) [値を挿入] アイコンをクリックして、作業項目 ID の値を保存するために使用した可能性のある既存の変数を選択します。
  5. [作業項目値] フィールドを使用して、次のいずれかのタブを選択します。
    • レコード
      [追加] ボタンをクリックして レコードを追加し、次のエントリを更新します。
      • インデックス: 自動生成されるフィールドであり、手動で編集することはできません。ただし、複数のレコードを追加した場合は、[上に移動] および [下に移動] の矢印が有効になります。[インデックス] フィールドの値は、レコードを移動する位置に基づいて変化します。
      • 名前: 追加する列の名前を入力します。
      • タイプ: ドロップダウン メニューをクリックして、列のタイプを選択します。
        注: 作業項目では文字列、数値、日時のみがサポートされます
      • 値: 選択した [タイプ] に基づいて列の値を入力します。
      注: 追加するレコードの列数が作業項目構造と同じであることを確認します。たとえば、列の数、名前、タイプ、およびその値。
    • 変数

      変数名を入力するか、[値を挿入] アイコンをクリックして、作業項目の値を含む既存の変数を選択します。

  6. [ステータス] ドロップダウン メニューをクリックして、次のオプションのいずれかを選択します。
    • 再処理 (新規): 選択した作業項目を新規として再処理するには、このオプションを選択します。
    • 保留中: 選択した作業項目を一時停止または保留にするには、このオプションを選択します。さらに、次のいずれかのタブを使用して、[保留中] ステータスを調整できます。
      • 無期限: 後日または日付でステータスを手動で変更する場合は、このオプションを選択します。
      • 期限: 以下の基準に基づいて [保留中] ステータスを設定するには、このオプションを選択します。
        • 日時: 日付、時刻、タイムゾーンを選択します。
          注: [EST]、[HST]、[MST] のタイム ゾーンは非推奨です。
        • 変数: 変数を入力するか、[値を挿入] アイコンをクリックして、既存の変数を選択します。
  7. [保存] をクリックします。
    選択した作業項目は、選択した設定に基づいて更新されます。