Configurare Workfront for Experience Manager enhanced connector assets-integration-overview
Un utente con accesso amministratore in Adobe Experience Manager configura il connettore avanzato dopo averlo installato. Per istruzioni sull'installazione, vedere Installare il connettore.
-
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 avanzata del connettore, passa al gruppo
digital.hoodoo
disponibile nel riquadro a sinistra in Gestione pacchetti. -
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.
Configurare le cartelle collegate linked-folders
Per iscriverti agli eventi, segui questi passaggi:
- Passa alla scheda Iscrizioni eventi nei servizi cloud.
- Selezionare l'integrazione personalizzata creata in Workfront.
- Fare clic su Abilita sottoscrizioni eventi Workfront.
Configurazione della struttura delle cartelle collegate linked-folder-structure
- Vai alla scheda Cartelle collegate al progetto nei servizi cloud.
- 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.
- 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. - Configura autorizzazioni: aggiungi le autorizzazioni
jcr:all permissions
a/conf/workfront-tools/settings/cloudconfigs
per il gruppowf-workfront-users
. - 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.
- Sottocartelle con più campi consente di specificare un elenco di cartelle da creare come cartella secondaria della cartella collegata.
- Stato progetto: seleziona lo stato del progetto per creare la cartella collegata.
- Creazione di una cartella collegata in progetti con portfolio: elenco di Portfoli a cui il progetto deve appartenere per creare la cartella collegata. Lascia vuoto questo elenco per creare la cartella collegata per tutto il portfolio di progetti.
- Creare una cartella collegata nei progetti con campo modulo personalizzato: campo modulo personalizzato e il valore corrispondente che il progetto deve avere per creare la cartella collegata. Questa configurazione viene ignorata se viene lasciata vuota. Selezionare
CUSTOM FORMS: Create DAM Linked Folder
per il campo e immettereYes
per il valore. - Fai clic su Abilita creazione automatica di cartelle collegate. Se torni alla scheda Sottoscrizioni evento, vedrai che ora è presente un evento di creazione.
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:
-
Aggiungere le autorizzazioni
jcr:read
a/conf/global/settings/dam/adminui-extension/foldermetadataschema
per il gruppowf-workfront-users
. -
Passa a Strumenti > Assets > Cartella schemi metadati.
-
Seleziona il modulo schema metadati cartelle da modificare e fai clic su Modifica.
-
Seleziona il campo modulo schema metadati cartelle da modificare e seleziona la scheda Impostazioni nel pannello di destra.
-
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)
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:
-
Passa a Strumenti > Assets > Schemi metadati.
-
Seleziona il modulo schema metadati da modificare e fai clic su Modifica oppure crea uno schema metadati da zero.
-
Seleziona il campo del modulo schema metadati che desideri modificare e fai clic sulla scheda Impostazioni nel pannello di destra.
-
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)
-
Nel caso in cui il campo Workfront selezionato nel campo modulo personalizzato Workfront sia un campo di tipo Utente Workfront, sarà 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.
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.
- Campo modulo personalizzato identificato dal prefisso
-
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}
Imposta stato set-status
Nell'editor del flusso di lavoro, modificare le proprietà di Workfront - Imposta stato nella scheda Argomenti.
Sincronizzazione commenti comments-sync
-
In Experience Manager, accedere a Strumenti > Cloud Service > Configurazione strumenti di Workfront, selezionare la configurazione e selezionare Proprietà.
-
Seleziona la scheda Sottoscrizioni eventi, fai clic su Abilita sincronizzazione commenti in Invia commenti aggiunti in Workfront all'opzione AEM.
Per verificare la sincronizzazione dei commenti da Workfront all’AEM, effettua le seguenti operazioni:
-
Passa a un documento collegato in Workfront e aggiungi un commento nella scheda Aggiornamenti.
-
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.
-
In Experience Manager, accedere a Strumenti > Cloud Service > Configurazione strumenti Workfront e aprire la scheda Avanzate.
-
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 questa opzione non è selezionata, verrà creata una nuova risorsa con un nome diverso (ad esempio,
asset-name.pdf
easset-name-1.pdf
). -
Selezionare l'opzione Aggiorna metadati risorsa durante la creazione di una 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.
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 verrà 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.
.
Pubblicazione automatica delle risorse auto-publish-assets
-
In Experience Manager, accedere a Strumenti > Cloud Service > Configurazione strumenti Workfront e aprire la scheda Avanzate.
-
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 verrà pubblicata automaticamente.
-
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
.
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.