Jira Software moduli
In uno scenario Adobe Workfront Fusion, è possibile automatizzare i flussi di lavoro che utilizzano Jira Software e collegarlo a più applicazioni e servizi di terze parti.
Se hai bisogno di istruzioni per la creazione di uno scenario, consulta Creare uno scenario in Adobe Workfront Fusion.
Per informazioni sui moduli, vedere Moduli in Adobe Workfront Fusion.
Requisiti di accesso
Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:
Per conoscere il piano, il tipo di licenza o l'accesso disponibili, contattare l'amministratore Workfront.
Per informazioni sulle Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze
Prerequisiti
Per utilizzare i moduli Jira è necessario disporre di un account Jira.
Connetti Jira Software a Workfront Fusion
Il metodo di connessione si basa sull'utilizzo di Jira Cloud o Jira Server.
Connetti Jira Cloud a Workfront Fusion
Connetti Jira Cloud a Workfront Fusion
Per connettere Jira Software a Workfront Fusion, è necessario creare un token API e inserirlo insieme all'URL del servizio e al nome utente nel campo Crea una connessione in Workfront Fusion.
Crea un token API in Jira
-
Vai a https://id.atlassian.com/manage/api-tokens e accedi.
-
Fai clic su Crea token API.
-
Digitare un nome per il token, ad esempio Workfront Fusion.
-
Copia il token utilizzando il pulsante Copia negli Appunti.
note important IMPORTANT Impossibile visualizzare di nuovo il token dopo aver chiuso questa finestra di dialogo. 1. Memorizza il token generato in un luogo sicuro.
-
Continua con Configura il token API Jira in Workfront Fusion.
Configura il token API Jira in Workfront Fusion
-
In Workfront Fusion, aggiungere un modulo Jira a uno scenario per aprire la casella Crea una connessione.
-
Specifica le seguenti informazioni:
- URL servizio: Questo è l'URL di base utilizzato per accedere al tuo account Jira. Esempio:
yourorganization.atlassian.net - Nome utente
- Token API: Questo è il token API creato nella sezione Creare un token API in Jira di questo articolo.
- URL servizio: Questo è l'URL di base utilizzato per accedere al tuo account Jira. Esempio:
-
Fai clic su Continua per creare la connessione e tornare al modulo.
Connetti Jira Server a Workfront Fusion
Per autorizzare una connessione tra Workfront Fusion e Jira Server, sono necessari la chiave consumer, la chiave privata e l'URL del servizio. Potrebbe essere necessario contattare l'amministratore Jira per ottenere queste informazioni.
Genera chiavi pubbliche e private per la connessione Jira
Per acquisire una chiave privata per la connessione Workfront Fusion Jira, è necessario generare chiavi pubbliche e private.
-
Nel terminale, eseguire i seguenti
opensslcomandi.-
openssl genrsa -out jira_privatekey.pem 1024Questo comando genera una chiave privata a 1024 bit.
-
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365Questo comando crea un certificato X509.
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8Questo comando estrae la chiave privata (formato PKCS8) in
jira_privatekey.pcks8
file. -
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pemQuesto comando estrae la chiave pubblica dal certificato al file
jira_publickey.pem.note note NOTE Se si utilizza Windows, potrebbe essere necessario salvare manualmente la chiave pubblica nel file jira_publickey.pem:-
Nel terminale, eseguire il comando seguente:
openssl x509 -pubkey -noout -in jira_publickey.cer -
Copia l'output del terminale (inclusi
-------BEGIN PUBLIC KEY--------e-------END PUBLIC KEY-------- -
Incollare l'output del terminale in un file denominato
jira_publickey.pem.
-
-
Configurare l'app client come consumer in Jira
-
Accedi all'istanza Jira.
-
Nel pannello di navigazione a sinistra, fai clic su JiraImpostazioni
-
Nel campo Immettere l'URL dell'applicazione da collegare, immettere:
code language-none https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1 -
Fai clic su Crea nuovo collegamento. Ignora il messaggio di errore "Nessuna risposta ricevuta dall’URL immesso".
-
Nella finestra Collega applicazioni, immetti i valori nei campi Chiave consumer e Segreto condiviso.
È possibile scegliere i valori per questi campi.
-
Copia i valori dei campi Chiave consumer e Segreto condiviso in un percorso sicuro.
Questi valori saranno necessari più avanti nel processo di configurazione.
-
Compila i campi URL come segue:
table 0-row-2 1-row-2 2-row-2 3-row-2 Campo Descrizione URL token richiesta <Jira base url>/plugins/servlet/oauth/request-tokenURL autorizzazione <Jira base url>/plugins/servlet/oauth/authorizeURL token di accesso <Jira base url>/plugins/servlet/oauth/access-token -
Selezionare la casella di controllo Crea collegamento in ingresso.
-
Fai clic su Continua.
-
Nella finestra Collega applicazioni, compila i campi seguenti:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Chiave consumer Incolla la chiave consumer copiata in un percorso sicuro. Nome consumer Immettere un nome a scelta. Questo nome serve come riferimento. Public Key Incolla la chiave pubblica dal file jira_publickey.pem. -
Fai clic su Continua.
-
Continua a Creare una connessione a Jira Server or Jira Data Center in Workfront Fusion
Crea una connessione a Jira Server o Jira Data Center in Workfront Fusion
-
In qualsiasi modulo di Jira Server in Workfront Fusion, fai clic su Aggiungi accanto al campo connessione.
-
Nel pannello Crea una connessione, compila i campi seguenti:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Nome connessione Immetti un nome per la connessione Chiave consumer Incolla la chiave consumer copiata in una posizione sicura in Configura l'app client come consumer in Jira Private Key Incolla la chiave privata dal file jira_privatekey.pcks8creato in Genera chiavi pubbliche e private per la connessione Jira.Service URL Immetti l'URL dell'istanza Jira. Esempio: yourorganization.atlassian.net -
Fai clic su Continua per creare la connessione e tornare al modulo.
Jira Software moduli e relativi campi
Quando configuri Jira Software moduli, Workfront Fusion visualizza i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati ulteriori campi di Jira Software, 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 all'altro in Adobe Workfront Fusion.
Triggers
Verifica i record
Questo modulo di attivazione avvia uno scenario quando viene aggiunto, aggiornato o eliminato un record.
Azioni
Aggiungi problema a sprint
Questo modulo di azione aggiunge uno o più problemi a uno sprint.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Crea un record
Questo modulo di azione crea un nuovo record in Jira.
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.
Chiamata API personalizzata
Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all'API Jira Software. In questo modo è possibile creare un'automazione del flusso di dati che non può essere eseguita dagli altri moduli Jira Software.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, vedere Metodi di richiesta HTTP in Adobe Workfront Fusion.
<Instance URL>/rest/api/2/Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard.
Ad esempio: {"Content-type":"application/json"}
Workfront Fusion aggiunge le intestazioni di autorizzazione.
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.
Eliminare un record
Questo modulo di azione elimina un record specifico.
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.
Scarica un allegato
Questo modulo di azione scarica un particolare allegato.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Leggi un record
Questo modulo di azione legge i dati da un singolo record in Jira Software.
Specifica l’ID del record.
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.
Aggiorna un record
Questo modulo di azione aggiorna un record esistente, ad esempio un problema o un progetto.
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.
Ricerche
Elenca record
Questo modulo di ricerca recupera tutti gli elementi di un tipo specifico che corrispondono alla query di ricerca
Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Cerca record
Questo modulo di ricerca cerca i record in un oggetto in Jira Software 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.