Vai al contenuto principale
Una richiesta HTTP che contiene dati application/x-www-form-urlencoded, testo e dati binari.

Proprietà

NameTypeDescription
UrlstringL’url della risorsa.
MethodstringIl tipo di richiesta (ad esempio GET o POST).
AuthTokenstringToken di autenticazione (se è richiesta l’autenticazione del servizio esterno).
AuthSchemestringSchema di autenticazione.
ThrowExceptionOnFailedbooleanSpecifica 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.
TimeoutnumberTimeout 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).
ResponseTextstring, read-onlyRisultati della risposta in formato Testo.
ResponseTypestring, read-onlyIl tipo di risposta restituito dal servizio, ad es. “application/json”.
StatusnumberCodice 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

NameDescription
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);