Cargar un combo por WebService
Al completar una tarea, los usuarios a veces tienen que completar un campo seleccionando una opción de un combo. Un ejemplo típico es una lista de países, ciudades, productos, etc. Si la lista es demasiado larga, cargar las opciones del combo manualmente llevaría demasiado tiempo. En esos casos es muy útil cargar un combo desde un Web Service. Además, puede usarse para importar datos desde un sistema propio.
Al configurar el proceso, en la pestaña “Formulario” agrega un nuevo campo. Selecciona tipo de dato “Combo” y en “Origen de datos” elige la opción “Web Service externo”. Luego haz clic en “Edita el Web Service aquí…”
Se abrirá una ventana donde podrás configurar el Web Service:
En el campo URL del Web Service (REST) escribe la URL pública del Web Service.
(Opcional) En caso de que el Web Service reciba parámetros, puedes definirlos en la pestaña Datos de Entrada. Tendrás que especificar un nombre y valor para cada parámetro agregado. Puedes seleccionar el valor de uno de los campos del formulario o introducirlo manualmente.
En la pestaña Datos de Salida mapea la respuesta del Web Service (que debería ser un string JSON) con la etiqueta y el valor de las opciones cargadas en el combo. Ambos campos son obligatorios, pero puedes ingresar la misma etiqueta y valor si deseas.
En la mayoría de los casos el sistema mostrará sólo la etiqueta de la opción del combo. La ventaja de distinguir entre valor y etiqueta es utilizar el valor como un parámetro de entrada en otra llamada a un Web Service. El ejemplo típico sería utilizar el valor de un país para cargar un combo con las ciudades de ese país.
En la ventana Configuración del Web Service, selecciona Aceptar.
En la Edición del campo, selecciona 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?
Al configurar el proceso, en la pestaña “Formulario” agrega un nuevo campo. Selecciona tipo de dato “Combo” y en “Origen de datos” elige la opción “Web Service externo”. Luego haz clic en “Edita el Web Service aquí…”
Se abrirá una ventana donde podrás configurar el Web Service:
En el campo URL del Web Service (REST) escribe la URL pública del Web Service.
(Opcional) En caso de que el Web Service reciba parámetros, puedes definirlos en la pestaña Datos de Entrada. Tendrás que especificar un nombre y valor para cada parámetro agregado. Puedes seleccionar el valor de uno de los campos del formulario o introducirlo manualmente.
En la pestaña Datos de Salida mapea la respuesta del Web Service (que debería ser un string JSON) con la etiqueta y el valor de las opciones cargadas en el combo. Ambos campos son obligatorios, pero puedes ingresar la misma etiqueta y valor si deseas.
En la mayoría de los casos el sistema mostrará sólo la etiqueta de la opción del combo. La ventaja de distinguir entre valor y etiqueta es utilizar el valor como un parámetro de entrada en otra llamada a un Web Service. El ejemplo típico sería utilizar el valor de un país para cargar un combo con las ciudades de ese país.
En la ventana Configuración del Web Service, selecciona Aceptar.
En la Edición del campo, selecciona 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: 03/04/2020
¡Gracias!