Il Connettore Jira per Smartsheet è disponibile come offerta Premium. Se hai acquistato il Connettore Jira Smartsheet nel tuo piano, accedi per creare flussi di lavoro tra Smartsheet e Jira.
USM Content
Individuazione e correzione degli errori di sincronizzazione
Puoi utilizzare le risorse seguenti per individuare e risolvere gli errori dei flussi di lavoro:
- Cronologia di esecuzione: vai a questa pagina per visualizzare un conteggio degli errori di sincronizzazione per un flusso di lavoro, insieme al messaggio di errore e ai dettagli del problema.
- Report di errore: quando si verificano problemi, il proprietario del flusso di lavoro e la persona che ha modificato il campo o la riga del flusso di lavoro che ha causato il problema ricevono un’e-mail.
- Colonna di errore: controlla questa colonna nel tuo foglio per rivedere un messaggio sulle righe con un problema di sincronizzazione.
Run History (Cronologia di esecuzione)
Dopo aver creato un flusso di lavoro, puoi accedere alla pagina Cronologia di esecuzione per visualizzare la cronologia di sincronizzazione e gli eventuali errori che si sono verificati. Puoi accedere alla cronologia di esecuzione selezionando il timestamp del flusso di lavoro in Ultima esecuzione.
Nella cronologia delle esecuzioni sono presenti i seguenti tipi di esecuzione:
- Sincronizza con Smartsheet: il flusso di lavoro viene eseguito per le modifiche da Jira che sono state sincronizzate con Smartsheet.
- Sincronizza con Jira: il flusso di lavoro viene eseguito per le modifiche da Smartsheet che sono state sincronizzate con Jira.
- Finder di righe filtrate: il flusso di lavoro viene eseguito per le modifiche a eventuali problemi che devono essere filtrati in base alla configurazione del flusso di lavoro. Filtered Row Finder è un processo in background che viene eseguito ogni 2 ore. I problemi filtrati vengono aggiunti alla gerarchia Filtered Out by Connector—Not Synced (Filtrato per connettore, non sincronizzato) del foglio. Il processo Filtered Row Finder viene eseguito solo con tipi di flusso di lavoro automatizzati. Questo processo viene eseguito anche se non hai specificato filtri nel flusso di lavoro.
Errori comuni
Quando si verificano problemi, il proprietario del flusso di lavoro e la persona che ha modificato il problema/la riga nel flusso di lavoro che ha causato il problema, ricevono report di errore via e-mail. Di seguito sono riportati alcuni errori e problemi comuni.
Campo [Gruppo] non impostato
Oggetto | Dettagli |
|---|---|
Dettagli | I problemi senza valore di raggruppamento impostato in Jira vengono visualizzati in una gerarchia denominata gruppo di campi non impostato |
Risoluzione dei problemi | Assegna un valore di raggruppamento ai problemi in Jira |
Filtered Out by Connector-Not Synced
Oggetto | Dettagli |
|---|---|
Dettagli | Ciò si verifica con il Connettore Salesforce e Jira. La riga Filtered Out by Connector-Not Synced non aggiunge righe con problemi di sincronizzazione; mostra solo gli elementi eliminati in Jira o le righe che non soddisfano più i criteri del filtro Jira e non si sincronizzano con Jira. |
Risoluzione dei problemi |
|
Impossibile impostare il campo . It is not on the appropriate screen or is unknown (Errore: il campo ’’ non può essere impostato. Non è sulla schermata appropriata, oppure è sconosciuto).
Oggetto | Dettagli |
|---|---|
Dettagli | Questo errore viene visualizzato se il valore di campo che desideri impostare non è presente nella schermata Modifica di Jira. Solo i campi nella schermata Modifica in Jira possono essere modificati dal Connettore Jira per Smartsheet. |
Risoluzione dei problemi |
|
Configurazione delle notifiche non riuscita
Oggetto | Dettagli |
|---|---|
Dettagli | Il Connettore Jira non è in grado di ricevere notifiche di modifica da Jira tramite Webhook. In questo caso, il connettore non è in grado di rilevare gli aggiornamenti in Jira e sincronizzarli con Smartsheet. |
Risoluzione dei problemi | Verifica la registrazione al webhook in Jira:
Controlla le autorizzazioni di Amministratore di sistema Jira:
Riautentica il connettore:
Verifica la presenza di firewall Jira o restrizioni di rete (solo Jira self-hosted):
Verifica che nessun aggiornamento dell’applicazione Jira abbia interrotto il webhook:
|
Se il problema persiste dopo i passaggi precedenti, contatta l’Assistenza Smartsheet e fornisci un file di informazioni di supporto per l’esecuzione del flusso di lavoro (WEX) per accelerare la risoluzione. Consulta Generare un file WEX per il supporto di seguito.
Genera un file WEX per l'assistenza
Se hai seguito i passaggi di risoluzione dei problemi di cui sopra e hai ancora bisogno di aiuto, la generazione di un file WEX (Workflow Execution Support Info) prima di contattare l'assistenza aiuta il team a diagnosticare il problema più velocemente e a ridurre gli scambi.
Il file WEX contiene informazioni dettagliate sul flusso di lavoro, comprese le mappature dei campi, la direzione di sincronizzazione e le configurazioni dei filtri. Non contiene i tuoi dati Smartsheet o Jira.
Qualsiasi Amministratore di sistema o Amministratore Connector di Smartsheet può generare un file WEX seguendo questi passaggi:
- Accedi a https://connectors.smartsheet.com/c/jira .
- Nella dashboard Connettore Jira, seleziona il timestamp nella colonna Data di esecuzione per il flusso di lavoro interessato. Si apre la cronologia di esecuzione del flusso di lavoro.
- Seleziona il timestamp in Ultima esecuzione per l'esecuzione più recente.
- Nella pagina seguente, apri il menu dell'hamburger (tre linee orizzontali in alto a sinistra) e seleziona Download Workflow Execution Support Info .
Allega questo file quando invii il ticket di assistenza o lo condividi con l’Assistenza Smartsheet.
Il file WEX è in formato JSON. Il supporto lo analizza da solo: non è necessario interpretarlo da solo.
Domande frequenti
Se si verificano dei problemi, vengono inviati dei report degli errori tramite e-mail al proprietario del flusso di lavoro e alla persona che ha modificato il problema/la riga nel flusso di lavoro che ha causato il problema. Di seguito sono riportati alcuni errori e problemi comuni.
Problema: l’ordine delle righe non è come previsto
Quando si esegue un flusso di lavoro automatizzato, i problemi vengono ordinati per Issue Key (Chiave problema) in ordine crescente, anche se sono ordinati in modo diverso in Jira. Per ordinare i problemi sincronizzati con un flusso di lavoro automatico, utilizza Raggruppamento righe .
Per i flussi di lavoro manuali, il processo Filtered Row Finder (Ricerca righe filtrate) non viene eseguito. In questo caso, puoi ordinare manualmente le righe nel tuo foglio.
Se desideri ordinare i problemi manualmente mentre utilizzi ancora un flusso di lavoro automatizzato, procedi nel modo seguente:
- Sincronizza Jira con un foglio diverso.
- Usa una funzione index/match o una formula vlookup tra fogli per portare i valori nel tuo foglio principale usando la chiave problema. Formula di esempio: =INDEX({Intervallo che contiene il valore da restituire}, MATCH([Valore di ricerca]@row, {Intervallo che contiene il valore di ricerca}, 0))
Il problema non può essere salvato in Jira
Devi disporre di autorizzazioni in scrittura sui progetti Jira connessi per potervi salvare i dati.
I dati non vengono rimossi da un foglio dopo gli aggiornamenti dei filtri
Smartsheet non eliminerà i dati estratti da Jira perché ogni riga potrebbe contenere dati importanti di colonne, allegati o commenti.
Quando i problemi Jira nel tuo foglio non soddisfano più i criteri del filtro del flusso di lavoro, Smartsheet crea una sezione Filtered out by Connector—not synced nella parte superiore per conservare le informazioni filtrate dal Connettore. Le righe filtrate non vengono sincronizzate fino a quando non soddisfano di nuovo i criteri di filtro e queste righe possono essere eliminate se il team non ritiene più necessario che siano incluse nel foglio.
Si è verificato un errore durante l’aggiornamento della colonna Error in Smartsheet
Se rimuovi la colonna Sync Error dal foglio collegato, riceverai un errore. Assicurati che il foglio includa una colonna Errore di sincronizzazione perché è obbligatoria. Se necessario, puoi modificare il flusso di lavoro per rimappare la colonna Errore di sincronizzazione sul foglio. Per saperne di più, vedi la modifica del flusso di lavoro.
Colonna Error
Questa colonna viene aggiunta automaticamente al foglio dal connettore e mostrerà i dettagli su eventuali problemi di sincronizzazione che si verificano per la riga.
...is not a valid user for the given JIRA project (...non è un utente valido per il progetto JIRA)
Questo messaggio può essere visualizzato quando viene inserita un’e-mail non valida in un campo Smartsheet sincronizzato con Jira e può causare problemi con la sincronizzazione dei contatti.
Inoltre, all'interno di Jira Cloud, questo errore può verificarsi se l'utente non è assegnato al progetto in Jira o se, in Jira, i servizi esterni (come il Connettore Jira di Smartsheet) non possono visualizzare gli indirizzi e-mail. Una configurazione per utente può essere modificata accedendo a Profilo > Gestisci il tuo account > Profilo e visibilità e modificando Chi può vederlo? impostazione per il campo Contatto in basso. Se è impostato su Only you and the admins, il Connettore Jira non potrà accedere alle informazioni sull’indirizzo e-mail dell’utente con questa impostazione e non compilerà il campo e-mail.
Quando provo ad accedere al Connettore Jira, mi viene detto che non sono autorizzato a eseguire questa azione. Cosa faccio?
È possibile che tu non disponga ancora delle autorizzazioni necessarie per accedere al Connettore Jira. Contatta il tuo Amministratore di sistema Smartsheet per ricevere assistenza.