Vai al contenuto principale

La personalizzazione dell'export CSV dei dati di timbratura

Scritto da Fulvia Chesi

Con la configurazione predefinita, l'esportazione in formato CSV delle timbrature contiene le principali informazioni relative a ciascuna timbratura registrata, come l'ID esterno della persona che ha timbrato, la data, l'ora, la direzione della timbratura e la tecnologia di certificazione utilizzata.

Inviando una richiesta di personalizzazione dell'export CSV al team tecnico, è possibile modificare l'ordine delle informazioni esportate, rimuoverne alcune o aggiungerne altre, scegliendo i dati disponibili da un elenco.

Per poter inoltrare una richiesta di personalizzazione corretta, è necessario fornire una lista di tutte le informazioni che si desidera visualizzare, copiando il nome specifico della colonna “Attributo” dalla tabella presente in questo articolo. È importante includere anche le informazioni già presenti nel CSV esportato normalmente che si desidera mantenere, e indicare l'ordine in cui si vuole che vengano esportate.

Personalizza la configurazione dell'esportazione

Prima di cominciare:

L'elenco dei dati disponibili contiene un elenco dettagliato dei dati che è possibile aggiungere nell'esportazione in formato CSV, relativi al dispositivo e alla sede di timbratura, alla persona e all'azienda.

Per ogni dato esportato è possibile definire una lunghezza fissa, specificando il carattere da utilizzare per riempire (padding) i valori di lunghezza inferiore a quella prevista e la posizione in cui aggiungere il carattere (trailing/leading). Ad esempio, se la matricola inserita su Fluida è "1", può essere previsto che venga esportata come "00001".

Per la maggior parte dei dati esportati, specialmente quelli che prevedono un valore predefinito, è possibile indicare un diverso valore da esportare. Ad esempio, per la direzione della timbratura anziché IN/OUT, è possibile utilizzare Entrata/Uscita.

Possono inoltre essere aggiunti campi con valore fisso. Questa possibilità è utile se, ad esempio, il software in cui viene importato il file esportato da Fluida richiede un campo con un valore fisso preciso (es: "tipo_record").

È anche possibile personalizzare l'ordine degli elementi che compongono il file.

Infine, possono essere personalizzate le principali caratteristiche del file esportato:

  • Encoding del file (a scelta tra testo e CSV, che prevede l'escape dei caratteri e gestisce la correttezza formale del file).

  • Separatore dei dati (scegliendo, ad esempio, tra "," / "." / ";" oppure nessun separatore).

  • Separatore di riga (di default "a capo").

  • Nome del file.

  • Estensione del file (es: csv, txt - non necessariamente legata all'encoding).

  • Presenza o meno di una riga di intestazione.

Se necessiti di una personalizzazione, contatta support@fluida.io per verificarne la fattibilità.

Dati disponibili

Attributo

Tipo di dato

Note

UUID della timbratura

Testo

Identificativo univoco universale della timbratura

Data e ora di timbratura

Data

Nella timezone del dispositivo con cui è stata registrata la timbratura.

Il formato è personalizzabile

Timezone della timbratura

Testo

Direzione di timbratura

Valori predefiniti

Possibili valori:

  • NONE = presenza

  • IN = entrata

  • OUT = uscita

Tipologia "tecnica" di timbratura

Valori predefiniti

Possibili valori:

  • manual = Manuale/Forzata

  • remote = Certificata GPS

  • clock = Certificata BT/NFC

UUID del dispositivo di timbratura

Testo

Identificativo univoco universale del dispositivo di timbratura

Nome del dispositivo di timbratura

Testo

Solo per timbrature Bluetooth/NFC

Tipologia del dispositivo di timbratura

Valori predefiniti

Possibili valori:

  • NFC = dispositivo di timbratura NFC (es: Fluida Station)

  • BT = dispositivo di timbratura Bluetooth (es: Fluida Beacon)

UUID della sede di timbratura

Testo

Nome della sede di timbratura

Testo

ID esterno della sede di timbratura

Testo

Nome della persona che ha timbrato

Testo

Cognome della persona che ha timbrato

Testo

Codice fiscale della persona che ha timbrato

Testo

ID esterno della persona che ha timbrato

Testo

Codice badge della persona che ha timbrato

Testo

Solo per timbrature effettuate tramite Badge NFC

Matricola della persona che ha timbrato

Testo

Ruolo della persona che ha timbrato

Testo

Nome dell'azienda

Testo

Partita IVA dell'azienda

Testo

ID esterno dell'azienda (Codice azienda)

Testo

💡 Non è possibile aggiungere come attributo la data di competenza della timbratura (ad esempio in caso di timbrature notturne).

Hai ricevuto la risposta alla tua domanda?