Show Menu
TEMAS×

Trabajar con el modelo de datos de formulario

El editor del modelo de datos de formulario proporciona una interfaz de usuario intuitiva y herramientas para editar y configurar un modelo de datos de formulario. Con el editor, puede agregar y configurar objetos, propiedades y servicios del modelo de datos desde orígenes de datos asociados en el modelo de datos de formulario. Además, le permite crear objetos y propiedades del modelo de datos sin orígenes de datos y enlazarlos posteriormente con objetos y propiedades del modelo de datos respectivos. También puede generar y editar datos de ejemplo para propiedades de objeto del modelo de datos que puede utilizar para rellenar formularios adaptables y comunicaciones interactivas durante la vista previa. Puede probar los objetos y servicios del modelo de datos configurados en un modelo de datos de formulario para asegurarse de que está correctamente integrado con los orígenes de datos.
Si es nuevo en la integración de datos de Forms y no ha configurado un origen de datos o creado un modelo de datos de formulario, consulte los siguientes temas:
Continúe leyendo para obtener más información sobre las distintas tareas y configuraciones que puede realizar con el editor del modelo de datos de formulario.
Debe ser miembro de los grupos fdm-author y form-user para poder crear y trabajar con el modelo de datos de formulario. Póngase en contacto con el administrador de AEM para convertirse en miembro de los grupos.

Añadir objetos y servicios del modelo de datos

Si ha creado un modelo de datos de formulario con orígenes de datos, puede utilizar el editor del modelo de datos de formulario para agregar objetos y servicios del modelo de datos, configurar sus propiedades, crear asociaciones entre objetos del modelo de datos y probar el modelo y los servicios de datos de formulario.
Puede agregar objetos y servicios del modelo de datos a partir de orígenes de datos disponibles en el modelo de datos de formulario. Cuando los objetos del modelo de datos agregados aparecen en la ficha Modelo, los servicios agregados aparecen en la ficha Servicios.
Para agregar objetos y servicios del modelo de datos:
  1. Inicie sesión en la instancia de creación de AEM, vaya a Formularios > Integraciones de datos y abra el modelo de datos de formulario en el que desee agregar objetos de modelo de datos.
  2. En el panel Fuentes de datos, expanda las fuentes de datos para vista de los objetos y servicios del modelo de datos disponibles.
  3. Seleccione los objetos y servicios del modelo de datos que desee agregar al modelo de datos de formulario y toque Añadir seleccionados .
    Objetos y servicios del modelo de datos seleccionado
    La ficha Modelo muestra una representación gráfica de todos los objetos del modelo de datos y sus propiedades agregadas al modelo de datos de formulario. Cada objeto del modelo de datos se representa mediante un cuadro en el modelo de datos de formulario.
    La ficha Modelo muestra los objetos del modelo de datos agregados
    Puede mantener y arrastrar cuadros de objetos del modelo de datos para organizarlos en el área de contenido. Todos los objetos del modelo de datos agregados en el modelo de datos de formulario aparecen atenuados en el panel Fuentes de datos.
    La ficha Servicios lista los servicios agregados.
    La ficha Servicios muestra los servicios del modelo de datos
    Además de los objetos y servicios del modelo de datos, el documento de metadatos del servicio OData incluye propiedades de navegación que definen la asociación entre dos objetos del modelo de datos. Para obtener más información, consulte Uso de las propiedades de navegación de los servicios OData.
  4. Toque Guardar para guardar el objeto del modelo de formulario.
    Puede invocar servicios configurados en la ficha Servicios de un modelo de datos de formulario mediante las reglas de formulario adaptables. Los servicios configurados están disponibles en la acción Invocar servicios del editor de reglas. Para obtener más información sobre el uso de estos servicios en reglas de formularios adaptables, consulte Invocar servicios y establecer valor de reglas en el editor de reglas.

Creación de objetos de modelo de datos y propiedades secundarias

Creación de objetos de modelo de datos

Aunque puede agregar objetos de modelo de datos desde orígenes de datos configurados, también puede crear objetos o entidades de modelo de datos sin orígenes de datos. Resulta especialmente útil si no ha configurado orígenes de datos en el modelo de datos de formulario.
Para crear un objeto de modelo de datos sin orígenes de datos:
  1. Inicie sesión en la instancia de creación de AEM, vaya a Formularios > Integraciones de datos y abra el modelo de datos de formulario en el que desea crear una entidad u objeto de modelo de datos.
  2. Puntee Crear entidad .
  3. En el cuadro de diálogo Crear modelo de datos, especifique un nombre para el objeto del modelo de datos y toque Añadir . Se agrega un objeto de modelo de datos al modelo de datos de formulario. Tenga en cuenta que el objeto del modelo de datos recientemente agregado no está enlazado a un origen de datos y no tiene ninguna propiedad, como se muestra en la siguiente imagen.
A continuación, puede agregar propiedades secundarias en objetos del modelo de datos independientes.

Añadir propiedades secundarias

El editor del modelo de datos de formulario permite crear propiedades secundarias en un objeto del modelo de datos. La propiedad cuando se crea no está enlazada a ninguna propiedad de un origen de datos. Posteriormente, puede enlazar la propiedad secundaria con otra propiedad del objeto del modelo de datos que la contiene.
Para crear una propiedad secundaria:
  1. En un modelo de datos de formulario, seleccione un objeto de modelo de datos y toque Crear propiedad secundaria.
  2. En el cuadro de diálogo Crear propiedad secundaria, especifique un nombre y un tipo de datos para la propiedad en los campos Nombre y Tipo , respectivamente. Opcionalmente, puede especificar un título y una descripción para la propiedad.
  3. Active Calculado si la propiedad es una propiedad calculada. El valor de una propiedad calculada se evalúa en función de una regla o una expresión. Para obtener más información, consulte Edición de propiedades .
  4. Si el objeto del modelo de datos está enlazado a un origen de datos, la propiedad secundaria agregada se enlazará automáticamente a la propiedad del objeto del modelo de datos principal con el mismo nombre y tipo de datos.
    Para enlazar manualmente una propiedad secundaria con una propiedad de objeto de modelo de datos, toque el icono Examinar situado junto al campo Referencia de enlace . El cuadro de diálogo Seleccionar objeto lista todas las propiedades del objeto del modelo de datos principal. Seleccione una propiedad con la que enlazar y toque el icono de visto. Tenga en cuenta que sólo puede seleccionar una propiedad del mismo tipo de datos que la propiedad secundaria.
  5. Toque Listo para guardar la propiedad secundaria y Guardar para guardar el modelo de datos de formulario. La propiedad secundaria ahora se agrega al objeto del modelo de datos.
Una vez creados los objetos y las propiedades del modelo de datos, puede seguir creando formularios adaptables y comunicaciones interactivas basadas en el modelo de datos de formulario. Posteriormente, cuando tenga orígenes de datos disponibles y configurados, puede enlazar el modelo de datos de formulario con orígenes de datos. El enlace se actualizará automáticamente en formularios adaptables y comunicaciones interactivas asociados. Para obtener más información sobre la creación de formularios adaptables y comunicaciones interactivas mediante el modelo de datos de formulario, consulte Uso del modelo de datos de formulario.

Enlazar objetos y propiedades del modelo de datos

Cuando los orígenes de datos que desea integrar con el modelo de datos de formulario están disponibles, puede agregarlos al modelo de datos de formulario como se describe en Actualizar orígenes de datos. A continuación, haga lo siguiente para enlazar los objetos y las propiedades del modelo de datos sin enlazar:
  1. En el modelo de datos de formulario, seleccione el origen de datos independiente que desea enlazar con un origen de datos.
  2. Toque Editar propiedades .
  3. En el panel Editar propiedades , toque el icono de exploración situado junto al campo Enlace . Abre el cuadro de diálogo Seleccionar objeto que lista los orígenes de datos agregados en el modelo de datos de formulario.
  4. Expanda el árbol de orígenes de datos y seleccione un objeto de modelo de datos para enlazar y tocar el icono de visto.
  5. Toque Listo para guardar las propiedades y, a continuación, toque Guardar para guardar el modelo de datos de formulario. El objeto del modelo de datos ahora está enlazado con un origen de datos. Observe que el objeto del modelo de datos ya no está marcado como Sin enlazar.

Configurar servicios

Para leer y escribir datos para un objeto de modelo de datos, haga lo siguiente para configurar los servicios de lectura y escritura:
  1. Seleccione la casilla de verificación situada en la parte superior de un objeto de modelo de datos para seleccionarlo y toque Editar propiedades .
    Editar propiedades para configurar servicios de lectura y escritura para un objeto de modelo de datos
    Se abre el cuadro de diálogo Editar propiedades.
    Cuadro de diálogo Editar propiedades
    Además de los objetos y servicios del modelo de datos, el documento de metadatos del servicio OData incluye propiedades de navegación que definen la asociación entre dos objetos del modelo de datos. Cuando se agrega un origen de datos del servicio OData a un modelo de datos de formulario, hay un servicio disponible en el modelo de datos de formulario para todas las propiedades de navegación de un objeto de modelo de datos. Puede utilizar este servicio para leer las propiedades de navegación del objeto del modelo de datos correspondiente.
    Para obtener más información sobre el uso del servicio, consulte Uso de las propiedades de navegación de los servicios OData.
  2. Alternar Objeto de nivel superior para especificar si el objeto del modelo de datos es un objeto de modelo de nivel superior.
    Los objetos del modelo de datos configurados en un modelo de datos de formulario están disponibles para su uso en la ficha Objetos del modelo de datos del navegador de contenido de un formulario adaptable basado en el modelo de datos de formulario. Cuando se agrega una asociación entre dos objetos del modelo de datos, el objeto del modelo de datos con el que se asocia se anida en el objeto del modelo de datos que se asocia en la ficha Objetos del modelo de datos. Si el modelo de datos anidado es un objeto de nivel superior, también aparecerá por separado en la ficha Objetos del modelo de datos. Por lo tanto, verá dos entradas del mismo, una dentro y otra fuera de la jerarquía anidada, lo que podría confundir a los autores de formularios. Para que el objeto del modelo de datos asociado aparezca solo en la jerarquía anidada, desactive la propiedad Objeto de nivel superior.
  3. Seleccione Servicios de lectura y escritura para los objetos del modelo de datos seleccionado. Aparecen los argumentos de los servicios.
    Servicios de lectura y escritura configurados para la fuente de datos de empleados
  4. Toque para que el argumento de servicio de lectura enlace el argumento a un atributo de Perfil de usuario, atributo de solicitud o valor literal y especifique el valor de enlace.
  5. Toque Listo para guardar el argumento, Listo para guardar las propiedades y, a continuación, Guardar para guardar el modelo de datos de formulario.

Enlazar argumentos de servicio de lectura

Enlace el argumento de servicio de lectura a un atributo de Perfil de usuario, un atributo de solicitud o un valor literal basado en un valor de enlace. El valor se pasa al servicio como un argumento para recuperar los detalles asociados con el valor especificado del origen de datos.

Literal value

Seleccione Literal en el menú desplegable Enlace a e introduzca un valor en el campo Valor de enlace. Los detalles asociados con el valor se recuperan del origen de datos. Utilice esta opción para recuperar detalles asociados a un valor estático.
En este ejemplo, los detalles asociados con 4367655678 , como valor del mobilenum argumento, se recuperan del origen de datos. Los detalles asociados si pasa el valor de un argumento de número móvil pueden incluir propiedades como nombre de cliente, dirección de cliente y ciudad.

Atributo de perfil de usuario

Seleccione Atributo de Perfil de usuario en el menú desplegable Enlace a e introduzca el nombre del atributo en el campo Valor de enlace. Los detalles del usuario que ha iniciado sesión en la instancia de AEM se recuperan del origen de datos en función del nombre del atributo.
El nombre de atributo especificado en el campo Valor de enlace debe incluir la ruta de enlace completa hasta el nombre de atributo del usuario. Abra la siguiente URL para acceder a los detalles del usuario en CRXDE:
https://<server-name>:<número de puerto>/crx/de/index.jsp#/home/users/
En este ejemplo, especifique profile.empid en el campo Valor de enlace para el grios usuario.
El id argumento toma el valor del empid atributo del perfil del usuario y lo pasa como argumento al servicio de lectura. Lee y devuelve valores de propiedades asociadas desde el objeto del modelo de datos de empleado para el usuario empid asociado al inicio de sesión.

Solicitar atributo

Utilice el atributo request para recuperar las propiedades asociadas del origen de datos.
  1. Seleccione Solicitar atributo en el menú desplegable Enlace a e introduzca el nombre del atributo en el campo Valor de enlace.
  2. Abra head.jsp para definir los detalles de atributos en CRXDE: https://<server-name>:<port number>/crx/de/index.jsp#/libs/fd/af/components/page2/afStaticTemplatePage/head.jsp
  3. Incluya el siguiente texto en el archivo head.jsp:
    <%Map paraMap = new HashMap();
     paraMap.put("<request_attribute>",request.getParameter("<request_attribute>"));
     request.setAttribute("paramMap",paraMap);%>
    
    
Los detalles se recuperan del origen de datos en función del nombre de atributo especificado en la solicitud.
Por ejemplo, si se especifica un atributo como petid=100 en la solicitud, se recuperan las propiedades asociadas al valor de atributo del origen de datos.

Añadir asociaciones

Normalmente, hay asociaciones creadas entre objetos de modelo de datos en un origen de datos. La asociación puede ser uno a uno o uno a varios. Por ejemplo, puede haber varios dependientes asociados a un empleado. Se denomina asociación de uno a varios y se describe 1:n en la línea que conecta objetos del modelo de datos asociados. Sin embargo, si una asociación devuelve un nombre de empleado único para un ID de empleado determinado, se denomina asociación uno a uno.
Cuando se agregan objetos de modelo de datos asociados en un origen de datos a un modelo de datos de formulario, sus asociaciones se conservan y se muestran como conectadas por líneas de flecha. Puede agregar asociaciones entre objetos del modelo de datos en distintos orígenes de datos en un modelo de datos de formulario.
Las asociaciones predefinidas en un origen de datos JDBC no se conservan en el modelo de datos de formulario. Debe crearlos manualmente.
Para agregar una asociación:
  1. Seleccione la casilla de verificación situada en la parte superior de un objeto de modelo de datos para seleccionarlo y toque Añadir asociación . Se abre el cuadro de diálogo Añadir asociación.
    Además de los objetos y servicios del modelo de datos, el documento de metadatos del servicio OData incluye propiedades de navegación que definen la asociación entre dos objetos del modelo de datos. Puede utilizar estas propiedades de navegación al agregar asociaciones en el Modelo de datos de formulario. Para obtener más información, consulte Uso de las propiedades de navegación de los servicios OData.
    Se abre el cuadro de diálogo Añadir asociación.
    Cuadro de diálogo Añadir asociación
  2. En el panel Añadir asociación:
    • Especifique un título para la asociación.
    • Seleccione el tipo de asociación — Uno a Uno o Uno a Muchos.
    • Seleccione el objeto del modelo de datos con el que se va a asociar.
    • Seleccione el servicio de lectura para leer datos del objeto de modelo seleccionado. Se abre el argumento del servicio de lectura. Edite para cambiar el argumento, si es necesario, y enlace el argumento a la propiedad del objeto del modelo de datos que se va a asociar.
    En el siguiente ejemplo, el argumento predeterminado para el servicio de lectura del objeto del modelo de datos Dependientes es dependentid .
    El argumento predeterminado para el servicio de lectura Dependientes es dependiente
    Sin embargo, el argumento debe ser una propiedad común entre el objeto del modelo de datos asociado, que en este ejemplo es Employeeid . Por lo tanto, el Employeeid argumento debe enlazarse a la id propiedad del objeto del modelo de datos Empleado para recuperar los detalles de dependientes asociados del objeto del modelo de datos Dependientes.
    Argumento y enlace actualizados
    Toque Listo para guardar el argumento.
  3. Toque Listo para guardar la asociación y, a continuación, Guardar para guardar el modelo de datos de formulario.
  4. Repita los pasos para crear más asociaciones según sea necesario.
La asociación agregada aparece en el cuadro de objetos del modelo de datos con el título especificado y una línea que conecta los objetos del modelo de datos asociados.
Para editar una asociación, seleccione la casilla correspondiente y toque Editar asociación .

Editar propiedades

Puede editar las propiedades de los objetos del modelo de datos, sus propiedades y los servicios agregados en el modelo de datos de formulario.
Para editar las propiedades:
  1. Active la casilla de verificación situada junto a un objeto de modelo de datos, una propiedad o un servicio en el modelo de datos de formulario.
  2. Toque Editar propiedades . Se abre el panel Editar propiedades del objeto, propiedad o servicio del modelo seleccionado.
    • Objeto del modelo de datos: Especifique los servicios de lectura y escritura y edite los argumentos.
    • Propiedad : Especifique el tipo, subtipo y formato de la propiedad. También puede especificar si la propiedad seleccionada es la clave principal del objeto del modelo de datos.
    • Servicio : Especifique el objeto del modelo de entrada, el tipo de salida y los argumentos del servicio. Para un servicio Get, puede especificar si se espera que devuelva una matriz.
    Cuadro de diálogo Editar propiedades para obtener un servicio
  3. Toque Listo para guardar las propiedades y, a continuación, Guardar para guardar el modelo de datos de formulario.

Crear propiedades calculadas

Una propiedad calculada es aquella cuyo valor se calcula en función de una regla o una expresión. Mediante una regla, puede establecer el valor de una propiedad calculada en una cadena literal, un número, un resultado de una expresión matemática o el valor de otra propiedad en el modelo de datos de formulario.
Por ejemplo, puede crear una propiedad calculada FullName cuyo valor sea el resultado de la concatenación de las propiedades FirstName y LastName existentes. Para ello:
  1. Cree una nueva propiedad con el nombre FullName cuyo tipo de datos sea String.
  2. Active Calculado y toque Listo para crear la propiedad.
    Se crea la propiedad calculada FullName. Observe el icono situado junto a la propiedad para mostrar una propiedad calculada.
  3. Seleccione la propiedad FullName y toque Editar regla . Se abre una ventana del editor de reglas.
  4. En la ventana del editor de reglas, toque Crear . Se abre una ventana de regla Definir valor .
    En la lista desplegable Seleccionar opción, seleccione Expresión ​matemática. Otras opciones disponibles son Objeto y Cadena del Modelo de datos de formulario.
  5. En la expresión matemática, seleccione Nombre y Apellido en los objetos primero y segundo, respectivamente. Seleccione más como operador.
    Toque Listo y, a continuación, Cerrar para cerrar la ventana del editor de reglas. La regla tiene un aspecto similar al siguiente.
  6. En el modelo de datos de formulario, toque Guardar . La propiedad calculada está configurada.

Trabajo con las propiedades de navegación de los servicios de OData

En los servicios OData, las propiedades de navegación se utilizan para definir asociaciones entre dos objetos del modelo de datos. Estas propiedades se definen en un tipo de entidad o un tipo complejo. Por ejemplo, en el siguiente extracto del archivo de metadatos de los servicios de muestra TripPin OData de muestra, la entidad persona contiene tres propiedades de navegación: Amigos, BestFriend y Viajes.
Para obtener más información sobre las propiedades de navegación, consulte la documentación de OData .
<edmx:Edmx xmlns:edmx="https://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
<script/>
<edmx:DataServices>
<Schema xmlns="https://docs.oasis-open.org/odata/ns/edm" Namespace="Microsoft.OData.Service.Sample.TrippinInMemory.Models">
<EntityType Name="Person">
<Key>
<PropertyRef Name="UserName"/>
</Key>
<Property Name="UserName" Type="Edm.String" Nullable="false"/>
<Property Name="FirstName" Type="Edm.String" Nullable="false"/>
<Property Name="LastName" Type="Edm.String"/>
<Property Name="MiddleName" Type="Edm.String"/>
<Property Name="Gender" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonGender" Nullable="false"/>
<Property Name="Age" Type="Edm.Int64"/>
<Property Name="Emails" Type="Collection(Edm.String)"/>
<Property Name="AddressInfo" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location)"/>
<Property Name="HomeAddress" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location"/>
<Property Name="FavoriteFeature" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature" Nullable="false"/>
<Property Name="Features" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature)" Nullable="false"/>
<NavigationProperty Name="Friends" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person)"/>
<NavigationProperty Name="BestFriend" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person"/>
<NavigationProperty Name="Trips" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Trip)"/>
</EntityType>

Al configurar un servicio OData en un modelo de datos de formulario, todas las propiedades de navegación de un contenedor de entidad están disponibles a través de un servicio en el modelo de datos de formulario. En este ejemplo del servicio TripPin OData, las tres propiedades de navegación del contenedor de Person entidad se pueden leer con un GET LINK servicio del Modelo de datos de formulario.
A continuación se resalta el GET LINK of Person /People servicio en el Modelo de datos de formulario, que es un servicio combinado para las tres propiedades de navegación en la Person entidad del servicio TripPin OData.
Una vez agregado el GET LINK servicio a la ficha Servicios del Modelo de datos de formulario, puede editar las propiedades para elegir el objeto del modelo de salida y la propiedad de navegación que se va a utilizar en el servicio. Por ejemplo, el siguiente GET LINK of Person /People servicio del siguiente ejemplo utiliza Trip como objeto del modelo de salida y la propiedad navigation como Trips.
¿Los valores disponibles en el campo Valor ​predeterminado del argumento NavigationPropertyName dependen del estado de la matriz Return? botón de alternancia. Cuando está activado, muestra las propiedades de navegación del tipo Colección.
En este ejemplo, también puede elegir el objeto del modelo de salida como argumento de propiedad Persona y navegación como Amigos o BestFriend (en función de si la matriz Devolver? está habilitado o deshabilitado).
Del mismo modo, puede elegir un GET LINK servicio y configurar sus propiedades de navegación al agregar asociaciones en el Modelo de datos de formulario. Sin embargo, para poder seleccionar una propiedad de navegación, asegúrese de que el campo ​Enlace a esté definido como Literal .

Generar y editar datos de muestra

El editor del modelo de datos de formulario permite generar datos de ejemplo para todas las propiedades de objeto del modelo de datos, incluidas las propiedades calculadas, en un modelo de datos de formulario. Es un conjunto de valores aleatorios que cumplen el tipo de datos configurado para cada propiedad. También puede editar y guardar datos, que se conservan aunque vuelva a generar los datos de ejemplo.
Para generar y editar datos de ejemplo, haga lo siguiente:
  1. Abra un modelo de datos de formulario y toque Editar datos de ejemplo. Genera y muestra los datos de ejemplo en la ventana Editar datos de muestra.
  2. En la ventana Editar datos de ejemplo, edite los datos según sea necesario y toque Guardar .
A continuación, puede utilizar los datos de ejemplo para rellenar previamente y probar comunicaciones interactivas basadas en el modelo de datos de formulario. Para obtener más información, consulte Uso del modelo de datos de formulario.

Probar objetos y servicios del modelo de datos

El modelo de datos de formulario está configurado pero, antes de ponerlo en uso, es posible que desee probar si los objetos y servicios configurados del modelo de datos funcionan correctamente. Para probar los objetos y servicios del modelo de datos:
  1. Seleccione un objeto de modelo de datos o un servicio en el modelo de datos de formulario y toque Objeto de modelo de prueba o Servicio de prueba , respectivamente.
    Se abre la ventana Probar modelo de datos de formulario.
  2. En la ventana Probar modelo de datos de formulario, seleccione el objeto o servicio del modelo de datos que se va a probar en el panel Entrada.
  3. Especifique un valor de argumento en el código de prueba y toque Prueba . Una prueba correcta devuelve el resultado en el panel Salida.
Del mismo modo, puede probar otros objetos y servicios del modelo de datos de formulario.

Validación automatizada de los datos de entrada

El modelo de datos de formulario valida los datos recibidos como entrada al invocar la API DermisBridge (según los criterios de validación disponibles en el modelo de datos de formulario). La validación se basa en el ValidationOptions indicador establecido en el objeto de consulta que se utiliza para invocar la API.
El indicador se puede establecer en cualquiera de los siguientes valores:
  • COMPLETO : FDM realiza la validación en función de todas las restricciones
  • DESACTIVADO : Sin validación
  • BÁSICO : FDM realiza la validación basándose en las restricciones "requeridas" y "rellenables"
Si no se establece ningún valor para el ValidationOptions indicador, la validación BÁSICA se realiza en los datos de entrada.
A continuación se muestra un ejemplo de cómo establecer el indicador de validación en COMPLETO :
operationOptions.setValidationOptions(ValidationOptions.FULL);

El valor que proporcione para un atributo en los datos de entrada debe coincidir con el tipo de datos definido para el atributo en el documento de metadatos. Si el valor no coincide con el tipo de datos definido para el atributo, la API DermisBridge muestra una excepción independientemente del valor del ValidationOptions indicador. Si el nivel de registro está establecido en Debug, se registra un error en el archivo error.log .
El modelo de datos de formulario valida los datos de entrada en función de una lista de restricciones de tipo de datos. La lista de restricciones para los datos de entrada puede variar en función del origen de datos.
La siguiente tabla lista las restricciones de los datos de entrada en función del origen de datos:
Restricciones Descripción Origen de datos de entrada
required Si es true, el parámetro debe incluirse en los datos de entrada. Swagger, WSDL y base de datos
NULL Si es true, el valor del parámetro se puede establecer en Null en los datos de entrada. WSDL, Odata y base de datos
máximo Especifica el límite superior de los valores numéricos. El valor máximo especificado como límite superior también se puede asignar al parámetro en los datos de entrada. Swagger y WSDL
mínimo Especifica el límite inferior de los valores numéricos. El valor mínimo especificado como límite inferior también se puede asignar al parámetro en los datos de entrada. Swagger y WSDL
uniqueMaximum Especifica el límite superior de los valores numéricos. El valor máximo especificado como límite superior no debe asignarse al parámetro en los datos de entrada. Swagger y WSDL
uniqueMinimum Especifica el límite inferior de los valores numéricos. El valor mínimo especificado como límite inferior no debe asignarse al parámetro en los datos de entrada. Swagger y WSDL
minLength Especifica el límite inferior del número de caracteres incluidos en una cadena. El valor mínimo especificado como límite inferior también se puede asignar al parámetro en los datos de entrada. Swagger y WSDL
maxLength Especifica el límite superior del número de caracteres incluidos en una cadena. El valor máximo especificado como límite superior también se puede asignar al parámetro en los datos de entrada. Swagger, WSDL, Odata y base de datos
pattern Especifica una secuencia fija de caracteres. La cadena de entrada solo se valida correctamente si los caracteres se ajustan al patrón especificado. Swagger
minItems Especifica el número mínimo de elementos de una matriz. El valor mínimo especificado como límite inferior también se puede asignar al parámetro en los datos de entrada. Swagger y WSDL
maxItems Especifica el número máximo de elementos de una matriz. El valor máximo especificado como límite superior también se puede asignar al parámetro en los datos de entrada. Swagger y WSDL
uniqueItems Si es true, todos los elementos de la matriz deben ser únicos en los datos de entrada. Swagger
enum (string) Restringe el valor de un parámetro en los datos de entrada a un conjunto fijo de valores de cadena. Debe ser una matriz con al menos un elemento, donde cada elemento es único. Swagger, WSDL y Odata
enum (número) Restringe el valor de un parámetro en los datos de entrada a un conjunto fijo de valores numéricos. Debe ser una matriz con al menos un elemento, donde cada elemento es único. WSDL
En este ejemplo, los datos de entrada se validan según las restricciones máxima, mínima y requerida definidas en el archivo Swagger. Los datos de entrada cumplen los criterios de validación solo si el identificador de pedido está presente y su valor está entre 1 y 10.
parameters: [
{
name: "orderId",
in: "path",
description: "ID of pet that needs to be fetched",
required: true,
type: "integer",
maximum: 10,
minimum: 1,
format: "int64"
}
]

Se muestra una excepción si los datos de entrada no cumplen los criterios de validación. Si el nivel de registro está establecido en Depurar , se registra un error en el archivo error.log . Por ejemplo,
21.01.2019 17:26:37.411 *ERROR* com.adobe.aem.dermis.core.validation.JsonSchemaValidator {"errorCode":"AEM-FDM-001-044","errorMessage":"Input validations failed during operation execution.","violations":{"/orderId":["numeric instance is greater than the required maximum (maximum: 10, found: 16)"]}}

Pasos siguientes

Tiene un modelo de datos de formulario que ya está listo para su uso en formularios adaptables y flujos de trabajo de comunicaciones interactivos. Para obtener más información, consulte Uso del modelo de datos de formulario.