「レコードの作成」または「レコードの更新」ステップ
単一の操作を使用して、ServiceNow テーブルのレコードを作成または更新します。存在するレコードを更新するか、指定された値を使用してレコードを作成します。
既存のレコードの識別
「レコードの作成または更新」ステップは、一意の識別子として選択したフィールドで一致する値を検索することによって、既存のレコードを識別します。たとえば、[簡単な説明] フィールドと [優先度] フィールドがインシデントを一意に識別するように指定できます。ステップは、[簡単な説明] フィールドと [優先度] フィールドが一致するインシデントを検出すると、新しいレコードを作成するのではなく、一致するレコードを更新します。
- 一意の識別子としてフィールドが選択されていない場合、ステップは指定されたフィールド値でレコードを作成します。
- 複数のレコードが一意の識別子の値と一致する場合、ステップはいずれのレコードも更新せず、フロー実行の詳細にエラーメッセージを表示します。
ロールと可用性
ワークフロースタジオ アクションステップとして利用可能です。action_designer ロールを持つユーザーは、1 つ以上のアクションステップを使用してカスタムアクションを作成できます。
入力
アクションに必要な各入力の値を指定します。動的な値を追加するには、[データ] パネルからピルをドラッグアンドドロップするか、ピルピッカーから選択します。
- テーブル
- データタイプ：Table Name
レコードを作成または更新するテーブル。
- フィールド
- データタイプ：Template Values
レコードのために設定または更新するフィールド値。たとえば、簡単な説明を特定の値に設定するには、[簡単な説明] を選択して目標値を設定します。
重要:システムでは、タスクレコードの追加コメントや作業メモといった複数のジャーナルフィールドの更新をサポートしていません。サブフローにアクションを追加する場合は、「テンプレート値の入力を作成」ことが可能です。フィールド値を動的に設定すると、サーバー側の検証ルールはトリガーされますが、UI ポリシーをトリガーすることはできません。
- 一意性を決定
- データタイプ：True/False
レコードをいつ更新または作成するかを決定する一意の識別子としてフィールドを選択するオプション。受信したフィールド値が既存のレコードフィールド値と一致する場合は、レコードが更新されます。受信したフィールド値が既存のレコードフィールド値と一致しない場合は、レコードが作成されます。このオプションは、必要なテーブル名とフィールドが選択されている場合に表示されます。
- このステップが失敗した場合
- データタイプ：Choice 次のステップの実行を続行するか、エラー評価に進むオプション。このオプションはステップステータスの出力に影響しません。次の選択肢があります。
- [アクションを停止せずに次のステップに進みます]：次のステップのアクションの実行を続行します。
- [エラーの評価に進みます (Go to Error Evaluation)]：アクションの実行を停止し、[エラーの評価] セクションに進みます。
出力
これらの出力は [データ] パネルに表示されます。アクションの任意の場所で入力として使用できます。
- レコード
- データタイプ：Record
作成または更新されたレコードへの参照。
- テーブル
- データタイプ：Table Name
レコードが作成または更新されたテーブル。
- エラーメッセージ
- データタイプ：String
レコード操作が失敗した際に生成されるエラーメッセージ。
- ステータス
- データタイプ：Choice
アクションの完了ステータス。フロー実行の詳細ページには、次のいずれかの値が表示されます。
- 作成済み [created]：アクションによってレコードが作成されました。
- 更新 [updated]：アクションによってレコードが更新されました。
- エラー [error]：アクションによってエラーが発生しました。
- ステップステータス
- データタイプ：Object
ステップに関するランタイムの詳細を含むオブジェクトデータピル。アクションの各ステップはステップステータスを返します。
- ステップステータスコード (Step Status Code)
- データタイプ：Integer ステップでエラーが発生したかどうかを示す整数データピルです。何らかの理由でエラーが生成された場合、ステップは値 1 を返します。たとえば、必須の入力データが欠落しているか、間違ったデータタイプで出力を返す場合、ステップはエラーを生成する可能性があります。ステップは、正常に実行されると値 0 を返します。これらのコードはカスタマイズできません。
- 成功 [0]：ステップは成功しました。
- エラー [1]：ステップによってエラーが発生しました。
- ステップステータスメッセージ (Step Status Message)
- データタイプ：String
ステップまたはシステム操作によって生成されたエラーメッセージを含む文字列データピル。このステップステータスメッセージはカスタマイズできません。
問題レコードの作成または更新
このアクションには 2 つの入力があります。説明用の文字列入力と、ユーザーレコード用の参照入力があります。[レコードの作成または更新] ステップでは、これらの入力を使用して問題レコードを作成または更新します。[問題の説明] フィールドと [作成者] フィールドによって一意性が決まります。入力値が一致すると、ステップは作成操作の代わりに更新操作を実行します。