Benutzerdefinierten Manager erstellen
Das Datenmodell verwendet Manager-Dinge, um bestimmte Funktionen zu steuern. Das Manager-Ding enthält die erforderlichen Funktionen für alle Datenbankbearbeitungen für die Funktionalität, z.B. das Erstellen und Aktualisieren von Datenbanktabellen. Das Manager-Ding implementiert auch alle Dingformen, die für die Verwaltung der Dienste des zugeordneten Objektmodells verantwortlich sind.
Diese Manager sind in der Tabelle ManagerConfigurationSettings auf der Seite Konfiguration des Startpunkt-Konfigurationsdings (PTC.Factory.C_LaunchPointConfigurationThing_[Release-Version]) definiert.
Standard-Manager-Dinge werden für jeden Manager vorkonfiguriert zur Verfügung gestellt.
Sie können benutzerdefinierte Manager erstellen, um Ihre eigenen Datenbanktabellen zu verwalten (zu erstellen und zu aktualisieren). Verwenden Sie die Standard-Manager-Dinge als Modelle.
In den folgenden Schritten wird beschrieben, wie ein Manager erstellt wird, der eine Datenbanktabelle namens customdata mit zwei Spalten verwaltet: UID (Primärschlüssel, automatisch generiert) und CustomProperty1 (Datentyp der Zeichenfolge). Die Tabelle customdata wird mit zwei Zeilen initialisiert.
1. Erstellen Sie in ThingWorx Composer eine neue Data Shape.
a. Geben Sie als Name CustomData ein.
b. Klicken Sie unter Felddefinitionen auf Hinzufügen.
c. Definieren Sie das folgende Feld:
▪ Name – Geben Sie UID ein.
▪ Basistyp – Wählen Sie LONG aus.
▪ Ist Primärschlüssel – Aktivieren Sie dieses Kontrollkästchen.
d. Klicken Sie auf , um das erste Feld hinzuzufügen und ein anderes Feld zu definieren:
▪ Name – Geben Sie CustomProperty1 ein.
▪ Basistyp– Wählen Sie STRING aus.
e. Klicken Sie auf , um das zweite Feld hinzuzufügen.
f. Klicken Sie auf Speichern, um die neue Data Shape zu speichern.
2. Erstellen Sie in ThingWorx Composer eine neue Dingvorlage.
a. Geben Sie als Name CustomManagerThingTemplate ein.
b. Wählen Sie für Basis-Dingvorlage eine beliebige Dingvorlage aus. Beispiel: GenericThing.
c. Suchen Sie für Implementierte Formen nach PTC.SCA.SCO.DBManagementThingShape und fügen Sie sie hinzu. Soll der Manager Erstellungsdienste aufrufen, suchen Sie nach der Dingform PTC.SCA.SCO.ServiceConfigurationThingShape und fügen Sie sie ebenfalls hinzu.
d. Klicken Sie auf Speichern, um die Dingvorlage zu speichern.
3. Erstellen Sie in ThingWorx Composer ein neues Ding.
a. Geben Sie als Name CustomManagerThing ein.
b. Suchen Sie für Basis-Dingvorlage nach CustomManagerThingTemplate (die in Schritt 2 erstellte Dingvorlage) und wählen Sie sie aus.
c. Überschreiben Sie unter Dienste den Dienst GetDBInfo und fügen Sie den folgenden Code hinzu. Klicken Sie anschließend auf Fertig:
var result = {
dbInfo: [{dataShapeName: "CustomData"}]
};
dbInfo: [{dataShapeName: "CustomData"}]
};
d. Überschreiben Sie unter Dienste den Dienst InitData und fügen Sie den folgenden Code hinzu. Klicken Sie anschließend auf Fertig:
var infoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape({
infoTableName : "InfoTable",
dataShapeName : "CustomData"
});
infoTable.AddRow({"CustomProperty1":"TestValue1"});
infoTable.AddRow({"CustomProperty1":"TestValue2"});
Things[me.GetDatabaseThingName()].Insert({
infoTable: infoTable,
dataShapeName: "CustomData"
});
infoTableName : "InfoTable",
dataShapeName : "CustomData"
});
infoTable.AddRow({"CustomProperty1":"TestValue1"});
infoTable.AddRow({"CustomProperty1":"TestValue2"});
Things[me.GetDatabaseThingName()].Insert({
infoTable: infoTable,
dataShapeName: "CustomData"
});
e. Klicken Sie auf Speichern, um das Ding zu speichern.
4. Registrieren Sie den benutzerdefinierten Manager.
a. Navigieren Sie zum Startpunkt-Konfigurationsding (PTC.Factory.C_LaunchPointConfigurationThing_[Release-Version]).
b. Klicken Sie unter Konfiguration auf Hinzufügen für die Konfigurationstabelle ManagerConfigurationSettings.
▪ Geben Sie unter Name einen Namen für den benutzerdefinierten Manager ein wie z.B. CustomDataManager.
▪ Suchen Sie für Wert das in Schritt 3 erstellte benutzerdefinierte Manager-Ding.
c. Klicken Sie auf Hinzufügen, um den benutzerdefinierten Manager zur Konfigurationstabelle hinzuzufügen.
d. Klicken Sie auf Speichern, um die Aktualisierungen für das Startpunkt-Konfigurationsding zu speichern.
5. Führen Sie im CustomMangerThing, das in Schritt 3 erstellt wurde, unter Dienste den Dienst CreateTables aus. Eine Datenbanktabelle namens CustomData wird mit zwei Zeilen erstellt.
6. Wenn Sie Fremdschlüssel definieren möchten, finden Sie weitere Informationen unter
Fremdschlüssel hinzufügen oder entfernen.
7. Informationen zum Ändern der Länge von String-Datenbankspalten finden Sie unter
Länge für STRING-Datenbankspalten festlegen.
8. Informationen dazu, wie Sie das Versenden und Validieren von Vor- und Nachaktionsereignissen konfigurieren, finden Sie unter
Versenden und Validieren von Vor- und Nachaktionsereignissen.