Vuoi connetterti a un'applicazione di terze parti al di là dei connettori Premium precostituiti di Workiva? Puoi ottenere questo risultato sfruttando i comandi del connettore di richiesta HTTP per interagire con le API REST. In questo Percorso Didattico Collegato, aggiorneremo la nostra Catena per utilizzare il Token del Portatore in un Comando che utilizza l'endpoint Elenco Fogli di Calcolo per ottenere un elenco di fogli di calcolo all'interno dell'area di lavoro.
Nota: sebbene questa opzione sia denominata "Richiesta HTTP", è supportato (e consigliato) l'uso di HTTPS (HTTP sicuro).
| Caso d'uso primario | Connessione a sistemi di terze parti |
| Obiettivo di apprendimento primario | Imparare i concetti fondamentali di Chains utilizzando il connettore di richiesta HTTP |
| Prerequisiti | Configurazione dell'autorizzazione API Workiva Configurazione del connettore per le richieste HTTP CLP - Richiesta HTTP Generazione di un token |
| Modello di supporto | CLP - Fogli di calcolo dell'elenco delle richieste HTTP |
Passo 1: Creare le variabili dell'area di lavoro
Per utilizzare i dettagli dell'API di Workiva in più catene e comandi, creeremo delle variabili dello spazio di lavoro per memorizzare tali informazioni. Creeremo una nuova variabile dello spazio di lavoro per l'URL dell'API della piattaforma.
- Da Chain Builder , accedi alle Impostazioni dell'area di lavoro .
- Nella sezione " Variabili dell'area di lavoro ", fare clic sul segno più per creare una nuova variabile dell'area di lavoro.
-
Configura le variabili utilizzando le seguenti informazioni:
- Nome: wsv-BaseURL-Platform
- Valore: in base alla propria regione, utilizzare il valore appropriato. È possibile verificare la regione controllando l'URL; se l'URL contiene "
EU" o "APAC" , utilizzare l'URL corrispondente. Altrimenti utilizza il valore US.
Nota: la regione degli Stati Uniti contiene solo "app".
Campo Valore USA URL base IAM https://api.app.wdesk.com Campo Valore UE URL base IAM https://api.eu.wdesk.com Campo Valore APAC URL base IAM https://api.apac.wdesk.com Campo Valore CA URL base IAM https://api.ca.wdesk.com - Salva le impostazioni dell'area di lavoro .
Nota: dovresti vedere tutte queste variabili nelle impostazioni del tuo spazio di lavoro. In caso contrario, rivedere i prerequisiti indicati sopra
Passo 2: Copiare e modificare una catena
- Accedi a Chain Builder e individua la catena denominata CLP | Genera un token .
- Fai clic sull'ellisse verticale sul lato destro e seleziona "Copia" .
- Una volta creata la copia della catena, clicca sull'icona della matita per modificarla.
- Fai clic su " Impostazioni catena " in alto a destra.
- Rinomina la catena: CLP | Fogli di calcolo con l'elenco delle richieste HTTP .
- ( 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. Quindi recupera un elenco di tutti i fogli di calcolo all'interno dell'area di lavoro. L'area di lavoro deve avere almeno uno o più fogli di calcolo".
- Salva la catena.
Passo 3: Elenco dei fogli di calcolo
Per recuperare un elenco dei nostri fogli di calcolo, questa stringa utilizza un Comando GET dal connettore delle richieste HTTP.
- Aggiungi un comando "Get " dal connettore " Richiesta HTTP " all'area di lavoro della catena.
- Collegare il comando " Post - Retrieve a Token " al comando " Get ".
- Fai doppio clic sul comando per configurarlo.
- Rinomina il comando: Get - Elenco dei fogli di calcolo
- Clicca sul comando e poi sull'icona della matita associata per modificare il comando.
- Selezionare la casella di controllo "Mostra risposta ".
- Fai clic su URL , quindi su Workspace nel pannello "Seleziona una variabile" e seleziona la variabile che hai creato al Passo 1 ( wsv-BaseURL-Platform ).
- Aggiungi /spreadsheets dopo la variabile. A
questo punto indicheremo all'endpoint come eseguire l'operazione, specificando le intestazioni nel modulo GET . - Fai clic due volte sul pulsante grigio con il segno più (+) accanto alla sezione "Intestazione" e inserisci in ciascun campo i valori riportati di seguito, prestando particolare attenzione alle maiuscole e alle minuscole e allo spazio dopo "Bearer".
- Campo intestazione 1:
- Utilizza il segno "+" per aggiungere un campo di intestazione .
- Legenda: Accetta
- Valore : application/json
- Campo di intestazione 2 :
- Utilizza il segno "+" per aggiungere un altro campo di intestazione .
- Legenda: Versione X
- Valore : 01/01/2026
-
Indicheremo all'endpoint come eseguire l'operazione utilizzando i parametri inseriti nel modulo POST . Per farlo, clicca 4 volte sul pulsante verde più accanto alla sezione Modulo e popola ogni campo con i valori sottostanti, prestando particolare attenzione alle lettere maiuscole e minuscole.
-
- Campo 1:
- Nome: client_id
- Valore: <wsv-Workiva API Client ID>
Nel pannello " Seleziona una variabile ", fare clic sulla freccia verso il basso per espandere " Workspace " e selezionare " wsv-Workiva API Client ID ".
- Campo 2:
- Nome: client_secret
- Valore: <wsv-Workiva API Client Secret>
Nel pannello " Seleziona una variabile ", fare clic sulla freccia verso il basso per espandere " Workspace " e selezionare " wsv-Workiva API Client Secret ".
- Campo 3:
- Nome: grant_type
- Valore: client_credentials
- Campo 4:
- Nome: scope
- Valore: se lo si desidera, è possibile inserire qui un valore per specificare a quali ambiti questo token debba avere accesso.
- Campo 1:
- Popola la risposta con il payload di esempio qui sotto. In questo modo, forniamo un formato all'output del comando, rendendo ogni variabile restituita più facile da usare.
{"access_token": "string", "expires_in": "integer", "scope": "string", "token_type": "string" }-
( Facoltativo ) Inserisci una descrizione : "Questo comando restituisce una pagina di un elenco di fogli di calcolo. Per ulteriori informazioni, consultare la documentazione per gli sviluppatori all'indirizzo https://developers.workiva.com/2026-01-01/getspreadsheets.html
Suggerimento: Per capire come compilare i campi "Header" e "Response", consulta la documentazione per sviluppatori relativa all'endpoint dell'API a cui ti stai collegando; in questo caso stiamo utilizzando l'endpoint " Get Spreadsheets ".
- Salva il comando.
Passo 4: Prova l'esercitazione
Ora che la Catena è completa, verifica il risultato.
- Pubblica la catena.
- Fare clic su " Esegui " e poi su " Esegui catena ".
- Una volta che la Chain ha completato l'esecuzione, dovresti vedere un elenco di fogli di calcolo nella scheda "Outputs" (Corpo della risposta del comando GET ) .