Documentazione Workfront Guida di Workfront

Configura Adobe Workfront for Jira

Ultimo aggiornamento: 17 luglio 2024

Argomenti:

Creato per:

Utente

È possibile utilizzare Adobe Workfront for Jira per integrare i sistemi Jira e Workfront.

Dopo aver installato il componente aggiuntivo, è possibile definire flussi di lavoro che creano automaticamente Jira problemi alla creazione di Workfront elementi di lavoro. Gli elementi di entrambe le applicazioni vengono collegati e alcune delle relative informazioni vengono aggiornate automaticamente in entrambi i sistemi.

Tutti gli utenti in Workfront e Jira possono beneficiare di questa integrazione. È sufficiente una licenza per il sistema in cui operano maggiormente e non per entrambi i sistemi.

Questo componente aggiuntivo è disponibile per entrambe le versioni Server e OnDemand (o Cloud) del software Jira.

Per un elenco di Jira versioni attualmente supportate da Workfront for Jira, vedere Workfront for Jira in Atlassian Marketplace.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità in questo articolo.

Devi avere i seguenti:

Adobe Workfront piano	Nuovo: Qualsiasi oppure Corrente: Pro o versione successiva
Adobe Workfront licenza	Nuovo: Standard oppure Corrente: Plan
Jira accesso	Accesso amministratore di sistema Importante: è consigliabile creare account di amministratore di sistema separati in Jira e Workfront per dedicarsi a questa integrazione, anziché utilizzare account esistenti che potrebbero essere collegati agli utenti.
Configurazioni del livello di accesso	Devi essere un amministratore Workfront.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, vedere Requisiti di accesso nella documentazione di Workfront.

Prerequisiti

Prima di configurare Workfront for Jira, è necessario:

Installa Workfront for Jira.
Per istruzioni sull'installazione di Workfront for Jira, vedere Installa Adobe Workfront for Jira.

Configura Workfront for Jira

Configurando Workfront for Jira, è possibile:

Definisci i trigger che creeranno Jira elementi quando vengono creati Workfront elementi.
Specificare i campi da sincronizzare tra gli elementi collegati tra Jira e Workfront.

NOTE

Dopo aver configurato Workfront for Jira nell'ambiente Jira, tutti gli utenti Jira visualizzano un pannello destro Workfront su tutti gli elementi Jira. Il pannello contiene informazioni sugli elementi che potrebbero essere collegati da Workfront o specifica che nessun elemento Workfront è collegato a Jira elementi.
Quando si utilizza l'installazione di Jira Server, nel pannello Workfront vengono visualizzati solo i problemi associati ai progetti identificati come attivatori per l'integrazione di Workfront. Per ulteriori informazioni sulla configurazione dei trigger per il flusso di lavoro Workfront to Jira, vedere Configurare i trigger per il collegamento automatico degli elementi tra Jira e Workfront.

Per configurare Workfront for Jira:

Accedere a Jira come amministratore Jira.
Fare clic su Impostazioni nel menu principale di Jira.
Fai clic su Componenti aggiuntivi, quindi fai clic su Gestisci componenti aggiuntivi.
Espandere il componente aggiuntivo Workfront.
Fare clic su Configura.
Seguire le istruzioni per accedere a Workfront.

NOTE
L'utente deve avere un apiKey valido in Workfront per creare una connessione riuscita.

Per continuare la configurazione, è necessario accedere a Workfront come amministratore Workfront.
NOTE
Workfront si connette a Jira utilizzando OAuth 2.0, uno standard utilizzato dalla maggior parte delle integrazioni basate sul Web per l'autenticazione e l'autorizzazione degli utenti.

Quando viene richiesto di immettere il dominio dell'account Workfront, digitarlo in questo formato: yourCompany'sDomain.my.workfront.com. Il dominio della tua azienda è in genere il nome della tua azienda.

L'autenticazione avanzata non è disponibile finché non viene abilitata da un amministratore Workfront per questa integrazione.
In Jira, seleziona la scheda Triggers per configurare la creazione automatica di Jira elementi durante la creazione di nuovi Workfront elementi.

Per ulteriori informazioni sulla configurazione dei trigger per il flusso di lavoro da Workfront a Jira, vedere Configurare i trigger per il collegamento automatico degli elementi tra Jira e Workfront.
Selezionare la scheda Configurazione per configurare la sincronizzazione dei campi tra gli elementi collegati Jira e Workfront.

Per ulteriori informazioni sulla configurazione della sincronizzazione dei campi tra Jira e Workfront, vedere Configurare la sincronizzazione dei campi tra Jira e Workfront Elementi.

NOTE
Dopo aver definito i trigger e la sincronizzazione dei campi tra le due applicazioni, qualsiasi utente Workfront in grado di creare attività o problemi potrebbe potenzialmente attivare la creazione di un elemento in Jira. L'utente può creare un elemento se i criteri dell'elemento creato corrispondono ai trigger in Jira, anche se l'utente non dispone di una licenza di Jira. Inoltre, qualsiasi utente Jira può iniziare immediatamente a lavorare sull'elemento Jira e i relativi aggiornamenti sono visibili in Workfront, senza disporre di una licenza Workfront. Eventuali aggiornamenti in Workfront sono visibili anche sugli elementi Jira.
(Facoltativo) Seleziona la scheda Registro attività per esaminare eventuali errori che potrebbero essersi verificati durante l'integrazione.

Per ulteriori informazioni sul registro attività, vedere Visualizza il Jira registro attività.

Configurare i trigger per il collegamento automatico degli elementi tra Jira e Workfront

In qualità di amministratore di sistema Jira, puoi definire trigger che creerebbero automaticamente problemi in Jira quando un elemento in Workfront soddisfa determinati criteri.

NOTE

La creazione di nuovi problemi in Jira potrebbe richiedere fino a 10 minuti per l'integrazione.

Quando si configura l'attivazione della creazione di Jira elementi durante la creazione di Workfront elementi, tenere presente quanto segue:

L'integrazione è unidirezionale: è possibile attivare solo gli elementi creati in Workfront per la creazione automatica in Jira. Impossibile attivare la creazione automatica in Workfront degli elementi creati in Jira.
Non esiste alcun limite al numero di attivatori che è possibile avere.
Se un elemento creato in Workfront corrisponde a più di uno dei trigger, in Jira verrà creato un solo elemento. L'elemento viene creato in Jira in base al primo trigger (nell'ordine in cui sono stati definiti in Jira). Tutti gli altri trigger vengono ignorati.
È possibile collegare un solo elemento in Workfront a un elemento in Jira. Non puoi collegare un elemento Workfront a più problemi Jira o un problema Jira a più elementi Workfront.

Per configurare i trigger per la creazione automatica di elementi in Jira:

Accedere a Jira come amministratore di sistema.
Fare clic su Impostazioni nel menu principale di Jira.
Fai clic su Componenti aggiuntivi, quindi su Gestisci componenti aggiuntivi.
Espandere il componente aggiuntivo Workfront.
Fare clic su Configura.
Accedere a Workfront come amministratore di sistema.

La scheda Triggers è selezionata per impostazione predefinita in Jira.
Fai clic su Aggiungi trigger per aggiungere un nuovo trigger.
Nel campo Team/utente/ruolo di Workfront, specificare il nome di un team, un utente o una mansione Workfront, quindi fare clic su di esso per selezionarlo quando viene visualizzato nell'elenco.

NOTE
Non è possibile avere più trigger per lo stesso team, utente o ruolo.

Quando un utente crea un'attività o un problema e lo assegna a una di queste entità, viene automaticamente creato un problema in Jira.
Nel campo Jiraprogetto, inizia a digitare il nome di un progetto Jira, quindi fai clic su per selezionarlo quando viene visualizzato nell'elenco.

Quando viene creato il problema Jira, questo viene inserito nel progetto scelto qui.
Seleziona un tipo di Iproblema dal menu a discesa.

Indica il tipo di problema creato in Jira quando vengono soddisfatte le condizioni di questo trigger, in base alle impostazioni per quel progetto specifico in Jira.
Fai clic su Salva.

Con questa configurazione, ogni volta che un utente di Workfront crea un elemento che corrisponde ai trigger specificati, viene creato un nuovo problema in Jira.

Configura la sincronizzazione dei campi tra Jira e Workfront elementi

In qualità di amministratore Jira, puoi definire quali campi devono essere sincronizzati automaticamente sugli elementi collegati tra Workfront e Jira. Alcuni campi possono essere sincronizzati da Workfront all'elemento Jira, mentre altri possono essere sincronizzati da Jira a Workfront.

Per definire i campi da sincronizzare automaticamente sugli elementi collegati tra le due applicazioni:

Accedi a Jira come amministratore Jira.
Fare clic su Impostazioni nel menu principale di Jira.
Fai clic su Componenti aggiuntivi, quindi su Gestisci componenti aggiuntivi.
Espandere il componente aggiuntivo Workfront.
Fare clic su Configura.
Accedere a Workfront come amministratore Workfront.
In Jira, fare clic sulla scheda Configurazione.
Nella sezione Sincronizza da Workfront a Jira, seleziona i campi che desideri aggiornare in Jira quando vengono aggiornati in Workfront.
1. Selezionare una delle seguenti frequenze con cui vengono sincronizzati i campi:
  
  Alla Creazione
  I campi specificati vengono sincronizzati tra gli elementi Workfront collegati e Jira quando l'elemento viene creato in Workfront.
  Always
  I campi specificati vengono sincronizzati tra gli elementi Workfront collegati e Jira quando vengono aggiornati in Workfront.
  Never
  I campi specificati non vengono mai sincronizzati tra gli elementi collegati Workfront e Jira. Nessuna indicazione in Jira che il campo sia stato aggiornato in Workfront.
2. Selezionare una delle opzioni seguenti per sincronizzare i campi da Workfront a Jira:
  Name
  
  Il nome di un'attività o di un problema in Workfront diventa il nome del problema a cui è collegato in Jira.
  
  Nota: quando vengono creati automaticamente nuovi elementi in Jira, il nome Workfront viene sempre aggiornato sull'elemento Jira, indipendentemente dal fatto che questo campo sia abilitato o meno. Quando un elemento Jira è collegato manualmente a un elemento Workfront, il nome dell'elemento Workfront viene aggiornato solo in Jira quando si seleziona Sincronizza sempre questo campo. Per ulteriori informazioni sul collegamento manuale o automatico degli elementi, vedere Collegare gli elementi tra Adobe Workfront e Jira.
  
  Descrizione
  La descrizione di un'attività o di un problema in Workfront diventa la descrizione del problema a cui è collegata in Jira.
  Documenti
  
  I documenti allegati a un'attività o a un problema in Workfront sono allegati anche al problema a cui sono collegati in Jira. Le nuove versioni dei documenti da Workfront vengono aggiunte come documenti separati a Jira e sono aggiunte con _v<numero di versione> per indicare la versione numerata in Workfront.
  
  Se ad esempio il nome di un documento in Workfront è Annuncio principale e si aggiunge una nuova versione in Workfront, la nuova versione verrà trasferita in Jira come nuovo documento con il nome Annuncio principale_v2.
  
  Importante:
  
  Quando si sincronizzano i documenti, tenere presente quanto segue:
  
  I documenti superiori a 5 MB non vengono sincronizzati. Se la sincronizzazione di un documento non riesce perché il documento è troppo grande, nel registro attività viene registrato un errore.
  
  Per ulteriori informazioni sul registro attività, vedere Visualizzare il registro attività Jira.
  
  I documenti collegati ad attività e problemi da server esterni non vengono trasferiti agli elementi Jira. Solo i documenti caricati direttamente sull'attività o sul problema in Workfront vengono trasferiti al problema collegato in Jira.
  
  Per creare una bozza da un documento, è necessario generarla in Workfront.
  
  Per ulteriori informazioni sulla generazione di una bozza, vedere Creare una bozza per un documento esistentein Creare una bozza per un documento.
  Data di completamento Pianificata
  
  La Planned Completion Date (Data di completamento pianificata) di un'attività o di un problema in Workfront diventa la Due Date del problema a cui è collegata in Jira.
  
  Nota: accertati di visualizzare Scadenza su Jira problemi, per sincronizzare questo valore.
Nella sezione Sincronizza da Jira aWorkfront selezionare i campi che si desidera aggiornare in Workfront quando vengono aggiornati in Jira.
1. Selezionare una delle seguenti frequenze con cui vengono sincronizzati i campi:
  
  Always
  I campi specificati vengono sempre sincronizzati tra gli elementi collegati Workfront e Jira quando vengono aggiornati in Jira.
  Never
  
  I campi specificati non vengono mai sincronizzati tra gli elementi collegati Workfront e Jira. Nessuna indicazione in Workfront che il campo sia stato aggiornato in Jira.
  
  Nota: quando selezioni Mai, i campi Workfront possono ancora essere aggiornati manualmente da Jira nel pannello Workfront a sinistra del problema Jira. Questi aggiornamenti vengono visualizzati solo su Workfront elementi in Jira e Workfront e non su Jira elementi.
2. Selezionare questa opzione per sincronizzare i campi seguenti da Jira a Workfront:
  
  Stato
  Lo stato di un problema in Jira diventa lo stato dell'attività o del problema a cui è collegato in Workfront.
  Per ulteriori informazioni sugli stati Workfront, vedere Creare o modificare uno stato.
  assegnatario
  
  Il Assignee di un problema in Jira diventa il Assignee dell'attività o del problema a cui è collegato in Workfront.
  
  Importante: quando si assegna un elemento in Jira a un utente che non dispone di un account Workfront, l'integrazione crea un nuovo utente attivo in Workfront solo quando Crea automaticamente un utente in Workfront se l'utente Jira non dispone di un account Workfront è impostato su Always. Questo utente non occupa una licenza Workfront. Gli utenti attivi possono essere assegnati ad elementi di lavoro in Workfront, ma non possono essere inclusi negli aggiornamenti.
  
  Allegati
  Gli allegati di un problema in Jira sono allegati anche all'attività o al problema a cui è collegato in Workfront.
  Commenti
  
  Un commento su un problema di Jira è pubblicato anche sull'elemento Workfront collegato nell'area Aggiornamenti. Al contrario, un commento pubblicato nell'area Updates per un'attività Workfront o un problema si sincronizza con il flusso di commenti nativo di Jira per il problema collegato.
  
  Impostazione predefinita: Always. Se si seleziona Never qui, è comunque possibile pubblicare commenti manualmente su un elemento collegato in Workfront o in Jira.
Nella sezione OTHER, seleziona i campi aggiuntivi da aggiornare tra gli elementi collegati.
1. Selezionare un'opzione per determinare se i campi specificati Sempre o Mai vengono aggiornati in Jira o Workfront quando vengono modificati.
2. Seleziona uno dei campi e degli aggiornamenti seguenti:
  Copia Workfront dati personalizzati nel pannello di destra in Jira
  
  Visualizza i dati personalizzati Workfront di un elemento nel pannello di destra Workfront.
  
  Nota: le sezioni dei moduli personalizzati vengono visualizzate nel pannello destro Workfront con il livello di accesso dell'amministratore di sistema Workfront.
  
  Copia Workfront Priorità nel pannello di destra in Jira
  Visualizza la priorità Workfront di un elemento nel pannello di destra Workfront.
  Aggiungi un aggiornamento nella scheda Aggiornamenti Workfront sulle modifiche alla data di scadenza in Jira
  Aggiunge un commento nella scheda Update dell'elemento Workfront quando Due Date cambia nell'elemento Jira collegato.
  Crea automaticamente un utente in Workfront se l'utente Jira non dispone di un account Workfront
  
  Esistono i seguenti scenari:
  
  Quando si seleziona Always, l'integrazione consente di creare un nuovo utente di Workfront ogni volta che un utente Jira senza un account Workfront esegue le azioni seguenti su un problema Jira collegato:
  
  È assegnato a un problema Jira
  
  Registra il tempo per un problema Jira
  
  Questo nuovo utente non occupa una licenza Workfront. L'impostazione predefinita è Always. L'utente creato in questo modo in Workfront ha "Jira" aggiunto al proprio nome.
  
  Quando si seleziona Never, si verificano le seguenti condizioni:
  
  Impossibile visualizzare Jira assegnazioni sugli elementi Workfront. In questo caso, solo le assegnazioni effettuate in Workfront vengono visualizzate sugli elementi Workfront.
  
  L'ora registrata per un problema di Jira collegato da un utente senza un account di Workfront non viene trasferita automaticamente all'elemento di Workfront collegato. Puoi comunque registrare l'ora per l'elemento Workfront nel pannello a destra del problema Jira.
Fai clic su Salva.

Ora, ogni volta che un utente aggiorna uno dei campi specificati in questa configurazione su un elemento in Jira o Workfront, viene aggiornato anche l'elemento collegato nell'altra applicazione.

Risoluzione dei problemi

Impossibile creare elementi in Jira a causa di campi trigger contrassegnati come "Impossibile trovare"

Problema

Quando si verifica un errore con l'applicazione Workfront for Jira, Workfront disabilita i trigger per evitare ulteriori complicazioni. Quando questi trigger sono disabilitati, vengono visualizzati come "Impossibile trovare."

Soluzione

Individua l’errore che ha disabilitato i trigger. È possibile trovare l'errore nel Workfront for Jira registro attività.

La causa più comune di questo comportamento è l'errore "Impossibile impostare il campo 'duedate'. Non si trova nella schermata appropriata o è sconosciuta."

Questo errore indica che si sta tentando di sincronizzare "Data di completamento Pianificata" da Workfront a Jira. Per eseguire questa operazione, è necessario assicurarsi che gli oggetti Jira abbiano un campo denominato "Scadenza". Se non dispongono di questo campo, Workfront non è in grado di sincronizzare la data di completamento pianificata da Workfront e disabilita i trigger.

Per risolvere l'errore, eseguire una delle operazioni seguenti:

Chiedere all'amministratore di Jira di aggiornare gli oggetti Jira interessati per assicurarsi che abbiano un campo data di scadenza.
Disattiva la sincronizzazione della data di completamento pianificata di Workfront nella pagina Configurazione di Workfront.

recommendation-more-help