JSON package

JSON package は、JSON データ ソースから情報を抽出および解析することを可能にします。 このパッケージを使用すると、JSON 文字列内の値の追加や更新、ノードパスを利用した JSON 文字列のオブジェクトへの変換、JSON 文字列と辞書の相互変換など、JSON データを柔軟に操作できます。

JSON packageは、データ交換に JSON を利用する Web サービスや API とオートメーション ワークフローをシームレスに統合する際に重要な役割を果たします。

ベネフィット

  • JSON (JavaScript Object Notation) は、データの保存、転送、取得に適した軽量でわかりやすい、拡張可能な形式です。 JSON は、データのキーと値のペアを使用し、より高速なデータ交換と Web サービスの結果を提供します。
  • ほとんどの REST Web サービス (API)、一部の設定ファイル、MongoDB などの多くの NoSQL データベースでは、一般に、データ交換に適した柔軟な形式を理由に JSON を使用しています。 軽量で解析しやすい、テキストベースのデータ形式になっているため、提供されたデータを理解して解釈するために追加のコードは必要ありません。
  • JSON ファイルは、オートメーションがサーバー、環境固有、またはフォルダー共有の詳細を決定するときに参照する設定データの保存や取得に最適です。
  • JSON の柔軟な構造は、さまざまなデータ型や複雑なデータ階層に効率的に対応します。

JSON データ型

JSON の値は、以下のデータ型でなければなりません。
  • 文字列
  • 数字
  • オブジェクト (JSON オブジェクト)
  • 配列
  • ブール型
注: Automation 360 では、値 NULL はサポートされていません。 したがって、JSONデータを抽出して辞書変数に変換する際、JSON文字列内のnull値は変換されません。辞書変数はnull値をサポートしていないためです。 しかし、JSONがnullの代わりに空の文字列（""）を含む場合、それは正常にディクショナリ変数に変換されます。

JSON 構造体について

JSON では、データは主に次の 2つの構造体に格納されます。
  • オブジェクト: JSON のオブジェクトは、中括弧 {} で囲まれたキーと値のペアのコレクションです。 各キーは引用符（“”）で囲まれた文字列で、コロン（:）の後に続き、カンマ（,）はキーと値のペアを区切るために使用されます。
    例: Sample.png
    {"name ": "John", "age": "30", "city": Detroit}
  • 配列: 配列は、値の順序付きリストであり、大括弧 [] で囲みます。 配列内の値は、カンマ (,) で区切ります。
    例: Sample.png
    ["John", "Annie", "Shane"]

JSON packageの使用

JSON actionsのpackageを以下の順番で使用します。
  1. セッションを開始 actionを使用して JSON セッションを開始します。 このセッション名は、対応するすべての actions に使用します。
  2. JSON パッケージの使用可能なさまざまなactionsを使用して、JSON 関連のタスクを自動化します。
  3. セッションの終了 action を使用してセッションを終了し、タスクを完了します。

JSON Actionsのpackage

JSON packageには、以下のactionsが含まれています。
注: macOS プラットフォームで自動化を作成すると、確認ウィンドウが表示され、macOS でアプリの権限を付与するように促されます。 このトピックでは、プロンプトメッセージの一覧とアプリの権限を管理するための指示をご覧ください。

macOS のアプリケーションの権限

Action 内容
セッションを開始 指定された JSON データソースに基づいて新しい JSON セッションを開始します。 「セッションを開始」アクションへ変更してください actionを参照してください。
ノード値を追加 セッション開始 データソースに指定された JSON に新しいノードを追加します。 ノード値を追加を参照してください。
ディクショナリを JSON に変換 を使用する ディクショナリ 変数の内容を JSON 形式に変換します。 ディクショナリを JSON に変換] を使用するを参照してください。
JSON をディクショナリに変換 JSON データソースの内容をディクショナリ変数に抽出します。 JSON をディクショナリに変換を参照してください。
ノード リストの取得 ノード パスのノード一覧を取得します。 JSON の [ノード リストの取得] actionを参照してください。
ノード取得 JSON ソースからキーの値を抽出します。 JSON のノードを取得を参照してください。
ノード値の取得 JSON ソースからノードの値を取得します。 JSON の [ノード値の取得] actionを参照してください。
ノード値を更新する JSON データソース内のノードの値を更新します。 ノード値を更新するを参照してください。
検証 JSON データソースの構文、構造、およびスキーマを検証します。 アクションを検証を参照してください。
セッションの終了 JSON セッションを閉じます。 JSON の [セッションの終了] actionを参照してください。

他のリソース