ドキュメントWorkfrontWorkfront ガイド

ドキュメント Webhooks API

最終更新日: 2025年5月21日
  • トピック:

作成対象:

  • 開発者

Adobe Workfront のドキュメント Web フックは、Workfront が外部ドキュメントプロバイダーに対して認可された API 呼び出しを行う API エンドポイントのセットを定義します。これにより、誰でも任意のドキュメントストレージプロバイダー用のミドルウェアプラグインを作成できます。

Web フックベースの統合のユーザーエクスペリエンスは、Google Drive、Box、Dropboxなどの既存のドキュメント統合のユーザーエクスペリエンスに似ています。例えば、Workfront ユーザーは以下のアクションを実行できます。

  • 外部ドキュメントプロバイダーのフォルダー構造をナビゲート
  • ファイルを検索
  • ファイルを Workfront にリンク
  • 外部ドキュメントプロバイダーにファイルをアップロード
  • ドキュメントのサムネールを表示

参照の実装

新しい web フック実装の開発をすぐに開始できるように、Workfront では参照の実装を提供しています。このためのコードは https://github.com/Workfront/webhooks-app にあります。この実装は Java ベースで、Workfront がネットワークファイルシステム上でドキュメントに接続できるようにします。

Web フック統合の登録

Workfrontの 管理者は、Workfront 内で設定/ドキュメント/カスタム統合に移動して、会社のカスタム web フック統合を追加することができます。設定内のカスタム統合ページから、管理者は既存のドキュメント web フック統合のリストを表示することができます。このページから、統合を追加、編集、有効化、無効化することができます。統合を追加するには、「統合を追加」ボタンをクリックします。

使用可能なフィールド

統合を追加する際、管理者は以下のフィールドに値を入力します。

フィールド名説明
名前この統合の名前。
ベース API の URLコールバック API の場所。外部システムに対して呼び出しを行う場合、Workfrontはエンドポイント名をこのアドレスに追加します。 例えば、管理者が Base API URL の「https://www.mycompany.com/api/v1」を入力した場合、Workfront は次の URL を使用してドキュメントのメタデータを取得します:https://www.mycompany.com/api/v1/metadata?id=1234。
パラメーターのリクエストすべての API 呼び出しの文字列に追加されるオプションの値。例:access_type=offline
認証タイプOauth2 または ApiKey。
認証 URL(OAuth2 のみ)ユーザー認証に使用される完全な URL。Workfrontは、OAuth プロビジョニングプロセスの一環として、ユーザーをこのアドレスに移動させます。

メモ:Workfrontは、「state」パラメーターをクエリ文字列に追加します。 プロバイダーは、これを Workfront のリダイレクト URI に追加して、Workfront に返す必要があります。
トークンエンドポイント URL(OAuth2 のみ)OAuth2 トークンを取得するために使用される完全な API URL。これは、Webhook プロバイダーまたは外部ドキュメントプロバイダーがホストします。
クライアント ID(OAuth2 のみ)この統合用の OAuth2 クライアント ID。
クライアントシークレット(OAuth2 のみ)この統合用の OAuth2 クライアントの秘密鍵。
Workfront リダイレクト URI(OAuth2 のみ)これは読み取り専用のフィールドで、Workfront によって生成されます。この値は、この統合を外部のドキュメントプロバイダーに登録するために使用されます。

注意:認証 URL で前述したように、プロバイダは、リダイレクトを実行する際に「state」パラメータとその値をクエリ文字列に追加する必要があります。
ApiKey(ApiKey のみ)web フックプロバイダーに対して承認済み API 呼び出しを行うために使用されます。API キーは Webhook プロバイダーによって発行されます。

認証

Workfront ドキュメント web フックでは、OAuth2 および ApiKey の 2 種類の認証形式をサポートしています。どちらの場合も、Workfront は API を呼び出す際に、認証トークンをヘッダーに入れて渡します。

OAuth2

OAuth2 を使用すると、Workfront は、承認済み API 呼び出しをユーザーの代わりに web フックプロバイダーに対して行うことができます。その前に、外部ドキュメントプロバイダーアカウントをWorkfrontに接続し、自分の代わりに行動するためのWorkfront アクセス権を付与する必要があります。 このハンドシェイクプロセスは、ユーザーごとに 1 回だけ行われます。仕組みは次のとおりです。

  1. まずユーザーが自分のアカウントに web フック統合を接続します。現在は、ドキュメントを追加ドロップダウン/サービスを追加/カスタム統合名をクリックすることで、これを行います。

  2. Workfrontがユーザーを認証 URL に移動すると、外部のドキュメントプロバイダーにログインするように求められる場合があります。 このページは、web フックプロバイダーまたは外部ドキュメント管理システムによってホストされています。その際、Workfront は認証 URL に「state」パラメーターを追加します。同じ値を以下の手順で Workfront の戻り URI に追加することにより、この値を Workfront に返す必要があります。

  3. 外部システムにログインした後(または、ユーザーが既にログインしている場合)、ユーザーの代わりに一連のアクションを実行するためのアクセスをWorkfrontが要求していることを示す「認証」ページが表示されます。

  4. ユーザーが「許可」ボタンをクリックすると、ブラウザーはWorkfront リダイレクト URI にリダイレクトされ、クエリ文字列に「code=<code>」が追加されます。 OAuth2 仕様に従い、このトークンの有効期間は短く設定されています。また、クエリ文字列には「state=<sent_by_workfront>」も含める必要があります。

  5. Workfront はこのリクエストを処理し、認証コードを使用してトークンエンドポイント URL への API 呼び出しを行います。

  6. トークンエンドポイント URL は、更新トークンとアクセストークンを返します。

  7. Workfrontはこれらのトークンを保存し、このユーザーの webhook 統合を完全にプロビジョニングします。

  8. これ以降、Workfront は web フックプロバイダーに対して、承認済み API 呼び出しを実行できるようになります。これらの呼び出しを行う際に、Workfront は、以下に示すように、アクセストークンを HTTP リクエストヘッダーに入れて送信します。

    -------------------------------
    Authorization: Bearer [access_token] ­­­­­­­­­­­­­­­­­­­­­­­­­­
    -------------------------------
    
  9. アクセストークンの有効期限が切れている場合、Workfrontはトークンエンドポイント URL を呼び出して新しいアクセストークンを取得してから、新しいアクセストークンを使用して承認済み API 呼び出しを再試行します。

ApiKey

ApiKey を使用して web フックプロバイダーへの承認済み API 呼び出しを行う方が、OAuth2 よりもはるかに簡単です。API 呼び出しを行う際に、Workfront は ApiKey と Workfront ユーザー名を HTTP リクエストヘッダーに入れて渡すだけです。

-------------------------------

apiKey: 12345

username: johndoe@foo.com

-------------------------------

Web フックプロバイダーは、このユーザー名を使用して、ユーザー固有の権限を適用できます。これは、両方のシステムがシングルサインオン(SSO)を使用して LDAP に接続する場合に最適に機能します。

リクエストヘッダーの追加(オプション)

Workfront では、認証に OAuth2 トークンまたは ApiKey を使用する以外に、あらかじめ定義された一連のヘッダーを API 呼び出しごとに web フックプロバイダーに送信できます。Workfrontの管理者は、上記の節で説明したように、Webook Integration を登録または編集する際にこれを設定できます。

例えば、これは基本認証に使用できます。それには、Workfront 管理者がカスタム統合ダイアログで次のリクエストヘッダー情報を追加します。

Authorization Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

この QWxhZGRpbjpvcGVuIHNlc2FtZQ== は、「username:password」を Base64 でエンコードした文字列です。基本認証を参照してください。 これが追加されると、Workfrontは他のリクエストヘッダーに加えて、これを HTTP リクエストヘッダーで渡します。

­­­­­­­­­­­­­­­­­­­­­­­­­­-------------------------------

apiKey: 12345

username: johndoe@foo.com

Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== ­­­­­­­­­­­­­­­­­­­­­­­­­­

-------------------------------

API 仕様

ドキュメント web フックを機能させるために web フックプロバイダーが実装する必要がある API のリストを以下に示します。

OAuth2 トークンの取得(OAuth2 認証のみ必要)

認証済みユーザーの OAuth2 更新トークンとアクセストークンを返します。これは、ユーザーがドキュメントプロバイダーをプロビジョニングすると、1 回だけ呼び出されます。 その後の呼び出しは、更新されたアクセストークンを取得するために行われます。

HTTP リクエスト POST [任意の URL]

この URL は設定可能で、カスタム統合設定ページのトークンエンドポイント URL 値に対応しています。

クエリパラメーター

名前
必須
説明
grant_type
はい
値は「authorization_code」か「refresh_token」のいずれかです。指定した値は、この API 呼び出しに渡される 2 つのパラメーターのうち、code または refresh_token のいずれかを示します。
コード
依存関係
ユーザーが「許可」ボタンをクリックした直後にWorkfrontに送信される認証コード。 これは、grant_type が「authorization_code」の場合にのみ必要です。認証コードは短期間のみ有効で、通常は 10 分以内に期限が切れます。
refresh_token
依存関係
これは、以前の access_token が期限切れである場合に、新しい access_token を取得するために後続の呼び出しを行う場合にのみ必要です。この値を送信する場合は、grant_type パラメーターを「refresh_token」に設定します。
client_id
はい
このカスタム統合用に Workfront で設定されたクライアント ID。
client_secret
はい
このカスタム統合用に Workfront で設定されたクライアントの秘密鍵。

応答

名前
タイプ
説明
access_token.
文字列
ユーザーに代わって認証済み API 呼び出しを行うために使用されるトークン。許可されていない API 呼び出しを防ぐために期限切れになります。
refresh_token.
文字列
この API メソッドを呼び出して新しい access_token を取得するのに使用される、長期間有効なトークン。
expires_in,
long
(任意) access_token の有効期限が切れるまでの時間(秒単位)。通常は 3,600 です。

例

POST /oauth2/token
grant_type=authorization_code
code=d9ac7asdf6asdf579d7a8
client_id=123456
client_secret=6asdf7a7a9a4af

応答

{
"access_token":"ad8af5ad5ads759",
"refresh_token":"9a0h5d87d808ads",
"expires_id":"3600"
}

ファイルまたはフォルダーのメタデータの取得

指定されたファイルまたはフォルダーのメタデータを返します。

URL

GET /metadata?id=[document or folder ID]

クエリパラメーター

名前
説明
id

Webhook プロバイダーによって参照されるファイルまたはフォルダーの ID。 これは、Workfront のドキュメント ID とは異なります。ルートディレクトリのメタデータを取得するには、値「/」を使用します。

メモ:ID の最大長は 255 文字です。

応答

名前
タイプ
説明
タイトル
文字列
ドキュメントまたはフォルダーの名前。
kind
文字列
この項目がファイルかフォルダーかを指定します(「file」または「folder」)。
id
文字列
ファイルまたはフォルダーの ID。
viewLink
文字列
ブラウザーウィンドウでドキュメントを表示するためにユーザーが使用する URL パス。この URL は、ドキュメントプロバイダーかネイティブ外部ストレージプロバイダーのどちらかでホストできます。
downloadLink
文字列
ブラウザーウィンドウでドキュメントをダウンロードするためにユーザーが使用する URL パス。この URL は、ドキュメントプロバイダーかネイティブ外部ストレージプロバイダーのどちらかでホストできます。
mimeType
文字列
(オプション)ファイルの MIME タイプ。
dateModified
文字列
このファイルが最後に変更された時刻(形式は RFC 3339 タイムスタンプ)。
サイズ
Long
(オプション)ファイルのサイズ(バイト単位)。
readOnly
ブール値
(任意)このファイルまたはフォルダーが認証済みユーザーに対して読み取り専用かどうかを示します。

例:https://www.acme.com/api/metadata?id=12345

応答

{
"title":"My Document",
"kind":"file"
"id":"12345",
"viewLink":"https://www.acme.com/viewDocument?id=12345",
"downloadLink":"https://www.acme.com/downloadDocument?id=12345",
"mimeType":"image/png",
"dateModified":"2014­06­05T17:39:45.251Z",
"size": "32554694"
}
NOTE
エラー処理は、すべての API 呼び出しで一貫している必要があります。詳しくは、エラー処理の節を参照してください。

フォルダーに含まれる項目のリストの取得

指定されたフォルダーのファイルおよびフォルダーのメタデータを返します。

URL

GET /files

クエリパラメーター

名前
説明
parentId
フォルダー ID。ルートディレクトリのメタデータを取得するには、値「/」を使用します。

ドキュメント web フック API では、現在、ページネーションをサポートしていません。

応答

ファイルとフォルダーのリストを含んだ JSON。各項目のメタデータは、/metadata エンドポイントによって返されるものと同じです。

例:https://www.acme.com/api/files?parentId=123456

応答

[
{
"title":"Folder A",
"kind":"folder",
"id":"2lj23lkj",
"viewLink":"https://www.acme.com/viewDocument?id=2lj23lkj",
"downloadLink":"https://www.acme.com/downloadDocument?id=2lj23lkj",
"mimeType":"",
"dateModified":"2014­06­05T17:39:45.251Z",
"size":""
},
{
"title":"My Document",
"kind":"file",
"id":"da8cj234"
"viewLink":"https://www.acme.com/viewDocument?id=da8cj234",
"downloadLink":"https://www.acme.com/downloadDocument?id=da8cj234",
"mimeType":"image/png",
"dateModified":"2014­06­05T17:39:45.251Z",
"size":"32554694"
},
]

検索の実行

検索から返されたファイルやフォルダーのメタデータを返します。これは、全文検索としてまたは通常のデータベースクエリとして実行できます。ユーザーが外部ファイルブラウザーから検索を実行すると、Workfront が /search エンドポイントを呼び出します。

URL

GET /search

クエリパラメーター

名前
説明
query
検索語または検索フレーズ
parentId
(オプション)検索を実行したフォルダー ID。

メモ:これは、Workfrontの今後の機能のプレースホルダーです。 現在、Workfrontはこのパラメーターを渡していません。

ドキュメント web フック API では、現在、ページネーションをサポートしていません。

応答

クエリに一致するファイルやフォルダーのメタデータのリストを含んだ JSON。何をもって「一致」とするかは、web フックプロバイダーによって決まります。フルテキスト検索またはファイル名ベースの検索を行うのが理想的です。

例:https://www.acme.com/api/search?query=test-query

応答

[
{ File/Folder Metadata },
{ File/Folder Metadata }
]

ドキュメントのコンテンツの取得

ドキュメントの生バイトを返します。

URL

GET /download

クエリパラメーター

名前
説明
id
ドキュメント ID

応答

ドキュメントの未加工のバイトデータ。

例:https://www.acme.com/api/download?id=123456

ドキュメントのサムネールの取得

ドキュメントのサムネールの未加工バイトデータを返します。

URL

GET /thumbnail

クエリパラメーター

名前
説明
id
ドキュメント ID
size
サムネールの幅。

応答

サムネールの未加工のバイトデータです。

例:https://www.acme.com/api/thumbnail?id=123456

ファイルのアップロード(前半)

ファイルをドキュメントストレージプロバイダーにアップロードするには、2 つの異なる API エンドポイントを必要とする 2 つの手順のプロセスです。 Workfront は、/uploadInit を呼び出して、アップロードプロセスを開始します。このエンドポイントはドキュメント ID を返し、ドキュメントのバイトをアップロードする際にこのドキュメント ID が/upload に渡されます。 基になるドキュメントのストレージシステムによっては、長さが 0 のドキュメントを作成してから、後でドキュメントの内容を更新する必要が生じる場合があります。

ドキュメント ID とドキュメントバージョン ID を使用して、Workfront から追加の情報を取得できる機能が、この仕様のバージョン 1.1 に追加されました。例えば、ドキュメント管理システムがドキュメントに関する追加情報を必要とする場合に、web フックの実装コードでドキュメント ID を使用して、Workfront の RESTful API でその情報を取得するといったことができます。ベストプラクティスとして、この情報は、ドキュメント上のカスタムデータフィールド、およびドキュメントに含まれるタスク、イシューまたはプロジェクトから取得できます。

URL

POST /uploadInit

クエリパラメーター

名前
説明
parentId
Web フックプロバイダーで参照される親フォルダー ID。
filename
ドキュメントの名前。
documentId
Workfront ドキュメント ID (バージョン 1.1 で追加)。
documentVersionId
Workfront ドキュメントのバージョン ID (バージョン 1.1 で追加)。

応答

/metadata エンドポイントで定義した、ファイルのメタデータです。

例:https://www.acme.com/api/uploadInit?parentId=12345&filename=new-file.png&docu mentId=511ea6e000023edb38d2effb2f4e6e3b&documentVersionId=511ea6e000023edb38d2e ffb2f4e6e3b

応答

[file_metadata] には、ドキュメントプロバイダーで使用される新しいドキュメント ID が含まれます。

ファイルのアップロード(後半)

Web フックプロバイダーにドキュメントのバイトデータをアップロードします。

URL

PUT /upload

クエリパラメーター

名前
説明
id
前半で作成されたドキュメント ID。

リクエスト本文

ドキュメントの Raw コンテンツのバイトデータです。

応答

{
"result": "success"
}

または

{
"result": "fail"
}

例:https://www.acme.com/api/upload?id=1234 [更新ストリームに含まれるドキュメントのバイトデータ]

応答

{
"result":"success"
}

サービスに関する情報の取得

(リリース日 - 未定)特長や機能など、サービスに関する情報を返します。Workfront では、この情報を使用して Workfront のユーザーインターフェイスをカスタマイズします。例えば、web フックの実装にいくつかのカスタムアクションが含まれている場合、それらの操作は JSON でリストする必要があります。それにより、ユーザーは、これらのアクションを Workfront から呼び出すことができるようになります。

URL

GET /serviceInfo

クエリパラメーター

なし。さらに、このエンドポイントへの呼び出しには、認証も必要ありません。

応答

このサービスに関する情報を含む JSON。

名前
タイプ
説明
webhookVersion
文字列
このサービスで実装されている web フックのバージョン。この仕様の一番上にリストされているバージョン番号です。
version
文字列
このサービスの内部バージョン番号。この番号は web フックサービスプロバイダーが定め、情報提供の目的でのみ使用されます。
publisher
文字列
Web フックの実装を提供する会社の名前。
availableEndpoints
文字列
このサービスで実装される API エンドポイントを含んだリスト。これは、Workfront のユーザーインターフェイスに、web フックプロバイダーから提供される機能が確実に反映されるようにするために使用されることがあります。リスト内の各項目には、エンドポイントの名前(「search」など)を含める必要があります。
customActions
文字列
この web フックで実装されているカスタム操作を含んだリストです。各リスト項目には、名前と表示名が含まれます。表示名は、Workfrontのドキュメントアクションドロップダウンに表示されます。 ドロップダウンで項目をクリックすると、/customAction エンドポイントを呼び出して、Webhook のアクションが呼び出されます。

例: https://www.acme.com/api/serviceInfo

戻り値

{
"webhook version": "1.2", "version": "1.0", "publisher": "Acme, LLC", "availableEndpoints": ["files", "metadata", "search", "download"

"thumbnail", "uploadInit", "upload" ], "customActions" [
{
"name": "archive", "displayName": "Archive" }, {

"name": "doSomethingElse", "displayName": "Do Something" }, ] }

フォルダーを作成

(バージョン 1.2 で追加)特定のディレクトリにフォルダーを作成します。
URL

POST /createFolder

クエリパラメーター

名前
説明
parentId
フォルダーを作成するフォルダー ID。
名前
新しいフォルダーの名前。

応答

新しく作成されたフォルダーのメタデータ(/metadata エンドポイントで定義)。

例:POST https://www.acme.com/api/createFolder

-------------------------------

parentId=1234

name=New Folder ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­

-------------------------------

戻り値

{"title":"New Folder",
 "kind":"folder""id":"5678",
 "viewLink":"",
 "downloadLink":"",
 "mimeType":"",
 "dateModified":"2014­06­05T17:39:45.251Z"
 "size": ""
 }

ドキュメントまたはフォルダーの削除

(リリース日 - 未定)外部システム内の特定の ID を持つドキュメントまたはフォルダーを削除します。フォルダーを削除すると、その内容も削除されます。

URL

PUT /delete

クエリパラメーター

名前
説明
documentId
削除するドキュメント ID。
folderId
削除するフォルダー ID。

成功または失敗を示す応答 JSON 文字列(この後の「エラー処理」の節を参照)。

例: PUT https://www.acme.com/api/delete?documentId=1234

戻り値

{
"status": "success"
}

戻り値

{
"status": "failure", "error": "File not found"
}

ドキュメントまたはフォルダーの名前変更

(リリース日 - 未定)外部システム内の特定の ID を持つドキュメントまたはフォルダーの名前を変更します。

URL

PUT /rename

クエリパラメーター

名前
説明
id
名前を変更するドキュメントまたはフォルダーの ID。
名前
ドキュメントまたはフォルダの新しい名前。

応答

成功または失敗を示す JSON 文字列(この後の「エラー処理」の節を参照)。

例:

PUT https://www.acme.com/api/rename

-------------------------------

id=1234

name=Folder B ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­

-------------------------------
{
"status": "success"
}returns
{
"status": "failure", error: "Folder cannot be renamed because a folder with that name already exists."
}

カスタムアクションの実行

(リリース日 - 未定)このエンドポイントを使用すると、Workfront ユーザー(または自動化ワークフローイベント)が外部システムでアクションを実行できるようになります。/customAction エンドポイントは、「name」パラメーターを受け取ります。これにより、web フックプロバイダーは複数のカスタム操作を実装できます。

Web フックプロバイダーでは、カスタムアクションを /serviceInfo 応答の customActions 下に含めることで、Workfront に登録します。設定/ドキュメント/カスタム統合で web フックプロバイダーを設定または更新すると、Workfront がこのリストを読み込みます。
カスタムアクションの実行

ユーザーは、「ドキュメントアクション」の下のセクションを選択して、カスタムアクションをトリガーできます。
トリガーのカスタム アクション

URL

GET /customAction

クエリパラメーター

名前
説明
名前
実行するアクションのタイプを指定する識別子。この値は、/serviceInfo エンドポイントから返される customAction 値のうちの 1 つに対応します。
documentId
アクションの実行対象となる Workfront ドキュメントの ID。
documentVersionId
アクションを実行する Workfront ドキュメント バージョン ID です。

応答

成功または失敗を示す JSON 文字列(この後の「エラー処理」の節を参照)。失敗(status = "failure")の場合、Workfront は、用意されているエラーメッセージをユーザーに表示します。

例: https://sample.com/webhooks/customName?name=archive&documentId=5502082c003a4f30ddec2fb2b739cb7c&documentVersionId=54b598a700e2342d6971597a5df1a8d3

応答

{
"status": "success"
}

エラー処理

API リクエストを処理する際に問題が発生する場合があります。その対応は、すべての API エンドポイントで一貫した方法で行う必要があります。エラーが発生した場合は、web フックプロバイダーが以下を行います。

  • 応答ヘッダーにエラーコードを含めます。エラーコードの例は次のとおりです。

    • 403 - Forbidden(禁止されている)リクエストトークンが見つからない、または無効であるか、トークンに関連付けられている資格情報に、指定されたリソースへのアクセス権がないことを示します。OAuth ベースの web フックプロバイダーの場合、Workfront は新しいアクセストークンの取得を試みます。
    • 404 - Not found(見つからない)指定したファイルまたはフォルダーが存在しないことを示します。
    • 500 - Internal Server Error(内部サーバーエラー)その他の種類のエラーです。
  • 応答の本文に次の形式でエラーの説明を記述します。

{
"status": "error"
"error": "Sample error message"
}

テスト

ドキュメント web フックの実装が正しく動作することを確認するには、以下のテストを実行します。これらは、Workfront web インターフェイスを介して web フック実装のエンドポイントに間接的にヒットする手動のテストです。

前提条件

これらのテストを実行するには、以下が必要です。

  • Advanced Document Management (ADM)が有効になっているWorkfront アカウント。
  • システム管理者権限を持つこのアカウントのWorkfront ユーザー。
  • Workfrontから HTTP エンドポイントにアクセスできる Document Webhook インスタンス。

またこれらのテストでは、Workfront の設定/ドキュメント/カスタム統合でドキュメント web フックインスタンスを既に登録していることも前提としています。

テスト 1:ユーザーへのドキュメント web フックサービスのプロビジョニング

OAuth ベースの web フックプロバイダーの認証 URL とトークンエンドポイント URL をテストします。

  1. Workfront で、上部のナビゲーションバーにある「ドキュメント」リンクをクリックして、ドキュメントのメインページに移動します。
  2. ドキュメントを追加ドロップダウンをクリックし、サービスを追加で Document Webhook サービスを選択します。
  3. (OAuth サービスのみ)前の手順を完了すると、サービスの OAuth2 認証ページがポップアップウィンドウに読み込まれます。 (メモ:最初にサービスにログインするように求められる場合があります)。 認証ページで、「信頼」または「許可」ボタンをクリックして、Workfrontにユーザーのアカウントへのアクセス権を付与します。
  4. サービスがドキュメントの追加ドロップダウンに追加されたことを確認します。初めに表示されない場合は、ブラウザーを更新してみてください。

テスト 2:Workfront へのドキュメントのリンク(/files および /metadata エンドポイントをテストします)

  1. Workfront で、上部のナビゲーションバーにある「ドキュメント」リンクをクリックして、ドキュメントのメインページに移動します。
  2. 「ドキュメントを追加」でドキュメント web フックサービスを選択します。
  3. モーダルでフォルダー構造内を移動します。
  4. フォルダー構造内を正しく移動できることを確認します。
  5. ドキュメントを選択してWorkfrontにリンクします。

テスト 3:コンテンツ管理システム内のドキュメントへの移動

/metadata エンドポイント(特に viewLink)をテストします。

  1. Workfront にドキュメントをリンクします。
  2. そのドキュメントを選択し、「開く」リンクをクリックします。
  3. ドキュメントが新しいタブで開くことを確認します。

テスト 4:コンテンツ管理システム内のドキュメントへの移動(ログインを使用)

/metadata エンドポイント(特に viewLink)をテストします。

  1. コンテンツ管理システムからログアウトしていることを確認します。
  2. Workfront にドキュメントをリンクします。
  3. そのドキュメントを選択し、「開く」リンクをクリックします。
  4. コンテンツ管理システムのログイン画面が新しいタブに読み込まれることを確認します。
  5. ログインし、ドキュメントに移動したことを確認します。

テスト 5:コンテンツ管理システムからのドキュメントのダウンロード

/metadata エンドポイント(特に downloadLink)をテストします。

  1. Workfront にドキュメントをリンクします。
  2. そのドキュメントを選択し、「ダウンロード」リンクをクリックします。
  3. ダウンロードが開始されることを確認します。

テスト 6:コンテンツの検索

/search エンドポイントをテストします。

  1. Workfront で、上部のナビゲーションバーにある「ドキュメント」リンクをクリックして、ドキュメントのメインページに移動します。
  2. 「ドキュメントを追加」でドキュメント web フックサービスを選択します。
  3. モーダルで検索を実行します。
  4. 検索結果が正しいことを確認します。

テスト 7:Workfront からコンテンツ管理システムへのドキュメントの送信

/files、/uploadInit および /upload エンドポイントをテストします。

  1. Workfront で、上部のナビゲーションバーにある「ドキュメント」リンクをクリックして、ドキュメントのメインページに移動します。
  2. コンピューターからWorkfrontにドキュメントをアップロードします。
  3. ドキュメントの詳細ページに移動します。
  4. ドキュメントアクション ドロップダウンから、「送信先」の下のドキュメント Webhook サービスを選択します。
  5. 目的の宛先フォルダーに移動し、「保存」ボタンをクリックします。
  6. ドキュメントがコンテンツ管理システム内の正しい場所にアップロードされていることを確認します。

テスト 8:Workfront でのサムネールの表示

/thumbnail エンドポイントをテストします。

  1. Workfront にドキュメントをリンクします。
  2. リストでドキュメントを選択します。
  3. サムネールが右側のパネルに表示されることを確認します。

テスト 9:コンテンツのバイトデータの取得

/download エンドポイントをテストします。

  1. Workfront にドキュメントをリンクします。
  2. ドキュメントの詳細ページに移動します。
  3. ドキュメント アクション/送信先/Workfront を選択して、ドキュメントを Workfront に送信します。この結果、Workfront に新しいドキュメントバージョンが作成されます。
  4. 「ダウンロード」リンクをクリックして、このドキュメントを Workfront からダウンロードします。

テスト 10:アクセストークンの更新(OAuth2 web フックプロバイダーの場合のみ)

トークンエンドポイント URL のエンドポイントをテストします。

  1. ユーザーに Document Webhook サービスをプロビジョニングします。
  2. ユーザーのアクセストークンがタイムアウトするのを待つか、外部システムで手動で無効にすることで、そのユーザーのアクセストークンを無効にします。
  3. Workfront でアクセストークンを更新します。それには、例えば、Workfront にドキュメントをリンクします。ドキュメントに移動してリンクできれば、アクセストークンが正常に更新されたことがわかります。
NOTE
現在、リンクされたドキュメントの場合は「送信先」を使用できません。この機能は Workfront に追加される予定です。/download エンドポイントをテストするには、Postman などの REST クライアントを使用して、手動でエンドポイントにヒットさせます。または、デジタルプルーフを生成して、/download エンドポイントをテストすることもできます。デジタルプルーフを有効にするには、Workfront 管理者にお問い合わせください。

バージョン

  • バージョン 1.0(リリース日 - 2015年5月)

    • 初期仕様
  • バージョン 1.1(リリース日 - 2015年6月)

    • /uploadInit の更新 - documentId と documentVersionId の追加
  • バージョン 1.2(リリース日 - 2015年10月)

    • /createFolder の追加
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43