Cargar un combo por WebService
En ocasiones, al completar una tarea, los usuarios se encuentran con la necesidad de seleccionar una opción de un menú desplegable que forma parte del formulario. Este escenario es común cuando se deben elegir elementos como países, ciudades, productos, entre otros. Sin embargo, cuando la lista de opciones es extensa, ingresarlas manualmente sería una tarea ardua y lenta. En tales casos, la posibilidad de cargar las opciones desde un Web Service resulta sumamente útil. Además, esta funcionalidad puede emplearse para importar datos desde un sistema interno.
Para llevar a cabo esta configuración en el proceso, dirígete a la pestaña "Formulario". Desde allí, agrega un nuevo campo y selecciona el tipo de dato "Selección" o "Menú desplegable". En el apartado "Origen de datos", escoge la opción "Web Service externo". Luego, haz clic en "Configurar el Web service aquí".
Una ventana emergente aparecerá, brindándote la posibilidad de configurar el Web Service:
1-En el campo "URL del servicio web (REST)", ingresa la dirección URL pública del servicio.
2-(Opcional) Si el servicio web requiere parámetros, puedes definirlos en la pestaña "Datos de entrada". En esta sección, deberás especificar el nombre y el valor de cada parámetro adicional. Tienes la opción de seleccionar valores desde otros campos del formulario o introducirlos manualmente.
3-En la pestaña "Datos de salida", establece la relación entre la respuesta del servicio web (que normalmente se presenta en formato JSON) y las etiquetas y valores de las opciones que serán cargadas en el menú desplegable. Aunque ambos campos son obligatorios, es posible utilizar la misma etiqueta y valor si así lo prefieres.
En la mayoría de los casos, el sistema mostrará solamente la etiqueta asociada a cada opción en el menú. Sin embargo, distinguir entre el valor y la etiqueta se vuelve ventajoso cuando el valor se emplea como parámetro en futuras llamadas a otros servicios web. Un ejemplo típico sería usar el valor correspondiente a un país para cargar un menú desplegable con las ciudades de ese país.
1-Una vez realizada la configuración en la ventana del servicio web, selecciona "Aceptar".
2-A continuación, en la edición del campo, confirma los cambios seleccionando "Aceptar"
Por favor considere que el formato de respuesta esperado del Web Service es el siguiente: [{“país”: “Afganistán”, “id”: “AF”}, {“país”: “Albania”, “id”: “AL” }]**
Las opciones del combo se cargarán al abrir la instancia de proceso (siempre y cuando la visibilidad del campo sea editable u obligatorio) y cuando cualquiera de los campos definidos como parámetros de entrada cambien. Puedes utilizar un campo oculto como parámetro de entrada. En ese caso, el valor del parámetro de entrada es el que tenía en la tarea anterior.
Nota: La llamada se realizará siempre mediante una solicitud HTTP GET.
¿Cómo configurarlo?
Para llevar a cabo esta configuración en el proceso, dirígete a la pestaña "Formulario". Desde allí, agrega un nuevo campo y selecciona el tipo de dato "Selección" o "Menú desplegable". En el apartado "Origen de datos", escoge la opción "Web Service externo". Luego, haz clic en "Configurar el Web service aquí".
Una ventana emergente aparecerá, brindándote la posibilidad de configurar el Web Service:
1-En el campo "URL del servicio web (REST)", ingresa la dirección URL pública del servicio.
2-(Opcional) Si el servicio web requiere parámetros, puedes definirlos en la pestaña "Datos de entrada". En esta sección, deberás especificar el nombre y el valor de cada parámetro adicional. Tienes la opción de seleccionar valores desde otros campos del formulario o introducirlos manualmente.
3-En la pestaña "Datos de salida", establece la relación entre la respuesta del servicio web (que normalmente se presenta en formato JSON) y las etiquetas y valores de las opciones que serán cargadas en el menú desplegable. Aunque ambos campos son obligatorios, es posible utilizar la misma etiqueta y valor si así lo prefieres.
En la mayoría de los casos, el sistema mostrará solamente la etiqueta asociada a cada opción en el menú. Sin embargo, distinguir entre el valor y la etiqueta se vuelve ventajoso cuando el valor se emplea como parámetro en futuras llamadas a otros servicios web. Un ejemplo típico sería usar el valor correspondiente a un país para cargar un menú desplegable con las ciudades de ese país.
1-Una vez realizada la configuración en la ventana del servicio web, selecciona "Aceptar".
2-A continuación, en la edición del campo, confirma los cambios seleccionando "Aceptar"
Por favor considere que el formato de respuesta esperado del Web Service es el siguiente: [{“país”: “Afganistán”, “id”: “AF”}, {“país”: “Albania”, “id”: “AL” }]**
Las opciones del combo se cargarán al abrir la instancia de proceso (siempre y cuando la visibilidad del campo sea editable u obligatorio) y cuando cualquiera de los campos definidos como parámetros de entrada cambien. Puedes utilizar un campo oculto como parámetro de entrada. En ese caso, el valor del parámetro de entrada es el que tenía en la tarea anterior.
Nota: La llamada se realizará siempre mediante una solicitud HTTP GET.
Actualizado el: 27/08/2023
¡Gracias!