b37c4b37c698e2fa36a0f09ce6b1926beda09f52
API/ShowAdditionalJoinConditions.md
| ... | ... | @@ -0,0 +1,59 @@ |
| 1 | +#ShowAdditionalJoinConditions |
|
| 2 | + |
|
| 3 | +[[_TOC_]] |
|
| 4 | + |
|
| 5 | +##About |
|
| 6 | +**Data Type:** Bool |
|
| 7 | +**Accepted Values:** true,false,1,0 |
|
| 8 | +**Default value:** true |
|
| 9 | +**Impacted Features:** Report Designer |
|
| 10 | +**Purpose:** Adds the ability to add multiple conditions to each join. |
|
| 11 | +**Usage:** This setting is used to create more complex joins where And, Or and other operators need to be used in join conditions. |
|
| 12 | +**Caveats:** More complex joins will add to the initial report load. If caching is turned off, this processing time will occur each time the report loads. This can be alleviated in part by ensuring to use indexed and/or key columns. |
|
| 13 | + |
|
| 14 | +##Code Samples |
|
| 15 | +###Global.asax (C♯) |
|
| 16 | + |
|
| 17 | +```csharp |
|
| 18 | +//main class: inherits DatabaseAdHocConfig or FileSystemAdHocConfig |
|
| 19 | +public class CustomAdHocConfig : Izenda.AdHoc.DatabaseAdHocConfig |
|
| 20 | +{ |
|
| 21 | + // Configure settings |
|
| 22 | + // Add custom settings after setting the license key and connection string by overriding the ConfigureSettings() method |
|
| 23 | + public static void InitializeReporting() { |
|
| 24 | + //Check to see if we've already initialized. |
|
| 25 | + if (HttpContext.Current.Session == null || HttpContext.Current.Session["ReportingInitialized"] != null) |
|
| 26 | + return; |
|
| 27 | + AdHocSettings.LicenseKey = "INSERT_LICENSE_KEY_HERE"; |
|
| 28 | + AdHocSettings.SqlServerConnectionString = "INSERT_CONNECTION_STRING_HERE"; |
|
| 29 | + Izenda.AdHoc.AdHocSettings.AdHocConfig = new CustomAdHocConfig(); |
|
| 30 | + AdHocSettings.ShowAdditionalJoinConditions = true; //The relevant setting |
|
| 31 | + HttpContext.Current.Session["ReportingInitialized"] = true; |
|
| 32 | + } |
|
| 33 | +} |
|
| 34 | +``` |
|
| 35 | + |
|
| 36 | +###Global.asax (VB.NET) |
|
| 37 | + |
|
| 38 | +```visualbasic |
|
| 39 | +'main class: inherits DatabaseAdHocConfig or FileSystemAdHocConfig |
|
| 40 | +Public Class CustomAdHocConfig |
|
| 41 | + Inherits Izenda.AdHoc.DatabaseAdHocConfig |
|
| 42 | + |
|
| 43 | + Shared Sub InitializeReporting() |
|
| 44 | + 'Check to see if we've already initialized |
|
| 45 | + If HttpContext.Current.Session Is Nothing OrElse HttpContext.Current.Session("ReportingInitialized") IsNot Nothing Then |
|
| 46 | + Return |
|
| 47 | + 'Initialize System |
|
| 48 | + AdHocSettings.LicenseKey = "INSERT_LICENSE_KEY_HERE" |
|
| 49 | + AdHocSettings.SqlServerConnectionString = "INSERT_CONNECTION_STRING_HERE" |
|
| 50 | + Izenda.AdHoc.AdHocSettings.AdHocConfig = New CustomAdHocConfig() |
|
| 51 | + AdHocSettings.ShowAdditionalJoinConditions = true 'The relevant setting |
|
| 52 | + HttpContext.Current.Session("ReportingInitialized") = True |
|
| 53 | + End Sub |
|
| 54 | +End Class |
|
| 55 | +``` |
|
| 56 | + |
|
| 57 | +##Screenshots |
|
| 58 | + |
|
| 59 | +AdHocSettings.ShowAdditionalJoinConditions = true; |