Centro assistenza di Workiva

Vuoi collegarti a un'applicazione di terze parti al di là dei connettori Premium precostituiti di Workiva? Puoi ottenere questo risultato utilizzando i comandi del connettore di richiesta HTTP per interagire con le API REST. 

Nota: Sebbene sia etichettato come Richiesta HTTP, HTTPS (Secure HTTP) è supportato (e consigliato).

In questo Percorso Didattico Collegato, aggiorneremo la nostra Catena per utilizzare gli Input Runtime in cui possiamo specificare quale foglio di calcolo vogliamo recuperare.

Passo 1: Copiare e modificare una catena

1. Naviga in Chain Builder e individua la catena CLP | HTTP Request List Spreadsheets.
2. Clicca sull'ellisse verticale per Copiare la catena.
3. Clicca sull'icona della matita per modificare la catena.
4. Clicca su Impostazioni della catena in alto a destra e rinomina la catena: CLP | Richiesta HTTP Ottieni un singolo foglio di calcolo.
5. (Opzionale) 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."
6. Salva la Catena.

Passo 2: Ingressi di Runtime

Utilizza l'evento Runtime Inputs Chain Event 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.

1. Sposta il comando POST - Retrieve a Token dal nodo iniziale.
2. Aggiungi un evento a catena Runtime Inputs da Chain Trigger Events al nodo iniziale.
3. Fai doppio clic sul collegamento che unisce Runtime Inputs al comando Get - List Spreadsheets e elimina il collegamento.
4. Collega Runtime Inputs al comando POST - Recupera un token.

5. Collega il Comando POST - Retrieve a Token al Comando GET - List Spreadsheets.

   

6. Fai doppio clic sull'evento a catena Runtime Inputs per configurarlo.
7. Clicca su Add Input e configura i seguenti campi:
   • Tipo: Campo di testo
   • Nome visualizzato: ID del foglio di calcolo - consulta questo documento per trovare l'ID
   • Obbligatorio: Contrassegnare questa casella di controllo
8. (Opzionale) Inserisci una Descrizione: "Questo comando permette all'utente di specificare i valori degli input richiesti per il runtime."
9. 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.

1. Fai doppio clic sul comando Ottieni - Elenco dei fogli di calcolo per configurarlo.
   1. Dai un nome al comando: Get - Recupera un singolo foglio di calcolo.

   2. Usa la variabile Spreadsheet ID da Runtime Inputs nel campo URL per specificare quale foglio di calcolo recuperare.
      A tal fine, clicca sul campo URL e dopo /spreadsheets aggiungi "/<>",
      sostituendo <Spreadsheet> con la variabile da Runtime Inputs come segue:

      

      1. Nel pannello di sinistra, espandi il menu a tendina Trigger.
      2. Espandi il menu a tendina Runtime Inputs.
      3. Seleziona la variabile Spreadsheet ID.

2. (Opzionale) Inserisci una Descrizione: "Questo comando restituisce un singolo foglio di calcolo. Per ulteriori informazioni, consulta la documentazione per gli sviluppatori all'indirizzo https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/".
3. Salva il comando.

Passo 4: Prova l'esercizio

Ora che la Catena è completa, possiamo testare il risultato.

1. Pubblica la Catena.
2. Clicca su Execute, quindi su Run with Inputs.
3. Trova un foglio di calcolo con ID, navigando verso un foglio di calcolo nella Piattaforma Workiva.  Assicurati che l'utente che ha concesso l'autorizzazione a questo foglio di calcolo.
4. Clicca su Avvia.
5. Una volta completata l'esecuzione della catena, puoi vedere che i dettagli del foglio di calcolo sono stati generati nella scheda Outputs - Response Body del comando Get.

To continue to challenge yourself and learn more about using the HTTP Request Connector to connect to a third party API, check out the next exercise CLP Copy a Spreadsheet (add link when document created).