Exportación de datos configurable

En este caso vamos a explicar cómo subir un documento a la plataforma y etiquetarlo con ciertas etiquetas en caso de desearlo

Requerimientos

1) Nuestro access_token. Para ello mostramos como hacerlo en el siguiente tutorial: Login

2) Las Etiqueta/s (OPCIONAL)

  • El identificador (uniqueId) de la etiqueta
  • Los identificadores (uniqueId) de los campos de la etiqueta. (En el caso de que queramos insertar datos en los campos)

En este caso lo llevaremos a cabo con la siguiente etiqueta:

etiq

Que tiene los siguientes campos:

campos etiq

Una vez conseguida dicha información vamos a mostrar como llevar a cabo la llamada a nuestra API a través de la aplicación POSTMAN que nos facilitará la explicación de dicha llamada.




Configuración de la llamada


Method

  • POST
  • URL: https://www.gladtolink.com:8080/API/export/{uniqueId-Exportacion}/filter/{uniqueId-Filtro}/data



Par obtener la url lo podemos hacer de forma sencilla desde la modal de la exportación:
clipboard exportacion con filtro

Y a continuación copiando el enlace dado:

clipboard exportacion con filtro2

Header

  • Authorization (Bearer Token): Lugar de nuestro access_token
  • Content-Type: en formato application/json

En la siguiente imágen se puede ver como quedaría dicha configuración:

export header


Body

En el body de la llamada será un texto en tipo json que contiene:

  • tags: Representa el listado de etiquetas que queremos que tenga nuestra exportación
    • uniqueId: Es el uniqueId de la etiqueta
    • forms: Representa el listado de campos que queremos que contenga la etiqueta
      • uniqueId: Es el uniqueId del campo
      • value: Es el valor que queremos que tenga el campo

En la siguiente imagen podemos ver el ejemplo de como queda, y el resultado de tal petición:

export body


Código body de ejemplo:

  {
    "tags": [
    	{
    	    "uniqueId": "cfcf0472-f3e4-4086-a49d-c0826435e9d6",
    	    "forms": [
		{
		     "uniqueId": "e4ef7fcd-067c-40ea-9cc4-359b89305369",
		     "value": "John"
  	        }
    	    ]
    	 }
     ]
  }