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

前提条件

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

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

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

        例えば、作業項目の構造がデータ型としてStringを含んでいる場合、入力レコードの構造はNumberです。

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

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

      • 日時 値が将来の日付と時刻に設定されていません。
        たとえば、システムの日時が 2024 年 5 月 10 日 14:00 の場合、日時 を将来の日付と時刻の値に設定してください。
        注: 作業項目を保留にしたときに、日時 値 が将来の日付と時刻に設定されていない
  • レコード > 追加オプションのフィールドでは、次の画像に示すように、入力値として変数を使用しないようにしてください。

    作業項目を更新

手順

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

      [構造を取得] ボタンをクリックします。

      このボタンをクリックすると、作業項目の全体構造が表示されます。キー、タイプ、値を追加するためのテキストボックスが含まれています。 構造を取得する ボタンは、レコード オプションでのみ利用可能であり、手動で属性を追加していない場合に限ります。 ただし、手動で属性を追加した場合は、構造を取得 ボタンをクリックして手動入力をクリアし、名前、データ型、空の値などの構造を読み込みます。 作業項目の構造を取得した後、パネルを追加または削除できます。
      注: キュー名として変数を追加しないようにしてください。
    • 変数

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

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