JSON モジュール
Adobe Workfront FusionJSON アプリは、Adobe Workfront Fusion がデータコンテンツとより深く連携したり、新しい JSON コンテンツを作成したりできるように、JSON 形式のデータを処理するモジュールを提供します。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
JSON を解析
データ構造
データ構造は、JSON データの編成方法を記述し、個々の JSON 項目をシナリオ内の他のモジュールにマッピングできるようにします。データ構造を指定しない場合、モジュールを手動で実行すると、Workfront Fusion が指定された JSON から構造を作成します。
- JSON を解析モジュールをシナリオに追加します。
- 「JSON 文字列」フィールドで、データ構造を作成する JSON を入力します。
- 他のモジュールを JSON を解析モジュールにはまだ結びつけません。Workfront Fusion はまだ JSON データの構造を把握していないので、JSON を解析モジュールのデータをシナリオ内の他のモジュールにマッピングすることはまだできません。
- シナリオを手動で実行します。これにより、JSON を解析モジュールが、指定した JSON から JSON 構造を識別できるようになります。
- 次のモジュールを接続できるようになりました。JSON を解析モジュールの項目をマッピングに使用できるようになりました。
詳しくは、Adobe Workfront Fusion のデータ構造を参照してください。
コレクションと配列
「JSON 文字列」フィールドにコレクション { ... }
が含まれている場合、出力はコレクションの項目を含む単一のバンドルです。
code language-none |
---|
|
JSON 文字列フィールドに配列 [ ... ]
が含まれている場合、出力は一連のバンドルになります。各バンドルには、配列の 1 つの要素が含まれます。
code language-none |
---|
|
JSON モジュールとそのフィールド
JSON モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリやサービスでのアクセスレベルなどの要因に応じて、追加の JSON フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion でモジュールから別のモジュールに情報をマッピングを参照してください。
アグリゲーター
JSON に集計
この集約モジュールは、以前のモジュールからの出力を JSON に集計します。
変換サービス
JSON を XML に変換
このアクションモジュールは、JSON 文字列を XML に変換します。
JSON を作成
このアクションモジュールは、データ構造から JSON を作成します。
JSON を解析
このアクションモジュールは、JSON 文字列を解析してデータ構造にし、JSON 文字列内のデータにアクセスできるようにします。
JSON を変換
このアクションモジュールは、オブジェクトを json 文字列に変換します。
データレコードを JSON に変換中
-
データを取得するには、シナリオに Google Sheets/行を選択モジュールを配置します。Google スプレッドシートから行を取得するモジュールを設定します。「返される行の最大数」を小さい数に設定しますが、テスト用に 1 より大きい値(例:3)に設定します。Google Sheets モジュールを右クリックし、「このモジュールのみを実行」を選択して実行します。モジュールの出力を確認します。
-
Google Sheets モジュールの後に、配列アグリゲーターモジュールを接続します。モジュール設定で、「ソースノード」フィールドから Google Sheets モジュール を選択します。その他のフィールドは、現時点ではそのままにしておきます。
-
配列アグリゲーターモジュールの後に JSON/JSON を作成モジュールを接続します。モジュールの設定には、JSON 形式を記述したデータ構造が必要です。「追加」をクリックして、データ構造の設定を開きます。このデータ構造を作成する最も簡単な方法は、JSON サンプルから自動的に生成することです。「ジェネレーター」をクリックし、JSON サンプルを「サンプルデータ」フィールドに貼り付けます。
code language-none |
---|
|
-
「保存」をクリックします。これで、データ構造の「仕様」フィールドに、生成された構造が含まれます。
-
データ構造の名前をより具体的なものに変更し、「保存」をクリックします。ルート配列属性に対応するフィールドは、JSON モジュールの設定で、マッピング可能なフィールドとして表示されます。
-
フィールドの横にある「マップ」ボタンをクリックし、Array aggregator から出力された
Array[]
項目をマッピングします。 -
「OK」をクリックして、JSON モジュールの設定を閉じます。
-
Array Aggregator モジュールの設定を開きます。ターゲット構造 をカスタムから、ルート配列属性に対応する JSON モジュールのフィールドに変更します。Google Sheets モジュールの項目を適切なフィールドにマッピングします。
-
「OK」をクリックして、Array Aggregator モジュールの設定を閉じます。
-
シナリオを実行します。
- Google Sheets モジュールの設定を開き、「返される行の最大数」の数値を増やしてスプレッドシートの行数よりも大きくなるようにし、すべてのデータを処理できるようにします。
トラブルシューティング
JSON を解析モジュールからデータをマッピングできません
JSON コンテンツが JSON を解析モジュールに適切にマッピングされ、データ構造が正しく定義されていることを確認します。詳しくは、この記事のデータレコードを JSON に変換を参照してください。
JSON で条件ステートメントを使用するとモジュールが失敗する
if
などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。