Azure DevOps moduli
In uno scenario Adobe Workfront Fusion, è possibile automatizzare i flussi di lavoro che utilizzano Azure DevOps e collegarlo a più applicazioni e servizi di terze parti.
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:
| 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: Workfront Fusion per l'automazione e l'integrazione del lavoro |
| Prodotto |
Nuovo:
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.
Prerequisiti
Per utilizzare i moduli Azure DevOps, è necessario disporre di un account DevOps Azure.
Informazioni API di Azure DevOps
Il connettore DevOps di Azure utilizza quanto segue:
| Versione API | v5.1 |
| Tag API | v1.29.33 |
Connetti Azure DevOps a Workfront Fusion
-
Aggiungi un modulo Azure DevOps allo scenario.
-
Fai clic su Aggiungi accanto al campo Connessione.
-
Nel campo Tipo di connessione, selezionare Azure DevOps.
IMPORTANTIl tipo di connessione Azure DevOps (Richiedi tutti gli ambiti) diventerà obsoleto nel prossimo futuro. Pertanto, si sconsiglia di utilizzarlo. -
Compila i campi seguenti:
Nome connessioneImmettere un nome per la connessione che si sta creando.OrganizzazioneImmettere il nome dell'organizzazione con cui è stata creata l'applicazione Azure DevOps. -
Per immettere un ID app o un segreto client di Azure DevOps, fare clic su Mostra impostazioni avanzate e immetterle nei campi aperti.
-
Fai clic su Continua per completare la configurazione della connessione e continuare a creare lo scenario.
Moduli DevOps di Azure e relativi campi
Quando configuri Azure DevOps moduli, Workfront Fusion visualizza i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati ulteriori campi di Azure DevOps, 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.
Trigger
Controlla elementi di lavoro
Questo modulo di attivazione immediata esegue uno scenario quando un record viene aggiunto, aggiornato o eliminato in Azure DevOps.
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.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Seleziona o aggiungi un webhook per il modulo.
Per ulteriori informazioni sui webhook nei moduli trigger, vedere Trigger istantanei (webhook).
Per informazioni su come creare un webhook, vedere Webhook.
Azioni
Crea un record
Questo modulo di azione crea un nuovo progetto o elemento di lavoro.
Il modulo restituisce l’ID oggetto per il nuovo elemento di lavoro creato oppure l’URL e il codice di stato di un progetto appena creato.
Specificare se si desidera creare un elemento di lavoro o un progetto.
-
Progetto
Compila i campi seguenti:
-
Name: immettere o mappare un nome per il nuovo progetto.
-
Description: immettere o mappare una descrizione per il nuovo progetto.
-
Visibility: specificare se il progetto deve essere pubblico o privato. Per interagire con un progetto privato, gli utenti devono aver effettuato l’accesso alla tua organizzazione e disporre dell’accesso al progetto. I progetti pubblici sono visibili agli utenti che non hanno effettuato l'accesso all'organizzazione.
-
Controllo della versione: specificare se si desidera che il progetto utilizzi Git o Controllo della versione di Team Foundation (TFCV) per il controllo della versione.
-
Processo elemento di lavoro: selezionare il processo di lavoro da utilizzare per il progetto. Le opzioni sono Basic, Scrum, Capability Maturity Model Integration (CMMI) e Agile.
Per ulteriori informazioni sui processi Azure DevOps, vedere Processi predefiniti e modelli di processo nella documentazione di Azure DevOps.
-
-
Elemento di lavoro
Compila i campi seguenti:
-
Project: selezionare il progetto in cui si desidera creare l'elemento di lavoro.
-
Tipo di elemento di lavoro: selezionare il tipo di elemento di lavoro da creare.
-
Altri campi: in questi campi immettere il valore desiderato per l'elemento di lavoro per una determinata proprietà. I campi disponibili dipendono dal tipo di elemento di lavoro.
-
Chiamata API personalizzata
Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all'API Azure DevOps. In questo modo è possibile creare un'automazione del flusso di dati che non può essere eseguita dagli altri moduli Azure DevOps.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Immetti l’URL relativo a cui desideri connetterti per questa chiamata API.
Esempio: {organization}/_apis[/{area}]/{resource}
Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard.
Ad esempio: {"Content-type":"application/json"}
Aggiungi la query per la chiamata API sotto forma di oggetto JSON standard.
Ad esempio: {"name":"something-urgent"}
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.
Scarica un allegato
Questo modulo di azione scarica un allegato.
Il modulo restituisce il contenuto del file dell’allegato.
Collega elementi di lavoro
Questo modulo di azione collega due elementi di lavoro e definisce la relazione tra di essi.
Definire la relazione tra gli elementi di lavoro da collegare.
Per ulteriori informazioni, vedere Guida di riferimento per i tipi di collegamento nella documentazione di Azure DevOps.
Leggi record
Questo modulo di azione legge i dati da un singolo record in Azure DevOps.
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.
Seleziona se desideri leggere un progetto o un elemento di lavoro
-
Project: selezionare il progetto che si desidera leggere.
-
Elemento di lavoro: selezionare il progetto che contiene l'elemento di lavoro che si desidera leggere, quindi selezionare il tipo di elemento di lavoro.
Aggiorna un elemento di lavoro
Questo modulo di azione aggiorna un elemento di lavoro esistente utilizzando il relativo ID.
Il modulo restituisce l’ID dell’elemento di lavoro aggiornato.
Carica un allegato
Questo modulo di azione carica un file e lo allega a un elemento di lavoro.
Il modulo restituisce l’ID dell’allegato e un URL di download per l’allegato.
Ricerche
Elencare elementi di lavoro
Questo modulo di azione recupera tutti gli elementi di lavoro di un tipo specifico in un progetto Azure DevOps.
Il modulo restituisce l’ID dell’elemento di lavoro principale e di tutti i 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.