Zum Hauptinhalt springen

Skripte

Ein Skript eignet sich für Berechnungen, Umwandlungen oder Verfahren, die sich mit normalen Aktionen nicht gut ausdrücken lassen. Ein Skript gehört zu seinem Workflow-Schritt. Quelltext, Eingaben und Fähigkeiten werden gemeinsam mit dem Workflow gespeichert und veröffentlicht.

Ein Skript konfigurieren​

Fügen Sie einen Skriptschritt hinzu, definieren Sie Eingabefelder und schreiben Sie JavaScript mit einem exportierten main(input, tools). Die Funktion muss direkt oder über ein Promise ein JSON-Objekt zurückgeben. Wählen Sie nur benötigte Werkzeuge und Datensatzzugriffe.

Definieren Sie beispielsweise eine erforderliche Texteingabe request_name und verwenden Sie:

export function main(input) {
return { task_title: `Prüfen: ${input.request_name}` };
}

Ordnen Sie den Anzeigenamen des Auslösers request_name zu. Ein folgender Schritt Aufgabe erstellen kann output.task_title im Titel verwenden. Achten Sie auf die Grenze von 255 Zeichen für den aufgelösten Aufgabentitel. Dieses Beispiel benötigt keine Werkzeuge.

Tourfold analysiert den Quelltext und leitet die Ausgabestruktur ab. Unvollständiger Code kann mit Diagnosehinweisen als Entwurf bleiben; die Veröffentlichung erfordert einen nachweisbaren Ausgabevertrag. Die Analyse führt den Code nicht aus. Tatsächliche Ausgabewerte werden bei der Ausführung erneut geprüft. Eine erfolgreiche Analyse garantiert daher nicht für jede Eingabe eine erfolgreiche Ausführung.

Gemeinsam mit dem Workflow veröffentlichen​

Veröffentlichen Sie den Workflow, um das Skript zusammen mit allen anderen Schritten festzuschreiben. Ändern Sie den Code in einem neuen Workflow-Entwurf und veröffentlichen Sie diesen. Bestehende Läufe behalten ihre ursprüngliche Konfiguration. Beim Kopieren eines Workflows oder einer Version wird die Skriptkonfiguration unabhängig kopiert.

Ein neues direkt eingebettetes Skript kann Zuordnungen vom vorherigen Schritt übernehmen. Kopierte Workflow-Versionen behalten ihre Eingabeverträge. Prüfen Sie Eingabezuordnungen bei Änderungen am umgebenden Ablauf.

Werkzeuge, Grenzen und Fehler​

Skripte können ausdrücklich erlaubte Werkzeuge zum Lesen, Anlegen, Aktualisieren und Abschließen von Aufgaben sowie zum Lesen, Aktualisieren und Erstellen/Aktualisieren von Datensätzen aufrufen. Verfügbare Werkzeuge beschreiben ihre Argumente und Ausgaben. Es gibt keinen allgemeinen Netzwerk-, Dateisystem- oder Zugangsdatenzugriff und keine beliebigen Modulimporte.

Die Ausführung ist begrenzt, unter anderem auf eine Sekunde Gast-CPU-Zeit, 25 Sekunden Gesamtlaufzeit und höchstens 16 erlaubte Werkzeugaufrufe. Platzieren Sie lange Abläufe nicht in einem einzigen Skript. Für beabsichtigte Wartezeiten verwenden Sie Workflow-Warteschritte.

Im Lauf sehen Sie angenommene Ein- und Ausgaben, begrenzte Protokolle, Fehler und gespeicherte Geschäftsergebnisse. Ein unterbrochenes Skript wird nicht automatisch von vorn gestartet, um seinen Speicherzustand wiederherzustellen. Frühere gespeicherte Aktionen bleiben bestehen, wenn späterer Code fehlschlägt. Prüfen Sie sie vor einem bewussten Neustart.

Die Vorschau führt keine Skripte aus. Quelltext-, Schema- und Werkzeugdetails stehen in der Skript-API-Referenz (Englisch).