DocumentatieWorkfrontHandleiding voor Workfront

Gekoppelde mappen en documenten migreren

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Gebruiker

U kunt de API gebruiken om gekoppelde mappen en documenten te migreren naar Adobe Experience Manager Assets.

Procedure

  1. Identificeer alle documenten en mappen die aan het vorige externe documentopslagbureau zijn gekoppeld. Hierbij worden de interne document- of mapid's van de Workfront en alle mappen met deze map vermeld.

    note note
    NOTE
    Controleer alle ontdekte mappen of documenten om te controleren of ze nog geen koppeling voor deze mappen of documenten hebben gemaakt met de nieuwe provider.

  2. Zoek de documenten en mappen in de nieuwe opslagplaats op pad en zoek vervolgens hun identiteit op in het externe systeem.

  3. Maak een toewijzing van de interne Workfront-id aan de id in de nieuwe externe opslag. U hebt dit nodig om in de volgende stap een nieuwe koppeling te maken.

  4. Maak een koppeling naar een nieuw document of een nieuwe documentmap in Workfront en wijs de bron via de nieuwe externe id naar de nieuwe locatie.

    1. Documenten: voeg een nieuwe versie van het bestaande document met de nieuwe externe documentleverancier toe.
    2. Omslagen: Creeer een nieuwe omslag in de zelfde plaats met de zelfde naam.
CAUTION
Verwijder de bestaande gekoppelde mappen niet. Dit kan leiden tot gegevensverlies. Als u oude mapkoppelingen uit de Workfront-toepassing wilt verwijderen, schakelt u de integratie van aangepaste documenten in het gedeelte Instellen uit.

Voorbeeld van migreren van koppelingen

vereenvoudigd-verbinding-stroom

API-informatie

Voor meer informatie over Workfront APIs in deze sectie, zie Documentatie van de Ontwikkelaar:Documenten.

Alle documenten zoeken

Vind Alle Documenten (DOCU) verbonden aan Leverancier van het Document van providerType met documentProviderID.

Http Method: GET

Http Endpoint: {host}/attask/api/v14.0/document/search?fields=currentVersion:*&currentVersion:externalIntegrationType={providerType}

API verwijzing DOCS

Alle mappen zoeken

Vind Alle Omslagen van het Document (DOCFDR) verbonden aan de Leverancier van het Document van providerType met documentProviderID.

Http Method: GET

Http Endpoint: {host}/attask/api/v14.0/documentFolder/search?fields=*,linkedFolder:*&linkedFolder:externalIntegrationType={providerType}

API DOCS: (Eindpunten van documentmap worden momenteel niet gedekt door developer.workfront.com)

Documenten koppelen

De Documenten van de verbinding (DOCU) van Externe Leverancier van het Document van providerType met documentProviderID.

IMPORTANT
Documenten worden tijdelijk opgeslagen. Dit betekent dat u toegang hebt tot alle versies van het document. Wanneer u de koppeling maakt, kunt u de bestaande document-id opgeven. U schrijft dus gewoon een nieuwe versie naar dat document, waarbij de gegevens extern in de nieuwe provider worden gehost. Dit document-id is dezelfde als de document-id die u vindt op de documentkoppeling die u vervangt. Het is hetzelfde conceptuele document. U geeft gewoon aan dat de bytes voor deze nieuwe versie worden opgeslagen met een andere provider.
Http Method: POST

Endpoint: {host}/internal/documents/linkExternalObjects

Http Body:
refObjCode=DOCU&refObjID={documentId}&providerType={providerType}&documentProviderID={documentProviderID}

API DOCS: (Internal Link Endpoints zijn momenteel niet opgenomen in developer.workfront.com)

Mappen koppelen

De Omslagen van het Document van de verbinding (DOCFDR) van Externe Leverancier van het Document van providerType met documentProviderID.

IMPORTANT
Voor mapkoppelingen hebt u, in tegenstelling tot documentkoppelingen, de 'documentFolderId' nodig van de map in Workfront waarin u de nieuwe koppeling wilt plaatsen. Dit is waarschijnlijk dezelfde bovenliggende map als de gekoppelde map die we kopiëren.
CAUTION
Mappen worden niet tijdelijk opgeslagen. Verwijder de oude mappen niet. Schakel de integratie van aangepaste documenten in het installatiegebied uit om oude mappen te verwijderen.
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: (Internal Link Endpoints zijn momenteel niet opgenomen in developer.workfront.com)

Belangrijke termen

  • Document: Een digitaal middel binnen Workfront

  • Omslag van het Document: Een container voor digitale activa binnen Workfront

  • identiteitskaart van het Document: Interne identiteitskaart van Workfront voor een digitaal middel

  • identiteitskaart van de Omslag van het Document: Interne identiteitskaart van Workfront voor een digitale activaomslag

  • identiteitskaart van de Leverancier van het Document: identiteitskaart verbonden aan specifieke documentleveranciers

IMPORTANT
Voor een bepaald type documentprovider kunnen er meerdere gekoppelde instanties zijn. Ze kunnen bijvoorbeeld meerdere AEM opslagplaatsen hebben gekoppeld. Of meerdere Google Drive-instanties gekoppeld. De Document Provider ID wijst op de specifieke instantie van het verbindingstype wij of willen vervangen.

  • het Type van Leverancier van de Opslag van het Document (ook "Extern Type van Integratie"): Het type van de leveranciersintegratie van de documentopslag die Workfront steunt. Of via een specifieke integratie of een "aangepaste integratie".

  • Huidige Types van Leverancier van de Opslag van het Document ( providerType):

    code language-none 
    ATTASK
BOX
GOOGLE
SHAREPOINT
WEBDAM
WORKFRONTDAM
INFERNO
WIDEN
DROPBOX
DROPBOX_BUSINESS
ONEDRIVE
QUIP
WEBHOOKS
AEM
MOCK

  • Verbonden Document: Een digitaal element dat in een externe leverancier van de documentopslag wordt ontvangen. Workfront heeft een eigen interne Document ID voor het element, maar de bytes worden extern opgeslagen. Om dit mogelijk te maken, slaat Workfront ook een "externe document-id" op die u helpt bij het zoeken naar de bron waarnaar extern wordt verwezen in de externe opslagplaats of opslagplaats.

  • Gekoppelde Omslag van het Document: Een container voor digitale activa die in een externe leverancier van de documentopslag worden ontvangen. Workfront heeft een eigen interne Document Folder ID voor het element, maar de bytes worden extern opgeslagen. Om dit mogelijk te maken, slaat Workfront ook een "externe document-id" op die u helpt bij het zoeken naar de bron waarnaar extern wordt verwezen in de externe opslagplaats of opslagplaats.

  • Externe identiteitskaart van het Document: identiteitskaart die wordt toegewezen wanneer de activa buiten Workfront worden opgeslagen. Workfront wijst zijn interne id toe aan de id die wordt gebruikt om het element in het externe systeem te vinden, via dit veld voor de id van het externe document. Daarom moet bij het koppelen van het document of de map vanuit een nieuwe externe opslag een nieuwe externe document-id worden samengesteld in de juiste indeling voor de externe documentprovider om het document in de nieuwe opslagplaats of opslagplaats te identificeren.

    note note
    NOTE
    Workfront heeft nog geen standaard voor externe document-id's. Er wordt een nieuwe specificatie gebruikt voor AEM-id's, maar voor andere id's kan de externe document-id verschillende vormen aannemen, afhankelijk van het providertype.

  • Type van Objecten: Dit is een API slechts termijn voor de doeleinden van dit document. Het is een soort algemeen object in Workfront waarmee je wilt communiceren. In deze gevallen zult u werken met documenten en mappen die respectievelijk de typen "DOCU" en "DOCFDR" hebben.

  • identiteitskaart van Objecten: Het interne herkenningsteken van Workfront voor het generische voorwerp u wenst om met in wisselwerking te staan. U gaat werken met documenten en mappen, dus dit is respectievelijk de document-id of de documentmap-id.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43