Esempio di utilizzo di REST Web Service actions
Utilizza il metodo Get (Ottieni), Post (Pubblica) e Put (Inserisci) actions per REST Web Service package inviare richieste a e ricevere risposte da un'API REST. In questo esempio, recupererai un elenco di tutto l'inventario disponibile, effettuerai un ordine per un articolo e aggiornerai lo stato dell'articolo in "venduto".
Questo esempio utilizza gli endpoint dell'API di esempio Swagger Petstore per dimostrare come utilizzare actions per inviare richieste e recuperare il corpo della risposta.
Procedura
-
Apri un nuovo bot:
- Da Control Room, seleziona Bot > I miei bot.
- Fai clic su Crea nuovo > bot.
- Nella finestra Crea Task Bot, immetti un nome per il bot.
-
Accetta la posizione predefinita della cartella \Bot\.
Per cambiare la posizione in cui viene memorizzato il bot, fai clic su Scegli e segui i prompt.
- Fai clic su Crea e modifica.
-
Utilizza il metodo Get (Ottieni) action per recuperare un elenco di tutti gli animali domestici disponibili.
- Fare doppio clic o trascinare il metodo > REST Web ServicesGet action.
-
Immettere il seguente URI:
https://petstore.swagger.io/v2/pet/findByStatus?status=available
-
Fornire i dettagli dell'autorizzazione nella tabella Custom headers (Intestazioni personalizzate).
- Nella colonna Name (Nome), immettere
- Nella colonna Value (Valore), immettere
- Nella colonna Name (Nome), immettere
-
Creare la variabile
dOutput
nel campo Assign the output to a variable (Assegna l'output a una variabile).
-
Inserire un log nel file action per visualizzare il corpo della risposta.
- Fare doppio clic o trascinare il Log su file action.
- Fornire il percorso del file a un file di testo.
-
Nel campo Immettere il testo da registrare, immettere
{Body}$Output$
.
-
Fare clic su Salva, quindi su Esegui.
Il bot recupera il corpo della risposta e lo salva nel file di testo.
- Disabilitare il file Log to action.
-
Utilizza il metodo Post action per effettuare un ordine per un animale domestico.
- Fare doppio clic o trascinare il metodo > REST Web ServicesPost action.
-
Immettere il seguente URI:
https://petstore.swagger.io/v2/store/order
-
Fornire i dettagli dell'autorizzazione nella tabella Custom headers (Intestazioni personalizzate).
- Nella colonna Name (Nome), immettere
- Nella colonna Value (Valore), immettere
- Nella colonna Name (Nome), immettere
- Aprire il file di registro e copiare l'ID animale domestico della prima voce.
-
Copiare e incollare quanto segue nel campo Custom parameters (Parametri personalizzati), sostituendo il testo tra parentesi angolari con il valore copiato dal file :
{ "petId": <PetID>, "quantity": 1, "shipDate": "2020-06-10T17:32:54.219Z", "status": "placed", "complete": true }
-
Inserire la variabile
dOutput
nel campo Assign the output to a variable (Assegna l'output a una variabile).
-
Inserire una casella Messaggio action per visualizzare il corpo della risposta.
- Fare doppio clic o trascinare la finestra di messaggio action.
- Fornire il percorso del file a un file di testo.
-
Nel campo Immettere il testo da registrare, immettere
{Body}$Output$
.
-
Fare clic su Salva, quindi su Esegui.
Il bot recupera il corpo della risposta e lo stampa nella casella Messaggio. Una risposta corretta include "stato":"posizionato","completato":vero.
-
Utilizzare il metodo Put action per aggiornare il nome dell'animale domestico in "Pluto" e lo stato dell'animale domestico in "venduto".
- Fare doppio clic o trascinare il metodo > REST Web ServicesPut action.
-
Immettere il seguente URI:
https://petstore.swagger.io/v2/pet
-
Fornire i dettagli dell'autorizzazione nella tabella Custom headers (Intestazioni personalizzate).
- Nella colonna Name (Nome), immettere
- Nella colonna Value (Valore), immettere
- Nella colonna Name (Nome), immettere
- Attivare il file di registro e copiare l'ID animale domestico della prima voce.
-
Copiare e incollare quanto segue nel campo Custom parameters (Parametri personalizzati), sostituendo il testo tra parentesi angolari con il valore copiato dal file :
{ "petId": <PetID>, "name": "Pluto", "status": "sold" }
-
Inserire la variabile
dOutput
nel campo Assign the output to a variable (Assegna l'output a una variabile).
-
Spostare la casella Messaggio action sotto il metodo actionInserisci:
- Fare doppio clic o trascinare la finestra di messaggio action.
- Fornire un percorso di file a un file di testo.
-
Nel campo Immettere il testo da registrare, immettere
{Body}$Output$
.
-
Fare clic su Salva, quindi su Esegui.
Il bot recupera il corpo della risposta e lo stampa nella casella Messaggio. Una risposta corretta include "nome":"Pluto","stato":"venduto".