Moduli Adobe Workfront - Pianificazione
Con i moduli Adobe Workfront Planning è possibile attivare uno scenario quando si verificano eventi in Workfront Planning. È inoltre possibile creare, leggere, aggiornare ed eliminare record oppure eseguire una chiamata API personalizzata all’account Adobe Workfront Planning.
Requisiti di accesso
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Pacchetto 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. |
| Licenze Adobe Workfront |
Standard Work o successiva |
| Prodotto | Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion. |
Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione.
Prerequisiti
Per accedere a Workfront Planning, è necessario disporre dei seguenti elementi:
- Un nuovo pacchetto Workfront e una nuova licenza. Workfront Planning non è disponibile per i pacchetti o le licenze legacy di Workfront.
- Un pacchetto di Workfront Planning.
- L’istanza di Workfront della tua organizzazione deve essere integrata in Adobe Unified Experience.
Informazioni API di Adobe Workfront Planning
Il connettore Adobe Workfront Planning utilizza quanto segue:
Connessione di Workfront Planning a Workfront Fusion
Il connettore Workfront Planning utilizza OAuth 2.0 per connettersi a Workfront Planning.
È possibile creare una connessione all’account Workfront Planning direttamente da un modulo Workfront Planning Fusion.
Connessione a Workfront Planning tramite ID client e segreto client
-
In qualsiasi modulo di Adobe Workfront Planning, fare clic su Aggiungi accanto al campo Connessione.
-
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 la connessione Adobe Workfront auth. 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/oauth2Prefisso host Nella maggior parte dei casi, questo valore deve essere origin. -
Fai clic su Continua per salvare la connessione e tornare al modulo.
Se non si è connessi a Workfront Planning, viene visualizzata una schermata di accesso. Dopo aver effettuato l’accesso, puoi autorizzare la connessione.
- Le connessioni OAuth 2.0 all’API Workfront non sono più basate sulle chiavi API.
- Per creare una connessione a un ambiente sandbox di 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.
Connettersi a Workfront Planning utilizzando una connessione server-to-server
-
In qualsiasi modulo di Adobe Workfront Planning, fare clic su Aggiungi accanto al campo Connessione.
-
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, inserisciexample.Percorso dell’istanza Inserisci il tipo di ambiente della connessione.
Esempio: se l’URL è
https://example.my.workfront.com, inseriscimy.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. -
Fai clic su Continua per salvare la connessione e tornare al modulo.
Se non si è connessi a Workfront Planning, viene visualizzata una schermata di accesso. Dopo aver effettuato l’accesso, puoi autorizzare la connessione.
- Le connessioni OAuth 2.0 all’API Workfront non sono più basate sulle chiavi API.
- Per creare una connessione a un ambiente sandbox di 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 di Adobe Workfront Planning versione 2 e relativi campi
Quando si configurano i moduli di Workfront Planning, Workfront Fusion visualizza 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.
Aree di lavoro (V2)
Creare un’area di lavoro (V2)
Questo modulo di azione crea una nuova area di lavoro in Planning.
Eliminare un’area di lavoro (V2)
Questo modulo di azione elimina un singolo workspace, specificato dall’ID.
Ottieni tutte le aree di lavoro (V2)
Questo modulo recupera un elenco di tutte le aree di lavoro.
Ottieni un’area di lavoro (V2)
Questo modulo recupera un’area di lavoro in base al relativo ID.
Aggiornare un’area di lavoro (V2)
Questo modulo di azione aggiorna una nuova area di lavoro in Planning.
Tipi di record (V2)
Creare un tipo di record (V2)
Questo modulo di azione crea un nuovo tipo di record nell’area di lavoro selezionata.
Eliminare un tipo di record (V2)
Questo modulo di azione elimina un singolo tipo di record, specificato dall’ID.
Ottieni tipi di record globali (V2)
Questo modulo recupera un elenco di tipi di record in un account Adobe Workfront Planning.
Ottieni un tipo di record (V2)
Questo modulo recupera un tipo di record in base al relativo ID.
Recupera tipi di record (V2)
Questo modulo recupera un elenco di tipi di record disponibili in una determinata area di lavoro.
Aggiornare un tipo di record (V2)
Questo modulo aggiorna un tipo di record.
Record (V2)
Crea un record (V2)
Questa azione consente di creare un singolo record in Workfront Planning.
Eliminare un record (V2)
Questo modulo di azione elimina un singolo record, specificato dall’ID.
Ottieni un record (V2)
Questo modulo di azione recupera un record, specificato dal relativo ID.
Ottieni record per tipo di record (V2)
Questo modulo recupera un elenco di tutti i record del tipo di record specificato.
Sposta record (V2)
Questo modulo riordina uno o più record all’interno di un tipo di record specificando dove inserirli.
Cerca record (V2)
Restituire i record in base ai criteri specificati
Aggiornare un record (V2)
Questo modulo aggiorna il record specificato.
Campi (V2)
Crea un campo (V2)
Questo modulo di azione crea un nuovo campo sul tipo di record specificato.
Eliminare un campo (V2)
Questo modulo di azione elimina un singolo campo, specificato dall’ID.
Ottieni un campo (V2)
Questo modulo recupera un campo in base al relativo ID.
Recupera campi per tipo di record (V2)
Questo modulo recupera un elenco di campi per un tipo di record specifico.
Aggiornare un campo (V2)
Questo modulo aggiorna parzialmente un campo in base al relativo ID.
Viste (V2)
Creare una vista (V2)
Questo modulo di azione crea una nuova visualizzazione per il tipo di record selezionato.
Eliminare una vista (V2)
Questo modulo di azione elimina una singola vista, specificata dall’ID.
Ottieni una visualizzazione (V2)
Questo modulo recupera una vista in base al relativo ID.
Ottieni visualizzazioni per tipo di record (V2)
Questo modulo recupera un elenco di visualizzazioni per il tipo di record specifico.
Aggiornare una vista (V2)
Questo modulo di azione aggiorna la vista specificata.
Autorizzazioni (V2)
Ignora richieste di accesso (V2)
Questo modulo di azione ignora una o più richieste di accesso, specificate dall’ID.
Ottenere tutti i membri e i relativi ruoli per una risorsa (V2)
Questo modulo elenca tutti gli utenti, i gruppi e i team che hanno una relazione di condivisione esplicita sulla risorsa. Le credenziali utilizzate nella connessione per questo modulo devono disporre dell’autorizzazione Gestione per la risorsa.
Ottenere le autorizzazioni effettive dell’utente corrente per una risorsa (V2)
Questo modulo restituisce le autorizzazioni di visualizzazione, modifica, eliminazione e aggiunta dell’utente corrente per una determinata risorsa.
Elencare le richieste di accesso in sospeso per una risorsa (V2)
Questo modulo restituisce tutte le richieste di accesso in sospeso per la risorsa specificata.
Richiedi accesso a una risorsa (V2)
Questo modulo crea o aggiorna una richiesta di accesso per l’utente corrente sulla risorsa specificata.
Altro (V2)
Ottieni ID di autenticazione da Workfront ID (V2)
Questo modulo accetta un ID utente di Workfront e restituisce l’ID di autorizzazione corrispondente utilizzato da Planning.
Effettuare una chiamata API personalizzata (V2)<tabella
Questo modulo effettua una chiamata personalizzata all’API di pianificazione di Workfront.
https://<WORKFRONT_DOMAIN>/maestro/api/..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"}
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.
Eventi Watch (V2)
Questo modulo di attivazione avvia uno scenario quando un record, un tipo di record o un’area di lavoro viene creata, aggiornata o eliminata in Workfront Planning.
- Il webhook modificato viene trattato dagli abbonamenti agli eventi di Workfront come un nuovo abbonamento. La cronologia delle sottoscrizioni degli eventi non viene mantenuta per la configurazione del webhook precedente, in quanto viene considerata una sottoscrizione di evento separata.
- Il passaggio dalla sottoscrizione precedente a quella nuova potrebbe non essere sincronizzato perfettamente. È quindi possibile ricevere un evento due volte (se il nuovo abbonamento inizia a essere eseguito prima che quello vecchio si fermi) o perdere un evento (se il vecchio abbonamento si arresta prima che quello nuovo inizi a essere eseguito).
Per un esempio di utilizzo della logica avanzata in questo modulo, vedere Esempio di logica avanzata nel modulo Watch Events.
Moduli di Adobe Workfront Planning versione 1 e relativi campi
Quando si configurano i moduli di Workfront Planning, Workfront Fusion visualizza 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
Osserva eventi
Questo modulo di attivazione avvia uno scenario quando un record, un tipo di record o un’area di lavoro viene creata, aggiornata o eliminata in Workfront Planning.
- Il webhook modificato viene trattato dagli abbonamenti agli eventi di Workfront come un nuovo abbonamento. La cronologia delle sottoscrizioni degli eventi non viene mantenuta per la configurazione del webhook precedente, in quanto viene considerata una sottoscrizione di evento separata.
- Il passaggio dalla sottoscrizione precedente a quella nuova potrebbe non essere sincronizzato perfettamente. È quindi possibile ricevere un evento due volte (se il nuovo abbonamento inizia a essere eseguito prima che quello vecchio si fermi) o perdere un evento (se il vecchio abbonamento si arresta prima che quello nuovo inizi a essere eseguito).
Per un esempio di utilizzo della logica avanzata in questo modulo, vedere Esempio di logica avanzata nel modulo Watch Events.
Azioni
Eliminare un tipo di record
Questo modulo di azione elimina un singolo tipo di record in Workfront Planning dal relativo ID.
Effettua chiamata API personalizzata
Questo modulo effettua una chiamata API personalizzata all’API Adobe Workfront Planning.
https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard.
Ad esempio: {"Content-type":"application/json"}
Workfront Fusion aggiunge automaticamente le intestazioni di autorizzazione.
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.
Ricerche
Cerca record
Questo modulo di azione recupera un elenco di record in base ai criteri specificati.
Non categorizzato
Crea un record
Questa azione consente di creare un singolo record in Workfront Planning.
Elimina una decisione
Questo modulo di azione elimina il record specificato in Workfront Planning.
Ottieni un record
Questo modulo azioni recupera un singolo record da Adobe Workfront Planning, specificato dal relativo ID.
Ottieni record per tipo di record
Questo modulo di azione recupera tutti i record del tipo specificato.
Recupera tipi di record
Questo modulo di azione recupera un elenco di tipi di record in un account Adobe Workfront Planning.
Aggiorna record
Questa azione aggiorna un singolo record in Workfront Planning.
Usa JSONata per raggruppamenti di record-types leggibili
La seguente espressione JSONata crea un output leggibile della query di Planning che fornisce la suddivisione per tipi di record. In questo modo il nome del tipo di record, i nomi dei campi e i nomi delle opzioni di campo (se applicabile) sono leggibili da un nome e il resto della struttura rimane intatto.
(
$s0 := ({"data":$ ~> | fields | {"options":(options){name:$}} |});
$s1 := ({"data":$s0.data ~> | **.fields | {"options_name":(options.*){displayName:$}} | });
$s2 := $s1 ~> | data | {"fields":(fields){displayName:$}} |;
$s2.data{displayName:$}
)
Per informazioni sull’utilizzo dei moduli JSONata, vedere Moduli JSONata.
Esempio di logica avanzata nel modulo Watch Events
Questo è un esempio del formato utilizzato dalla logica avanzata quando si utilizza il modulo Workfront Planning > Osserva eventi.
[
{
"fieldName": "recordTypeId",
"fieldValue": "Rt68c886502d4b5554ee80896b",
"comparison": "eq",
"state": "newState"
},
{
"fieldName": "data",
"fieldValue": {
"F68c886502d4b5554ee808975": "planning"
},
"comparison": "eq",
"state": "newState"
},
{
"fieldName": "data",
"fieldValue": {
"F68c886502d4b5554ee808975": "active"
},
"comparison": "eq",
"state": "newState"
}
]
Quando utilizzi una logica avanzata nel modulo Watch Event, tieni presente quanto segue:
- La prima voce
"fieldvalue":è l’ID del tipo di record di pianificazione estratto dall’URL. In questo esempio, l’ID del tipo di record di pianificazione èRt68c886502d4b5554ee80896b. - I dati di Planning vengono restituiti all’interno di un array denominato
data, che in questo esempio viene visualizzato come"fieldName": "data". - I nomi dei campi di Planning vengono restituiti come ID che iniziano con
F. - Poiché questo esempio esegue la valutazione in base a un connettore di filtro
OR, sono presenti due voci per lo stesso campo (F68c886502d4b5554eec808975). Le due opzioni dell’elenco a discesa a cui si applica il filtro del modulo sono"planning"e"active".