You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: powerapps-docs/developer/common-data-service/walkthrough-blazor-webassembly-single-tenant.md
+25-25Lines changed: 25 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: "Walkthrough: Create an ASP.NET Core Blazor WebAssembly App using Common Data Service | Microsoft Docs"
2
+
title: "Tutorial: Create an ASP.NET Core Blazor WebAssembly App using Common Data Service | Microsoft Docs"
3
3
description: ""
4
4
keywords: ""
5
5
ms.date: 05/25/2020
@@ -16,28 +16,28 @@ search.app:
16
16
- D365CE
17
17
---
18
18
19
-
# Walkthrough: Create an ASP.NET Core Blazor WebAssembly App using Common Data Service
19
+
# Tutorial: Create an ASP.NET Core Blazor WebAssembly App using Common Data Service
20
20
21
-
Use the steps in this walkthrough to create a Blazor WebAssembly app that connects to the Common Data Service (CDS). The focus of this topic is to understand the necessary steps to authenticate a user with a specific CDS instance and retrieve data.
21
+
Use the steps in this tutorial to create a Blazor WebAssembly app that connects to the Common Data Service. The focus of this topic is to understand the necessary steps to authenticate a user with a specific Common Data Service instance and retrieve data.
22
22
23
23
Blazor WebAssembly is one of two hosting models available for ASP.NET Core Blazor, the other is Blazor Server. For a complete description of the differences, see [ASP.NET Core Blazor hosting models](/aspnet/core/blazor/hosting-models).
24
24
25
-
This walkthrough depends on the instructions in the [Secure an ASP.NET Core Blazor WebAssembly standalone app with Azure Active Directory](/aspnet/core/security/blazor/webassembly/standalone-with-azure-active-directory) topic. Because CDS uses Azure Active Directory (AAD) for authentication, this walkthrough will describe how to modify the basic app created using the app template provided so that it can connect to CDS.
25
+
This tutorial depends on the instructions in the [Secure an ASP.NET Core Blazor WebAssembly standalone app with Azure Active Directory](/aspnet/core/security/blazor/webassembly/standalone-with-azure-active-directory) topic. Because Common Data Service uses Azure Active Directory (AAD) for authentication, this tutorial will describe how to modify the basic app created using the app template provided so that it can connect to Common Data Service.
26
26
27
27
## Goal
28
28
29
-
When you complete this walkthrough, you will have a Blazor WebAssembly app that displays data from the CDS Account entity which the authenticated user has access to.
29
+
When you complete this tutorial, you will have a Blazor WebAssembly app that displays data from the Common Data Service Account entity that the authenticated user has access to.
30
30
31
-
:::image type="content" source="media/blazor-webassembly-walkthrough-goal.png" alt-text="Represents the goal of this walkthrough.":::
31
+
:::image type="content" source="media/blazor-webassembly-walkthrough-goal.png" alt-text="Represents the goal of this tutorial.":::
32
32
33
33
34
34
## Prerequisites
35
35
36
-
To complete this walkthrough you must have:
36
+
To complete this tutorial, you must have:
37
37
38
-
- Access to a Power Apps environment with a CDS database
39
-
- A CDS user with a security role that provides read access to the Account and Contact entities
40
-
- Application Administrator, Application Developer, Cloud Application Administrator, or Hybrid Identity Administrator role access to the AAD tenant that the CDS environment uses.
38
+
- Access to a [Common Data Service environment with a database](https://docs.microsoft.com/power-platform/admin/create-environment#create-an-environment-with-a-database)
39
+
- A Common Data Service user with a security role that provides read access to the Account and Contact entities
40
+
- Application Administrator, Application Developer, Cloud Application Administrator, or Hybrid Identity Administrator role access to the AAD tenant that the Common Data Service environment uses.
41
41
- Understanding of the C# programming language
42
42
- Understanding of ASP.NET Core Blazor is helpful but not required
43
43
- The latest version of Visual Studio 2019 with the **ASP.NET and web development** workload installed.
@@ -47,26 +47,26 @@ To complete this walkthrough you must have:
47
47
48
48
Let’s make sure that your environment is configured properly, and you understand where to perform the actions in Step 2.
49
49
50
-
### Verify CDS database
50
+
### Verify Common Data Service database
51
51
52
-
1.Open https://make.powerapps.com/
52
+
1.Sign in to [Power Apps](https://make.powerapps.com/).
53
53
1. Select **Solutions** in the navigation pane.
54
54
55
-
:::image type="content" source="media/blazor-webassembly-walkthrough-maker-portal.png" alt-text="The maker portal showing an environment without a CDS database.":::
55
+
:::image type="content" source="media/blazor-webassembly-walkthrough-maker-portal.png" alt-text="The maker portal showing an environment without a Common Data Service database.":::
56
56
57
-
1. If you don’t see a list of installed solutions, use the environment selector at the top to choose a different environment which has a database. Otherwise create a new environment.
57
+
1. If you don’t see a list of installed solutions, use the environment selector at the top to choose a different environment that has a database. Otherwise create a new environment.
58
58
59
-
### Get the CDS Web API URI
59
+
### Get the Common Data Service Web API URI
60
60
61
-
You will need the Instance Web API Service Root URL. This is found on the Developer Resources page of your CDS environment.
61
+
You will need the Instance Web API Service Root URL. This is found on the Developer Resources page of your Common Data Service environment.
62
62
63
63
Follow the instructions found in [View or download developer resources](view-download-developer-resources.md) to copy the Url.
64
64
65
65
It will look something like this: `https://yourorgname.api.crm.dynamics.com/api/data/v9.1/`
66
66
67
67
### Navigate to the Azure Active Directory portal
68
68
69
-
1.Return to https://make.powerapps.com/.
69
+
1.Sign in to [Power Apps](https://make.powerapps.com).
70
70
1. In the ‘waffle’ icon at the top left and select **Admin**.
71
71
72
72
:::image type="content" source="media/blazor-webassembly-walkthrough-navigate-admin-center.png" alt-text="Navigating to the Microsoft 365 admin center.":::
@@ -152,7 +152,7 @@ At this point, all the capabilities of the app work whether you log-in or not. O
152
152
153
153
## Step 3: Grant API permissions
154
154
155
-
To connect to CDS, you must configure permissions for the app to connect.
155
+
To connect to Common Data Service, you must configure permissions for the app to connect.
156
156
157
157
1. Return to your app registration in AAD, In the **API permissions** section, click **Add a permission**.
158
158
@@ -165,7 +165,7 @@ To connect to CDS, you must configure permissions for the app to connect.
165
165
1. Select **Common Data Service**.
166
166
1. Select the **user_impersonation** permission
167
167
168
-
:::image type="content" source="media/blazor-webassembly-walkthrough-user-impersonation-permission.png" alt-text="Adding the CDS user_impersonation permission.":::
168
+
:::image type="content" source="media/blazor-webassembly-walkthrough-user-impersonation-permission.png" alt-text="Adding the Common Data Service user_impersonation permission.":::
169
169
170
170
> [!NOTE]
171
171
> Dynamics CRM and Common Data Service refer to the same service.
@@ -177,7 +177,7 @@ To connect to CDS, you must configure permissions for the app to connect.
177
177
178
178
## Step 4: Apply code changes
179
179
180
-
Apply changes to the following files to enable displaying CDS data in the application.
180
+
Apply changes to the following files to enable displaying Common Data Service data in the application.
181
181
182
182
### \wwwroot\appsettings.json
183
183
@@ -193,7 +193,7 @@ You will find that this file already has configuration information generated by
193
193
}
194
194
```
195
195
196
-
Update the file to include a new `CDSWebAPI` section that includes the root of the **Instance Web API Service Root URL** you copied in the [Get the CDS Web API URI](#get-the-cds-web-api-uri) step.
196
+
Update the file to include a new `CDSWebAPI` section that includes the root of the **Instance Web API Service Root URL** you copied in the [Get the Common Data Service Web API URI](#get-the-cds-web-api-uri) step.
197
197
198
198
> [!NOTE]
199
199
> You don’t need the full URL, just the root.
@@ -245,7 +245,7 @@ Update the file to include a new `CDSWebAPI` section that includes the root of t
Copy file name to clipboardExpand all lines: powerapps-docs/developer/common-data-service/walkthrough-register-app-azure-active-directory.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: "Walkthrough: Register an app with Azure Active Directory (Common Data Service) | Microsoft Docs"
3
-
description: "This walkthrough describes how to register an application with Azure Active Directory so that it can connect to the Common Data Service environment, authenticate using OAuth, and access the web services."
2
+
title: "Tutorial: Register an app with Azure Active Directory (Common Data Service) | Microsoft Docs"
3
+
description: "This tutorial describes how to register an application with Azure Active Directory so that it can connect to the Common Data Service environment, authenticate using OAuth, and access the web services."
4
4
keywords: ""
5
5
ms.date: 04/01/2019
6
6
ms.service: powerapps
@@ -17,9 +17,9 @@ search.app:
17
17
- D365CE
18
18
---
19
19
20
-
# Walkthrough: Register an app with Azure Active Directory
20
+
# Tutorial: Register an app with Azure Active Directory
21
21
22
-
This walkthrough describes how to register an application with Azure Active Directory, which enables a user with Power Apps user account to connect to their Common Data Service environment from external client applications using OAuth authentication.
22
+
This tutorial describes how to register an application with Azure Active Directory, which enables a user with Power Apps user account to connect to their Common Data Service environment from external client applications using OAuth authentication.
23
23
24
24
> [!IMPORTANT]
25
25
> Power Apps also provides you with Server-to-Server (S2S) authentication option to connect to Common Data Service environment from external applications and services using the special application user account. S2S authentication is the common way that apps registered on Microsoft AppSource use to access the data of their subscribers. More information: [Build web applications using Server-to-Server (S2S) authentication](build-web-applications-server-server-s2s-authentication.md).
@@ -78,7 +78,7 @@ This completes the registration of your application in Azure Active Directory.
78
78
## Additional configuration options
79
79
80
80
If your application will be a Single Page Application (SPA) that depends on CORS you must configure the app registration to support the implicit flow.
81
-
More information: [Walkthrough: Registering and configuring a SPA application with adal.js](walkthrough-registering-configuring-simplespa-application-adal-js.md)
81
+
More information: [Tutorial: Registering and configuring a SPA application with adal.js](walkthrough-registering-configuring-simplespa-application-adal-js.md)
82
82
83
83
If your application will support server-to-server connections, see [Use Multi-Tenant Server-to-server authentication](use-multi-tenant-server-server-authentication.md)
0 commit comments