API/CodeSamples/DataSourceCategories.md
... ...
@@ -0,0 +1,62 @@
1
+#DataSourceCategories
2
+
3
+[[_TOC_]]
4
+
5
+##About
6
+
7
+This allows you to assign sets of data sources to different categories. When [[ShowDataSourcesAsCheckBoxes|/API/CodeSamples/ShowDataSourcesAsCheckBoxes]] is enabled, the [[Data Sources tab|http://wiki.izenda.us/Guides/ReportDesign/3.0-Data-sources-tab]] will display each category in bold below the Recent Data Sources dropdown and all data sources contained in that category will be displayed under that category. Otherwise, this setting has no effect.
8
+
9
+**Default Value:** Empty list
10
+
11
+##Global.asax (C♯)
12
+
13
+```csharp
14
+//main class: inherits DatabaseAdHocConfig or FileSystemAdHocConfig
15
+public class CustomAdHocConfig : Izenda.AdHoc.DatabaseAdHocConfig
16
+{
17
+ // Configure settings
18
+ // Add custom settings after setting the license key and connection string by overriding the ConfigureSettings() method
19
+ public static void InitializeReporting() {
20
+ //Check to see if we've already initialized.
21
+ if (HttpContext.Current.Session == null || HttpContext.Current.Session["ReportingInitialized"] != null)
22
+ return;
23
+ AdHocSettings.LicenseKey = "INSERT_LICENSE_KEY_HERE";
24
+ //Creates a connection to Microsoft SQL Server
25
+ AdHocSettings.SqlServerConnectionString = "INSERT_CONNECTION_STRING_HERE";
26
+ Izenda.AdHoc.AdHocSettings.AdHocConfig = new CustomAdHocConfig();
27
+ AdHocSettings.DataSourceCategories = new string[] {"Employees", "Territories"}; //The relevant setting
28
+ HttpContext.Current.Session["ReportingInitialized"] = true;
29
+ }
30
+}
31
+
32
+```
33
+
34
+##Global.asax (VB.NET)
35
+
36
+```visualbasic
37
+'main class: inherits DatabaseAdHocConfig or FileSystemAdHocConfig
38
+Public Class CustomAdHocConfig
39
+ Inherits Izenda.AdHoc.DatabaseAdHocConfig
40
+
41
+ Shared Sub InitializeReporting()
42
+ 'Check to see if we've already initialized
43
+ If HttpContext.Current.Session Is Nothing OrElse HttpContext.Current.Session("ReportingInitialized") IsNot Nothing Then
44
+ Return
45
+ 'Initialize System
46
+ AdHocSettings.LicenseKey = "INSERT_LICENSE_KEY_HERE"
47
+ AdHocSettings.SqlServerConnectionString = "INSERT_CONNECTION_STRING_HERE"
48
+ Izenda.AdHoc.AdHocSettings.AdHocConfig = New CustomAdHocConfig()
49
+ AdHocSettings.DataSourceCategories = New String() {"Employees", "Territories"} 'The relevant setting
50
+ HttpContext.Current.Session("ReportingInitialized") = True
51
+ End Sub
52
+End Class
53
+```
54
+
55
+##Screenshots
56
+
57
+```csharp
58
+AdHocSettings.DataSourceCategories["Employees"] = new string[] { "Employees", "Territories" };
59
+AdHocSettings.DataSourceCategories["Orders"] = new string[] { "Orders", "Products" };
60
+```
61
+
62
+![](http://wiki.izenda.us/API/CodeSamples/DataSourceCategories/datasourcecategories.png)
... ...
\ No newline at end of file