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