Configurare il connettore generico di sincronizzazione dati

SmartOSH dispone di un modulo di importazione e sincronizzazione che consente di caricare dati in massa tramite un file di scambio (Excel o CSV) depositato su un server FTP. Questo documento descrive il formato, la denominazione e la configurazione necessaria per utilizzare il connettore generico.

Formati di file supportati

Excel (XLS / XLSX)

Il file di dati può essere fornito in formato Microsoft Excel (.xls o .xlsx). In questo formato, ogni tabella è rappresentata come una scheda (foglio) all’interno dello stesso file. I nomi e l’ordine delle schede devono corrispondere a quelli descritti nella specifica dei campi.

CSV

Può essere utilizzato anche il formato CSV, con un file per ogni tabella. Regole obbligatorie:

• Delimitatore: ;
• Carattere di escape per testi letterali: doppia virgoletta "
• Codifica: UTF-8
• Prima riga: nomi delle colonne

Esempio:

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

Fotografie dei dipendenti (opzionale)

Il file opzionale delle fotografie deve essere fornito come ZIP con le immagini nella directory radice, con estensione .jpg, .gif o .png.

Denominazione dei file

Il nome deve sempre iniziare con KB020 e includere, separati da trattino, i dati base del file.

Excel (XLS/XLSX)

Schema: KB020-ORDINE-Nome descrittivo.xlsx

Esempio: KB020-1000-Caricamento dati MiAzienda 20170622.xlsx

CSV

Poiché c’è un file per ogni tabella, il nome deve includere il nome della tabella invece del descrittivo. Il prefisso numerico garantisce il caricamento nell’ordine corretto.

Esempi:

• 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

Sistemi legacy con nomi brevi

Se per limitazioni tecniche il cliente non può usare nomi lunghi, può fornire i file con nome breve e aggiungere un file index.txt nella radice della cartella con le equivalenze.

Formato di ogni riga: [nomebreve];[nomelungo]

Esempio:

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

Posizione del file (FTP)

Il cliente deve depositare i file su un server FTP. Ci sono due opzioni:

• FTP sicuro proprio del cliente (FTP, FTPS o SFTP).
• FTP sicuro fornito da SmartOSH (richiedendolo al team di consulenza).

Se si utilizza il servizio di SmartOSH, i dati di connessione sono:

Parametro	Valore
Server	sync.smartosh.com
Tipo	FTP / FTPS
Utente	Fornito dalla consulenza
Password	Fornita dalla consulenza

Configurare il connettore in SmartOSH

1. Accedere al tenant corrispondente con un utente Amministratore.
2. Andare su Opzioni → Connessione dati e aggiungere un nuovo connettore con i seguenti valori:

Campo	Valore
Codice importazione	GENERIC
Tipo	FTP / FTPS (o SFTP se fornito dal cliente)
URL	sync.smartosh.com (o il server del cliente)
Percorso	Lasciare vuoto salvo indicazioni del supporto
Utente	Fornito dalla consulenza
Password	Fornita dalla consulenza
Attivo	Sì
Sovrascrivi	Sì

3. Salvare la configurazione.
4. L’importazione può essere forzata in qualsiasi momento con l’azione Sincronizza ora.

Server FTP del cliente

Se il cliente fornisce il proprio server, deve specificare il tipo (FTP / FTPS / SFTP) come appropriato. Per SFTP è consentito che i file siano in una sottocartella specifica, indicandola nel campo Percorso.

Contenuto dei file

• In Excel, le schede devono chiamarsi e ordinarsi come indicato nella specifica.
• In CSV, ogni tabella è in un file, con prefisso numerico per fissare l’ordine di caricamento.
• In ogni caso, sono incluse solo le colonne con dati da trasferire. Non è necessario creare tutte le colonne di tutti i campi.

Specifiche dettagliate dei campi

L’elenco completo delle schede, nomi delle tabelle e campi disponibili è pubblicato su smart.smartosh.com/kb020 (richiede autenticazione).

Allegato: errori controllati

Durante l’elaborazione, il connettore può emettere i seguenti errori:

Messaggio	Spiegazione
El formato no está correctamente definido y no se dispone de información sobre el mapeo '{0}'	Manca la colonna Operación nell’Excel.
No hay valor en la columna '{0}' y este es necesario, {1}	Mancano campi obbligatori o sono vuoti.
Se ha encontrado más de un registro a actualizar basándose en el identificador. La operación no puede continuar.	I record identificati dal codice devono essere unici.
No existe la {1} con Código {0} ni tampoco en los códigos equivalentes...	Errore dati: non è possibile determinare se inserire o aggiornare.
Error al asignar el valor '{0}' al campo '{1}'	Formato valore errato (dipende dal campo).
Error al EscribirFTP en la conexión	Problema di connessione o permessi nella scrittura su FTP.

Attenzione

Se una sincronizzazione termina con errori, controllare sempre lo storico del connettore prima di rilanciare l’operazione. Forzare Sincronizza ora con dati difettosi ripeterà solo l’errore.

---

Fonte: KB020 «Connettore generico per la sincronizzazione dei dati tramite file di scambio», modulo Consulenza, versione 1.5, 19-04-2021.