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 carpeta nueva 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 los documentos (DOCU) vinculados 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}
Referencia de DOCUMENTOS DE API
Buscar todas las carpetas
Buscar todas las carpetas de documentos (DOCFDR) vinculadas 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
Vincular 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
Vincular 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
-
ID de carpeta de documentos: ID interno de Workfront para una carpeta de recursos digitales
-
ID 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 de 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 vinculado: 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 vinculados: Un contenedor para recursos digitales hospedados 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.
-
ID 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: se trata de un término de API únicamente para los fines 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: El identificador Workfront interno 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.