JSON モジュール

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

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件:Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件:Workfront Fusion for Work Automation and Integration、Workfront Fusion for Work Automation

製品

現在の製品要件:Select または Prime Adobe Workfront プランがある場合、この記事で説明する機能を使用するには、組織で Adobe Workfront Fusion の購入 Adobe Workfront 必要です。 Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件:この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

JSON を解析

データ構造

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

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

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

コレクションと配列

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

INFO
例:
code language-none
{
       "name" : "Peter",

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

INFO
例:
code language-none
[
   {
       "name" : "Peter",
       "ID" : 1
   },

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

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

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

アグリゲーター

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 文字列内のデータにアクセスできるようにします。

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

JSON を変換

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

Object
JSON に変換するオブジェクトを入力またはマッピングします。

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

INFO
例: ​次の例は、データレコードを 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"




}




]




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

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

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

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

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

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

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

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

トラブルシューティング

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

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

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

if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。

INFO
例:
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43