Guides/mongo-bi-connector.md
... ...
@@ -0,0 +1,71 @@
1
+#Using MongoDB Connector for BI with Izenda Reporting
2
+
3
+[[_TOC_]]
4
+
5
+##About
6
+
7
+This tutorial is meant to provide guidance in setting up Izenda to work with MongoDB's Connector for BI. The MongoDB Connector for BI is proprietary to MongoDB, and will only be available to MongoDB Enterprise users. Izenda will not ship with MongoDB or the BI Connector. The BI Connector is designed for use with business intelligence applications like Izenda, and provides an ODBC connection and SQL translator for a MongoDB noSQL database. It does not store information, but it creates a schema, and uses PostgreSQL 9.4 as a standard.
8
+
9
+Izenda is not responsible for any data issues resulting from the use of the MongoDB Connector for BI.
10
+
11
+##Prerequisites
12
+
13
+You will need to have a MongoDB Enterprise Server set up to use the Connector for BI. You will also need to set up the BI Connector on a Linux server. Please see the following links for more information:
14
+
15
+- [[MongoDB Download Center - Get Enterprise Server and/or BI Connector|https://www.mongodb.com/download-center?jmp=nav#enterprise]]
16
+- [[MongoDB Enterprise Server Documentation|https://docs.mongodb.com/manual/?_ga=1.160186494.270323263.1463507060]]
17
+- [[MongoDB Connector for BI Documentation|https://docs.mongodb.com/bi-connector/]]
18
+
19
+##Setting Up the Connection
20
+
21
+Once you have installed the Connector for BI and opened the appropriate ports, you are ready to connect Izenda to your MongoDB database. Izenda does not require any special downloads or drivers to connect to the BI Connector, as Izenda ships with a PostgreSQL driver. To connect, simply form your connection string:
22
+
23
+- Server=(host name);Port=(port - MongoDB default is 27032);Database=(same as username);User Id=(username created during setup for BI Connector);Password=(created during setup for BI Connector);
24
+
25
+You can add the connection string via [[AdHocSettings.PostgreSQLConnectionString|http://wiki.izenda.us/Integration/Tutorials/connect-to-the-database#PostgreSQL-9+]], or via [[Fusion connection|http://wiki.izenda.us/Guides/Izenda-AdHoc-Driver#Izenda-Fusion-Driver]].
26
+
27
+##Code Samples
28
+**Global.asax (C♯)**
29
+```c#
30
+
31
+//main class: inherits DatabaseAdHocConfig or FileSystemAdHocConfig
32
+public class CustomAdHocConfig : Izenda.AdHoc.DatabaseAdHocConfig
33
+{
34
+ // Configure settings
35
+ // Add custom settings after setting the license key and connection string by overriding the ConfigureSettings() method
36
+ public static void InitializeReporting() {
37
+ //Check to see if we've already initialized.
38
+ if (HttpContext.Current.Session == null || HttpContext.Current.Session["ReportingInitialized"] != null)
39
+ return;
40
+ AdHocSettings.LicenseKey = "INSERT_LICENSE_KEY_HERE";
41
+ //Creates a connection to Microsoft SQL Server
42
+ AdHocSettings.PostgreSQLConnectionString = "Server=127.0.0.1;Port=27032;Database=izmongo;User Id=izmongo;Password=***;"; //The relevant setting
43
+ Izenda.AdHoc.AdHocSettings.AdHocConfig = new CustomAdHocConfig();
44
+ HttpContext.Current.Session["ReportingInitialized"] = true;
45
+ }
46
+}
47
+```
48
+
49
+**Global.asax (VB.NET)**
50
+
51
+```visualbasic
52
+
53
+'main class: inherits DatabaseAdHocConfig or FileSystemAdHocConfig
54
+Public Class CustomAdHocConfig
55
+ Inherits Izenda.AdHoc.DatabaseAdHocConfig
56
+
57
+ Shared Sub InitializeReporting()
58
+ 'Check to see if we've already initialized
59
+ If HttpContext.Current.Session Is Nothing OrElse HttpContext.Current.Session("ReportingInitialized") IsNot Nothing Then
60
+ Return
61
+ 'Initialize System
62
+ AdHocSettings.LicenseKey = "INSERT_LICENSE_KEY_HERE"
63
+ AdHocSettings.PostgreSQLConnectionString = "Server=127.0.0.1;Port=27032;Database=izmongo;User Id=izmongo;Password=***;" 'The relevant setting
64
+ Izenda.AdHoc.AdHocSettings.AdHocConfig = New CustomAdHocConfig()
65
+ HttpContext.Current.Session("ReortingInitialized") = True
66
+ End Sub
67
+
68
+End Class
69
+```
70
+
71
+