Skip to content

Commit 01141d9

Browse files
committed
Updates
1 parent 6ea3d05 commit 01141d9

File tree

3 files changed

+31
-31
lines changed

3 files changed

+31
-31
lines changed

powerapps-docs/developer/common-data-service/TOC.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -409,7 +409,7 @@
409409
href: authenticate-office365-deprecation.md
410410
- name: "Tutorial: Register an app with Azure Active Directory"
411411
href: walkthrough-register-app-azure-active-directory.md
412-
- name: "Walkthrough: Create an ASP.NET Core Blazor WebAssembly App"
412+
- name: "Tutorial: Create an ASP.NET Core Blazor WebAssembly App"
413413
href: walkthrough-blazor-webassembly-single-tenant.md
414414
- name: Build web applications using Server-to-Server (S2S) authentication
415415
href: build-web-applications-server-server-s2s-authentication.md

powerapps-docs/developer/common-data-service/walkthrough-blazor-webassembly-single-tenant.md

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
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"
33
description: ""
44
keywords: ""
55
ms.date: 05/25/2020
@@ -16,28 +16,28 @@ search.app:
1616
- D365CE
1717
---
1818

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
2020

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.
2222

2323
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).
2424

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.
2626

2727
## Goal
2828

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.
3030

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.":::
3232

3333

3434
## Prerequisites
3535

36-
To complete this walkthrough you must have:
36+
To complete this tutorial, you must have:
3737

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.
4141
- Understanding of the C# programming language
4242
- Understanding of ASP.NET Core Blazor is helpful but not required
4343
- 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:
4747

4848
Let’s make sure that your environment is configured properly, and you understand where to perform the actions in Step 2.
4949

50-
### Verify CDS database
50+
### Verify Common Data Service database
5151

52-
1. Open https://make.powerapps.com/
52+
1. Sign in to [Power Apps](https://make.powerapps.com/).
5353
1. Select **Solutions** in the navigation pane.
5454

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.":::
5656

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.
5858

59-
### Get the CDS Web API URI
59+
### Get the Common Data Service Web API URI
6060

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.
6262

6363
Follow the instructions found in [View or download developer resources](view-download-developer-resources.md) to copy the Url.
6464

6565
It will look something like this: `https://yourorgname.api.crm.dynamics.com/api/data/v9.1/`
6666

6767
### Navigate to the Azure Active Directory portal
6868

69-
1. Return to https://make.powerapps.com/.
69+
1. Sign in to [Power Apps](https://make.powerapps.com).
7070
1. In the ‘waffle’ icon at the top left and select **Admin**.
7171

7272
:::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
152152

153153
## Step 3: Grant API permissions
154154

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.
156156

157157
1. Return to your app registration in AAD, In the **API permissions** section, click **Add a permission**.
158158

@@ -165,7 +165,7 @@ To connect to CDS, you must configure permissions for the app to connect.
165165
1. Select **Common Data Service**.
166166
1. Select the **user_impersonation** permission
167167

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.":::
169169

170170
> [!NOTE]
171171
> 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.
177177

178178
## Step 4: Apply code changes
179179

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.
181181

182182
### \wwwroot\appsettings.json
183183

@@ -193,7 +193,7 @@ You will find that this file already has configuration information generated by
193193
}
194194
```
195195

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.
197197

198198
> [!NOTE]
199199
> 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
245245
1. Add the following code below the line that starts with `builder.Configuration.Bind("AzureAd" ...`
246246

247247
```csharp
248-
// Add access to CDS to the scope of the access token when the user signs in
248+
// Add access to Common Data Service to the scope of the access token when the user signs in
249249
options.ProviderOptions.DefaultAccessTokenScopes.Add($"{resourceUrl}/user_impersonation");
250250
```
251251

@@ -462,7 +462,7 @@ This code does the following:
462462

463463
1. Ensures that only authenticated users can view the page with data.
464464
1. Defines a table to display Account data after it is retrieved.
465-
1. Requests an accesstoken and then uses that token with an HttpRequestMessage to retrieve data from CDS.
465+
1. Requests an accesstoken and then uses that token with an HttpRequestMessage to retrieve data from Common Data Service.
466466
1. Defines classes to enable strongly typed data when the JSON returned from the service is deserialized.
467467

468468
### \Shared\NavMenu.razor
@@ -484,7 +484,7 @@ Add this node where ever you like within the `<ul class="nav flex-column">` elem
484484
In Visual Studio, press F5 to launch the app with the code changes.
485485

486486
1. Before logging in, navigate to **Fetch Accounts**. You should expect to see the failure notification.
487-
1. Log-in as a user who has access to the CDS data.
487+
1. Log-in as a user who has access to the Common Data Service data.
488488

489489
> [!NOTE]
490490
> If you did not grant admin consent in [Step 3: Grant API permissions](#step-3-grant-api-permissions), users can expect to see a dialog like this:
@@ -500,6 +500,6 @@ In Visual Studio, press F5 to launch the app with the code changes.
500500
### See also
501501

502502
[Secure an ASP.NET Core Blazor WebAssembly standalone app with Azure Active Directory](/aspnet/core/security/blazor/webassembly/standalone-with-azure-active-directory)<br />
503-
[Walkthrough: Register an app with Azure Active Directory](walkthrough-register-app-azure-active-directory.md)<br />
503+
[Walkthrough: Register an app with Azure Active Directory](tutorial-register-app-azure-active-directory.md)<br />
504504
[Use OAuth with Common Data Service](authenticate-oauth.md)<br />
505505
[Use the Common Data Service Web API](webapi/overview.md)

powerapps-docs/developer/common-data-service/walkthrough-register-app-azure-active-directory.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
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."
44
keywords: ""
55
ms.date: 04/01/2019
66
ms.service: powerapps
@@ -17,9 +17,9 @@ search.app:
1717
- D365CE
1818
---
1919

20-
# Walkthrough: Register an app with Azure Active Directory
20+
# Tutorial: Register an app with Azure Active Directory
2121

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.
2323

2424
> [!IMPORTANT]
2525
> 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.
7878
## Additional configuration options
7979

8080
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)
8282

8383
If your application will support server-to-server connections, see [Use Multi-Tenant Server-to-server authentication](use-multi-tenant-server-server-authentication.md)
8484

0 commit comments

Comments
 (0)