Merge pull request #8542 from mendix/qt-moveodatadoc

Move OData How-to to Refguide

Author: quinntracy

content/en/docs/howto/integration/exposing-data-to-bi-tools-using-odata.md renamed to content/en/docs/refguide/modeling/integration/odata-services/exposing-data-to-bi-tools-using-odata.md

@@ -1,8 +1,11 @@
 ---
 title: "Expose Data to BI Tools Using OData"
-url: /howto/integration/exposing-data-to-bi-tools-using-odata/
+url: /refguide/exposing-data-to-bi-tools-using-odata/
 weight: 13
 description: "Describes how to create a published OData service with resources, add the OData server to Tableau and Excel, combine resources in Tableau, and create custom queries."
+aliases:
+    - /howto/integration/exposing-data-to-bi-tools-using-odata/
+#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
 ## Introduction
@@ -65,15 +68,15 @@ In this section, we will outline the steps for adding more than one published en
 
 Imagine you have an app that helps with asset management. You have a Published OData Service with persistable entities called **SmartTask** and **Employee** that expose information. The domain model looks like this:
 
-{{< figure src="/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/asset-manager-domain-model.png" class="no-border" >}}
+{{< figure src="/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/asset-manager-domain-model.png" class="no-border" >}}
 
 To visualize data from your app in Tableau, follow these steps:
 
 1. Open **Tableau** and select **Connect** > **To a Server** > **OData**:
 2. Return to Studio Pro and double-click the published OData service. Copy the link in the **Location** field to the clipboard.
 3. On the **Server Connection** dialog box, enter the copied OData service **Location** link for the **Server**  address:
 
-    {{< figure src="/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582020.png" class="no-border" >}}
+    {{< figure src="/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582020.png" class="no-border" >}}
 
     Include authentication credentials if you set them up.
 
@@ -82,7 +85,7 @@ To visualize data from your app in Tableau, follow these steps:
 6. Click **Data** > **New Data Source** and repeat steps 1–5 to add a server connection for other published OData services.
 7. Open **Sheet1**. Under **Data**, click the first entity and drag a desired entity **Attribute** from **Measures** to **Dimensions**. In this case, click **Engineers** and drag **ID** from **Measures** to **Dimensions**:
 
-    {{< figure src="/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582012.png" class="no-border" >}}
+    {{< figure src="/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582012.png" class="no-border" >}}
 
 8. Similarly, click and drag an attribute from the second entity from **Measures** to **Dimensions**. In this case, click **SmartTasks** and drag **SmartTask_Engineer** from **Measures** to **Dimensions**.
 9. Go to **Data** > **Edit Relationships...** to define the relationship between the different data sources.
@@ -93,25 +96,25 @@ To visualize data from your app in Tableau, follow these steps:
     4. Remove any default mappings.<br />
     5. Click **Add...** to configure a field mapping.
 
-    {{< figure src="/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582013.png" class="no-border" >}}
+    {{< figure src="/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582013.png" class="no-border" >}}
 
 11. In the **Add/Edit Field Mapping** window, select the attribute for the first entity for the **Primary data source field** and **Entity1_Entity2** for the **Secondary data source field**, then click **OK** to save the field mapping. In this case, select **ID** for the **Primary data source field** and **SmartTask_Engineer** for the **Secondary data source field**: 
 
-    {{< figure src="/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582011.png" class="no-border" >}}
+    {{< figure src="/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582011.png" class="no-border" >}}
 
 12. In the **Relationships** window, click **OK** to save the relationships:
 
-    {{< figure src="/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582007.png" class="no-border" >}}
+    {{< figure src="/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582007.png" class="no-border" >}}
 
 13. Select the second entity for the data source (in this case, **Engineers**) and drag the **Name** attribute from the **Dimensions** section to **Rows**:
 
-    {{< figure src="/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582006.png" class="no-border" >}}
+    {{< figure src="/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582006.png" class="no-border" >}}
 
 14. Select your first published entity (in this case, **SmartTasks**) for the data source and do the following:<br />
     1. Click the **SmartTask_Engineer** attribute to use it as the linking field.<br />
     2. Drag **Number of Records** from the **Measures** section to **Columns**.
 
-    {{< figure src="/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582005.png" class="no-border" >}}
+    {{< figure src="/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582005.png" class="no-border" >}}
 
 You should now see a bar chart of the data.
 
@@ -125,12 +128,12 @@ To filter data with query parameters, follow these steps:
 2. Click the OData URL to change the connection settings.
 3. Add `?$top=2` to the server URL (in order to only retrieve the first two values) and click **Sign In**:
 
-    {{< figure src="/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18581998.png" class="no-border" >}}
+    {{< figure src="/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18581998.png" class="no-border" >}}
 
 4. On the warning indicating that the data being used was refreshed, click **OK**.
 5. Open **Sheet1** and drag **Name** to **Rows** again. Now you should now see a bar chart with only the data of the two engineers:
 
-    {{< figure src="/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18581997.png" class="no-border" >}}
+    {{< figure src="/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18581997.png" class="no-border" >}}
 
 6. You can combine filters by using the `&` character. Repeat steps 1–4, but now use `http://localhost:8080/odata/Expenses/Expenses?$skip=1` as the server URL. You should now see a bar chart showing the data of  2 and 3.