DocumentazioneWorkfrontGuida di Workfront

Adobe Workfront moduli

Last update: Thu Jun 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente

È possibile utilizzare Adobe Workfront Fusion Adobe Workfront per automatizzare i processi in Workfront. Se si dispone di Workfront Fusion per l'automazione e l'integrazione del lavoro , puoi utilizzarla anche per connettersi ad app e servizi di terze parti.

Il Workfront il connettore non viene conteggiato rispetto al numero di app attive disponibili per l’organizzazione. Tutti gli scenari, anche se utilizzano solo Workfront app, conteggio rispetto al conteggio totale degli scenari della tua organizzazione.

Per ulteriori informazioni sulle app e sugli scenari disponibili per la tua organizzazione, consulta Organismi in Adobe Workfront Fusion organizzazioni e team.

Per istruzioni sulla creazione di uno scenario, consulta Creare uno scenario in Adobe Workfront Fusion. Per informazioni sui moduli, consulta Moduli in Adobe Workfront Fusion.

Requisiti di accesso

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

Adobe Workfront piano*
Pro o versione successiva
Adobe Workfront licenza*
Plan, Work
Adobe Workfront Fusion licenza**

Fabbisogno di licenza corrente: No Workfront Fusion requisito di licenza.

Oppure

Requisito licenza legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro, Workfront Fusion per automazione lavoro

Prodotto

Fabbisogno prodotto corrente: se si dispone di Select o Prime Adobe Workfront Pianifica, la tua organizzazione deve acquistare Adobe Workfront Fusion nonché Adobe Workfront per utilizzare la funzionalità descritta in questo articolo. Workfront Fusion è incluso in Ultimate Workfront piano.

Oppure

Requisiti del prodotto legacy: la tua organizzazione deve acquistare Adobe Workfront Fusion nonché Adobe Workfront per utilizzare la funzionalità descritta in questo articolo.

Per conoscere il piano, il tipo di licenza o l'accesso di cui si dispone, contattare Workfront amministratore.

Per informazioni su Adobe Workfront Fusion licenze, consulta Adobe Workfront Fusion licenze.

Connetti Workfront a Workfront Fusion

Il Workfront Il connettore utilizza OAuth 2.0 per connettersi a Workfront.

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

  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
    Nome connessione Immettere un nome per la nuova connessione.
    Environment Seleziona se ti connetti a un ambiente di produzione o non di produzione.
    Tipo di connessione Specificare se ci si connette a un account di servizio o a un account personale.
    ID client Immetti il Workfront ID client. È disponibile nell’area Applicazioni OAuth2 dell’area Configura di Workfront. Apri l’applicazione specifica a cui ti stai connettendo per visualizzare l’ID client.
    Segreto client Immetti il Workfront ID client. È disponibile nell’area Applicazioni OAuth2 dell’area Configura di Workfront. Apri l’applicazione specifica a cui ti stai connettendo per visualizzare l’ID client.
    URL autenticazione

    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
    Prefisso host Nella maggior parte dei casi, questo valore deve essere origin.

  3. Clic Continua per salvare la connessione e tornare al modulo.

NOTE

  • Se non viene visualizzato un pulsante di accesso SAML, significa che l'organizzazione non ha attivato il Single Sign-On (SSO). Puoi accedere con il tuo nome utente e la tua password.

    Per ulteriori informazioni sull'SSO, vedere Panoramica del Single Sign-On Adobe Workfront

  • Connessioni OAuth 2.0 al Workfront Le API non si basano più sulle chiavi API.

Workfront moduli e relativi campi

Quando si configura Workfront moduli, Workfront Fusion visualizza i campi elencati di seguito. Oltre a questi, ulteriori Workfront I campi potrebbero essere visualizzati in base a 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, consulta Mappare le informazioni da un modulo all’altro in Adobe Workfront Fusion.

NOTE
Se non trovi i campi più aggiornati in un modulo Workfront, potrebbe trattarsi di un problema di caching. Attendi un’ora e riprova.

Triggers

Guarda gli eventi

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. Clic Aggiungi a destra del Webhook casella.

  2. Configurare il webhook in Aggiungi un hook che viene visualizzata.

    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
    Nome webhook (Facoltativo) Digita un nuovo nome per il webhook
    Connection Per istruzioni sulla connessione Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
    Tipo di record Seleziona il tipo di Workfront registrare che si desidera che il modulo controlli.
    State

    Seleziona se desideri controllare lo stato precedente o quello nuovo.

    • Nuovo stato

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

      Ad esempio, se lo stato è impostato su Nuovo stato e il filtro è impostato su Stato È uguale a In corso, il webhook attiva uno scenario quando lo stato Stato diventa In corso, indipendentemente dallo stato precedente.

    • Old State

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

      Ad esempio, se lo stato è impostato su Old State e il filtro è impostato su Status Equals In corso, il webhook attiva uno scenario quando uno stato Status attualmente In corso 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 esistenti Workfront webhook. Per impostare filtri diversi per Workfront sottoscrizioni di eventi, rimuovi il webhook corrente e creane uno nuovo.

    Per ulteriori informazioni sui filtri evento, consulta Filtri di abbonamento agli eventi in Workfront > Moduli 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.
    Origine record

    Scegli se desideri che lo scenario sia visibile Solo Nuovi Record, Aggiornato Solo Record, Record nuovi e aggiornati, o Deleted Records Only.

    Nota: se si sceglie Record nuovi e aggiornati, la creazione del webhook crea 2 abbonamenti evento (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 di eventi nel Workfront Articolo della Guida API di abbonamento agli eventi.

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

Campo di controllo

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 Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Tipo di record

Seleziona il tipo di Workfront registrare che si desidera che il modulo controlli.

Selezionare ad esempio Attività se si desidera avviare l'esecuzione dello scenario ogni volta che viene aggiornato un campo record in un'attività.
Field Seleziona il campo che desideri che il modulo controlli per gli aggiornamenti. Questi campi riflettono i campi Workfront l'amministratore ha configurato per il tracciamento.
Output Seleziona le informazioni 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.

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

Record di controllo

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 nel periodo di tempo specificato 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 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Filtro Scegli se desideri che lo scenario sia visibile Solo Nuovi Record, Aggiornato Solo Record, o Record nuovi e aggiornati.
Tipo di record

(Viene visualizzato dopo aver scelto un Filtro.) Seleziona il tipo di Workfront registrare che si desidera che il modulo controlli.

Ad esempio, se si desidera avviare lo scenario ogni volta che viene creato un nuovo progetto, selezionare Progetto
Output Seleziona le informazioni da includere nel bundle di output per questo modulo.
Filtro facoltativo (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.

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

Azioni

Converti oggetto

Questo modulo di azione effettua una delle seguenti conversioni:

  • Converti problema in progetto
  • Converti problema in attività
  • Converti attività in progetto
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 Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Tipo di oggetto Selezionare il tipo di oggetto da convertire. Questo è il tipo di oggetto prima della conversione.
Converti in 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.
ID modello

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.
Moduli personalizzati 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.
Copia campi nativi Abilita questa opzione per copiare tutti i campi nativi dall’oggetto originale al nuovo oggetto.
Copia moduli personalizzati Abilita questa opzione per copiare tutti i campi nativi dall’oggetto originale al nuovo oggetto.
Creare un record (allegare moduli personalizzati)

Questo modulo di azione crea un oggetto, ad esempio un progetto, un’attività o un problema in Workfronte 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.

Ad esempio, puoi utilizzare questo modulo per creare un’attività in Workfront quando un client aggiunge una nuova riga in una Google Sheets elenco delle attività da eseguire.

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

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.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Tipo di record

Seleziona il tipo di Workfront che si desidera creare nel modulo.

Ad esempio, se desideri creare un progetto, seleziona Progetto dall’elenco a discesa, quindi accertati di avere accesso ai dati (dei moduli precedenti nello scenario) che popoleranno il progetto.
Seleziona campi da mappare

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.

Per i campi nei moduli personalizzati, utilizza Allega Modulo Personalizzato campo.
Allega Modulo Personalizzato Selezionare i moduli personalizzati da aggiungere al nuovo oggetto, quindi immettere i valori per tali campi.

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

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 Nota (Commento o risposta), è possibile utilizzare i tag HTML nella Testo nota per creare testo RTF, ad esempio testo in grassetto o corsivo.

    Per ulteriori informazioni sul testo RTF negli aggiornamenti, consulta Aggiungere un aggiornamento a un elemento di lavoro in Aggiorna lavoro.
Crea 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.

Ad esempio, puoi utilizzare questo modulo per creare un’attività in Workfront quando un client aggiunge una nuova riga in un elenco di attività di Google Sheets che devono essere eseguite.

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

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.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Tipo di record

Seleziona il tipo di Workfront che si desidera creare nel modulo.

Ad esempio, se desideri creare un progetto, seleziona Progetto dall’elenco a discesa, quindi accertati di avere accesso ai dati (dei moduli precedenti nello scenario) che popoleranno il progetto.
Seleziona campi da mappare 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.

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

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 Nota (Commento o risposta), è possibile utilizzare i tag HTML nella Testo nota per creare testo RTF, ad esempio testo in grassetto o corsivo.

    Per ulteriori informazioni sul testo RTF negli aggiornamenti, consulta Aggiungere un aggiornamento a un elemento di lavoro in Aggiorna lavoro.
Chiamata API personalizzata

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

Il modulo restituisce le seguenti informazioni:

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

  • Intestazioni (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.

  • Corpo (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 Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
URL Inserisci un percorso relativo a https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/.
versione API Seleziona la versione di Workfront API che desideri che il modulo utilizzi.
Method Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, consulta 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 al Workfront documentazione. Se la chiamata API personalizzata restituisce un errore di richiesta HTTP 422, prova a utilizzare un "Content-Type":"text/plain" intestazione.
Stringa Di Query

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 quali if nel JSON, inserisci le virgolette al di fuori dell’istruzione condizionale.

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

Elimina 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 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Forza eliminazione Abilita questa opzione per garantire che il record venga eliminato, anche se Workfront L’interfaccia utente richiede la conferma dell’eliminazione.
ID

Immetti l’univoco Workfront ID del record che desideri eliminare dal modulo.

Per ottenere l’ID, apri la Workfront nel browser e copia il testo alla fine dell'URL dopo "ID=". Ad esempio: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
Tipo di record Seleziona il tipo di Workfront che si desidera eliminare dal modulo.

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

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.
Scarica documento

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 Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
ID documento

Mappa o immetti manualmente il codice univoco Workfront ID del documento che desideri scaricare dal modulo.

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

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

Azione Varie

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

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 Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Tipo di record Seleziona il tipo di Workfront che si desidera che il modulo interagisca con.
Action

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

Potrebbe essere necessario compilare ulteriori campi, a seconda del tipo di record e dell'azione scelti. Alcune combinazioni di queste due impostazioni possono richiedere solo un ID record, mentre altre (come Project per Tipo di record e Allega modello per Action) richiedono informazioni aggiuntive (ad esempio un ID oggetto e un ID modello).

Per informazioni dettagliate sui singoli campi, vedere Documentazione per sviluppatori Workfront.

Nota: il sito della documentazione per sviluppatori include informazioni solo tramite la versione 14 dell’API, ma contiene ancora informazioni importanti per le chiamate API.

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

    • Progetti

    • Attività

    • Issues

    • Utenti

    • Documenti

    Per tutti gli altri tipi di record, selezionare Altri oggetti ed endpoint 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 Workfront Nel modulo Misc Action, la procedura consigliata consiste nel creare una bozza senza opzioni avanzate, quindi aggiornarla utilizzando Workfront Proof API SOAP.

Per ulteriori informazioni sulla creazione di una bozza con Workfront API (utilizzata da questo modulo), consulta Aggiungi opzioni di verifica avanzate durante la creazione di una bozza tramite Adobe Workfront API
ID

Inserisci o mappa l’univoco Workfront ID del record con cui vuoi che il modulo interagisca.

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

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

Leggi un 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 standard per l’output specificato.

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 Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Tipo di record Scegli la Workfront tipo di oggetto che si desidera venga letto dal modulo.
Output Seleziona le informazioni da includere nel bundle di output per questo modulo.
Riferimenti Selezionare i campi di riferimento da includere nell'output.
Raccolte Selezionare i campi di riferimento da includere nell'output.
ID

Immetti l’univoco Workfront ID del record che desideri che il modulo legga.

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

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

Aggiorna 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 Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
ID

Immetti l’univoco Workfront ID del record che desideri aggiornare nel modulo.

Per ottenere l’ID, apri la 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 Seleziona il tipo di Workfront che desideri aggiornare il 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.

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

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 Nota (Commento o risposta), è possibile utilizzare i tag HTML nella Testo nota per creare testo RTF, ad esempio testo in grassetto o corsivo.

    Per ulteriori informazioni sul testo RTF negli aggiornamenti, consulta Aggiungere un aggiornamento a un elemento di lavoro in Aggiorna lavoro.
Carica documento

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

È 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 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
ID record correlato Immetti l’univoco Workfront ID del record in cui desideri caricare il documento.
Tipo di record correlato a Seleziona il tipo di Workfront registra dove desideri che il modulo carichi il documento.
File di origine Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

Ricerche

Leggi record correlati

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 Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Tipo di record

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

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo in questo articolo.
ID record padre

Immettere o mappare l'ID del record padre di cui si desidera leggere i record associati.

Per ottenere l’ID, apri la Workfront nel browser e copia il testo alla fine dell'URL dopo "ID=". Ad esempio: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
Raccolte Selezionare o mappare il tipo di record figlio che si desidera leggere nel modulo.
Output Seleziona le informazioni da includere nel bundle di output per questo modulo.
Ricerca

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 Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Tipo di record Seleziona il tipo di Workfront record 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.
max Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.
Campi criteri di ricerca Selezionare i campi da utilizzare per i criteri di ricerca. Questi campi saranno quindi disponibili nel menu a discesa Criteri di ricerca.
Criteri di ricerca di

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 usi username nei criteri di ricerca. Inclusione username in una query API a Workfront accede a Workfront e la ricerca non avrà esito positivo.

Nota: In e NotInutilizzare gli array. Gli input devono essere in formato array.
Output Selezionare i campi da includere nell'output per questo modulo.
Riferimenti Selezionare i campi di riferimento da includere nella ricerca.
Raccolte Seleziona le raccolte che desideri aggiungere alla ricerca.
Ricerca (legacy)

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 layout-auto html-authored no-header
Connection Per istruzioni sulla connessione Workfront app a Workfront Fusion, vedi Connetti Workfront a Workfront Fusion in questo articolo.
Tipo di record Seleziona il tipo di Workfront record 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.
max Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.
Criteri di ricerca di

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 usi username nei criteri di ricerca. Inclusione username in una query API a Workfront accede a Workfront e la ricerca non avrà esito positivo.

Nota: In e NotInutilizzare gli array. Gli input devono essere in formato array.
Output Selezionare i campi da includere nell'output per questo modulo.
Riferimenti Selezionare i campi di riferimento da includere nella ricerca.
Raccolte Seleziona le raccolte che desideri aggiungere alla ricerca.

Consulta l’elenco dei Workfront tipi di oggetto per i quali è possibile utilizzare questo modulo in Workfront tipi di oggetto disponibili per ogni Workfront modulo.

Workfront tipi di oggetto disponibili per ogni Workfront modulo

Tipi di oggetto disponibili per ogni Workfront modulo trigger
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
Osserva Record Watch Field Osserva Eventi
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 Workfront modulo azione
note note
NOTE
Il Scarica documento modulo non è incluso in questa tabella perché Workfront i tipi di oggetto 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
Crea record Aggiorna un record Elimina record Carica documento Leggi un record Chiamata API personalizzata 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 Workfront modulo di ricerca
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
- Ricerca Leggi record correlati
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 abbonamento agli eventi in Workfront > Guarda gli eventi moduli

NOTE
Si consiglia vivamente di utilizzare i filtri di abbonamento agli eventi nel Guarda gli eventi moduli.

Il Workfront Guarda gli eventi Il modulo attiva scenari basati su un webhook che crea un abbonamento evento nel Workfront API. L’abbonamento a un evento è un set di dati che determina quali eventi vengono inviati al webhook. Ad esempio, se imposti un Guarda gli eventi modulo 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, puoi impostare una sottoscrizione di evento nel Workfront API per inviare al webhook solo i problemi presenti in un progetto specifico, assicurando che Guarda gli eventi Il modulo verrà attivato solo per i problemi di quel 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 in Workfront Fusion scenario. 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 si utilizza Changed, seleziona Solo eventi aggiornati nel Origine record campo.
IMPORTANT
Non è possibile modificare i filtri esistenti Workfront webhook. Per impostare filtri diversi per Workfront sottoscrizioni di eventi, rimuovi il webhook corrente e creane uno nuovo.
INFO
Esempio: Considera uno scenario che elabora i 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.
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, puoi creare un filtro dopo Guarda gli eventi modulo.
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 sugli abbonamenti agli eventi, consulta Domande frequenti - Abbonamenti agli eventi.

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

Per ulteriori informazioni sui filtri negli scenari, consulta Aggiungere un filtro a uno scenario in Adobe Workfront Fusion.

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