Migrer les dossiers et les documents liés
Vous pouvez utiliser l’API pour migrer les dossiers et documents liés vers Adobe Experience Manager Assets.
Procédure
-
Identifiez tous les documents et dossiers liés au fournisseur externe précédent de stockage de documents, en notant leurs identifiants de document ou de dossier internes Workfront ainsi que l’identifiant de dossier de tout dossier contenant.
note note NOTE Vous devez rechercher tous les dossiers ou documents découverts pour vérifier qu’ils n’ont pas déjà créé de lien pour eux avec le nouveau fournisseur. -
Recherchez les documents et les dossiers dans le nouveau référentiel par chemin d’accès, puis recherchez leur identité dans le système externe.
-
Créez un mappage de l’Workfront ID interne sur l’ID dans le nouveau magasin externe. Vous en avez besoin pour créer un lien à l’étape suivante.
-
Créez un lien vers un nouveau document ou dossier de document dans Workfront, en pointant vers la ressource à son nouvel emplacement via son nouvel ID externe.
- Documents: ajoutez une nouvelle version du document existant avec le nouveau fournisseur de documents externe.
- Dossiers: créez un dossier portant le même nom au même endroit.
Exemple de processus de migration de liens
Informations sur l’API
Pour plus d’informations sur les API Workfront de cette section, voir Documentation destinée aux développeurs : documents.
Recherche de tous les documents
Tout rechercher Documents (DOCU) Associé à Fournisseur de documents de providerType avec documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/document/search?fields=currentVersion:*¤tVersion:externalIntegrationType={providerType}
Recherche de tous les dossiers
Tout rechercher Dossiers de document (DOCFDR) Lié au fournisseur de document de providerType avec documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/documentFolder/search?fields=*,linkedFolder:*&linkedFolder:externalIntegrationType={providerType}
Documentation d’API : (points de fin de dossier de document non actuellement couverts à l’adresse developer.workfront.com)
Lier des documents
Lien Documents (DOCU) de Fournisseur de documents externe de providerType avec documentProviderID.
Http Method: POST
Endpoint: {host}/internal/documents/linkExternalObjects
Http Body:
refObjCode=DOCU&refObjID={documentId}&providerType={providerType}&documentProviderID={documentProviderID}
Documentation API : (points de terminaison de lien interne non actuellement couverts à l’adresse developer.workfront.com)
Lier des dossiers
Lien Dossiers de document (DOCFDR) de Fournisseur de documents externe de providerType avec 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}
Documentation API : (points de terminaison de lien interne non actuellement couverts à l’adresse developer.workfront.com)
Termes importants
-
Document: ressource numérique dans Workfront
-
Document Folder: conteneur pour les ressources numériques dans Workfront
-
Document ID: identifiant interne Workfront d’une ressource numérique
-
Document Folder ID: identifiant interne Workfront pour un dossier de ressources numériques
-
ID de fournisseur de documents: identifiant associé à des fournisseurs de documents spécifiques
-
Type de fournisseur de stockage de documents (également "Type d’intégration externe"): type d’intégration du fournisseur de stockage de documents prise en charge par Workfront. Soit par le biais d’une intégration dédiée, soit par une "intégration personnalisée".
-
Types de fournisseurs de stockage de documents actuels (providerType):
code language-none ATTASK BOX GOOGLE SHAREPOINT WEBDAM WORKFRONTDAM INFERNO WIDEN DROPBOX DROPBOX_BUSINESS ONEDRIVE QUIP WEBHOOKS AEM MOCK
-
Document lié: ressource numérique hébergée dans un fournisseur externe de stockage de documents. Workfront aura son propre "ID de document" interne pour la ressource, mais les octets sont stockés en externe. Pour faciliter cette opération, Workfront stocke également un "ID de document externe" afin de faciliter la localisation de la ressource référencée en externe dans le référentiel ou le magasin distant.
-
Linked Document Folder: conteneur pour les ressources numériques hébergées dans un fournisseur externe de stockage de documents. Workfront aura son propre "ID de dossier de document" interne pour la ressource, mais les octets sont stockés en externe. Pour faciliter cette opération, Workfront stocke également un "ID de document externe" afin de faciliter la localisation de la ressource référencée en externe dans le référentiel ou le magasin distant.
-
ID de document externe: identifiant attribué lorsque les ressources sont stockées en dehors de Workfront. Workfront mappe son identifiant interne à l'identifiant utilisé pour localiser la ressource dans le système externe, via ce champ "identifiant document externe". Par conséquent, lors de la liaison du document ou du dossier à partir d’un nouveau magasin externe, un nouvel identifiant de document externe doit être composé, dans le format approprié, pour que le fournisseur de documents externe identifie le document dans le nouveau référentiel ou magasin.
note note NOTE Workfront ne dispose pas encore d’une norme pour les identifiants de document externe. Une nouvelle spécification est en cours d’utilisation pour les ID d’AEM, mais pour les autres ID, l’ID de document externe peut prendre différentes formes selon le type de fournisseur. -
Type d’objet: il s’agit d’un terme d’API uniquement aux fins de ce document. C’est un type d’objet générique dans Workfront avec lequel vous souhaitez interagir. Dans ce cas, vous interagissez avec des documents et des dossiers de type "DOCU" et "DOCFDR" respectivement.
-
Identifiant d’objet: identifiant Workfront interne de l’objet générique avec lequel vous souhaitez interagir. Vous interagissez avec des documents et des dossiers, ce qui correspond respectivement à l’ID de document ou à l’ID de dossier de document.