Proprietà
| Name | Type | Description |
|---|---|---|
| Url | string | L’url della risorsa. |
| Method | string | Il tipo di richiesta (ad esempio GET o POST). |
| AuthToken | string | Token di autenticazione (se è richiesta l’autenticazione del servizio esterno). |
| AuthScheme | string | Schema di autenticazione. |
| ThrowExceptionOnFailed | boolean | Specifica se generare un’eccezione quando il servizio esterno restituisce un codice di errore come stato della risposta HTTP (cioè al di fuori dell’intervallo 200-299). Se impostata su False, non vengono generate eccezioni quando un servizio esterno restituisce un codice di errore come stato della risposta HTTP. Per visualizzare lo stato del codice di risposta HTTP, controllare il valore della proprietà Status. Impostata su True per impostazione predefinita. Importante! Se la risposta contiene un codice di errore, ciò implica che il servizio esterno è operativo e sta inviando risposte alle richieste. Se si verifica un errore relativo alla disponibilità del servizio o alla connessione Internet durante l’invio di una richiesta HTTP, verrà generata un’eccezione dell’applicazione indipendentemente dal valore di questa proprietà, perché in questo caso non è disponibile alcun codice di stato HTTP del servizio esterno. |
| Timeout | number | Timeout della richiesta in minuti. Impostato su 1 minuto per impostazione predefinita. Importante! Il valore del timeout della richiesta non può superare la restrizione sul tempo di esecuzione dello script (600 secondi). |
| ResponseText | string, read-only | Risultati della risposta in formato Testo. |
| ResponseType | string, read-only | Il tipo di risposta restituito dal servizio, ad es. “application/json”. |
| Status | number | Codice di stato della risposta HTTP del servizio esterno. Se ThrowExceptionOnFailed è impostata su True, un codice di errore genererà un’eccezione e la Transaction verrà interrotta. Il testo del messaggio di errore può essere visualizzato in Skill Monitor. |
Metodi
| Name | Description |
|---|---|
| SetHeader(string name, string value); | Imposta intestazioni HTTP aggiuntive per la richiesta. Questo metodo va chiamato per ogni intestazione. |
| Send(); | Invia la richiesta HTTP. |
| SetFileContent(DocumentExportResult documentExportResult, string mediaType?); | Inizializza una richiesta HTTP basata su flusso, consentendo di passare i dati esportati come file. Il tipo di contenuto viene impostato automaticamente in base all’estensione del file esportato, ad esempio application/json, application/pdf. Se necessario, il tipo di contenuto può essere impostato in anticipo utilizzando il parametro facoltativo mediaType. |
| SetFileContent(BinaryFile binaryFile, string mediaType?); | Inizializza una richiesta HTTP basata su dati binari, passando il file immagine di origine importato alla creazione della transaction oppure l’immagine contenuta nel field di tipo Picture. Il tipo di contenuto viene impostato automaticamente in base all’estensione del file importato. Se necessario, il tipo di contenuto può essere impostato in anticipo utilizzando il parametro facoltativo mediaType. |
| SetSourceFileContent(string mediaType?); | Inizializza una richiesta HTTP basata su dati binari, consentendo di passare il file immagine di origine importato alla creazione della transaction. Il tipo di contenuto viene impostato automaticamente in base all’estensione del file importato. Se necessario, il tipo di contenuto può essere impostato in anticipo utilizzando il parametro facoltativo mediaType. Importante! Questo metodo è obsoleto. Avrà accesso solo al primo file della transaction. Usa invece il metodo SetFileContent(). |
| SetStringContent(string content, ContentEncoding contentEncoding?, string mediaType?); | Inizializza una richiesta HTTP basata su string. Per impostazione predefinita, Content-Type è impostato su application/json con codifica UTF-8. Se necessario, è possibile modificare sia il contenuto sia i tipi di codifica. |
| SetUrlFormEncodedContent(any content); | Inizializza il contenuto per una richiesta basata su oggetto JavaScript e lo codifica come application/x-www-form-urlencoded. L’oggetto JavaScript deve essere inizializzato come un semplice set di proprietà, ad esempio: var form = {}; form.grant_type = "password"; form.scope = "openid permissions"; form.client_id = "value of client_id"; form.client_secret = "value of client_secret"; form.password = "Password"; form.username = "User Name"; request.SetUrlFormEncodedContent(form); |