Migrar pastas e documentos vinculados
Você pode usar a API para migrar pastas e documentos vinculados para o Adobe Experience Manager Assets.
Procedimento
-
Identifique todos os documentos e pastas vinculados ao provedor de armazenamento de documentos externo anterior, anotando seus identificadores internos de documentos ou pastas do Workfront, bem como a ID da pasta de qualquer pasta contêiner.
note note NOTE Você deve verificar todas as pastas ou documentos descobertos para verificar se eles ainda não criaram um link para eles com o novo provedor. -
Localize os documentos e pastas no novo repositório por caminho e, em seguida, procure sua identidade no sistema externo.
-
Crie um mapeamento da Workfront ID interna para a ID no novo armazenamento externo. Você precisa disso para criar um novo link na etapa a seguir.
-
Crie um novo link de documento ou pasta de documentos no Workfront, apontando para o recurso em seu novo local por meio da nova ID externa.
- Documentos: adicione uma nova versão do documento existente com o novo provedor de documentos externos.
- Pastas: Crie uma nova pasta no mesmo local com o mesmo nome.
Exemplo de processo para migrar links
Informações da API
Para obter mais informações sobre as APIs do Workfront nesta seção, consulte Documentação do desenvolvedor:Documentos.
Localizar todos os documentos
Localizar Todos os Documentos (DOCU) Vinculados ao Provedor de Documentos do providerType com documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/document/search?fields=currentVersion:*¤tVersion:externalIntegrationType={providerType}
Localizar todas as pastas
Localizar Todas as Pastas de Documentos (DOCFDR) Vinculadas ao Provedor de Documentos de providerType com documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/documentFolder/search?fields=*,linkedFolder:*&linkedFolder:externalIntegrationType={providerType}
API DOCS: (Endpoints de pasta de documentos não cobertos atualmente em developer.workfront.com)
Vincular documentos
Vincular Documentos (DOCU) do Provedor de Documento Externo do providerType com documentProviderID.
Http Method: POST
Endpoint: {host}/internal/documents/linkExternalObjects
Http Body:
refObjCode=DOCU&refObjID={documentId}&providerType={providerType}&documentProviderID={documentProviderID}
DOCUMENTOS DA API: (Endpoints de link internos não cobertos atualmente em developer.workfront.com)
Vincular pastas
Vincular Pastas de Documentos (DOCFDR) do Provedor de Documentos Externos do providerType com 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 DA API: (Endpoints de link internos não cobertos atualmente em developer.workfront.com)
Termos importantes
-
Documento: um ativo digital no Workfront
-
Pasta de documentos: um contêiner para ativos digitais no Workfront
-
ID do documento: ID interna da Workfront para um ativo digital
-
ID da Pasta de Documentos: ID interna da Workfront para uma pasta de ativos digitais
-
ID do Provedor de Documentos: ID associada a provedores de documentos específicos
-
Tipo de Provedor de Armazenamento de Documentos (também "Tipo de Integração Externa"): o tipo de integração do provedor de armazenamento de documentos ao qual a Workfront dá suporte. Por meio de uma integração dedicada ou uma "integração personalizada".
-
Tipos de Provedor de Armazenamento de Documentos Atuais ( providerType):
code language-none ATTASK BOX GOOGLE SHAREPOINT WEBDAM WORKFRONTDAM INFERNO WIDEN DROPBOX DROPBOX_BUSINESS ONEDRIVE QUIP WEBHOOKS AEM MOCK
-
Documento vinculado: um ativo digital hospedado em um provedor de armazenamento de documentos externo. O Workfront terá sua própria "ID do documento" interna para o ativo, mas os bytes são armazenados externamente. Para facilitar isso, o Workfront também armazena uma "ID de documento externa" para ajudar a localizar o recurso referenciado externamente no repositório ou armazenamento remoto.
-
Pasta de Documentos Vinculados: um contêiner de ativos digitais hospedados em um provedor de armazenamento de documentos externo. O Workfront terá sua própria "ID da pasta de documentos" interna para o ativo, mas os bytes são armazenados externamente. Para facilitar isso, o Workfront também armazena uma "ID de documento externa" para ajudar a localizar o recurso referenciado externamente no repositório ou armazenamento remoto.
-
ID do Documento Externo: ID atribuída quando os ativos são armazenados fora do Workfront. O Workfront mapeia seu identificador interno para o identificador usado para localizar o ativo no sistema externo, por meio desse campo "identificador de documento externo". Portanto, ao vincular o documento ou a pasta de um novo armazenamento externo, um novo identificador de documento externo deve ser composto, no formato apropriado para o provedor de documentos externos identificar o documento no novo repositório ou armazenamento.
note note NOTE O Workfront ainda não tem um padrão para identificadores de documentos externos. Uma nova especificação está sendo usada para IDs AEM, mas para outras IDs, a ID do documento externo pode assumir diferentes formas, dependendo do tipo de provedor. -
Tipo de Objeto: este é um termo somente para API para fins deste documento. É um tipo de objeto genérico no Workfront com o qual você deseja interagir. Nesse caso, você interagirá com documentos e pastas que têm os tipos "DOCU" e "DOCFDR", respectivamente.
-
ID do Objeto: o identificador interno do Workfront para o objeto genérico com o qual você deseja interagir. Você interagirá com documentos e pastas, portanto, essa será a ID do documento ou a ID da pasta do documento, respectivamente.