Amministrazione e configurazione del Connettore Jira di Smartsheet

Il Connettore Jira di Smartsheet sincronizza le informazioni tra Smartsheet e una o più istanze Jira creando flussi di lavoro.

Il Connettore Jira di Smartsheet è un prodotto Premium. Contatta il nostro team di vendita, per informazioni sui prezzi.

Se hai acquistato il Connettore Jira di Smartsheet nel tuo piano, accedi per creare flussi di lavoro tra Smartsheet e Jira.

Accedi al Connettore Jira di Smartsheet

Terminologia e tipi di autorizzazione

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

Gli utenti possono avere tre diverse autorizzazioni per interagire con il Connettore Jira di Smartsheet:

• Amministratore di sistema Smartsheet: gestisce gli Amministratori del Connettore Jira e gli Utenti del Connettore Jira dall’applicazione Smartsheet. Gli Amministratori di sistema possono inoltre 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: può creare flussi di lavoro per sincronizzare le informazioni tra Smartsheet e Jira.

Funzioni per tipo di autorizzazione

La tabella seguente mostra quali autorizzazioni possono completare attività specifiche utilizzando il Connettore Jira.

 *Gli Amministratori di sistema Smartsheet e gli Amministratori del Connettore possono creare e modificare i propri flussi di lavoro se la funzione dell’elenco 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. Scopri di più sulla limitazione dell’accesso.

Configurazione della connessione

Devi prima configurare la connessione tra Smartsheet e l’istanza Jira, in modo che gli utenti possano creare flussi di lavoro per connettere elementi in Smartsheet e Jira. Il Connettore Jira di Smartsheet è compatibile con Jira Cloud e il server Jira v6.x - v10.x e Jira Data Center.

Stabilisci la connessione utilizzando un account e-mail con licenza generico (smartsheet-jira@dominio.com) per Smartsheet e Jira. Ciò evita la necessità di ripetere le connessioni o i flussi di lavoro se la persona che gestisce il collegamento Jira lascia l’organizzazione, poiché la proprietà della connessione non può essere modificata.

Prerequisiti

Per impostare la connessione tra Smartsheet e Jira, devi disporre delle seguenti autorizzazioni:

In Jira:

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

In Smartsheet:

• Utente con licenza di Smartsheet (modello Collaboratore legacy) o Membro (modello Abbonamento utente)
• Ruolo di Amministratore di sistema Smartsheet o Amministratore Connettore Jira di Smartsheet

Basta avere il ruolo di Amministratore di sistema Smartsheet OPPURE il ruolo di Amministratore Connettore Jira di Smartsheet; ma Smartsheet consiglia di avere entrambi i ruoli per configurare il Connettore.

Poiché il Connettore Jira di Smartsheet consente l’implementazione di flussi di lavoro automatici, l’applicazione deve disporre delle credenziali dell’Amministratore di sistema Jira per creare o configurare un webhook con l’API REST Jira. Le credenziali dell’Amministratore di sistema Jira vengono utilizzate solo per creare e configurare i webhook.

L’account utilizzato per la configurazione deve rimanere attivo con diritti di Amministratore sia in Jira che in Smartsheet. La rimozione dello stato Amministratore di questo utente attiva un errore: Missing user credentials for this endpoint (Credenziali utente mancanti per questo endpoint). Il ripristino delle autorizzazioni di Amministratore corregge la connessione e permette di riprendere la normale sincronizzazione del flusso di lavoro. Se le credenziali dell’Amministratore Jira vengono rimosse, devi ricostruire il collegamento dell’applicazione per via di modifiche del token.

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

Configura le impostazioni del firewall e crea 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):
   1. Inserisci l’URL dell’host JIRA dell’ambiente Jira che desideri connettere al tuo ambiente Smartsheet (https://mbfcorp.atlassian.net/). 
   2. L’URL dell’API JIRA probabilmente è lo stesso del tuo host JIRA. 
   3. Per Name (Nome), accetta il nome predefinito o modificalo con un descrittore più utile. 
   4. Seleziona la tua versione di JIRA.
5. Una volta completati questi elementi, nella pagina Settings (Impostazioni), seleziona Continue (Continua).
6. Nella pagina Configuration (Configurazione), vedi Consumer Key (Chiave consumer), Consumer Name (Nome consumer) e Public Key (Chiave pubblica). Copia questi valori in quanto ti serviranno in seguito.

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

1. Accedi a Jira (devi avere le autorizzazioni di Amministratore Jira).

2. Vai in Settings > Products (Impostazioni > Prodotti) in Jira.
    

   Brandfolder Image

   

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

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

   Brandfolder Image

   
4. Seleziona Create link (Crea link); viene visualizzato un riquadro Create link (Crea link). Compila i campi come descritto di seguito:

   • Per Jira Cloud, seleziona Direct application link (Collegamento diretto all’applicazione) e inserisci https://app.smartsheet.com per l’URL dell’applicazione. Quindi, seleziona Next (Avanti).

     Brandfolder Image

     

   • Per Jira con self-hosting versione 9 e successiva, seleziona Atlassian product (Prodotto Atlassian) e vai al sito https://app.smartsheet.com per l’URL dell’applicazione. Quindi, seleziona Continue (Continua).

     Brandfolder Image

     
5. Una volta visualizzato uno dei seguenti messaggi, seleziona Continue (Continua) e lascia invariato il nuovo URL.
   • Se non hai ricevuto risposta dall’URL inserito, potrebbe non essere valido. Se necessario, correggi l’URL riportato di seguito e seleziona Continue (Continua).
   • L’URL dell’applicazione fornito è stato reindirizzato una volta. Verifica il campo URL di reindirizzamento per assicurarti che si tratti di un URL affidabile.
6. A questo punto viene visualizzato un riquadro Review link (Rivedi collegamento) o Link applications (Collega applicazioni). Compila i campi come descritto di seguito:
   • Nella casella Application Name (Nome applicazione), digita Smartsheet.
   • Per Application Type (Tipo di applicazione), accetta il valore predefinito Generic Application (Applicazione generica).
   • Per Jira con self-hosting v9 e versioni successive, seleziona la casella Create incoming link (Crea collegamento in entrata).

   • Seleziona Continue (Continua).

     Brandfolder Image

     

Passaggio 3 - Modifica il collegamento dell’applicazione

1. Per il collegamento dell’applicazione creato nel Passaggio 2, seleziona il menu a tre punti che appare quando passi il cursore del mouse su Application link (Collegamento all’applicazione) oppure seleziona l’icona di modifica (dipendente dalla versione). 

2. Viene visualizzata una finestra Configure (Configura). Seleziona Incoming Authentication (Autenticazione in entrata).
    

   Brandfolder Image

   
3. Compila i campi come descritto di seguito: 
   • Service Provider Name (Nome del fornitore di servizi) (se necessario): Smartsheet
   • Consumer Name (Nome consumer): incolla il nome consumer copiato dal Connettore Jira nel Passaggio 1
   • Consumer Key (Chiave consumer): incolla la chiave consumer copiata dal Connettore Jira nel Passaggio 1
   • Public Key/Shared Secret (Chiave pubblica/Segreta condivisa): incolla la Chiave pubblica copiata dal Connettore Jira nel Passaggio 1
   • Description (Descrizione): aggiungi una descrizione come desiderato
   • Se le opzioni Request Token URL (Richiedi URL token), Access Token URL (Accedi a URL token) o Authorize URL (Autorizza URL) sono richieste nel tuo ambiente Jira, utilizza questo URL per compilare questi campi: https://api.smartsheet.com/2.0/token
4. Nella parte inferiore dell’autenticazione in entrata, seleziona Save (Salva), quindi Close (Chiudi) nell’angolo in basso a destra.

Passaggio 4 - Completa la connessione Jira per Smartsheet

1. Torna alla configurazione del Connettore Jira di Smartsheet (dovrebbe essere ancora nella pagina Configuration (Configurazione) in cui hai copiato le chiavi) e seleziona Continue (Continua).
2. Nella schermata Connect (Connetti), seleziona Connect (Connetti) per completare la connessione lato Smartsheet.
3. Una schermata di dialogo chiede se consenti a Smartsheet di leggere e scrivere nel tuo ambiente Jira. Seleziona Consenti. 

La tua connessione tra Smartsheet e Jira è ora configurata. Gli utenti membri o con licenza sul tuo account possono ora creare flussi di lavoro tra gli elementi in Jira e i fogli in Smartsheet. 

Puoi connettere più ambienti Jira al tuo account Smartsheet con il Connettore Jira di Smartsheet. Ripeti le istruzioni di cui sopra per ciascuna istanza Jira aggiuntiva da registrare. 

Limitare l’accesso al Connettore Jira di Smartsheet

Se desideri restringere ulteriormente chi può creare flussi di lavoro all’interno del Connettore Jira di Smartsheet, puoi limitare l’accesso a determinati membri o utenti con licenza sul tuo account. Le azioni che puoi svolgere nel Connettore Jira dipendono dalle autorizzazioni di cui disponi sugli elementi in Smartsheet (autorizzazioni di condivisione foglio) e Jira (autorizzazioni di lettura/scrittura sul campo problema), indipendentemente dall’eventuale abilitazione di ulteriori limitazioni.

Il Connettore rispetta le autorizzazioni concesse in Jira e Smartsheet. Ad esempio, supponi che la persona che ha creato un flusso di lavoro nel Connettore non disponga dell’autorizzazione per modificare dati specifici di progetto in Jira. In tal caso, il flusso di lavoro non può modificare i dati del progetto tramite il Connettore.

Per limitare l’accesso

Per limitare chi può creare flussi di lavoro con il Connettore Jira, l’Amministratore di sistema Smartsheet/Jira può attivare l’impostazione Restrict Access (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 della pagina 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 chiunque desideri che acceda al connettore.

Per rimuovere l’accesso

Qualsiasi utente rimosso dall’elenco non sarà in grado di creare o modificare i propri 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 quella persona.