DocumentazioneWorkfrontGuida di Workfront

Jira Software moduli

Last update: Tue Jun 27 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • User

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

Per istruzioni sulla creazione di uno scenario, consulta Creare uno scenario in Adobe Workfront Fusion.

Per informazioni sui moduli, consulta Moduli in Adobe Workfront Fusion.

Requisiti di accesso

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:

Adobe Workfront piano*
Pro o versione successiva
Adobe Workfront licenza*
Plan, Work
Adobe Workfront Fusion licenza**

Fabbisogno di licenza corrente: No Workfront Fusion requisito di licenza.

Oppure

Requisito licenza legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro

Prodotto

Fabbisogno prodotto corrente: se si dispone di Select o Prime Adobe Workfront Pianifica, la tua organizzazione deve acquistare Adobe Workfront Fusion nonché Adobe Workfront per utilizzare la funzionalità descritta in questo articolo. Workfront Fusion è incluso in Ultimate Workfront piano.

Oppure

Requisiti del prodotto legacy: la tua organizzazione deve acquistare Adobe Workfront Fusion nonché Adobe Workfront per utilizzare la funzionalità descritta in questo articolo.

Per conoscere il piano, il tipo di licenza o l'accesso di cui si dispone, contattare Workfront amministratore.

Per informazioni su Adobe Workfront Fusion licenze, consulta Adobe Workfront Fusion licenze

Prerequisiti

Da utilizzare Jira moduli è necessario disporre di Jira account.

Connetti Jira Software a Workfront Fusion

Il metodo di connessione si basa sull'utilizzo o meno di Jira Cloud o Jira Server.

Connetti Jira Cloud a Workfront Fusion

Connetti Jira Cloud a Workfront Fusion

Per connettersi Jira Software a Workfront Fusion, devi creare un token API e inserirlo insieme all’URL del servizio e al nome utente nella Creare una connessione campo in Workfront Fusion.

Creare un token API in Jira

  1. Vai a https://id.atlassian.com/manage/api-tokens e accedi.

  2. Clic Crea token API.

  3. Digita un nome per il token, ad esempio Workfront Fusion.

  4. Copia il token utilizzando Copia negli Appunti pulsante.

    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.

  5. Continua con Configurare Jira Token API in Workfront Fusion.

Configurare Jira Token API in Workfront Fusion

  1. In entrata Workfront Fusion, aggiungi un Jira modulo a uno scenario per aprire Creare una connessione casella.

  2. Specifica le seguenti informazioni:

  3. Clic 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 il Jira per queste informazioni.

Genera chiavi pubbliche e private per il tuo Jira connessione

Per acquisire una chiave privata per il Workfront Fusion Jira connessione, devi generare chiavi pubbliche e private.

  1. Nel terminale, eseguire le operazioni 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 jira_privatekey.pcks8
      file.

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

      Questo comando estrae la chiave pubblica dal certificato al jira_publickey.pem file.

      note note
      NOTE
      Se utilizzi Windows, potrebbe essere necessario salvare la chiave pubblica nel jira_publickey.pem file manualmente:

      1. Nel terminale, eseguire il comando seguente:

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. Copiare l'uscita del terminale (compresa -------BEGIN PUBLIC KEY-------- e -------END PUBLIC KEY--------

      3. Incolla l’output del terminale in un file denominato jira_publickey.pem.

  2. Continua con Configurare l’app client come consumatore in Jira

Configurare l’app client come consumatore in Jira

  1. Accedi al tuo Jira dell'istanza.

  2. Nel pannello di navigazione a sinistra, fai clic su JiraImpostazioni > Applicazioni> Collegamenti applicazione.

  3. In Immettere l'URL dell'applicazione da collegare campo, immetti

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

  4. Clic Crea nuovo collegamento. Ignora il messaggio di errore "Nessuna risposta ricevuta dall’URL immesso".

  5. In Collegare le applicazioni , immettere i valori nella finestra Chiave consumer e Segreto condiviso campi.

    È possibile scegliere i valori per questi campi.

  6. Copia i valori di Chiave consumer e Segreto condiviso campi in una posizione sicura.

    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
    URL token di richiesta <Jira base url>/plugins/servlet/oauth/request-token
    URL autorizzazione <Jira base url>/plugins/servlet/oauth/authorize
    URL token di accesso <Jira base url>/plugins/servlet/oauth/access-token

  8. Seleziona la Crea collegamento in ingresso casella di controllo.

  9. Clic Continua.

  10. In Collegare le applicazioni , compilare 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 tuo jira_publickey.pem file.

  11. Clic Continua.

  12. Continua con Creare una connessione a Jira Server o Jira Data Center in Workfront Fusion

Creare una connessione a Jira Server o Jira Data Center in Workfront Fusion

NOTE
Utilizza il Jira Server app a cui connettersi Jira Server o Jira Data Center.
  1. In qualsiasi Jira Server modulo in Workfront Fusion, fai clic su Aggiungi accanto al connessione campo.
  2. In Creare una connessione , compilare i campi seguenti:
Nome connessione
Immetti un nome per la connessione
Chiave consumer
Incolla la chiave del consumatore che hai copiato in una posizione sicura in Configurare l’app client come consumatore in Jira
Private Key
Incolla la chiave privata da jira_privatekey.pcks8 file creato in Genera chiavi pubbliche e private per il tuo Jira connessione.
Service URL
Immetti il Jira URL dell’istanza.
  1. Clic Continua per creare la connessione e tornare al modulo.

Jira Software moduli e relativi campi

Quando si configura Jira Software moduli, Workfront Fusion visualizza i campi elencati di seguito. Oltre a questi, ulteriori Jira Software I campi potrebbero essere visualizzati in base a 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, consulta Mappare le informazioni da un modulo all’altro in Adobe Workfront Fusion.

Triggers

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.

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 Jira Software account a Workfront Fusion, vedi Connetti Jira Software a Workfront Fusion in questo articolo.

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

    • Comment
    • Issue
    • Progetto
    • Sprint

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.

Connection
Per istruzioni sulla connessione Jira Software account a Workfront Fusion, vedi Connetti Jira Software a Workfront Fusion in questo articolo.
Sprint ID
Immetti o mappa l’ID Sprint dello sprint a cui desideri aggiungere un problema.
ID problema o chiavi
Aggiungi un ID problema o una chiave per ogni problema che desideri aggiungere allo sprint.

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.

Connection
Per istruzioni sulla connessione Jira Software account a Workfront Fusion, vedi Connetti Jira Software a Workfront Fusion in questo articolo.
Tipo di record

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

  • Attachment
  • Comment
  • Issue
  • Progetto
  • Sprint
  • Worklog

Chiamata API personalizzata

Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata al Jira Software API. In questo modo, puoi creare un’automazione del flusso di dati che non può essere eseguita dall’altro Jira Software moduli.

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

td>

Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, consulta Metodi di richiesta HTTP in Adobe Workfront Fusion.

Connection
Per istruzioni sulla connessione Jira Software account a Workfront Fusion, vedi Connetti 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.

Stringa Di Query

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 quali if nel JSON, inserisci 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.

Connection
Per istruzioni sulla connessione Jira Software account a Workfront Fusion, vedi Connetti Jira Software a Workfront Fusion in questo articolo.
Tipo di record

Selezionare il tipo di record da eliminare dal modulo.

  • Attachment
  • Comment
  • Issue
  • Progetto
  • Sprint
ID o chiave
Immetti o mappa l’ID o la chiave del record da eliminare.

Scaricare un allegato

Questo modulo di azione scarica un particolare allegato.

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

Connection
Per istruzioni sulla connessione Jira Software account a Workfront Fusion, vedi Connetti Jira Software 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 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 Jira Software account a Workfront Fusion, vedi Connetti Jira Software a Workfront Fusion in questo articolo.
Tipo di record

Seleziona il tipo di Jira record che si desidera leggere nel modulo.

  • Attachment
  • Issue
  • Progetto
  • Sprint
  • Utente
Output
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".
ID
Inserisci o mappa l’univoco Jira Software ID del record che desideri che il modulo legga.

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

Connection
Per istruzioni sulla connessione Jira Software account a Workfront Fusion, vedi Connetti Jira Software 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.

  • Comment
  • Issue
  • Progetto
  • Sprint
  • Problema di transizione
ID o chiave
Immetti o mappa l’ID o la chiave del record da aggiornare.

Ricerche

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

Connection
Per istruzioni sulla connessione Jira Software account a Workfront Fusion, vedi Connetti Jira Software a Workfront Fusion in questo articolo.
Tipo di record

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
  • Progetto
  • Problema Sprint
  • Worklog
Max Results
Immettere o mappare il numero massimo di record che il modulo deve recuperare durante ogni ciclo di esecuzione dello scenario.

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.

Connection
Per istruzioni sulla connessione Jira Software account a Workfront Fusion, vedi Connetti Jira Software 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.

  • Issues

  • Issues by JQL (Jira Query Language)

    Per ulteriori informazioni su JQL, vedi JQL sul sito di aiuto di Atlassian.

  • Progetto

  • Progetto per problema

  • Utente

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43