Configurare Workfront for Experience Manager enhanced connector assets-integration-overview

Versione
Collegamento articolo
AEM 6.5
Fai clic qui
AEM as a Cloud Service
Questo articolo

Un utente con accesso amministratore in Adobe Experience Manager come Cloud Service configura il connettore avanzato dopo averlo installato. Per istruzioni sull'installazione, vedere Installare il connettore.

IMPORTANT
A giugno 2022, Adobe ha rilasciato una nuova integrazione nativa per la connessione di Workfront con Adobe Experience Manager Assets as a Cloud Service. Questa integrazione è diventata il metodo richiesto per collegare queste due soluzioni. Qualsiasi nuova implementazione futura del connettore avanzato (versione 1.9.8 e successive) per collegare Workfront ad AEM Assets as a Cloud Service è bloccata.
IMPORTANT
  • Adobe richiede la distribuzione e la configurazione di Adobe Workfront for Experience Manager enhanced connector solo tramite partner certificati o Adobe Professional Services. Se distribuita e configurata senza un partner certificato o Adobe Professional Services, non è supportata da Adobe.

  • Adobe potrebbe rilasciare aggiornamenti a Adobe Workfront e Adobe Experience Manager che rendono ridondante questo connettore; in tal caso, i clienti potrebbero dover passare dall'utilizzo di questo connettore.

  • Adobe supporta le versioni migliorate del connettore 1.7.4 e successive. Le versioni precedenti prerelease e personalizzate non sono supportate. Per verificare la versione del connettore avanzato, vedere il passaggio 5(a) delle istruzioni di installazione del connettore avanzato.

  • Consulta Esame di certificazione partner per il connettore avanzato Workfront for Experience Manager Assets. Per informazioni sull'esame, vedere Guida all'esame.

Configurare le sottoscrizioni di eventi event-subscriptions

Gli abbonamenti agli eventi vengono utilizzati per notificare all'AEM gli eventi che si verificano in Adobe Workfront. Sono disponibili tre funzionalità Workfront for Experience Manager enhanced connector che richiedono abbonamenti agli eventi per funzionare:

  • Creazione automatica di cartelle collegate al progetto.
  • Sincronizzazione delle modifiche nei valori del modulo personalizzato del documento Workfront con i metadati delle risorse AEM.
  • Pubblicazione automatica delle risorse in Brand Portal al completamento del progetto.

Per utilizzare queste funzioni, abilita sottoscrizioni eventi.

  • Modifica la configurazione di Strumenti di Workfront Cloud Service creata nel passaggio 5 e seleziona la scheda Sottoscrizioni eventi.

  • Seleziona la Integrazione personalizzata Workfront creata nella sezione 6.

  • Fare clic su Abilita sottoscrizioni eventi Workfront.

    Sottoscrizione evento

Configurare le cartelle collegate linked-folders

Per iscriverti agli eventi, segui questi passaggi:

  1. Passa alla scheda Iscrizioni eventi nei servizi cloud.
  2. Selezionare l'integrazione personalizzata creata in Workfront.
  3. Fare clic su Abilita sottoscrizioni eventi Workfront.

Configurazione della struttura delle cartelle collegate linked-folder-structure

  1. Vai alla scheda Cartelle collegate al progetto nei servizi cloud.
  2. Percorso principale della cartella collegata: seleziona una cartella in DAM in cui desideri creare le cartelle collegate. Se lasciato vuoto, per impostazione predefinita viene impostato su /content/dam. Verificare che lo schema metadati Strumenti di Workfront e lo schema metadati cartelle collegate a Workfront siano stati applicati alla cartella selezionata.
  3. Struttura delle cartelle collegate: immetti valori separati da virgole. Ogni valore deve essere DE:<some-project-custom-form-field>, Portfolio, Programma, Anno, Nome o un valore di tipo "Stringa letterale" (quest'ultimo con virgolette). Attualmente è impostato su Portfolio,Programma,Anno,DE:Tipo di progetto,Nome.
  4. Configura autorizzazioni: aggiungi le autorizzazioni jcr:all permissions a /conf/workfront-tools/settings/cloudconfigs per il gruppo wf-workfront-users.
  5. Se il titolo della cartella in Workfront deve includere tutte le cartelle della struttura, seleziona la casella di controllo Crea titolo della cartella collegata in Workfront utilizzando i nomi della struttura di cartelle. In caso contrario, si tratta del titolo dell'ultima cartella.
  6. Sottocartelle con più campi consente di specificare un elenco di cartelle da creare come cartella secondaria della cartella collegata.
  7. Stato progetto: seleziona lo stato per il quale il progetto deve essere impostato per creare la cartella collegata.
  8. Creazione di una cartella collegata in progetti con portfolio: elenco di Portfoli a cui deve appartenere il progetto per poter creare la cartella collegata. Lascia vuoto questo elenco per creare la cartella collegata per tutto il portfolio di progetti.
  9. Creare una cartella collegata nei progetti con campo modulo personalizzato: campo modulo personalizzato e il valore corrispondente che il progetto deve avere per poter creare la cartella collegata. Questa configurazione viene ignorata se viene lasciata vuota. Selezionare CUSTOM FORMS: Create DAM Linked Folder per il campo e immettere Yes per il valore.
  10. Configura autorizzazione: configura queste autorizzazioni, jcr:all permissions for /conf/workfront-tools/settings/cloudconfigs per wf-workfront-users group.
  11. Fai clic su Abilita creazione automatica di cartelle collegate. Se torni alla scheda Sottoscrizioni evento, vedrai che ora esiste un evento di creazione.

configurazione cartella collegata

Mappatura schema metadati metadata-schema-mapping

Configurare la mappatura dei metadati delle cartelle folder-metadata-mapping

La mappatura dei metadati tra i progetti Workfront e le cartelle AEM è definita negli schemi di metadati delle cartelle AEM. Gli schemi di metadati delle cartelle devono essere creati e configurati come di consueto in AEM. Strumenti di Workfront aggiunge un elenco a discesa di completamento automatico alla scheda Configurazione impostazioni di ogni campo modulo schema metadati cartelle. Questo menu a discesa di completamento automatico consente di specificare a quale campo Workfront deve essere mappata ogni proprietà della cartella AEM.

Per configurare le mappature, effettua le seguenti operazioni:

  1. Aggiungere le autorizzazioni jcr:read a /conf/global/settings/dam/adminui-extension/foldermetadataschema per il gruppo wf-workfront-users.

  2. Passa a Strumenti > Assets > Cartella schemi metadati.

  3. Seleziona il modulo schema metadati cartelle da modificare e fai clic su Modifica.

  4. Seleziona il campo modulo schema metadati cartelle da modificare e seleziona la scheda Impostazioni nel pannello di destra.

  5. Nel campo Mappato dal campo Workfront, selezionare il nome del campo Workfront che si desidera mappare alla proprietà della cartella AEM selezionata. Le opzioni disponibili sono:

    • Campi modulo personalizzati del progetto
    • Campi Panoramica progetto (ID, Nome, Descrizione, Numero di riferimento, Data di completamento pianificata, Proprietario progetto, Sponsor progetto, Portfolio o Programma)

configurazione mappatura metadati

Configurare la mappatura dei metadati delle risorse asset-metadata-mapping

La mappatura dei metadati tra i documenti di Adobe Workfront e Assets è definita negli schemi di metadati AEM. Gli schemi di metadati devono essere creati e configurati come di consueto in AEM. Strumenti di Workfront aggiunge opzioni di configurazione alla scheda Configurazione impostazioni di ciascun campo modulo schema metadati. Queste opzioni ti consentono di specificare a quale campo Workfront deve essere mappata ogni proprietà AEM.

Per configurare le mappature, effettua le seguenti operazioni:

  1. Passa a Strumenti > Assets > Schemi metadati.

  2. Seleziona il modulo schema metadati da modificare e fai clic su Modifica oppure crea uno schema metadati da zero.

  3. Seleziona il campo del modulo schema metadati che desideri modificare e fai clic sulla scheda Impostazioni nel pannello di destra.

  4. In Campo modulo personalizzato Workfront selezionare il nome del campo Workfront che si desidera mappare alla proprietà AEM selezionata. Le opzioni disponibili sono:

    • Documenta campi modulo personalizzati
    • Campi modulo personalizzati del progetto
    • Campi modulo personalizzati problema
    • Campi modulo personalizzato attività
    • Campi Panoramica progetto (ID, Nome, Descrizione o Numero di riferimento)
  5. Nel caso in cui il campo Workfront selezionato nel campo modulo personalizzato Workfront sia un campo di tipo Utente Workfront, è necessario specificare quale campo Utente Workfront si desidera mappare. Per eseguire questa operazione, selezionare Ottieni valore dal campo oggetto di riferimento di Workfront, quindi specificare il nome del Campo modulo personalizzato utente Workfront dal quale recuperare il valore da mappare.

    configurazione mappatura metadati

Proprietà mappa map-property

Questo passaggio del flusso di lavoro consente a un utente di mappare una proprietà su un modulo personalizzato Workfront in un progetto, un'attività, un problema o un documento. L'artefatto Workfront interessato da questo passaggio viene cercato utilizzando un percorso relativo dal payload. Le proprietà da mappare sono controllate dalla configurazione della finestra di dialogo dei passaggi.

Tipo: questo campo consente di selezionare il tipo di oggetto Workfront a cui mappare le proprietà.

Proprietà ID: questo campo consente di specificare il percorso dell'ID dell'oggetto Workfront a cui mappare le proprietà. Il percorso specificato in questo campo deve essere relativo al payload del flusso di lavoro.

Assegnazioni proprietà: questo campo multiplo consente di specificare le mappature tra le proprietà AEM e i campi Workfront. Ogni elemento nel campo multiplo specifica una mappatura. Ogni mappatura deve avere il formato <workfront-field>=<aem-mapped-property>.

  • workfront-field può essere

    • Campo modulo personalizzato identificato dal prefisso DE:.
    • Campo modificabile identificato dal relativo nome. I nomi dei campi sono stati trovati in Workfront API explorer.
  • aem-mapped-property può essere:

    • Un valore letterale. Queste devono essere racchiuse tra virgolette.
    • Una proprietà AEM. Questo riferimento deve essere relativo al payload del flusso di lavoro.
    • Un valore denominato. Queste devono essere racchiuse tra parentesi.
    • Una concatenazione dei 3 elementi sopra indicati. Specificarlo utilizzando {+}.
    • Una modifica dei 3 elementi precedenti racchiudendo il valore con {replace(<value>,"old-char","new-char")}.
  • Alcuni esempi sono:

    • status="INP"
    • DE:Asset Type=jcr:content/metadata/assetType
    • DE:Path={path}
    • URL="https://my-aem-author/assets.html"{+}{path}

Configurazione per mappare la proprietà

Imposta stato set-status

Nell'editor del flusso di lavoro, modificare le proprietà di Workfront - Imposta stato nella scheda Argomenti.

Modifica flusso di lavoro per impostare lo stato

Sincronizzazione commenti comments-sync

  1. In Experience Manager, accedere a Strumenti > Cloud Service > Configurazione strumenti di Workfront, selezionare la configurazione e selezionare Proprietà.

    commenti sincronizzati

  2. Seleziona la scheda Sottoscrizioni eventi, fai clic su Abilita sincronizzazione commenti in Invia commenti aggiunti in Workfront all'opzione AEM.

    Sincronizzazione abilitata

Per verificare la sincronizzazione dei commenti da Workfront all’AEM, effettua le seguenti operazioni:

  1. Passa a un documento collegato in Workfront e aggiungi un commento nella scheda Aggiornamenti.

    lascia un commento in Workfront

  2. Passare allo stesso documento collegato in AEM, selezionare il documento e aprire l'opzione Timeline nel menu di navigazione a sinistra, quindi selezionare Commenti. Nella barra laterale a sinistra vengono visualizzati i commenti sincronizzati da Workfront.

Versioni risorsa asset-versions

Per mantenere la cronologia delle versioni delle risorse in AEM, configura il controllo delle versioni delle risorse in AEM.

  1. In Experience Manager, accedere a Strumenti > Cloud Service > Configurazione strumenti Workfront e aprire la scheda Avanzate.

  2. Selezionare l'opzione Memorizza risorse con lo stesso nome delle versioni della risorsa esistente. Se selezionata, questa opzione consente di memorizzare le risorse caricate con lo stesso nome e nella stessa posizione della versione della risorsa esistente. Se non è selezionata, viene creata una nuova risorsa con un nome diverso (ad esempio, asset-name.pdf e asset-name-1.pdf).

  3. Selezionare l'opzione Aggiorna metadati risorsa durante la creazione di una nuova versione. Se selezionata, questa opzione aggiorna i metadati della risorsa ogni volta che ne viene creata una nuova versione. Se questa opzione è deselezionata, la risorsa manterrà i metadati che aveva prima di creare la nuova versione.

configurare il controllo delle versioni delle risorse

NOTE
Il controllo delle versioni non è supportato nelle cartelle collegate. Durante la creazione di una bozza Workfront con un documento all'interno di una cartella collegata, i commenti e le annotazioni della versione precedente della risorsa vengono rimossi.

Allegare moduli personalizzati attach-custom-forms

Questo passaggio del flusso di lavoro consente agli utenti di allegare un modulo personalizzato a un artefatto Workfront. Questo passaggio di flusso di lavoro può essere aggiunto a qualsiasi modello di flusso di lavoro. L'artefatto Workfront interessato da questo passaggio viene cercato utilizzando un percorso relativo dal payload.

Nell'editor del flusso di lavoro di Experience Manager, modificare le proprietà del passaggio del flusso di lavoro Workfront - Allega modulo personalizzato.

moduli personalizzati .

Pubblicazione automatica delle risorse auto-publish-assets

  1. In Experience Manager, accedere a Strumenti > Cloud Service > Configurazione strumenti Workfront e aprire la scheda Avanzate.

  2. Seleziona Pubblica automaticamente le risorse se inviate da Workfront. Questa opzione consente la pubblicazione automatica delle risorse quando vengono inviate da Workfront all’AEM. Questa funzione può essere abilitata in modo condizionale specificando un campo modulo personalizzato Workfront e il valore su cui deve essere impostata. Ogni volta che un documento viene inviato al AEM, se soddisfa la condizione, la risorsa viene pubblicata automaticamente.

  3. Seleziona Publish tutte le risorse del progetto in Brand Portal al completamento del progetto. Questa opzione consente la pubblicazione automatica delle risorse in Brand Portal quando lo stato del progetto Workfront a cui appartengono viene modificato in Complete.

configura pubblicazione automatica

Aggiornamenti dei moduli personalizzati per documenti di Workfront subscribe-workfront-doc-custom-form-updates

Per sottoscrivere le modifiche nei moduli personalizzati del documento Workfront, selezionare l'opzione appropriata nella scheda Avanzate. Quando si sottoscrivono questi aggiornamenti, i campi di metadati Experience Manager mappati vengono aggiornati quando viene modificato il campo corrispondente nel modulo personalizzato del documento Workfront.

configurazione aggiornamenti modulo personalizzato documento Workfront in Experience Manager

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab