Mashup-Parameter konfigurieren
Sie können Parameter für Ihre Mashups erstellen und konfigurieren. Diese Parameter sind bindbare Quellen und Ziele, die über das Ereignis Parameter Value Changed verfügen. Die folgenden Felder sind verfügbar, um Mashup-Parameter zu konfigurieren:
• Name: Name des Parameters.
• Basistyp:
Basistypen für Felddefinitionen
Basistyp | Beschreibung |
---|
BOOLEAN | Der Wert "true" oder "false". |
DASHBOARDNAME | Der Name eines Dashboards |
DATASHAPENAME | Ein Verweis auf einen Data Shape im Modell; erfährt daher eine spezielle Verarbeitung. |
DATETIME | Eine formatierte Datums-/Zeitangabe. |
HTML | HTML-Inhalt. |
HYPERLINK | Eine Standard-URL (z.B. www.thingworx.com). |
IMAGE | Binärdaten, die als Bild gerendert werden können. |
IMAGELINK | Ein URL-Link zu einem Bild. |
INFOTABLE | Eine Standarddarstellung von Daten in ThingWorx, die einem SQL-Ergebnissatz ähnelt. Es gibt eine Reihe integrierter Dienste für das Erstellen, Verwenden und Analysieren einer Infotable. |
INTEGER | Eine Zahl, die ohne Nachkommastelle geschrieben werden kann. |
JSON | Eine JavaScript Object Notation-Zeichenfolge. | Für ThingWorx 8.4.0 und höhere Versionen. |
|
LOCATION | Standardkoordinate des World Geodetic System 1984 (WGS 84), ausgedrückt als [Längengrad, Breitengrad], Höhe. |
LONG | Der Typ LONG sollte verwendet werden, wenn ein längerer Bereich als der vom Basistyp INTEGER bereitgestellte erforderlich ist. |
MASHUPNAME | Ein Verweis auf ein ThingWorx Mashup; daher spezielle Verarbeitung. |
NOTHING | Enthält nichts (ungültig). |
NUMBER | Eine Zahl. | Exponentialwerte sind zulässig. Beispielsweise 123e45. |
|
PASSWORD | |
QUERY | Ein JSON-Objekt, das ein Array von "Filtern" enthält. Jeder Filter sollte "value", "type" und "fieldname" enthalten. |
SCHEDULE | Ein cron-basierter Zeitplan (mithilfe des Zeitplan-Editors konfiguriert). |
STRING | Eine beliebige Anzahl alphanumerischer Zeichen. |
STYLETHEMENAME | Ein Verweis auf ein Stilthema; erfährt daher eine spezielle Verarbeitung. |
TAGS | ThingWorx Tag-Werte. |
TEXT | Eine beliebige Anzahl alphanumerischer Zeichen. Der Unterschied zu STRING besteht darin, dass TEXT indiziert ist. |
THINGNAME | Ein Verweis auf ein Ding; erfährt daher eine spezielle Verarbeitung |
THINGSHAPENAME | Ein Verweis auf eine Dingform im Modell; erfährt daher eine spezielle Verarbeitung |
THINGTEMPLATENAME | Der Name einer Dingvorlage |
TIMESPAN | Ein TimeSpan-Objekt stellt ein Zeitintervall (Dauer oder verstrichene Zeit) dar, das als positive oder negative Anzahl von Tagen, Stunden, Minuten, Sekunden gemessen wird. |
USERNAME | Ein Verweis auf einen ThingWorx Benutzer, der im System definiert ist. |
XML | Ein XML-Ausschnitt oder -Dokument. |
• Bindungsrichtung: Quelle, Ziel oder beide.
• Tooltip: Text, der dem Mashup-Parameter als Tooltip hinzugefügt und mit dem Mauszeiger angezeigt wird.
• Aufgabenliste anzeigen: Bei Auswahl dieser Option werden Erinnerungen angezeigt, dass zusätzliche Schritte erforderlich sind, um die Parameter im enthaltenen Mashup zu konfigurieren.
• Löschen: Entfernt den Mashup-Parameter.
• Benutzerdefiniertes Konfigurations-Formular hinzufügen: Fügt ein Mashup als benutzerdefinierte Konfiguration hinzu.
Verbesserungen für ThingWorx 8.4.X und höhere Versionen
Die folgenden Verbesserungen werden zur Konfiguration der Mashup-Parameter vorgenommen:
• Sie können den Basistyp auf JSON festlegen.
Diese Funktion bietet fortgeschrittenen Entwicklern viel Flexibilität. Der JSON-Editor wird bereitgestellt, damit der Benutzer JSON eingeben kann.
• Sie können einem Parameter den InfoTable-Typ zuweisen, ohne den Data Shape zuzuweisen.
Der Data Shape ist für ThingWorx 8.3.X und frühere Versionen obligatorisch. Für 8.4.X und höhere Versionen ist es nicht obligatorisch, wodurch mehr Flexibilität gegeben ist. Dadurch können verschiedene Data Shapes für das Mashup bereitgestellt werden.
• Sie können die Bindungsrichtung des Parameters steuern: "←" (Quelle), "→" (Ziel) und "↔" (Beide).
Bei 8.3.X und früheren Versionen ist der Parameter immer auf die Richtung "Beide" festgelegt. Wenn das Mashup enthalten ist, wissen Sie daher möglicherweise nicht, was Sie mit dem Parameter machen sollen. Jetzt können Sie die Bindungsrichtung steuern.
• Sie können die Angabe "Aufgabe" im Fensterbereich "Aufgabe" für jeden Parameter hinzufügen.
Wenn der Parameter in Widgets vom Typ "Enthaltenes Mashup" enthalten ist, wird dann ein Hinweis im Fensterbereich "Aufgabe" angezeigt, in dem die Einspeisung dieses Parameters empfohlen wird.
Sobald Sie ein Mashup in ein Widget vom Typ "Enthaltenes Mashup" ziehen, werden die Parameter im Eigenschaftsfensterbereich des Widgets "Enthaltenes Mashup" verfügbar, und die folgenden Funktionen stehen Ihnen zur Verfügung:
• Sie können eine JSON-Zeichenfolge an das Widget "Enthaltenes Mashup" senden. Der JSON-Editor wird bereitgestellt, damit der Benutzer JSON eingeben kann.
• Sie können eine InfoTable ohne vordefinierten Data Shape an den enthaltenen Mashup-Parameter senden. Der Data Shape ist für ThingWorx 8.3.X und frühere Versionen obligatorisch. Bei 8.4.X und höheren Versionen ist dies nicht obligatorisch.
• Die Bindungsrichtung des Parameters für das enthaltene Mashup ist leicht verständlich: "←" (Quelle), "→" (Ziel) und "↔" (Beide). Bei 8.3.X und früheren Versionen ist der Parameter immer auf die Richtung "Beide" festgelegt.
• Sie haben für jeden Parameter die Anzeige "Aufgabe" im Fensterbereich "Aufgabe".
Beispielsweise für die folgenden Parameter im Bild;
Das erwartete Ergebnis im Widget "Enthaltenes Mashup" sieht folgendermaßen aus: