Configurar el connector genèric de sincronització de dades

SmartOSH disposa d’un mòdul d’importació i sincronització que permet carregar dades massivament mitjançant un arxiu d’intercanvi (Excel o CSV) dipositat en un servidor FTP. Aquest document descriu el format, el nomenat i la configuració necessària per usar el connector genèric.

Formats d’arxiu admesos

Excel (XLS / XLSX)

L’arxiu de dades pot lliurar-se en format Microsoft Excel (.xls o .xlsx). En aquest format, cada taula es representa com una pestanya (fulla) dins del mateix llibre. Els noms i l’ordre de les pestanyes han de coincidir amb els descrits a l’especificació de camps.

CSV

També es pot usar CSV, amb un arxiu per a cada taula. Regles obligatòries:

• Delimitador: ;
• Caràcter d’escapament per a textos literals: cometa doble "
• Codificació: UTF-8
• Primera fila: noms de columnes

Exemple:

Codigo;Nombre;TipoIdentificacion;Identificador
001;ACME S.A.;0;A554668987
002;"LUSIANA S.A";0;A00046879

Fotografies d’empleat (opcional)

L’arxiu opcional de fotografies ha de lliurar-se com a ZIP amb les imatges al directori arrel, amb extensió .jpg, .gif o .png.

Nomenat d’arxius

El nom ha de començar sempre per KB020 i incloure, separats per guió, les dades bàsiques de l’arxiu.

Excel (XLS/XLSX)

Patró: KB020-ORDEN-Nom descriptiu.xlsx

Exemple: KB020-1000-Càrrega dades MiEmpresa 20170622.xlsx

CSV

Com que hi ha un arxiu per taula, el nom ha d’incloure el nom de la taula en lloc del descriptiu. El prefix numèric garanteix que es carreguin en l’ordre correcte.

Exemples:

• KB020-100-Empresas.csv
• KB020-200-Centros.csv
• KB020-300-Secciones.csv
• KB020-400-Puestos.csv
• KB020-500-Empleados.csv
• KB020-600-Asignaciones.csv
• KB020-700-InvestigacionAccidente.csv
• KB020-800-Formaciones.csv
• KB020-900-Convocatorias.csv
• KB020-1000-Convalidaciones.csv
• KB020-1100-SesionesFormativas.csv
• KB020-1200-AccionesFormativas.csv
• KB020-1300-Cargo.csv
• KB020-1400-AsignacionCargo.csv

Sistemes legacy amb noms curts

Si per limitacions tècniques el client no pot usar noms llargs, pot lliurar els arxius amb nom curt i afegir un arxiu index.txt a l’arrel de la carpeta amb les equivalències.

Format de cada línia: [nomcurt];[nomllarg]

Exemple:

emp.csv;KB020-100-Empresas.csv
cen.csv;KB020-200-Centros.csv
secci.csv;KB020-300-Secciones.csv

Ubicació de l’arxiu (FTP)

El client ha de dipositar els arxius en un servidor FTP. Hi ha dues opcions:

• FTP segur propi del client (FTP, FTPS o SFTP).
• FTP segur proporcionat per Smart OSH (sol·licitant-ho a l’equip de consultoria).

Si s’usa el servei de Smart OSH, les dades de connexió són:

Paràmetre	Valor
Servidor	sync.smartosh.com
Tipus	FTP / FTPS
Usuari	Proporcionat per consultoria
Contrasenya	Proporcionada per consultoria

Configurar el connector a SmartOSH

1. Accedir al tenant corresponent amb un usuari Administrador.
2. Anar a Opcions → Connexió de dades i afegir un nou connector amb els següents valors:

Camp	Valor
Codi importació	GENERIC
Tipus	FTP / FTPS (o SFTP si el proporciona el client)
URL	sync.smartosh.com (o el servidor del client)
Ruta	Deixar en blanc excepte indicació de suport
Usuari	Proporcionat per consultoria
Contrasenya	Proporcionada per consultoria
Actiu	Sí
Sobreescriure	Sí

3. Guardar la configuració.
4. La importació es pot forçar en qualsevol moment amb l’acció Sincronitzar ara.

Servidor FTP del client

Si el client proporciona el seu propi servidor, s’ha d’especificar el tipus (FTP / FTPS / SFTP) segons correspongui. Per a SFTP s’admet que els arxius estiguin en una subcarpeta concreta, indicant-la al camp Ruta.

Contingut dels arxius

• En Excel, les pestanyes han de dir-se i ordenar-se com indica l’especificació.
• En CSV, cada taula va en un arxiu, amb prefix numèric per fixar l’ordre de càrrega.
• En qualsevol cas, només s’inclouen les columnes amb dades a traspassar. No cal crear totes les columnes de tots els camps.

Especificació detallada de camps

La llista completa de pestanyes, noms de taules i camps disponibles està publicada a smart.smartosh.com/kb020 (requereix autenticació).

Annex: errors controlats

Durant el processament, el connector pot emetre els següents errors:

Missatge	Explicació
El formato no está correctamente definido y no se dispone de información sobre el mapeo '{0}'	Falta la columna Operació a l’Excel.
No hay valor en la columna '{0}' y este es necesario, {1}	Falten camps obligatoris o estan buits.
Se ha encontrado más de un registro a actualizar basándose en el identificador. La operación no puede continuar.	Els registres identificats per codi han de ser únics.
No existe la {1} con Código {0} ni tampoco en los códigos equivalentes...	Error de dades: no es pot determinar si inserir o actualitzar.
Error al asignar el valor '{0}' al campo '{1}'	Format incorrecte del valor (depèn del camp).
Error al EscribirFTP en la conexión	Problema de connexió o permisos en escriure al FTP.

Precaució

Si una sincronització finalitza amb errors, revisi sempre l’historial del connector abans de relançar l’operació. Forçar Sincronitzar ara amb dades defectuoses només repetirà l’error.

---

Font: KB020 «Connector genèric per a la sincronització de dades via arxius d’intercanvi», mòdul Consultoria, versió 1.5, 19-04-2021.