Database Links Manuale Sistemista. Database Links Manuale Sistemista

Transcript

1 Database Links Manuale Sistemista Pagina 1 di 18 Versione 2 del 24/10/2013

2 SOMMARIO 1 A Chi è destinato Pre requisiti Preparazione Ambiente Creazione record di configurazione per la applicazione DBLINKs Definizione parametri: Gestione delle autorizzazioni Creazione record sistema informativo per DBLINK Creazione Libreria/e contenente/i Database Allineamento Database Contenuti Definizione Classi Configurazione Classe Attivazione Classe Assegnazione di modelli Definizioni Categorizzazioni Concetto di Categorizzazione Definizione Categorizzazione Definizione Fonti Dati Concetti generali Creazione Fonte Dati Creazione Documenti Attivi Concetti generali Creazione Modello Fonte dati Singola Fonte Dati Tabellare Programmi da schedulare Pulizia file appoggio reperimento documenti (ALINK) Ottimizzazione file indice ricerche Ricerche full text Requisiti Installazione di Omnifind Attivazione delle funzioni Omnifind Indicizzazione differita Indicizzazione del pregresso Disattivazione delle funzioni Omnifind Eliminazione completa degli indici Importazione in massa, recupero del pregresso Pagina 2 di 18 Versione 2 del 24/10/2013

3 1 A CHI È DESTINATO Ai tecnici sistemisti con il compito di installare e attivare la applicazione presso l utente finale. 2 PRE REQUISITI L allievo deve essere in grado di : Operare con i comandi di base del sistema. Operare con l interfaccia webgate400. Pagina 3 di 18 Versione 2 del 24/10/2013

4 3 PREPARAZIONE AMBIENTE 3.1 Creazione record di configurazione per la applicazione DBLINKs Definizione parametri: Accedere al sistema con il profilo master di Webgate400 (es. WEBG4R0500 per la release 5.0), selezionare la voce Environment/Application Menu, selezionare Manutenzione record di configurazione. Premere F6 Creazione ed inserire il record attribuendogli un codice ed una descrizione. Inserire i dati richiesti, è Obbligatorio inserire il nome delle libreria dei file originali Gestione delle autorizzazioni Per gestire le autorizzazioni all uso del Database Links, accedere al sistema con il profilo master di Webgate400, Configurazione di Run Time, 2 modifica utente, nella sezione add-on, impostare a Y la voce Database Link Importante Per la configurazione dell applicativo si deve accedere al Menu Database Links, raggiungibile accedendo con il profilo master di Webgate400 (vedi paragrafo precedente). Selezionare la voce Environment/Application Menu, Database Links. 3.2 Creazione record sistema informativo per DBLINK Per ogni azienda/sistema informativo, e necessario aggiungere una voce all elenco aziende, manutenzionabile con il seguente comando : CALL CLXI/RGBUABC A : mettere opzione "1" per inserimento nuovo record Nr : numero sequenziale che rappresenta il nome del sistema informativo (001, 002,...XXX) Sg : due caratteri identificativi del suffisso libreria ambiente nn Descrizione Azienda : Descrizione del Sistema informativo All.DB : immettere il carattere speciale "*" in modo da garantire l'allinemento del Db delle librerie di ambiente In tal modo si imposta in automatico la contabilita' a *NONE ed il nuovo record, viene aggiunto. Esempio : 3.3 Creazione Libreria/e contenente/i Database Creare una libreria per ogni azienda inserita denominata DBLFInn dove nn e' il suffisso inserito nel passo precedente (nell esempio sigla W1). 3.4 Allineamento Database Aggiungere le librerie WEBGATE400 e WEBG4FD all'ambiente di esecuzione (se rilascio di release R0500 aggiungere la WEBG4R0500 e WGFR0500D) Pagina 4 di 18 Versione 2 del 24/10/2013

5 Esempio: ADDLIBLE WEBGATE400 ADDLIBLE WEBG4FD Eseguire quindi l'allineamento dell'applicativo DBLINK (NRR=006) utilizzando il seguente comando : ALLINEA NRR(006) NUMAZ(XXX) per ogni sistema informativo creato. (nell esempio precedente, XXX è rappresentato dalla azienda 110) Pagina 5 di 18 Versione 2 del 24/10/2013

6 4 CONTENUTI 4.1 Definizione Classi Configurazione Classe La gestione dei documenti si basa sulle Classi. Le classi definiscono la struttura logica dell applicativo, il luogo di archiviazione e gli accessi. Dal menù Database Links selezionare Manutenzione classi Database Links, viene richiesta l azienda, selezionarla e premere F1. Viene emessa la seguente videata: Inserire il codice della classe da creare, la descrizione e premere Invio. Pagina 6 di 18 Versione 2 del 24/10/2013

7 Con l opzione 2 richiamare la classe appena creata, appare la seguente videata: Fonti Dati Vanno inseriti tutte le fonti dati necessarie per la composizione del documento attivo. Percorsi Archiviazione vanno inseriti i percorsi dove si vogliono archiviare fisicamente i documenti. E divisa in 3 parti:. Editabili - nella prima vengono salvati i documenti nel formato originale. Pubblici contiene la versione in PDF se attivata la funzione Post processing. Originali serve per la gestione della Firma digitale (Vedi Manuale). Se i documenti sono archiviati nel sistema, i percorsi sono relativi a una porzione dell IFS. E possibile archiviare i documenti anche su un server esterno previa apposita configurazione dello stesso sull I Series (QNTC). Si consiglia di generare un percorso in modo strutturato per mantenere i documenti con maggior ordine. Es: /Wgpublic/Nome società/classe/edit /Wgpublic/Nome società/classe/public /Wgpublic/Nome società/classe/legal Mansioni valide per firma e Conservazione sostitutiva vedi apposito Manuale Modello deve contenere il percorso ed il nome del modello legato alla classe, il modello può essere un qualsiasi documento di Word, Excel, Power point ecc. Nel caso di documenti di Word possono essere generati dei Documenti attivi, che reperiscono dei dati dal Sistema informativo mediante le Fonti dati (Vedi capitolo). Es. /WGpublic/Codice società/template/modello.doc P7M vedi apposito Manuale Marca Temporale vedi apposito Manuale Pagina 7 di 18 Versione 2 del 24/10/2013

8 Post Processing va attivata se si vogliono convertire in PDF i documenti allegati manualmente (Word. Excel ecc), l attivazione di questa funzionalità comporta l installazione su un server di un programma per l intercettazione dei documenti allegati e la loro conversione. (Vedi apposito Manuale) Attivazione Classe Le classi non sono utilizzabili sino a che non gli è stata attribuita almeno una Autorizzazione. Selezionare U- Permessi utente e premere invio In questa videata si attribuiscono le autorizzazioni alla classe. Possono essere inserite per Utente, Gruppo o generico con la parola chiave *PUBLIC. Le autorizzazioni possono essere in tutte le combinazioni di permesso S e negazione N La non attribuzione di una funzione (campo Blank) è considerata negazione Assegnazione di modelli E possibile assegnare più modelli ad una classe. Selezionare M- Modelli e premere invio Inserire un nome per il modello e premere invio Pagina 8 di 18 Versione 2 del 24/10/2013

9 Selezionare 2 e premere invio, viene mostrata la videata di configurazione: Inserire le Fonti dati necessarie ed il percorso del modello. Es. /wgpublic/codice società/template/modello.doc E consigliato di posizionare tutti i modelli di una società in un'unica cartella, questo renderà più facile la rintracciabilità degli stessi nel caso di modifiche di massa, ad es. cambio di intestazioni. N.B. Una volta creato il modello deve essere spostato manualmente nella directory indicata nel percorso Pagina 9 di 18 Versione 2 del 24/10/2013

10 4.2 Definizioni Categorizzazioni Concetto di Categorizzazione Le categorizzazioni servono per ricercare gli allegati in modo diverso dal soggetto a cui sono stati ancorati. Ad esempio se voglio rintracciare i documenti relativi alla Zona e non al codice del Cliente. Oppure per una parte (sottostringa) o concatenamento di campi presenti nel database di ancoraggio. Ad esempio per l anno della data di un documento Definizione Categorizzazione Dal Menù Database Link selezionare Manut. Parametri Categorizzazione Allegati, selezionare l azienda interessata e premere F1. E emessa la seguente videata: Principale E il nome del campo presente nel record di database a cui si vuole fare riferimento, ad esempio il codice Zona dell anagrafica Cliente. Correlato E il campo che deve essere presente insieme al campo principale per agganciare il record di database, ad esempio il campo Tipo Codice insieme al Codice. Nella prima riga si scriverà nel campo Principale il campo Codice e nel campo Correlato il Tipo Codice. Viceversa si inserirà una riga dove nel campo Principale il campo Tipo codice e nel campo Correlato il campo Codice. Ordinamento L ordinamento in cui appaiono i campi in ricerca, valori possibili da 1 a 9998, 9999 non visualizza il campo. Alias Definisce un nome alias da ricercare nel database. I campi nei vari files, possono essere nominati in modo diverso. Quindi, definendo una categorizzazione (per esempio per codice articolo), dovrò definire come alias i nomi di campo contenenti codici articolo e chiamati in modo diverso dal campo principale. Anche per l Alias si possono gestire i campi Correlati. Pagina 10 di 18 Versione 2 del 24/10/2013

11 Nome campo Si definisce solo quando come argomento di categorizzazione deve essere memorizzata una sottostringa del campo principale per esempio L anno estratto da un campo data documento. Pagina 11 di 18 Versione 2 del 24/10/2013

12 4.3 Definizione Fonti Dati Concetti generali La Fonte Dati è lo strumento che ci permette di reperire delle informazioni dal database, collegate al soggetto di ancoraggio dell allegato, e di inserirle nei modelli creati in Word Creazione Fonte Dati Dal Menù Database Links selezionare Manut. Fonti Dati Database Links, selezionare l azienda interessata e premere F1 E emessa la seguente videata: inserire il Codice e la Descrizione e premere invio. Con l opzione 2 richiamare la Fonte Dati appena creata, appare la seguente videata: Vi sono due tipi di Fonte Dati: Singole Ritorna al modello un solo record. Ad esempio dati anagrafici.ragione sociale, Indirizzo oppure Descrizione Articolo, Famiglia ecc. Tabellare una fattura I record restituiti non possono essere predeterminati. Ad esempio le righe di un ordine o di Istruzione SQL Il reperimento dei dati avviene tramite istruzione SQL. Si hanno a disposizione come parametri, tutti i campi del database relativi al soggetto di ancoraggio. Il passaggio dei parametri avviene mettendo il simbolo % davanti al campo. Pagina 12 di 18 Versione 2 del 24/10/2013

13 Esempio: Se devo reperire L indirizzo completo di un cliente, la descrizione della zona e del codice pagamento, potrò creare tre Fonti Dati che leggeranno: l anagrafica del cliente tramite il codice cliente passato come parametro la descrizione della zona tramite il codice zona presente sull anagrafica del cliente la descrizione del pagamento tramite il codice pagamento presente sull anagrafica del cliente. Se il campo codice cliente si chiama XCOCLI sul database, per utilizzarlo come parametro dovrò chiamarlo %XCOCLI. Per reperire la Ragione sociale e l Indirizzo del cliente dal file dei Clienti chiamato CLIEN supponendo che si chiamino rispettivamente XRAGSO e XINDIR la stringa SQL risulterebbe come da figura: In questo caso si suppone che il codice cliente sia numerico, infatti il parametro non viene posto tra apici. Tipo Tabellare Deve essere spuntato se si tratta di una Fonte Dati di tipo Tabellare Percorso Modello Fonte Dati (se tabellare) Va inserito il percorso completo del modello che conterrà i dati restituiti dalla Fonte Dati (Vedi Documenti Attivi) Es. /wgpublic/codice società/template/righefattura.doc Pagina 13 di 18 Versione 2 del 24/10/2013

14 4.4 Creazione Documenti Attivi Concetti generali Con documento attivo si intende un documento in Word, predefinito come modello, contenente dei dati variabili che devono essere reperiti al momento della creazione. I dati vengono reperiti tramite le Fonti Dati collegate alla Classe di archiviazione del modello Creazione Modello Una volta impostata la parte costante del modello si devono eventualmente inserire i dati variabili, reperiti tramite le Fonti Dati Fonte dati Singola Per inserire i dati relativi ad una Fonte Dati di tipo Singolo si procede in questo modo: Posizionarsi dove si deve inserire il campo, dal menù Inserisci selezionare Campo, appare la seguente videata: Selezionare DocVariable e come nome inserire il Codice della fonte dati seguita da un _ Trattino basso ed il nome del campo di databese. Es: FD_XRAGSO Fonte Dati Tabellare Non conoscendo il numero di record che possono essere restituiti dalla Fonte Dati, si deve creare un modello contenente SOLO una tabella atta a contenere i dati. La tabella può essere di due righe, in tal caso si suppone che la prima riga sia di intestazione. Deve essere composta almeno di un numero di colonne tali da contenere tutti i campi selezionati nella Fonte Dati, le colonne in eccedenza vengono lasciate vuote. I dati vengono caricati nell ordine in cui sono stati selezionati, la tabella viene popolata automaticamente di tutte le righe necessarie a contenere i dati. Es. Tabella che deve contenere Codice, Descrizione, Quantità e Prezzo con una colonna vuota da compilare manualmente. Codice Descrizione Quantità Prezzo Evadibile Il modello ottenuto va inserito nel corpo del Modello principale, in cui ad esempio sono stati predisposti i dati di testata e di Piede del documento finale. Pagina 14 di 18 Versione 2 del 24/10/2013

15 Per inserire il modello posizionarsi dove si vogliono inserire i dati, dal menu Inserisci selezionare Campo appare la seguente videata: Selezionare IncludeText e come nome inserire il nome del modello creato per contenere la Tabella. 5 PROGRAMMI DA SCHEDULARE Per mantenere in efficienza gli archivi di database Links è necessario schedulare (se possibile giornalmente) queste due funzioni : 5.1 Pulizia file appoggio reperimento documenti (ALINK) Eseguire il comando sotto indicato sostituendo al nome della libreria quello corretto, relativo alla versione del prodotto. CLRPFM FILE(DBLINK/ALINK) 5.2 Ottimizzazione file indice ricerche Eseguire il seguente comando curandosi di avere nella lista delle librerie quella contenente il file LINXX (si trova con tutti gli altri files relativi alla applicazione DBLINKS) CALL PGM(RLKR07) Pagina 15 di 18 Versione 2 del 24/10/2013

16 6 RICERCHE FULL TEXT 6.1 Requisiti Sistema operativo IBM i5/os 6.1 o superiore. Rilascio Webgate di 19 luglio 2013 o successivo. 6.2 Installazione di Omnifind Sulla macchina va installato il prodotto Omnifind e tutte le relative PTF di aggiornamento disponibili. Per i requisiti di installazione del prodotto fare riferimento ai manuali ufficiali IBM per la versione di sistema operativo in uso. Assicurarsi che il sistema Omnifind si avvii con la macchina schedulando la stored procedure CALL SYSPROC/SYSTS_START per l esecuzione ad ogni avvio della macchina con utente QSECOFR. 1. Impostare le autorizzazioni ad *PUBLIC sul file QSYS2/SYSTXTINDX. 2. Verificare come da manuale ufficiale IBM per il sistema operativo in uso quali sono le autorizzazioni ed i prerequisiti delle seguenti stored procedure: a. SYSPROC/SYSTS_START b. SYSPROC/SYSTS_CREATE c. SYSPROC/SYSTS_UPDATE d. SYSPROC/SYSTS_DROP e. SYSPROC/SYSTS_STOP 6.3 Attivazione delle funzioni Omnifind Per attivare la ricerca nei contenuti per DBLinks aprire i parametri funzionali ed attivare la relativa spunta. Figura 1 - DBLink - Parametri funzionali Questa operazione consente di: Creare l ambiente di indicizzazione per la propria azienda (file LINOF nella propria DBLFIxx ed indice all interno del sistema Omnifind) Rendere ricercabili i documenti creati o modificati da questo momento in avanti Il parametro Modo Indicizzazione consente di specificare se l indicizzazione va fatta subito dopo il suo inserimento / aggiornamento in DBLink oppure se va fatta attraverso l utilità di recupero del pregresso. Il parametro Intervallo Indicizzazione specifica il numero di secondi minimo tra un indicizzazione e la successiva, da utilizzare per abbassare il carico della macchina in caso di indicizzazione immediata. Pagina 16 di 18 Versione 2 del 24/10/2013

17 6.4 Indicizzazione differita L indicizzazione differita consente di non appesantire la macchina durante l utilizzo quotidiano spostando il lavoro di indicizzazione durante le ore di inattività della macchina. Per utilizzare questo comportamento: attivare la funzione di indicizzazione differita nei parametri funzionali DBLink (specificando Differita per il parametro Modo Indicizzazione ) schedulare il comando DOCINDEX con opzione Docs to index ad *MARKED oppure *PRIOR nei periodi di inattività della macchina 6.5 Indicizzazione del pregresso L attivazione di Omnifind non esegue l indicizzazione dei documenti già contenuti all interno di DBLinks. Per recuperare il pregresso utilizzare il command DOCINDEX in periodi di inattività della macchina poiché la procedura di indicizzazione dei documenti è molto lenta ed ha un forte impatto su disco. 6.6 Disattivazione delle funzioni Omnifind Dai parametri funzionali di DBLinks disattivare la relativa spunta. Questa operazione consente di: Disattivare l ambiente di indicizzazione Non rendere ricercabili i documenti creati o modificati da questo momento in avanti Mantenere gli indici precedentemente creati 6.7 Eliminazione completa degli indici Qualora fosse necessario eliminare completamente i risultati delle indicizzazioni effettuate, dopo aver disattivato le funzioni di ricerca come al punto 3.6: aprire un terminale con utente QSECOFR assicurarsi che il job abbia CCSID diverso da avviare un prompt SQL lanciare la stored procedure CALL SYSPROC/SYSTS_DROP( DBLFIxx, LINOFxxIDX ) sostituendo xx con il suffisso della propria azienda eliminare il file DBLFIxx/LINOF sostituendo xx con il suffisso della propria azienda Pagina 17 di 18 Versione 2 del 24/10/2013

18 6.8 Importazione in massa, recupero del pregresso E stata sviluppata un API per il recupero dei documenti non indicizzati di links ed relativo command per l esecuzione (DOCINDEX). Figura 2 - DOCINDEX - Schermata di immissione parametri Library name Parametro obbligatorio, è sempre necessario specificare una libreria DBLFI che contiene il file LINKS della propria azienda. Class name Classe documentale, se specificata viene utilizzata come filtro per le classi attive. Default: (tutte le classi) End Time Indica l orario massimo di fine esecuzione. L importazione dei documenti comincerà immediatamente ad importare un file per volta fino al termine dell esecuzione o fino a che non sarà raggiunto l orario specificato. Perché il processo continui senza limiti di tempo specificare il valore *NOMAX. Default: *NOMAX (nessun limite di tempo) Docs to index Determina quali documenti saranno indicizzati in base al loro stato. Valori possibili: - *MARKED include solo i documenti marcati per l indicizzazione - *PRIOR include i documenti marcati per l indicizzazione ed i files presenti a database prima dell attivazione dell indicizzazione su DBLinks (pregresso) - *ALL include tutti i documenti, già indicizzati e non Default: *MARKED (marcati per l indicizzazione) Delay between docs Imposta il numero di secondi di attesa tra l indicizzazione di un file ed il successivo. Il parametro consente di ridurre il carico della macchina generato dal processo dato che le operazioni di indicizzazione sono intensive per i dischi. Specificando un tempo di Wait a 0 si possono riscontrare picchi di utilizzo CPU su un processo QJVAEXEC da parte del motore di Omnifind che stà effettuando l indicizzazione. Pagina 18 di 18 Versione 2 del 24/10/2013