Integrazione. InfoBusiness AdHoc Revolution

Pagina 1/25

Integrazione InfoBusiness AdHoc Revolution Versione 1.3.0 Pagina 2/25

Data Autore Versione Note 15/05/09 InfoBusiness Progetti 01.00.00 17/07/09 InfoBusiness Progetti 01.02.00 31/07/09 InfoBusiness Progetti 01.02.01 08/10/09 InfoBusiness Progetti 01.02.02 28/10/09 InfoBusiness Progetti 01.03.00 Pagina 3/25

Indice generale Contenuti...5 Scelte tecnologiche...6 Strumento ETL...6 Database...6 IB Connector...6 Linee Guida...7 Analisi Documentale...8 Contabilità Generale...8 Movimenti di Analitica...8 Movimenti di Magazzino...8 Analisi Esposizione...9 Parametrizzazione ETL...10 Definizione...11 Vincoli...13 Struttura tabellare...14 File AHRETL.properties...15 Verticalizzazioni...16 Come verticalizzare l'infomart...17 Come verticalizzare l'etl...19 What's New...22 Release 1.3.0...23 ETL...23 Mart...23 Release 1.2.2...23 ETL...23 Release 1.2.1...23 Mart...23 Release 1.2.0...23 ETL...23 Mart...24 Riferimenti...25 Pagina 4/25

Contenuti Il documento si prefigge l'obbiettivo di descrivere in maniera analitica gli aspetti implementativi relativi all'integrazione della suite InfoBusiness con il gestionale AdHoc Revolution. In particolare verranno rese esplicite le scelte di base del progetto riguardanti tecnologie e linee guida di analisi. Pagina 5/25

Scelte tecnologiche Strumento ETL Come strumento ETL (Extraction, Transformation and Loading) si è scelto di utilizzare uno strumento Open Source dedicato allo scopo: Pentaho Data Integration - Kettle (di seguito PDI, http://kettle.pentaho.org/). La scelta di utilizzare un vero prodotto ETL, e in particolare di PDI, è maturata in seguito alle seguenti considerazioni: è esterno al gestionale: è quindi possibile utilizzare lo stesso strumento per integrazioni con diversi prodotti. Zucchetti può essere facilmente schedulato o richiamato da applicazioni client/server o Web. essendo un processo dedicato all'operazione da compiere è più efficiente. semplice da utilizzare. potente e performante. può interfacciare praticamente qualsiasi fonte dati, quindi è molto utile per integrare nel Data Warehouse fonti dati esterne ai prodotti Zucchetti. essendo OpenSource e gratuito permette di essere adottato senza barriere d'ingresso economiche. è stato utilizzato con successo per tutti i progetti di Data Warehouse e integrazione sviluppati dal team InfoBusiness negli ultimi tre anni, tra cui HR, MErp e OMNIA. Database Il progetto di integrazione è stato reso compatibile (sia in Input che in Output) con DataBase MS SQL e Oracle. Rimane aperta la possibilità di utilizzare in Output (per il Data Warehouse) anche altri motori DataBase (ad esempio MySql, Firebird). IB Connector IBConnector è un framework java preposto all'esecuzione di un job (oggetto Kettle che governa il flusso dati) di un repository cifrato (file XML esportato da Kettle contenente il progetto d'integrazione). Al fine di proteggere il lavoro svolto, il repository viene cifrato prima della distribuzione mediante un componente denominato Crypter. L'output che si ottiene è un file con estensione.ibc, il Crypted Repository, che sarà utilizzabile da IBConnector. Pagina 6/25

L'architettura vuole dare la possibilità a Zucchetti di proteggere il lavoro fatto dal gruppo InfoBusiness, dando la possibilità di distribuire un motore standard sincronizzato con il License Server di InfoBusiness. L'obbiettivo è anche quello di non limitare il potenziale di quei clienti/rivenditori che hanno la necessità di implementare delle verticalizzazioni. I clienti/rivenditori potranno richiedere a Zucchetti il nuovo repository cifrato per poter utilizzare il Crypted Repository, mediante IBConnector. Linee Guida Nell'analisi e nella realizzazione, il progetto tiene conto delle seguenti direttive generali: è la prima espressione di un modello unico per i Data Warehouse di tutti i gestionali per azienda. il disegno è volto a ottenere il massimo valore aggiunto, mettendo a disposizione: informazioni certificate. concetti confrontabili. la nuova integrazione deve essere una buona base di partenza, quindi insieme solida e flessibile, perché i partner la possano verticalizzare per il singolo cliente o per il loro parco. il disegno è studiato in modo che possa essere facilmente compreso, implementato e integrato con informazioni aggiuntive. nel dettaglio, per facilitare la comprensione dei contenuti, nel Data Warehouse è stata utilizzata una nomenclatura il più possibile vicina a quella utilizzata nel gestionale. l'integrazione è studiata per essere distribuita in modo efficiente: installazione e configurazione iniziale devono poter essere portate a termine con velocità e semplicità. l'integrazione deve poter essere sfruttata e utilizzata anche As Is, in modo che possa essere proposta senza mettersi in ottica progettuale quando la situazione non lo richiede. Pagina 7/25

Analisi Documentale Questo tema permette l'analisi dei documenti del ciclo attivo e passivo. Oltre ai layout relativi a ogni singola tipologia di documento (Ordini, Documenti di Trasporto, Fatture e Note di Credito), ne vengono messi a disposizione alcuni che permettono il confronto di informazioni provenienti da documenti diversi contemporaneamente. Ogni tema è ulteriormente suddiviso in due layout, monoaziendale o multiaziendale, per fornire la possibilità di interrogare il DWH per singola azienda o per più aziende parallelamente, a seconda delle esigenze. Nel Data Warehouse, per ogni documento, sono state messe a disposizione tutte le informazioni relative sia alla testata che alle righe di dettaglio: in questo modo sarà possibile avere una visione completa di quanto gestito. Contabilità Generale Questo tema permette l'analisi delle registrazioni di contabilità e delle registrazioni I.V.A. Anche per la contabilità generale sono stati creati entrambi i layout, monoaziendale e multiaziendale. Nel Data Warehouse, per ogni registrazione, sarà possibile visualizzare tutte le informazioni utili a ricostruire delle analisi adatte a soddisfare le maggiori esigenze dei clienti. Movimenti di Analitica Questo tema permette l'analisi dei movimenti di analitica ripartiti, mensilmente, per data di competenza. E' possibile effettuare un analisi sia per data di registrazione (dettagliata con granularità giornaliera) che per data di competenza (dettagliata con granularità mensile). Gli importi, incrociabili con le voci di costo, centri di costo, commesse, unità divisionali e aziende, sono spaccati in dare e avere. Dei movimenti di analitica è possibile anche recuperare l'origine del movimento e la tipologia. E' possibile reperire i dettagli relativi all'articolo (tipologia, categoria, ecc...) ed al documento (categoria, causale, ecc...). Oltre alla struttura analitica, con voce e centro di costo, commessa ed attività, è possibile incrociare le misure di analisi anche con i dettagli dell'intestatario. Anche per i movimenti di analitica sono stati creati entrambi i layout, monoaziendale e multiaziendale. Movimenti di Magazzino Questo tema permette l'analisi dei movimenti di magazzino per data di registrazione e data documento. Le quantità movimentate, suddivise in Esistenza, Impegnato, Ordinato e Riservato, sono perfettamente confrontabili partendo dal singolo magazzino fino all'esplosione del singolo lotto o Pagina 8/25

della sua ubicazione. E' possibile identificare il singolo movimento, grazie alle informazioni riguardanti l'origine del movimento e la tipologia. Anche per i movimenti di magazzino sono stati creati entrambi i layout, monoaziendale e multiaziendale. Analisi Esposizione Questo tema permette di condurre analisi sull'esposizione di clienti/fornitori per data registrazione relativamente al ciclo attivo e passivo. L'esposizione è stata realizzata partendo dalle fatture/note di credito contabilizzate registrate nella tabella dei documenti e dalle fatture/note di credito memorizzate direttamente in prima nota. Nell'analisi sono presenti anche i documenti di trasporto e gli ordini per evidenziare rispettivamente il valore dell'atteso (ddt non ancora fatturati) e il valore dello stimato (ordini non ancora evasi). Le informazioni principali sulle fatture e sulle note di credito sono recuperate dalla tabella delle partite, dalla prima nota, dalle scadenze varie, dalle distinte (quest'ultima per la gestione delle RiBa in esposizione) e dalla tabella dei documenti. Le informazioni sui ddt e sugli ordini sono recuperate dalla tabella dei documenti e dalla tabella delle rate (per reperire in particolare l'importo e la data di scadenza del documento in questione). I fatti principali che vertono sull'analisi dell'esposizione riguardano gli importi dello scaduto, dell'esposizione e del venduto/acquistato (quest'ultimo recuperato dalla tabella dei documenti) I primi si riferiscono alle fatture/note di credito non ancora saldate alla data di scadenza di pagamento (sono le fatture scadute o insolute). I secondi invece si riferiscono alle fatture/note di credito non ancora saldate alla data di elaborazione dell' ETL (possono essere fatture scadute, in scadenza, insolute o a rischio ). È quindi importante tenere sempre presente che gli importi dell'esposizione dipendono strettamente dalla data in cui è stato eseguito l'etl. Infine, tramite il fatto relativo al venduto/acquistato, è possibile ad esempio, mettere a confronto, il valore totale fatturato ad un cliente con il totale dell'esposizione e dell'incassato. In questo modo quindi si può mettere a confronto quanto il cliente ha già pagato,quanto deve ancora pagare, i giorni medi di ritardo dei pagamenti ed il numero delle scadenze non ancora saldate. Per l'esposizione sono stati realizzati i layout Esposizione Ciclo Attivo, Esposizione Ciclo Passivo ed Esposizone (quest'ultimo contenente i fatti e le dimensioni del ciclo attivo e del ciclo passivo), sia per sistemi monoaziendali che multiaziendali. Pagina 9/25

Parametrizzazione ETL La seguente sezione del documento si prefigge lo scopo di rappresentare la soluzione adottata per gestire la parametrizzazione dell'etl per l'integrazione oggetto del documento. Verrà riportata una definizione dei singoli parametri e la struttura tabellare degli stessi. Pagina 10/25

Definizione L'ETL per esportare i dati dal DB del gestionale verso il DB del Data Warehouse necessita di una serie di informazioni (parametri). Tali parametri vengono precompilati dall'etl nel DB del Data Warehouse in modo automatico (in base alla configurazione dell'archivio delle Causali Documento), tramite l'esecuzione di un apposito job (Start_Parametri, richiamato dal batch AHR-IBC init ). Sarà cura del rivenditore agire sulle relative tabelle, variandoli a seconda dell'esigenza del cliente. I parametri sono raggruppati come segue (in rosso i parametri obbligatori): Parametri Generali Azienda: codice dell'azienda che si desidera esportare Data Inizio: data di inizio esportazione/cancellazione Data Fine: data fine esportazione/cancellazione Tipo Data: la tipologia di data da utilizzare per l'esportazione/cancellazione dei dati (data documento -DATDOC- o data registrazione -DATREG-) Parametri Causali Documenti Sono le causali dei documenti che si vogliono esportare. Per ogni causale inserita si dovrà indicare il riferimento al ciclo acquisti o vendite (A e V), la classe documentale nel Data Warehouse (OR, DT e FA), il segno degli importi del documento nel Data Warehouse (-1, 0, 1) e il segno per la valorizzazione del costo per il calcolo della marginalità (-1, 0, 1). Nello specifico l'etl non effettuerà nessun controllo tra i flag associati ad ogni causale e i rispettivi presenti in AdHoc. Sarà cura dell'utente verificare che i parametri inseriti corrispondano a quelli previsti da analisi. Esiste la possibilità di assegnare una causale a più classi documentali (ad esempio una fattura accompagnatoria potrebbe essere presente sia con DT che con FA, semplicemente creando due differenti righe). N.B.: la classe documentale NC sarà inserita come FA, ed avrà segno -1. Marginalità Inventario: è la coppia esercizio e codice che permette di identificare l'inventario di default per il valore di costo per il calcolo della marginalità. Esiste inoltre la possibilità di definire una data inizio data fine validità per l'esportazione di uno specifico inventario. Per poter esportare più inventari, sarà sufficiente creare più righe con data inizio data fine validità differenti. Listino 1: rappresenta un primo listino di default per il valore di costo per il calcolo della marginalità, dove tali valori vengono calcolati in funzione della data di inizio e fine validità del listino stesso. Listino 2: come per Listino 1, solo che rappresenta una seconda opportunità di valorizzazione Listino 3: come per Listino 2, solo che rappresenta una terza opportunità di valorizzazione Listino 4: come per Listino 3, solo che rappresenta una quarta opportunità di valorizzazione Listino 5: come per Listino 4, solo che rappresenta una quinta opportunità di valorizzazione Pagina 11/25

Di seguito alcune note: se la data inizio è nulla, cancella tutto fino alla data fine se la data fine è nulla, cancella tutto dalla data inizio in poi se entrambe le date sono nulle, viene ripulito tutto il Data Warehouse e ripopolato interamente Per il valore di costo per il calcolo della marginalità, se l'inventario, o il listino 1, o il listino 2, o il listino 3, o il listino 4, o il listino 5, non presentassero un codice valido (oppure nullo), il valore è 0 per quel particolare parametro. E' sconsigliato l'utilizzo di più inventari con data inizio data fine validità equivalenti o con intervalli temporali sovrapposti, in quanto NON E' GARANTITA LA CORRETTA VALORIZZAZIONE DEI COSTI. I valori di costo saranno moltiplicati per il segno indicato nella causale indicata nei parametri di esportazione (ad esempio si può decidere che una nota di credito movimenti con segno negativo gli importi e non movimenti i costi). Il prezzo del listino non è espresso in valuta di conto, ma con la valuta presente in anagrafica. I costi provenienti da listini con valuta diversa da quella del documento, andranno calcolati in base al cambio presente sul documento da analizzare. Pagina 12/25

Vincoli Di seguito, vengono riportati i vincoli per l'esportazione da AdHoc Revolution verso il DWH. Tutte le spese di piede (trasporto, incasso, ecc...) vengono sempre gestite come spese di testata, a meno che non siano state precedentemente ripartite sulle righe. Le provvigioni vengono calcolate direttamente dalla riga documento. Non gestito il processo di storno automatico delle scritture di assestamento. Non gestiti documenti con scorporo I.V.A.. Non gestiti articoli di tipo kit. Non gestite particolarità per il pro-rata, ventilazione I.V.A., I.V.A. ad esigibilità differita, acconti, ritenute e cespiti. Ciò non preclude la possibilità di integrazione da parte del rivenditore, o da parte di INFOBUSINESS PROGETTI in un prossimo rilascio. Non gestiti i nominativi. L'ordinamento delle dimensioni è a cura del rivenditore, in base alle preferenze dell'utente finale. Attualmente le dimensioni vengono ordinate alfabeticamente all'interno di ogni gruppo. I documenti non contabilizzati presenteranno una data di Registrazione Contabile coincidente con la data di Registrazione Documento. Pagina 13/25

Struttura tabellare Di seguito è riportata la struttura tabellare: CREATE TABLE PARAMETRI_AZIENDA( CODAZI VARCHAR(50), DATA_INIZIO SMALLDATETIME, DATA_FINE SMALLDATETIME, TIPO_DATA VARCHAR(50), LISTINO1 VARCHAR(50), LISTINO2 VARCHAR(50), LISTINO3 VARCHAR(50), LISTINO4 VARCHAR(50), LISTINO5 VARCHAR(50) ); CREATE TABLE PARAMETRI_DOCUMENTI( CODAZI VARCHAR(50), CAUSALE VARCHAR(50), CLASSEDOC VARCHAR(50), FLACQVEN VARCHAR(50), SEGNO_VALORE INT, SEGNO_COSTO INT, SEGNO_PROVV INT ); CREATE TABLE PARAMETRI_MARGINALITA( CODAZI VARCHAR(50), ESERCIZIO VARCHAR(50), INVENTARIO VARCHAR(50), DATA_INIZIO SMALLDATETIME, DATA_FINE SMALLDATETIME ); Pagina 14/25

File AHRETL.properties Questo file, che si trova all'interno della cartella AHRETL, contiene le definizioni dei default che verranno impostate dall'etl per effettuare la sostituzione dei valori NULL presenti sul DB sorgente. Nel dettaglio, i valori in esso contenuti sono: default_code = @ default_date = 01/01/1950 default_desc = Non Disponibile default_number = 0 default_string = @ Penserà l'etl stesso a reperire la tipologia del campo, se numerico, carattere o data. Variandoli, si potranno sostituire anche a livello di DWH senza modificare l'etl. E' possibile anche aggiungere delle nuove proprietà, ma in questo caso occorrerà verticalizzare l'etl, aggiungendo la lettura dei nuovi valori di default creati. Pagina 15/25

Verticalizzazioni In questa sezione del documento verranno riportati i consigli su come verticalizzare InfoMart ed ETL. Pagina 16/25

Come verticalizzare l'infomart Per poter semplificare la verticalizzazione di un InfoMart, abbiamo aggiunto allo standard dei nuovi layout, completamente vuoti, atti a contenere le personalizzazioni. Ad ogni layout presente, ne sono stati aggiunti 2: al primo, denominato Custom, vanno aggiunte tutte le nuove entità comuni ad ogni layout; al secondo, denominato CustomNomelayout (ad esempio CustomVen), vanno aggiunte solo le nuove entità di uno specifico layout. Di seguito sono riportati i passi principali. 1.Aprire InfoDesign e creare un nuovo InfoMart 2.Modificare questo InfoMart, aggiungendo tutte le nuove tabelle, dimensioni, misure, ecc... 3.Creare i layout Custom, come precedentemente spiegato. Pagina 17/25

4.Salvare e aprire l'infomart di AHR. 5.Selezionare dal menù Strumenti Importa Mart, quello personalizzato per includere le verticalizzazioni presenti, i layout Custom saranno aggiornati automaticamente. Pagina 18/25

Come verticalizzare l'etl Per evitare che un aggiornamento dei sorgenti vada a sovrascrivere delle personalizzazioni apportate all'etl, consigliamo di seguire la seguente procedura. 1.Aprire Spoon, selezionare Repository Esplora Repository 2.Espandere la treeview fino al livello Trasformazioni o Job, selezionare col tasto destro il simbolo / e nella nuova finestra apparsa Crea Cartella. 3.Specificare il nome della nuova cartella (nell'esempio PERS) e premere OK. Chiudere la finestra Repository Explorer utilizzando il bottone Esegui Le Modifiche. Pagina 19/25

4.Ora è possibile tenere separate le personalizzazioni all'etl semplicemente salvandole nella nuova directory, mantenendo intatto l'originale. 5.Aprire il Job chiamante, selezionare col tasto destro l'oggetto desiderato, aprirne le proprietà utilizzando Modifica Job Entry. Pagina 20/25

6.E' ora possibile decidere se utilizzare l'oggetto standard oppure quello appena personalizzato, semplicemente variando la cartella del repository. 7.La stessa procedura andrà seguita anche per le nuove Trasformazioni o per i nuovi Job. Pagina 21/25

What's New In questa sezione del documento verranno riepilogati nel dettaglio tutti i rilasci relativi al prodotto AHR IBC (connettore AdHoc Revolution). Pagina 22/25

Release 1.3.0 ETL Integrazione Movimenti di Analitica. Integrazione Movimenti di Magazzino. Integrazione Esposizione. Mart Aggiunta del tema di analisi Movimenti di Analitica. Aggiunta del tema di analisi Movimenti di Magazzino. Aggiunta del tema di analisi Esposizione. Rivisitazione InfoMart. Release 1.2.2 ETL Retrocompatibilità con le precedenti versioni di AdHoc Enterprise. Correzione dell'algoritmo per il calcolo dell'importo generale. Introduzione di una tabella di trascodifica (DOMINI) per le dimensioni di tipo flag. Release 1.2.1 Mart Rimosso tema sulla Classificazione Articoli e Clienti. Correzione errori sulle dimensioni che presentavano un valore di default se non valorizzate. Release 1.2.0 ETL Risolto l'errore sul calcolo del campo MVIMPEVA quando la riga del documento era valorizzata a quantità, ma era riportata a 0. Nuova gestione con selezione azienda da esportare. Pagina 23/25

Mart Aggiunta del tema Classificazione Articoli e Clienti. Pagina 24/25

Riferimenti Per il contenuto dell'infomart (Layout, Dimensioni, Misure e Formule) si rimanda al documento Contenuto InfoMart AHR.xls dove sono riportati dei commenti descrittivi sul significato di ogni entità. Pagina 25/25