REST Web Service package
Utilizza actions in REST Web Service package come metodi (DELETE, GET, PATCH, POST o PUT) per inviare richieste a e ricevere risposte da un'API.
Lavorare con REST Web Service actions
Fornisci le seguenti informazioni per inviare una richiesta REST e ricevere una risposta. Non tutti i parametri sono richiesti per tutti i metodi.
- URI: un indirizzo univoco per una risorsa API.
- Modalità di autenticazione: sono disponibili tre modalità di autenticazione supportate:
- Base: le stringhe di testo possono essere utilizzate per l'autenticazione di base.
- Utente AD connesso: gli utenti di Active Directory (AD) autorizzati ad accedere all'API correlata vengono autenticati tramite AD. Nella richiesta non sono richieste le credenziali.
- Autenticazione Windows NT LAN Manager (NTLM) (Utente AD): un metodo di autenticazione di sfida/risposta che consente ai client di fornire il proprio nome utente e password come credenziali crittografate o testo normale. Ti consigliamo di utilizzare le credenziali archiviate in Automation Anywhere Credential Vault.
- Intestazione: non tutti i metodi richiedono un'intestazione. Le intestazioni rappresentano i metadati associati alla richiesta.Nota: Per utilizzare una chiave API nella richiesta, immetti
chiave_api
nel campo Nome dell'intestazione e il valore della chiave nel campo Valore. - Risposta di errore di acquisizione: seleziona la casella di controllo per acquisire la risposta di errore tranne che per la risposta Operazione riuscita/Ok. I dettagli della risposta di errore vengono acquisiti nel corpo della risposta.
- Consenti connessione non sicura durante l'utilizzo di https: seleziona la casella di controllo per consentire la connessione non sicura quando usi https.
- Tipo di contenuto: quando un'intestazione contiene un tipo di contenuto, definisce la negoziazione del contenuto tra il client e il server. actions REST Web Service supporta i seguenti tipi di contenuto:
- applicazione/json
- applicazione/xml
- testo/normale
- testo/html
- testo/xml
- multiparte/dati modulo
- Attendi il completamento dell'azione: puoi impostare un valore di time-out quando invii una richiesta REST e ricevi una risposta. Quando esegui actions come POST, PUT, DELETE, PATCH e GET, nel campo Attendi il completamento dell'azione puoi specificare il tempo di attesa (in millisecondi). Per impostazione predefinita, il tempo di attesa è di 60.000 millisecondi.
- Variabili di output: l'output della risposta viene acquisito in una variabile dizionario. Una variabile dizionario è una coppia chiave-valore. Utilizza il nome dell'intestazione della risposta come chiave per restituire il valore dell'intestazione, o "Corpo" come chiave per restituire il corpo della risposta.Nota: La chiave di risposta con il relativo valore è disponibile nella variabile dizionario per visualizzare lo stato di risposta dell'API REST.Per ottenere un elenco dei nomi di intestazione per la risorsa API, esegui queste operazioni:
- Inserisci una action Loop dopo action REST Web Service.
- Seleziona l'iteratore Per ogni chiave del dizionario.
- Nel campo Variabile Dizionario, seleziona la variabile che contiene l'output action REST Web Service.
- Assegna il valore di ogni chiave a
$prompt-assignment$
. - Inserisci un'action Log To File.
- Indica il percorso del file a un file di testo per contenere l'elenco dei nomi di intestazione.
- Inserisci
$prompt-assignment$
nel campo Inserisci testo da registrare. - Seleziona l'opzione Sovrascrivi file esistente.
- Fai clic su Salva.
Quando esegui bot, vengono stampati i nomi di intestazione dalla risorsa API al file selezionato.
Passaggio dei valori in modo sicuro
Puoi passare in modo sicuro i valori dal Credential Vault al servizio web specificando locker, le credenziali e l'attributo nei seguenti campi action supportati:
- URI
- Intestazioni personalizzate
- Corpo: Per il tipo di contenuto
application/x-www-form-urlencoded
, fai clic su Aggiungi parametro per selezionare il valore da Credential Vault.Per tutti gli altri tipi di contenuto, seleziona l'opzione Seleziona credenziali come parametri e fai clic su Seleziona.
Actions nel package REST Web Service
Action | Descrizione |
---|---|
Elimina metodo | Rimuove la risorsa identificata dall'URI. |
metodo Get | Recupera le informazioni identificate dai parametri inclusi nell'URI. Non esiste alcun Tipo di contenuto per il metodo GET, perché tutti i parametri vengono passati come parte dell'URI. I limiti e le caratteristiche del metodo GET includono quanto segue:
|
Metodo patch | Modifica la risorsa identificata dall'URI. |
metodo POST | Crea una nuova risorsa nell'URI.
|
metodo PUT | Aggiorna o sostituisce una risorsa in base ai parametri passati nell'URI o nel corpo. |