Adobe Workfront モジュール

任意のAdobe Workfront ワークフローパッケージと任意のAdobe Workfront Automation and Integration パッケージ

WorkfrontUltimate

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

標準

ワークまたはそれ以上

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	新しい接続の名前を入力します。
   インスタンス名 ​	インスタンスの名前（ドメインとも呼ばれます）を入力します。 例：URL が https://example.my.workfront.com の場合は、example と入力します。
   インスタンス レーン ​	この接続の接続先となる環境タイプを入力します。 例：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 Fusion でWorkfront モジュールを設定する場合、以下に示すフィールドが表示されます。 これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加のWorkfront フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。

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

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

トリガー

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

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

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

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

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

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

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

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

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

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

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

カスタムフォームのフィールドの場合は、「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 その他アクション ​ モジュールを使用してプルーフを作成する場合、ベストプラクティスは、詳細なオプションを使用せずにプルーフを作成し、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 は配列で動作します。入力は配列形式である必要があります。