Usar Invocar servicio en el Editor de reglas visuales para formularios basados en componentes principales

Esta es una función previa al lanzamiento y se puede acceder a ella a través de nuestro canal previo al lanzamiento.

El Editor de reglas visuales de un formulario adaptable admite la característica Invocar servicio, que le permite seleccionar un servicio de la lista de modelos de datos de formulario (FDM) configurados para su instancia. Puede asignar campos de formulario directamente a los parámetros de entrada del servicio. Para asignar campos de formulario a los parámetros de salida, utilice la opción de carga útil de evento para el servicio del modelo de datos de formulario especificado. Además, el editor de reglas visual le permite crear reglas para los controladores de éxito y de error para las operaciones Invoke Service en función de sus respuestas de salida. Los controladores de éxito administran la ejecución correcta de la operación Invocar servicio, mientras que los controladores de error resuelven cualquier error que se produzca.

Ventajas de utilizar el servicio de invocación en el editor de reglas del formulario

Estas son algunas ventajas de utilizar la operación Invocar servicio en el editor de reglas de un formulario adaptable:

Invocar los controladores de servicio para las respuestas de éxito y error

El editor de reglas visual permite crear reglas para los controladores de éxito y de error para las operaciones Invocar servicio en función de sus respuestas de salida. La siguiente imagen muestra Invocar servicio en el editor de reglas visuales para un formulario adaptable:

Para agregar el controlador de éxito o de error, haga clic en Agregar controlador de éxito o en Agregar controlador de error, respectivamente.

Al hacer clic en Agregar controlador de éxito, aparece el editor de reglas Invocar controlador de éxito de servicio, que le permite especificar reglas o lógica para administrar la respuesta de salida Invocar servicio cuando la operación se realiza correctamente. Puede especificar reglas incluso sin definir condiciones; sin embargo, puede agregar condiciones para el controlador de éxito haciendo clic en la opción Agregar condición.

Puede agregar varias reglas para controlar las respuestas correctas para la operación Invocar servicio:

{width="50%,"}

Del mismo modo, puede agregar reglas para controlar la respuesta de salida Invocar servicio cuando la operación no se realice correctamente. La siguiente imagen muestra el editor de reglas Invocar controlador de errores del servicio:

También puede agregar varias reglas para controlar las respuestas erróneas de la operación Invocar servicio.

La característica Habilitar validación de errores en el servidor permite que el autor agregue validaciones al diseñar un formulario adaptable para que también se ejecute en el servidor.

Requisitos previos para utilizar Invoke Service en el editor de reglas

A continuación se muestran los requisitos previos que debe cumplir antes de usar Invocar servicio en el editor de reglas:

Exploración del servicio de invocación mediante diferentes casos de uso

Invocar servicio del editor de reglas visual le permite realizar varias operaciones útiles. Puede usarlo para rellenar opciones desplegables, establecer paneles simples o repetibles y validar campos de formulario, todo en función de la respuesta de salida de Invocar servicio. De este modo, se mejora la flexibilidad y la interactividad de los formularios.

La tabla siguiente describe algunos escenarios en los que se puede usar Invocar servicio:

Cree un formulario Get Information que recupere valores según la entrada escrita en el cuadro de texto Pet ID. La captura de pantalla siguiente muestra el formulario utilizado en estos casos de uso:

Campos de formulario

Agregue los campos siguientes al formulario:

NOTE

En el campo Referencia de enlace del cuadro de diálogo Propiedades de los campos de formulario, seleccione y desplácese hasta seleccionar la propiedad binaria que agregó en el modelo de datos de formulario (FDM).

Configurar paneles

Defina los paneles como repetitivos con las restricciones siguientes:

Puede ajustar los valores de los paneles repetitivos para adaptarlos a sus necesidades.

Origen de datos

En este ejemplo, la API Swagger Petstore se usa para configurar un origen de datos. El modelo de datos de formulario Form está configurado para el servicio getPetById, que recupera los detalles del animal doméstico en función del ID ingresado.

Publicemos el siguiente JSON usando el servicio addPet en la API de Swagger Petstore:

{
        "id": 101,
        "category": {
            "id": 1,
            "name": "Labrador"
        },
        "name": "Lisa",
        "photoUrls": [
            "https://example.com/photos/lisa1.jpg",
            "https://example.com/photos/lisa2.jpg"
        ],
        "tags": [
            {
                "id": 1,
                "name": "vaccinated"
            },
            {
                "id": 2,
                "name": "friendly"
            },
            {
                "id": 3,
                "name": "house-trained"
            }
        ],
        "status": "available"
    }

Las reglas y la lógica se implementan mediante la acción Invocar servicio en el editor de reglas del cuadro de texto Pet ID para mostrar los casos de uso mencionados.

Ahora vamos a explorar en detalle la implementación de cada caso de uso.

Caso de uso 1: Rellenar valores desplegables utilizando la salida de Invocar servicio

Este caso de uso muestra cómo rellenar opciones desplegables de forma dinámica en función del resultado de Invoke Service.

Implementación

Para conseguirlo, cree una regla en el cuadro de texto Pet ID para invocar el servicio getPetById. En la regla, establezca la propiedad enum de la lista desplegable photo-url en photoUrls en Agregar controlador de éxito.

Salida

Escriba 101 en el cuadro de texto Pet ID para rellenar dinámicamente las opciones desplegables en función del valor introducido.

Caso de uso 2: Establecer un panel repetible con la salida del servicio de invocación

Este caso de uso muestra cómo rellenar paneles repetibles de forma dinámica basándose en el resultado de un servicio Invoke.

Consideraciones

Implementación

Cree una regla en el cuadro de texto Pet ID para invocar el servicio getPetById. En Agregar controlador de éxito, agregue otra respuesta de controlador de éxito. Establezca el valor del panel tags en tags en la regla.

Salida

Escriba 101 en el cuadro de texto Pet ID para rellenar dinámicamente el panel repetible en función del valor de entrada.

Caso de uso 3: Configurar el panel mediante la salida del servicio de invocación

Este caso de uso muestra cómo establecer dinámicamente el valor de un panel en función del resultado de Invocar servicio.

Consideraciones

Implementación

Cree una regla en el cuadro de texto Pet ID para invocar el servicio getPetById. En Agregar controlador de éxito, agregue otra respuesta de controlador de éxito. Establezca el valor del cuadro de texto categoryname en category.name en la regla.

Salida

Escriba 101 en el cuadro de texto Pet ID para rellenar dinámicamente el panel en función del valor de entrada.

Caso de uso 4: Usar el parámetro de salida de Invocar servicio para validar otros campos

Este caso de uso muestra cómo usar el resultado de Invocar servicio para validar dinámicamente otros campos de formulario.

Implementación

Cree una regla en el cuadro de texto Pet ID para invocar el servicio getPetById. En Agregar controlador de errores, agregue una respuesta de controlador de errores. Ocultar el botón Enviar si se escribe un Pet ID incorrecto.

Salida

Escriba 102 en el cuadro de texto Pet ID y el botón Enviar estará oculto.

Preguntas frecuentes

Q: ¿Qué sucede si he creado una regla con el servicio de invocación y luego actualizo a la última versión de los componentes principales?

A: Al actualizar a la última versión de los componentes principales, la regla Invocar servicio se actualiza automáticamente a la interfaz de usuario más reciente, ya que es compatible con versiones anteriores.

Q: ¿Puedo agregar varias reglas para controlar las respuestas correctas o de error para la operación Invocar servicio?

A: Sí, puede agregar varias reglas para controlar las respuestas correctas o de error para la operación Invocar servicio.

Artículos relacionados

Recursos adicionales