Skip to content

Commit edb11d2

Browse files
Merge pull request #28926 from MicrosoftDocs/main
[AutoPublish] main to live - 07/14 10:32 PDT | 07/14 23:02 IST
2 parents 1cada7e + 7031e3c commit edb11d2

16 files changed

Lines changed: 41 additions & 34 deletions

copilot/employee-self-service/customize.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,13 @@ Customization is how you make the Employee Self-Service (ESS) agent work in the
2626

2727
|Role |Activities to perform |Configuration area |
2828
|-----|----------------------|-------------------|
29-
|Environment Maker </br>Service owner of ESS agent |- Set up user context </br>- Customize ESS agent |Microsoft Copilot Studio |
29+
|Environment Maker </br>Owner of ESS agent |- Set up user context </br>- Customize ESS agent |Microsoft Copilot Studio |
3030
|ISV Administrators </br>Service owners of specific applications |Provide configuration inputs such as URLs, OAUTH tokens, and more |ISV configuration |
3131
|HR </br>IT </br>Legal </br>Privacy |-Identify knowledge sources </br>-Provide frequent queries </Identify sensitive queries> | N/A |
3232

3333
## Understanding components
3434

35-
Before continuing with configuring the ESS Agent, the service owner who will manage the ESS agent going forward must have a thorough understanding of its architecture.
35+
Before continuing with configuring the ESS Agent, the agent owner who will manage the ESS agent going forward must have a thorough understanding of its architecture.
3636
The ESS agent is built with the following components:
3737

3838
### Topics

copilot/employee-self-service/deploy-overview-alm.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ You need to work with your organization’s Power Platform administrator to esta
8080

8181
The ESS Agent has three distinct persona experiences:
8282

83-
1. Administrator: Prepare the tenant to deploy, configure, and operate the ESS agent with the correct roles assigned to identified service owners.
83+
1. Administrator: Prepare the tenant to deploy, configure, and operate the ESS agent with the correct roles assigned to identified administrators.
8484

8585
2. Environment maker: Install, configure, and publish the agent, including third-party ISV packages.
8686

copilot/employee-self-service/prepare.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Preparation is the first step to deploying the Employee Self-Service (ESS) agent
3636
1. Sign in as a Global admin to your [admin center](https://admin.microsoft.com).
3737
1. Select **Roles**, then choose **Role assignments**.
3838
1. In the **Microsoft Entra ID** section, find the **Power Platform Administrator** role.
39-
1. Add the users you've chosen as service owners for the ESS agent in the **Assigned** section.
39+
1. Add identified users in the **Assigned** section.
4040

4141
## Set up your Power Platform environment and assign the Environment Maker role
4242

@@ -48,7 +48,7 @@ Preparation is the first step to deploying the Employee Self-Service (ESS) agent
4848
1. Add a **Dataverse data store**.
4949
1. Under **Access**, select **Security roles**.
5050
1. From the list of security roles, select **Environment Maker**. Choose **Members** in the top ribbon.
51-
1. Select **Add people** in the ribbon to add the designated person who can configure and publish the ESS agent. This person is typically the service owner in your organization.
51+
1. Select **Add people** in the ribbon to add the designated person who can configure and publish the ESS agent. This person is typically the agent owner in your organization.
5252

5353
>[!NOTE]
5454
>Environment Makers can't install new agents. Only the environment administrators can install new agents.

copilot/employee-self-service/prerequisites.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@ The ESS Agent includes several different technical components and configuration
132132
|-----|------------|---------------------|-------------------|
133133
|Global admin |User who has permissions to configure and delegate other roles |Assign user roles |Microsoft admin center |
134134
|Power Platform administrator |User who has power to configure Power Platform environments and assign roles within Power Platform |- Create environments </br> - Assign user roles </br> - Install ESS agent |- Power Platform </br> - Microsoft Copilot Studio |
135-
|Power Platform maker |User who has permission to make changes in a specific Power Platform environment. It’s recommended to have the service owner for this agent perform this role. |Configure ESS agent |- Power Platform </br> - Microsoft Copilot Studio |
135+
|Power Platform maker |User who has permission to make changes in a specific Power Platform environment. It’s recommended to have the agent owner for this agent perform this role. |Configure ESS agent |- Power Platform </br> - Microsoft Copilot Studio |
136136
|ISV administrators |Users who manage third-party solutions |Provide configuration inputs for ISV applications |ISV application's administration and configuration interface |
137137
|Information security |Infrastructure team who manage and control enterprise application security policies |- Allowlist inbound requests for ISV endpoints </br> - Manage single sign-on configurations |- Network firewall policies </br> - Signle sign-on applications |
138138
|Change control board |Team that manages changes in an organization relating to deploying an enterprise application |- Approve technical architecture </br> - Approve data security, compliance, and governance policies </br> - Approve responsible AI polices |N/A |

copilot/employee-self-service/publish.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Publishing the Employee Self-Service (ESS) agent makes it available to your user
2626

2727
|Role |Activities to perform |Configuration area |
2828
|-----|----------------------|-------------------|
29-
|Environment Maker/ Service owner of the ESS agent |- Deploy customization solution to target environment</br> - Set up authentication</br> - Publish ESS agent |Microsoft Copilot Studio |
29+
|Environment Maker/ Owner of the ESS agent |- Deploy customization solution to target environment</br> - Set up authentication</br> - Publish ESS agent |Microsoft Copilot Studio |
3030
|Administrator |- Approve the ESS publish request</br> - Deploy it to selected users |Microsoft admin center |
3131
|Business stakeholders/ champions |Identify test users |N/A |
3232

copilot/employee-self-service/usage-analytics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ appliesto:
2424
2525
You can use different intefaces to monitor ESS agent usage depending on the role in your organization that is in charge of monitoring analytics.
2626

27-
As an application or service owner with the Environment Maker role, you can view analytics in Copilot Studio by navigating to the **Analytics** tab.
27+
As an application or agent owner with the Environment Maker role, you can view analytics in Copilot Studio by navigating to the **Analytics** tab.
2828

2929
For advanced reporting requirements, you can integrate Azure Application Insights with Copilot Studio to gather more telemetry.
3030

copilot/employee-self-service/workday.md

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -228,10 +228,8 @@ In this article, you learn how to set up the **Microsoft Entra ID Integrated** a
228228
When installing the Workday connector, the first step is to set up connections using the form. Fill out the following fields:
229229

230230
**Microsoft Entra resource URL (Application ID URI)**
231-
This is Microsoft Entra's app registration created for Workday SSO.
231+
This is Microsoft Entra's app registration created for Workday SSO. [Learn how to access app registrations](/entra/identity-platform/quickstart-register-app).
232232

233-
1. Sign into the [Azure portal](https://portal.azure.com)
234-
1. In the search bar, search for **App registrations**.
235233
1. Select **All applications**.
236234
1. Choose the correct application created for Workday SSO.
237235
1. In the **Overview** section, use the **Application ID URI** under the **Essentials** tab.
@@ -266,6 +264,9 @@ Workday report configuration provides the SOAP base URL.
266264
|ISUAccount |PP environment variable |EmployeeContextRequestAccountName |ISU_WQL_COPILOT@< domain >.com |
267265
|ReportName |PP environment variable |EmployeeContextRequestReportName |WD_User_Context |
268266

267+
>[!NOTE]
268+
>[If the ISUAccount name gets encoded in the report XML output, substitute %40 with @ character to make it a qualified UPN.]
269+
269270
>[!IMPORTANT]
270271
>If the custom report name is different from the default name (**WD_User_Context**), follow these steps:
271272
@@ -275,28 +276,34 @@ Workday report configuration provides the SOAP base URL.
275276
1. Select **Objects** > **Employee Self-Service Template Configuration** > **HRWorkdayHCMEmployeeGetContext**.
276277
1. Update the value with the correct name in the **Value** section.
277278

279+
>[!NOTE]
280+
>[The ESS agent uses a new Workday connector, which is not the same as the one published in the Power Platfrom connectors list (Workday HCM - Connectors). The current connector used in the agent is Workday SOAP. Plan for any DLP policies to allowlist this connector in the environment where the agent is being deployed and tested.]
281+
278282
#### Step four: Configure connections
279283

280284
During the Workday Extension Pack installation process, you'll be prompted for the following connection configurations:
281285

282-
|Connection reference name |Connection reference ID |Expected connection |
286+
|Connection reference name |Connection reference ID |Expected connection user account |
283287
|--------------------------|------------------------|--------------------|
284-
|OAuthUser |new_sharedworkdaysoap_ff0df |the signed-in user |
288+
|OAuthUser |new_sharedworkdaysoap_ff0df |Maker/the signed-in user |
285289
|Context Generic User |new_sharedworkdaysoap_d6081 |ISSG_WQL_COPILOT |
286290
|Generic User |new_sharedworkdaysoap_0786a |ISSG_Generic_COPILOT |
287291
|Microsoft Dataverse |msviess_sharedcommondataserviceforapps_92b66 |ISSG_WQL_COPILOT |
288292

293+
Note that all the above user accounts mentioned in the table under "Expected connection user account" should be available in Entra for SSO and use the respective accounts in UPN format (example: `[email protected]`). Ensure that each connection is explicitly set up with its own account even though the connection status turned green after the first connection setup.
294+
289295
#### Step five: Update the environment variables
290296

291297
1. After you install the Workday extension, select **Solutions** in the left navigation in Copilot Studio.
292298
1. A banner on the solutions page prompts you to fill in the environment variables.
293-
1. Update the following environment variables:
299+
1. Update the following environment variables. Refer to the following inputs from the **SOAP Base URL** section.
294300

295301
|Environment variable |Description |
296302
|---------------------|------------|
297-
|EmployeeContextRequestAccountName |Should contain the account that has access to the RaaS report. Reference from connection table: ISUAccount |
298-
|EmployeeContextRequestReportName |Should be the name of the report that contains the required information. Reference from connection table: Report Instance |
299303
|WorkdayWebsiteRedirectMessage |This is the message shown to users in success/failure scenarios for update email/phone number actions |
304+
|EmployeeContextRequestAccountName |Should contain the account that has access to the RaaS report. Reference from connection table: ISUAccount |
305+
|EmployeeContextRequestReportName |should be the name of the report that contains the required information reference from above connection table: ReportName |
306+
|EmployeeContextRequestReportInstanceName |should be the instance name that the report belongs to reference from above connection table: Report Instance |
300307

301308
#### Step 6: Confirm the Workday flows are turned on
302309

microsoft-365/admin/manage/assign-licenses-to-users.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ f1.keywords:
55
author: cmcatee-MSFT
66
ms.author: cmcatee
77
manager: scotv
8-
ms.reviewer: sinakassaw, nicholak
8+
ms.reviewer: nicholak
99
audience: Admin
1010
ms.topic: how-to
1111
ms.service: microsoft-365-business
@@ -32,7 +32,7 @@ ms.custom:
3232
- campaignIDs-batch1
3333
search.appverid: MET150
3434
description: "Learn how to assign or unassign licenses for your users in the Microsoft 365 admin center."
35-
ms.date: 04/07/2025
35+
ms.date: 07/08/2025
3636
---
3737

3838
# Assign or unassign licenses for users in the Microsoft 365 admin center

microsoft-365/admin/manage/manage-group-licenses.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ f1.keywords: NOCSH
44
author: cmcatee-MSFT
55
ms.author: cmcatee
66
manager: scotv
7-
ms.reviewer: sinakassaw, nicholak
7+
ms.reviewer: nicholak
88
audience: Admin
99
ms.topic: how-to
1010
ms.service: microsoft-365-business
@@ -21,7 +21,7 @@ ms.custom:
2121
- m365-groups
2222
search.appverid: MET150
2323
description: "Learn how to assign or unassign licenses to groups in the Microsoft 365 admin center."
24-
ms.date: 04/07/2025
24+
ms.date: 07/08/2025
2525
---
2626

2727
# Assign or unassign licenses to a group in the Microsoft 365 admin center

microsoft-365/admin/misc/add-partner.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ f1.keywords:
55
ms.author: cmcatee
66
author: cmcatee-MSFT
77
manager: scotv
8-
ms.reviewer: armanv, nicholak
8+
ms.reviewer: nicholak
99
audience: Admin
1010
ms.topic: how-to
1111
ms.service: microsoft-365-business
@@ -28,7 +28,7 @@ search.appverid:
2828
- MOE150
2929
- GEA150
3030
description: "Learn how to add a partner of record when you buy Microsoft 365, change the partner, or delete a partner from a subscription."
31-
ms.date: 01/07/2025
31+
ms.date: 07/08/2025
3232
---
3333

3434
# Add, change, or delete a subscription advisor partner

0 commit comments

Comments
 (0)