Moduli Adobe Workfront Planning
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.
s## 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 Connessione di autenticazione Adobe Workfront. Connection name (Nome della connessione) Inserisci un nome per la nuova connessione. ID client Inserisci il tuo ID client. Questo è disponibile nell’area Applicazioni OAuth2 in Configurazione di Workfront. Apri l’applicazione specifica a cui ti stai connettendo per visualizzare l’ID client. Client Secret (Segreto client) Inserisci il Segreto client di Workfront. Questo è disponibile nell’area Applicazioni OAuth2 in Configurazione di Workfront. Se non disponi di un Segreto client per l’applicazione OAuth2 in Workfront, puoi generarne un altro. Per istruzioni, consulta la documentazione di Workfront. URL di autenticazione Questo può rimanere il valore predefinito, oppure puoi inserire l’URL dell’istanza Workfront, seguito da
/integrations/oauth2.Esempio:
https://mydomain.my.workfront.com/integrations/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 Adobe Workfront Planning e relativi campi
Quando configuri i moduli di Workfront, Workfront Fusion mostra i campi elencati di seguito. Oltre a questi campi potrebbero essere mostrati campi di Workfront aggiuntivi, in base a fattori quali il tuo livello di accesso nell’app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.
Se visualizzi il pulsante Map (Mappa) sopra un campo o una funzione, puoi utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, consulta Mappare le informazioni da un modulo a un altro.
Trigger
Guarda gli 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.
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 in 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
Creare un record
Questa azione consente di creare un singolo record in Workfront Planning.
Eliminare un record
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.