---
title: "Importar datos a una ontología desde fichero vía API"
canonical: "https://onesaitplatform-es.refined.site/space/DOC/2215919630/Importar%20datos%20a%20una%20ontolog%C3%ADa%20desde%20fichero%20v%C3%ADa%20API"
format: markdown
---
ES | [EN](https://onesaitplatform.atlassian.net/wiki/spaces/DOC/pages/2215919539)  

> Macro (toc)

## Introducción

Con la herramienta Import tool de plataforma es posible volcar los datos de un fichero CSV, JSON o XML sobre una ontología ya existente o sobre una nueva (ver [https://onesaitplatform.atlassian.net/wiki/spaces/DOC/pages/2215919434](https://onesaitplatform.atlassian.net/wiki/spaces/DOC/pages/2215919434) ). Esta herramienta también se encuentra apificada, por lo que se puede invocar vía API a través de una sencilla petición HTTP REST.


## Invocación desde Swagger

Si accedemos a las APIs del Control Panel desde la cabecera y buscamos en el desplegable la opción “Import tool”, nos aparecerá la interfaz Swagger de dicha API:

![image](media://fc58a3fb-94a1-4fef-886e-cbbaa21091cd)


![image](media://7907127f-dc2b-412a-95d7-da5f596179dc)


![image](media://4e04a88b-85c2-4993-b548-51dede6871d4)

Y una operación POST para hacer la importación:

![image](media://1870dd88-5cc7-4092-b367-704a0dc4d21d)

Seleccionamos esta operación y rellenamos los parámetros:

- **Authorization: **se introduce en la cabecera de la petición y representa el token Oauth2 del usuario. Se puede obtener pulsando en el botón APIs de la cabecera del Panel de Control.
- **newOntology: **indica si se quiere crear una nueva ontología (*true*) donde volcar los datos del fichero o hacerlo sobre una existente (*false*).
- **ontologyName: **nombre de la ontología donde se van a importar los datos del fichero. Si el campo newOntology está a *false*, tendrá que ser el nombre de una ontología existente y a la que el usuario tenga permiso. Si, por el contrario, está a *true*, tendrá que ser un nombre de ontología válido y que no exista una ontología con el mismo nombre.
- **ontologyDescription: **breve descripción de la ontología nueva que se va a crear para importar los datos. Este parámetro solamente es obligatorio rellenarlo si se ha marcado newOntology a *true*.
- **file: **fichero CSV, XML o JSON con los datos a importar.

![image](media://b16fe9db-8fbd-432a-8c09-8b1d8123b32b)

Una vez rellenados estos parámetros, pulsamos sobre Execute y, si todo ha funcionado correctamente, el resultado será un código 200. 

![image](media://3c01c9bb-a7e3-415a-9eaf-54ae22eee105)

Si accedemos al listado de ontologías (DEVELOPMENT → My Ontologies), podremos ver nuestra nueva ontología creada:

![image](media://675b7d04-aa02-4fc2-bb33-bcc2d45c33bb)

![image](media://0a9f7f11-fd20-4581-aabd-0b6c93307394)

Y desde la herramienta de consultas (TOOLS → Query Tool), veremos que se han insertado correctamente los datos:

![image](media://19c475bc-662f-418e-acae-1d160468131a)


## Invocación desde Postman

Si disponemos de la aplicación Postman podemos realizar la petición HTTP desde ahí. En este caso vamos a importar un dato nuevo desde un fichero JSON a la ontología ya existente Restaurants.

Para ello, seleccionamos POST como método HTTP, configuramos la URL de la API y rellenamos los parámetros necesarios desde la pestaña Params:

![image](media://afedc41f-13e4-42ba-addc-5218f2e319d7)

En las cabeceras de la petición incluimos el token Oauth2:

![image](media://8bf133b4-c7d7-4236-8a14-3a6bde091741)

Finalmente, en el cuerpo de la petición incluimos el fichero:

![image](media://e8b250b0-c5b7-4190-ab71-897488ad22fa)

Pulsamos sobre el botón Send y, si la petición nos ha devuelto un código 200: 

![image](media://0a5ee6b1-cfa0-462d-a139-f40a88e12b1c)

Podemos acceder a la herramienta de consultas (TOOLS → Query Tool) del Panel de Control para comprobar que se ha insertado ese nuevo dato correctamente:

![image](media://9c014227-118d-4838-9481-f48f06b683f9)