[レコードを作成または更新] アクション
単一の操作を使用して、ServiceNow テーブルのレコードを作成または更新します。存在するレコードを更新するか、指定された値を使用してレコードを作成します。
既存のレコードの識別
[レコードを作成または更新] アクションは、一意の識別子として選択したフィールドで一致する値を検索することによって、既存のレコードを識別します。たとえば、[簡単な説明] フィールドと [優先度] フィールドがインシデントを一意に識別するように指定できます。アクションは、[簡単な説明] フィールドと [優先度] フィールドが一致するインシデントを検出すると、新しいレコードを作成するのではなく、一致するレコードを更新します。
- 一意の識別子としてフィールドが選択されていない場合、アクションは指定されたフィールド値でレコードを作成します。
- 複数のレコードが一意の識別子の値と一致する場合、アクションはいずれのレコードも更新せず、フロー実行の詳細にエラーメッセージを表示します。
ロールと可用性
ワークフロースタジオ ServiceNow コアアクションとして利用可能です。flow_designer または admin ロールを持つユーザーは、アクションをフローに追加し、構成の詳細を定義できます。
入力
フローに必要な各入力の値を指定します。動的な値を追加するには、[データ] パネルからピルをドラッグアンドドロップすることも、ピルピッカーから選択することもできます。
- テーブル
- データタイプ:Table Name
レコードを作成または更新するテーブル。
- フィールド
- データタイプ:Template Values
レコードのために設定または更新するフィールド値。たとえば、簡単な説明を特定の値に設定するには、[簡単な説明] を選択して目標値を設定します。
重要:システムでは、タスクレコードの追加コメントや作業メモといった複数のジャーナルフィールドの更新をサポートしていません。サブフローにアクションを追加する場合は、「テンプレート値の入力を作成」ことが可能です。フィールド値を動的に設定すると、サーバー側の検証ルールはトリガーされますが、UI ポリシーをトリガーすることはできません。
- 一意性を決定
- データタイプ:True/False
レコードをいつ更新または作成するかを決定する一意の識別子としてフィールドを選択するオプション。受信したフィールド値が既存のレコードフィールド値と一致する場合は、レコードが更新されます。受信したフィールド値が既存のレコードフィールド値と一致しない場合は、レコードが作成されます。このオプションは、必要なテーブル名とフィールドが選択されている場合に表示されます。
出力
これらの出力は [データ] パネルに表示されます。フローの他の場所で入力として使用できます。
- レコード
- データタイプ:Record
作成または更新されたレコードへの参照。
- テーブル
- データタイプ:Table Name
レコードが作成または更新されたテーブル。
- ステータス
- データタイプ:Choice
アクションの完了ステータス。フロー実行の詳細ページには、次のいずれかの値が表示されます。
- 作成済み [created]:アクションによってレコードが作成されました。
- 更新 [updated]:アクションによってレコードが更新されました。
- エラー [error]:アクションによってエラーが発生しました。
- エラーメッセージ
- データタイプ:String
レコード操作が失敗した際に生成されるエラーメッセージ。