Obtener formulario
Los formularios en Persat pueden ser insertados tanto desde la web, la aplicación móvil, o desde la API. Una vez creados se les asigna un id unico, mediante el cual podemos luego consultar su contenido.
Para obtener un formulario particular que ya ha sido insertado en Persat se debe realizar un GET como el que se muestra a continuación.
IMPORTANTE: El id del formulario es un string, si bien hoy en día los ids de los formularios representan números, hay que considerar la posibilidad de que sean alfanuméricos a futuro.
GET
https://api.persat.com.ar/v1/digital-forms/form_id
Path Parameters
Name | Type | Description |
---|---|---|
form_id* | String | Identificador del formulario. |
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Bearer API_KEY |
Analizando la Respuesta
_id: Identificador del formulario. Es un string, si bien hoy en dia representa un número, puede ser modificado a futuro para ser alfanumerico.
created: Fecha de creación del formulario.
Si bien la fecha esta representada en UTC, hay que considerarla en horario local. Esto se debe a un requerimiento de mantener la compatibilidad con una versión anterior de Persat. Entonces para el caso del ejemplo, y sin importar si soy un cliente de Argentina, Ecuardor o Mexico, la fecha mostrada representa el día 18 de Mayo de 2022 a las 15:36 hora de mi país
created_by_user_name: Nombre del usuario que insertó el formulario. En caso que el formulario haya sido creado a traves de la API, el valor será "Creado por Api"
created_by_user_id: id del usuario nombrado arriba. En caso que el formulario haya sido creado a traves de la API, el valor será -1
El id de cada usuario se puede obtener en la pantalla de Usuarios y Permisos, presionando sobre el boton Developers en la barra superior
client: Datos del cliente en el que se encuentra el formulario
id: Id interno. NO UTILIZAR. Preparar el sistema para incluso dejar de recibir este dato a futuro.
name: Nombre del cliente
uid_client: Id del cliente. Es el que se utiliza como identificador de este cliente. Es un valor único.
df_data: Datos del formulario
df_data.schema_id: Identificador del esquema (plantilla) del formulario. Por ejemplo: Puedo tener un formulario de "Nota de Pedido" y otro de "Encuesta". Para saber de que tipo de formulario estoy hablando es que se usa el schema_id. Además también puede pasar que el formulario de "Nota de Pedido", tengas varias versiones dentro de Persat, con lo cual cada una de estas versiones es un schema_id diferente.
Para poder conocer los schema_id de los formularios disponibles Indetificación de Formularios
También puede consultarlos mediante un endpoint de la API Obtener esquema
df_data.results: Datos del formulario
df_data.results.last_updated: Fecha de ultima modificación en hora local. Es decir que se aplica el mismo criterio que para el created mencionado mas arriba en esta misma sección.
df_data.results.formvalues: Datos de cada uno de los componentes (widgets) del formulario. Cada tipo de formulario esta conformado por widgets de distinto tipo, como por ejemplo: Campo Texto, Campo Lista, Campo número, etc.
Para el caso del ejemplo, se puede visualizar que el formulario cuenta con 4 widgets. A priori no se pude deducir exactamente que tipo de widget es cada uno, sin embargo podemos inferir que el widget con id FWFFs0qST es un CAMPO FECHA.
Dependiendo del tipo de widget, es el tipo de valor obtenido. Un widget de tipo Texto, contendrá un string, mientras que uno de tipo Numero contendra un number. Ver todos los widgets disponibles en la siguiente sección: Tipos de Widgets
Para conocer los Ids de los widgets Identificación de Formularios
Last updated