View a markdown version of this page

Integrazione con Smartsheet - Amazon Quick
PrerequisitiConfigura gli strumenti per sviluppatori SmartsheetAmbiti di accesso OAuthConfigura l'integrazione in Amazon QuickOperazioni disponibiliGestisci e risolvi i problemi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Integrazione con Smartsheet

Usa il connettore di azione Smartsheet per gestire fogli, righe, report e cercare nelle tue aree di lavoro Smartsheet direttamente in Amazon Quick tramite linguaggio naturale. Questa integrazione utilizza l'API Smartsheet. Per ulteriori informazioni, consulta l'introduzione all'API Smartsheet nella documentazione di Smartsheet.

La configurazione di questa integrazione prevede due passaggi. Innanzitutto, configuri le credenziali in Smartsheet per il metodo di autenticazione scelto. Quindi, crei l'integrazione in Amazon Quick e la colleghi al tuo account Smartsheet. Per informazioni sui metodi di autenticazione supportati da Amazon Quick, consultaMetodi di autenticazione.

Prerequisiti

Prima di configurare l'integrazione, assicurati di soddisfare i seguenti requisiti:

Configura gli strumenti per sviluppatori Smartsheet

Prima di configurare Amazon Quick, configura le credenziali in Smartsheet. I passaggi da completare dipendono dal metodo di autenticazione che intendi utilizzare. Amazon Quick supporta due metodi di autenticazione per Smartsheet. Per ulteriori informazioni su questi metodi, consultaMetodi di autenticazione.

Per ulteriori informazioni su Smartsheet OAuth, consulta OAuth nella documentazione dell'API Smartsheet.

Registrati a Developer Tools e crea un profilo da sviluppatore

  1. Vai alla pagina di registrazione degli Strumenti per sviluppatori e registra l'account Smartsheet che desideri utilizzare con le tue app. Per ulteriori informazioni, consulta Registrazione agli strumenti per sviluppatori nella documentazione dell'API Smartsheet.

  2. Dopo che Smartsheet ha attivato gli Strumenti per sviluppatori, accedi all'applicazione Smartsheet e scegli l'icona del tuo Account nell'angolo in basso a sinistra, quindi scegli Strumenti per sviluppatori.

  3. Scegli Crea profilo sviluppatore e inserisci un nome per il profilo. Per maggiori informazioni, consulta Crea il tuo profilo di sviluppatore nella documentazione dell'API Smartsheet.

Suggerimento

Smartsheet consiglia di utilizzare un account di servizio dedicato per le app OAuth anziché un account personale.

Registra l'applicazione OAuth

  1. In Smartsheet Developer Tools, scegli Crea nuova app.

  2. Compila il modulo:

    • Nome dell'app: un nome per identificare l'app per gli utenti.

    • Descrizione dell'app: una breve descrizione dell'integrazione.

    • URL dell'app: l'URL che avvia l'app o una pagina di destinazione.

    • App contact/support: informazioni di contatto del supporto.

    • URL di reindirizzamento dell'app: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

      Sostituisci {region} con la tua AWS regione (ad esempio,us-east-1).

  3. Scegli Save (Salva). Smartsheet genera l'ID client dell'app e il segreto dell'app.

  4. Copia i valori Client ID e Client Secret. Ne hai bisogno quando configuri l'integrazione in Amazon Quick.

Per ulteriori informazioni, consulta Registrare un'app nella documentazione dell'API Smartsheet.

Genera un token di accesso all'API (solo autenticazione del servizio)

Se prevedi di utilizzare l'autenticazione del servizio anziché OAuth, genera un token di accesso API. È necessario disporre di un piano Business o Enterprise per generare token. Per maggiori informazioni, consulta Generare un token di accesso API nel Centro assistenza Smartsheet.

  1. Nell'applicazione Smartsheet, scegli il tuo account (immagine del profilo) nella parte inferiore della barra di navigazione a sinistra, quindi scegli Impostazioni personali.

  2. Scegli la scheda Accesso API e scegli Genera nuovo token di accesso.

  3. Assegna un nome al token e scegli OK. Copia immediatamente il valore del token: è l'unica volta che è visibile.

Importante

Conserva il tuo token di accesso in modo sicuro. Chiunque disponga del token può accedere a tutti i dati Smartsheet a cui ha accesso il proprietario del token. Non assegnare i token ai sistemi di controllo delle versioni. Per le migliori pratiche sulla memorizzazione dei token, consulta Autenticazione nella documentazione dell'API Smartsheet.

Ambiti di accesso OAuth

Quando configuri l'autenticazione utente (OAuth), l'integrazione richiede i seguenti ambiti di accesso da Smartsheet. Questi ambiti determinano cosa può fare l'integrazione per conto dell'utente autenticato. Se si utilizza invece l'autenticazione del servizio (chiave API), l'integrazione utilizza le autorizzazioni complete del proprietario del token e gli ambiti non si applicano. Per ulteriori informazioni, consulta gli ambiti di accesso nella documentazione dell'API Smartsheet.

Ambiti di accesso OAuth di Smartsheet
Scope Description
READ_SHEETS Leggi tutti i dati del foglio, inclusi gli allegati, le discussioni e i dati delle celle.
WRITE_SHEETS Inserisci e modifica i dati del foglio, inclusi allegati, discussioni e dati delle celle.
Nota

Gli ambiti di accesso non sostituiscono le autorizzazioni di condivisione esistenti. Ad esempio, avere l'WRITE_SHEETSambito non consente all'integrazione di aggiornare un foglio su cui l'utente ha accesso solo a livello di visualizzatore. Per ulteriori informazioni, consulta Livelli di accesso alle risorse nella documentazione dell'API Smartsheet.

Configura l'integrazione in Amazon Quick

Dopo aver completato la configurazione di Smartsheet Developer Tools, crea l'integrazione in Amazon Quick.

  1. Nella console Amazon Quick, scegli Connettori.

  2. Scegli la scheda Crea per il tuo team.

  3. Trova e scegli Smartsheet.

  4. Inserisci i dettagli dell'integrazione:

    • Nome: nome descrittivo per l'integrazione con Smartsheet.

    • Descrizione (opzionale): scopo dell'integrazione.

  5. Scegli il tipo di connessione e compila le impostazioni di connessione. Per ulteriori informazioni su questi metodi di autenticazione, consultaMetodi di autenticazione.

    1. Per l'autenticazione utente (OAuth), utilizza Client ID e Client Secret dalla registrazione dell'app Smartsheet Developer Tools. Configura i campi seguenti:

      • URL di base — https://api.smartsheet.com/2.0

      • ID cliente: ID client dell'app risultante dalla registrazione dell'app Smartsheet Developer Tools.

      • Client Secret: app segreta derivante dalla registrazione dell'app Smartsheet Developer Tools.

      • URL del token: https://api.smartsheet.com/2.0/token

      • URL di autenticazione — https://app.smartsheet.com/b/authorize

      • URL di reindirizzamento — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

    2. Per l'autenticazione del servizio (chiave API), utilizza il token di accesso API dalle Impostazioni personali di Smartsheet. Configura i campi seguenti:

      • Chiave API: token di accesso all'API Smartsheet generato dalle tue Impostazioni personali.

      • URL di base — https://api.smartsheet.com/2.0

      • E-mail: indirizzo e-mail associato all'account Smartsheet che ha generato il token.

  6. Scegli Crea e continua.

  7. Scegli gli utenti con cui condividere l'integrazione.

  8. Scegli Next (Successivo).

Per l'autenticazione dell'utente, vai su Connettori > il nome del tuo connettore Smartsheet e scegli Accedi per completare il flusso di autorizzazione OAuth. Nella finestra di consenso Smartsheet, scegli Consenti per concedere l'accesso.

Importante

Con l'autenticazione del servizio, tutte le azioni vengono eseguite utilizzando le autorizzazioni del proprietario del token API. Qualsiasi utente Amazon Quick con accesso a questa integrazione può eseguire azioni su tutte le risorse Smartsheet a cui il proprietario del token può accedere. Definisci le autorizzazioni dei token in modo appropriato per i requisiti di sicurezza della tua organizzazione.

Nota

Se utilizzi Smartsheet Gov, Smartsheet Regions Europe o Smartsheet Regions Australia, utilizza l'URL di base corrispondente per il tuo ambiente:

URL di base regionali Smartsheet
Ambiente URL di base
Smartsheet https://api.smartsheet.com/2.0
Smartsheet Gov https://api.smartsheetgov.com/2.0
Smartsheet Regions Europe https://api.smartsheet.eu/2.0
Regioni Smartsheet Australia https://api.smartsheet.au/2.0

Per maggiori informazioni, consulta l'URL di base nella documentazione dell'API Smartsheet.

Operazioni disponibili

Dopo aver configurato l'integrazione, sono disponibili le seguenti azioni.

Azioni disponibili di Smartsheet
Categoria Azione Description
Cerca Ricerca nell'elenco Cerca il testo specificato in tutti i fogli a cui l'utente può accedere.
Fogli Fogli di elenco Elenca tutti i fogli accessibili all'utente autenticato.
Fogli Ottieni foglio Ottiene un foglio e i relativi dati in base all'ID del foglio.
Report Elenca i rapporti Elenca tutti i report accessibili all'utente.
Report Visualizza rapporto Ottiene i dettagli del rapporto in base all'ID del rapporto.

Gestisci e risolvi i problemi

Per modificare, condividere o eliminare la tua integrazione, consulta. Gestione delle integrazioni esistenti

Problemi di autenticazione

  • L'autorizzazione OAuth non riesce: verifica che Client ID e Client Secret corrispondano ai valori indicati nella registrazione dell'app Smartsheet Developer Tools. Verifica che l'URL di reindirizzamento in Smartsheet corrisponda esattamente all'URL nella tua configurazione Amazon Quick. Per un elenco dei tipi di errore OAuth, consulta Tipi di errore OAuth nella documentazione dell'API Smartsheet.

  • Strumenti per sviluppatori non disponibili: verifica che gli Strumenti per sviluppatori siano attivati per il tuo account Smartsheet. Gli account gratuiti non supportano gli Strumenti per sviluppatori. Se la tua richiesta è stata rifiutata, contatta il tuo Customer Success Manager di Smartsheet.

  • L'autenticazione della chiave API non riesce: verifica che il token di accesso non sia stato revocato. Puoi gestire i token da Impostazioni personali > Accesso API nell'applicazione Smartsheet. Per ulteriori informazioni, consulta Generare un token di accesso all'API nel Centro assistenza Smartsheet.

  • Token di accesso scaduto: i token di accesso OAuth scadono dopo circa 7 giorni. Amazon Quick gestisce automaticamente l'aggiornamento dei token. Se riscontri errori persistenti nei token, esci e accedi nuovamente dalle impostazioni di integrazione. Per ulteriori informazioni, consulta Effettuare chiamate API nella documentazione dell'API Smartsheet.

Messaggi di errore comuni

  • Le azioni restituiscono errori di autorizzazione: verifica che l'utente autenticato disponga delle autorizzazioni di condivisione richieste sui fogli di destinazione. Gli ambiti OAuth non hanno la precedenza sui controlli di accesso a livello di condivisione. Per maggiori informazioni, consulta Livelli di accesso alle risorse nella documentazione dell'API Smartsheet.

  • Foglio non trovato: verifica che l'ID del foglio sia corretto e che l'utente autenticato abbia almeno l'accesso da visualizzatore al foglio.

  • Errori relativi ai limiti di velocità dell'API: l'API Smartsheet impone limiti di velocità. Per ulteriori informazioni, consulta Limitazioni nella documentazione dell'API Smartsheet.