Moduli Azure DevOps
In uno scenario Adobe Workfront Fusion, puoi automatizzare i flussi di lavoro che utilizzano Azure DevOps, nonché collegarli a più applicazioni e servizi di terze parti.
Per istruzioni sulla creazione di uno scenario, consulta gli articoli in Creare scenari: indice degli articoli.
Per informazioni sui moduli, consulta gli articoli in Moduli: indice degli articoli.
Requisiti di accesso
| table 0-row-2 1-row-2 2-row-2 3-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 |
| Licenza di Adobe Workfront Fusion |
Basato su operazioni: disponibile per le organizzazioni con licenze basate su operazioni Basata su connettore (precedente): Workfront Fusion for Work Automation and Integration |
| 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.
Per informazioni sulle licenze di Adobe Workfront Fusion, consulta Licenze di Adobe Workfront Fusion.
Prerequisiti
Per utilizzare i moduli Azure DevOps, è necessario disporre di un account DevOps Azure.
Informazioni API di Azure DevOps
Il connettore Azure DevOps utilizza quanto segue:
Connettere Azure DevOps a Workfront Fusion connect-azure-devops-to-workfront-fusion
Collegare Azure DevOps a Workfront Fusion utilizzando EntraApp
-
Aggiungi un modulo Azure DevOps allo scenario.
-
Fai clic su Aggiungi accanto al campo Connessione.
-
Nel campo Tipo di connessione, selezionare il tipo di connessione che si desidera utilizzare.
note NOTE Azure DevOps (EntraApp) consente di richiedere tutti gli ambiti per la connessione. -
Compila 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 name (Nome della connessione) Immettere un nome per la connessione che si sta creando. Organizzazione Immettere il nome dell'organizzazione con cui è stata creata l'applicazione Azure DevOps. ID app Immettere l'ID dell'applicazione DevOps a cui ci si connette. Client Secret (Segreto client) Immettere il segreto client per le applicazioni DevOps a cui ci si connette. Richiedi tutti gli ambiti Se si utilizza il tipo di connessione Azure DevOps (EntraApp), abilitare questa opzione per richiedere tutti gli ambiti per la connessione. -
Per immettere un ID app Azure DevOps o un segreto client, fai clic su Mostra impostazioni avanzate e immettili nei campi aperti.
-
Fai clic su Continua per completare la configurazione della connessione e continuare a creare lo scenario.
Connettere Azure DevOps a Workfront Fusion utilizzando un’entità servizio
È possibile creare una connessione che utilizza un’entità servizio (una connessione API dell’applicazione) invece di un account personale. Questa opzione è utile quando si desidera che la connessione venga eseguita come identità di un’applicazione o di un servizio anziché come persona specifica. Questo può essere utile in modo che l’integrazione non si interrompa se, ad esempio, quella persona lascia l’azienda o modifica la propria password.
Questo tipo di connessione è disponibile per tutti i moduli DevOps di Azure.
Prerequisiti per la connessione di Azure DevOps a Workfront Fusion tramite un’entità servizio
Per creare questa connessione, è necessario disporre dei seguenti elementi:
- Accesso Amministratore globale o Amministratore applicazioni in Microsoft Entra ID, per registrare l’app. Se non disponi di questo accesso, chiedi a qualcuno del tuo team IT o di identità di completare quel passaggio al posto tuo.
- Accesso Amministratore raccolta progetti nell’organizzazione Azure DevOps per aggiungere l’entità servizio come membro. Spesso si tratta di una persona diversa da quella che gestisce l’Entra ID di Microsoft.
- Nome dell’organizzazione Azure DevOps. È possibile trovarlo nell’URL di Azure DevOps:
dev.azure.com/<your organization name>.
Creare la registrazione dell’app in Microsoft Entra ID
- Accedere al centro di amministrazione Microsoft Entra.
- Vai a Registrazioni app > Nuova registrazione.
- Assegna all’app un nome chiaro e riconoscibile. Ad esempio,
Workfront Fusion Azure DevOps Integration. - Lascia vuoto URI reindirizzamento. Questa connessione non comporta l’accesso tramite un browser.
- Seleziona Registra.
- Continua con Crea un segreto client.
Creare un segreto client
- Nella tua nuova registrazione all’app, vai a Certificati e segreti.
- Seleziona Nuovo segreto client, aggiungi una descrizione e scegli un periodo di scadenza.
- Seleziona Aggiungi.
- Copia immediatamente il Valore del segreto. Viene visualizzato una sola volta. Se esci prima di copiarlo, devi crearne uno nuovo.
- Continua con Raccogliere i dettagli della connessione.
Raccogliere i dettagli di connessione
-
Nella pagina Panoramica della registrazione dell’app, prendi nota dei seguenti valori. Immetti questi valori durante la creazione della connessione nel modulo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header ID tenant Nella pagina Panoramica, con etichetta ID directory (tenant). ID client Nella pagina Panoramica, etichettato ID applicazione (client). Client Secret (Segreto client) Il valore copiato in Crea un segreto client. Organizzazione Il nome della tua organizzazione Azure DevOps. Ad esempio, se l'URL è dev.azure.com/yourorg, immettereyourorg.note NOTE Puoi saltare l'area Autorizzazioni API della registrazione dell'app. Se aggiungi Azure DevOps, sono disponibili solo autorizzazioni delegate. Le autorizzazioni dell'applicazione sono visualizzate in grigio. Ciò è previsto, perché Azure DevOps non supporta questa modalità di concessione dell’accesso. Nella parte successiva, l’accesso viene concesso direttamente all’interno di Azure DevOps. -
Continua con Aggiungi l’entità servizio alla tua organizzazione Azure DevOps.
Aggiungere l’entità servizio all’organizzazione Azure DevOps
La registrazione dell’app in Microsoft Entra ID ne crea solo l’identità. Non fornisce ancora all’app alcun accesso ai dati Azure DevOps. Questa procedura consente l’accesso.
-
Accedi alla tua organizzazione Azure DevOps all’indirizzo
dev.azure.com/<your organization name>. -
Seleziona Impostazioni organizzazione in basso a sinistra, quindi seleziona Utenti.
-
Selezionare Aggiungi utenti.
-
Nella casella di ricerca, cerca in base al nome visualizzato dell’app, che è il nome che le hai assegnato quando hai registrato l’app. Non eseguire ricerche in base all’ID client.
-
Selezionare un livello di accesso:
- Base è in genere sufficiente per leggere e scrivere elementi di lavoro, bacheche e repository.
- Se il flusso di lavoro deve sfogliare i processi disponibili, ad esempio i modelli Agile, Scrum o personalizzati, come parte della configurazione, aggiungi l’entità servizio al gruppo Amministratori raccolta progetti. Si tratta di un livello di accesso più ampio, quindi concedilo solo se hai bisogno di tale funzionalità.
-
Assegna l’entità servizio al progetto o ai progetti specifici necessari, seguendo le consuete procedure di accesso dell’organizzazione.
-
Seleziona Aggiungi.
-
Continua a Creare la connessione.
Creare la connessione
-
Nella schermata di configurazione della connessione del modulo, selezionare il tipo di connessione Entità servizio.
-
Immetti il codice seguente:
- ID tenant
- ID client
- Segreto client
- Organizzazione
-
Salva la connessione.
Se tutto è configurato correttamente, la connessione viene convalidata correttamente.
Moduli DevOps di Azure e relativi campi
Quando configuri i moduli Azure DevOps, in Workfront Fusion vengono visualizzati i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati altri campi di Azure DevOps, a seconda di 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
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 accede la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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.
Chiamata API personalizzata
Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all’API Azure DevOps. In questo modo puoi 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 seguenti campi.
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 come oggetto JSON standard.
Ad esempio: {"name":"something-urgent"}
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.
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.
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 e gli eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui ha accesso la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.