Ver el código de «SIU-Kolla/Version 4.4.0/Documentacion de las operaciones/menu usuarios importacion encuestados/importar personas desde archivo»

== Importar Personas desde archivo ==


La operación de Importar Personas permite incorporar a SIU-Kolla usuarios de otras fuentes de manera masiva. El objetivo es facilitar el alta de los usuarios evitando realizar el alta manual de cada una de ellos. En la siguiente pantalla se muestra en la opción de menú '''Importación de Encuestados''' -> '''Importar Personas desde Archivo'''.

[[archivo:KOL_K4_Importacion_Archivo1_V4.png]]

=== Archivo de Importación ===

Para llevar a cabo la '''Importación de Personas desde Archivo''' es necesario contar con un archivo de texto plano (txt) que cumpla con los siguientes requisitos:

1) El archivo debe contener los datos de '''''un''''' usuario por '''''cada''''' línea de texto.

2) En cada línea se deben incluir, en orden, los siguientes datos y separados mediante el carácter seleccionado. Este separador puede ser coma ''',''' o punto y coma ''';'''

* '''usuario'''
* '''clave''' ''(Si este dato se encuentra vacío SIU-Kolla generará una clave aleatoria que deberá ser recuperada luego.)''
* '''metodo_de_encriptacion''' ''(Puede elegirse entre los métodos: plano y bcrypt. Para método plano, se debe dejar el dato vacío. Para bcrypt la clave debe ingresarse ya encriptada. Ver ejemplos a continuación.)''
* '''apellidos'''
* '''nombres'''
* '''pais''' ''(Por ejemplo para Argentina es 54)''
* '''tipo_documento''' ''(Ingresar "0" para DNI)'''*'''''
* '''numero_documento'''
* '''sexo''' ''(F o M)''
* '''fecha_nacimiento''' ''(DD/MM/AAAA)''
* '''e-mail'''


'''''(*)''' Tipos de documentos posibles: <br>''
''0 = Documento Nacional de Identidad <br>''
''1 = Doc. Nac. de Identidad Temporario <br>''
''2 = Cédula de Identidad <br>''
''3 = CUIL/CUIT <br>''
''18 = Libreta de Enrolamiento <br>''
''19 = Libreta Cívica <br>''
''90 = Pasaporte <br>''


''Todos los datos son de carácter obligatorio, excepto si se elije una encriptación plana para la Clave. En tal caso, no se especificará dato alguno y se dejará un espacio en blanco en el archivo.''

==== Ejemplo con Claves Encriptadas ====

<source lang="php" enclose="div">
rlopez,$2y$12$40kSRT4X4E8ZbbpFT.6GiuHZ3SsQEy90oPkFTNSlKmyul.6eVgg.C,bcrypt,Lopez,Roberto,54,0,32453123,M,17/12/1990,rlopez@uni.edu.ar
sgoyco,$2y$12$oTFrDH2geNsFAUWDw4inH.1/vqrkweOx4CBYBPWag6T8JUxErJggG,bcrypt,Goyco,Susana,54,0,274523421,F,12/02/1983,sgoyco@uni.edu.ar
dricardi,$2y$12$woE/3eCeOj.cBVpzMKI2s.NjPU4OWraiCGT0UecHWj5Tj9Zm3.Z7m,bcrypt,Ricardi,Daniel,54,0,328873459,M,04/09/1982,dricardi@uni.edu.ar
</source>

==== Ejemplo con Claves Sin Encriptación (Plana) ====

<source lang="php" enclose="div">
rlopez,123456789*-a,,Lopez,Roberto,54,0,32453123,M,17/12/1990,rlopez@uni.edu.ar
sgoyco,389657921*-a,,Goyco,Susana,54,0,274523421,F,12/02/1983,sgoyco@uni.edu.ar
dricardi,426859632*-a,,Ricardi,Daniel,54,0,328873459,M,04/09/1982,dricardi@uni.edu.ar
</source>
<br>

=== Selección de Archivo ===

En el primer paso, la operación solicitará los siguientes datos:

En el campo '''Archivo''' mediante la opción ''Examinar'', se podrá seleccionar el archivo para la importación. Es importante respetar el formato y tipo de archivo, se tratan de archivos de texto plano con extensión "csv".

En el campo '''Separador de campos''' debe indicarse el caracter que se utilizó como separador, tener en cuenta que el separador puede ser el '''Punto y Coma''' (''';''') o bien la '''Coma'''(''',''').

[[Archivo:KOL_K4_Importacion_Archivo2.png]]

=== Grupo de Encuestados ===

En el segundo paso de la operación, se mostrarán las siguientes opciones:

Si se desea utilizar un Grupo que ya fue creado, se deberá indicar la opción ''Existente'' y a continuación completar el campo Grupo que se desea utilizar para incorporar en el mismo los encuestados que se estarán importando. 

Si por otro lado se desea crear un nuevo Grupo se deberá cliquear el  botón ''Nuevo'' y a continuación seleccionar la ''Unidad de Gestión'' en la que se desea agregar el nuevo grupo de encuestados. Por último el ''Nombre'' que se le desea asignar.

[[Archivo:KOL_K4_Usuarios_ImportarArchivo.png]]

Si al importar los encuestados se desea actualizar los datos de la persona que ya existe en Kolla se debe seleccionar la opción ''Existente''. SIU-Kolla actualizará los siguientes datos:

<source lang="php" enclose="div">
        - Apellidos
        - Nombres
        - Sexo
        - Fecha de nacimiento
        - E-mail
   </source>


Mediante la opción '''Importar''' se dará comienzo al proceso de importación de encuestados. Posteriormente se mostrará un mensaje de '''Alerta''' que confirma la opción deseada.

[[Archivo:KOL_K4_Usuarios_ImportarArchivo2.png]]


Una vez finalizada la importación, si la misma concluye correctamente, desplegará el siguiente mensaje:


[[Archivo:KOL_K4_Usuarios_ImportarArchivo3.png]]

=== Resumen de Importación ===

En este paso se muestra el resumen de importación o actualización.

[[Archivo:KOL_K4_Usuarios_ImportarArchivo4.png]]

=== Integración con SIU-Araí ===

En caso de que SIU-Kolla se encuentre vinculado a SIU-Araí el proceso de importación por archivo vinculará estos nuevos usuarios con los ya existentes en SIU-Araí, utilizando el DNI como dato de identificación.

También se mostrará la cifra de usuarios correcta o incorrectamente importados en la vista de resumen final.


<small>[[#Importar Datos de Personas desde archivo|Subir]]</small>


[[SIU-Kolla/Version_4.4.0/Documentacion_de_las_operaciones/menu_usuarios_importacion_encuestados#Importación de Encuestados| < Volver]]