Referencia de extensión de validación de DTMI
Agregue una extensión de validación de DTMI a su modelo gemelo digital para que pueda definir reglas de validación de datos mediante las propiedades de validación del esquema JSON.
En los modelos gemelos digitales, utilice Especificaciones de validación de esquema JSON para agregar propiedades de validación a los datos de validación ingeridos. Para obtener información sobre cómo utilizar la extensión DTMI en su modelo gemelo digital, consulte Escenario: Agregar validación de esquema JSON a un modelo gemelo digital.
- Para las propiedades primitivas, como cadenas o enteros, las restricciones de validación se agregan como propiedades hermanas junto al campo de esquema dentro de la propiedad o la definición de telemetría.
- Para las arrays, las validaciones se aplican a la matriz en sí, como
minItemsouniqueItems, se definen como hermanos del esquema de matriz, mientras que las restricciones que se aplican a cada elemento, como rangos de valores o patrones de cadena que se colocan dentro del esquema de matriz, como propiedades hermanas deelementSchema.
La plataforma IoT soporta las siguientes palabras clave de validación de esquema JSON:
- Instancias numéricas, incluidas:
numberyinteger - Cadenas:
"schema": "string" - Matrices
minItem,maxItemsyuniqueItems
Para la validación
exclusiveMinimum y exclusiveMaximum, al utilizar el tipo de esquema unsignedLong, los valores se pueden convertir en dobles si superan el rango de una longitud estándar. Esta conversión puede provocar una pérdida de precisión, por lo que es posible que los valores cercanos a exclusiveMinimum o exclusiveMaximum no superen la validación aunque parezcan válidos.| Validación | Tipo de datos | Válido en estos @types | Se aplica a los tipos de esquema | Ejemplos |
|---|---|---|---|---|
| Número | Matriz CommandRequest CommandResponse Enumeración Campo MapValue Propiedad Telemetría |
| |
| Número | Matriz CommandRequest CommandResponse Enumeración Campo MapValue Propiedad Telemetría |
| |
| Entero | Matriz CommandRequest CommandResponse Enumeración Campo MapKey MapValue Propiedad Telemetría |
| |
multipleOf | Número | Matriz CommandRequest CommandResponse Enumeración Campo MapValue Propiedad Telemetría |
| |
pattern | Cadena | Matriz CommandRequest CommandResponse Enumeración Campo MapKey MapValue Propiedad Telemetría |
| |
| Entero | Matriz CommandRequest CommandResponse Campo MapValue Propiedad Telemetría | Esquema de matriz (todos los tipos primitivos) | |
uniqueItems | Booleano | Matriz CommandRequest CommandResponse Campo MapValue Propiedad Telemetría | Esquema de matriz (todos los tipos primitivos) | |