5.7.3 Verwenden der Makro-API

Makros werden in Host Access for the Cloud mit JavaScript aufgezeichnet und geschrieben. JavaScript ist eine beliebte und gängige Programmiersprache. Für die Sprache steht Ihnen eine Vielzahl an Lernressourcen und Werkzeugen zur Verfügung.

Die Makro-API setzt sich aus einer Reihe von Objekten zusammen, über die Sie mit dem Host interagieren, auf Bildschirmstatus warten und mit dem Benutzer interagieren können.

Informationen zu promises und yields

Da JavaScript in einem einzelnen Thread läuft und für die Verwaltung der Ausführung „Callback-Funktionen“ und „Zusagen“ verwendet, ist der Code möglicherweise schwer nachvollziehbar. Host Access for the Cloud verbindet das Konzept von „Zusagen“ mit dem „yield“-Schlüsselwort, damit Makrocode linear organisiert werden kann.

  • Promises

    Promises sind Muster zur Vereinfachung von Funktionen, die an einem in der Zukunft liegenden Punkt Ergebnisse asynchron zurückgeben. Alle Funktionen der Typen „wait“ und „ui“ in der Makro-API geben „promise“-Objekte zurück.

  • Yield

    Makros verwenden das „yield“-Schlüsselwort, um die Ausführung des Makros zu blockieren, bis ein „promise“-Objekt aufgelöst oder ausgeführt wurde. Wenn also 'yield' vor einer beliebigen 'wait'- oder 'ui'-Funktion gesetzt wird, wird die Ausführung des Makros angehalten, bis die Ausführung dieser Funktion abgeschlossen ist. Sie können das 'yield'-Schlüsselwort vor jeder Funktion platzieren, die 'promise' zurückgibt, also auch für Ihre benutzerdefinierten Funktionen.

HINWEIS:Die Funktion zum Blockieren der Makroausführung durch die Kombination von 'yield' und 'promises' wird in der Funktion createMacro() aktiviert.

Fehlermeldungen

Fehler werden in Makros mithilfe der 'try / catch'-Anweisung behandelt. Einige der API-Funktionen können Fehler ausgeben, wenn beispielsweise Bedingungen nicht erfüllt werden können oder eine Zeitüberschreitung eintritt. Der ausgegebene Fehler wird in die 'catch'-Anweisung aufgenommen. Sie können kleinere Codeblöcke in einer 'try / catch'-Anweisung umbrechen, um Fehler detaillierter zu behandeln. Makro-Entwickler können Fehler auch über 'throw new Error('Helpful error message'); ausgeben.

Verwandte Themen