Migración de carpetas y documentos vinculados
Puede utilizar la API para migrar carpetas y documentos vinculados a Adobe Experience Manager Assets.
Procedimiento
-
Identifique todos los documentos y carpetas vinculados con el proveedor de almacenamiento de documentos externo anterior, teniendo en cuenta sus identificadores de carpeta o documento interno de Workfront, así como el ID de carpeta de cualquier carpeta contenedora.
note note NOTE Debe comprobar todas las carpetas o documentos detectados para comprobar que aún no han creado un vínculo para ellos con el nuevo proveedor. -
Busque los documentos y carpetas en el nuevo repositorio por ruta y, a continuación, busque su identidad en el sistema externo.
-
Cree una asignación del Workfront ID interno al ID en el nuevo almacén externo. Esto es necesario para crear un vínculo nuevo en el siguiente paso.
-
Cree un nuevo documento o vínculo de carpeta de documentos en Workfront que señale al recurso en su nueva ubicación mediante su nuevo ID externo.
- Documentos: agregue una nueva versión del documento existente con el nuevo proveedor de documentos externo.
- Carpetas: cree una nueva carpeta en el mismo lugar con el mismo nombre.
Proceso de ejemplo para migrar vínculos
Información de API
Para obtener más información sobre las API de Workfront en esta sección, consulte Documentación para desarrolladores:Documentos.
Buscar todos los documentos
Buscar todos Documentos (DOCU) Vinculado a Proveedor de documentos de providerType con documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/document/search?fields=currentVersion:*¤tVersion:externalIntegrationType={providerType}
Buscar todas las carpetas
Buscar todos Carpetas de documentos (DOCFDR) Vinculado al proveedor de documentos de providerType con documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/documentFolder/search?fields=*,linkedFolder:*&linkedFolder:externalIntegrationType={providerType}
DOCUMENTOS DE API: (Puntos finales de carpeta de documentos no cubiertos actualmente en developer.workfront.com)
Enlazar documentos
Vínculo Documentos (DOCU) de Proveedor de documentos externos de providerType con documentProviderID.
Http Method: POST
Endpoint: {host}/internal/documents/linkExternalObjects
Http Body:
refObjCode=DOCU&refObjID={documentId}&providerType={providerType}&documentProviderID={documentProviderID}
DOCUMENTOS DE API: (Puntos finales de vínculo interno no cubiertos actualmente en developer.workfront.com)
Vincular carpetas
Vínculo Carpetas de documentos (DOCFDR) de Proveedor de documentos externos de providerType con 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}
DOCUMENTOS DE API: (Puntos finales de vínculo interno no cubiertos actualmente en developer.workfront.com)
Términos importantes
-
Documento: un recurso digital en Workfront
-
Carpeta de documentos: un contenedor para recursos digitales en Workfront
-
ID de documento: ID interno de Workfront para un recurso digital
-
Identificador de carpeta de documentos: ID interno de Workfront para una carpeta de recursos digitales
-
Identificador de proveedor de documentos: ID asociado con proveedores de documentos específicos
-
Tipo de proveedor de almacenamiento de documentos (también "tipo de integración externa"): tipo de integración del proveedor de almacenamiento de documentos que admite Workfront. Mediante una integración dedicada o una "integración personalizada".
-
Tipos de proveedor de almacenamiento de documentos actuales ( providerType):
code language-none ATTASK BOX GOOGLE SHAREPOINT WEBDAM WORKFRONTDAM INFERNO WIDEN DROPBOX DROPBOX_BUSINESS ONEDRIVE QUIP WEBHOOKS AEM MOCK
-
Documento enlazado: Un recurso digital alojado en un proveedor de almacenamiento de documentos externo. Workfront tendrá su propio "ID de documento" interno para el recurso, pero los bytes se almacenan externamente. Para facilitarlo, Workfront también almacena un "ID de documento externo" para ayudar a localizar el recurso al que se hace referencia externamente en el repositorio o almacén remoto.
-
Carpeta de documentos enlazados: un contenedor para recursos digitales alojados en un proveedor de almacenamiento de documentos externo. Workfront tendrá su propio "ID de carpeta de documentos" interno para el recurso, pero los bytes se almacenan externamente. Para facilitarlo, Workfront también almacena un "ID de documento externo" para ayudar a localizar el recurso al que se hace referencia externamente en el repositorio o almacén remoto.
-
Identificador de documento externo: ID asignado cuando los recursos se almacenan fuera de Workfront. Workfront asigna su identificador interno al identificador utilizado para localizar el recurso en el sistema externo, a través de este campo "identificador de documento externo". Por lo tanto, al vincular el documento o la carpeta desde un nuevo almacén externo, se debe crear un nuevo identificador de documento externo, en el formato adecuado para que el proveedor de documentos externos identifique el documento en el nuevo repositorio o almacén.
note note NOTE Workfront todavía no tiene un estándar para identificadores de documentos externos. AEM Se está utilizando una nueva especificación para ID de, pero para otros ID, el ID del documento externo puede adoptar diferentes formas según el tipo de proveedor. -
Tipo de objeto: Este es un término de API únicamente a los efectos de este documento. Es un tipo de objeto genérico dentro de Workfront con el que desea interactuar. En estos casos, interactuará con documentos y carpetas que tengan los tipos "DOCU" y "DOCFDR" respectivamente.
-
ID de objeto: Identificador interno de Workfront del objeto genérico con el que desea interactuar. Interactuará con documentos y carpetas, por lo que será el ID del documento o el ID de la carpeta del documento respectivamente.