Saltar al contenido principal

Esquemas de artefactos

Todo lo que un creador construye en Parsware —una tabla, una vista, un formulario, una consulta, un informe, un proceso, una aplicación— es, por debajo, un documento JSON sencillo, y cada tipo de documento tiene un JSON Schema publicado (draft 2020-12). El diseñador es una forma de escribir el documento; un editor, un script o un asistente de IA es otra. Lo haya escrito quien lo haya escrito, la plataforma lo comprueba con el mismo esquema, al guardarlo y otra vez cuando se importa una solución que lo contiene.

Cada esquema se sirve desde este sitio en /schemas/<nombre>.schema.json, de modo que cualquier herramienta de JSON Schema puede comprobar un archivo antes de enviarlo:

npx ajv-cli validate --spec=draft2020 -s saved-query.schema.json -d visitors-by-purpose.json

Un documento que contiene otro documento deja esa parte al esquema del otro, como hace la plataforma: la query de una consulta guardada es un documento de consulta y se comprueba con parsware-query. Compruébela también ahí.

Un rechazo de la plataforma nombra lo mismo que un validador: dónde en el documento (un JSON Pointer como /aggregate/measures/0/function) y qué está mal ahí.

Todos los esquemas​

DocumentoEsquemaPágina
Tablamodel-driven-entityDefinición de tabla
Conjunto de opcionesmodel-driven-option-setDefinición del conjunto de opciones
Vistamodel-driven-viewDefinición de vista
Formulariomodel-driven-formDefinición de formulario
Aplicación basada en modelomodel-driven-appDefinición de aplicación
Consultaparsware-query
Consulta guardadasaved-query
Informemodel-driven-report
Panelmodel-driven-dashboard
Aplicación de Studiostudio-app
Una pantalla de Studio compiladaui-tree
Aplicación de portalportal-app
Guía de la aplicaciónapp-guide
Procesobpms-process
Dibujo del procesobpms-design
Regla de negocio de clientebusiness-rule
Paso de complemento de servidorplugin-stepPaso de complemento
Script de soluciónsolution-script
Trabajo programadoscheduled-job
API personalizadacustom-apiAPI personalizada
Rol de seguridadsecurity-role
Directiva de datospolicy-definition
Variable de entornoenvironment-variable
Datos inicialesseed-data
Recurso webweb-resource-manifestManifiesto del recurso web
Aplicación personalizadacustom-app-manifestManifiesto de la aplicación
Control personalizadocustom-control-manifestManifiesto del control
Archivo de una aplicación o un control (parsware.json)artifact-packagePaquete de artefacto
Paquete de soluciónsolution-packagePaquete de solución

Los campos description de cada esquema explican sus miembros; hay una página propia donde la forma necesita más que eso.

Versiones anteriores​

Cuando la forma de un documento cambia de una manera que los archivos antiguos no pueden cumplir, el esquema antiguo se conserva junto al nuevo, para que una solución exportada antes del cambio siga importándose: model-driven-form-v1 y model-driven-view-v1 quedan congelados ahí.

Estos archivos son los de la plataforma​

Los esquemas de aquí son copias de aquellos con los que valida cada servicio, y una prueba hace fallar la compilación cuando una copia difiere de su origen. Aquello con lo que usted comprueba es aquello con lo que comprueba la plataforma.