Estrattore dati - Utilità

Transcript

1 Estrattore dati - Utilità Documento aggiornato al 19 Aprile 2019 PREMESSA... 2 IMPORT/EXPORT DELLE ESTRAZIONI... 3 Gestione Import/Export delle Estrazioni... 3 Esportazione... 4 Esportazione di una singola estrazione... 4 Esportazione di più estrazioni... 4 Importazione... 5 COPIA ESTRAZIONE... 9 Gestione... 9 Configurazione ed utilizzo ESTRAZIONI SCHEDULATE Pag. 1/15

2 PREMESSA Il presente documento ha lo scopo di indicare la gestione e le configurazioni utili al fine di poter gestire al meglio il modulo dell'estrattore Dati. Pag. 2/15

3 IMPORT/EXPORT DELLE ESTRAZIONI Gestione Import/Export delle Estrazioni Ogni estrazione creata può essere esportata dall'ambiente in cui è stata definita per essere poi importata/esportata in un altro ambiente di lavoro. Informazione fondamentale per l'export e l'import delle estrazioni, è il campo "Cod.riferimento" presente all'interno della Definizione dell'estrazione (da: Gestione Dati/Impostazioni/Estrattore Dati > Modifica > Importazione estrazione > Codice di riferimento). L'opzione, se indicata, verrà utilizzata dal sistema nella funzionalità di Importazione estrazioni per riconoscere se l'estrazione è già esistente; in quest'ultimo caso le estrazioni presenti, a parità di codice di riferimento, verranno completamente sostituite con i dati presenti nell'estrazione in importazione ad eccezione dei Modelli, ove presenti, e della sezione Autorizzazioni. Di seguito verranno riportate nel dettaglio la gestione dell Importazione e dell Esportazione delle Estrazioni. Pag. 3/15

4 Esportazione E' possibile eseguire la funzionalità di "Esportazione Estrazioni" in due diverse modalità : - per l export massiva, cliccando sull'opzione " - Opzioni per estrazioni selezionate > Esporta" (da: Gestione dati/impostazioni/definizione Estrazione) - per l export singola, cliccando sull'opzione " - Opzioni per estrazioni > Esporta" (da: Gestione dati/impostazioni/definizione Estrazione) posta a fianco di ogni estrazione. Esportazione di una singola estrazione Da Definizione Estrazione, dopo aver selezionato l estrazione interessata, dalla funzionalità Opzioni per estrazioni ( ) selezionare la voce Esporta. In base alla 'tipologia' di estrazione selezionata, viene generato un solo file XML (se non presenti modelli per quell'estrazione), oppure un file in formato ZIP nel caso in cui l'estrazione esportata presenti dei modelli Excel oppure Stampa Unione. Esportazione di più estrazioni Da Definizione Estrazione, dopo aver selezionato le estrazioni interessate, dalla funzionalità Opzioni per estrazioni selezionate ( ) selezionare la voce Esporta. Pag. 4/15

5 Prima di procedere con l effettiva esportazione, verrà mostrato a video il seguente messaggio "Esportare le estrazioni selezionate?" Il file del salvataggio è in formato ZIP, poiché contiene più estrazioni. I file presenti in tale zip variano in funzione delle estrazioni esportate: nel caso in cui sono state selezionate estrazioni senza modelli RTF-Stampa Unione/XLS, allora i file saranno tutti in formato XLM. nel caso, invece, sono state selezionate estrazioni con modelli RTF-Stampa Unione/XLS, i file presenti nello zip saranno in formato XLM per quanto riguarda la definizione delle estrazioni, e di tipo RTF/XLS per quanto riguarda i modelli di stampa unione /excel allegati ad esse. Si precisa che, nel caso in cui nelle estrazioni sono presenti/definiti dei modelli (Rtf oppure XLS), in fase di esportazione verranno esportati solamente quei modelli definiti sull'azienda "Tutti i codici non definiti direttamente", in quanto gli altri modelli codificati su Azienda specifica sono propri dell'ambiente di lavoro. Importazione Affinchè sia possibile eseguire la funzionalità di "Importazione Estrazioni", da Definizione Estrazione " (da: Gestione dati/impostazioni/definizione Estrazione) selezionare la voce di Importa estrazioni. Pag. 5/15

6 Selezionare il file di definizione dell'estrazione premendo il bottone Aggiungi file. Nota: si precisa che il file da importare deve avere estensione XML o ZIP. I file con estensioni diverse non saranno importati. Dopo aver selezionato l'estrazione interessata, premere il bottone Start upload per caricare il file. Pag. 6/15

7 Nell'elenco vengono mostrate le estrazioni che potranno essere importate, con la relativa descrizione, il codice di riferimento, l'indicazione di estrazione "Già presente" e se presente una Forzatura. All interno della sezione Estrazione di destinazione Forzature è possibile inserire una forzatura per la descrizione dell estrazione e per il nome file che viene generato. Nel caso in cui venisse apportata una modifica ad una delle due descrizioni nell elenco la colonna Forz. assumerà il valore Sì. Si precisa che a parità di "Codice riferimento" è possibile indicare, nella sezione Estrazione di destinazione Forzature, in Operazioni da eseguire, se inserire l estrazione (selezionando l opzione Inserimento ) oppure se aggiornare quella già presente (selezionando l opzione Aggiornamento ). Pag. 7/15

8 Nel caso in cui la "Tipologia estrazione" non è codificata sull'impianto, l'estrazione verrà importata correttamente, ma nella configurazione il campo "Tipologia Estrazione" sarà vuoto. Per eseguire l'importazione è necessario prima selezionare le definizioni che si intendono importare e successivamente selezionare l opzione Importa. Al termine dell'esecuzione ne verrà data evidenza della corretta o meno importazione dell'estrazione. Pag. 8/15

9 COPIA ESTRAZIONE Gestione La funzionalità di "Copia estrazione" permette di eseguire una copia di un estrazione già presente sul portale, duplicandola. Affinchè sia possibile eseguire la copia di un estrazione, quella di partenza non deve essere definita sull Azienda "Tutti i codici non definiti direttamente". Inoltre, è possibile eseguire la copia solo nel momento in cui l estrazione ha il Codice di riferimento definito e risulta essere uguale a quella già presente a sistema. L informazione del Codice di riferimento viene impostata in fase di Definizione estrazione (da: Gestione Dati/Impostazioni/Estrattore dati/definizione Estrazione) nella sezione Importazione estrazione-codice di riferimento : Questa funzionalità è utile nel caso in cui si abbia la necessità di definire/gestire la stessa estrazione per Aziende diverse; nel caso indicato si avranno tante estrazioni quante sono le Aziende che dovranno utilizzarle. Pag. 9/15

10 Configurazione ed utilizzo Per procedere alla copia, accedere al punto di menu Definizione Estrazione (da: Gestione Dati/Impostazioni/Estrattore dati/definizione Estrazione). Prima di eseguire la funzionalità di Copia assicurarsi che l estrazione che si intende duplicare non sia definita sull Azienda "Tutti i codici non definiti direttamente" e che abbia il Codice di riferimento definito ed uguale a quella già presente a sistema. Utilizzare l'opzione Copia Estrazione : e selezionare il file di definizione dell'estrazione premendo il bottone Aggiungi file : Nota: si precisa che il file da importare deve avere estensione XML o ZIP. I file con estensioni diverse non saranno importati. Pag. 10/15

11 Dopo aver selezionato l'estrazione interessata, premere il bottone Start upload per caricare il file. Eseguito l'upload, l'estrazione viene mostrata nell'elenco riportando le seguenti informazioni: - Descrizione dell estrazione; - Codice di riferimento; - Già presente che indica se l estrazione caricata è già presente sull impianto e codificata sull azienda specifica; Nel caso in cui l'estrazione non possa essere copiata non verrà mostrato nessun dato nell'elenco. Per eseguire la copia selezionare la definizione desiderata e premere sul bottone Importa. Al termine dell importazione, ne verrà data indicazione nel campo Risultato copia. Pag. 11/15

12 La nuova estrazione sarà così definita: - Il Codice di riferimento risulta uguale a quello preso dall estrazione di origine - L azienda su cui è codificata risulta essere "Tutti i codici non definiti direttamente" - È abilitata ai Gruppi di sicurezza associati all Utente che ha eseguito l operazione di Copia, ad eccezione dei Ruoli e dei Gruppi con codice gruppo superiore a Nel caso in cui si abbia la necessità di definire la stessa estrazione per più Aziende, l'utente deve accedere in "Modifica" sulla nuova estrazione importata e variare il relativo codice azienda (associato di default dalla funzione di copia a "Tutti i codici non definiti direttamente"). Pag. 12/15

13 ESTRAZIONI SCHEDULATE Il sistema offre la possibilità di schedulare le estrazioni in modo tale che l'utente, non debba eseguire giornalmente o settimanalmente le estrazioni al fine di possedere dei dati aggiornati, ma ha la possibilità di schedularle in base alla sua necessità. È possibile definire le Estrazioni schedulate dal punto di menu Gestione Dati/Impostazioni/Estrattore dati/estrazioni schedulate. Pag. 13/15

14 Affinchè sia possibile utilizzare le Estrazioni in modalità schedulata, è necessario eseguire le seguenti configurazioni: Da punto di menu Estrazioni schedulate selezionare Nuovo Dall icona di selezionare, indicare il Cod. applicativo al quale fanno riferimento le estrazioni che si vogliono eseguire in modalità schedulata. Da Estrazione verrà riportato l elenco di tutte le estrazioni presenti e codificate sull impianto per il codice applicativo precedentemente indicato. Selezionata l estrazione indicare per ciascuna di esse il formato d uscita (CSV, Stampa Unione, Excel) e l eventuale modello ad esso associata (definito in precedenza in fase di Definizione Estrazione ) Indicare successivamente le Modalità di esecuzione delle estrazioni selezionate: Percorso e nome file In questo campo indicare il percorso nel quale il file generato deve essere salvato. Tale percorso può essere situato internamente o esternamente alla webapps di riferimento. Nota: Il nome del file generato deve essere incluso nella stringa inserita. Esempio: D:\Tomcat\webapps\Schedulazioni\anagrafiche.rtf (percorso esterno) D:\Tomcat\webapps\HRPortal\documenti\anagrafiche.rtf (percorso interno) Pag. 14/15

15 Tipo schedulazione Indicare l'intervallo di tempo che deve intercorrere tra una schedulazione e l'altra. Il sistema unirà le informazioni presenti in questa sezione con quelle indicate all'interno della maschera di definizione del processo schedulato relativo. Affinchè sia possibile eseguire le estrazioni è necessario configurare il processo schedulato "hrex_bschedexp - Estrazioni schedulate" (da: Pannello di controllo/schedulatore/processi) per ogni applicativo indicato come riferimento delle estrazioni. Pag. 15/15