Migrieren von verknüpften Ordnern und Dokumenten
Sie können die -API verwenden, um verknüpfte Ordner und Dokumente nach Adobe Experience Manager Assets zu migrieren.
Verfahren
-
Identifizieren Sie alle Dokumente und Ordner, die mit dem vorherigen externen Dokumentenspeicheranbieter verknüpft sind, und notieren Sie ihre internen Dokument- oder Ordnerkennungen in Workfront sowie die Ordner-ID aller enthaltenen Ordner.
note note NOTE Sie sollten nach allen gefundenen Ordnern oder Dokumenten suchen, um sicherzustellen, dass noch kein Link für sie mit dem neuen Anbieter erstellt wurde. -
Suchen Sie die Dokumente und Ordner im neuen Repository nach dem Pfad und suchen Sie dann im externen System nach ihrer Identität.
-
Erstellen Sie eine Zuordnung der internen Workfront-ID zur ID im neuen externen Store. Sie benötigen dies, um im folgenden Schritt einen neuen Link zu erstellen.
-
Erstellen Sie einen neuen Link für ein Dokument oder einen Dokumentordner in Workfront, der über die neue externe ID auf die Ressource an deren neuem Speicherort verweist.
- Dokumente: Eine neue Version des vorhandenen Dokuments mit dem neuen externen Dokumentanbieter hinzufügen.
- Ordner: Erstellen Sie einen neuen Ordner an derselben Stelle mit demselben Namen.
Beispielprozess zum Migrieren von Links
API-Informationen
Weitere Informationen zu den Workfront-APIs finden Sie in diesem Abschnitt unter Entwicklerdokumentation:Dokumente.
Alle Dokumente suchen
Alle Dokumente (DOCU) verknüpft mit Dokumentanbieter von providerType mit documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/document/search?fields=currentVersion:*¤tVersion:externalIntegrationType={providerType}
Alle Ordner suchen
Alle Dokumentenordner (DOCFDR), mit dem Dokumentanbieter () verknüpft, documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/documentFolder/search?fields=*,linkedFolder:*&linkedFolder:externalIntegrationType={providerType}
API-Dokumente: (Endpunkte für Dokumentenordner werden derzeit nicht unter developer.workfront.com behandelt)
Dokumente verknüpfen
Verknüpfung Dokumente (DOCU) von Externer Dokumentanbieter von providerType mit documentProviderID.
Http Method: POST
Endpoint: {host}/internal/documents/linkExternalObjects
Http Body:
refObjCode=DOCU&refObjID={documentId}&providerType={providerType}&documentProviderID={documentProviderID}
API-Dokumente: (Endpunkte für interne Links werden derzeit nicht unter developer.workfront.com behandelt)
Ordner verknüpfen
Verknüpfung Dokumentordner (DOCFDR von Externer Dokumentanbieter von providerType mit 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-Dokumente: (Endpunkte für interne Links werden derzeit nicht unter developer.workfront.com behandelt)
Wichtige Begriffe
-
Dokument: Ein digitales Asset in Workfront
-
Dokumentenordner: Ein Container für digitale Assets in Workfront
-
Dokument-ID: Interne Workfront-ID für ein digitales Asset
-
Dokumentordner-ID: Interne Workfront-ID für einen Ordner für digitale Assets
-
Dokumentanbieter-ID: ID, die bestimmten Dokumentanbietern zugeordnet ist
-
Document Storage Provider Type (auch „External Integration Type„): Der Integrationstyp des Document Storage Providers, den Workfront unterstützt. Entweder über eine dedizierte Integration oder eine „benutzerdefinierte Integration“.
-
Aktuelle Typen von Dokumentspeicheranbietern ( providerType):
code language-none ATTASK BOX GOOGLE SHAREPOINT WEBDAM WORKFRONTDAM INFERNO WIDEN DROPBOX DROPBOX_BUSINESS ONEDRIVE QUIP WEBHOOKS AEM MOCK -
Verknüpftes Dokument: Ein digitales Asset, das in einem externen Dokumentspeicheranbieter gehostet wird. Workfront verfügt über eine eigene interne „Dokument-ID“ für das Asset, die Bytes werden jedoch extern gespeichert. Um dies zu erleichtern, speichert Workfront auch eine „externe Dokument-ID“, um die Suche nach der extern referenzierten Ressource innerhalb des Remote-Repositorys oder -Speichers zu erleichtern.
-
Verknüpfter Dokumentordner: Ein Container für digitale Assets, der in einem externen Dokumentspeicheranbieter gehostet wird. Workfront verfügt für das Asset über eine eigene interne „Dokumentenordner-ID“, die Bytes werden jedoch extern gespeichert. Um dies zu erleichtern, speichert Workfront auch eine „externe Dokument-ID“, um die Suche nach der extern referenzierten Ressource innerhalb des Remote-Repositorys oder -Speichers zu erleichtern.
-
ID des externen: ID, die zugewiesen wird, wenn Assets außerhalb von Workfront gespeichert werden. Workfront ordnet seine interne Kennung der Kennung zu, die zum Auffinden des Assets im externen System verwendet wird, und zwar über dieses Feld „Kennung des externen Dokuments“. Daher muss beim Verknüpfen des Dokuments oder Ordners aus einem neuen externen Speicher eine neue externe Dokumentkennung in dem entsprechenden Format erstellt werden, damit der externe Dokumentanbieter das Dokument in dem neuen Repository oder Speicher identifizieren kann.
note note NOTE Workfront verfügt noch nicht über einen Standard für externe Dokumentkennungen. Für AEM-IDs wird eine neue Spezifikation verwendet. Für andere IDs kann die ID des externen Dokuments jedoch je nach Anbietertyp unterschiedliche Formen annehmen. -
Objekttyp: Dies ist ein API-Begriff für die Zwecke dieses Dokuments. Es handelt sich um ein generisches Objekt in Workfront, mit dem Sie interagieren möchten. In diesem Fall interagieren Sie mit Dokumenten und Ordnern, die die Typen „DOCU“ bzw. „DOCDR“ aufweisen.
-
Objekt-ID: Die interne Workfront-Kennung für das generische Objekt, mit dem Sie interagieren möchten. Sie interagieren mit Dokumenten und Ordnern, sodass dies entweder die Dokument-ID oder die Dokument-Ordner-ID ist.