Antes de empezar
Esta ficha explica cómo obtener la lista de secciones analíticas de una instancia Lucca. Está dirigida a los administradores avanzados.
Para recuperar los datos se deben seguir tres pasos:
- Elaboración de la solicitud API
- Generación de la solicitud
- Explotación de la respuesta
Elaborar la solicitud API y recuperar los datos
La interfaz actual de gestión de ejes analíticos no permite recuperar la lista de secciones analíticas. Para recuperarla, debe presentar una solicitud API.
Para construir esta consulta, puede consultar la documentación correspondiente.
Cuerpo de la solicitud
La solicitud siempre empieza con la URL de su base de datos, por lo que necesitará el nombre de su instancia: por ejemplo,{NomInstance} seguido de /api/v3/axisSections, que indica que desea recuperar las secciones de ejes analíticos.
Esto resulta en https://{NomInstance}.ilucca.net/api/v3/axisSections
Selección de los campos que se mostrarán
A continuación, seleccione los campos que desea mostrar y añádalos después de ...axisSections?fields=, separándolos todos con una coma.
Por ejemplo, si quiere el identificador, el nombre, el código y si está activo o no, esto resulta en https://{NomInstance}.ilucca.net/api/v3/axisSections?fields=id,name,code,active
¿Qué campos se pueden recuperar?
Depende de lo que necesite, pero estos son los campos más utilizados:
Nombre del campo | Descripción |
Identificador | Corresponde al identificador único de la sección. Es necesario si quiere editar el código de una sección a través de una importación. |
Name | Nombre de la sección |
Código | Código de la sección Indispensable en caso de importación |
AxisId | Identificador del eje al que corresponde la sección Indispensable en caso de importación |
Active | Indica si la sección se ha archivado (active = false) o no. |
Owner | Responsable de la sección analítica |
ParentAxisSections | Secciones del eje principal al que está vinculada la sección |
Departments | Si hay restricciones de acceso, los departamentos con acceso a la sección. |
LegalEntities | Si hay restricciones de acceso, los establecimientos con acceso a la sección. |
Users | Si hay restricciones de acceso, los usuarios con acceso a la sección. |
También puede buscar en esta imagen:
(Opcional) Filtrado en el eje
A continuación, por ejemplo, puede filtrar el eje deseado.
Para ello, debe recuperar el identificador del eje. Si decide mostrar aquí las secciones del eje analítico «Test», deberá utilizar el identificador 8:
A continuación, debe añadirlo a la URL después de ...?fields=...&axisId=
. En el caso de este eje analítico con identificador 8, se obtiene: https://{NomInstance}.ilucca.net/api/v3/axisSections?fields=id,name,code,active&axisId=8
Generar la solicitud
Una vez finalizada la solicitud, lo más fácil es ir a su navegador y hacer clic en la URL creada.
Asegúrese de utilizar un navegador en el que se haya conectado recientemente a Lucca.
Utilizar el resultado de la solicitud
La respuesta a esta solicitud se dará en formato JSON. Podrá utilizar fácilmente una herramienta que convertirá este formato en formato Excel (ejemplo: http://www.convertcsv.com/json-to-csv.htm).
Por lo general, basta con copiar la respuesta en formato JSON en la herramienta seleccionada para obtener un archivo en formato Excel.
La parte de la respuesta que hay que copiar aparece resaltada en esta imagen:
Para el ejemplo del sitio web https://www.convertcsv.com/json-to-csv.htm, basta con copiarlo aquí:
En la sección Resultado, verá la versión Excel o CSV.
También podrá utilizar este archivo para volver a importarlo si necesita realizar ediciones. En este caso, asegúrese de poner el ID en los campos y colocarlo en la primera columna, o en su defecto el código de sección, luego ponga el archivo en formato CSV separándolo con «;». En el ejemplo de este sitio web, está en la pestaña «opciones».