Teile dieser Seite wurden möglicherweise maschinell übersetzt.

JavaScript-Modulreferenz

Wer kann das nutzen?

Pläne:

  • Bridge by Smartsheet

Smartsheet Bridge-Dienstprogramme: JavaScript

Das JavaScript-Dienstprogramm in Bridge umfasst nur ein Modul: Run Script. Verwenden Sie dieses Modul, um JavaScript-Funktionen zu schreiben und die von Ihnen erstellten Funktionen zu starten.

JavaScript-Dienstprogramm einrichten

  1. Melden Sie sich bei Bridge an.
  2. Öffnen Sie die Seite Integrations.
  3. Suchen Sie nach JavaScript und wählen Sie es aus.

Modul Skript ausführen

Das Modul enthält die folgenden Felder, in denen Sie Datenreferenzen verwenden können:

  • Script Name:Der Name des auszuführenden Skripts.
  • Script Parameters:Die Parameter, die das Skript beim Ausführen erwartet, dargestellt als Zuordnung von Schlüssel-Wert-Objekten.
    • Key: Der Parametername, der im Skript angezeigt wird.
    • Value: Der Wert, der dem Schlüssel zugewiesen ist, den das Skript beim Ausführen verwendet.

Die Anzahl der zulässigen Skriptparameter ist unbegrenzt und wird dynamisch hinzugefügt.

Um das Skript einzurichten, das Sie ausführen möchten:
  1. Wählen Sie das Zahnradsymbol oben im Modul aus.
  2. Erweitern Sie den Bereich Scripts.
  3. Wählen Sie Add to Scripts. aus.
  4. Füllen Sie die Felder Script Name und Script Body aus.
  5. Wählen Sie Speichern aus.
Javascript modules

Wenn Bridge das Modul Run Script ausführt, sind im Bereich Run Log die folgenden Informationen verfügbar:

  • Data
    • result: Die JavaScript-Ausgabe
  • State: Bereich, der angibt, ob das Modul funktioniert hat
    • Code: der Erfolgs-/Fehlercode, den das Modul aus Smartsheet
    • Message: eine Systemmeldung, die das Modul aus Smartsheet abruft. Beispiel: Wenn das Modul einen Wert nicht finden kann, lautet die Meldung Not found.
    • Status: der Status, den das Modul aus Smartsheet abruft. Die Statusbezeichnungen, die Sie möglicherweise sehen, sind Succeeded und Failed.

Beispiele

Beispiel 1: Hello world

  1. Erstellen Sie ein Skript, in dem der Script Body ist: return “Hello” + a.

Sie müssen return in jedes Skript eingeben, um eine Ausgabe zu erhalten.

  1. Fügen Sie im Modul den Parameter a mit dem Wert world hinzu.
  2. Workflow ausführen:

Stellen Sie sicher, dass der Key im Modulgenerator mit dem Parameter im Feld Script Body übereinstimmt. 

Value ist die austauschbare Eingabe. Diese kann z. B. aus der Ausgabe einer früheren Modulantwort stammen.

Der Script Name benötigt keine Anführungszeichen für Zeichenfolgen-Eingaben, aber der Script Body benötigt sie. Andernfalls erhalten Sie eine Fehlermeldung.

Beispiel 2: Grundlegende Operationen

Um zwei Zeichenfolgen zu verketten:
  1. Erstellen Sie ein Skript mit dem Script Body: return a + b.
  2. Fügen Sie im Modul die Parameter a und b mit den Werten 3 und 2, hinzu. 
  3. Workflow ausführen:
Javascript modules

Diese Methode verknüpft die beiden Werte, addiert sie jedoch nicht. 

Javascript modules

Variablen, die über Bridge festgelegt werden, werden als Zeichenfolgen behandelt.

Um Zahlen zu summieren:
  1. Erstellen Sie ein Skript mit dem Script Body Feld: return Number(a) + Number(b).
  2. Workflow ausführen:

Mit denselben Parametern wie im Beispiel unten beträgt das Ergebnis diesmal 5.

Javascript modules

Beispiel 3: Iteration über ein Array

Für dieses Beispiel haben wir einen Workflow mit dem Modul List Sheets. Wenn der Workflow ausgeführt wird, liefert das Ausführungsprotokoll die untenstehenden Ausgaben, wobei data als Array [100]markiert ist. Das bedeutet, dass das Feld ein Array ist.

Javascript modules

Sie müssen den Workflow ausführen, um die Informationen aus dem Ausführungsprotokoll zu erhalten.

  1. Wählen Sie die drei Punkte neben dataaus, und wählen Sie dann Copy Data Reference.
Javascript modules
  1. Fügen Sie ein neues Run Script-Modul zum Workflow hinzu.
  2. Erstellen Sie ein neues JavaScript-Skript. Für dieses Beispiel nennen wir es getFirstElementOfListSheets, und der Script Body ist returnlistSheets[0]. Dies gibt das erste Element des Datenarrays zurück.

Die Zahl in den eckigen Klammern definiert, welches Array-Element zurückgegeben wird. 0 gibt das erste zurück, 1 gibt das zweite zurück, und so weiter.

Im JavaScript-Modul:

  1. Setzen Sie getFirstElementOfListSheets als den Skriptname.
  2. Fügen Sie einen Skriptparameter mit Key #1 hinzu, der listSheetsgenannt wird.
  3. Fügen Sie den in Schritt 1 kopierten Datenverweis in Value #1ein.
Javascript modules

Wenn wir den Workflow ausführen, liefert das Ausführungsprotokoll die untenstehenden Ausgaben. 

Javascript modules

Die untenstehenden Elemente result sind Teil des ersten Elements im Array.

Produkt-/Funktionseinschränkungen

  • Sie können nur 6 MB Nutzlastanforderungen und -antworten verarbeiten.

    Das wird sich mit den nächsten Upgrades ändern.

  • Es gibt keine Skriptvalidierung bei der Skripterstellung. Wenn ein Skript fehlerhaft ist, muss der Entwickler alle Probleme und Fehler debuggen/beheben, die beim Ausführen des Skripts zurückgegeben werden.
  • Sie können Skriptversionen und -verlauf nicht verfolgen oder verwalten.
  • Smartsheet Bridge eignet sich für Ereignisse oder Workflows mit festem Zeitplan. Es ist kein Ersatz für die Funktionalität der unidirektionalen oder bidirektionalen Synchronisierung (Spiegelung), die Connectors bereitstellen. Smartsheet Bridge beachtet keine Reihenfolgen und speichert keine Informationen zu Statusänderungen in den verschiedenen Systemen. Connector-artige Setups sind unzuverlässig und werden dringend abgeraten.