Moduli Jira Software
In uno scenario Adobe Workfront Fusion, puoi automatizzare i flussi di lavoro che utilizzano Jira Software, nonché collegarli 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, consulta gli articoli in Creare scenari: indice degli articoli.
Per informazioni sui moduli, consulta gli articoli in Moduli: indice degli articoli.
Requisiti 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 pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront. Workfront Ultimate Pacchetti Workfront Prime e Select, con un ulteriore acquisto di Workfront Fusion. |
| Licenze Adobe Workfront |
Standard Work o successiva |
| Licenza di Adobe Workfront Fusion |
Basata sulle operazioni: nessun requisito di licenza Workfront Fusion Basata su connettore (precedente): Workfront Fusion for Work Automation and Integration |
| Prodotto | Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion. |
Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione.
Per informazioni sulle licenze di Adobe Workfront Fusion, consulta Licenze di Adobe Workfront Fusion.
Prerequisiti
Per utilizzare i moduli Jira è necessario disporre di un account Jira.
Informazioni API Jira
Il connettore Jira utilizza quanto segue:
Connettere Jira Software a Workfront Fusion
Il metodo di connessione si basa sull'utilizzo di Jira Cloud o Jira Server.
Connettere Jira Cloud a Workfront Fusion
Connettere 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
-
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 Configurare il token API Jira in Workfront Fusion.
Configura il token API Jira in Workfront Fusion
-
In qualsiasi modulo Jira Cloud di Workfront Fusion, fai clic su Aggiungi accanto al campo connessione.
-
Specifica le seguenti informazioni:
- Ambiente
- Tipo
- 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.
-
Fai clic su Continua per creare la connessione e tornare al modulo.
Connettere 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. Questa operazione viene eseguita tramite il terminale del computer. È possibile individuare il terminale ricercando il terminale nel menu Start o nella barra di ricerca del computer (non nella barra di ricerca del browser).
-
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) nel file
jira_privatekey.pcks8. -
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 Continue (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 Continue (Continua).
-
Continua con Crea una connessione a Jira Server o Jira Data Center in Workfront Fusion
Crea una connessione a Jira Server o Jira Data Center in Workfront Fusion
-
In qualsiasi modulo Jira Server di 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 4-row-2 5-row-2 layout-auto html-authored no-header Connection name (Nome della connessione) Specifica un nome per la connessione. Ambiente Seleziona se utilizzi un ambiente di produzione o non di produzione. Tipo Seleziona se utilizzi un account di servizio o un account personale. 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.
Moduli Jira Software e relativi campi
Quando configuri i moduli Jira Software, in Workfront Fusion vengono visualizzati i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati altri campi di Jira Software, a seconda di fattori quali il tuo livello di accesso nell’app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.
Se visualizzi il pulsante Map (Mappa) sopra un campo o una funzione, puoi utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, consulta Mappare le informazioni da un modulo a un altro.
Trigger
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 seguenti campi.
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 accede la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Chiamata API personalizzata
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 seguenti campi.
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, consulta Metodi di richiesta HTTP.
<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 automaticamente le intestazioni di autorizzazione.
Aggiungi la query per la chiamata API come oggetto JSON standard.
Ad esempio: {"name":"something-urgent"}
Aggiungi il contenuto del corpo della chiamata API sotto forma di oggetto JSON standard.
Nota:
Quando utilizzi istruzioni condizionali come if in JSON, racchiudi l’istruzione condizionale tra virgolette.
Eliminare un record
Questo modulo di azione elimina il record specificato.
Specifica l’ID del record.
Il modulo restituisce l’ID del record e gli eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui ha accesso la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Scarica un allegato
Questo modulo di azione scarica un particolare allegato.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 accede la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 e gli eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui ha accesso la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Ricerche
[410] The requested API has been removed. Please migrate to the /rest/api/3/search/jql API. A full migration guideline is available at https://developer.atlassian.com/changelog/#CHANGE-2046
-
È interessato solo il modulo di ricerca. Al momento, altri endpoint API Jira utilizzati dal connettore Fusion non sono interessati da questa rimozione.
-
Il rollout geografico può causare incongruenze. Atlassian sta implementando questa modifica a livello regionale, il che significa che alcune istanze di Jira Cloud potrebbero ancora supportare temporaneamente gli endpoint precedenti. Questo può causare comportamenti non coerenti tra gli ambienti.
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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.