Introduzione

Dopo aver creato e configurato un modello di importazione, l'ultima parte da impostare è la mappatura dei campi. Questa parte permette di indicare al sistema quali campi presenti nel file importato devono essere scritti dentro quali campi presenti su Altamira e selezionati tramite la maschera associata al modello di importazione.

Per accedere alla mappatura di un modello di importazione vai in Impostazioni > Modelli > Importazione. Seleziona il modello di importazione e clicca sul pulsante Mappatura.

In questa pagina clicca su Aggiungi per generare la mappatura di un campo. Inserisci quindi una riga per ogni campo da importare.

Campo Origine e Destinazione

Campo Destinazione è il campo sui cui si decide di scrivere i dati che si importano da un determinato campo presente nel file da importare. Il nome di questo campo viene indicato invece in Campo origine.

Esitono più modi per importare\scrivere sul campo indicato in Campo Destinazione:

• Puoi utilizzare il campo Campo Origine inserendo il nome della colonna del file excel per esempio. E' possibile anche fare la somma di più campi e inserire del testo tra loro tramite le virgolette. Esempio : NomeCampo1 + "/" + NomeCampo2
• Puoi utilizzare il campo Valore di default insrendo un valore che verrà scritto per in maniera identica per tutti i record che importeremo.
• Puoi entrare nella modifica della riga di mappatura, cliccando sull'icona di modifica a sinistra del Campo Origine. Qui è possibile inserire uno script che permette di manipolari i dati del file utilizzato per l'importazione e di dedicedere in questo modo cosa importare in modo più specifici. In questo caso non è necessario specificare nulla nel campo Campo Origine in quanto sarà lo script a restituire il valore da scrivere nel campo Campo Destinazione.

Modifica avanzata mappatura

Cliccando sull'icona di modifica a sinistra del Campo Origine puoi entrare nella schermata di modifica avanzata della riga di mappatura in questione. In questa schermata puoi utilizzare del campi aggiuntivi:

• Filtro su sorgente : in questo campo si inserisce un valore presente nel campo in questione per cui verrà filtrato il file dell'importazione. Si può quindi decidere di importare solo quelle righe per cui il valore di un determinato campo è uguale a quello inserito in questo filtro. Per esempio solo i redisui di tipo ferie, solo i candidati di un certo comune e via dicendo.
• View di lookup : 
  
  • di seguito sono elencati i campi da configurare per utilizzare la view di lookup all'interno della mappatura dei campi del modello di importazione (prima di configurare questi campi bisogna creare e configurare correttamente la vista in questione seguendo le indicazioni nell'articolo Modello di importazione: view di lookup :
    
    • Entità : qui si indica l'entità in cui è presente la vista (di tipo Report - Tabella) che sarà usata come view di lookup.
    • View di lookup : qui si indica la vista da utilizzare come view di lookup
    • Campo di contenuti nella view di lookup : qui si indica il campo, presente nella vista sopra indicata, che bisogna restituire con il risultato della view di lookup. Come esempio si può vedere la spiegazione del modello di importazione delle timbrature (creare articolo e inserire link).
  • la view di lookup si utilizza in due casi:  
    • quando si hanno almeno due campi su cui filtrare un'entità\tabella secondaria legata a quella su cui si sta importando. Non potendo utilizzare due campi impostati come chiave secondaria che fanno riferimento alla stessa entità tramite la configurazione standard della mappatura, questa è la soluzione da utilizzare.
    • quando si vuole fare un collegamento con un'entità\tabella a cui la tabella su cui importiamo non è collegata. La view di lookup infatti permette di fare ricerche su qualunque tabella.
• Script : all'interno di questo campo si possono scrivere degli script nel linguaggio C#. Questi script permettono di manipolare i dati che stiamo importando per svariate situazioni. Alcuni script utilizati sono disponibile nell'articolo Modello di importazione : Script.

Chiave primaria e Chiave secondaria

Impostare questi parametri serve a far fare delle ricerche specifiche al sistema per identificare i record su cui scrivere i dati.

• Campo Chiave : i campi impostati come chiave fanno riferimento alla tabella su cui si stanno importando i dati. Il campo o la combinazione di campi che hanno questa opzione attiva sono i campi identificativi del record che si devono scrivere.
  • Se si volessero scrivere i dati anagrafici del dipednente il campo chiave potrebbe essere il codice fiscale o l'indirizzo mail in quanto identificativo di ogni dipendente. Quindi i campi impostati qui sono quelli che rendono univoco un record rispetto ad un altro.
  • Se il sistema trova un record con i valori importati lo scrive aggiornandolo, altrimenti lo crea.
  • Se l'opzione del modello di importazione "Aggiungi automaticamente gli elementi principale se non sono già presenti" è disattiva, il record non vengono creati se i valori dei campi chiave non vengono trovati sul database.
• Chiave Secondaria : serve a fare un collegamento con un'altra entità da cui dipendono i dati che si stanno importando.
  • Un esempio di un caso in cui è possibile utilizzare un campo con come chiave secondaria senza impostarlo però come chiave primaria è quando è necessario scrivere l'ID di un'entità diversa da quella principale dentro un campo di quella principale, come ad esempio l'ID di un dipendente nell'import di un certificato medico, ma nel tracciato si ha a disposizione solo un altro campo di quell'entità, come il codice fiscale del dipendente.
    In questo caso il campo del codice fiscale dell'entità dei dipendenti (che non è quella principale) deve essere indicato come chiave secondaria. Il motore di importazione andrà a recuperare il DipendenteID utilizzando come filtro il Codice fiscale e lo scriverà dentro il record del certificato medico che stiamo importando.
    N.B. nel tracciato di questo esempio il campo ID dell'entità del certificato medico deve essere presente nel tracciato e deve essere indicato come "Campo chiave"
  • Selezionare entrambi i campi "Campo Chiave" e "Campo Chiave Secondario" solo quando il campo ID dell'entità non principale, a cui fa riferimento il nostro campo, deve esser utilizzato come filtro per trovare il record dell'entità principale.
    Come il campo "Codice fiscale" dell'entità dei dipendenti nell'importazione dei cedolini. In questo caso tipicamente si hanno due campi indicati come "Campo chiave": il primo è il mese del cedolino (che risiede nell'entità dei cedolini) ed il secondo è il codice fiscale dei dipendenti, che è indicato anche come "Campo Chiave Secondario". Questo perchè anche l'ID del dipendente, oltre al mese del cedolino, deve essere utilizzato come filtro per individuare la riga dell'entità dei cedolini da inserire/modificare.
    ATTENZIONE: se il campo in cui si selezionano entrambe le flag è presente nell'entità principale della view questo verrà si utilizzato per trovare il record, ma non verrà scritto dall'import.
  • Non si possono utilizzare due campi come chiave secondarie che fanno riferimento alla stessa tabella. In quel caso bisogna usare le view di lookup. Se infatti volessimo impostare come chiave primaria il cognome e nome di un dipendente, questo andrebbe fatto utilizzando un solo campo e non due (quindi "cognome e nome" chiave secondaria e non "cognome" e "nome" come chiavi secondarie". Eventualmente si può mettere nel campo origine "cognome + " " + nome" se avessi due campi separati nel file da importare).