Personalización del contenido y el acceso a la información > Creación de un administrador personalizado
Creación de un administrador personalizado
El modelo de datos utiliza cosas de administrador para controlar determinadas funciones. La cosa del administrador tiene las opciones necesarias para cualquier manipulación de la base de datos para las funciones, como crear y actualizar tablas de bases de datos. La cosa del administrador también implementa todas las definiciones de cosa necesarias para administrar los servicios relacionados con el modelo de objeto asociado.
Estos administradores se definen en la tabla ManagerConfigurationSettings de la página Configuración de la cosa de configuración del punto de inicio (PTC.Factory.C_LaunchPointConfigurationThing_[versión]).
Se proporcionan cosas de administrador por defecto para cada administrador.
Se pueden crear administradores personalizados para gestionar (crear y actualizar) tablas de base de datos propias. Utilice las cosas de administrador por defecto como modelos.
Los siguientes pasos describen cómo crear un administrador que administre una tabla de base de datos denominada customdata con dos columnas: UID (columna principal, generada automáticamente) y CustomProperty1 (tipo de datos Cadena). La tabla customdata se inicia con dos filas.
1. En ThingWorx Composer, cree una nueva definición de datos.
a. En Nombre, escriba CustomData.
b. En Definiciones de campo, pulse en Añadir.
c. Defina el campo siguiente:
▪ Nombre: indique el UID.
▪ Tipo base: seleccione LONG.
▪ Es clave principal: seleccione esta casilla.
d. Pulse en para añadir el primer campo y definir otro:
▪ Nombre: escriba CustomProperty1.
▪ Tipo base: seleccione STRING.
e. Pulse en para añadir el segundo campo.
f. Pulse en Guardar para guardar la nueva definición de datos.
2. En ThingWorx Composer, cree una nueva plantilla de cosa.
a. En Nombre, escriba CustomManagerThingTemplate.
b. Para Plantilla de cosa base, seleccione cualquier plantilla de cosa. Por ejemplo, GenericThing.
c. En Definiciones implementadas, busque y añada PTC.SCA.SCO.DBManagementThingShape. Si el administrador va a llamar a la creación de servicios, busque y añada también PTC.SCA.SCO.ServiceConfigurationThingShape.
d. Pulse en Guardar para guardar la plantilla de cosa.
3. En ThingWorx Composer, cree una cosa nueva.
a. En Nombre, escriba CustomManagerThing.
b. En Plantilla de cosa base, busque y seleccione CustomManagerThingTemplate (la plantilla de cosa creada en el paso 2).
c. En Servicios, sustituya el servicio GetDBInfo y añada el código siguiente; después pulse en Terminado:
var result = {
dbInfo: [{dataShapeName: "CustomData"}]
};
d. En Servicios, sustituya el servicio InitData y añada el código siguiente; después pulse en Terminado:
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"
});
e. Pulse en Guardar para guardar la cosa.
4. Registre el administrador personalizado.
a. Navegue a la cosa de configuración de puntos de inicio (PTC.Factory.C_LaunchPointConfigurationThing_[versión]).
b. En Configuración, pulse en Añadir para la tabla de configuración ManagerConfigurationSettings.
▪ En Nombre, introduzca un nombre para el administrador personalizado, por ejemplo, CustomDataManager.
▪ Para Valor, busque y seleccione la cosa del administrador personalizado creada en el paso 3.
c. Pulse en Añadir para añadir el administrador personalizado a la tabla de configuración.
d. Pulse en Guardar para guardar los cambios en la cosa de configuración del punto de inicio.
5. En CustomManagerThing (creado en el paso 3), bajo Servicios, ejecute el servicio CreateTables. Se crea una tabla de base de datos denominada customdata con dos filas.
6. Si desea definir claves externas, consulte Adición o eliminación de claves externas.
7. Para cambiar la longitud de columnas de base de datos de String, consulte Definición de la longitud de las columnas de la base de datos de tipo STRING.
8. Para configurar la validación del envío de eventos anteriores y posteriores a la acción, consulte Envío y validación de eventos anteriores y posteriores a la acción.