Adobe Workfront モジュール

任意の Adobe Workfront Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ

Workfront Ultimate

Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。

標準

Work またはそれ以上

Workfront コネクターは、OAuth 2.0 を使用して Workfront に継続します。

Workfront アカウントへの接続を Workfront Fusion モジュール内から直接作成できます。

• クライアント ID とクライアントシークレットを使用した Workfront への接続
• サーバー間接続を使用した Workfront への接続

クライアント ID とクライアントシークレットを使用した Workfront への接続

1. 任意の Adobe Workfront モジュールで、「接続」フィールドの横にある「追加」をクリックします。

2. 次のフィールドに入力します。

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
   Connection type	Adobe Workfront auth connection を選択します。
   Connection name	新しい接続の名前を入力します。
   Client ID	Workfront クライアント ID を入力します。これは、Workfront の設定エリアの OAuth2 アプリケーションエリアにあります。接続している特定のアプリケーションを開いて、クライアント ID を確認します。
   Client Secret	Workfront クライアントシークレットを入力します。これは、Workfront の設定エリアの OAuth2 アプリケーションエリアにあります。Workfront で OAuth2 アプリケーションのクライアントシークレットがない場合は、別のシークレットを生成できます。手順について詳しくは、Workfront ドキュメントを参照してください。
   Authentication URL	これはデフォルト値のままにすることもできますし、Workfront インスタンスの URL に続けて /integrations/oauth2 を入力することもできます。 例： https://mydomain.my.workfront.com/integrations/oauth2
   Host prefix	ほとんどの場合、この値は origin にしてください。

3. 「続行」をクリックして接続を保存し、モジュールに戻ります。

   Workfront にログインしていない場合は、ログイン画面が表示されます。ログイン後、接続を許可できます。

サーバー間接続を使用した Workfront への接続

1. 任意の Adobe Workfront モジュールで、「接続」フィールドの横にある「追加」をクリックします。

2. 次のフィールドに入力します。

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header
   Connection type	「Adobe Workfront サーバー間接続」を選択します。
   Connection name	新しい接続の名前を入力します。
   Instance name	インスタンス（ドメインとも呼ばれます）の名前を入力します。 例：URL が https://example.my.workfront.com の場合は、example と入力します。
   Instance lane	この接続の接続先となる環境タイプを入力します。 例：URL が https://example.my.workfront.com の場合は、my と入力します。
   Client ID	Workfront クライアント ID を入力します。これは、Workfront の設定エリアの OAuth2 アプリケーションエリアにあります。接続している特定のアプリケーションを開いて、クライアント ID を確認します。
   Client Secret	Workfront クライアントシークレットを入力します。これは、Workfront の設定エリアの OAuth2 アプリケーションエリアにあります。Workfront で OAuth2 アプリケーションのクライアントシークレットがない場合は、別のシークレットを生成できます。手順について詳しくは、Workfront ドキュメントを参照してください。
   Scopes	この接続に適用可能なスコープを入力します。
   Host prefix	ほとんどの場合、この値は origin にしてください。

3. 「続行」をクリックして接続を保存し、モジュールに戻ります。

   Workfront にログインしていない場合は、ログイン画面が表示されます。ログイン後、接続を許可できます。

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

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

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

• トリガー
• アクション
• 検索

トリガー

モジュールが監視する Workfront レコードのタイプを選択します。

例えば、タスクでレコードフィールドが更新されるたびにシナリオの実行を開始する場合は、Task を選択します。

モジュールが監視する Workfront レコードのタイプを選択します。

例えば、新しいプロジェクトが作成されるたびにシナリオを開始するには、「Project」を選択します。

オブジェクトの ID を入力します。

メモ：オブジェクトの ID を入力する場合は、オブジェクトの名前を入力していき、目的のオブジェクトがリストに表示されたら、それを選択します。そうすると、モジュールが適切な ID をフィールドに入力します。

プロジェクトに変換する場合は、プロジェクトに使用するテンプレートの ID を選択します。

メモ：オブジェクトの ID を入力する場合は、オブジェクトの名前を入力していき、目的のオブジェクトがリストに表示されたら、それを選択します。そうすると、モジュールが適切な ID をフィールドに入力します。

モジュールで作成する Workfront レコードのタイプを選択します。

例えば、プロジェクトを作成する場合は、ドロップダウンリストから Project を選択します。

データ入力に使用するフィールドを選択します。これにより、不要なフィールドをスクロールしなくても、これらのフィールドを使用できます。その後、これらのフィールドにデータを入力またはマッピングできます。

カスタムフォームのフィールドの場合は、「Attach Custom Form」フィールドを使用します。

• オブジェクトの ID を入力する際に、オブジェクトの名前を入力し、リストから選択できます。そうすると、モジュールが適切な ID をフィールドに入力します。
• カスタムフィールドまたはメモオブジェクト（コメントまたは返信）にテキストを入力する際、「メモテキスト」フィールドで HTML タグを使用して、太字や斜体などのリッチテキストを作成できます。

• 個々のユーザーの解決

  code language-none
  ユーザーリストで個々のユーザーを解決できます。

• 大きなバッチで追加されたユーザーの解決

  大きなバッチで追加されたユーザーを解決するには、ユーザーのバッチを Adobe Admin Console に直接追加します。

  手順については、アドビドキュメントの複数ユーザーの管理 | CSV の一括アップロードを参照してください。

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。これにより、リクエストのコンテンツタイプが決まります。

例： {"Content-type":"application/json"}

メモ：エラーが表示され、エラーの発生元を特定するのが困難な場合は、Workfront ドキュメントに基づいてヘッダーの変更を考慮してください。カスタム API 呼び出しで 422 HTTP リクエストエラーが返される場合は、"Content-Type":"text/plain" ヘッダーを使用してみてください。

API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。

例： {"name":"something-urgent"}

ヒント：情報は、クエリパラメーターではなく、JSON 本文を使用して送信することをお勧めします。

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ：

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

モジュールが削除するレコードの一意の Workfront ID を入力します。

ID を取得するには、ブラウザーで Workfront オブジェクトを開き、URL の末尾の「ID=」の後のテキストをコピーします。例：https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

1. レコードを同期的に削除します。
2. レコード削除モジュールにエラー処理を追加し、40 秒のタイムアウトによるエラーを無視します。

モジュールでダウンロードするドキュメントの一意の Workfront ID をマッピングするか、手動で入力します。

ID を取得するには、ブラウザーで Workfront オブジェクトを開き、URL の末尾の「ID=」の後のテキストをコピーします。例：https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

モジュールで実行するアクションを選択します。

選択した Record Type と Action に応じて、追加のフィールドに入力する必要がある場合があります。この 2 つの設定の組み合わせによっては、レコード ID しか必要ないものもあれば、追加情報（オブジェクト ID やテンプレート ID など）を必要とするもの（Record Type のプロジェクトや Action の Attach Template など）もあります。

一部のアクションで使用できるオプションについて詳しくは、この記事のその他のアクションオプションを参照してください。

個々のフィールドについて詳しくは、Workfront 開発者ドキュメントを参照してください。

メモ：開発者ドキュメントサイトには、API バージョン 14 を通じた情報のみが含まれていますが、API 呼び出しに関する有用な情報がまだ含まれています。

1. Workfront 開発者ドキュメントページの左側のナビゲーションからレコードタイプを選択します。以下のタイプには、独自のページがあります。

   • Projects

   • Tasks

   • Issues

   • Users

   • Documents

   その他のすべてのレコードタイプに対して、Other objects and endpoints を選択し、アルファベット順に並べ替えられたページでレコードタイプを探します。

2. 適切なレコードタイプのページで、アクションを検索（Ctrl + F キーまたは Command + F キー）します。

3. 選択したアクションで使用可能なフィールドの説明を表示します。

メモ：

Workfront Misc Action モジュールを使用してプルーフを作成する場合、詳細オプションを使用せずにプルーフを作成し、Workfront Proof SOAP API を使用してプルーフを更新するのがベストプラクティスです。

（このモジュールが使用する）Workfront API を使用したプルーフの作成について詳しくは、Adobe Workfront API を使用したプルーフの作成時に高度なプルーフオプションを追加を参照してください。

モジュールがやり取りするレコードの一意の Workfront ID を入力またはマッピングします。

ID を取得するには、ブラウザーで Workfront オブジェクトを開き、URL の末尾の「ID=」の後のテキストをコピーします。例：https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

• clearApprovers

• clearAssignments

• clearConstraints

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  財務データをクリア

• clearPermission

• clearPredecessors

• clearProgress

• clearTimedNotifications

  リマインダー通知をクリア

• clearApprovers

• clearAssignments

• clearDocuments

• clearConstraints

• clearExpenses

• clearFinancials

  財務データをクリア

• clearPermission

• clearPredecessors

• clearProgress

• clearTimedNotifications

  リマインダー通知をクリア

• clearApprovers
• clearAssignments
• clearCustomData
• clearDocuments
• clearPermission
• clearProgress

• preserveIssue

  元のイシューを保持し、その解決策をこのタスクに関連付け

• preservePrimaryContact

  イシューのプライマリ連絡先にこのタスクへのアクセスを許可

• preserveCompletionDate

  イシューの予定完了日を維持

• preserveIssue

  元のイシューを保持し、その解決策をこのタスクに関連付け

• preservePrimaryContact

  イシューのプライマリ連絡先にこのタスクへのアクセスを許可

• clearApprovers

• clearAssignments

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  財務データをクリア

• clearPermission

• clearPredecessors

• clearProgress

• clearTimedNotifications

  リマインダー通知をクリア

• clearApprovers

• clearAssignments

• clearBillingRates

• clearConstraints

• clearDeliverables

  目標をクリア

• clearDocuments

• clearExpenses

• clearFinancials

  財務データをクリア

• clearHourTypes

• clearIssueSetup

  キュープロパティおよびイシュー設定をクリア

• clearPredecessors

• clearRisks

• clearSharingOptions

• clearTimedNotifications

  リマインダー通知をクリア

モジュールが読み取るレコードの一意の Workfront ID を入力します。

ID を取得するには、ブラウザーで Workfront オブジェクトを開き、URL の末尾の「ID=」の後のテキストをコピーします。例：https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

モジュールが更新するレコードの一意の Workfront ID を入力します。

ID を取得するには、ブラウザーで Workfront オブジェクトを開き、URL の末尾の「ID=」の後のテキストをコピーします。例：https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

新しいレコードのフィールド値を指定するカスタムフォームを選択します。フォームを選択したら、そのフォーム上のフィールドのデータを入力します。

このモジュールに添付するフォームのフィールド値を指定するには、「マッピングするフィールド」セクションにカスタムフォーム ID を含めます。

読み取る関連レコードの親レコード（Workfront オブジェクト）のタイプを選択します。

このモジュールを使用できる Workfront オブジェクトタイプのリストについて詳しくは、この記事の各 Workfront モジュールで使用可能な Workfront オブジェクトタイプを参照してください。

読み取る関連レコードの親レコードの ID を入力またはマッピングします。

ID を取得するには、ブラウザーで Workfront オブジェクトを開き、URL の末尾の「ID=」の後のテキストをコピーします。例：https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

検索するフィールド、クエリで使用する演算子、およびそのフィールドで検索する値を入力します。

メモ：検索条件に username を使用しないでください。Workfront への API クエリに username を含めると、そのユーザーが Workfront に記録され、検索は成功しません。

メモ：In と NotIn は配列で動作します。入力は配列形式である必要があります。

検索するフィールド、クエリで使用する演算子、およびそのフィールドで検索する値を入力します。

メモ：検索条件に username を使用しないでください。Workfront への API クエリに username を含めると、そのユーザーが Workfront に記録され、検索は成功しません。

メモ：In と NotIn は配列で動作します。入力は配列形式である必要があります。