### IRIS BI We offer you to embed business intelligence into your applications in order to give your users an opportunity to ask and answer sophisticated questions about their data. Typically, your application will include customizable dashboards that can provide insight into data from Business Intelligence models known as cubes. In contrast with traditional BI systems that use static data warehouses, Business Intelligence keeps being constantly synchronized with the live transactional data. We will use DeepSee User Portal as a dashboard builder and DeepSeeWeb - as the display of dashboards. #### Logging on to Business Intelligence To log on to Business Intelligence, do the following in the Management Portal:
  • Switch to the appropriate namespace as follows:
  • Select Analytics. The system always displays a list of the tools for Business Intelligence:
  • The Management Portal provides access to all Business Intelligence tools, including the back-end tools such as the Architect and the User Portal. Since the User Portal is intended for end users, it does not enable most users to return to the Management Portal. ### Architect First of all, you need to define the data structure in the architecture. To do that, you need to create a cube based on the class. The Architect enables you to define cubes and subject areas. You can use this tool, Studio, or both. The Class Viewer provides a constructive view of the class properties of your base class (apart from relationship properties). It makes it easy to create InterSystems IRIS Business Intelligence elements based on those properties. It is also critical to know that although this view provides a convenient way to access some properties, you can likewise use a source expression to access any data. These source expressions are evaluated when the cube is built. Thus they do not affect your runtime performance. You can fine a detailed guide on how to build a cube [here](https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=D2DT_CH_CUBE) ![](https://lh6.googleusercontent.com/bbNHO1zgFfp45dBTFtqeF-v-wZX0XiRrrqcbM96ol8dJfLnmwdWw9OmZIRWmw9bka6x1lXW5ujVtRjCKGVDk57Fc5Cth904ut0eI_6uQCIz7e3otri2AlvbGFyoN2aQmRIypX77DOsCspjO2BQl9YzaiZlFha3MitWZSuPKvekSZBZqtJhMBd-Hs3XzTPw) Example of a finished cube ### Creating Pivot Tables Once you have built the cube, the next step is to create a pivot table to use in DeepSeeWeb. To do this, use the Analyzer tool. This tool enables you to define pivot tables. It looks like the following image. ![](https://lh5.googleusercontent.com/dBo1YZXHIGkdNlQitGUZK-TUm8SErrxpvlfyx9t64SnvG3HEB2G1v3BKTlpWPVjjtg8y92sMS7UGtkNPQLv1sPm5u-BIPjOWXUnAsyA7U65wpEQcRbUfA9B7qYq5ZUhk5XkcFGSDy9bdzfvFHP7mB8iTjSH_7uBqzqd9u6J8YOeiPILQpVaNydTMUi4bQA) #### Selecting a Subject Area A subject area provides the elements that you use as the basis of any pivot table. To select the subject area:
  • Click the Change button or click the Select Subject Area link.
  • Click the name of the subject area.
  • Click OK.
  • The [Model Contents](https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=D2ANLY_ch_intro#D2ANLY_intro_orientation_model_contents) area lists the contents of the subject area that you are currently viewing. For instance, this area might look like this initially: ![](https://lh5.googleusercontent.com/E-w21Em2IjHsJv8Vq03WJ4oDJIZZo-P5uo4PL7rIZizeYQ8Mbm_OYQhaAwfUK5c_J9CQ3w7M2We6N1ECcpYOYrCzDhclDjhJH5OEhZQPuVhEAx9pe84Uscl20oxRfFWdctrlQfjPteIH3eiKQOJcp7smjsEq7AgfCC2T9P6_fHBjbLeNiMZOfD6CE_3IGQ) If you have not worked with the current subject area before, it can come in handy to examine its contents. First, use the drop-down list to select the kind of item to display in this area. Select one of the following:
  • Dimensions — Choose this to display the basic model defined in this subject area. In this case, the Model Viewer can show you the following sections:
  • Pivots — Pick this to display any pivot tables defined in this subject area.
  • Quality Measures — opt for this to display any quality measures available in this subject area.
  • Detail Listings — Select this to display any detail listings defined in this subject area.
  • The purpose of the Model Content area is to enable you to create pivot tables. To make it happen, drag and drop items into the [Pivot Builder](https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=D2ANLY_ch_intro#D2ANLY_intro_orientation_pivot_builder) area on the right, as described in the [next section](https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=D2ANLY_ch_analyzer#D2ANLY_analyzer_creating). #### Measures To display a list of measures, choose **Dimensions** from the drop-down list in the [Model Contents](https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=D2ANLY_ch_intro#D2ANLY_intro_orientation_model_contents) area. Then expand the **Measures** folder. This folder lists all measures in the subject area. For example: ![](https://lh3.googleusercontent.com/etDGm0ydQ1JAEGjBc-j5qgYopAe3TkwDNyjGIPna-MZ_rLGWr-UJfKJPUyANVr7kqfd-B5i2wjw8xOWcIXP9pe39-ZiXtdnRn0Kit3tolA2WeYb3Ng8oDqkFsWTGuoPzZ1nwM-XoFFJjveEkbtKIeS7MmIQ4_CxrKuDdF_QsYoFoMh5kV4HbIhTjWvSpUA) #### Dimensions To display a list of dimensions, select **Dimensions** from the drop-down list in the [Model Contents](https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=D2ANLY_ch_intro#D2ANLY_intro_orientation_model_contents) area. Then expand the **Dimensions** folder. This folder lists the dimensions and the levels, members, and properties that it contains. It might also list [related subject areas](https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=D2ANLY_ch_analyzer#D2ANLY_analyzer_cubeorientation_dim_relcube), with their dimensions, levels, and so on. ![](https://lh5.googleusercontent.com/CRKiHQjzklm3hMRDF94OhH1dkL-fdYuqTZ_8kr_Ubghslaciq6PJcwK1IGCAKxSRtsNUtxHiM9lixd1qGFU9Qblr4WCy0tLp5jPLdfsk7Cu7KFwfnxUCm9BEV1QLEw1Ho4sdDC1om6azJ48UliM7QT2w6u0qL1cTXSfmeJ7uv7j2xdz6eLMSE8xd3pOcXQ) ### DeepSee User Portal The User Portal is intended to be utilized directly by end users (in contrast to such back-end tools as Studio and the Management Portal). The User Portal is designed in a way which should enable you to do the following tasks:
  • View and use dashboards and pivot tables as well as all pieces of information which contain a key. For Ensemble users, this information can include Ensemble business metrics. For DeepSee users, this information is displayed like aggregated views of your data that you can investigate in various ways. You can organize these items into folders for easier management. You can also attach keywords to those items to make it easier to find them more quickly next time.
  • Share your dashboards and pivot tables with other users. The User Portal is a shared environment. It means that the same items are visible to all users who have access to the User Portal for a given Caché namespace.
  • Create dashboards, which generally display pivot tables and other elements such as meters and scorecards. Dashboards are typically intended to address specific business needs.
  • Access the DeepSee Analyzer that can help you create pivot tables or perform ad hoc analysis of data.
  • Share and access links to web pages and Zen reports.
  • (For Ensemble workflow users) Manage your workflow tasks.
  • In a supported browser, go to the following URL: http://localhost:57772/csp/samples/_DeepSee.UserPortal.Home.zen or in Portal Home follow: Analytics -> User Portal The User Portal looks like the following image: ![](https://lh5.googleusercontent.com/tcvT1ShenUEp2AWOE10bulO0-t_6-Yz6TeGaRDr6IkhgQZFaZand2Tp7IxdBorqX5DbmakG3cEVamFHKu71wxPCZt5GsweulLTrZ1g3jJEoa1t4wcIUTJyAmKP9MxfoJqWGR4_xpv5hgE0gH3MIjiA0y5Af-m3mPHIblXA1UKhh7GFTQCjqvGIu2xfLSDw)
  • The left area contains worklists, which are rectangular areas that have tools. For details, check out “Using Worklists in the User Portal.” In SAMPLES, these areas are initially blank.
  • The main area on the right shows the public DeepSee pivot tables, dashboards, and other items. Here you can open items, delete them, and mark them as favorites. You can also expand or collapse the folders. The top area provides a search option. Regarding a dashboard, this area displays the title of the dashboard if there is one. Otherwise, this area indicates the name of the dashboard. This area does not show items that are marked as private. If you are an Ensemble workflow user, the main area will also display an item labeled Workflow Inbox.
  • The Menu link in the upper left corner contains options to create and open dashboards and pivot tables, and perform other tasks in DeepSee. If you are assigned the %Developer role, this menu also includes an option to access the Management Portal.
  • The Home link at the top displays this page.
  • The Logout link enables you to log out.
  • The User Portal is a shared environment. Many of the items you see are also visible to other users. ## About Pivot Tables and Dashboards _Pivot tables_ are central to InterSystems DeepSee; they select and aggregate data. The following figure shows an example of a pivot table that illustrates the number of patients and the average allergy count per patient, grouped by age and gender. ![](https://lh6.googleusercontent.com/G2kiFotNMmXL67x3WqwfRYFzsjVg35goqe-2ye4lvm1l7XyE-qMNLCorS6qPiGbCceWJawaDS-6MDuKmYXVyml2zvkj8i1dg1L1bR9BkCwjibM8u5vyi3d7I8ec1xuFCMsFskhXMogHDPNRN7SwWy2PSO4wFqsUj38ghGDlloN9Pkz4-6vTjwSKc8YzAHA) Using this sample as a reference, let us discuss the key terms in DeepSee:
  • A level is used to group the source data. A level has members. Each member, in turn, corresponds to a specific set of records in the source data. For instance, the Age Group level has the members 0-29, 30-39, and 60+. The Gender level has the members Female and Male.
  • A measure is a value displayed in the body of the pivot table. It is based on the values in the source data. For a given context, a measure aggregates the values for all applicable source records and represents them with a single value. For example, the measure Patient Count is the number of patients, and the measure Avg Allergy Count is the average number of allergies per patient.
  • You typically see a pivot table within a _dashboard_, as follows: ![](https://lh4.googleusercontent.com/QBVu1V6BDzj8s17gfYhTHMm7JMoxNsb2GpflbCJJ9-Q6i-g6knqdeRnhdgJ8f7Fu9G6GOAmwVdWm9u3xpjoOFu8WJRGjNSPy1NO9wqEc3lIgUCbNogRTqaw62MPt4wYO55_RHUG70OeUMsnr640IxUrjRSVzNt6jSI0JxG-ddSSkLrzSt9WIETtGpFjSfQ) Pay attention to the multiple filters (shown in the **Filters** box) that this dashboard includes. You can use them to filter the items on this dashboard. Dashboards can include other kinds of elements, such as _meters_ and _scorecards_. A scorecard shows multiple rows of data in a tabular format that also contains features including value-dependent lamps and arrows. For instance: ![](https://lh6.googleusercontent.com/ZQ1VohCvU77ho2O9go1a4HDzNZk4HRAQkP8kb3Dlr41GAiuI_b6PGIwgvEkGhUfNr7TlLO8tr9Q27Lp2i_XBg4EXegSni0fz_WdQE7fQvyAbNW7uXP40k-LRXZ8H4A_Ov6eBOddb_kGtVMHj1_zvX9P5iG5KTiF6MHPJ3mdvO-e-y3eFFE_nf8kZ3mJ0xg) A meter shows one or more values in graphical objects as depicted in the following image: ![](https://lh3.googleusercontent.com/yhauOVFz9G2K4wh5Ni96hg8hNySDO6Wphmfvb8drxBX0bjd4pkyay0sP3IQqWRUmgau9syiSkVibqA1aaVW5on2SfOlMHNFKp3OVkd42YI6mlrtZzTdch1KeUil5ec_KIHXGL5NRzjNskCkssj2miuh10x4wYvGgVWuAXJhN1iOY9jESyHcAlBgY_GgSIw) ### DeepSeeWeb Description and installation instructions can be found [here](https://openexchange.intersystems.com/package/DeepSeeWeb) DeepSeeWeb is a Renderer for DeepSee Dashboards in a Browser with MDX2JSON as a Server Side and JS web-client. Developed using AngularJS and Bootstrap. After all the steps are done, you need to follow the link:  http://{host}:{port}/dsw/#/{namespcae}/{folder}/{dashboard}.dashboard Example: http://localhost:57772/dsw/#/IRISAPP/Test/Countries.dashboard DeepSeeWeb will look like the following:  ![](https://lh3.googleusercontent.com/yxJSVOacL_mLxxVq7oSRfEwUI6u0cS7WE3NQVSGOY5PIL0UUZO7ME7IMEnItTMLvTza3P_PBEmv1bys-LbCgtXsmvTDTkGiboMmtBxwA_9BWdT9QF6iaPGsC2o4uu3aw1231sUSo15u6_Jvl9plYaaF31IedR-FuUROY_jt7GWoMo-U0MoL6O_2riv4miw)