Moduli Jira

NOTE
Queste istruzioni si applicano alla nuova versione del connettore Jira, semplicemente etichettato Jira. Per istruzioni sui connettori legacy Jira Cloud e Jira Server, consulta Moduli software Jira.

In uno scenario Adobe Workfront Fusion, puoi automatizzare i flussi di lavoro che utilizzano Jira e collegarlo a più applicazioni e servizi di terze parti.

Il connettore Jira può essere utilizzato sia per Jira Cloud che per Jira Data Server.

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:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
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

Novità:

  • Seleziona o crea un pacchetto Prime Workfront: la tua organizzazione deve acquistare Adobe Workfront Fusion.
  • Pacchetto Ultimate Workfront: è incluso Workfront Fusion.

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 licenze di Adobe Workfront Fusion, vedere Licenze di Adobe Workfront Fusion.

Prerequisiti

Per utilizzare i moduli Jira è necessario disporre di un account Jira.

Collegare Jira a Workfront Fusion

Crea le credenziali necessarie

Per creare connessioni a Jira, sono necessari i seguenti elementi:

Tipo di connessione
Tipo di account
Credenziali richieste
OAuth 2
Qualsiasi
ID client e segreto client
Base
Jira Cloud
Token API Jira
Base
Datacenter Jira
Token di accesso personale Jira (PAT)

Per istruzioni sulla creazione di uno di questi, consulta la documentazione di Jira.

Quando crei queste credenziali, avrai bisogno delle seguenti informazioni:

  • Per OAuth 2:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Datacenter di Fusion Reindirizza URL
    STATI UNITI https://app.workfrontfusion.com/oauth/cb/workfront-jira2
    UE https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira2
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira2
  • Per i token di accesso personali (PAT):

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Datacenter di Fusion Reindirizza URL
    STATI UNITI https://app.workfrontfusion.com/oauth/cb/workfront-jira
    UE https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira
    note important
    IMPORTANT
    Per utilizzare un PAT, è necessario abilitare quanto segue nei file jira/bin/WEB-INF/classes, nel file jira-config.properties:
    • jira.rest.auth.allow.basic = true
    • jira.rest.csrf.disabled = true
    Se il file non esiste, è necessario crearlo.

Creare la connessione a Jira in Workfront Fusion

Per creare la connessione in Workfront Fusion:

  1. In qualsiasi modulo Jira, fai clic su Aggiungi accanto al campo Connessione.

  2. Configura i campi seguenti:

    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 8-row-2 9-row-2 layout-auto html-authored no-header
    Tipo di connessione Seleziona se stai creando una connessione di base o una connessione OAuth 2.
    Nome connessione Immettere un nome per la nuova connessione.
    URL servizio Immetti l’URL dell’istanza Jira. Questo è l’URL che utilizzi per accedere a Jira.
    Tipo di account Jira Seleziona se ti stai connettendo a Jira Cloud o Jira Data Center.
    ID client Se stai creando una connessione OAuth 2, immetti l’ID client Jira
    Segreto client Se stai creando una connessione OAuth 2, inserisci il segreto client Jira
    E-mail Se stai creando una connessione di base a Jira Cloud, inserisci il tuo indirizzo e-mail.
    Token API Se stai creando una connessione di base a Jira Cloud, immetti il token API.
    Token di accesso personale Se stai creando una connessione di base al centro dati Jira, immetti il token di accesso personale.
    Versione API Seleziona la versione API Jira a cui vuoi connettere la connessione.
  3. Fai clic su Continua per creare la connessione e tornare al modulo.

Moduli Jira e relativi campi

Quando configuri i moduli Jira, Workfront Fusion visualizza i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati campi Jira aggiuntivi, a seconda di fattori come 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.

Attiva/Disattiva mappa

Trigger

Controlla i record

Questo modulo di attivazione avvia uno scenario quando viene aggiunto, aggiornato o eliminato un record.

Webhook

Selezionare il webhook che si desidera utilizzare per controllare i record o crearne uno nuovo.

Per creare un nuovo webhook:

  1. Fai clic su Aggiungi

  2. Immettere un nome per il webhook.

  3. Seleziona la connessione da utilizzare per il webhook.

    Per istruzioni sulla connessione dell'account Jira a Workfront Fusion, vedere Connessione di Jira a Workfront Fusion in questo articolo.

  4. Selezionare il tipo di record che si desidera che venga controllato dal software:

    • Problema
    • Commento
    • Registro di lavoro
    • Progetto
    • Sprint
    • Allegato
  5. Seleziona uno o più tipi di evento che attiveranno questo scenario.

  6. Immetti un filtro Jira Query Language per questo modulo.

    Per ulteriori informazioni su JQL, vedere JQL nella Guida di Atlassian.

  7. Fai clic su Salva per salvare il webhook.

Azioni

Aggiungi problema a sprint

Questo modulo di azione aggiunge uno o più problemi a uno sprint.

Connessione
Per istruzioni sulla connessione dell'account Jira a Workfront Fusion, vedere Connessione di Jira a Workfront Fusion in questo articolo.
ID Sprint
Immetti o mappa l’ID Sprint dello sprint a cui desideri aggiungere un problema.
ID problema o chiavi
Per ogni problema o chiave che si desidera aggiungere allo sprint, fare clic su Aggiungi elemento e immettere l'ID o la chiave del problema. In un modulo è possibile immettere fino a 50 caratteri.

Crea un record

Questo modulo di azione crea un nuovo record in Jira.

Connessione
Per istruzioni sulla connessione dell'account Jira a Workfront Fusion, vedere Connessione di Jira a Workfront Fusion in questo articolo.
Tipo di record

Selezionare il tipo di record che si desidera venga creato dal modulo.

  • Allegato
  • Commento
  • Problema
  • Progetto
  • Sprint
  • Registro di lavoro
  • Utente
  • Bacheca
  • Categoria
  • Filtro
Altri campi
Compila gli altri campi. I campi sono disponibili a seconda del tipo di record selezionato.

Chiamata API personalizzata

Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all’API Jira.

Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, vedere Metodi di richiesta HTTP.

Connessione
Per istruzioni sulla connessione dell'account Jira a Workfront Fusion, vedere Connessione di Jira a Workfront Fusion in questo articolo.
URL
Inserisci un percorso relativo a<Instance URL>/rest/api/2/
Metodo
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

Aggiungi la query per la chiamata API sotto forma di oggetto JSON standard.

Ad esempio: {"name":"something-urgent"}

Corpo

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.

Eliminare un record

Questo modulo di azione elimina il record specificato.

Connessione
Per istruzioni sulla connessione dell'account Jira a Workfront Fusion, vedere Connessione di Jira a Workfront Fusion in questo articolo.
Tipo di record

Selezionare il tipo di record da eliminare dal modulo.

  • Commento
  • Problema
  • Progetto
  • Sprint
  • Registro di lavoro
  • Allegato
  • Bacheca
  • Categoria
  • Filtro
(Tipo di record)ID
Immetti o mappa l’ID o la chiave del record da eliminare.

Scaricare un allegato

Questo modulo di azione scarica l’allegato specificato.

Connessione
Per istruzioni sulla connessione dell'account Jira a Workfront Fusion, vedere Connessione di Jira a Workfront Fusion in questo articolo.
ID
Immetti o mappa l’ID dell’allegato da scaricare.

Leggi un record

Questo modulo di azione legge i dati dal record specificato in Jira.

Connessione
Per istruzioni sulla connessione dell'account Jira a Workfront Fusion, vedere Connessione di Jira a Workfront Fusion in questo articolo.
Tipo di record

Seleziona il tipo di record Jira che desideri che il modulo legga.

  • Allegato
  • Commento
  • Problema
  • Progetto
  • Sprint
  • Registro di lavoro
  • Utente
  • Bacheca
  • Categoria
  • Filtro
Uscite
Selezionare gli output che si desidera ricevere. Le opzioni di output sono disponibili in base al tipo di record selezionato nel campo "Tipo di record".
(Tipo di record) ID
Immetti o mappa l’ID Jira univoco del record che desideri che il modulo legga.

Aggiornare un record

Questo modulo aggiorna un record esistente, ad esempio un problema o un progetto.

Connessione
Per istruzioni sulla connessione dell'account Jira a Workfront Fusion, vedere Connessione di Jira a Workfront Fusion in questo articolo.
Tipo di record

Selezionare il tipo di record da aggiornare nel modulo. Quando si seleziona un tipo di record, nel modulo vengono visualizzati altri campi specifici per tale tipo di record.

  • Commento
  • Problema
  • Progetto
  • Sprint
  • Problema di transizione
  • Categoria
  • Filtro
ID o chiave
Immetti o mappa l’ID o la chiave del record da aggiornare.
Altri campi
Compila gli altri campi. I campi sono disponibili a seconda del tipo di record selezionato.

Ricerche

Cerca record

Questo modulo di ricerca cerca i record in un oggetto in Jira che corrispondono alla query di ricerca specificata.

Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Connessione
Per istruzioni sulla connessione dell'account Jira a Workfront Fusion, vedere Connessione di Jira a Workfront Fusion in questo articolo.
Tipo di record

Selezionare il tipo di record da cercare nel modulo. Quando si seleziona un tipo di record, nel modulo vengono visualizzati altri campi specifici per tale tipo di record.

  • Problema
  • Progetto
  • Utente
  • Sprint
  • Bacheca
  • Registro di lavoro
  • Commento
  • Problema di transizione
  • Categoria
Risultati Max
Immettere o mappare il numero massimo di record che il modulo deve recuperare durante ogni ciclo di esecuzione dello scenario.
Offset
Immetti o mappa l’ID del primo elemento per il quale desideri recuperare i dettagli. Questo è un modo per impaginare i record. Se si immette l'elemento 5000 come offset, il modulo restituirà gli elementi 5000-9999.
Altri campi
Compila gli altri campi. I campi sono disponibili a seconda del tipo di record selezionato.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3