移轉連結的資料夾和檔案

您可以使用API將連結的資料夾和檔案移轉至Adobe Experience Manager Assets。

程式

  1. 識別與先前外部檔案儲存提供者連結的所有檔案和資料夾,並記錄其Workfront內部檔案或資料夾識別碼以及任何容納資料夾的資料夾ID。

    note note
    NOTE
    您應該檢查所有探索到的資料夾或檔案,以確認他們尚未與新的提供者建立連結。
  2. 依路徑在新存放庫中尋找檔案和資料夾,然後在外部系統中查詢其身分。

  3. 建立內部Workfront ID與新外部存放區中ID的對應。 您需要在下列步驟中建立新連結。

  4. 在Workfront中建立新檔案或檔案資料夾連結,透過其新外部ID指向新位置的資源。

    1. 檔案:使用新的外部檔案提供者新增現有檔案的新版本。
    2. 資料夾:在相同位置以相同名稱建立新資料夾。
CAUTION
請勿刪除現有的連結資料夾。 這可能會造成資料遺失。 若要從Workfront應用程式中移除舊資料夾連結,請在「設定」區域中停用自訂檔案整合。

移轉連結的範例程式

simplified-link-flow

API資訊

如需本節中Workfront API的詳細資訊,請參閱 開發人員檔案:檔案.

尋找所有檔案

尋找全部 檔案(DOCU) 連結至 檔案提供者providerType 替換為 Documentproviderid.

Http Method: GET

Http Endpoint: {host}/attask/api/v14.0/document/search?fields=currentVersion:*&currentVersion:externalIntegrationType={providerType}

API檔案參考

尋找所有資料夾

尋找全部 檔案資料夾(DOCFDR) 連結至檔案提供者: providerType 替換為 Documentproviderid.

Http Method: GET

Http Endpoint: {host}/attask/api/v14.0/documentFolder/search?fields=*,linkedFolder:*&linkedFolder:externalIntegrationType={providerType}

API檔案: (developer.workfront.com目前未涵蓋的檔案資料夾端點)

連結檔案

連結 檔案(DOCU)外部檔案提供者providerType 替換為 Documentproviderid.

IMPORTANT
檔案會暫時儲存。 也就是說,您可以存取檔案的所有版本。 當您建立連結時,可以指定現有的檔案ID,因此您只需將新版本寫入該檔案,且資料會由新的提供者於外部託管。 此檔案ID與您所取代檔案連結上的檔案ID相同。 這是相同的概唸檔案。 您只需指出這個新版本的位元組是儲存在不同的提供者中。
Http Method: POST

Endpoint: {host}/internal/documents/linkExternalObjects

Http Body:
refObjCode=DOCU&refObjID={documentId}&providerType={providerType}&documentProviderID={documentProviderID}

API檔案: (developer.workfront.com目前未涵蓋的內部連結端點)

連結資料夾

連結 檔案資料夾(DOCFDR)外部檔案提供者providerType 替換為 Documentproviderid.

IMPORTANT
針對資料夾連結,與檔案連結不同,您需要Workfront中要將新連結放置到的資料夾的「documentFolderId」。 這很可能與我們複製的連結資料夾是相同的父資料夾。
CAUTION
資料夾不會暫時儲存。 請勿刪除舊資料夾。 在設定區域中停用自訂檔案整合,以移除舊資料夾。
Http Method: POST

Endpoint: {host}/internal/document/version/linkExternal

Http Body:
providerType={providerType}&documentProviderID={documentProviderID}&breadcrumb=[]&linkAction=LINKEXTERNAL&refObjCode={USER|PROJECT_TASK|TEMPLATE_TASK|securityRootObjectCode}&refObjID={userID|taskID|templateTaskID|securityRootId}&destFolderID={parentFolderId}

API檔案: (developer.workfront.com目前未涵蓋的內部連結端點)

重要詞語

  • 檔案:Workfront中的數位資產

  • 檔案資料夾:Workfront中數位資產的容器

  • 檔案ID:數位資產的Workfront內部ID

  • 檔案資料夾ID:數位資產資料夾的Workfront內部ID

  • 檔案提供者ID:與特定檔案提供者相關聯的ID

IMPORTANT
對於任何特定的檔案提供者型別,客戶可以有多個連線的執行個體。 舉例來說,他們可能連結了多個AEM存放庫。 或多個連結的Google Drive執行個體。 檔案提供者ID指示我們要取代或切換到的連線型別的特定執行個體。
  • 檔案儲存提供者型別(也稱為「外部整合型別」):Workfront支援的檔案儲存提供者整合型別。 透過專用整合或「自訂整合」。

  • 目前檔案儲存提供者型別( providerType)

    code language-none
    ATTASK
    BOX
    GOOGLE
    SHAREPOINT
    WEBDAM
    WORKFRONTDAM
    INFERNO
    WIDEN
    DROPBOX
    DROPBOX_BUSINESS
    ONEDRIVE
    QUIP
    WEBHOOKS
    AEM
    MOCK
    
  • 連結的檔案:在外部檔案儲存提供者中託管的數位資產。 Workfront將有資產專用的內部「檔案ID」,但位元組會儲存在外部。 為方便起見,Workfront也會儲存「外部檔案ID」,以協助找出遠端存放庫或存放區中的外部參考資源。

  • 連結的檔案資料夾:在外部檔案儲存提供者中代管的數位資產容器。 Workfront將有資產專用的內部「檔案資料夾ID」,但位元組會儲存在外部。 為方便起見,Workfront也會儲存「外部檔案ID」,以協助找出遠端存放庫或存放區中的外部參考資源。

  • 外部檔案ID:將資產儲存在Workfront外部時指派的ID。 Workfront透過此「外部檔案識別碼」欄位,將其內部識別碼對應至用於在外部系統中尋找資產的識別碼。 因此,從新的外部存放區連結檔案或資料夾時,必須以適當的格式構成新的外部檔案識別碼,以便外部檔案提供者識別新存放庫或存放區中的檔案。

    note note
    NOTE
    Workfront還沒有外部檔案識別碼的標準。 AEM ID使用新的規格,但對於其他ID,外部檔案ID可能會根據提供者型別而採用不同的表單。
  • 物件型別:此為API字詞,僅供本檔案使用。 這是Workfront中您希望與其互動的通用物件型別。 在這種情況下,您將分別與型別為「DOCU」和「DOCFDR」的檔案和資料夾進行互動。

  • 物件ID:您要與其互動之一般物件的內部Workfront識別碼。 您將與檔案和資料夾互動,因此這將會是檔案ID或檔案資料夾ID。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43