SpagoBI Meta. Marco Cortella 2011/05/09 17:59

Transcription

1 SpagoBI Meta Marco Cortella 2011/05/09 17:59

2 Table of Contents How install SpagoBI Meta... 3 Create a new DBMS connection... 3 Create the first Model... 7 Create the first Query Page 2 - last modified by Marco Cortella on 2011/05/09 17:59

3 Getting Started Guide ( SpagoBI Meta - RC ) How install SpagoBI Meta Create a new DBMS connection Create the first Model Create the first Query Please note that this isn't a final product. How install SpagoBI Meta To install SpagoBI Meta just uncompress the downloaded zip into a directory of your choice. Now locate the "eclipse" directory where you have uncompressed the files and launch the eclipse.exe file to start SpagoBI Meta. The first thing to do is to select a workspace, or select one already existing, where you want to save the files used by SpagoBI Meta (models,queries,etc...). Create a new DBMS connection To create a new DBMS connection make sure to have opened the "Data Source Explorer" view. For opening this view select the menu Window > Show View > Other > Data Management > Data Source Explorer. Page 3 - last modified by Marco Cortella on 2011/05/09 17:59

4 Now inside the Data Source Explorer select "New..", your DBMS Connection type (for example MySql) and click next. Page 4 - last modified by Marco Cortella on 2011/05/09 17:59

5 After that you have to specifiy a Driver and Connection details. If you haven't done this before you have to click on the "New driver definition icon". In this window you have to select the driver version, the driver JAR location (for MySql download it from ) and the connection properties. Page 5 - last modified by Marco Cortella on 2011/05/09 17:59

6 With the configured driver now you can test and edit the connection to your database. To test the connection simply press the "Test connection" button, if you get a "Ping succedded" messagge all is working. Page 6 - last modified by Marco Cortella on 2011/05/09 17:59

7 Create the first Model To create your first model proceed with this steps: First of all, create a new empty project inside the "Project Explorer" View. Select on the menu bar File > New > Project > General > Project. This will ask you a name for your project and a location (by default inside your current workspace, this is the recommended choice). Page 7 - last modified by Marco Cortella on 2011/05/09 17:59

8 Optionally create folder inside your project for every type of resources managed by SpagoBI Meta (models, queries, mappings...) for a better management of your work. For doing this, right-click on a project icon and select New > Folder. Now you can create your first SpagoBI Meta Model. Select on the menu bar File > New > Other > SpagoBI Meta > SpagoBI Model and press next. Page 8 - last modified by Marco Cortella on 2011/05/09 17:59

9 Assign a name to your SpagoBI Meta Model file (.sbimodel extension), a logic name and select the location inside your project. Page 9 - last modified by Marco Cortella on 2011/05/09 17:59

10 Next step is the selection of a connection. In this window you can see the connection already definied as described in the previous paragraph. You can also select a Catalog and Schema if avaiable for your database and connection. Page 10 - last modified by Marco Cortella on 2011/05/09 17:59

11 Now you have to choose the tables to import from your database inside the Physical Model. The Physical Model is like a "snapshot" of your current database tables structure used to create Business objects inside the SpagoBI Model editor. Make sure to import all the tables that you want to use later in this step. Page 11 - last modified by Marco Cortella on 2011/05/09 17:59

12 The last step let you quickly create Business Classes directly from the tables inside the Physical Model. This will create create Business Classes that have an identical structure (1:1) of your Physical Tables, with foreigns keys converted to business relationships, primary key to business identifiers and columns to attributes. Page 12 - last modified by Marco Cortella on 2011/05/09 17:59

13 Now click on Finish and You have created your first Spago BI Meta Model! Note that after clicking finish the SpagoBI Meta Model editor will be opened. On the left you have the Business Model representation as a tree, with the Business Classes, Attributes, Business Identifier and Business Relationship. On the right you have the Physical Model with the original structure extracted from your database connection. In the Business Model you can change and combine the structure imported from the Physical Model. Just select the Business Model root or the Business Model Classes to create something new with the context menus. For example you can create new relationships through Business Classes, set new Business Identifiers, delete or rename Business Attributes and combine Business Classes to create composed Business Classes with inherited attributes. You can also do this operations via drag&drop directly from the Physical Model to the Business Model. Page 13 - last modified by Marco Cortella on 2011/05/09 17:59

14 Create the first Query Once you have created your Business Model, with all the objects that you need, you can query this with the SpagoBI Meta Query Editor. To create a new Query you can: Right-click on the Business Model Root in the Business Model Editor and select Create > New Query Or right-click on a file.sbimodel inside your Project Explorer and select Create > New Query This will open a new wizard that let you create a new Query File (.metaquery) inside your project. The query file store you query definition and will be opened, edited and executed any time. Remember that to query your model the connection to the original database must be alive. The Query Editor is divided in two tabs (look at the bottom): The Edit tab: let you define and edit the query structure with a simple drag & drop graphical user interface. The Result tab: execute the query definied in the Edit Tab and shows the results in a grid with column sort and pagination. In the Edit tab, on the left, you have your Business Model as tree with Business Classes and Business Attributes inside. To the right you can see three panel for: Select Fields: the fields that will be showed in the results. You can apply alias name, aggregation functions, ordening, group by and more. Where clause: the filtering options that you want to apply to your interrogation. You can choose a left operand, an operation a write a right operand and combine it with another operand usign boolean connector. Having clause: this is similar to the where clause panel but applies to the group by operations. Page 14 - last modified by Marco Cortella on 2011/05/09 17:59