Merge pull request #26 from xedinseu/teccod-update

Teccod update

Author: MakarovS96

README.md

@@ -3,13 +3,57 @@
 [![Gitter](https://img.shields.io/badge/chat-on%20telegram-blue.svg)](https://t.me/joinchat/FoZ4M0KF5NakAJPwyg1Saw)
 
 InterSystems Developer Community analytics.
-Project made with InterSystems Analytics (DeepSee) to visualize and analyze members, articles, questions, answers, views and other pieces of content and activity on [InterSystems Developer Community](community.intersystems.com)
+Project made with InterSystems Analytics (DeepSee) and various BI systems to visualize and analyze members, articles, questions, answers, views and other pieces of content and activity on [InterSystems Developer Community](community.intersystems.com). This project contains pre-configured IRIS and Atscale  deployment in Docker containers and project files for BI systems .
 
-[See Live DC analytics](https://analytics.community.intersystems.com/dswpub/index.html#!/?ns=COMMUNITYPUBLIC&embed=1)
-![DC analytics](https://github.com/MakarovS96/images/blob/master/dcanalitycs.jpg)
+[See Live DC analytics](we'll provide the link to online demo as soon as we made it)
+
+### 1. To start IRIS 
+Open the terminal in this directory and run:  
+```
+$ docker-compose up -d iris
+```
+Check the availability of the service:  
+http://localhost:52773/dsw/index.html#/DCANALYTICS 
+    
+Standard login and password:  
+_system/SYS 
+
+### 2. To start the Atscale server:  
+
+A license must be entered to run Atscale server. To do this, you need to put the json file with the license in the folder "atscale-dataset/src/license".
+
+If you need to change hostname parameter, open directory "atscale-dataset", file "atscale.yaml" and edit (ip or dns name):  
+loadbalancer_dns_name: "127.0.0.1"  
+    
+Run docker container with the command:  
+```
+docker-compose up -d atscale  
+```
+Wait 2-3 minutes while server is starting up and check the availability of the service:  
+http://localhost:10500/login  
+    
+Standard login and password:  
+admin/admin 
+
+If you want to access the web interface, at the initialization step, you need to leave the default connection port, leave the login and password admin / admin and select an Embedded directory for storing data. These connection settings are stored in the BI projects settings.
+
+### 3. To use BI projects
+
+#### Power BI
+
+You may simply run the .pbix file from "analytic dashboards\Power BI" in Power BI desktop. Power BI stored data in this file, so to have actual data you firstly need to update the report by the Refresh button.
+
+#### Logi
+You need a licensed copy of the Logi report Designer to run the reports.
+
+In the folder "analytic dashboards\logi report\En report" you can find the report for the EN community.
+
+In folder "analytic dashboards\logi report\members by community" you can find the report about distribution of members by different language communities.
 
 # Collaboration
 
+If you want to use this project on your inw IRIS installation, you may use the following instructions.
+
 ## Installation
 ### Basic
 1. First be sure, that you have [MDX2JSON](https://github.com/intersystems-ru/Cache-MDX2JSON) and [DSW](https://github.com/intersystems-ru/DeepSeeWeb) installed.

analytic dashboards/Power BI/InterSystems En local.pbix

@@ -0,0 +1,24 @@
+## AtScale
+First you need to run two AtScale and IRIS containers “docker-compose up -d atscale”, “docker-compose up -d iris”. The AtSacle container already has a test published cube.
+
+## PowerBI
+To view and develop reports on PowerBI, first of all, you need to download PowerBI Desktop on the official Microsoft website https://www.microsoft.com/store/productId/9NTXR16HNW1T
+Then, to connect, you need to click Get data -> More -> Database -> AtScale cubes.
+
+![image](https://user-images.githubusercontent.com/47400570/165940147-26abee0c-2030-4b44-9622-d3eced32c081.png)
+
+In the server field, you need to insert an MDX link and select Data Connectivity mode "DirectQuery" and click OK.
+
+![image](https://user-images.githubusercontent.com/47400570/165940185-9c02d280-08ac-4d71-9e20-c9c1277cb43e.png)
+
+An authorization dialog will open in which you need to enter User name and Password (default admin: admin), then click Connect
+
+![image](https://user-images.githubusercontent.com/47400570/165940238-74fc94a2-92a7-434d-bdbe-e161116a9ac8.png)
+
+Then a dialog box will open, where all available cubes in the source will be displayed, select the one you need and click Load.
+
+![image](https://user-images.githubusercontent.com/47400570/165940278-accc4fa7-d521-4972-93fc-b59ba5610fcf.png)
+
+Done. Now you can start developing dashboards. On the left are the fields that can be used to build reports.
+
+![image](https://user-images.githubusercontent.com/47400570/165940410-0c7cdd67-0adf-450c-901c-5b455a8fde1d.png)

analytic dashboards/Power BI/README.md

@@ -0,0 +1,47 @@
+## AtScale
+To develop reports on PowerBI + AtScale, you first need to run the AtScale and IRIS containers “docker-compose up -d atscale”, “docker-compose up -d iris”.
+
+### Creating a cube in AtSacle
+Go to http://localhost:10500 is authorized (default admin:admin) in the top navigation menu go to Projects, all created projects will be displayed here. The container already has a GameOfThrones test project.
+
+To create your own cube, you need to click “+ New projects” in Projects and write the name of the project in the window that appears.
+
+![image](https://user-images.githubusercontent.com/47400570/165940835-7ced36e6-5a0e-4ec6-aadb-aab6729035a7.png)
+
+Then you need to go to the created project and press Enter Model.
+
+![image](https://user-images.githubusercontent.com/47400570/165940869-a963617e-160e-429a-9fcd-5082fbc6b4dd.png)
+
+To view detailed documentation, you can go to Support -> Documentation. Here is the official AtScale documentation.
+
+EnCommunityAnalytics2 test cube example:
+
+![image](https://user-images.githubusercontent.com/47400570/165940961-71666008-8186-4ac8-906a-79dda15e3567.png)
+
+Then you need to publish this project by going to Project -> (your project) and clicking Publish.
+
+![image](https://user-images.githubusercontent.com/47400570/165941009-9b5e94d5-e1a3-4bb5-95c2-4547db685bf2.png)
+
+## PowerBI connection
+
+First of all, you need to download PowerBI Desktop on the official Microsoft website https://www.microsoft.com/store/productId/9NTXR16HNW1T
+
+Then, to connect, you need to click Get data -> More -> Database -> AtScale cubes.
+
+![image](https://user-images.githubusercontent.com/47400570/165941132-8ee8c6e4-1fa6-4208-9a83-2f8b0d498110.png)
+
+In the server field, you need to insert an MDX link and select Data Connectivity mode "DirectQuery" and click OK.
+
+![image](https://user-images.githubusercontent.com/47400570/165941252-28f1eaf7-2b9a-44ad-a1ea-962f474a3cd9.png)
+
+An authorization dialog will open in which you need to enter User name and Password (default admin: admin), then click Connect.
+
+![image](https://user-images.githubusercontent.com/47400570/165941281-6fabb96c-9c85-41d5-801b-26461ef04eb8.png)
+
+Then a dialog box will open, where all available cubes in the source will be displayed, select the one you need and click Load.
+
+![image](https://user-images.githubusercontent.com/47400570/165941335-bb47c062-20c5-4ed6-afdc-b3621bcbd447.png)
+
+Done. Now you can start developing dashboards. On the left are the fields that can be used to build reports.
+
+![image](https://user-images.githubusercontent.com/47400570/165941386-7da52024-a193-4c41-aff9-55bf0bf5da74.png)

analytic dashboards/Power BI/README_DEV.md

@@ -0,0 +1,45 @@
+## logi-dataset description
+
+
+### Launch DC report:  
+    
+1. Open "My Folder"  
+<img src="https://user-images.githubusercontent.com/49229973/152959081-e8f7d3d9-00f6-45c9-80ff-3af1d5aefa39.jpg" width="800" />
+
+2. Run the report "EnCommunityAnalytics.cls".  
+To run correctly, containers with Iris and Atscale must be running.  
+
+<img src="https://user-images.githubusercontent.com/49229973/152959921-8b75d8b6-4961-4e2d-9a62-2c5540e6dfab.jpg" width="800" />
+
+    
+### Mail sending settings (SMTP server):  
+1. To configure the sending of letters, select "E-mail Server" in the menu.
+<img src="https://user-images.githubusercontent.com/49229973/152951413-03fa35e7-f9e3-4430-a6a7-d8c31887a3a6.jpg" width="800" />
+
+2. Fill in the required fields to connect to your SMTP server in step 1.  
+In step 2, enter your login and password if your SMTP server requires authorization.  
+<img src="https://user-images.githubusercontent.com/49229973/152951824-1a48390b-b750-445c-a341-c173a4d89318.jpg" width="800" />
+
+### Sending a report to E-mail:
+1. To send reports to E-mail and check the operation of the SMTP server, select "EnCommunityAnalytics.cls" and click "Shedule".  
+<img src="https://user-images.githubusercontent.com/49229973/152983037-11c5156c-14cb-4554-b898-e59ddc5ae59e.jpg" width="800" />
+
+2. Enter a name for the report and select the "Export to One File" option, then click "Next".  
+<img src="https://user-images.githubusercontent.com/49229973/152983524-ca8f9da5-f48b-4aec-a59c-b7195f9651fc.jpg" width="800" />
+
+3. All settings can be left by default, except for selecting the type of sending "To E-mail" and clicking "New".  
+<img src="https://user-images.githubusercontent.com/49229973/152983569-407edc1b-1cb3-430a-8650-d2fc06cb8313.jpg" width="800" />
+
+4. Specify the E-mail to which the report will be sent and the format, for example, as a PDF.  
+<img src="https://user-images.githubusercontent.com/49229973/152983621-74f40d4a-d19d-42c2-8cf9-3fb23b9605f3.jpg" width="800" />
+
+5. Your E-mail should appear in the "Mail To" field, after which you can click "Finish".  
+<img src="https://user-images.githubusercontent.com/49229973/152983662-e85f4243-2e42-4869-a8bc-30fe26e6925b.jpg" width="800" />
+
+6. The sending status can be checked in the "My Task" tab.  
+
+"Is Successful" - "Yes" - the message was sent successfully  
+<img src="https://user-images.githubusercontent.com/49229973/152983679-cee06bec-616c-490e-9fc8-d6d1ebf845d7.jpg" width="800" />
+
+"Is Successful" - "No" - there are errors while sending, click "Details" to see the details  
+<img src="https://user-images.githubusercontent.com/49229973/152985927-1f2811d7-1a79-4ae5-bc90-d604fc82af8f.jpg" width="800" />.