71b0d82138d7d37f11fd21526df683b9af62c0b0
Guides/ReportDesign/3.0-Data-sources-tab.md
| ... | ... | @@ -8,11 +8,11 @@ The Data Sources tab shows you which Tables or Views you have access to from the |
| 8 | 8 | |
| 9 | 9 | ##3.1 Simple Mode |
| 10 | 10 | |
| 11 | -![]() |
|
| 11 | + |
|
| 12 | 12 | |
| 13 | 13 | The screenshot above takes a look at the simple view of the datasources tab. Tables and views are represented by checkboxes that become enabled/disabled based on the primary keys located in the selected items. This means that when you check one box, all tables that cannot be joined to it will automatically be disabled. After each subsequent table you join by clicking, the list of available tables that are valid candidates to join with will be refreshed (see image below). |
| 14 | 14 | |
| 15 | -![]() |
|
| 15 | + |
|
| 16 | 16 | |
| 17 | 17 | ##3.2 Admin Tips |
| 18 | 18 | |
| ... | ... | @@ -24,31 +24,33 @@ Report administrators should check out the following code samples for the method |
| 24 | 24 | |
| 25 | 25 | ##3.3 Advanced Mode |
| 26 | 26 | |
| 27 | -In Advanced Mode, you will have to select the relationships that exist between the tables or views yourself. You will start with a drop-down menu that lists the various Tables and Views that are available. The following section requires basic knowledge of database terminology. |
|
| 27 | +In Advanced Mode, you will have to select the relationships that exist between the tables or views yourself. You will start with a drop-down menu that lists the various Tables and Views that are available (outlined in red in the screenshot below). The following section requires basic knowledge of database terminology. |
|
| 28 | 28 | |
| 29 | -![The Primary Table Dropdown Menu]() |
|
| 29 | + |
|
| 30 | 30 | |
| 31 | 31 | To join two tables and/or views, they must have fields with identical primary/foreign keys. For example, in the Northwind sample database, both the **Customers** and the **Orders** tables have the same *CustomerID* field. These two tables will be able to be joined together using the **primary key** in the Customers table and the **foreign key** in the Orders table. Foreign keys are not required to have the same name as the primary key, but must possess a relationship that results in one or more selected rows when joined together. To add another table to join on, press the  button. |
| 32 | 32 | |
| 33 | 33 | The very first dropdown on the new row is the **Primary Table** dropdown menu (shown below). This is the table/view you want to join into your collection of Data Sources. This will hold all of your possible DataSources regardless if they have fields that can act as viable joining points to your source table/view or not. |
| 34 | 34 | |
| 35 | -![The Primary Key Dropdown Menu]() |
|
| 35 | + |
|
| 36 | 36 | |
| 37 | 37 | When you select an additional Data Source, Izenda will automatically attempt to find what it thinks the appropriate relationship is. However, in this view the user has the capability to manually define what these relationships should be. To that end, there is the **Primary Key** dropdown. This dropdown appears to the right of your joined table/view and contains a list of all the fields for that table/view. Below is a screenshot showing what this looks like. |
| 38 | 38 | |
| 39 | -![The Foreign Table Dropdown Menu]() |
|
| 39 | + |
|
| 40 | 40 | |
| 41 | 41 | The **Foreign Table** dropdown menu (shown below) is a list of the tables/views that have been selected previously. To eliminate self-referential issues, the table/view listed in the dropdown on the current row is not included. Select the table/view to join the table/view in that row. |
| 42 | 42 | |
| 43 | -![The Foreign Key Dropdown Menu]() |
|
| 43 | + |
|
| 44 | 44 | |
| 45 | 45 | The **Foreign Key** dropdown menu (shown below) is a list of fields in the table/view that are selected in the **Foreign Table** dropdown menu to the left. Here you can select the field to join with the table/view in the **Primary Table** dropdown. |
| 46 | 46 | |
| 47 | -![The Join Field Dropdown Menu]() |
|
| 47 | + |
|
| 48 | 48 | |
| 49 | 49 | The **Join Field** dropdown menu (shown below) is a list of options specifying how your Data Sources will be associated with each other and how data will be retrieved. Join types are explained in the Section 3.4. |
| 50 | 50 | |
| 51 | -**Admins:** See Section 3.2 for information on how to show this field (off by default). |
|
| 51 | +![The Join Field Dropdown Menu]() |
|
| 52 | + |
|
| 53 | +**Admins:** See Section 3.2 for information on how to show this field (hidden by default). |
|
| 52 | 54 | |
| 53 | 55 | ###3.3.1 Understanding the Data Model |
| 54 | 56 | |
| ... | ... | @@ -58,7 +60,7 @@ Most users choosing to use the Advanced Mode need to have a clear understanding |
| 58 | 60 | |
| 59 | 61 | The join type dropdown, as described above, is found to the right of the **Foreign key** field when joining Data Sources in Advanced Mode. By default, Izenda will perform a Left Join across the data sources selected. When this dropdown isn't shown, Izenda performs the default join operation. |
| 60 | 62 | |
| 61 | -![Join Types Venn Diagram]() |
|
| 63 | + |
|
| 62 | 64 | |
| 63 | 65 | ###3.4.1 SQL Samples of Various Join Types |
| 64 | 66 |