Apama Analytics Builder 10.7.0 | Bedienungsanleitung für Apama Analytics Builder for Cumulocity IoT | Mit dem Modelleditor arbeiten | Mit Blöcken und Verbindungen arbeiten | Vorlagenparameter verwalten
 
Vorlagenparameter verwalten
Ein Modell kann null oder mehr Vorlagenparameter enthalten, die bei den Blockparametern anstelle von definierten Werten verwendet werden können. Anstatt beim Schwelle-Block zum Beispiel einen Schwellenwert von 100 zu definieren, können Sie im Blockparametereditor einen Vorlagenparameter zuweisen.
Wenn ein Modell Vorlagenparameter hat, dann können mehrere Instanzen des Modells erstellt werden, und es können unterschiedliche Werte für die Vorlagenparameter angegeben werden. Siehe auch Modelle; dort wird der Unterschied zwischen Modellen ohne Vorlagenparameter und Modellen mit Vorlagenparametern erläutert, sowie die verschiedenen Rollen: Modellautor und Instanzenverwalter.
Wenn Sie Vorlagenparameter verwenden möchten, müssen Sie diese zuerst, wie unten beschrieben, im Dialogfeld "Vorlagenparameter" definieren. Nachdem Sie einen Vorlagenparameter definiert haben, können Sie ihn im Blockparametereditor bestimmten Parametern desselben Typs zuweisen (siehe auch Die Parameter eines Blocks editieren).
Anmerkung:
Sie können die Vorlagenparameter auch direkt im Blockparametereditor definieren.
Modelle ohne Vorlagenparameter können direkt im Modellmanager aktiviert werden. Hierbei wird immer nur eine einzelne Modellinstanz ausgeführt. Sobald Sie einem oder mehreren Blockparametern mindestens einen Vorlagenparameter zuweisen und das Modell speichern, ändert sich dieses Verhalten. Sie können das Modell dann nicht mehr direkt im Modellmanager aktivieren. Stattdessen müssen Sie mindestens eine Instanz des Modells erstellen, und diese Instanz können Sie dann im Instanzeditor aktivieren. Ausführliche Informationen finden Sie unter Mit dem Instanzeditor arbeiten.
*Vorlagenparameter für die Instanzen des aktuellen Modells definieren
1. Klicken Sie in der Symbolleiste des Modelleditors auf um das Dialogfeld "Vorlagenparameter" aufzurufen.
Auf dem Symbol wird ein Häkchen angezeigt, wenn mindestens ein Vorlagenparameter definiert wurde: .
Das Dialogfeld ist anfangs leer und Sie müssen die Vorlagenparameter erstellen, die Sie in Ihrem Modell verwenden möchten. Wenn bereits Vorlagenparameter definiert wurden, dann werden diese im Dialogfeld angezeigt.
Wenn es eine lange Liste von Vorlagenparametern gibt, dann können Sie den gesuchten Vorlagenparameter leicht finden, indem Sie seinen Namen oder einen Teil des Namens im Suchfeld eingeben. Sobald Suchkriterien angewendet werden, wird im Suchfeld angezeigt. Klicken Sie darauf, wenn Sie die Suchkriterien löschen und alle verfügbaren Vorlagenparameter wieder anzeigen möchten.
Nachdem einem oder mehreren Blockparametern ein Vorlagenparameter zugewiesen wurde, wird in der Spalte Verwendung die Anzahl der Stellen angezeigt, an denen der Vorlagenparameter verwendet wird. Wenn ein Vorlagenparameter zum Beispiel an zwei Stellen verwendet wird, so bedeutet dies, dass er zwei Blockparametern zugewiesen wurde. Diese können sich im selben Block oder in verschiedenen Blöcken befinden.
2. Klicken Sie auf Neuer Vorlagenparameter, um einen neuen Vorlagenparameter zu erstellen.
Hierdurch wird am unteren Ende des Dialogfelds eine leere Zeile hinzugefügt. Sie können Neuer Vorlagenparameter mehrere Male anklicken, um mehrere leere Zeilen hinzuzufügen, die Sie nacheinander ausfüllen können.
3. Geben Sie für jeden Vorlagenparameter die folgenden Informationen an:
*Name. Geben Sie einen eindeutigen Namen ein, der den Vorlagenparameter im aktuellen Modell identifiziert. Dieser Name kann später im Blockparametereditor ausgewählt werden.
*Typ. Wählen Sie aus dem Dropdown-Listenfeld den Wertetyp des Vorlagenparameters aus. Der Typ kann zum Beispiel ein String- oder Float-Wert sein, der Name eines Geräts oder einer Gerätegruppe, oder der Parameter eines bestimmten Blocks.
Ein Eingabeblock bezieht sich auf ein Gerät oder eine Gerätegruppe, während sich ein Ausgabeblock auf ein Gerät oder ein Trigger-Gerät bezieht. Derselbe Vorlagenparameter und damit derselbe Wert kann sowohl bei einem Eingabeblock als auch bei einem Ausgabeblock verwendet werden. Wenn sich ein Vorlagenparameter auf eine Gerätegruppe bezieht, dann wird er bei einem Ausgabeblock als Trigger-Gerät behandelt. In der Regel wird ein einzelner Vorlagenparameter für alle Eingabe- und Ausgabeblöcke verwendet und kann für ein einzelnes Gerät oder eine Gerätegruppe stehen. In diesem Fall geht die Ausgabe des Blocks an das Gerät innerhalb der Gruppe, die eine Modellauswertung ausgelöst hat (ein Modell, das den Durchschnitt einer Messung berechnet und an eine Messung ausgibt, würde somit unabhängig für jedes Gerät eine neue Messung erzeugen). Auch wenn man einen anderen Vorlagenparameter verwenden würde, dessen Wert sich auf eine andere Gruppe bezieht, würde die Ausgabe des Modells nur an das Gerät gesendet werden, welches die Auswertung des Modells ausgelöst hat.
*Optional. Ein optionaler Wert kann leer bleiben oder später vom Instanzenverwalter festgelegt werden. Wenn Sie dieses Kontrollkästchen aktivieren, dann ist es nicht möglich, einem Standardwert anzugeben.
*Standardwert. Sie können einen Standardwert nur dann angeben, wenn das Kontrollkästchen Optional nicht aktiviert ist.
Ausnahme: Boolesche Typen haben immer einen Wert und können nicht optional sein. Sie sind standardmäßig falsch (das heißt, das Kontrollkästchen für den Standardwert ist nicht aktiviert).
Wenn Sie einen Standardwert angeben, dann wird dieser Standardwert im Instanzeditor angezeigt, wenn der Instanzenverwalter eine neue Instanz erstellt. Der Instanzenverwalter kann diesen Standardwert dann entweder unverändert lassen oder für diese Instanz nach Bedarf ändern.
Wenn Sie den Standardwert für ein Gerät festlegen und hierfür das Feld Standardwert anklicken, dann wird ein zusätzliches Dialogfeld angezeigt. Dieses Dialogfeld ist dasselbe wie bei der Auswahl eines anderen Geräts, einer anderen Gerätegruppe oder eines anderen Assets im Blockparametereditor (weitere Informationen zu diesem Dialogfeld finden Sie unter Die Parameter eines Blocks editieren). Klicken Sie die Schaltfläche Verwenden (diese wird angezeigt, wenn Sie mit der Maus über einen Eintrag fahren), um das gewünschte Gerät auszuwählen.
Anmerkung:
Wenn es einen Blockparameter gibt, bei dem kein erforderlicher Wert angegeben wurde, dann kann die Instanz nicht aktiviert werden. Bei einem Aktivierungsversuch wird ein Fehler angezeigt.
4. Sie können einen Vorlagenparameter jederzeit aktualisieren. Dies beinhaltet den Namen, ob er optional ist oder nicht, sowie den Standardwert. Alle Blöcke, in denen der aktualisierte Vorlagenparameter definiert ist, werden automatisch an die Verwendung der neuen Werte angepasst. Die einzige Ausnahme ist der Typ. Sie können den Typ nur ändern, wenn der Vorlagenparameter in keinem Block des Modells verwendet wird.
5. Wenn das Modell inaktiv ist, können Sie die Vorlagenparameter neu anordnen. Dies beeinflusst die Reihenfolge, in der sie im Instanzeditor angezeigt werden. Ziehen Sie eine Zeile mit Hilfe von neben dieser Zeile an eine andere Position. Siehe auch Die Instanzen filtern und sortieren.
6. Sie können einen Vorlagenparameter nur entfernen, wenn er in keinem Block des Modells verwendet wird. Um einen Vorlagenparameter zu entfernen, klicken Sie auf das Aktionsmenü (die drei vertikalen Punkte am Ende einer Zeile) und klicken Sie dann auf Entfernen.
7. Klicken Sie auf OK, um die Änderungen im Datenspeicher zu behalten und das Dialogfeld zu schließen.
Anmerkung:
Denken Sie daran, dass Ihre Änderungen nur dann dauerhaft ins Inventar geschrieben werden, wenn Sie das Modell speichern. Siehe auch Ein Modell speichern.