Adobe Workfront Fusion で、あるモジュールから別のモジュールに情報をマッピングします。
マッピングとは、項目に構造化されたモジュールの出力を、別のモジュールの入力フィールドに割り当てるプロセスです。
マッピングパネルは、シナリオで前のモジュールから出力された値を挿入するフィールドをクリックすると表示されます。モジュール内では、マッピングに使用できる任意のフィールドで、入力した静的テキストを含むマッピングパネルから、任意の関数とマッピングされた項目の組み合わせを使用して数式を作成できます。これらの要素は、互いに内部にネストできます。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。
Adobe Workfront Fusion のライセンスについて詳しくは、Adobe Workfront Fusion のライセンスを参照してください。
バンドルと項目
モジュールの操作により、その出力として 0 個、1 個または複数のバンドルが生成されます。バンドルは、1 つ以上の項目で構成されます。
モジュールの出力を調べるには、次の操作を実行します。
-
「1 回実行」をクリックして、モジュールを実行します。
-
モジュールの上のバブルをクリックします。
モジュールのすべてのフェーズを含むログが表示されます。モジュールの操作フェーズで出力されるバンドルまたは複数のバンドルは、出力 の見出しの下にあります。各バンドルには、項目と各項目の値が含まれます。
Date、Email ID (UID)、size などの様々な項目を含む単一のバンドルを生成したことがわかります。
項目のマッピング
2 つ以上のモジュールをリンクして一連のモジュールを作成した後、各モジュールは、それより前のモジュールが出力する項目の値を処理できます。
モジュールの入力フィールドに項目を割り当てるには、次の操作を実行します。
-
前のモジュールまたはモジュールの出力を処理するモジュールをクリックします。
-
表示されるモジュール設定パネルで、前のモジュールから出力された項目の値を使用するフィールドをクリックします。
マッピングパネルが開きます。
-
マッピングパネルから項目をクリックして、フィールドに挿入します。
-
（オプション）マッピングパネルで特定のフィールドを検索するには、マッピングパネルの検索バーをクリックし、検索する語句を入力します。リストに表示されるフィールドをクリックします。
検索結果には検索語が含まれ、大文字と小文字は区別されません。
詳しくは、 Adobe Workfront Fusion でのモジュールの設定を参照してください。
数式
複数の項目を 1 つのフィールドにマッピングし、リテラル（固定値）と組み合わせ、演算子と関数を使用して複雑な数式を作成できます。
関数と演算子は、そのタブの 1 つの下のマッピングパネルにあります。
（パネルを開く際に表示される）最初のタブ
その他のタブには、次のような関数が含まれます。
-
一般的な関数
-
数式
-
テキスト関数とバイナリ関数
-
日付と時間
-
配列操作の関数
関数を使った項目のマッピングについて詳しくは、 Adobe Workfront Fusion で関数を使用して項目をマッピングするを参照してください。
コレクション
一部の項目には、様々なタイプの複数の値を含めることができます。コレクションタイプの項目です。
コレクションタイプの項目は、項目のラベルと自動的に展開されるサブ項目のリストの右側に表示される小さな黒い長方形で識別できます。
コレクションについて詳しくは、Adobe Workfront Fusion の項目データタイプを参照してください。
配列
一部の項目には、同じタイプの複数の要素を含めることができます。これらは配列タイプの項目です。
配列タイプの項目は、項目のラベルの最後にある角括弧で識別できます。項目のラベルの右にある小さな黒い長方形をクリックすると、その要素の項目が表示されます。
配列について詳しくは、 Adobe Workfront Fusion の項目データタイプを参照してください。
配列の最初の要素をマッピングする
配列の Recipient name の項目を選択すると、次のようにフィールドに表示されます。
角括弧内の数値は、配列のどの要素を使用するかを決定するインデックスです。デフォルトでは 1 に設定されています。
配列の n 番目の要素をマッピングする
別の要素にアクセスする場合は、角括弧をクリックし、インデックス値を編集します。
指定されたキーで配列の要素をマッピングする
一部の配列には、キーと値の項目を持つ複数のコレクションが含まれています。これらは通常、様々なメタデータや属性などです。
次の例は、Jira アプリの出力を示しています。
この例では、ID が 10108 の特定の添付ファイルについて、添付ファイルの配列からファイル名を取得しています。
Jira の出力は、次のようになります。
一般的な要件は、指定されたキー値で要素を検索し、値項目から対応する値を取得することです。これは、map() および get() の関数の組み合わせにより、達成できます。
次に、数式について詳細な分類を示します。
-
map()の最初のパラメーター関数は配列の項目全体です。 -
2 つ目のパラメーターは、値の項目の未加工の名前です。未加工の名前を取得するには、マッピングパネルの項目にポインタを合わせます。
note note NOTE すべてのパラメーターでは大文字と小文字が区別されます。この特定の例では、項目のラベルと未加工の名前は大文字と小文字しか違いがありませんが、ラベルの値とは異なり、すべて小文字の値である未加工の名前を使う必要があります。 -
3 番目のパラメーターは、キー項目の未加工の名前です。
-
4 番目のパラメーターは、指定されたキー値です。
map() 関数は配列を返すので（指定されたキー値を持つ他の要素が存在する可能性があるため）、その最初の要素を取得するために get() 関数を適用する必要があります。
-
get()関数の最初のパラメーターはmap()関数の結果です。 -
2 番目のパラメーターは、要素のインデックスで、1 です。
map() 関数について詳しくは、 Adobe Workfront Fusion の配列関数を参照してください。
get() 関数について詳しくは、 Adobe Workfront Fusion の一般的な関数を参照してください。
要素を一連のバンドルに変換する
配列はイテレータモジュールを使用して、一連のバンドルに変換することができます。詳しくは、Adobe Workfront Fusion](https://experienceleague.adobe.com/workfront-fusion/modules/iterator-module.html?lang=ja) の[イテレータモジュールを参照してください。
トラブルシューティング
マッピングパネルに項目がありません
マッピングパネルには、モジュールごとに、モジュールの作成者が一覧表示するすべての出力項目が表示されます。場合によっては、このリストが様々な理由で未完了になったり、一部の項目が欠落していることがあります。Workfront Fusion では、シナリオエディターでモジュールを実行する際に、不足している出力項目を自動検出できます。正確な手順は、モジュールのタイプによって少し異なります。
インスタントトリガー
-
モジュールを右クリックし、表示されるメニューで「このモジュールのみを実行」をクリックします。
キュー内の web フックがない場合、モジュールは新しい web フックが処理されるまで待機します。
-
Web フックを生成します。
例えば、web フックモジュール Slack／新しいイベントをリッスンする（チャネル内の新しいチャネルメッセージを監視します）は、チャネルにメッセージを送信します。
-
モジュールの実行が終了したら、モジュールの上のバブルをクリックして、その出力全体を確認します。
マッピングパネルには、モジュールの出力で検出されたすべての項目が含まれます。
ポーリングトリガー
-
モジュールを右クリックし、表示されるメニューで「このモジュールのみを実行」をクリックします。
-
出力がない場合は、「開始場所を選択」をクリックして設定を調整します。
-
処理するイベントがない場合は、イベントを作成し、手順 2 に戻ります。
例えば、web フックモジュール Gmail／メールを監視 は、モジュールが監視しているフォルダーにメールを送信します。
-
モジュールの実行が終了したら、モジュールの上のバブルをクリックして、その出力全体を確認します。
マッピングパネルには、モジュールの出力で検出されたすべての項目が含まれるようになりました。
その他のモジュール
以下を実行することもできます。
-
シナリオ全体（またはモジュールを含む部分のみ）
シナリオがトリガーで始まる場合は、上記の「インスタントトリガー」または「ポーリングトリガー」の節を参照してください。
-
単一のモジュールのみ
単一のモジュールのみを実行する場合：
-
モジュールを右クリックし、表示されるメニューで「このモジュールのみを実行」をクリックします。
-
入力項目のサンプル値を指定し、「OK」をクリックします。
-
モジュールの実行が終了したら、モジュールの上のバブルをクリックして、その出力全体を確認します。
マッピングパネルには、モジュールの出力で検出されたすべての項目が含まれるようになりました。