Integration/Tutorials/connect-to-the-database.md
... ...
@@ -34,21 +34,15 @@ Izenda Reports supports connecting to multiple data sources simultaneously by us
34 34
* _**Important!**_ For these steps, the database and NOT the file system must have the following permissions set:
35 35
* Ensure that the database login can read the tables and views
36 36
* Ensure that _"NT AUTHORITY\NETWORK SERVICE"_ account ("ASPNET" on XP) has the access level of "db_owner" permissions to the database which contains the tables and views
37
-* Open the Izenda Reports settings page by navigating to [Host]/[Virtual Directory]/settings.aspx in your web browser (i.e. http://localhost/AdHoc54/settings.aspx)
38
-* Set the database and connection information using the Settings.aspx page:
39
- * Click the "Database" Tab, which is second from the left on the tab bar
40
- * Set the server type drop-down to "SqlServer"
41
- * Copy and paste your license key (make sure there is no extra whitespace)
42
- * Copy and paste your connection string (make sure there is no extra whitespace, remove the quotes if copying from sample)
43
- * Sample standard connection string (local database):
44
- * **"Server=myAddress;Database=mydb;User ID=myUsername;Password=myPassword;"**
45
- * Sample non-trusted connection string (remote database):
46
- * **"Server=myServerAddress;Database=myDataBase;Trusted_Connection=True;"**
47
- * Click the "Test" button to test the connection string
48
- * You should see the word "Success" next to the "Test" button
49
- * If "Failure" then check your connection string again
50
- * Click the "Save to Izenda.config" button in the upper left hand corner
51
-* Click the "Preview (Requires Clearing Browser Cache)" Button to navigate back to the Report List page (ReportList.aspx)
37
+* Open your Izenda Reports Global.asax file in your IDE and find the ``InitializeReporting()`` method.
38
+* Update the [[LicenseKey|http://wiki.izenda.us/API/CodeSamples/LicenseKey]] and [[ConnectionString|http://wiki.izenda.us/API/CodeSamples/SqlServerConnectionString]]
39
+ * Sample standard connection string (local database):
40
+ * **"Server=myAddress;Database=mydb;User ID=myUsername;Password=myPassword;"**
41
+ * Sample non-trusted connection string (remote database):
42
+ * **"Server=Server\myAddress;Database=myDataBase;Trusted_Connection=True;"**
43
+* Save your global.asax
44
+* Build your project
45
+* Start up your project or navigate to your web server via browser
52 46
* Izenda Reports is ready for use
53 47
54 48
##Oracle 9i/10g Setup
... ...
@@ -67,20 +61,17 @@ Izenda Reports supports connecting to multiple data sources simultaneously by us
67 61
* Izenda Reports must have access to the metadata in the database
68 62
* Ensure that the database login can read the tables and views
69 63
* Ensure that _"NT AUTHORITY\NETWORK SERVICE"_ account ("ASPNET" on XP) has the access level of "db_owner" permissions to the database which contains the tables and views
70
-* Open the Izenda Reports settings page by navigating to [Host]/[Virtual Directory]/settings.aspx in your web browser (i.e. http://localhost/AdHoc54/settings.aspx)
71
-* Set the database and connection information using the Settings.aspx page:
72
- * Click the "Database" Tab, which is second from the left on the tab bar
73
- * Set the server type drop-down to "Oracle"
74
- * Copy and paste your license key (make sure there is no extra whitespace)
75
- * Copy and paste your connection string (make sure there is no extra whitespace, remove the quotes if copying from sample)
76
- * Sample Oracle Microsoft Provider connection string:
77
- * " Provider = msdaora ; Data Source = MyOracleDB ; User Id = myUsername ; Password = myPassword ;"
78
- * Note: Oracle connection strings vary greatly, if this example doesn't work, please consult your Oracle DBA
79
- * Click the "Test" button to test the connection string
80
- * You should see the word "Success" next to the "Test" button
81
- * If "Failure" then check your connection string again
82
- * Click the "Save to Izenda.config" button in the upper left hand corner
83
-* Click the "Preview (Requires Clearing Browser Cache)" Button to navigate back to the Report List page (ReportList.aspx)
64
+* Open your Izenda Reports Global.asax file in your IDE and find the ``InitializeReporting()`` method.
65
+* Update the [[LicenseKey|http://wiki.izenda.us/API/CodeSamples/LicenseKey]] and [[ConnectionString|http://wiki.izenda.us/API/CodeSamples/OracleConnectionString]]
66
+ * You can use your [[TNSNames.ora|http://www.orafaq.com/wiki/Tnsnames.ora]] file to create the connection string or you can plug the connection string directly into the OracleConnectionString.
67
+ * Sample standard connection string (using TNS):
68
+ * **"Data Source=TORCL;User Id=myUsername;Password=myPassword;"**
69
+ * Sample non-trusted connection string (without TNS):
70
+ * **"Data Source=(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=MyHost)(PORT=MyPort)))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=MyOracleSID)));
71
+User Id=myUsername;Password=myPassword;"**
72
+* Save your global.asax
73
+* Build your project
74
+* Start up your project or navigate to your web server via browser
84 75
* Izenda Reports is ready for use
85 76
86 77
##MySQL Setup
... ...
@@ -100,18 +91,22 @@ Izenda Reports supports connecting to multiple data sources simultaneously by us
100 91
* Izenda Reports must have access to the metadata in the database
101 92
* Ensure that the database login can read the tables and views
102 93
* Ensure that "NT AUTHORITY\NETWORK SERVICE" account ("ASPNET" on XP) has the access level of "db_owner" permissions to the database which contains the tables and views
103
-* Open the Izenda Reports settings page by navigating to [Host]/[Virtual Directory]/settings.aspx in your web browser (i.e. http://localhost/AdHoc54/settings.aspx)
104
-* Set the database and connection information using the Settings.aspx page:
105
- * Click the "Database" Tab, which is second from the left on the tab bar
106
- * Set the server type drop-down to "MySQL"
107
- * Copy and paste your license key (make sure there is no extra whitespace)
108
- * Copy and paste your connection string (make sure there is no extra whitespace, remove the quotes if copying from sample)
109
- * Sample MySQL .NET connector on default port 3306
110
- * **"DRIVER={MySQL ODBC 5.1 Driver};Server=myServerAddress;Database=myDataBase;Uid=myUsername;Pwd=myPassword;"**
111
- * MySQL connection strings can vary greatly depending on installed components, if this does not work, please consult your MySQL database administrator
112
- * Click the "Test" button to test the connection string
113
- * You should see the word "Success" next to the "Test" button
114
- * If "Failure" then check your connection string again
115
- * Click the "Save to Izenda.config" button in the upper left hand corner
116
-* Click the "Preview (Requires Clearing Browser Cache)" Button to navigate back to the Report List page (ReportList.aspx)
117
-* Izenda Reports is ready for use
... ...
\ No newline at end of file
0
+* Open your Izenda Reports Global.asax file in your IDE and find the ``InitializeReporting()`` method.
1
+* Update the [[LicenseKey|http://wiki.izenda.us/API/CodeSamples/LicenseKey]] and [[ConnectionString|http://wiki.izenda.us/API/CodeSamples/MySqlConnectionString]]
2
+ * Sample standard connection string (using SSL):
3
+ * **"Driver={MySQL ODBC 5.2 ANSI Driver};Server=myServerAddress;Database=myDataBase;User=myUsername;Password=myPassword;sslca=c:\cacert.pem;sslcert=c:\client-cert.pem;sslkey=c:\client-key.pem;sslverify=1;Option=3;"**
4
+ * Other sample connection strings: https://www.connectionstrings.com/mysql/
5
+* Save your global.asax
6
+* Build your project
7
+* Start up your project or navigate to your web server via browser
8
+* Izenda Reports is ready for use
9
+
10
+##Testing your connection string
11
+
12
+If you wish to test your connection string to ensure connectivity, you can perform the following steps:
13
+
14
+* Click the settings button on the ReportList page toolbar
15
+* The KEY & DB CONNECTION tab should be open
16
+* The license key and connection string you entered will be hidden, showing only "*******" in its place.
17
+* Click "Test" below the connection string
18
+* Text will appear below the field describing either "SUCCESS" or "FAILURE". Failure lists the reason why it failed.
... ...
\ No newline at end of file