diff --git a/content/en/docs/howto/integration/exposing-data-to-bi-tools-using-odata.md b/content/en/docs/refguide/modeling/integration/odata-services/exposing-data-to-bi-tools-using-odata.md similarity index 84% rename from content/en/docs/howto/integration/exposing-data-to-bi-tools-using-odata.md rename to content/en/docs/refguide/modeling/integration/odata-services/exposing-data-to-bi-tools-using-odata.md index 1314d56adea..7ffa5a7a869 100644 --- a/content/en/docs/howto/integration/exposing-data-to-bi-tools-using-odata.md +++ b/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,7 +68,7 @@ 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: @@ -73,7 +76,7 @@ To visualize data from your app in Tableau, follow these steps: 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.
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:
1. Click the **SmartTask_Engineer** attribute to use it as the linking field.
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. diff --git a/static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18581997.png b/static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18581997.png similarity index 100% rename from static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18581997.png rename to static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18581997.png diff --git a/static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18581998.png b/static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18581998.png similarity index 100% rename from static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18581998.png rename to static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18581998.png diff --git a/static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582005.png b/static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582005.png similarity index 100% rename from static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582005.png rename to static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582005.png diff --git a/static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582006.png b/static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582006.png similarity index 100% rename from static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582006.png rename to static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582006.png diff --git a/static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582007.png b/static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582007.png similarity index 100% rename from static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582007.png rename to static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582007.png diff --git a/static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582011.png b/static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582011.png similarity index 100% rename from static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582011.png rename to static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582011.png diff --git a/static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582012.png b/static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582012.png similarity index 100% rename from static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582012.png rename to static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582012.png diff --git a/static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582013.png b/static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582013.png similarity index 100% rename from static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582013.png rename to static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582013.png diff --git a/static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582020.png b/static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582020.png similarity index 100% rename from static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/18582020.png rename to static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/18582020.png diff --git a/static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/asset-manager-domain-model.png b/static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/asset-manager-domain-model.png similarity index 100% rename from static/attachments/howto/integration/exposing-data-to-bi-tools-using-odata/asset-manager-domain-model.png rename to static/attachments/refguide/modeling/integration/exposing-data-to-bi-tools-using-odata/asset-manager-domain-model.png