Amministrazione e configurazione del Connettore Jira di Smartsheet

Il Connettore Jira di Smartsheet è un componente aggiuntivo Premium. Contatta il team di vendita Smartsheet per i prezzi.

Il Connettore Jira di Smartsheet sincronizza i dati tra Smartsheet e una o più istanze Jira. Usalo per creare flussi di lavoro che collegano gli issue Jira a righe, colonne e celle in Smartsheet.

Se il Connettore Jira di Smartsheet è già incluso nel tuo piano, accedi al Connettore Jira di Smartsheet per iniziare.

Accedi al Connettore Jira di Smartsheet

Terminologia e tipi di autorizzazione

Due termini definiscono la struttura del Connettore Jira:

• Connessione: il collegamento tra Smartsheet e un’istanza Jira specifica.
• Flusso di lavoro: il collegamento all’interno del Connettore Jira che collega gli elementi Jira a un foglio Smartsheet.

Tre tipi di autorizzazioni controllano l’accesso al Connettore Jira:

• Amministratore di sistema Smartsheet: gestisce gli Amministratori Connettore Jira e gli Utenti Connettore Jira da Smartsheet. Gli Amministratori di sistema possono anche abilitare un’impostazione per limitare l’accesso al Connettore.
• Amministratore Connettore Jira: stabilisce la connessione tra un’istanza Jira e il Connettore Jira di Smartsheet.
• Utente Connettore Jira: crea flussi di lavoro per sincronizzare le informazioni tra Smartsheet e Jira.

Funzionalità per tipo di autorizzazione

La tabella seguente mostra quali autorizzazioni sono necessarie per completare attività specifiche utilizzando il Connettore Jira.

* Gli Amministratori di sistema Smartsheet e gli Amministratori del Connettore possono creare e modificare flussi di lavoro quando la funzione di limitazione dell’accesso è abilitata. Se l’Amministratore di sistema attiva l’impostazione Restrict Users (Limita utenti) nel Connettore Jira, devi avere anche il ruolo Utente Jira in Smartsheet. Consulta Limitare l’accesso al Connettore Jira di Smartsheet.

Prima di iniziare

Usa un account condiviso per la configurazione

Configura la connessione utilizzando un account e-mail condiviso con licenza (ad esempio, smartsheet-jira@yourdomain.com) sia per Smartsheet che per Jira. Non è possibile trasferire la proprietà della connessione. Se la persona che ha creato la connessione lascia l’organizzazione, devi ricreare la connessione da zero. Un account condiviso evita questa situazione.

Configura il firewall

Configura le impostazioni del firewall prima di iniziare la configurazione della connessione.

Autorizzazioni necessarie

In Jira:

• Amministratore di sistema Jira (Amministratore di prodotto o Amministratore di organizzazione)

In Smartsheet:

• Membro (modello utente) o Utente con licenza (modello legacy) 
• Ruolo di Amministratore di sistema Smartsheet, ruolo di Amministratore Connettore Jira di Smartsheet o entrambi

È richiesto solo uno dei ruoli Smartsheet, ma Smartsheet consiglia di possedere entrambi.

Poiché il Connettore Jira esegue flussi di lavoro automatici, deve disporre delle credenziali dell’Amministratore di sistema Jira per creare e configurare i webhook tramite l’API REST Jira. Queste credenziali vengono utilizzate solo per la configurazione dei webhook.

Mantieni attivo l’account di configurazione. L’account utilizzato per la connessione deve rimanere attivo e mantenere i diritti di Amministratore sia in Jira che in Smartsheet. Se l’utente perde lo stato di Amministratore, la connessione si interrompe con l’errore: Missing user credentials for this endpoint (Credenziali utente mancanti per questo endpoint). Il ripristino delle autorizzazioni di Amministratore consente di riprendere la sincronizzazione. Se le credenziali di Amministratore di Jira vengono rimosse completamente, devi ricreare il collegamento dell’applicazione perché i token cambiano.

Configura la connessione

Il Connettore Jira di Smartsheet è compatibile con Jira Cloud e Jira Data Center. I passaggi variano a seconda del tipo di distribuzione e della versione OAuth. Utilizza questa tabella per seguire il percorso corrispondente alla tua configurazione:

Puoi creare fino a tre connessioni per istanza Jira Cloud con OAuth 2.0.

Jira Cloud o Data Center OAuth 1.0

Passaggio 1 - Registra un nuovo server Jira nel Connettore Jira di Smartsheet

1. Accedi al Connettore Jira di Smartsheet. Se ti viene richiesto di consentire l’accesso all’account Smartsheet, seleziona Allow (Consenti).
2. Seleziona il menu nell’angolo in alto a sinistra nella pagina e quindi seleziona Account Admin (Amministrazione dell’account).
3. Seleziona Register New Jira Server (Registra nuovo server Jira).
4. Nella pagina Settings (Impostazioni):
   • Inserisci l’URL dell’host JIRA per l’ambiente Jira che desideri connettere (ad esempio, https://mbfcorp.atlassian.net/). 
   • L’URL dell’API JIRA è in genere lo stesso dell’host JIRA. 
   • Per Name (Nome), accetta l’impostazione predefinita o inserisci un nome più descrittivo. 
   • Seleziona la tua JIRA Version (Versione di Jira). Per le istanze Jira Cloud, seleziona Jira Server 7 o Cloud.

Brandfolder Image

5. Seleziona Continue (Continua).
6. Nella pagina Configuration (Configurazione), copia la Consumer Key (Chiave consumer), il Consumer Name (Nome consumer) e la Public Key (Chiave pubblica). Li utilizzerai nei passaggi successivi.
7. Seleziona Continue (Continua).

Passaggio 2 - Crea un collegamento dell’applicazione (AppLink) a Smartsheet in Jira

1. Accedi a Jira con le autorizzazioni di Amministratore Jira.

2. Vai a Settings (Impostazioni) > Products (Prodotti).
    

   Brandfolder Image

   

3. Sulla barra laterale Products (Prodotti), in Integrations (Integrazioni), seleziona Application links (Collegamenti applicazione).

   Nelle precedenti versioni con self-hosting di Jira, vai a Settings (Impostazioni) > Applications (Applicazioni), quindi seleziona Application links (Collegamenti applicazione).

   Brandfolder Image

   
4. Seleziona Create link (Crea collegamento). Nella finestra di dialogo visualizzata, compila i campi:

   • Jira Cloud: seleziona Direct application link (Collegamento diretto all’applicazione) e inserisci https://app.smartsheet.com come Application URL (URL dell’applicazione). Seleziona Avanti.

     Brandfolder Image

     

   • Jira Data Center v9 e versioni successive: seleziona Atlassian product (Prodotto Atlassian) e inserisci https://app.smartsheet.com come Application URL (URL dell’applicazione). Seleziona Continue (Continua).

     Brandfolder Image

     
5. Quando viene visualizzato un avviso di reindirizzamento o convalida, seleziona Continue (Continua) e lascia invariato l’URL.
6. Nella finestra di dialogo Review link (Rivedi link) o Link applications (Collega applicazioni) visualizzata, compila i campi:
   • Application Name (Nome applicazione): Smartsheet.
   • Application Type (Tipo di applicazione): Generic Application (Applicazione generica) (accetta l’impostazione predefinita).
   • Solo Jira Data Center v9 e versioni successive: seleziona Create incoming link (Crea collegamento in entrata).

   • Seleziona Continue (Continua).

     Brandfolder Image

     

Passaggio 3 - Modifica il collegamento dell’applicazione

1. Trova il collegamento dell’applicazione creato nel Passaggio 2. Seleziona il menu a tre punti (passaci il mouse per visualizzarlo) o l’icona Modifica (a seconda della versione). 

2. Nella finestra di dialogo Configure (Configura), seleziona Incoming Authentication (Autenticazione in entrata).
    

   Brandfolder Image

   
3. Compila i campi: 
   • Service Provider Name (Nome del fornitore di servizi) (se mostrato): Smartsheet
   • Consumer Name (Nome consumer): incolla il nome consumer copiato nel Passaggio 1
   • Consumer Key (Chiave consumer): incolla la chiave consumer copiata nel Passaggio 1
   • Public Key/Shared Secret (Chiave pubblica/Segreto condiviso): incolla la chiave pubblica copiata nel Passaggio 1
   • Description (Descrizione): facoltativa
   • Se nel tuo ambiente Jira sono richiesti Request Token URL (URL del token di richiesta), Access Token URL (URL del token di accesso) o Authorize URL (URL di autorizzazione), inserisci https://api.smartsheet.com/2.0/token in ogni campo.
4. Seleziona Save (Salva), quindi Close (Chiudi).

Passaggio 4 - Completa la connessione tra Jira e Smartsheet

1. Torna alla configurazione del Connettore Jira di Smartsheet.

2. Nella schermata Connect (Connetti), seleziona Connect (Connetti).

   Una finestra di dialogo ti chiede di consentire a Smartsheet di leggere e scrivere nel tuo ambiente Jira. 

3. Seleziona Allow (Consenti). 

La connessione è ora attiva. I membri (utenti con licenza nel modello legacy) possono creare flussi di lavoro tra Jira e Smartsheet.

Per connettere altri ambienti Jira, ripeti questi passaggi per ogni istanza aggiuntiva. 

Jira Cloud OAuth 2.0

Passaggio 1 - Registra un nuovo server Jira nel Connettore Jira di Smartsheet

Configura le impostazioni del firewall e la configurazione prima di configurare questa connessione.

1. Accedi al Connettore Jira di Smartsheet. Se ti viene richiesto di consentire l’accesso all’account Smartsheet, seleziona Allow (Consenti).
2. Seleziona il menu nell’angolo in alto a sinistra nella pagina e quindi seleziona Account Admin (Amministrazione dell’account).
3. Seleziona Register New Jira Server (Registra nuovo server Jira).
4. Nella pagina Settings (Impostazioni):
   • Inserisci l’URL dell’host JIRA per l’ambiente Jira che desideri connettere (ad esempio, https://mbfcorp.atlassian.net/). 
   • L’URL dell’API JIRA è in genere lo stesso dell’host JIRA. 
   • Per Name (Nome), accetta l’impostazione predefinita o inserisci un nome più descrittivo. 
   • Seleziona la tua JIRA Version (Versione di Jira). Per le istanze Jira Cloud, seleziona Jira Server 7 o Cloud.

Brandfolder Image

5. Seleziona Continue (Continua).

   Nella pagina Configurazione viene visualizzato un messaggio che indica: Your JIRA connection is already configured (La connessione JIRA è già configurata).

6. Seleziona Continue (Continua).

Fase 2 - Completa la connessione Jira per Smartsheet

1. Nella schermata Connect (Connetti), seleziona Connect (Connetti).

   Una finestra di dialogo ti chiede di consentire a Smartsheet di leggere e scrivere nel tuo ambiente Jira. 

2. Seleziona l’host dal menu a discesa Use app on (Usa app su). 

Brandfolder Image

3. Seleziona Allow (Consenti). 

La connessione è ora attiva. I membri (utenti con licenza nel modello legacy) possono creare flussi di lavoro tra Jira e Smartsheet.

Per connettere altri ambienti Jira, ripeti questi passaggi per ogni istanza aggiuntiva. 

Jira Data Center OAuth 2.0

Passaggio 1 - Crea un collegamento dell’applicazione (AppLink) a Smartsheet in Jira

1. Accedi a Jira.
2. Vai a Settings (Impostazioni) > Applications (Applicazioni).

3. Nella barra laterale Applications (Applicazioni), in Integrations (Integrazioni), seleziona Application links (Collegamenti applicazione).

   Se Applications (Applicazioni) non viene visualizzato sotto Settings (Impostazioni), vai invece a Products (Prodotti). Cerca Application links (Collegamenti applicazione) sotto Integrations (Integrazioni) nella barra laterale Products (Prodotti).

4. Seleziona Create link (Crea collegamento). Nella finestra di dialogo visualizzata, compila i campi:
   • Application Type (Tipo di applicazione): External Application (Applicazione esterna)
   • Direction (Direzione): Incoming (In entrata)
   • Seleziona Continue (Continua)

Brandfolder Image

5. Configura il collegamento in entrata:
   • Name (Nome): inserisci un nome descrittivo
   • Redirect URL (URL di reindirizzamento): {smartsheet-connector-host}/c/jira/signInCallback}. Tieni presente che smartsheet-connector-host differisce per ogni regione:

     • USA: https://connectors.smartsheet.com/c/jira/signInCallback

     • UE: https://connectors.smartsheet.eu/c/jira/signInCallback

     • AU: https://connectors.smartsheet.au/c/jira/signInCallback

   • Application Permission (Autorizzazione applicazione): System Admin (Amministratore di sistema)
6. Seleziona Salva (Salva).

Al termine del passaggio, Jira visualizza un ID client e un Segreto client. Copia entrambi i valori, poiché ti serviranno nel passaggio 2.

Brandfolder Image

Passaggio 2: registra un nuovo Jira Server nel Connettore Jira di Smartsheet

1. Accedi al Connettore Jira di Smartsheet. Se ti viene richiesto di consentire l’accesso al tuo account Smartsheet, seleziona Allow (Consenti).
2. Seleziona il menu nell’angolo in alto a sinistra nella pagina e quindi seleziona Amministrazione account.
3. Seleziona Register New Jira Server (Registra nuovo server Jira).
4. Nella pagina Settings (Impostazioni):
   • Inserisci l’URL dell’host JIRA per l’ambiente che desideri connettere (ad esempio, https://mbfcorp.atlassian.net/).
   • L’URL API JIRA in genere è lo stesso del tuo host JIRA.
   • Per Name (Nome), accetta il valore predefinito o inserisci un nome più descrittivo.
   • Seleziona la tua JIRA Version (Versione di Jira).
5. Seleziona Continue (Continua).
6. Nella pagina Configuration (Configurazione), inserisci l’ID client e il segreto client copiati nel Passaggio 1.

Passaggio 3 - Completa la Connessione tra Jira e Smartsheet

1. Seleziona Continue (Continua).

2. Nella schermata Connect (Connetti), seleziona Connect (Connetti).

   Una finestra di dialogo ti chiede di consentire a Smartsheet di leggere e scrivere nel tuo ambiente Jira.

3. Seleziona Allow (Consenti).

La connessione è ora attiva. I membri (utenti con licenza nel modello legacy) possono creare flussi di lavoro tra Jira e Smartsheet.

Limitare l’accesso al Connettore Jira di Smartsheet

Le autorizzazioni sia in Smartsheet sia in Jira controllano sempre ciò che un utente può fare nel Connettore, indipendentemente dal fatto che siano abilitate ulteriori restrizioni. Ad esempio, se la persona che ha creato un flusso di lavoro non dispone dell’autorizzazione per modificare dati specifici del progetto in Jira, il flusso di lavoro non può modificare tali dati tramite il Connettore.

Per limitare gli utenti che possono creare flussi di lavoro, l’Amministratore di sistema Smartsheet o l’Amministratore del Connettore Jira può attivare l’impostazione Limita accesso.

Attivare Limita accesso

1. Accedi al Connettore Jira di Smartsheet con le tue credenziali Smartsheet.
2. Seleziona l’icona del menu nell’angolo in alto a sinistra e seleziona Gestione degli utenti.

3. Seleziona la casella di spunta Restrict which users can access the Smartsheet JIRA Integration (Limita gli utenti con accesso all’integrazione JIRA per Smartsheet). 

   Brandfolder Image

   
4. Aggiungi l’indirizzo e-mail di ogni utente che deve avere accesso.

Rimuovere un utente

Gli utenti rimossi dall’elenco perdono la possibilità di creare o modificare flussi di lavoro.

1. Accedi al Connettore Jira di Smartsheet con le tue credenziali Smartsheet.
2. Vai a Gestione degli utenti.
3. Seleziona l’icona Elimina a destra delle informazioni sull’account di quell’utente.