# Script de importación

# ¿Qué es el script de importación?

El script de importación es donde se encuentran las distintas rutinas de importación de datos desarrolladas para cada uno de los métodos de importación (archivos xlsx, archivos csv, consultas a bases de datos).

<p class="callout info">Para conocer más aspectos teóricos visitar [¿Qué son los tipos de importación?](https://grama.ar/documentacion/books/tipos-de-importacion/page/que-son-los-tipos-de-importacion)</p>

---

### Proceso de importación

A continuación se detallan los procesos de importación de datos que efectúa el script de acuerdo al método que se haya definido.

#### Importación de archivos xlsx

Diagrama esquemático del proceso que realiza el script de importación de datos para archivos excel (xls y xlsx).

[![import-xlsx.png](https://grama.ar/documentacion/uploads/images/gallery/2022-11/scaled-1680-/import-xlsx.png)](https://grama.ar/documentacion/uploads/images/gallery/2022-11/import-xlsx.png)

---

#### Importación de archivos csv

Diagrama esquemático del proceso que realiza el script de importación de datos para archivos csv.

[![import-csv.png](https://grama.ar/documentacion/uploads/images/gallery/2022-11/scaled-1680-/import-csv.png)](https://grama.ar/documentacion/uploads/images/gallery/2022-11/import-csv.png)

---

#### Importación por conexión a base de datos

Diagrama esquemático del proceso que realiza el script de importación de datos para conexiones con base de datos.

[![import-bd.png](https://grama.ar/documentacion/uploads/images/gallery/2022-11/scaled-1680-/import-bd.png)](https://grama.ar/documentacion/uploads/images/gallery/2022-11/import-bd.png)

---

##### Contenidos relacionados

- [Guía práctica script de importación](https://grama.ar/documentacion/books/script-de-importacion/page/guia-practica-del-script-de-importacion)
- [Tipos de importación](https://grama.ar/documentacion/books/tipos-de-importacion)
- [Logs de importación](https://grama.ar/documentacion/books/logs-de-importacion)

# Guía práctica del script de importación

Esta guía contiene información y recomendaciones sobre el manejo del Script de importación. En la misma encontrará las siguientes funcionalidades:

- [Ejecución manual del script de importación](https://grama.ar/documentacion/books/script-de-importacion/page/guia-practica-del-script-de-importacion#bkmrk-ejecuci%C3%B3n-manual)
- [Ejecución automática del script de importación](https://grama.ar/documentacion/books/script-de-importacion/page/guia-practica-del-script-de-importacion#bkmrk-ejecuci%C3%B3n-autom%C3%A1tica)

<p class="callout info">Para conocer más aspectos teóricos visitar [¿Qué es el script de importación?](https://grama.ar/documentacion/books/script-de-importacion/page/que-es-el-script-de-importacion)</p>

---

### Ejecución manual

#### Desde tipos de importación

Uno de los métodos para ejecutar el script de importación de datos para un tipo de importación se encuentra en la pantalla "Tipos de importación". En la grilla se dispone de un botón para ejecutar el mismo.

<div id="bkmrk--0" style="padding: 48.96% 0 0 0; position: relative;"><iframe allowfullscreen="allowfullscreen" frameborder="0" height="" src="https://player.vimeo.com/video/844638387?h=5630bfe740&title=0&byline=0&portrait=0" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" width=""></iframe>

</div>*Video: Ejecución manual de script de importación desde tipos de importación.*

---

##### Resumen de pasos

1. Buscar el tipo de importación en listado
2. Presionar “Ejecutar script”

---

#### Desde indicadores

También encontrará una opción para ejecutar el script de importación desde la pantalla del Indicador.

<div id="bkmrk--3" style="padding: 48.96% 0 0 0; position: relative;"><iframe allowfullscreen="allowfullscreen" frameborder="0" height="" src="https://player.vimeo.com/video/841924213?h=646695468e&title=0&byline=0&portrait=0" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" width=""></iframe>

</div>*Video: Ejecución manual de script de importación desde indicadores.*

---

##### Resumen de pasos

1. Buscar el indicador desde el listado de indicadores
2. Acceder al menú Datos
3. Presionar “Ejecutar script de importación"

---

### Ejecución automática

Es posible programar la ejecución automática del script de importación de datos mediante la configuración de cron jobs en el servidor donde se encuentra alojada la plataforma.

A continuación se detalla el comando a ejecutar:

```bash
/ROOT_PATH/yii import [SOURCE_ID]
```

<div id="bkmrk--6" style="padding: 48.96% 0 0 0; position: relative;"><iframe allowfullscreen="allowfullscreen" frameborder="0" height="" src="https://player.vimeo.com/video/847837341?h=4f67f8746a&title=0&byline=0&portrait=0" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" width=""></iframe>

</div>*Video: Ejecución automática de script de importación.*

<p class="callout info">ROOT\_PATH es la ruta hasta el directorio raíz donde se encuentra instalada la aplicación.</p>

<p class="callout info">SORUCE\_ID es opcional e indica el id del tipo de importación a ejecutar, si no se indica se ejecutan todos los tipos cuyo método no sea "Carga Manual".</p>

<p class="callout info">Si no conoce ROOT\_PATH y/o SORUCE\_ID en la pantalla de detalle del tipo de importación se encuentra el comando para ejecutar el script.</p>

Ejemplo de un cron job que se ejecuta el 1º de cada mes a las 00:00hs:

```bash
0 0 1 * * /ROOT_PATH/yii import SOURCE_ID
```