JSON Builder ステップ

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む2読むのに数分
  • ロールと使用可用性

    アクションデザイナー アクション ステップとして利用可能です。action_designer ロールを持つユーザーは、1 つ以上のアクションステップを使用してカスタムアクションを作成できます。

    フィールド

    フィールド 説明
    名前 名前と値のペアの名前の部分です。値を入力するか、データピルを使用して動的ペイロードを生成します。

    名前と値のペアの値の部分です。値を入力するか、データピルを使用して動的ペイロードを生成します。

    複合オブジェクトピルを使用して行にオブジェクトデータタイプを入力できますが、そうすると、複合オブジェクトピルに既に存在する子がすべて削除されます。

    タイプ
    名前と値のペアのデータタイプです。名前または値にデータピルを使用する場合は、ピルのデータタイプがここで選択したデータタイプと一致していることを確認してください。オプションは次のとおりです。
    • 文字列
    • オブジェクト
    • 番号
    • ブール
    • アレイ

    アレイとオブジェクトの場合は、プラスアイコン ( プラスアイコン) を使用して、アレイまたはオブジェクトに名前と値のペアを追加します。

    空の値の場合 名前と値のペアの値が空または null の場合の処理を指定するオプションです。
    • そのまま残す (Leave as is):空または null 値を空の文字列として保持します。
    • プロパティを省略 (Omit property):値が空または null の場合、名前と値のペアを除外します。
    • null として設定 (Set as null):空または null 値を null データタイプとして返します。
    • エラーをスロー:名前と値のペアの値が空または null 値の場合、エラーを返します。
    外部の構造を含める トップレベルの JSON コンテナに中括弧を含めるオプションです。
    空の構造を省略

    空のペイロードを省略するオプションです。

    名前と値のすべてのペアで [空の値の場合 (In case of empty value)] フィールドの [プロパティを省略 (Omit property)] を選択し、ペイロード内のすべての名前と値のペアが空の値を生成した場合に、空のペイロードが発生する可能性があります。

    プレビュー ステップによって生成される読み取り専用ペイロードです。

    アクションエラー評価のフィールド

    フィールド 説明
    このステップが失敗した場合 次のステップの実行を続行するか、エラー評価に進むオプション。カスタムアクションのエラー条件のステップのステータスコードやメッセージを使用するには、「Action error evaluation」を参照して ください。

    出力

    フィールド 説明 データタイプ
    出力 文字列としての JSON ペイロードです。ペイロードをオブジェクトとして使用する場合は、JSON パーサーステップ を使用して文字列を解析できます。 文字列
    ステップステータス ステップに関するランタイムの詳細を含むオブジェクトデータピル。アクションの各ステップはステップステータスを返します。 オブジェクト
    [ステップステータス] > [コード] ステップでエラーが発生したかどうかを示す整数データピルです。デフォルトでは、値 1 はステップでエラーが生成されたことを示します。値 0 は、ステップが正常に実行されたことを示します。これらのコードはカスタマイズできません。 整数
    [ステップステータス] > [メッセージ] ステップまたはシステム操作によって生成されたエラーメッセージを含む文字列データピル。このメッセージはカスタマイズできません。 文字列