Leggi e rivedi la documentazione di Automation Anywhere

Automation Anywhre Automation 360

Chiudi contenuti

Contenuti

Apri contenuti

Servizio web REST pacchetto

  • Aggiornato: 12/01/2020
    • Automation 360 v.x
    • Crea
    • Spazio di lavoro RPA

Servizio web REST pacchetto

Utilizza azioni in Servizio web REST pacchetto come metodi (DELETE, GET, PATCH, POST o PUT) per inviare richieste a e ricevere risposte da un'API .

Utilizzo di Servizio web REST azioni

Fornire 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:
    • Informazioni di 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 credenziali.
    • Autenticazione Windows NT LAN Manager (NTLM) (utente AD): Un metodo di autenticazione Challenge/Response 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 Anywhre Archivio credenziali.
  • Intestazione: Non tutti i metodi richiedono un'intestazione. Le intestazioni rappresentano i metadati associati alla richiesta.
    Nota: Per utilizzare una chiave API nella richiesta, immettere api_key nel campo Name (Nome) dell'intestazione e il valore della chiave nel campo Value (Valore).
  • Risposta di errore di acquisizione: Selezionare la casella di controllo per acquisire la risposta di errore tranne che per la risposta di Success/Ok. I dettagli della risposta di errore vengono acquisiti nel corpo della risposta.
  • Tipo di contenuto: Quando un'intestazione contiene un tipo di contenuto, definisce la negoziazione del contenuto tra il client e il server. Servizio web REST azioni supporta i seguenti tipi di contenuto:
    • applicazione/json
    • applicazione/xml
    • testo/semplice
    • testo/html
    • testo/xml
  • Variabile di uscita: L'output della risposta viene acquisito in una variabile del 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 del dizionario per visualizzare lo stato di risposta dell'API REST.
    Per ottenere un elenco dei nomi di intestazione per la risorsa API, esegui questi passaggi:
    1. Inserire un Ciclo azione dopo . Servizio web REST azione
    2. Selezionare Per ogni tasto nell'iteratore del dizionario.
    3. Nel campo Variabile Dizionario, selezionare la variabile che contiene Servizio web REST azione l'output.
    4. Assegnare il valore di ogni chiave a $prompt-assignment$.
    5. Inserire un Registra nel file azione.
    6. Fornire il percorso del file a un file di testo per contenere l'elenco dei nomi di intestazione.
    7. Inserire $prompt-assignment$ nel campo Inserisci testo da registrare.
    8. Selezionare l'opzione Sovrascrivi file esistente.
    9. Fare clic su Salva.

      Quando esegui bot, vengono stampati i nomi di intestazione dalla risorsa API al file selezionato.

Passaggio sicuro dei valori

Puoi passare in modo sicuro i valori dal Archivio credenziali al servizio Web specificando armadietto, le credenziali e l'attributo nei seguenti azione campi supportati:
  • URI
  • Intestazioni personalizzate
  • Corpo: Per il tipo di contenuto application/x-www-form-urlencoded, fare clic su Add parameter (Aggiungi parametro) per selezionare il valore da Archivio credenziali.

    Per tutti gli altri tipi di contenuto, selezionare l'opzione Seleziona credenziali come parametri e fare clic su Scegli.

Azioni nel Servizio web REST pacchetto

Azione Descrizione
Elimina metodo Rimuove la risorsa identificata dall'URI.
Ottieni metodo Recupera le informazioni identificate dai parametri inclusi nell'URI. Non esiste un 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.
  • GET non modifica alcun dato, rendendolo sicuro per tutti gli utenti indipendentemente dall'autorizzazione.
Metodo patch Modifica la risorsa identificata dall'URI.
Pubblica metodo 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.
Inserisci metodo Aggiorna o sostituisce una risorsa in base ai parametri passati nell'URI o nel corpo.
Invia feedback