Questo documento contiene informazioni di proprietà di openwork s.r.l. e deve essere utilizzato esclusivamente in relazione alle finalità per le quali è stato predisposto. È vietata qualsiasi forma di riproduzione o di divulgazione senza l esplicito consenso dei proprietari delle informazioni. openwork è un marchio registrato della openwork s.r.l. Altri nomi di prodotti e di aziende citati in queste pagine possono essere marchi dei rispettivi proprietari. 2017 openwork s.r.l. Jamio openwork data source connector for QlikView v 2.1 Data ultima revisione: Luglio 2017 Openwork srl Pag. 2 di 9
INDEX 1 INTRODUZIONE... 4 2 INSTALLAZIONE... 4 3 UTILIZZO... 5 3.1 SELEZIONE DEL CONNETTORE E CONNESSIONE A JAMIO... 5 3.2 SELEZIONE DEI CAMPI DA CATALOGO... 6 Openwork srl Pag. 3 di 9
1 INTRODUZIONE Jamio openwork data source connector for QlikView è una componente software che ha il compito di consentire alla Business Intelligence fornita dagli strumenti della famiglia QlikView di utilizzare dati forniti dalla piattaforma Jamio openwork. Il sotware è in grado di supportare la fase di disegno delle dashboard o dei documenti di analisi e la fase di caricamento dati per l alimentazione e la produzione degli oggetti di Business Intelligence dei prodotti QlikView. Jamio openwork data source connector for QlikView è costruito su abstract forniti e delineati da Qlik e utilizza, come tabelle e viste, i cataloghi che la piattaforma Jamio openwork mette a disposizione. 2 INSTALLAZIONE La procedura di installazione di Jamio openwork data source connector for QlikView prevede la copia dell applicazione software nella directory contenente i componenti custom di QlikView. Questa può cambiare da sistema a sistema, in base alle caratteristiche del sistema operativo, ma generalmente è posizionata nella directrory che è riportata nei passi seguenti: 1. Copiare il file QvJamioConnector2.0.7.zip in C:\Program Files (x86)\common Files\QlikTech\Custom Data\. 2. Estrarre il contenuto dello zip nella stessa cartella. 3. Verificare che sia stata creata la sottodirectory QvJamioConnector2.0 e che questa contenga una serie di file, tra cui QvJamioConnector2.0.exe. 4. Eliminare il file zip dalla cartella. Il nome della cartella e dell eseguibile contiene anche il numero di versione. Questo consente di installare versioni diverse di connettori che consentono di colloquiare con versioni diverse di Jamio openwork. Openwork srl Pag. 4 di 9
3 UTILIZZO QlikView Personal Edition è lo strumento software prodotto da Qlik per il disegno e la costruzione delle dashboard e dei documenti di analisi. Per il suo utilizzo si rimanda alla documentazione ufficiale Qlik. Il connettore svolge il compito di ausilio alla scrittura dello script di estrazione dei dati, componendo gli statement di connessione ed estrazione ed inserendoli alla posizione in cui si trova il cursore. Una volta installato il connettore, la console può essere avviata e la connessione a Jamio openwork sarà resa disponibile alle altre native del tool. Creare un nuovo documento (Menu File->Nuovo) e passare alla modifica dello script utilizzando l apposito tasto messo a disposizione dalla barra degli strumenti, come illustrato in Figura 1. Figura 1: Comando Modifica Script 3.1 Selezione del connettore e connessione a Jamio Effettuati i passaggi precedenti, la console mostra in basso a sinistra una serie di tab, che offrono funzionalità per la compilazione degli script. Selezionare il tab Campo e dalla Combo Database selezionare la voce QvJamioConnector2.0.exe, come mostrato in Figura 2. Figura 2: Selezione del connettore Una volta selezionato, alla pressione del pulsante Connetti sarà presentata una finestra per l inserimento dei dati di connessione, come illustrato in Figura 3. Openwork srl Pag. 5 di 9
Figura 3: Connessione a Jamio openwork I parametri da inserire e che quindi devono essere noti sono i seguenti: Gateway URL: è l end point ai servizi Jamio openwork. Tranne in particolari contesti di utilizzo questo deve essere sempre impostato a https://paas.jamio.com/gateway; Username: nome dell utente con cui accedere a Jamio openwork, che sarà utilizzato anche in fase di caricamento dei dati; Password: password dell utente; Area: area Jamio openwork di appartenenza; Una volta inseriti i parametri e cliccato il pulsante Connect, il sistema tenterà di connettersi e se l accesso a Jamio openwork avverrà con successo, nello script sarà inserita la stringa di connessione di caricamento Qlikview : CUSTOM CONNECT TO "Provider=QvJamioConnector2.1.exe;Repository=AreaEsempio;Gateway=https:/ /paas.jamio.com/gateway;documentname=$(vdocumentname);xuserid=tuduvqrmnl acwunoutccgadnsdzb;xpassword=hkebhxdmfe;"; La stringa di connessione contiene i seguenti parametri: Provider: il nome del connettore (eseguibile); Repository: il nome dell Area Jamio openwork assegnato all utente; Gateway: indirizzo del gateway di accesso per i servizi Jamio openwork; XUserId: nome utente per l accesso a Jamio openwork (crittografata); XPassword: password per l accesso a Jamio openwork (crittografata). Il sistema di encryption della account e della password fa parte dell implementazione delle librerie QlikView e viene quindi gestito in maniera automatica. 3.2 Selezione dei campi da catalogo Una volta indicata la stringa di connessione è possibile visualizzare i cataloghi disponibili cliccando sul pulsante Cataloghi (vedi Figura 4) presente nel tab Campo in basso a sinistra. Openwork srl Pag. 6 di 9
Figura 4: Posizione del tasto Cataloghi Si aprirà il pannello di navigazione dei cataloghi, contenente l elenco di quelli a disposizione dell utente, ottenuto per mezzo della connessione precedentemente inserita (come illustrato in Figura 5). Figura 5: Elenco dei cataloghi Facendo clic sul singolo catalogo il pannello mostrerà i singoli campi contenuti nei cataloghi nel seguente modo: in nero i campi semplici in rosso i campi complessi inseriti in parentesi angolari (<nome campo>) i campi di tipo array, siano essi semplici o complessi. I campi complessi, siano essi semplici o array sono, a loro volta, navigabili (doppio clic sul nome). Nella Figura 6 è mostrato un esempio di albero di navigazione dei campi di un catalogo e dei relativi campi e sotto campi complessi. Openwork srl Pag. 7 di 9
Figura 6: Albero di visualizzazione della struttura di un catalogo Openwork srl Pag. 8 di 9
Una volta selezionati i campi che si vogliono estrarre e cliccando sul pulsante OK, verrà inserito nello script lo statement di select richiesto. Figura 7: Selezioni dei campi del catalogo Lo script di caricamento adesso conterrà anche lo statement di Select. CUSTOM CONNECT TO "Provider=QvJamioConnector2.1.exe;Repository=AreaEsempio;Gateway=https://paas.jamio.com/g ateway;documentname=$(vdocumentname);xuserid=tuduvqrmnlacwunoutccgadnsdzb;xpassword=hkebh XdMFE;"; SELECT [Catalogo TestArray Destination].campoCollegamento, [Catalogo TestArray Destination].dataSet.stringa, [Catalogo TestArray Destination].dataSet.[lista di stringhe], [Catalogo TestArray Destination].dataSet.numerico, [Catalogo TestArray Destination].dataSet.[lista di numeri], [Catalogo TestArray Destination].dataSetLista.numerico FROM [Catalogo TestArray Destination]; Per poter selezionare più cataloghi è sufficiente tornare sulla schermata dei cataloghi e selezionare altre colonne. La produzione dello statement di select avviene per singolo catalogo. Tutte le altre funzionalità e gli statement per la produzione dello script saranno utilizzabili e fruibili, come da indicazioni di QlikView. Openwork srl Pag. 9 di 9