Campos de formulario: Búsqueda HTTP

Resumen

Una Búsqueda HTTP conecta un campo de formulario de GW Apps con una definición de solicitud HTTP reutilizable. Los diseñadores de aplicaciones primero crean la solicitud en Búsquedas HTTP, incluyendo su método, punto de enlace, autenticación, clave principal, entradas y salidas. Luego, agregan un campo de Búsqueda HTTP a un formulario y eligen qué salida se muestra y se guarda en el registro.

El ejemplo de este artículo utiliza el punto de acceso de usuarios de prueba públicos de JSONPlaceholder. Devuelve registros de muestra ficticios y no requiere autenticación. Úsalo solo para documentación y pruebas; utiliza un punto de acceso aprobado y una configuración de seguridad para producción.

Advertencia: Trate los extremos, las credenciales, los encabezados, los tokens, las entradas de solicitudes y los datos de respuestas como sensibles. Nunca exponga un secreto real en una URL, campo de formulario, captura de pantalla, ticket de soporte o artículo.

Ejemplo utilizado en este artículo

Campo	Descripción
Buscar	Directorio de usuarios de ejemplo
Método y URL	GET https://jsonplaceholder.typicode.com/users
Autenticación	Nada
Clave primaria	userId, Número, ruta JSON id
Entrada	nombre de usuario, Cadena de caracteres, opcional
Valor guardado	nombre completo

Crear la definición de búsqueda HTTP

1. Abra la aplicación en modo de edición.
2. Seleccione HTTP Lookups en la navegación de Application Designer.
3. Seleccione Crear nueva búsqueda HTTP.
4. Ingrese el nombre de búsqueda y la descripción.

Configurar la solicitud

1. Método Set.
2. Ingrese la URL correspondiente utilizada.
3. Establecer tipo de autenticación (En este caso, se establece como Ninguno porque el punto de conexión de prueba público no requiere credenciales).
4. Si lo requiere otro punto de conexión, agregue pares de clave/valor de encabezado fijo en Detalles del encabezado. 

Configurar la Clave Primaria, las Entradas y las Salidas

La Clave Primaria identifica cada resultado devuelto. Las Entradas proporcionan valores que la solicitud puede utilizar, y las Salidas identifican las propiedades de respuesta disponibles para el campo del formulario.

1. Bajo Clave primaria, ingrese el Nombre de la clave primaria, elija el Tipo y complete la ruta JSON.

Tipos de llaves primarias
Cadena
Número
Booleano
Correo electrónico
Fecha
Fecha y hora

2. Bajo Entradas, agregue el nombre, elija el Tipo de entrada y establezca el estado de obligatoriedad.

3. En Outputs, agregue las salidas deseadas utilizando la clave relativa, el tipo de datos y la ruta JSON.

4. Seleccione Crear. La nueva definición aparece en HTTP Lookups con su método, URL, nombre y descripción.

Agregar un campo de búsqueda HTTP a un formulario

1. Abra Forms y edite el formulario de destino.
2. En la pestaña Design, busque HTTP Lookup en la paleta Fields y arrástrelo a la posición de diseño requerida.
3. En el Paso 1, seleccione Búsqueda HTTP, elija su búsqueda creada.
4. En Output to save in record, elija Output Value y Output ID. El menú Type también ofrece Formula y Concat cuando el valor guardado debe calcularse o combinarse.
5. Seleccione Siguiente.
6. En el Paso 2, Entradas, asigne la entrada. En la grabación, está configurada como un cuadro de texto de campo HTTP, lo que le brinda al usuario un cuadro de texto para la entrada de búsqueda.
7. Seleccione Siguiente.
8. En el Paso 3, Resultados, seleccione opcionalmente Mapear resultado para copiar un resultado devuelto en otro campo de formulario compatible. Elija el campo de formulario de destino, seleccione Valor de salida y seleccione el ID de salida correspondiente.
9. Seleccione Crear y, a continuación, guarde el formulario.

Importante: El mapeo de salida es opcional. Solo mapee un valor de respuesta en otro campo de formulario cuando el propósito y el tipo de datos del campo de destino coincidan con la salida seleccionada. No sobrescriba identificadores ni campos de negocio no relacionados simplemente para probar la función.

Usar la Búsqueda en un Formulario

1. Vista previa o lanzamiento del formulario.
2. Seleccione el icono de búsqueda en el campo HTTP Lookup.
3. Revise la lista devuelta. La primera columna contiene la clave primaria configurada, y la columna de valor contiene la salida seleccionada para guardar en el registro.
4. Escribe en el cuadro de búsqueda para acotar los resultados mostrados.
5. Seleccione el resultado requerido. En este ejemplo, al seleccionar una fila se guarda el fullName de la persona como el valor del campo.
6. Guarde el registro y vuelva a abrirlo para confirmar que se conservó el valor seleccionado.

Referencia de configuración

Campo	Descripción
Nombre de búsqueda	La definición reutilizable que se muestra cuando se agrega un campo de búsqueda HTTP a un formulario.
Método	La operación HTTP. El menú actual muestra GET, POST, PUT y DELETE.
Autenticación	El menú actual muestra Ninguno, Autenticación básica, Token Bearer y JWT.
Clave primaria	La propiedad de respuesta que identifica de forma única cada fila de resultados.
Entrada	Un valor proporcionado a la solicitud de búsqueda. El asistente de campos de formulario controla cómo se proporciona cada entrada.
Salida	Una propiedad de respuesta expuesta para visualización, almacenamiento de registros o mapeo opcional a otro campo de formulario.
Resultado para guardar	El asistente admite Valor de salida, Fórmula o Concat. Valor de salida almacena una salida seleccionada, como fullName.

Solución de problemas y seguridad

• Si no aparecen resultados, verifique el punto de acceso, el método, la autenticación, el mapeo de entrada, la ruta de la clave principal y las rutas JSON de salida.
• Si falta una salida en el asistente de campos, confirme que su tipo de datos sea compatible con la forma en que se almacenará o asignará el valor. En la grabación proporcionada, la lista de valores guardados seleccionables mostraba las salidas de tipo String, pero no mostraba la salida de tipo Email.
• Use puntos finales HTTPS y credenciales de mínimo privilegio.
• No coloque secretos en URL, campos de formularios visibles, capturas de pantalla ni ejemplos de documentación.
• Asigna únicamente las propiedades de respuesta necesarias para el formulario y aprobadas para su almacenamiento.
• Vuelva a probar la búsqueda después de cambiar su punto de conexión, autenticación, entradas, rutas de salida o asignaciones de campos de destino.