Skip to content

Commit 988ec6e

Browse files
committed
Updated configure insights document and bps document list ordering
1 parent 179902c commit 988ec6e

3 files changed

Lines changed: 43 additions & 73 deletions

File tree

articles/sap/business-process-solutions/configure-insights.md

Lines changed: 39 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -11,53 +11,21 @@ ms.author: momakhij
1111

1212
# Configure insights in Business Process Solutions
1313

14-
Insights in Business Process Solutions are analytics templates, such as Power BI reports and semantic models, designed to help you quickly start analyzing your data. You can explore available templates on the Business Templates page.
14+
Insights in Business Process Solutions are [Business Templates](business-templates.md), such as Power BI reports and semantic models, designed to help you quickly start analyzing your data. You can explore available templates on the [Business Templates](business-templates.md) page.
1515
This article explains how to configure Insights and establish connections to refresh reports and models.
1616

17-
## Import Lakehouse Views
18-
19-
Some Insights require additional transformations delivered through SQL views on top of the lakehouse. To deploy these views, run the provided notebook from your workspace:
20-
21-
1. Navigate to your workspace.
22-
2. Open the notebook **bps_gold_view_creation**.
23-
:::image type="content" source="./media/configure-insights/gold-view-notebook.png" alt-text="Screenshot showing how to open the bps_gold_view_creation notebook." lightbox="./media/configure-insights/gold-view-notebook.png":::
24-
3. Click on the **Run All** button.
25-
:::image type="content" source="./media/configure-insights/run-gold-view-notebook.png" alt-text="Screenshot showing how to run the bps_gold_view_creation notebook." lightbox="./media/configure-insights/run-gold-view-notebook.png":::
26-
4. Once the notebook run is finished, you should see the sql views in your gold lakehouse.
27-
2817
## Deploy Power BI Report
2918

30-
To deploy a new Power BI report or Semantic model, use the onboarding wizard. On the overview page, select either the **Get Started** button or the **+ New Insight** button to open the wizard.
19+
To deploy a new Power BI report or Semantic model, use the onboarding wizard. On the overview page, select the **+ New Insight** button to open the wizard.
3120
:::image type="content" source="./media/configure-insights/overview-wizard-buttons.png" alt-text="Screenshot showing the Get Started and New Insight buttons on the overview page." lightbox="./media/configure-insights/overview-wizard-buttons.png":::
3221

3322
The wizard guides you through four steps: **Set up insight**, **Set up connections**, **Set up dataset**, and **Review and deploy**.
3423

3524
### Step 1: Set up insight
3625

37-
In this step, you configure the source system and select the insight to deploy. The wizard opens to the **Set up Business Process Solution insight** page.
38-
39-
Under **Source system**, you can select an existing source system or create a new source system to see available insights.
40-
:::image type="content" source="./media/configure-insights/wizard-source-system-options.png" alt-text="Screenshot showing the source system options with Create new and Select existing." lightbox="./media/configure-insights/wizard-source-system-options.png":::
26+
In this step, you select the source system and the insight to deploy. The wizard opens to the **Set up Business Process Solution insight** page.
4127

42-
#### Create new
43-
44-
If you don't have an existing source system, or want to create a new one:
45-
46-
1. Select **Create new** under **Source system**.
47-
:::image type="content" source="./media/configure-insights/wizard-create-new-selected.png" alt-text="Screenshot showing the Create new option selected under source system." lightbox="./media/configure-insights/wizard-create-new-selected.png":::
48-
2. Under **Source system type**, select the card for your system: **SAP S/4HANA**, **SAP ECC**, or **Salesforce**.
49-
:::image type="content" source="./media/configure-insights/wizard-source-system-type-cards.png" alt-text="Screenshot showing the source system type cards for SAP S/4HANA, SAP ECC, and Salesforce." lightbox="./media/configure-insights/wizard-source-system-type-cards.png":::
50-
3. Under **Source system name**, enter a name for the source system and select the **System version** from the dropdown.
51-
:::image type="content" source="./media/configure-insights/wizard-create-new-name-version.png" alt-text="Screenshot showing the source system name field and system version dropdown." lightbox="./media/configure-insights/wizard-create-new-name-version.png":::
52-
4. Under **Select insight**, the available insights for the selected source system type are displayed as cards, grouped by **Area** (for example, Record to Report, Order to Cash, Procure to Pay). You can change the grouping using the **Group by** dropdown, or use the **Search insights** box to filter. Each card shows the insight name, type (Report or Semantic Model), and a preview. **Select** the insight you want to deploy.
53-
:::image type="content" source="./media/configure-insights/wizard-create-new-insight-cards.png" alt-text="Screenshot showing the available insight cards grouped by area for a new source system." lightbox="./media/configure-insights/wizard-create-new-insight-cards.png":::
54-
5. Under **Define insight**, the **Insight name** is autopopulated. If an error message appears to indicate the name already exists, update the name to a unique value.
55-
:::image type="content" source="./media/configure-insights/wizard-create-new-define-insight.png" alt-text="Screenshot showing the Define insight section with the autopopulated insight name." lightbox="./media/configure-insights/wizard-create-new-define-insight.png":::
56-
6. Select **Next** to proceed with the Set up connections page.
57-
58-
#### Select existing
59-
60-
If at least one source system already exists in the Business Process Solutions item:
28+
Under **Source system**, select an existing source system. If you don't have a source system yet, see [Create a new source system](#create-a-new-source-system).
6129

6230
1. Select **Select existing** under **Source system**.
6331
:::image type="content" source="./media/configure-insights/wizard-select-existing-selected.png" alt-text="Screenshot showing the Select existing option selected under source system." lightbox="./media/configure-insights/wizard-select-existing-selected.png":::
@@ -71,52 +39,27 @@ If at least one source system already exists in the Business Process Solutions i
7139

7240
### Step 2: Set up connections
7341

74-
The **Set up connections** page displays the connection configuration for the selected source system. The page shows the **Source system name** and a **Data extraction setting** section where you choose how to extract data from the system.
75-
:::image type="content" source="./media/configure-insights/wizard-connections-page.png" alt-text="Screenshot showing the Set-up connections page with source system name and data extraction settings." lightbox="./media/configure-insights/wizard-connections-page.png":::
42+
For an existing source system, this page shows a read-only summary of the connection configuration. No action is required. Select **Next** to proceed.
7643

77-
For an existing succeeded source system, the connection details are shown as read-only. No action is required. Select **Next** to proceed.
7844
:::image type="content" source="./media/configure-insights/wizard-connections-readonly.png" alt-text="Screenshot showing the read-only connection details for a succeeded source system." lightbox="./media/configure-insights/wizard-connections-readonly.png":::
7945

80-
For a new source system, the available connection types depend on the source system type:
81-
82-
- **SAP S/4HANA**: Choose between **Azure Data Factory** and **Open Mirroring**.
83-
- **SAP ECC**: **Open Mirroring** is the available connection type.
84-
- **Salesforce**: **Fabric** is the available connection type.
85-
86-
Select a **Connection type** and fill in the required fields.
87-
88-
##### Azure Data Factory
89-
90-
If you select **Azure Data Factory** as the connection type, provide Azure resource details and SAP system connection information. For detailed prerequisites and field descriptions, see [Configure a source system with Azure Data Factory](configure-source-system-with-data-factory.md).
46+
If you're configuring a new source system, you need to set up the connection on this page. For detailed prerequisites and field descriptions, see the following articles:
9147

92-
:::image type="content" source="./media/configure-insights/wizard-connection.png" alt-text="Screenshot showing the Azure Data Factory connection setup with Azure resources and system connection fields." lightbox="./media/configure-insights/wizard-connection.png":::
93-
94-
##### Open Mirroring
95-
96-
If you select **Open Mirroring** as the connection type, provide the mirroring partner and Fabric SQL database connection details. For detailed prerequisites and field descriptions, see [Configure a source system with Open Mirroring](configure-source-system-with-open-mirroring.md).
97-
98-
:::image type="content" source="./media/configure-insights/wizard-connection-om.png" alt-text="Screenshot showing the Open Mirroring connection setup with partner name and Fabric SQL database connection ID." lightbox="./media/configure-insights/wizard-connection-om.png":::
99-
100-
##### Fabric
101-
102-
If you select **Fabric** as the connection type (available for Salesforce), provide the Salesforce and Fabric SQL connection details. For detailed prerequisites and field descriptions, see [Configure a Salesforce source system](configure-salesforce-source-system.md).
103-
104-
:::image type="content" source="./media/configure-insights/wizard-connection-sf.png" alt-text="Screenshot showing the Fabric connection setup for Salesforce." lightbox="./media/configure-insights/wizard-connection-sf.png":::
48+
- [Configure a source system with Azure Data Factory](configure-source-system-with-data-factory.md)
49+
- [Configure a source system with Open Mirroring](configure-source-system-with-open-mirroring.md)
50+
- [Configure a Salesforce source system](configure-salesforce-source-system.md)
10551

10652
Select **Next** to proceed.
10753

10854
### Step 3: Set up dataset
10955

110-
The **Set up dataset** page shows the **Dataset template** that is activated based on the insight you chose. The template details include:
56+
Datasets are collections of objects used to extract data from the business application. Business Process Solutions automatically selects and activates the relevant dataset based on the chosen insight. In this step, you can review the basic details, including the list of objects to be extracted and transformed.
11157

112-
- **Template name** and **Version**
113-
- **Supported systems**
114-
- **Power BI** availability status
115-
- A **Show details** link for more information about the selected dataset, like description and tables.
58+
To learn more about editing a dataset, adding custom objects, and maintaining relationships, see [Manage Datasets](manage-datasets.md#modify-dataset-tables-and-relationships).
11659

11760
:::image type="content" source="./media/configure-insights/wizard-dataset-template.png" alt-text="Screenshot showing the dataset template details including name, version, and supported systems." lightbox="./media/configure-insights/wizard-dataset-template.png":::
11861

119-
Under **Name Dataset**, a **Dataset name** is autopopulated based on the insight and source system. If the name already exists for the source system, update it to a unique name before proceeding.
62+
In the Name Dataset step, the system suggests a dataset name derived from the selected insight and source system.
12063
:::image type="content" source="./media/configure-insights/wizard-dataset-name.png" alt-text="Screenshot showing the dataset name field autopopulated based on insight and source system." lightbox="./media/configure-insights/wizard-dataset-name.png":::
12164

12265
Select **Next** to proceed.
@@ -139,6 +82,22 @@ Once the deployment completes, you can see the report in your workspace and in t
13982
> [!NOTE]
14083
> Power BI Report deployment automatically deploys the semantic model. You don't need to deploy the semantic model separately.
14184
85+
## Create a new source system
86+
87+
If you don't have an existing source system, or want to create a new one, you can do so during the insight setup wizard:
88+
89+
1. Select **Create new** under **Source system**.
90+
:::image type="content" source="./media/configure-insights/wizard-create-new-selected.png" alt-text="Screenshot showing the Create new option selected under source system." lightbox="./media/configure-insights/wizard-create-new-selected.png":::
91+
2. Under **Source system type**, select the card for your system: **SAP S/4HANA**, **SAP ECC**, or **Salesforce**.
92+
:::image type="content" source="./media/configure-insights/wizard-source-system-type-cards.png" alt-text="Screenshot showing the source system type cards for SAP S/4HANA, SAP ECC, and Salesforce." lightbox="./media/configure-insights/wizard-source-system-type-cards.png":::
93+
3. Under **Source system name**, enter a name for the source system and select the **System version** from the dropdown.
94+
:::image type="content" source="./media/configure-insights/wizard-create-new-name-version.png" alt-text="Screenshot showing the source system name field and system version dropdown." lightbox="./media/configure-insights/wizard-create-new-name-version.png":::
95+
4. Under **Select insight**, the available insights for the selected source system type are displayed as cards, grouped by **Area** (for example, Record to Report, Order to Cash, Procure to Pay). You can change the grouping using the **Group by** dropdown, or use the **Search insights** box to filter. Each card shows the insight name, type (Report or Semantic Model), and a preview. **Select** the insight you want to deploy.
96+
:::image type="content" source="./media/configure-insights/wizard-create-new-insight-cards.png" alt-text="Screenshot showing the available insight cards grouped by area for a new source system." lightbox="./media/configure-insights/wizard-create-new-insight-cards.png":::
97+
5. Under **Define insight**, the **Insight name** is autopopulated. If an error message appears to indicate the name already exists, update the name to a unique value.
98+
:::image type="content" source="./media/configure-insights/wizard-create-new-define-insight.png" alt-text="Screenshot showing the Define insight section with the autopopulated insight name." lightbox="./media/configure-insights/wizard-create-new-define-insight.png":::
99+
6. Select **Next** to proceed with the Set up connections page.
100+
142101
## Connection for Semantic Model Refreshes
143102

144103
To refresh the semantic model, we need to set up a connection in fabric, else we won't be able to automatically refresh the reports via pipelines. To set up the connection, follow the steps:
@@ -153,6 +112,17 @@ To refresh the semantic model, we need to set up a connection in fabric, else we
153112
:::image type="content" source="./media/configure-insights/associate-connection.png" alt-text="Screenshot showing how to associate a connection to the semantic model." lightbox="./media/configure-insights/associate-connection.png":::
154113
6. Once done, try to refresh the semantic model and check if it completes successfully.
155114

115+
## Import Lakehouse Views
116+
117+
Some Insights require additional transformations delivered through SQL views on top of the lakehouse. To deploy these views, run the provided notebook from your workspace:
118+
119+
1. Navigate to your workspace.
120+
2. Open the notebook **bps_gold_view_creation**.
121+
:::image type="content" source="./media/configure-insights/gold-view-notebook.png" alt-text="Screenshot showing how to open the bps_gold_view_creation notebook." lightbox="./media/configure-insights/gold-view-notebook.png":::
122+
3. Click on the **Run All** button.
123+
:::image type="content" source="./media/configure-insights/run-gold-view-notebook.png" alt-text="Screenshot showing how to run the bps_gold_view_creation notebook." lightbox="./media/configure-insights/run-gold-view-notebook.png":::
124+
4. Once the notebook run is finished, you should see the sql views in your gold lakehouse.
125+
156126
## Summary
157127

158128
In this article, we described the steps required to configure Insights in Business Process Solutions. You learned how to deploy lakehouse views, Power BI reports, and semantic models, and how to set up connections for refreshing reports and models. Now you can start exploring the reports and models to gain insights from your data.

articles/sap/business-process-solutions/configure-dataset.md renamed to articles/sap/business-process-solutions/manage-datasets.md

File renamed without changes.

articles/sap/business-process-solutions/toc.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,12 +17,12 @@ items:
1717
href: configure-source-system-with-open-mirroring.md
1818
- name: Configure Salesforce source system
1919
href: configure-salesforce-source-system.md
20-
- name: Configure dataset
21-
href: configure-dataset.md
22-
- name: Run extraction and data processing
23-
href: run-extraction-data-processing.md
2420
- name: Configure insights
2521
href: configure-insights.md
22+
- name: Run extraction and data processing
23+
href: run-extraction-data-processing.md
24+
- name: Manage datasets
25+
href: manage-datasets.md
2626
- name: Attestation Document
2727
href: attestation.md
2828
- name: Troubleshooting common issues

0 commit comments

Comments
 (0)