Migrera länkade mappar och dokument
Du kan använda API:t för att migrera länkade mappar och dokument till Adobe Experience Manager Assets.
Förfarande
-
Identifiera alla dokument och mappar som är länkade till den tidigare externa dokumentlagringsleverantören och notera deras interna dokument- eller mappidentifierare i Workfront samt mapp-ID:t för eventuella mappar.
note note NOTE Du bör söka efter alla identifierade mappar eller dokument för att kontrollera att de inte redan har skapat en länk för dem med den nya providern. -
Leta reda på dokumenten och mapparna i den nya databasen efter sökväg och slå sedan upp deras identitet i det externa systemet.
-
Skapa en mappning av det interna Workfront-id:t till ID:t i den nya externa butiken. Du behöver det här för att skapa en ny länk i följande steg.
-
Skapa en länk till ett nytt dokument eller en ny dokumentmapp i Workfront som pekar på resursen på dess nya plats via dess nya externa ID.
- Dokument: Lägg till en ny version av det befintliga dokumentet med den nya externa dokumentprovidern.
- Mappar: Skapa en ny mapp på samma plats med samma namn.
Exempelprocess för att migrera länkar
API-information
Mer information om Workfront API:er finns i Utvecklardokumentation:Dokument.
Sök efter alla dokument
Sök efter alla dokument (DOCU) som är länkade till dokumentprovidern för providerType med documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/document/search?fields=currentVersion:*¤tVersion:externalIntegrationType={providerType}
Söka efter alla mappar
Sök efter alla dokumentmappar (DOCFDR) som är länkade till dokumentprovidern för providerType med documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/documentFolder/search?fields=*,linkedFolder:*&linkedFolder:externalIntegrationType={providerType}
API DOCS: (Slutpunkter för dokumentmapp som för närvarande inte omfattas på developer.workfront.com)
Länka dokument
Länka Dokument (DOCU) från extern dokumentprovider för providerType med documentProviderID.
Http Method: POST
Endpoint: {host}/internal/documents/linkExternalObjects
Http Body:
refObjCode=DOCU&refObjID={documentId}&providerType={providerType}&documentProviderID={documentProviderID}
API DOCS: (interna länkslutpunkter som för närvarande inte omfattas på developer.workfront.com)
Länka mappar
Länka Dokumentmappar (DOCFDR) från extern dokumentprovider för providerType med documentProviderID.
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 DOCS: (interna länkslutpunkter som för närvarande inte omfattas på developer.workfront.com)
Viktiga termer
-
Dokument: En digital resurs i Workfront
-
Dokumentmapp: En behållare för digitala resurser i Workfront
-
Dokument-ID: Workfront internt ID för en digital resurs
-
ID för dokumentmapp: Workfront internt ID för en digital resursmapp
-
Dokumentleverantörs-ID: ID associerat med specifika dokumentleverantörer
-
Typ av dokumentlagringsprovider (även "extern integreringstyp"): Den typ av dokumentlagringsproviderintegration som Workfront stöder. Antingen via en dedikerad integrering eller en"anpassad integrering".
-
Aktuella dokumentlagringsprovidertyper (providerType):
code language-none ATTASK BOX GOOGLE SHAREPOINT WEBDAM WORKFRONTDAM INFERNO WIDEN DROPBOX DROPBOX_BUSINESS ONEDRIVE QUIP WEBHOOKS AEM MOCK -
Länkat dokument: En digital resurs på en extern dokumentlagringsleverantör. Workfront har ett internt"dokument-ID" för resursen, men byten lagras externt. För att underlätta detta lagrar Workfront även ett "externt dokument-ID" som hjälp att hitta den externt refererade resursen i fjärrdatabasen eller fjärrbutiken.
-
Länkad dokumentmapp: En behållare för digitala resurser på en extern dokumentlagringsleverantör. Workfront kommer att ha ett internt "dokumentmapp-ID" för resursen, men byten lagras externt. För att underlätta detta lagrar Workfront även ett "externt dokument-ID" som hjälp att hitta den externt refererade resursen i fjärrdatabasen eller fjärrbutiken.
-
Externt dokument-ID: ID tilldelas när resurser lagras utanför Workfront. Workfront mappar sin interna identifierare till den identifierare som används för att hitta resursen i det externa systemet via detta"externa dokumentidentifierarfält". När du länkar ett dokument eller en mapp från en ny extern lagringsplats måste därför en ny extern dokumentidentifierare sättas samman i lämpligt format för att den externa dokumentleverantören ska kunna identifiera dokumentet i den nya databasen eller arkivet.
note note NOTE Workfront har ännu ingen standard för externa dokumentidentifierare. En ny specifikation används för AEM ID, men för andra ID kan det externa dokument-ID:t ha olika former beroende på providertypen. -
Objekttyp: Det här är en API-term som bara används i det här dokumentet. Det är en typ av generiskt objekt inom Workfront som du vill interagera med. I så fall interagerar du med dokument och mappar som har typerna "DOCU" respektive "DOCFDR".
-
Objekt-ID: Den interna Workfront-identifieraren för det generiska objekt som du vill interagera med. Du kommer att interagera med dokument och mappar så att det blir antingen dokument-ID:t eller dokumentmapp-ID:t.