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

Espandi per visualizzare i requisiti di accesso per la funzionalità descritta in questo articolo.
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:

URL di base
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
Tag API
v1.13.7

Creare una connessione ad Adobe Workfront Planning create-a-connection-to-adobe-workfront-planning

Puoi creare una connessione al tuo account Workfront Planning direttamente da un modulo Workfront Fusion.

  1. In qualsiasi modulo di Adobe Workfront Planning, fai clic su Aggiungi accanto alla casella Connessione.

  2. Compila i seguenti campi:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    Connection name (Nome della connessione) Specifica un nome per questa connessione.
    Ambiente Seleziona se ti connetti a un ambiente di produzione o non di produzione.
    Tipo Seleziona se ti interessa la connessione a un account di servizio o a un account personale.

    ID client

    (Facoltativo)

    Inserisci il tuo Client ID Adobe. È disponibile nella sezione Credentials details (Dettagli delle credenziali) di Adobe Developer Console.

    Client Secret (Segreto client)

    (Facoltativo)

    Inserisci il tuo Client Secret (Segreto client) Adobe. È disponibile nella sezione Credentials details (Dettagli delle credenziali) di Adobe Developer Console.
    URL di autenticazione

    Immetti l’URL che verrà utilizzato dall’istanza di Workfront per autenticare questa connessione.

    Il valore predefinito è https://oauth.my.workfront.com/integrations/oauth2.

    Prefisso host

    Immetti il prefisso host.

    Il valore predefinito è origin-.

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

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.

Pulsante di attivazione/disattivazione Mappa

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.

Webhook
Selezionare il webhook che si desidera utilizzare o fare clic su Aggiungi per crearne uno nuovo.
Connessione
Per istruzioni sulla creazione di una connessione a Adobe Workfront Planning, consulta Creare una connessione a Adobe Workfront Planning in questo articolo.
Tipo di oggetto
Specificare se si desidera controllare record, tipi di record o aree di lavoro.
Stato

Seleziona se desideri controllare lo stato precedente o quello nuovo.

  • Nuovo stato

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

  • Stato precedente

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

Workspace
Se si desidera controllare i record, selezionare il Workspace che si desidera controllare.
Tipo di record
Se si desidera controllare i record, selezionare il tipo di record che si desidera controllare.
Filtri eventi

Puoi impostare filtri per controllare solo i record che soddisfano i criteri da te selezionati.

Per ogni filtro, inserisci il campo che desideri venga valutato dal filtro, l’operatore e il valore che desideri sia consentito dal filtro. Puoi utilizzare più di un filtro aggiungendo regole di tipo AND.

Nota: non è possibile modificare i filtri nei webhook Workfront esistenti. Per impostare filtri diversi per le sottoscrizioni 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 nell'articolo Moduli Workfront.

Oggetti da controllare
Seleziona se desideri controllare le nuove. record aggiornati, nuovi e aggiornati o eliminati.
Escludi aggiornamenti effettuati da questa connessione
Abilita questa opzione per impedire che lo scenario venga attivato quando viene apportata una modifica dalla connessione utilizzata da questo modulo. Questo impedisce l’attivazione di un’altra istanza dello scenario se questo esegue un’azione di attivazione.

Azioni

Eliminare un tipo di record

Questo modulo di azione elimina un singolo tipo di record in Workfront Planning dal relativo ID.

WARNING
L'eliminazione di un tipo di record in Workfront Planning comporta anche l'eliminazione di tutti i record nella tabella dei tipi di record.
Connessione
Per istruzioni sulla creazione di una connessione a Adobe Workfront Planning, consulta Creare una connessione a Adobe Workfront Planning in questo articolo.
ID tipo di record
Immettere o mappare l'ID del tipo di record che si desidera eliminare.

Effettua chiamata API personalizzata

Questo modulo effettua una chiamata API personalizzata all'API Adobe Workfront Planning.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Workfront Planning, consulta Creare una connessione a Adobe Workfront Planning in questo articolo.
URL
Inserisci un percorso relativo a https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
Metodo
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, consulta Metodi di richiesta HTTP.
Intestazioni

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.

Stringa di query
Per ogni coppia chiave/valore che si desidera aggiungere alla stringa di query, fare clic su Aggiungi elemento e immettere la chiave e il valore.
Corpo

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.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Workfront Planning, consulta Creare una connessione a Adobe Workfront Planning in questo articolo.
Workspace
Immettere o mappare il Workspace contenente i record che si desidera cercare.
Tipo di record
Selezionare il tipo di record che si desidera cercare.
Campi Record
Per ogni campo che si desidera utilizzare nella ricerca, individuare tale campo, selezionare l'operatore e immettere o mappare il valore che si desidera cercare. I campi sono disponibili in base al tipo di record selezionato.
Condizione per filtri

Seleziona la condizione per i filtri:

  • E

    Il modulo restituisce record che soddisfano tutti i valori di campo selezionati.

  • O

    Il modulo restituisce record che soddisfano qualsiasi dei valori di campo selezionati.

Limite
Inserisci oppure mappa il numero massimo di record che il modulo potrà restituire durante ciascun ciclo di esecuzione dello scenario.

Non categorizzato

Creare un record

Questa azione consente di creare un singolo record in Workfront Planning.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Workfront Planning, consulta Creare una connessione a Adobe Workfront Planning in questo articolo.
ID tipo di record
Immettere o mappare il tipo di record che si desidera creare. I tipi di record disponibili sono basati sull'account Workfront Planning.
Altri campi
Immettere i valori desiderati per il nuovo record. Questi campi si basano sul tipo di record selezionato.

Eliminare un record

Questo modulo di azione elimina il record specificato in Workfront Planning.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Workfront Planning, consulta Creare una connessione a Adobe Workfront Planning in questo articolo.
ID record
Immettere o mappare l'ID del record che si desidera eliminare.

Ottieni un record

Questo modulo azioni recupera un singolo record da Adobe Workfront Planning, specificato dal relativo ID.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Workfront Planning, consulta Creare una connessione a Adobe Workfront Planning in questo articolo.
ID record
Immettere o mappare l'ID del record che si desidera recuperare.

Ottieni record per tipo di record

Questo modulo di azione recupera tutti i record del tipo specificato.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Workfront Planning, consulta Creare una connessione a Adobe Workfront Planning in questo articolo.
Workspace
Selezionare o mappare l'area di lavoro contenente i record da recuperare.
Tipo di record
Selezionare il tipo di record da recuperare.

Recupera tipi di record

Questo modulo di azione recupera un elenco di tipi di record in un account Adobe Workfront Planning.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Workfront Planning, consulta Creare una connessione a Adobe Workfront Planning in questo articolo.
Workspace
Selezionare o mappare l'area di lavoro contenente i tipi di record che si desidera recuperare.

Aggiorna record

Questa azione aggiorna un singolo record in Workfront Planning.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Workfront Planning, consulta Creare una connessione a Adobe Workfront Planning in questo articolo.
ID record
Immettere o mappare il tipo di record che si desidera aggiornare. I tipi di record disponibili sono basati sull'account Workfront Planning.
Altri campi
Immettere i nuovi valori che si desidera assegnare al record. Questi campi si basano sul tipo di record selezionato.

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.

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