Jira Software moduli

Last update: Thu Jan 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

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.

Queste istruzioni sono valide per i moduli Jira Cloud e Jira 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	Nuovo: 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 Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze.

Prerequisiti

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

Informazioni API Jira

Il connettore Jira utilizza quanto segue:

Jira Cloud

Server Jira

apiVersion

apiVersionAgile

1,0

Tag API

1.7.29

1.0.19

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 Server 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 Create a connection in Workfront Fusion.

Crea un token API in Jira

Crea un token API in Jira.

Per istruzioni, consigliamo di cercare "Crea un token API" nella documentazione di Jira.

Dopo aver creato il token, copialo in un percorso sicuro.

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 qualsiasi modulo di Jira Cloud in Workfront Fusion, fai clic su Add accanto al campo connection.
Specifica le seguenti informazioni:
- Ambiente
- Tipo
- Service URL: Questo è l'URL di base che utilizzi per accedere al tuo account Jira. Esempio: yourorganization.atlassian.net
- Username
- API token: Questo è il token API creato nella sezione Creare un token API in Jira di questo articolo.
Fare clic su Continue 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
Configura l'app client come consumer in Jira
Crea una connessione al server Jira o al centro dati Jira in Workfront Fusion

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 openssl comandi.

openssl genrsa -out jira_privatekey.pem 1024

Questo comando genera una chiave privata a 1024 bit.
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365

Questo comando crea un certificato X509.
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8

Questo comando estrae la chiave privata (formato PKCS8) nel file jira_privatekey.pcks8.

openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem

Questo 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`.

Continua a Configurare l'app client come consumer in Jira

Configurare l'app client come consumer in Jira

Accedi all'istanza Jira.
Nel pannello di navigazione a sinistra, fai clic su Jira Settings > Applications> Application links.

Nel campo Enter the URL of the application you want to link, immetti

code language-none
`https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1`

Fare clic su Create new link. Ignora il messaggio di errore "Nessuna risposta ricevuta dall’URL immesso".
Nella finestra Link applications, immettere i valori nei campi Consumer key e Shared secret.

È possibile scegliere i valori per questi campi.
Copiare i valori dei campi Consumer key e Shared secret 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
Request Token URL	`<Jira base url>/plugins/servlet/oauth/request-token`
Authorization URL	`<Jira base url>/plugins/servlet/oauth/authorize`
Access Token URL	`<Jira base url>/plugins/servlet/oauth/access-token`

Selezionare la casella di controllo Create incoming link.
Fare clic su Continue.

Nella finestra Link applications, compila i campi seguenti:

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Consumer Key	Incolla la chiave consumer copiata in un percorso sicuro.
Consumer name	Immettere un nome a scelta. Questo nome serve come riferimento.
Public key	Incolla la chiave pubblica dal file `jira_publickey.pem`.

Fare clic su Continue.
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

NOTE

Utilizzare l'app Jira Server per connettersi a Jira Server o Jira Data Center.

In qualsiasi modulo di Jira Server in Workfront Fusion, fai clic su Add accanto al campo connection.

Nel pannello Create a connection, compila i campi seguenti:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
Connection name	Immetti un nome per la connessione
Environment	Seleziona se utilizzi un ambiente di produzione o non di produzione.
Type	Seleziona se utilizzi un account di servizio o un account personale.
Consumer Key	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.pcks8` creato in Genera chiavi pubbliche e private per la connessione Jira.
Service URL	Immetti l'URL dell'istanza Jira. Esempio: `yourorganization.atlassian.net`

Fare clic su Continue 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 a un altro.

Attiva/Disattiva mappa

Trigger
Azioni
Ricerche

Trigger

Watch for records

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.

Per aggiungere un nuovo webhook:

Clic Add
Immettere un nome per il webhook.
Seleziona la connessione da utilizzare per il webhook.

Per istruzioni sulla connessione dell'account Jira Software a Workfront Fusion, vedere Connessione di Jira Software a Workfront Fusion in questo articolo.
Selezionare il tipo di record che si desidera che venga controllato dal software:
- Comment
- Issue
- Project
- Sprint

Add issue to sprint

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

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

Connection

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

Sprint ID

Immetti o mappa l’ID Sprint dello sprint a cui desideri aggiungere un problema.

Issue ID or Keys

Per ogni problema o chiave che desideri visualizzare, fai clic su Add item e immetti l'ID o la chiave del problema. In un modulo è possibile immettere fino a 50 caratteri.

Create a 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.

Connection

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

Record Type

Selezionare il tipo di record che si desidera venga creato dal modulo, quindi compilare gli altri campi specifici del tipo di record visualizzato nel modulo.

Attachment
Comment
Issue
Project
Sprint
Worklog

Custom API Call

Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all'API Jira Software. Utilizzare questo modulo per 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.

Connection

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

URL

Inserisci un percorso relativo a<Instance URL>/rest/api/2/

Method

Headers

Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard.

Ad esempio: {"Content-type":"application/json"}

Workfront Fusion aggiunge le intestazioni di autorizzazione.

Query String

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

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

Body

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.

Delete a record

Questo modulo di azione elimina il record specificato.

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.

Connection

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

Record Type

Selezionare il tipo di record da eliminare dal modulo.

Attachment
Comment
Issue
Project
Sprint

ID or Key

Immetti o mappa l’ID o la chiave del record da eliminare.

Download an attachment

Questo modulo di azione scarica un particolare allegato.

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

Connection

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

Immetti o mappa l’ID dell’allegato da scaricare.

Read a record

Questo modulo di azione legge i dati da un singolo record in Jira Software.

Specifica l’ID del record.

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

Connection

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

Record Type

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

Attachment
Issue
Project
Sprint
User

Outputs

Selezionare gli output che si desidera ricevere. Le opzioni di output sono disponibili in base al tipo di record selezionato nel campo "Record Type".

Immettere o mappare l'ID Jira Software univoco del record che si desidera venga letto dal modulo.

Update a record

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

Specifica l’ID del record.

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

Connection

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

Record Type

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.

Comment
Issue
Project
Sprint
Transition issue

ID or Key

Immetti o mappa l’ID o la chiave del record da aggiornare, quindi compila gli altri campi specifici di quel tipo di record che vengono visualizzati nel modulo.

Ricerche

List records
Search for records

List records

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.

Connection

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

Record Type

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

Comment
Issue
Project
Sprint issue
Worklog

Max Results

Immettere o mappare il numero massimo di record che il modulo deve recuperare durante ogni ciclo di esecuzione dello scenario.

Search for records

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.

Connection

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

Record Type

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.

Issues
Issues by JQL (Jira Query Lanuguage)

Per ulteriori informazioni su JQL, vedere JQL nella Guida di Atlassian.
Project
Project by issue
User

recommendation-more-help

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3