Migrer des dossiers et des 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 les 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 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’ID Workfront interne sur l’ID dans le nouvel entrepôt 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 auprès du nouveau fournisseur de documents externe.
- Dossiers : créez un dossier au même endroit avec le même nom.
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 à l’équipe de développement : documents.
Rechercher tous les documents
Rechercher tous les documents (DOCU) associés au fournisseur de documents du providerType avec documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/document/search?fields=currentVersion:*¤tVersion:externalIntegrationType={providerType}
Rechercher tous les dossiers
Recherchez tous les dossiers de documents (DOCFDR) liés au fournisseur de document du providerType avec documentProviderID.
Http Method: GET
Http Endpoint: {host}/attask/api/v14.0/documentFolder/search?fields=*,linkedFolder:*&linkedFolder:externalIntegrationType={providerType}
API DOCS : (points d’entrée du dossier de documents non actuellement couverts à l’adresse developer.workfront.com)
Lier les documents
Lier les documents (DOCU) de fournisseur de documents externe du providerType avec documentProviderID.
Http Method: POST
Endpoint: {host}/internal/documents/linkExternalObjects
Http Body:
refObjCode=DOCU&refObjID={documentId}&providerType={providerType}&documentProviderID={documentProviderID}
API DOCS : (points d’entrée de lien interne non actuellement couverts à l’adresse developer.workfront.com)
Lier des dossiers
Liez les dossiers de documents (DOCFDR) de fournisseur de documents externe du 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}
API DOCS : (points d’entrée de lien interne non actuellement couverts à l’adresse developer.workfront.com)
Termes importants
-
Document : ressource numérique dans Workfront
-
Dossier de documents : conteneur pour les ressources numériques dans Workfront
-
ID du document : ID interne Workfront d’une ressource numérique
-
ID du dossier de documents : ID 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 via une intégration dédiée, soit via 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 par 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 distant ou entrepôt.
-
Dossier du document lié : un conteneur pour les ressources numériques hébergées par 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 distant ou entrepôt.
-
ID de document externe : ID 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 de document externe ». Par conséquent, lors de la liaison du document ou du dossier à partir d’un nouvel entrepôt 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 le nouvel entrepôt.
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. Il s’agit d’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 : l’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.