Création d'un gestionnaire personnalisé
Les objets de gestionnaire sont utilisés par le modèle de données pour contrôler certaines fonctionnalités. L'objet de gestionnaire contient les fonctions nécessaires à toute manipulation de la base de données, comme la création et la mise à jour de tables de base de données. Il implémente également toutes les formes d'objet responsables de la gestion des services associés au modèle d'objet associé.
Ces gestionnaires sont définis dans la table ManagerConfigurationSettings de la page Configuration de l'objet de configuration du point de lancement (PTC.Factory.C_LaunchPointConfigurationThing_[ReleaseVersion]).
Les objets de gestionnaire par défaut sont fournis pour chaque gestionnaire standard.
Vous pouvez créer des gestionnaires personnalisés pour gérer (créer et mettre à jour) vos propres tables de base de données. Utilisez comme modèles les objets de gestionnaire par défaut.
Dans les instructions suivantes, vous créez un gestionnaire qui gère une table de base de données nommée customdata, avec deux colonnes : UID (clé primaire, générée automatiquement) et CustomProperty1 (données de type chaîne). La table customdata est initialisée avec deux lignes.
1. Dans ThingWorx Composer, créez une nouvelle forme de données.
a. Pour Nom, spécifiez CustomData.
b. Sous Définitions de champ, cliquez sur Ajouter.
c. Définissez le champ suivant :
▪ Nom : spécifiez UID.
▪ Type de base : sélectionnez LONG.
▪ Est une clé primaire : cochez cette case.
d. Cliquez sur 
pour ajouter le premier champ, puis définissez un autre champ :
pour ajouter le premier champ, puis définissez un autre champ :▪ Nom : spécifiez CustomProperty1.
▪ Type de base : sélectionnez STRING.
e. Cliquez sur 
pour ajouter le second champ.
pour ajouter le second champ.f. Cliquez sur Enregistrer pour enregistrer la nouvelle forme de données.
2. Dans ThingWorx Composer, créez un nouveau modèle d'objet.
a. Pour Nom, spécifiez CustomManagerThingTemplate.
b. Cliquez sur Enregistrer pour créer le modèle d'objet.
c. Pour Formes implémentées, recherchez et ajoutez PTC.SCA.SCO.DBManagementThingShape.
d. Cliquez sur Enregistrer pour enregistrer le modèle d'objet.
3. Dans ThingWorx Composer, créez un nouvel objet.
a. Pour Nom, spécifiez CustomManagerThing.
b. Pour Modèle d'objet de base, recherchez et sélectionnez CustomManagerThingTemplate (le modèle d'objet créé à l'étape 2).
c. Sous Services, remplacez le service GetDBInfo et ajoutez le code suivant :
var result = {
dbInfo: [{dataShapeName: "CustomData"}]
};
dbInfo: [{dataShapeName: "CustomData"}]
};
d. Sous Services, remplacez le service InitData et ajoutez le code suivant :
var infoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape({
infoTableName : "InfoTable",
dataShapeName : 'CustomData'
});
infoTable.AddRow({"CustomProperty1":"TestValue1"});
infoTable.AddRow({"CustomProperty2":"TestValue2"});
Things[me.GetDatabaseThingName()].Insert({
infoTable: infoTable,
dataShapeName: 'CustomData'
});
infoTableName : "InfoTable",
dataShapeName : 'CustomData'
});
infoTable.AddRow({"CustomProperty1":"TestValue1"});
infoTable.AddRow({"CustomProperty2":"TestValue2"});
Things[me.GetDatabaseThingName()].Insert({
infoTable: infoTable,
dataShapeName: 'CustomData'
});
e. Cliquez sur Enregistrer pour enregistrer l'objet.
4. Sur l'objet CustomMangerThing créé à l'étape 3, sous Services, exécutez le service CreateTables. Une table de base de données nommée customdata est créée et contient deux lignes.
5. Si vous souhaitez définir des clés étrangères, consultez la rubrique
Ajout ou suppression de clés étrangères.
6. Pour modifier la longueur des colonnes de la base de données String, consultez la rubrique
Paramétrage de la longueur des colonnes de la base de données de type String.
7. Pour configurer la distribution et validation des événements pré et post-action, consultez la rubrique
Distribution et validation des événements pré et post-action.