Eseguire la migrazione di cartelle e documenti collegati
Puoi utilizzare l’API per migrare cartelle e documenti collegati in Adobe Experience Manager Assets.
Procedura
-
Identificare tutti i documenti e le cartelle collegati al precedente provider di archiviazione documenti esterno, notando i relativi identificatori interni di documenti o cartelle Workfront e l'ID cartella di qualsiasi cartella contenitore.
note note NOTE È necessario verificare che non sia già stato creato un collegamento con il nuovo provider per tutte le cartelle o tutti i documenti individuati. -
Individuare i documenti e le cartelle nel nuovo repository in base al percorso, quindi cercare la relativa identità nel sistema esterno.
-
Crea una mappatura dell’ID Workfront interno sull’ID nel nuovo archivio esterno. Per creare un nuovo collegamento, segui il passaggio seguente.
-
Crea un nuovo collegamento a documento o cartella documenti in Workfront, che punta alla risorsa nella nuova posizione tramite il nuovo ID esterno.
- Documenti: aggiungi una nuova versione del documento esistente con il nuovo provider di documenti esterno.
- Cartelle: crea una nuova cartella nella stessa posizione con lo stesso nome.
Processo di esempio per la migrazione dei collegamenti
Informazioni API
Per ulteriori informazioni sulle API di Workfront in questa sezione, consulta Documentazione per sviluppatori:Documenti.
Trova tutti i documenti
Trova tutto Documenti (DOCU) Collegato a Provider documento di providerType con documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/document/search?fields=currentVersion:*¤tVersion:externalIntegrationType={providerType}
Documentazione di riferimento API
Trova tutte le cartelle
Trova tutto Cartelle documenti (DOCFDR) Collegato al provider di documenti di providerType con documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/documentFolder/search?fields=*,linkedFolder:*&linkedFolder:externalIntegrationType={providerType}
DOCS API: (gli endpoint per cartelle di documenti non sono attualmente inclusi in developer.workfront.com)
Collega documenti
Collegamento Documenti (DOCU) da Provider documento esterno di providerType con documentProviderID.
Http Method: POST
Endpoint: {host}/internal/documents/linkExternalObjects
Http Body:
refObjCode=DOCU&refObjID={documentId}&providerType={providerType}&documentProviderID={documentProviderID}
DOCUMENTAZIONE API: (gli endpoint per collegamenti interni non sono attualmente inclusi in developer.workfront.com)
Collega cartelle
Collegamento Cartelle documenti (DOCFDR) da Provider documento esterno di 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}
DOCUMENTAZIONE API: (gli endpoint per collegamenti interni non sono attualmente inclusi in developer.workfront.com)
Termini importanti
-
Documento: risorsa digitale in Workfront
-
Cartella documenti: contenitore per risorse digitali in Workfront
-
ID documento: ID interno di Workfront per una risorsa digitale
-
ID cartella documenti: ID interno di Workfront per una cartella di risorse digitali
-
ID provider documenti: ID associato a provider di documenti specifici
-
Tipo di provider di archiviazione documenti (anche "tipo di integrazione esterna"): tipo di integrazione del provider di archiviazione dei documenti supportata da Workfront. Tramite un’integrazione dedicata o una "integrazione personalizzata".
-
Tipi di provider di archiviazione documenti correnti ( providerType):
code language-none ATTASK BOX GOOGLE SHAREPOINT WEBDAM WORKFRONTDAM INFERNO WIDEN DROPBOX DROPBOX_BUSINESS ONEDRIVE QUIP WEBHOOKS AEM MOCK -
Documento collegato: risorsa digitale ospitata in un provider di archiviazione documenti esterno. Workfront avrà un proprio "ID documento" interno per la risorsa, ma i byte vengono memorizzati esternamente. Per facilitare questa operazione, Workfront memorizza anche un "ID documento esterno" per facilitare l’individuazione della risorsa a cui si fa riferimento esternamente all’interno dell’archivio o dell’archivio remoto.
-
Cartella documenti collegati: contenitore per risorse digitali ospitato in un provider di archiviazione documenti esterno. Workfront avrà un proprio "ID cartella documenti" interno per la risorsa, ma i byte vengono archiviati esternamente. Per facilitare questa operazione, Workfront memorizza anche un "ID documento esterno" per facilitare l’individuazione della risorsa a cui si fa riferimento esternamente all’interno dell’archivio o dell’archivio remoto.
-
ID documento esterno: ID assegnato quando le risorse vengono memorizzate al di fuori di Workfront. Workfront mappa il proprio identificatore interno all’identificatore utilizzato per individuare la risorsa nel sistema esterno, tramite questo campo "identificatore documento esterno". Pertanto, quando si collega il documento o la cartella da un nuovo archivio esterno, è necessario comporre un nuovo identificatore di documento esterno nel formato appropriato affinché il provider di documenti esterni possa identificare il documento nel nuovo archivio o archivio.
note note NOTE Workfront non dispone ancora di uno standard per gli identificatori di documenti esterni. È in uso una nuova specifica per gli ID AEM, ma per altri ID, l’ID documento esterno può assumere forme diverse a seconda del tipo di provider. -
Tipo di oggetto: termine utilizzato solo nelle API ai fini del presente documento. Si tratta di un tipo di oggetto generico all’interno di Workfront con cui desideri interagire. In questi casi, si interagirà con documenti e cartelle di tipo "DOCU" e "DOCFDR" rispettivamente.
-
ID oggetto: identificatore interno di Workfront per l’oggetto generico con cui desideri interagire. Interagirai con documenti e cartelle in modo che questo sia rispettivamente l’ID del documento o l’ID della cartella del documento.