ドキュメントAdobe Workfront Fusion

JSON モジュール

最終更新日： 2026年5月6日

Adobe Workfront Fusion JSON アプリは、Adobe Workfront Fusionがデータコンテンツをさらに操作したり、新しいJSON コンテンツを作成したりできるように、JSON形式でデータを処理するモジュールを提供します。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ

任意の Adobe Workfront Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ

Workfront Ultimate

Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。
Adobe Workfront ライセンス

標準

Work またはそれ以上
製品 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。

この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。

JSONの解析時の考慮事項

データ構造

データ構造は、JSON データの編成方法を記述し、個々の JSON 項目をシナリオ内の他のモジュールにマッピングできるようにします。データ構造を指定しない場合は、モジュールを手動で実行し、Workfront Fusionが指定されたJSONから構造を構築します。

  1. JSON を解析モジュールをシナリオに追加します。
  2. 「JSON 文字列」フィールドで、データ構造を作成する JSON を入力します。
  3. 他のモジュールを JSON を解析モジュールにはまだ結びつけません。Workfront FusionはJSON データの構造をまだ把握していないため、Parse JSON モジュールからシナリオ内の他のモジュールにデータをマッピングすることはできません。
  4. シナリオを手動で実行します。これにより、JSON を解析モジュールが、指定した JSON から JSON 構造を識別できるようになります。
  5. 次のモジュールを接続できるようになりました。JSON を解析モジュールの項目をマッピングに使用できるようになりました。

詳しくは、Adobe Workfront Fusion のデータ構造を参照してください。

コレクションと配列

「JSON 文字列」フィールドにコレクション { ... } が含まれている場合、出力はコレクションの項目を含む単一のバンドルです。

例：

{
    "name" : "Peter",

    "ID" : 1>}

JSON コレクション ​

style
shade-box

JSON 文字列フィールドに配列 [ ... ] が含まれている場合、出力は一連のバンドルになります。各バンドルには、配列の 1 つの要素が含まれます。

例：

[
  {
    "name" : "Peter",
    "ID" : 1
  },

  {
    "name" : "Mike",
    "ID" : 2
  }
]

JSON配列

style
shade-box

JSON モジュールとそのフィールド

JSON モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。これらに加えて、アプリやサービスでのアクセスレベルなどの要因に応じて、追加の JSON フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、モジュール間での情報のマッピングを参照してください。

マップ切り替え

アグリゲータ

JSON に集計

この集約モジュールは、以前のモジュールからの出力を JSON に集計します。

Source module
JSON に集計するデータを出力するモジュールを選択します。
Data structure
JSON の作成に使用するデータ構造を選択します。データ構造は、このモジュールで使用できる他のフィールドを決定します。詳しくは、記事内のデータ構造を参照してください。
Indentation
タブ、2 つのスペース、4 つのスペースのどれを使用して JSON のインデントを設定するかを選択します。
Group by
集約出力をグループ化する式を定義します。この式には、1 つ以上のマッピングされた項目を含めることができます。集計されたデータは、この式の値を使用してグループに分割されます。各グループは、キー（評価された式）と値（集約されたテキスト）を持つ個別のバンドルとして出力されます。キーを後続のモジュールのフィルターとして使用できます。
Stop processing after an empty aggregation
結果がない場合にシナリオを停止するには、このオプションを有効にします。

変換サービス

JSON を XML に変換

このアクションモジュールは、JSON 文字列を XML に変換します。

JSON string
XML に変換する JSON を入力またはマッピングします。

JSON を作成

このアクションモジュールは、データ構造から JSON を作成します。

データ構造
JSON の作成に使用するデータ構造を選択します。詳しくは、この記事のデータ構造を参照してください。
インデント
このJSONに使用するインデントを選択します。

JSON を解析

このアクションモジュールは、JSON 文字列を解析してデータ構造にし、JSON 文字列内のデータにアクセスできるようにします。

Data structure
JSON の作成に使用するデータ構造を選択します。詳しくは、この記事のデータ構造を参照してください。
JSON string
解析する JSON を入力またはマッピングします。

JSON を変換

このアクションモジュールは、オブジェクトを json 文字列に変換します。

インデント
このJSONに使用するインデントを選択します。
Object
JSON に変換するオブジェクトを入力またはマッピングします。

データレコードを JSON に変換中

例：​次の例は、データレコードを Google Sheets から JSON 形式に変換する方法を示しています。

  1. データを取得するには、シナリオに Google Sheets／行を選択モジュールを配置します。Google スプレッドシートから行を取得するモジュールを設定します。返される行の最大数​を、テスト目的で1つ以上の数に設定します（例、3つ）。 Google Sheets モジュールを右クリックし、「このモジュールのみを実行」を選択して実行します。モジュールの出力を確認します。

  2. Google Sheets モジュールの後に、配列アグリゲーターモジュールを接続します。モジュール設定で、「ソースノード」フィールドから Google Sheets モジュール を選択します。その他のフィールドは、現時点ではそのままにしておきます。

  3. 配列アグリゲーターモジュールの後に JSON／JSON を作成モジュールを接続します。モジュールの設定には、JSON 形式を記述したデータ構造が必要です。「追加」をクリックして、データ構造の設定を開きます。このデータ構造を作成する最も簡単な方法は、JSON サンプルから自動的に生成することです。「ジェネレーター」をクリックし、JSON サンプルを「サンプルデータ」フィールドに貼り付けます。

    例：

    code language-none 
    {
"books": [
{
"id": "ID",
"title": "Title",
"author": "Author"
}
]
}

  4. 「保存」をクリックします。これで、データ構造の「仕様」フィールドに、生成された構造が含まれます。

  5. データ構造の名前をより具体的なものに変更し、「保存」をクリックします。ルート配列属性に対応するフィールドは、JSON モジュールの設定で、マッピング可能なフィールドとして表示されます。

  6. フィールドの横にある「マップ」ボタンをクリックし、Array aggregator から出力された Array[] 項目をマッピングします。

  7. 「OK」をクリックして、JSON モジュールの設定を閉じます。

  8. Array Aggregator モジュールの設定を開きます。ターゲット構造​をカスタムから、ルート配列属性に対応する JSON モジュールのフィールドに変更します。Google Sheets モジュールの項目を適切なフィールドにマッピングします。

  9. 「OK」をクリックして、Array Aggregator モジュールの設定を閉じます。

  10. シナリオを実行します。

    JSON モジュールは正しい JSON 形式を出力します。

  11. Google Sheets モジュールの設定を開き、「返される行の最大数」の数値を増やしてスプレッドシートの行数よりも大きくなるようにし、すべてのデータを処理できるようにします。

style
shade-box

トラブルシューティング

JSON を解析モジュールからデータをマッピングできません

JSON コンテンツが JSON を解析モジュールに適切にマッピングされ、データ構造が正しく定義されていることを確認します。詳しくは、この記事のデータレコードを JSON に変換を参照してください。

JSON で条件ステートメントを使用するとモジュールが失敗する

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

例：

JSON内の引用符

style
shade-box
recommendation-more-help
workfront-fusion-help-workfront-fusion