配列または配列要素のマッピング
配列は、次の内容を含めることができるバンドル項目です。
- 同じ型の 1 つ以上の値（単純配列）
- 同じタイプの 1 つ以上のコレクション（複合配列）
例：
- 複合配列:Watch emails モジュールは、すべてのメールの添付ファイルの配列を返します。 すべての添付ファイルは、名前、コンテンツ、サイズなどを含むコレクションを表します。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
新規： Standard
または
現在：Work 以上
現在：Workfront Fusion ライセンスは必要ありません。
または
レガシー：任意
新規：
- Select または Prime Workfront プラン：組織は Adobe Workfront Fusion を購入する必要があります。
- Ultimate Workfront プラン：Workfront Fusion が含まれています。
または
現在：Adobe Workfront Fusion を購入する必要があります。
このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
配列全体のマッピング
-
左側のパネルで「Scenarios」タブをクリックします。
-
配列をマッピングするシナリオを選択します。
-
シナリオの任意の場所をクリックして、シナリオエディターに移動します。
-
配列をマッピングするモジュールで、配列をマッピングするフィールドをクリックします。 配列のマッピング先のフィールドです。
-
表示されるボックスで、項目をマッピングします。
パネルを使用すると、他のタイプの項目と同じ方法でフィールドをマッピングできます。各項目を個別に入力せずに、別の配列をターゲットフィールドにマッピングする場合は、「Map」ボタンを使用します。 この場合、両方の配列（ソース配列とターゲット配列）の構造が同じであることを確認します。
1 つの配列には、任意の数の項目を追加できます。
イテレータを使用して、配列を個々のバンドルに分割できます。詳しくは、 Adobe Workfront Fusion🔗 の Iterator モジュールを参照してください。
新しい配列への項目のマッピング
Workfront Fusion の一部のフィールドでは、要素を配列にマッピングできます。 例えば、チェックリスト項目の配列を、Workfront ボード / チェックリスト項目を追加モジュールに作成できます。 モジュールを実行すると、すべてのチェックリスト項目がカードに追加されます。
「項目を追加」と表示されるモジュールフィールドは、すべて配列を作成します。
配列に要素を追加するには、次の手順に従います。
- 「項目を追加」をクリックします
- 開いたパネルに、項目の詳細を入力します。
- 「追加」をクリックします。
- （オプション） 配列に追加する各要素に対して、手順 1 ～ 3 を繰り返します。
配列要素のマッピング
数値別に配列要素をマッピングします
配列要素は、配列名の後に角括弧で囲まれた数字として表示されます。 このインデックス番号を使用して、配列の個々の要素をフィールドにマッピングできます。
NOTE配列要素をマッピングするには：
-
要素をマッピングするフィールドをクリックします。
マッピングパネルが開きます。
-
マッピングする要素を含む配列を見つけます。
-
アレイの横にあるドロップダウン矢印をクリックします。
-
マッピングする要素をクリックします。
要素がマッピングされます。インデックスは 1 です。 これにより、配列の最初の要素がマッピングされます。
-
配列の別の要素をマッピングするには、[1 をクリックし ] マッピングする配列要素のインデックス番号を入力します。
指定されたキーで配列の要素をマッピングする
一部の配列には、メタデータや属性などのキー値項目を持つコレクションが含まれています。 これらの値の 1 つを使用するには、指定されたキー値で要素を検索し、対応する値を値項目から取得できます。 map() 関数と get() 関数を組み合わせた数式を使用することをお勧めします。
次の例は、Jira アプリの出力を示しています。
この例では、ID が 10108 の特定の添付ファイルについて、添付ファイルの配列からファイル名を取得します。
この例では、次の出力が生成されます。
この式は次のように説明できます。
-
map-
map()の最初のパラメーター関数は配列の項目全体です。 -
2 つ目のパラメーターは、値の項目の未加工の名前です。生の名前を取得するには、mapping のパネルの項目の上にマウスポインターを置きます。
NOTEすべてのパラメーターでは大文字と小文字が区別されます。この例では、アイテムのラベルが生の名前と異なるのは大文字のみですが、生の名前を使用する必要があります。 -
3 番目のパラメーターは、キー項目の生の名前です。
-
4 番目のパラメーターは指定されたキー値です。
map()関数は配列を返すので（指定されたキー値を持つ他の要素が存在する可能性があるため）、その最初の要素を取得するためにget()関数を適用する必要があります。 -
-
get-
get()関数の最初のパラメーターは、map()関数の結果です。 -
2 番目のパラメーターは要素のインデックスです。 この例では、インデックスは
1です。
-
この例では、次の出力が生成されます。
map() 関数の詳細については、 配列関数を参照してください。
get() 関数の詳細については、 一般関数を参照してください。
配列要素を一連のバンドルに変換します
配列は、Iterator モジュールを使用して一連のバンドルに変換できます。 詳しくは、Iterator モジュールを参照してください。
