Moduli Adobe Workfront

Puoi utilizzare il connettore Adobe Workfront Fusion Adobe Workfront per automatizzare i processi all’interno di Workfront. È inoltre possibile collegare Workfront ad altre applicazioni e servizi.

Per istruzioni sulla creazione di uno scenario, vedere gli articoli in Creare scenari: indice articolo. Per informazioni sui moduli, vedere gli articoli in Moduli: indice articolo.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità in questo articolo.

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront Qualsiasi
Licenza Adobe Workfront

Nuovo: Standard

Oppure

Corrente: Lavoro o versione successiva

Licenza Adobe Workfront Fusion**

Corrente: nessun requisito di licenza Workfront Fusion.

Oppure

Legacy: qualsiasi

Prodotto

Nuovo:

  • Seleziona o crea un pacchetto Prime Workfront: la tua organizzazione deve acquistare Adobe Workfront Fusion.
  • Pacchetto Ultimate Workfront: è incluso Workfront Fusion.

Oppure

Corrente: la tua organizzazione deve acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, vedere Requisiti di accesso nella documentazione.

Per informazioni sulle Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze.

note note
NOTE
  • Se la tua organizzazione utilizza il pacchetto di licenze legacy (basato sui connettori), deve disporre di una licenza Workfront Fusion for Work Automation and Integration per connettersi ad app e servizi di terze parti. Il connettore Workfront non viene conteggiato rispetto al numero di app attive disponibili per l’organizzazione. Tutti gli scenari, anche se utilizzano solo l’app Workfront, vengono conteggiati in base al numero totale di scenari della tua organizzazione.

Connessione di Workfront a Workfront Fusion

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.

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

  2. Compila i campi seguenti:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    Connection name Immettere un nome per la nuova connessione.
    Environment Seleziona se ti connetti a un ambiente di produzione o non di produzione.
    Connection type Specificare se ci si connette a un account di servizio o a un account personale.
    Client ID Immetti l'ID client di Workfront. È disponibile nell’area Applicazioni OAuth2 dell’area Configura di Workfront. Apri l’applicazione specifica a cui ti stai connettendo per visualizzare l’ID client.
    Client Secret Immetti il segreto del client Workfront. È disponibile nell’area Applicazioni OAuth2 dell’area Configura 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.
    Authentication URL

    Questo può rimanere il valore predefinito, oppure puoi immettere l'URL dell'istanza Workfront, seguito da /integrations/oauth2.

    Esempio: https://mydomain.my.workfront.com/integrations/oauth2

    Host prefix Nella maggior parte dei casi, questo valore deve essere origin.
  3. Fare clic su Continue per salvare la connessione e tornare al modulo.

    Se non hai effettuato l’accesso a Workfront, vieni indirizzato a una schermata di accesso. Dopo aver effettuato l’accesso, puoi consentire la connessione.

NOTE
  • Le connessioni OAuth 2.0 all’API Workfront non si basano più sulle chiavi API.
  • Per creare una connessione a un ambiente Sandbox Workfront, è necessario creare un'applicazione OAuth2 in tale ambiente e quindi utilizzare l'ID client e il segreto client generati da tale applicazione nella connessione.

Moduli Workfront e relativi campi

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

Se viene visualizzato il pulsante Mappa sopra un campo o una funzione, è possibile utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, vedere Mappare le informazioni da un modulo a un altro.

Attiva/Disattiva mappa

NOTE
  • Se non trovi i campi più aggiornati in un modulo Workfront, potrebbe trattarsi di un problema di caching. Attendi un’ora e riprova.
  • I codici di stato HTTP 429 di Adobe Workfront non dovrebbero causare disattivazioni, ma attivare invece una breve pausa di esecuzione nello scenario.

Trigger

Watch Events

Questo modulo trigger esegue uno scenario in tempo reale quando in Workfront vengono aggiunti, aggiornati o eliminati oggetti di un tipo specifico

Il modulo restituisce tutti i campi standard associati al record, insieme a tutti i campi e i valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

  1. Fare clic su Add a destra della casella Webhook.

  2. Configurare il webhook nella casella Add a hook visualizzata.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    Webhook name Immetti un nome per il webhook
    Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
    Record Type Selezionare il tipo di record Workfront che si desidera controllare nel modulo.
    State

    Seleziona se desideri controllare lo stato precedente o quello nuovo.

    • New state

      Attiva uno scenario quando il record cambia in un valore specificato.

      Ad esempio, se lo stato è impostato su New State e il filtro è impostato su Status Equals In Progress, il webhook attiva uno scenario in cui Status diventa In Progress, indipendentemente dallo stato precedente.

    • Old state

      Attiva uno scenario quando il record cambia da a un determinato valore.

      Ad esempio, se lo stato è impostato su Old State e il filtro è impostato su Status Equals In Progress, il webhook attiva uno scenario quando un Status che è attualmente In Progress passa a un altro stato.

    Events filters

    È possibile impostare i filtri per controllare solo i record che soddisfano i criteri selezionati.

    Per ogni filtro, immetti il campo che desideri che il filtro valuti, l’operatore e il valore che desideri che il filtro consenta. Puoi utilizzare più di un filtro aggiungendo regole AND.

    NOTA: non è possibile modificare i filtri nei webhook di Workfront esistenti. Per impostare filtri diversi per le sottoscrizioni di eventi Workfront, rimuovi il webhook corrente e creane uno nuovo.

    Per ulteriori informazioni sui filtri eventi, vedere Filtri di sottoscrizione eventi nei moduli Workfront > Watch Events in questo articolo.

    Escludi eventi creati da questa connessione

    Abilita questa opzione per escludere gli eventi creati o aggiornati utilizzando lo stesso connettore utilizzato dal modulo di attivazione. Questo può evitare situazioni in cui uno scenario potrebbe attivarsi da solo, causandone la ripetizione in un ciclo infinito.

    NOTA: il tipo di record Assegnazione non include questa opzione.

    Record Origin

    Scegliere se si desidera che lo scenario controlli New Records Only, Updated Records Only, New and Updated Records o Deleted Records Only.

    NOTA: se si sceglie New and Updated Records, la creazione del webhook crea 2 sottoscrizioni di eventi (per lo stesso indirizzo del webhook).

Dopo la creazione del webhook, puoi visualizzare l’indirizzo dell’endpoint a cui vengono inviati gli eventi.

Per ulteriori informazioni, consulta la sezione Esempi di payload degli eventi nell'articolo API di sottoscrizione eventi nella documentazione di Workfront.

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

Watch Field

Questo modulo trigger esegue uno scenario quando viene aggiornato un campo specificato. Il modulo restituisce sia il vecchio che il nuovo valore del campo specificato. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Record Type

Selezionare il tipo di record Workfront che si desidera controllare nel modulo.

Selezionare ad esempio Task se si desidera avviare l'esecuzione dello scenario ogni volta che si aggiorna un campo record in un'attività.

Field Seleziona il campo che desideri che il modulo controlli per gli aggiornamenti. Questi campi riflettono i campi impostati dall’amministratore di Workfront per il tracciamento.
Outputs Seleziona i campi oggetto da includere nel bundle di output per questo modulo.
Limit Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

Watch Record

Questo modulo trigger esegue uno scenario quando vengono aggiunti, aggiornati o entrambi gli oggetti di un tipo specifico. Il modulo restituisce tutti i campi standard associati al record o ai record, insieme a tutti i campi e i valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Nell’output, il modulo indica se ogni record è nuovo o aggiornato.

I record aggiunti e aggiornati dall'ultima esecuzione dello scenario vengono restituiti come nuovi record.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

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 Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Filter Scegliere se si desidera che lo scenario controlli New Records Only, Updated Records Only o New and Updated Records.
Record Type

Selezionare il tipo di record Workfront che si desidera controllare nel modulo.

Ad esempio, se desideri avviare lo scenario ogni volta che viene creato un nuovo progetto, seleziona Project

Outputs Seleziona i campi da includere nel bundle di output per questo modulo.
Reference Seleziona i campi di riferimento da includere nel bundle di output per questo modulo.
Outputs Seleziona i campi della raccolta da includere nel bundle di output per questo modulo.
Optional Filter (Avanzata) Digita una stringa di codice API per definire eventuali parametri o codice aggiuntivi che definiranno meglio i criteri.
Limit Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

Azioni

Convert object

Questo modulo di azione effettua una delle seguenti conversioni:

  • Converti problema in progetto
  • Converti problema in attività
  • Converti attività in progetto
note note
NOTE
A partire da luglio 2024, i moduli personalizzati possono essere inclusi durante la conversione di un oggetto.
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 8-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Object type Selezionare il tipo di oggetto da convertire. Questo è il tipo di oggetto prima della conversione.
Convert to Selezionare l'oggetto in cui si desidera convertirlo. Questo è il tipo di oggetto dopo la conversione.
<Object> ID

Immettere l'ID dell'oggetto.

Nota: quando si immette l'ID di un oggetto, è possibile iniziare a digitare il nome dell'oggetto, quindi selezionarlo dall'elenco. Il modulo immette quindi l’ID appropriato nel campo.

Template ID

Per la conversione in progetto, seleziona l’ID modello da utilizzare per il progetto.

Nota: quando si immette l'ID di un oggetto, è possibile iniziare a digitare il nome dell'oggetto, quindi selezionarlo dall'elenco. Il modulo immette quindi l’ID appropriato nel campo.

Custom forms Seleziona i moduli personalizzati da aggiungere all’oggetto appena convertito, quindi immetti i valori per i campi del modulo personalizzato.
Options Abilitare le opzioni desiderate durante la conversione dell'oggetto. Sono disponibili opzioni a seconda dell’oggetto da o verso il quale si sta eseguendo la conversione.
Copy native fields Abilita questa opzione per copiare tutti i campi nativi dall’oggetto originale al nuovo oggetto.
Copy custom forms Abilita questa opzione per copiare tutti i campi nativi dall’oggetto originale al nuovo oggetto.
Create a record (attaching custom forms)

Questo modulo di azione crea un oggetto, ad esempio un progetto, un’attività o un problema in Workfront, e consente di aggiungere un modulo personalizzato al nuovo oggetto. Il modulo consente di selezionare quale dei campi dell’oggetto è disponibile nel modulo.

Specifica l’ID del record.

Il modulo restituisce l’ID del record ed eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Assicurati di fornire il numero minimo di campi di input. Ad esempio, se desideri creare un problema, devi fornire un ID progetto principale valido nel campo ID progetto per indicare dove il problema dovrebbe risiedere in Workfront. Puoi utilizzare il pannello di mappatura per mappare queste informazioni da un altro modulo dello scenario, oppure puoi immetterle manualmente digitando il nome e selezionandolo dall’elenco.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Record Type

Selezionare il tipo di record Workfront che si desidera venga creato dal modulo.

Ad esempio, se desideri creare un progetto, seleziona Project dall'elenco a discesa.

Select fields to map

Selezionare i campi che si desidera rendere disponibili per l'immissione dei dati. Questo consente di utilizzare questi campi senza dover scorrere quelli non necessari. È quindi possibile immettere o mappare i dati in questi campi.

Per i campi nei moduli personalizzati, utilizza il campo Attach Custom Form.

Attach Custom Form Selezionare i moduli personalizzati che si desidera aggiungere al nuovo oggetto, quindi immettere o mappare i valori per tali campi.

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

note note
NOTE
  • Quando si immette l'ID di un oggetto, è possibile iniziare a digitare il nome dell'oggetto, quindi selezionarlo dall'elenco. Il modulo immette quindi l’ID appropriato nel campo.
  • Quando si immette il testo per un campo personalizzato o un oggetto Note (Commento o risposta), è possibile utilizzare i tag HTML nel campo Note Text per creare testo RTF, ad esempio testo in grassetto o corsivo.
Create Record

Questo modulo di azione crea un oggetto, ad esempio un progetto, un’attività o un problema in Workfront. Il modulo consente di selezionare quale dei campi dell’oggetto è disponibile nel modulo.

Specifica l’ID del record.

Il modulo restituisce l’ID del record ed eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Assicurati di fornire il numero minimo di campi di input. Ad esempio, se desideri creare un problema, devi fornire un ID progetto principale valido nel campo ID progetto per indicare dove il problema dovrebbe risiedere in Workfront. Puoi utilizzare il pannello di mappatura per mappare queste informazioni da un altro modulo dello scenario, oppure puoi immetterle manualmente digitando il nome e selezionandolo dall’elenco.

Questo modulo non allega moduli personalizzati durante la creazione dell’oggetto. Per allegare moduli personalizzati durante la creazione di un oggetto, utilizzare il modulo Create a record (attaching custom forms).

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Record Type

Selezionare il tipo di record Workfront che si desidera venga creato dal modulo.

Ad esempio, se desideri creare un progetto, seleziona Project dall'elenco a discesa.

Select fields to map Selezionare i campi che si desidera rendere disponibili per l'immissione dei dati. Questo consente di utilizzare questi campi senza dover scorrere quelli non necessari.

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

note note
NOTE
  • Quando si immette l'ID di un oggetto, è possibile iniziare a digitare il nome dell'oggetto, quindi selezionarlo dall'elenco. Il modulo immette quindi l’ID appropriato nel campo.
  • Quando si immette il testo per un campo personalizzato o un oggetto Note (Commento o risposta), è possibile utilizzare i tag HTML nel campo Note Text per creare testo RTF, ad esempio testo in grassetto o corsivo.
Custom API Call

Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all’API Workfront. In questo modo, puoi creare un’automazione del flusso di dati che non può essere eseguita dagli altri moduli di Workfront.

Il modulo restituisce le seguenti informazioni:

  • Status Code (numero): indica l'esito positivo o negativo della richiesta HTTP. Si tratta di codici standard che puoi cercare su Internet.

  • Headers (oggetto): contesto più dettagliato per il codice di risposta/stato che non è correlato al corpo di output. Non tutte le intestazioni visualizzate in un’intestazione di risposta sono intestazioni di risposta, quindi alcune potrebbero non essere utili.

    Le intestazioni di risposta dipendono dalla richiesta HTTP scelta durante la configurazione del modulo.

  • Body (oggetto): a seconda della richiesta HTTP scelta durante la configurazione del modulo, alcuni dati potrebbero essere restituiti. Tali dati, ad esempio i dati di una richiesta GET, sono contenuti in questo oggetto.

Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
URL Immettere un percorso relativo a https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/.
API Version Seleziona la versione dell’API Workfront che desideri venga utilizzata dal modulo.
Method Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, vedere Metodi di richiesta HTTP in Adobe Workfront Fusion.
Headers

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

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

Nota: se ricevi errori ed è difficile determinarne l’origine, puoi modificare le intestazioni in base alla documentazione di Workfront. Se la chiamata API personalizzata restituisce un errore di richiesta HTTP 422, provare a utilizzare un'intestazione "Content-Type":"text/plain".

Query String

Aggiungi la query per la chiamata API sotto forma di oggetto JSON standard.

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

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

Body

Aggiungi il contenuto body per la chiamata API sotto forma di oggetto JSON standard.

Nota:

Quando si utilizzano istruzioni condizionali come if nel JSON, inserire le virgolette al di fuori dell'istruzione condizionale.

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

Delete Record

Questo modulo di azione elimina un oggetto, ad esempio un progetto, un’attività o un problema in Workfront.

Specifica l’ID del record.

Il modulo restituisce l’ID del record ed eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Force delete Abilita questa opzione per garantire che il record venga eliminato, anche se l’interfaccia utente di Workfront richiede la conferma dell’eliminazione.
Async delete Abilita questa opzione per consentire al modulo di eliminarlo in modo asincrono.
ID

Immettere l'ID Workfront univoco del record che si desidera eliminare dal 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

Record Type Selezionare il tipo di record Workfront da eliminare dal modulo.

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

note note
NOTE
Per evitare che i record vengano eliminati a causa di operazioni asincrone, è consigliabile effettuare la configurazione dello scenario seguente.
  1. Eliminare il record in modo sincrono.
  2. Aggiungi la gestione degli errori al modulo Elimina record per ignorare l’errore causato dal timeout di 40 secondi.
Download Document

Questo modulo di azione scarica un documento da Workfront.

Specifica l’ID del record.

Il modulo restituisce il contenuto, il nome, l'estensione e la dimensione del file del documento. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Document ID

Mappa o immetti manualmente l’ID Workfront univoco del documento che desideri scaricare dal 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

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

Misc Action

Questo modulo di azione consente di eseguire azioni sull’API.

note note
NOTE
A luglio 2024, l'azione convertToProject include il campo copyCategories. Se è impostato su TRUE, tutti i moduli personalizzati verranno inclusi nel progetto in cui viene convertito il problema.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Record Type Selezionare il tipo di record Workfront con cui si desidera interagire il modulo.
Action

Selezionare l'azione che si desidera venga eseguita dal modulo.

Potrebbe essere necessario compilare ulteriori campi, a seconda di Record Type e Action scelti. Alcune combinazioni di queste due impostazioni possono richiedere solo un ID record, mentre altre (come Project per Record Type e Attach Template per Action) richiedono informazioni aggiuntive (ad esempio un ID oggetto e un ID modello).

Per le opzioni disponibili per alcune azioni, vedere Opzioni di 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 tramite la versione 14 dell'API, ma contiene comunque informazioni importanti per le chiamate API.

  1. Seleziona il tipo di record nella barra di navigazione a sinistra, nella pagina della documentazione per gli sviluppatori di Workfront. I seguenti tipi hanno pagine proprie:

    • Projects

    • Tasks

    • Issues

    • Users

    • Documents

    Per tutti gli altri tipi di record, selezionare Other objects and endpoints e individuare il tipo di record nelle pagine ordinate alfabeticamente.

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

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

Nota:

Durante la creazione di una bozza tramite il modulo Workfront Misc Action, è consigliabile creare una bozza senza opzioni avanzate, quindi aggiornarla utilizzando l'API SOAP Workfront Proof.

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

ID

Immetti o mappa l’ID Workfront univoco del record con cui desideri interagire 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

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

Opzioni di azione varie

Attività
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
Azione Opzioni
Copia
  • clearApprovers

  • clearAssignments

  • clearConstraints

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Cancella i dati finanziari

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Cancella le notifiche promemoria

Sposta
  • clearApprovers

  • clearAssignments

  • clearDocuments

  • clearConstraints

  • clearExpenses

  • clearFinancials

    Cancella i dati finanziari

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Cancella le notifiche promemoria

Problema
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored
Azione Opzioni
Copia
  • clearApprovers
  • clearAssignments
  • clearCustomData
  • clearDocuments
  • clearPermissions
  • clearProgress
Converti in attività
  • 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

Converti in progetto
  • preserveIssue

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

  • preservePrimaryContact

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

Progetto
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
Azione Opzioni
Copia
  • clearApprovers

  • clearAssignments

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Cancella i dati finanziari

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Cancella le notifiche promemoria

Allega modello/Salva come modello
  • clearApprovers

  • clearAssignments

  • clearBillingRates

  • clearConstraints

  • clearDeliverables

    Cancella gli obiettivi

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Cancella i dati finanziari

  • clearHourTypes

  • clearIssueSetup

    Cancella la configurazione delle proprietà e dei problemi della coda

  • clearPredecessors

  • clearRisks

  • clearSharingOptions

  • clearTimedNotifications

    Cancella le notifiche promemoria

Read a Record

Questo modulo di azione recupera i dati da un singolo record.

Specifica l’ID del record. È inoltre possibile specificare quali record correlati si desidera che vengano letti dal modulo.

Ad esempio, se il record che il modulo sta leggendo è un progetto, è possibile specificare che si desidera che le attività del progetto vengano lette.

Il modulo restituisce un array di dati dai campi di output specificati.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

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 Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Record Type Scegliere il tipo di oggetto Workfront che si desidera venga letto dal modulo.
Outputs Seleziona le informazioni da includere nel bundle di output per questo modulo.
References Selezionare i campi di riferimento da includere nell'output.
Collections Selezionare i campi di riferimento da includere nell'output.
ID

Immettere l'ID Workfront univoco del record che si desidera venga letto dal 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

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

Update Record

Questo modulo di azione aggiorna un oggetto, ad esempio un progetto, un’attività o un problema. Il modulo consente di selezionare quale dei campi dell’oggetto è disponibile nel modulo.

Specifica l’ID del record.

Il modulo restituisce l’ID dell’oggetto ed eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
ID

Immettere l'ID Workfront univoco del record che si desidera aggiornare nel 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

Record Type Selezionare il tipo di record Workfront che si desidera aggiornare nel modulo.
Select fields to map Selezionare i campi che si desidera rendere disponibili per l'immissione dei dati. Questo consente di utilizzare questi campi senza dover scorrere quelli non necessari. È quindi possibile immettere o mappare i dati in questi campi.

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

note note
NOTE
  • Quando si immette l'ID di un oggetto, è possibile iniziare a digitare il nome dell'oggetto, quindi selezionarlo dall'elenco. Il modulo immette quindi l’ID appropriato nel campo.
  • Quando si immette il testo per un campo personalizzato o un oggetto Note (Commento o risposta), è possibile utilizzare i tag HTML nel campo Note Text per creare testo RTF, ad esempio testo in grassetto o corsivo.
Upload Document

Questo modulo di azione carica un documento in un oggetto Workfront, ad esempio un progetto, un’attività o un problema. Questo modulo carica il documento in blocchi, rendendo il processo di caricamento più semplice per Workfront.

Questo modulo può gestire file di dimensioni maggiori rispetto al modulo legacy e fa parte di un rollout graduale per le organizzazioni con un pacchetto Ultimate Workfront.

È possibile specificare la posizione del documento, il file da caricare e un nuovo nome facoltativo per il file.

Il modulo restituisce l’ID del documento e dei campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Related Record ID Immettere l'ID Workfront univoco del record in cui si desidera caricare il documento.
Related Record Type Seleziona il tipo di record Workfront in cui vuoi che il modulo carichi il documento.
Folder ID A seconda del tipo di record correlato, potrebbe essere necessario immettere o mappare un ID cartella.
Source file Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

Upload Document (Legacy)

Questo modulo di azione carica un documento in un oggetto Workfront, ad esempio un progetto, un’attività o un problema. Carica l’intero documento contemporaneamente.

È possibile specificare la posizione del documento, il file da caricare e un nuovo nome facoltativo per il file.

Il modulo restituisce l’ID del documento e dei campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Related Record ID Immettere l'ID Workfront univoco del record in cui si desidera caricare il documento.
Related Record Type Seleziona il tipo di record Workfront in cui vuoi che il modulo carichi il documento.
Folder ID A seconda del tipo di record correlato, potrebbe essere necessario immettere o mappare un ID cartella.
Source file Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.

Visualizzare un elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo di Workfront.

Ricerche

Read Related Records

Questo modulo di ricerca legge i record corrispondenti alla query di ricerca specificata, in un particolare oggetto padre.

È possibile specificare quali campi includere nell'output. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Record Type

Selezionare il tipo di record padre (oggetto Workfront) di cui si desidera leggere i record associati.

Vedere l'elenco dei tipi di oggetto Workfront per i quali è possibile utilizzare questo modulo in tipi di oggetto Workfront disponibili per ogni modulo Workfront in questo articolo.

Parent Record ID

Immettere o mappare l'ID del record padre di cui si desidera 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

Collections Selezionare o mappare il tipo di record figlio che si desidera leggere nel modulo.
Outputs Seleziona le informazioni da includere nel bundle di output per questo modulo.
Search

Questo modulo di ricerca cerca i record in un oggetto in Workfront che corrispondono alla query di ricerca specificata.

Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

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 8-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione dell'app Workfront a Workfront Fusion, vedere Connessione di Workfront a Workfront Fusion in questo articolo.
Record Type Selezionare il tipo di record Workfront che si desidera cercare nel modulo.
Result Set Selezionare un'opzione per specificare se si desidera che il modulo ottenga il primo risultato corrispondente ai criteri di ricerca o tutti i risultati corrispondenti.
Maximal Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.
Search criteria fields Selezionare i campi da utilizzare per i criteri di ricerca. Questi campi saranno quindi disponibili nel menu a discesa Criteri di ricerca.
Search criteria

Immettere il campo in base al quale si desidera eseguire la ricerca, l'operatore che si desidera 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 comporta l'accesso dell'utente a Workfront e la ricerca non avrà esito positivo.

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

Outputs Selezionare i campi da includere nell'output per questo modulo.
References Selezionare i campi di riferimento da includere nella ricerca.
Collections Seleziona le raccolte che desideri aggiungere alla ricerca.

Tipi di oggetto Workfront disponibili per ogni modulo Workfront

Tipi di oggetto disponibili per ogni modulo trigger di Workfront
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 layout-auto
Watch Record Watch Field Watch Events
Processo di approvazione
Assegnazione
Linea di base
Fatturazione
Tariffa di fatturazione
Azienda
Dashboard
Documento
Cartella documenti
Richiesta documento
Versione documento
Spesa
Tipo di spesa
Gruppo
Ora
Tipo di ora
Problema
Iterazione
Ruolo
Voce del diario
Milestone
Percorso milestone
Nota
Tag nota
Portfolio
Programma
Progetto
Utente Progetto
Approvazione bozza
Tempo riservato*
Rapporto
Rischio
Tipo Rischio
Approvatore passaggio
Attività
Team
Modello
Attività modello
Scheda orario
Utente
Aggiorna
Tipi di oggetto disponibili per ogni modulo azione di Workfront
note note
NOTE
Il modulo Download Document non è incluso in questa tabella perché i tipi di oggetto Workfront non fanno parte della relativa configurazione.
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 8-row-8 9-row-8 10-row-8 11-row-8 12-row-8 13-row-8 14-row-8 15-row-8 16-row-8 17-row-8 18-row-8 19-row-8 20-row-8 21-row-8 22-row-8 23-row-8 24-row-8 25-row-8 26-row-8 27-row-8 28-row-8 29-row-8 30-row-8 31-row-8 32-row-8 33-row-8 34-row-8 35-row-8 36-row-8 37-row-8 38-row-8 39-row-8 layout-auto
Create a record Update a record Delete a record Upload Document Read a record Custom API Call Misc Action
Processo di approvazione
Assegnazione
Linea di base
Fatturazione
Tariffa di fatturazione
Azienda
Documento
Cartella documenti
Versione documento
Tasso di cambio
Spesa
Tipo di spesa
Documento esterno
Gruppo
Ora
Tipo di ora
Problema
Iterazione
Ruolo
Voce del diario
Milestone
Percorso milestone
Nota
Tag nota
Portfolio
Programma
Progetto
Utente Progetto
Tempo riservato*
Rischio
Tipo Rischio
Approvatore passaggio
Attività
Team
Modello
Attività modello
Scheda orario
Utente
Aggiorna
Tipi di oggetto disponibili per ogni modulo di ricerca di Workfront
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 35-row-3 36-row-3 layout-auto
Search Read Related Records
Processo di approvazione
Assegnazione
Fatturazione
Tariffa di fatturazione
Azienda
Documento
Cartella documenti
Versione documento
Spesa
Tipo di spesa
Gruppo
Ora
Tipo di ora
Problema
Iterazione
Ruolo
Voce del diario
Milestone
Percorso milestone
Nota
Tag nota
Portfolio
Programma
Progetto
Utente Progetto
Tempo riservato*
Rischio
Tipo Rischio
Approvatore passaggio
Attività
Team
Modello
Attività modello
Scheda orario
Utente
Delega utente

Si consiglia di verificare che questo funzioni come previsto.

Filtri di sottoscrizione eventi nei moduli Workfront > Watch Events

NOTE
Si consiglia vivamente di utilizzare i filtri di abbonamento agli eventi nei moduli Watch Events.

Il modulo Workfront Watch Events attiva scenari basati su un webhook che crea una sottoscrizione di eventi nell'API Workfront. L’abbonamento a un evento è un set di dati che determina quali eventi vengono inviati al webhook. Ad esempio, se imposti un modulo Watch Events che sta monitorando la presenza di problemi, l'abbonamento all'evento invia solo gli eventi relativi ai problemi.

Utilizzando i filtri di abbonamento agli eventi, gli utenti di Fusion possono creare sottoscrizioni agli eventi più adatte ai loro casi d’uso. È ad esempio possibile impostare una sottoscrizione evento nell'API Workfront per inviare al webhook solo i problemi che si trovano in un progetto specifico, assicurandosi che il modulo Watch Events venga attivato solo per i problemi di tale progetto. La possibilità di creare trigger più piccoli migliora la progettazione dello scenario riducendo il numero di trigger irrilevanti.

Questa operazione è diversa dalla configurazione di un filtro nello scenario Workfront Fusion. Senza un filtro di abbonamento agli eventi, il webhook riceve tutti gli eventi relativi al tipo di oggetto selezionato. La maggior parte di questi eventi sarebbe irrilevante per lo scenario e deve essere filtrata prima che lo scenario possa continuare.

Nel filtro Workfront > Osserva eventi sono disponibili i seguenti operatori:

  • Uguale a

  • Non è uguale a

  • Maggiore di

  • Minore di

  • Maggiore o uguale a

  • Minore o uguale a

  • Contiene

  • Esiste

    • Questo operatore non richiede un valore e il campo del valore è assente.
  • Non esiste

    • Questo operatore non richiede un valore e il campo del valore è assente.
  • Cambiato

    • Questo operatore non richiede un valore e il campo del valore è assente.
    • Questo operatore ignora il campo Stato.
    • Quando utilizzi Changed, seleziona Solo eventi aggiornati nel campo Origine record.
IMPORTANT
Non è possibile modificare i filtri nei webhook Workfront esistenti. Per impostare filtri diversi per le sottoscrizioni di eventi Workfront, rimuovi il webhook corrente e creane uno nuovo.
INFO
Esempio: considera uno scenario che elabora nuovi problemi assegnati a un utente specifico, Ana.

Filtrare gli eventi utilizzando un filtro di abbonamento agli eventi (scelta consigliata) filtrare-gli-eventi-utilizzando-un-filtro-di-abbonamento-agli-eventi-(scelta-consigliata)

Utilizzando il filtro eventi, puoi impostare il webhook per attivare lo scenario quando un problema viene assegnato ad Ana al momento della creazione. Ana ha l’ID utente b378489d8f7cd3cee0539260720a84b7.
Filtro eventi
Se vengono creati 100 problemi in un giorno, ma solo due di essi sono assegnati ad Ana, lo scenario verrebbe eseguito due volte.

Filtra gli eventi all’interno dello scenario (scelta non consigliata) filtra-gli-eventi-all%E2%80%99interno-dello-scenario-(scelta-non-consigliata)

Per filtrare gli eventi in modo che vengano elaborati solo i problemi assegnati ad Ana, è possibile creare un filtro dopo il modulo Watch Events.
Senza filtro eventi
Se vengono creati 100 problemi in un giorno, ma solo due di essi sono assegnati ad Ana, lo scenario verrebbe eseguito 100 volte. 98 esecuzioni si fermerebbero al filtro, ma il modulo trigger consuma ancora dati ed esegue operazioni in tutte le esecuzioni.

Per ulteriori informazioni sulle sottoscrizioni di eventi di Workfront, vedere Domande frequenti - Sottoscrizioni eventi.

Per ulteriori informazioni sui webhook, vedi Trigger istantanei (webhook) in Adobe Workfront Fusion

Per ulteriori informazioni sui filtri negli scenari, vedere Aggiungere un filtro a uno scenario.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3