Moduli Adobe Workfront

Qualsiasi pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront.

Workfront Ultimate

Pacchetti Workfront Prime e Select, con un ulteriore acquisto di Workfront Fusion.

Standard

Work o successiva

Il connettore Workfront utilizza OAuth 2.0 per connettersi a Workfront.

Puoi creare una connessione al tuo account Workfront direttamente dall’interno di un modulo Workfront Fusion.

• Connettersi a Workfront utilizzando l’ID client e il Segreto client
• Connettersi a Workfront utilizzando una connessione da server a server

Connettersi a Workfront utilizzando l’ID client e il Segreto client

1. In qualsiasi modulo di Adobe Workfront, fai clic su Aggiungi accanto al campo Connessione.

2. Compila i seguenti campi:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
   Connection type (Tipo di connessione)	Seleziona Connessione di autenticazione Adobe Workfront.
   Connection name (Nome della connessione)	Inserisci un nome per la nuova connessione.
   ID client	Inserisci il tuo ID client. Questo è disponibile nell’area Applicazioni OAuth2 in Configurazione di Workfront. Apri l’applicazione specifica a cui ti stai connettendo per visualizzare l’ID client.
   Client Secret (Segreto client)	Inserisci il Segreto client di Workfront. Questo è disponibile nell’area Applicazioni OAuth2 in Configurazione di Workfront. Se non disponi di un Segreto client per l’applicazione OAuth2 in Workfront, puoi generarne un altro. Per istruzioni, consulta la documentazione di Workfront.
   URL di autenticazione	Questo può rimanere il valore predefinito, oppure puoi inserire l’URL dell’istanza Workfront, seguito da /integrations/oauth2. Esempio: https://mydomain.my.workfront.com/integrations/oauth2
   Prefisso host	Nella maggior parte dei casi, questo valore deve essere origin.

3. Fai clic su Continua per salvare la connessione e tornare al modulo.

   Se non hai effettuato l’accesso a Workfront, verrà aperta una schermata di accesso. Dopo aver effettuato l’accesso, puoi autorizzare la connessione.

Connettersi a Workfront utilizzando una connessione da server a server

1. In qualsiasi modulo di Adobe Workfront, fai clic su Aggiungi accanto al campo Connessione.

2. Compila i seguenti campi:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header
   Connection type (Tipo di connessione)	Seleziona Connessione da server a server Adobe Workfront.
   Connection name (Nome della connessione)	Inserisci un nome per la nuova connessione.
   Nome istanza	Inserisci i il nome dell’istanza, noto anche come dominio. Esempio: se l’URL è https://example.my.workfront.com, inserisci example.
   Percorso dell’istanza	Inserisci il tipo di ambiente della connessione. Esempio: se l’URL è https://example.my.workfront.com, inserisci my.
   ID client	Inserisci il tuo ID client. Questo è disponibile nell’area Applicazioni OAuth2 in Configurazione di Workfront. Apri l’applicazione specifica a cui ti stai connettendo per visualizzare l’ID client.
   Client Secret (Segreto client)	Inserisci il Segreto client di Workfront. Questo è disponibile nell’area Applicazioni OAuth2 in Configurazione di Workfront. Se non disponi di un Segreto client per l’applicazione OAuth2 in Workfront, puoi generarne un altro. Per istruzioni, consulta la documentazione di Workfront.
   Ambiti	Inserisci gli ambiti applicabili per questa connessione.
   Prefisso host	Nella maggior parte dei casi, questo valore deve essere origin.

3. Fai clic su Continua per salvare la connessione e tornare al modulo.

   Se non hai effettuato l’accesso a Workfront, verrà aperta una schermata di accesso. Dopo aver effettuato l’accesso, puoi autorizzare la connessione.

Moduli Workfront e relativi campi

Quando configuri i moduli di Workfront, Workfront Fusion mostra i campi elencati di seguito. Oltre a questi campi potrebbero essere mostrati campi di Workfront aggiuntivi, in base a fattori quali il tuo livello di accesso nell’app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.

Se visualizzi il pulsante Map (Mappa) sopra un campo o una funzione, puoi utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, consulta Mappare le informazioni da un modulo a un altro.

• Trigger
• Azioni
• Ricerche

Trigger

Seleziona il tipo di record Workfront che il modulo deve controllare.

Seleziona ad esempio Attività se desideri avviare l’esecuzione dello scenario ogni volta che un campo record viene aggiornato in un’attività.

Seleziona il tipo di record Workfront che il modulo deve controllare.

Se ad esempio desideri avviare lo scenario ogni volta che viene creato un nuovo progetto, seleziona Progetto

Inserisci l’ID dell’oggetto.

Nota: quando inserisci l’ID di un oggetto, puoi iniziare a digitare il nome dell’oggetto, quindi selezionarlo dall’elenco. Il modulo inserisce quindi l’ID appropriato nel campo.

Se stai eseguendo la conversione a un progetto, seleziona l’ID modello da utilizzare per il progetto.

Nota: quando inserisci l’ID di un oggetto, puoi iniziare a digitare il nome dell’oggetto, quindi selezionarlo dall’elenco. Il modulo inserisce quindi l’ID appropriato nel campo.

Seleziona il tipo di record di Workfront che il modulo deve creare.

Se ad esempio desideri creare un progetto, seleziona Progetto dall’elenco a discesa.

Seleziona i campi che desideri rendere disponibili per l’input di dati. Questo ti consente di utilizzare tali campi senza dover scorrere quelli non necessari. Quindi puoi inserire o mappare i dati in questi campi.

Per i campi nei moduli personalizzati, utilizza il campo Allega modulo personalizzato.

• Quando inserisci l’ID di un oggetto, puoi iniziare a digitare il nome dell’oggetto, quindi selezionarlo dall’elenco. Il modulo inserisce quindi l’ID appropriato nel campo.
• Quando inserisci il testo per un campo personalizzato o un oggetto Nota (commento o risposta), puoi utilizzare tag HTML nel campo Testo nota per creare testo formattato, ad esempio testo in grassetto o corsivo.

• Risolvi singoli utenti

  code language-none
  Puoi risolvere singoli utenti nell’elenco Utenti.

• Risolvi utenti aggiunti in un batch grande

  Per risolvere gli utenti aggiunti in un batch di grandi dimensioni, puoi aggiungere direttamente il batch di utenti ad Adobe Admin Console.

  Per istruzioni, consulta Gestire più utenti   Caricamento in blocco di CSV nella documentazione di Adobe.

Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard. Questo determina il tipo di contenuto della richiesta.

Ad esempio: {"Content-type":"application/json"}

Nota: se vengono restituiti errori ed è difficile determinarne l’origine, prendi in considerazione la modifica delle intestazioni in base alla documentazione di Workfront. Se la chiamata API personalizzata restituisce un errore di richiesta HTTP 422, prova a utilizzare un’intestazione "Content-Type":"text/plain".

Aggiungi la query per la chiamata API come oggetto JSON standard.

Ad esempio: {"name":"something-urgent"}

Suggerimento: è consigliabile inviare informazioni tramite il corpo JSON anziché come parametri di query.

Aggiungi il contenuto del corpo della chiamata API sotto forma di oggetto JSON standard.

Nota:

Quando utilizzi istruzioni condizionali come if nel codice JSON, racchiudi l’istruzione condizionale tra virgolette.

Inserisci l’ID Workfront univoco del record che il modulo deve eliminare.

Per ottenere l’ID, apri l’oggetto Workfront nel browser e copia il testo alla fine dell’URL, dopo “ID=”. Ad esempio: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

1. Elimina il record in modo sincrono.
2. Aggiungi la gestione errori al modulo Elimina record in modo da ignorare l’errore causato dal timeout di 40 secondi.

Mappa oppure inserisci manualmente l’ID Workfront univoco del documento che il modulo deve scaricare.

Per ottenere l’ID, apri l’oggetto Workfront nel browser e copia il testo alla fine dell’URL, dopo “ID=”. Ad esempio: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Seleziona l’azione che il modulo deve eseguire.

Potresti dover compilare altri campi, a seconda di Tipo di record e Azione che hai scelto. Alcune combinazioni di queste due impostazioni possono richiedere solo un ID record, mentre altre (come Progetto per Tipo di record e Allega modello per Azione) richiedono informazioni aggiuntive quali un ID oggetto e un ID modello.

Per le opzioni disponibili per alcune azioni, consulta Opzioni per azioni varie in questo articolo.

Per informazioni dettagliate sui singoli campi, consulta la documentazione per gli sviluppatori di Workfront.

Nota: il sito della documentazione per gli sviluppatori include informazioni solo fino alla versione 14 dell’API, ma contiene comunque informazioni importanti sulle chiamate API.

1. Seleziona il tipo di record nella barra di navigazione a sinistra della pagina di documentazione per sviluppatori di Workfront. Per i seguenti tipi esistono pagine specifiche:

   • Progetti

   • Attività

   • Problemi

   • Utenti

   • Documenti

   Per tutti gli altri tipi di record, seleziona Altri oggetti e endpoint e individua il tipo di record nelle pagine organizzate in ordine alfabetico.

2. Nella pagina del tipo di record appropriato, cerca l’azione (Ctrl + F o Comando + F).

3. Visualizza le descrizioni dei campi disponibili nell’azione selezionata.

Nota:

Quando crei una bozza tramite il modulo Azioni varie di Workfront, la best practice prevede di creare una bozza senza opzioni avanzate, quindi di aggiornarla utilizzando l’API SOAP Workfront Proof.

Per ulteriori informazioni sulla creazione di una bozza con l’API Workfront (utilizzata da questo modulo), consulta Aggiungere opzioni di bozza avanzate durante la creazione di una bozza con l’API Adobe Workfront

Inserisci oppure mappa l’ID Workfront univoco del record con cui il modulo deve interagire.

Per ottenere l’ID, apri l’oggetto Workfront nel browser e copia il testo alla fine dell’URL, dopo “ID=”. Ad esempio: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

• clearApprovers

• clearAssignments

• clearConstraints

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  Cancella dati finanziari

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Cancella notifiche di promemoria

• clearApprovers

• clearAssignments

• clearDocuments

• clearConstraints

• clearExpenses

• clearFinancials

  Cancella dati finanziari

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Cancella notifiche di promemoria

• clearApprovers
• clearAssignments
• clearCustomData
• clearDocuments
• clearPermissions
• clearProgress

• preserveIssue

  Mantieni il problema originale e collegane la risoluzione a questa attività

• preservePrimaryContact

  Consenti al contatto principale del problema di accedere a questa attività

• preserveCompletionDate

  Mantieni la data di completamento pianificata del problema

• preserveIssue

  Mantieni il problema originale e collegane la risoluzione a questa attività

• preservePrimaryContact

  Consenti al contatto principale del problema di accedere a questa attività

• clearApprovers

• clearAssignments

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  Cancella dati finanziari

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Cancella notifiche di promemoria

• clearApprovers

• clearAssignments

• clearBillingRates

• clearConstraints

• clearDeliverables

  Cancella obiettivi

• clearDocuments

• clearExpenses

• clearFinancials

  Cancella dati finanziari

• clearHourTypes

• clearIssueSetup

  Cancella la configurazione dei problemi e le proprietà della coda

• clearPredecessors

• clearRisks

• clearSharingOptions

• clearTimedNotifications

  Cancella notifiche di promemoria

Inserisci l’ID Workfront univoco del record che il modulo deve leggere.

Per ottenere l’ID, apri l’oggetto Workfront nel browser e copia il testo alla fine dell’URL, dopo “ID=”. Ad esempio: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Inserisci l’ID Workfront univoco del record che deve aggiornare il modulo.

Per ottenere l’ID, apri l’oggetto Workfront nel browser e copia il testo alla fine dell’URL, dopo “ID=”. Ad esempio: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Seleziona i moduli personalizzati per i quali desideri specificare i valori dei campi nel nuovo record. Dopo aver selezionato il modulo, inserisci i dati per i campi del modulo.

Per fornire i valori dei campi di un modulo che stai allegando in questo modulo, includi l’ID del modulo personalizzato nella sezione dei campi da mappare.

Seleziona il tipo di record principale (oggetto Workfront) di cui desideri leggere i record associati.

Per un elenco dei tipi di oggetto Workfront per i quali puoi utilizzare questo modulo, consulta Tipi di oggetto Workfront disponibili per ciascun modulo di Workfront.

Inserisci oppure mappa l’ID del record principale di cui desideri leggere i record associati.

Per ottenere l’ID, apri l’oggetto Workfront nel browser e copia il testo alla fine dell’URL, dopo “ID=”. Ad esempio: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Inserisci il campo in base al quale desideri eseguire la ricerca, l’operatore da utilizzare nella query e il valore ricercato nel campo.

Nota: non utilizzare username nei criteri di ricerca. L’inclusione di username in una query API per Workfront effettua l’accesso dell’utente a Workfront e la ricerca non avrà esito positivo.

Nota: In e NotIn utilizzano gli array. Gli input devono essere in formato array.

Inserisci il campo in base al quale desideri eseguire la ricerca, l’operatore da utilizzare nella query e il valore ricercato nel campo.

Nota: non utilizzare username nei criteri di ricerca. L’inclusione di username in una query API per Workfront effettua l’accesso dell’utente a Workfront e la ricerca non avrà esito positivo.

Nota: In e NotIn utilizzano gli array. Gli input devono essere in formato array.