30May, 2017
0Comentarios

¿Cómo actualizar una lista externa usando el API de Kizeo Forms?

 

El articulo « Trucos y Consejos » de hoy está pensado para los más expertos de ustedes y requiere un buen conocimiento en desarrollo informático y un buen manejo de las opciones de Kizeo Forms. 

Si Usted usa de manera frecuente las listas externas con datos bien específicos a su empresa como los contactos de sus clientes o inventarios de material disponible le resultará muy útil que estas listas se actualicen automáticamente. Eso es posible configurarlo usando nuestro API.

1. Haga el inventario de sus listas externas

La primera etapa consiste en recuperar la lista de todas sus listas externas utilizando una solicitud typo GET en el URL siguiente:  https://www.kizeoforms.com/lists/.

Esta etapa le permitirá recuperar el identificador (“id”) de cada una de sus listas externas asociadas con su nombre. Este “id” es él que le servirá para usar las opciones que vamos a ver a continuación.

Recuperará sus datos de la siguiente manera:

[
    {
        "id1": "Numero_lista_1",
        "name1": "Nombre_lista_1"
    },
    {
        "id2": "Numero_lista_2",
        "name2": "Nombre_lista_2"
    },
    {
        "id3": "Numero_lista_3",
        "name3": "Nombre_lista_3"
    }
]

2. Recupere todos los elementos de sus listas externas

La próxima etapa es recuperar la lista externa que desea actualizar utilizando su identificador, lo cual consiguió en la solicitud que mencionamos antes.

¡Ojo! Es necesario repetir esta operación para cada lista externa que quiere actualizar.

Para tener una versión completa sin aplicar filtro sobre la selección de sus elementos, sólo necesita pedir una solicitud de typo GET al siguiente URL   https://www.kizeoforms.com/lists/{listId}/complete

Dos detalles importantes:

  • No se olvide insertar su token de identificación al principio de su solicitud
  • Sustituya {listId} por el identificador de la lista que desea actualizar.

Recibirá su lista en el formato JSON:

 {
    "id": "integer",
    "name": "string",
    "items": [
        "Element1",
        "Element2",
        "Element3"
    ]
}

id” siendo el identificador de la lista pedida, “name” el nombre de la lista y “items” la tabla que contiene todos los elementos de la lista como string.

Después, sólo le hará falta añadir a esta lista los elementos que quiere poner en su lista externa. Luego, tendrá que enviar una solicitud de tipo PUT al siguiente URL: https://www.kizeoforms.com/lists/{listId}

Agregando adentro de esta solicitud la lista que acaba de modificar, la que contiene los viejos y nuevos elementos, sin volver a mencionar su identificador ni su nombre.

Por ejemplo:

{
    "items": [
        "Elemento1",
        "Elemento2",
        "Elemento3",
        "Nuevo_Elemento1",
        "Nuevo_Elemento2"
    ]
}

¡Ojo! Si sólo envia los nuevos elementos en esta solicitud, entonces los viejos elementos de la lista que no aparecen adentro de esta solicitud PUT serán suprimidos.

¡Deje su comentario acerca de este articulo!
¡Comparta sus dudas, sugerencias o preguntas y con gusto se las contestaremos !

Dejar un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *