Verknüpfte Ordner und Dokumente migrieren
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 Dokumentenspeicher verknüpft sind, unter Angabe der internen Workfront-Dokument- oder -Ordnerkennungen sowie der Ordner-ID aller Ordner, die diesen Ordner enthalten.
note note NOTE Sie sollten nach allen gefundenen Ordnern oder Dokumenten suchen, um sicherzustellen, dass sie noch keinen Link mit dem neuen Anbieter erstellt haben. -
Suchen Sie die Dokumente und Ordner im neuen Repository nach Pfad und suchen Sie dann ihre Identität im externen System.
-
Erstellen Sie eine Zuordnung der internen Workfront ID zur ID im neuen externen Speicher. Sie benötigen dies, um im folgenden Schritt einen neuen Link zu erstellen.
-
Erstellen Sie in Workfront einen neuen Dokument- oder Dokumentordnerlink, der über die neue externe ID auf die Ressource am neuen Speicherort verweist.
- Dokumente: Fügen Sie mit dem neuen externen Dokumentenanbieter eine neue Version des vorhandenen Dokuments hinzu.
- Ordner: Erstellen Sie einen neuen Ordner an derselben Stelle mit demselben Namen.
Beispielprozess für die Migration von Links
API-Informationen
Weitere Informationen zu den Workfront-APIs finden Sie in diesem Abschnitt Entwicklerdokumentation:Dokumente.
Alle Dokumente suchen
Alle suchen Dokumente (DOCU) Verknüpfung zu Document Provider von providerType mit documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/document/search?fields=currentVersion:*¤tVersion:externalIntegrationType={providerType}
Suchen aller Ordner
Alle suchen Dokumentenordner (DOCFDR) Verknüpfung mit Document Provider von providerType mit documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/documentFolder/search?fields=*,linkedFolder:*&linkedFolder:externalIntegrationType={providerType}
API-DOCS: (Document Folder Endpoints, die derzeit nicht unter developer.workfront.com abgedeckt sind)
Verknüpfen von Dokumenten
Link 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-DOCS: (Interne Link-Endpunkte, die derzeit nicht unter developer.workfront.com abgedeckt sind)
Verknüpfungsordner
Link Dokumentenordner (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-DOCS: (Interne Link-Endpunkte, die derzeit nicht unter developer.workfront.com abgedeckt sind)
Wichtige Begriffe
-
Dokument: Ein digitales Asset in Workfront
-
Dokumentordner: Ein Container für digitale Assets in Workfront
-
Dokument-ID: Interne Workfront-ID für ein digitales Asset
-
Document Folder ID: Interne Workfront-ID für einen digitalen Asset-Ordner
-
Dokumentanbieter-ID: Kennung, die bestimmten Dokumentenanbietern zugeordnet ist
-
Document Storage Provider-Typ (auch "External Integration Type"): Der Typ der von Workfront unterstützten Document Storage Provider-Integration. Entweder über eine dedizierte Integration oder eine "benutzerdefinierte Integration".
-
Aktuelle Document Storage Provider-Typen ( 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 Dokumentenspeicheranbieter 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", die bei der Suche nach der extern referenzierten Ressource im Remote-Repository oder -Speicher hilft.
-
Verknüpfter Dokumentordner: Ein Container für digitale Assets, der in einem externen Dokumentenspeicheranbieter gehostet wird. Workfront verfügt über eine eigene interne "Dokumentordner-ID"für das Asset, die Bytes werden jedoch extern gespeichert. Um dies zu erleichtern, speichert Workfront auch eine "externe Dokument-ID", die bei der Suche nach der extern referenzierten Ressource im Remote-Repository oder -Speicher hilft.
-
Externe Dokument-ID: ID, die zugewiesen wird, wenn Assets außerhalb von Workfront gespeichert werden. Workfront ordnet seine interne Kennung über dieses Feld "Externe Dokumentkennung"der Kennung zu, die zum Suchen des Assets im externen System verwendet wird. Daher muss beim Verknüpfen des Dokuments oder Ordners aus einem neuen externen Speicher eine neue externe Dokumentkennung im entsprechenden Format erstellt werden, damit der externe Dokumentanbieter das Dokument im neuen Repository oder Store identifizieren kann.
note note NOTE Workfront verfügt noch nicht über einen Standard für externe Dokument-IDs. Für AEM IDs wird eine neue Spezifikation verwendet. Für andere IDs kann die externe Dokument-ID jedoch je nach Anbietertyp in verschiedenen Formularen verwendet werden. -
Objekttyp: Dies ist ein API-lediglich-Begriff für die Zwecke dieses Dokuments. Es handelt sich um eine Art generisches Objekt in Workfront, mit dem Sie interagieren möchten. In diesem Fall interagieren Sie mit Dokumenten und Ordnern mit den Typen "DOCU"bzw. "DOCFDR".
-
Objekt-ID: Die interne Workfront-Kennung für das generische Objekt, mit dem Sie interagieren möchten. Sie interagieren mit Dokumenten und Ordnern, sodass es sich entweder um die Dokument-ID oder um die Dokumentordner-ID handelt.