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.

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
2
2
apiVersionAgile
1,0
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 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

  1. Crea un token API in Jira.

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

  2. 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.

  3. Continua con Configura il token API Jira in Workfront Fusion.

Configura il token API Jira in Workfront Fusion

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

  2. 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.
  3. 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

Per acquisire una chiave privata per la connessione Workfront Fusion Jira, è necessario generare chiavi pubbliche e private.

  1. 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:
      1. Nel terminale, eseguire il comando seguente:

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. Copia l'output del terminale, inclusi -------BEGIN PUBLIC KEY-------- e -------END PUBLIC KEY--------.

      3. Incollare l'output del terminale in un file denominato jira_publickey.pem.

  2. Continua a Configurare l'app client come consumer in Jira

Configurare l'app client come consumer in Jira

  1. Accedi all'istanza Jira.

  2. Nel pannello di navigazione a sinistra, fai clic su Jira Settings Icona impostazioni Jira > Applications> Application links.

  3. 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
    
  4. Fare clic su Create new link. Ignora il messaggio di errore "Nessuna risposta ricevuta dall’URL immesso".

  5. Nella finestra Link applications, immettere i valori nei campi Consumer key e Shared secret.

    È possibile scegliere i valori per questi campi.

  6. Copiare i valori dei campi Consumer key e Shared secret in un percorso sicuro.

    Questi valori saranno necessari più avanti nel processo di configurazione.

  7. 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
  8. Selezionare la casella di controllo Create incoming link.

  9. Fare clic su Continue.

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

  12. 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.
  1. In qualsiasi modulo di Jira Server in Workfront Fusion, fai clic su Add accanto al campo connection.

  2. 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
  3. 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

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:

  1. Clic Add

  2. Immettere un nome per il webhook.

  3. 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.

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

    • Comment
    • Issue
    • Project
    • Sprint

Azioni

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.
ID
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.

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 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".
ID
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.

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 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

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