Zum Hauptinhalt springen
Context ist ein globales Objekt, das Ihrem Skript für die Benutzerdefinierte Aktivität Vorgangsdaten zur Verfügung stellt, das Senden von HTTP-Anfragen und das Protokollieren benutzerdefinierter Meldungen ermöglicht sowie Secrets des Mandanten abruft.

Eigenschaften

NameTypZugriffBeschreibung
TransactionTransactionSchreibgeschütztDas Transaction-Objekt, das Zugriff auf den aktuellen Vorgang und alle zugehörigen Dokumente bietet.
ErrorMessagestringLesen/SchreibenBenutzerdefinierte Fehlermeldung. Der Text wird im Ereignisprotokoll der Transaction im Skill Monitor angezeigt.
Das Zuweisen eines Werts zu ErrorMessage unterbricht den Vorgang.

Veraltete Eigenschaften

Die Eigenschaften InputData und OutputData sind veraltet. Verwenden Sie stattdessen Transaction.Documents.
NameTypZugriffBeschreibung
InputDataTransaction.DocumentsSchreibgeschütztDokumentdaten während der Skill-Ausführung.
OutputDataTransaction.DocumentsSchreibgeschütztGeänderte Dokumentdaten. Für External Export nicht verfügbar.

Methoden

CreateMultipartFormDataRequest

MultipartFormDataRequest CreateMultipartFormDataRequest();
Gibt ein MultipartFormDataRequest-Objekt zum Senden von Daten als Formular mit Zeichenketten und Dateien (multipart/form-data) zurück.

CreateHttpRequest

HttpRequest CreateHttpRequest();
Gibt ein HttpRequest-Objekt zurück, mit dem eine string, eine Datei, ein Quellbild oder ein einfaches URL-form-encoded-Formular gesendet werden kann. Dieses Formular kann keine Dateien enthalten.

LogMessage

void LogMessage(string msg);
Schreibt eine benutzerdefinierte Nachricht in das Ereignisprotokoll der Transaction.

GetSecret

string GetSecret(string secretName);
Gibt den Wert einer Mandanten-Umgebungsvariablen vom Typ secret zurück. Verwenden Sie diese Methode, um Token an Drittanbieterdienste zu übergeben, ohne sie fest in Ihrem Skript zu hinterlegen.
Um die in Ihrem Mandanten verfügbaren Secrets aufzulisten, beginnen Sie im Skripteditor mit der Eingabe von Context.GetSecret( und drücken Sie Ctrl + Space, während sich der Cursor in den Klammern befindet.
Wenn der Variablenname reservierte Zeichen enthält (" oder ,), maskieren Sie sie im Methodenaufruf mit einem Backslash. Nur Benutzer mit der Rolle Tenant Administrator können Umgebungsvariablen erstellen, bearbeiten oder löschen. Weitere Informationen finden Sie unter Umgebungsvariablen verwalten.