Casa
Ottieni Community Edition GRATUITAMENTE
ACCEDI
Leggi e rivedi la documentazione di Automation Anywhere

Automation Anywhere Automation 360

Chiudi contenuti

Contenuti

Apri contenuti

REST Web Service package

  • Aggiornato: 2022/02/20
    • Automation 360 v.x
    • Crea
    • Spazio di lavoro RPA

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:
    1. Inserisci una action Loop dopo action REST Web Service.
    2. Seleziona l'iteratore Per ogni chiave del dizionario.
    3. Nel campo Variabile Dizionario, seleziona la variabile che contiene l'output action REST Web Service.
    4. Assegna il valore di ogni chiave a $prompt-assignment$.
    5. Inserisci un'action Log To File.
    6. Indica il percorso del file a un file di testo per contenere l'elenco dei nomi di intestazione.
    7. Inserisci $prompt-assignment$ nel campo Inserisci testo da registrare.
    8. Seleziona l'opzione Sovrascrivi file esistente.
    9. 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:

  • la lunghezza dell'URI è limitata a 2048 caratteri.
  • Tutti i parametri vengono passati nell'URI.
  • Il metodo GET espone i dati presenti nell'URI, rendendolo meno sicuro rispetto al metodo POST.
  • Il metodo GET non modifica alcun dato, rendendolo sicuro per tutti gli utenti indipendentemente dall'autorizzazione.
Metodo patch Modifica la risorsa identificata dall'URI.
metodo POST Crea una nuova risorsa nell'URI.
  • I parametri vengono passati nel corpo della richiesta.
  • Non esiste un limite di lunghezza per un corpo della richiesta.
metodo PUT Aggiorna o sostituisce una risorsa in base ai parametri passati nell'URI o nel corpo.
Invia feedback