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 dipendento i dati che si stanno importando.
  • Esempio da inserire di un caso in cui sia possibile utilizzare un campo con come chiave secondaria senza impostarlo però come chiave primaria *punto da completare*
  • Selezionando entrambi i campi Campo Chiave e Campo Chiave Secondario *punto da completare*
  • 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).