Context

L’oggetto globale Context: proprietà e metodi per accedere ai dati della transaction, inviare richieste HTTP e recuperare i segreti del tenant.

Context è un oggetto globale che rende disponibili i dati della transaction allo script della tua attività personalizzata, consente di inviare richieste HTTP, registrare messaggi personalizzati e recuperare i segreti del tenant.

​

Proprietà

Name	Type	Access	Description
Transaction	Transaction	Sola lettura	L’oggetto Transaction, che fornisce accesso alla transaction corrente e a tutti i documenti associati.
ErrorMessage	string	Lettura/scrittura	Messaggio di errore personalizzato. Il testo viene visualizzato nel Registro eventi della Transaction in Skill Monitor.

L’assegnazione di un valore a ErrorMessage interrompe la transaction.

​

Proprietà deprecate

Le proprietà InputData e OutputData sono deprecate. Utilizza invece Transaction.Documents.

Nome	Tipo	Accesso	Descrizione
InputData	Transaction.Documents	Sola lettura	Dati del documento durante l’esecuzione della skill.
OutputData	Transaction.Documents	Sola lettura	Dati del documento modificati. Non disponibili per External Export.

​

Metodi

​

CreateMultipartFormDataRequest

MultipartFormDataRequest CreateMultipartFormDataRequest();

Restituisce un oggetto MultipartFormDataRequest per inviare dati sotto forma di modulo contenente stringhe e file (multipart/form-data).

​

CreateHttpRequest

HttpRequest CreateHttpRequest();

Restituisce un oggetto HttpRequest per inviare una stringa, un file, un’immagine sorgente o un semplice modulo URL-form-encoded. Questo modulo non può contenere file.

​

LogMessage

void LogMessage(string msg);

Scrive un messaggio personalizzato nel registro eventi della Transaction.

​

GetSecret

string GetSecret(string secretName);

Restituisce il valore di una variabile d’ambiente del tenant di tipo secret. Usa questo metodo per passare token a servizi di terze parti senza inserirli direttamente nello script.

Per elencare i segreti disponibili nel tuo tenant, inizia a digitare Context.GetSecret( nell’editor di script e premi Ctrl + Space mentre il cursore si trova all’interno delle parentesi.

Se il nome della variabile contiene caratteri riservati (" o ,), esegui l’escape con una barra rovesciata nella chiamata al metodo. Solo gli utenti con il ruolo di Tenant Administrator possono creare, modificare o eliminare variabili d’ambiente. Per ulteriori informazioni, vedi Gestire le variabili d’ambiente.

​

Argomenti correlati

Attività personalizzata

Estendi gli skill con logica di scripting e integrazioni di terze parti.

Modello a oggetti

Riferimento completo agli oggetti JavaScript per gli script dell’Attività personalizzata.

Transaction

La transaction corrente e l’accesso a tutti i documenti associati.

Gestire le variabili d'ambiente

Archivia segreti a livello di tenant da passare alle attività Custom e Output.

Script di esempio

Esempi JavaScript per scenari comuni dell’Attività personalizzata.