Vuoi collegarti a un'applicazione di terze parti al di là dei connettori Premium precostituiti di Workiva? È possibile ottenere questo risultato utilizzando i comandi del connettore per le richieste HTTP per interagire con le API REST.
Nota: sebbene questa opzione sia denominata "Richiesta HTTP", è supportato (e consigliato) l'uso di HTTPS (HTTP sicuro).
In questo Percorso Didattico Collegato, aggiorneremo la nostra Catena per utilizzare gli Input Runtime in cui possiamo specificare quale foglio di calcolo vogliamo recuperare.
| Caso d'uso primario | Connessione a sistemi di terze parti |
| Obiettivo di apprendimento primario | Utilizza i comandi HTTP Request Connector di Workiva per interagire con le API REST di applicazioni di terze parti oltre ai connettori precostituiti. Aggiornare le catene per utilizzare gli input di runtime per specificare quale foglio di calcolo utilizzare. |
| Obiettivo di apprendimento secondario | Usare gli input del runtime |
| Prerequisiti |
Configurare la concessione API di Workiva Configurazione del connettore di richiesta HTTP CLP completo | Fogli di calcolo con l'elenco delle richieste HTTP |
| Modello di supporto | CLP | Richiesta HTTP Ottieni un singolo foglio di calcolo |
Passo 1: Copiare e modificare una catena
- Accedi a Chain Builder e individua i fogli di calcolo "Chain CLP | Elenco delle richieste HTTP ".
- Fai clic sull'ellisse verticale per copiare la catena.
- Clicca sull'icona della matita per modificare la catena.
- Fai clic su " Impostazioni catena " in alto a destra e rinomina la catena: CLP | Richiesta HTTP per ottenere un singolo foglio di calcolo .
- ( Facoltativo ) Inserisci una descrizione : "Questa catena genera un nuovo token di accesso all'API di Workiva. Devi fornire un ID cliente e un Segreto cliente validi, ricavati da una concessione API generata in precedenza, nei valori delle variabili sottostanti. Quando la catena viene eseguita, chiederà all'utente di inserire un ID del foglio di calcolo. La catena recupererà il foglio di calcolo."
- Salvate la catena.
Passo 2: Ingressi di Runtime
Utilizza l'evento "Runtime Inputs Chain " per avviare la catena.
Questo ci permette di specificare l'ID del foglio di calcolo che vogliamo ottenere. Per saperne di più sugli input di runtime.
- Sposta il comando POST - Recupera un token dal nodo iniziale.
- Aggiungi un evento “Catena di input di runtime ” dalla sezione “Eventi di attivazione della catena ” al nodo di inizio.
- Fare doppio clic sul collegamento che associa " Runtime Inputs " al comando " Get - List Spreadsheets " ed eliminare il collegamento.
- Collegare gli input di runtime al comando POST - Recupera un token .
-
Collega il comando POST - Recupera un token al comando GET - Elenca fogli di calcolo .
- Fai doppio clic sull'evento " Runtime Inputs Chain" per configurarlo.
- Fare clic su " Aggiungi input " e configurare i seguenti campi:
- Tipo: Campo di testo
- Nome visualizzato: ID del foglio di calcolo - consulta questo documento per sapere come individuare l'ID
- Obbligatorio: selezionare questa casella di controllo
- ( Facoltativo ) Inserisci una descrizione : "Questo comando consente all'utente di specificare i valori degli input necessari per l'esecuzione."
- Salva il comando.
Passo 3: aggiornare il comando Get
Aggiorneremo il comando HTTP Request Get in modo da ottenere i dettagli di un singolo foglio di calcolo invece di elencare tutti i fogli di calcolo dell'area di lavoro.
- Fai doppio clic sul comando " Get - List of Spreadsheets " per configurarlo.
- Nome del comando: Get - Recupera un singolo foglio di calcolo .
-
Utilizza la variabile "ID foglio di calcolo " presente nella sezione "Input di runtime" nel campo URL per specificare quale foglio di calcolo recuperare.
Per farlo, clicca sul campo URL e, dopo /spreadsheets , aggiungi "/< ID del foglio di calcolo > ", sostituendo
<Spreadsheet ID> con la variabile proveniente dagli input di runtime come segue:- Nel pannello di sinistra, espandi il menu a tendina "Trigger" .
- Espandi il menu a tendina " Input di runtime ".
- Selezionare la variabile " ID foglio di calcolo ".
- ( Facoltativo ) Inserisci una descrizione : "Questo comando restituisce un singolo foglio di calcolo. Per ulteriori informazioni, consultare la documentazione per gli sviluppatori all'indirizzo https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html"
- Salva il comando.
Passo 4: Prova l'esercizio
Ora che la Catena è completa, possiamo testare il risultato.
- Pubblica la catena.
- Fare clic su " Esegui ", quindi su " Esegui con input ".
- Trova un ID foglio di calcolo, accedendo a un foglio di calcolo sulla piattaforma Workiva. Assicurati che l'utente che ha concesso l'autorizzazione a questo foglio di calcolo.
- Fare clic su Start .
- Una volta che la Chain ha completato l'esecuzione, è possibile notare che i dettagli del foglio di calcolo sono stati generati nella scheda "Outputs " (Risultati) - Corpo della risposta del comando Get .