Definiciones de datos
Las definiciones de datos representan los datos en el modelo. Una definición de datos es un conjunto con nombre de definiciones de campo y metadatos relacionados. Cada campo de una definición de datos tiene un tipo de datos. ThingWorx tiene un conjunto definido de tipos base.
Las definiciones de datos ayudan a crear aplicaciones, ya que cuando una aplicación consume datos, con la descripción de la definición de datos, la aplicación tiene conocimientos integrados sobre cómo representar el conjunto de datos. Por ejemplo, si se colocan datos en una rejilla de un mashup, la rejilla conoce cómo son los datos debido a la definición de datos. La rejilla sabe qué campos son números, cadenas o fechas. Cuando se configura cómo la rejilla debe representar los datos, este conocimiento del conjunto de datos facilita la configuración.
Hay cosas específicas que se crean para almacenar datos: flujos, flujos de valor y tablas de datos. Al definir una cosa de almacenamiento de datos, se debe definir una definición de datos (excepto en los flujos de valor).
Las definiciones de datos se utilizan en más casos que solo como definiciones para flujos, flujos de valor y tablas de datos. Las definiciones de datos también se utilizan cuando se necesita describir un conjunto de datos. Por ejemplo, si se define una salida de infotable para una implementación de servicio, se utiliza una definición de datos para describir el conjunto de resultados de salida. Se puede tener una propiedad de cosa de tipo infotable y también se puede especificar la definición de datos en la que se describe la propiedad.
|
Tipo base
|
Descripción
|
||
|---|---|---|---|
|
BASETYPENAME
|
Un nombre de tipo base válido.
|
||
|
BLOB
|
Un objeto binario de gran tamaño.
|
||
|
BOOLEAN
|
Un valor verdadero o falso.
|
||
|
DASHBOARDNAME
|
El nombre de un tablero.
|
||
|
DATASHAPENAME
|
Una referencia a una definición de datos en el modelo que, por consiguiente, tiene una gestión especial.
|
||
|
DATETIME
|
Fecha y hora con formato.
|
||
|
GUID
|
Identificador único global.
|
||
|
GROUPNAME
|
Un nombre de grupo de usuarios.
|
||
|
HTML
|
Contenido HTML.
|
||
|
HYPERLINK
|
Un URL estándar (p. ej., www.ptc.com).
|
||
|
IMAGE
|
Datos binarios que se pueden representar como imagen.
|
||
|
IMAGELINK
|
Un vínculo URL a una imagen.
|
||
|
INFOTABLE
|
Una representación estándar de datos en ThingWorx que son similares a un conjunto de resultados de SQL. Hay varios servicios integrados para generar, consumir y analizar una infotable.
|
||
|
INTEGER
|
Un número que se puede escribir sin un componente fraccionario.
|
||
|
JSON
|
Un objeto de Javascript Object Notation.
|
||
|
LOCATION
|
Coordenada del Sistema Geodésico Mundial (WGS) 84, expresada como [longitud, latitud], elevación.
|
||
|
LONG
|
El tipo LONG se debe utilizar cuando se requiere un rango más largo del que se proporciona en el tipo base INTEGER.
|
||
|
MASHUPNAME
|
Una referencia a un mashup de ThingWorx y que, por consiguiente, tiene una gestión especial.
|
||
|
MENUNAME
|
El nombre de un menú.
|
||
|
NOTHING
|
No contiene nada (nulo).
|
||
|
NUMBER
|
Un número.
|
||
|
PASSWORD
|
Un valor de contraseña con máscara. Consulte
Contraseñas para obtener más información. Para obtener información sobre métodos de codificación, consulte
Codificación.
|
||
|
QUERY
|
Un objeto JSON en el que se incluye una matriz de "filtros". En cada filtro se debe incluir los parámetros value, type y fieldname.
|
||
|
SCHEDULE
|
Una programación basada en notaciones CRON (configurada mediante el editor de programaciones).
|
||
|
STRING
|
Cualquier cantidad de caracteres alfanuméricos.
|
||
|
STYLETHEMENAME
|
Una referencia a un tema de estilo y que, por consiguiente, tiene una gestión especial.
|
||
|
TAGS
|
Valores de etiqueta de ThingWorx.
|
||
|
TEXT
|
Cualquier cantidad de caracteres alfanuméricos. La diferencia con STRING es que TEXT está indexado.
|
||
|
THINGCODE
|
Una representación numérica de una cosa en la que se incluye un objeto DomainID y un objeto InstanceID. Por ejemplo, 2:1.
|
||
|
THINGNAME
|
Una referencia a una cosa y que, por consiguiente, tiene una gestión especial.
|
||
|
THINGSHAPENAME
|
Una referencia a una definición de cosa en el modelo y que, por consiguiente, tiene una gestión especial.
|
||
|
THINGTEMPLATENAME
|
El nombre de una plantilla de cosa.
|
||
|
TIMESPAN
|
Un objeto TimeSpan representa un intervalo de tiempo (duración o tiempo transcurrido) que se mide como un número (positivo o negativo) de días, horas, minutos, segundos.
|
||
|
USERNAME
|
Una referencia a un usuario de ThingWorx definido en el sistema.
|
||
|
VEC2
|
Una recopilación de dos números. Por ejemplo, las coordenadas 2D X e Y.
|
||
|
VEC3
|
Una recopilación de tres números. Por ejemplo, las coordenadas 3D X, Y y Z.
|
||
|
VEC4
|
Una recopilación de cuatro números. Por ejemplo, las coordenadas 4D X, Y, Z y W.
|
||
|
XML
|
Un fragmento o un documento XML.
|
Actualización de una definición de datos existente
Se deben tener en cuenta las siguientes implicaciones si desea actualizar una definición de datos existente (cambiando las definiciones, los tipos o la clave principal de campo) después de que se haya definido:
• La inserción de datos después de cambiar la definición de datos funcionará. Sin embargo, las nuevas filas se asignarán a la definición de la nueva definición de datos.
• Al insertar datos después de cambiar la definición de datos, la clave principal funcionará, pero aún se verificará la integridad de las claves existentes. Al realizar una inserción, el valor de clave se genera mediante la concatenación de todos los valores de campo marcados como clave principal (en el orden de las definiciones de campo) en un campo denominado key.
• La consulta de las filas después de cambiar la definición de datos intentará, de la mejor manera posible, asignar nombres y tipos de campo al conjunto de resultados. Si las filas existentes no coinciden con los tipos o los nombres de campo, las filas se incluirán en el conjunto, pero sin ningún valor.