Skip to content

Commit cb30aad

Browse files
committed
edit pass: purview-how-to
1 parent 71546f4 commit cb30aad

File tree

2 files changed

+34
-29
lines changed

2 files changed

+34
-29
lines changed

articles/purview/how-to-workflow-self-service-data-access-hybrid.md

Lines changed: 33 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ ms.custom: template-how-to #Required; leave this attribute/value as-is.
1616

1717
You can use [workflows](concept-workflow.md) to automate some business processes through Microsoft Purview. Self-service access workflows allow you to create a process for your users to request access to datasets they've discovered in Microsoft Purview.
1818

19-
Let's say your team has a new data analyst who will do some business reporting. You add that data analyst to your department's collection in Microsoft Purview. From there, they can browse through the data assets and read descriptions about the data your department has available.
19+
Let's say your team has a new data analyst who will do some business reporting. You add that data analyst to your department's collection in Microsoft Purview. From there, they can browse through the data assets and read descriptions about the data that your department has available.
2020

2121
The data analyst notices that one of the Azure Data Lake Storage Gen2 accounts seems to have the exact data that they need to get started. Because a self-service access workflow has been set up for that resource, they can [request access](how-to-request-access.md) to that Azure Data Lake Storage account from within Microsoft Purview.
2222

@@ -33,30 +33,30 @@ This guide will show you how to create and manage self-service access workflows
3333

3434
1. Sign in to [the Microsoft Purview governance portal](https://web.purview.azure.com/resource/) and select the management center. Three new icons appear in the table of contents.
3535

36-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/workflow-section.png" alt-text="Screenshot that shows the management center left menu with the new workflow section highlighted.":::
36+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/workflow-section.png" alt-text="Screenshot that shows the management center menu with the new workflow section highlighted.":::
3737

3838
1. To create new workflows, select **Authoring**. This step takes you to the workflow authoring experience.
3939

40-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/workflow-authoring-experience.png" alt-text="Screenshot that shows the authoring workflows page and a list of all workflows.":::
40+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/workflow-authoring-experience.png" alt-text="Screenshot that shows the page for authoring workflows and a list of all workflows.":::
4141

4242
>[!NOTE]
4343
>If the **Authoring** tab is unavailable, you don't have the permissions to author workflows. You need the [workflow admin role](catalog-permissions.md).
4444
4545
1. To create a new self-service workflow, select the **+New** button.
4646

47-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/workflow-authoring-select-new.png" alt-text="Screenshot that shows the authoring workflows page, with the + New button highlighted.":::
47+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/workflow-authoring-select-new.png" alt-text="Screenshot that shows the page for authoring workflows, with the New button highlighted.":::
4848

4949
1. You're presented with categories of workflows that you can create in Microsoft Purview. To create an access request workflow, select **Governance**, and then select **Continue**.
5050

51-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/select-governance.png" alt-text="Screenshot that shows the new workflow window, with the Governance option selected.":::
51+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/select-governance.png" alt-text="Screenshot that shows the new workflow panel, with the Governance option selected.":::
5252

5353
1. The next screen shows all the templates that Microsoft Purview provides to create a self-service data access workflow. Select the **Data access request** template, and then select **Continue**.
5454

55-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/select-data-access-request.png" alt-text="Screenshot that shows the new workflow window, with the Data access request option selected.":::
55+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/select-data-access-request.png" alt-text="Screenshot that shows the new workflow panel, with the data access request template selected.":::
5656

5757
1. Enter workflow a name and optionally add a description. Then select **Continue**.
5858

59-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/name-and-continue.png" alt-text="Screenshot that shows the new workflow window, with a name entered in the textbox.":::
59+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/name-and-continue.png" alt-text="Screenshot that shows the name and description boxes for a new workflow.":::
6060

6161
1. You're presented with a canvas where the selected template is loaded by default.
6262

@@ -66,7 +66,7 @@ This guide will show you how to create and manage self-service access workflows
6666
1. Trigger when a data access request is made.
6767
1. Get an approval connector that specifies a user or group that will be contacted to approve the request.
6868

69-
Assign Data owners as approvers. Using the dynamic variable **Asset.Owner** as approvers in the approval connector will send approval requests to the data owners on the entity.
69+
Assign data owners as approvers. Using the dynamic variable **Asset.Owner** as approvers in the approval connector will send approval requests to the data owners on the entity.
7070

7171
>[!Note]
7272
> Because entities might not have the data owner field populated, using the **Asset.Owner** variable might result in errors if no data owner is found.
@@ -75,57 +75,62 @@ This guide will show you how to create and manage self-service access workflows
7575

7676
* If a data source is registered for [data use management](how-to-enable-data-use-governance.md) with the policy:
7777
1. Create a [self-service policy](concept-self-service-data-access-policy.md).
78-
1. Send email to the requestor that access is provided.
78+
1. Send email to the requestor that confirms access.
7979
* If a data source isn't registered with policy:
80-
1. Task a connector to assign [a task](how-to-workflow-manage-requests-approvals.md#tasks) to a user or an Azure Active Directory group to manually provide access to the requestor.
80+
1. Use a connector to assign [a task](how-to-workflow-manage-requests-approvals.md#tasks) to a user or an Azure Active Directory (Azure AD) group to manually provide access to the requestor.
8181
1. Send an email to requestor to explain that access is provided after the task is marked as complete.
8282

83-
If the condition to check approval status is rejected, send an email to requestor that the data access request is denied.
83+
If the condition to check approval status is rejected, send an email to the requestor to say that the data access request is denied.
8484

85-
1. The default template can be used as it is by populating two fields:
86-
* Adding an approver's email address or Microsoft Azure Active Directory group in **Start and Wait for approval** Connector
87-
* Adding a user's email address or Microsoft Azure Active Directory group in **Create task** connector to denote who is responsible for manually providing access if the source isn't registered with policy.
85+
1. You can use the default template as it is by populating two fields:
86+
* Add an approver's email address or Azure AD group in the **Start and wait for an approval** connector.
87+
* Add a user's email address or Azure AD group in the **Create task and wait for task completion** connector to denote who is responsible for manually providing access if the source isn't registered with the policy.
8888

89-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/required-fields-for-template-inline.png" alt-text="Screenshot that shows the workflow canvas with the start and wait for an approval step, and the Create Task and wait for task completion steps highlighted, and the Assigned to textboxes highlighted within those steps." lightbox="./media/how-to-workflow-self-service-data-access-hybrid/required-fields-for-template-expanded.png":::
89+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/required-fields-for-template-inline.png" alt-text="Screenshot that shows the workflow canvas with the connector for starting an approval and the connector for creating a task, along with the text boxes for assigning them." lightbox="./media/how-to-workflow-self-service-data-access-hybrid/required-fields-for-template-expanded.png":::
9090

9191
> [!NOTE]
92-
> Please configure the workflow to create self-service policies ONLY for sources supported by Microsoft Purview's policy feature. To see what's supported by policy, check the [Data owner policies documentation](tutorial-data-owner-policies-storage.md).
92+
> Configure the workflow to create self-service policies only for sources that the Microsoft Purview policy supports. To see what the policy supports, check the [documentation about data owner policies](tutorial-data-owner-policies-storage.md).
9393
>
94-
> If your source isn't supported by Microsoft Purview's policy feature, use the Task connector to assign [tasks](how-to-workflow-manage-requests-approvals.md#tasks) to users or groups that can provide access.
94+
> If the Microsoft Purview policy doesn't support your source, use the **Create task and wait for task completion** connector to assign [tasks](how-to-workflow-manage-requests-approvals.md#tasks) to users or groups that can provide access.
9595
96-
1. You can also modify the template by adding more connectors to suit your organizational needs.
96+
You can also modify the template by adding more connectors to suit your organizational needs.
9797

98-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/more-connectors-inline.png" alt-text="Screenshot that shows the workflow authoring canvas, with a + button highlighted on the arrow between the two top steps, and the Next Step button highlighted at the bottom of the workspace." lightbox="./media/how-to-workflow-self-service-data-access-hybrid/more-connectors-expanded.png":::
98+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/more-connectors-inline.png" alt-text="Screenshot that shows the workflow authoring canvas, with the button for adding a connector and the button for saving the new conditions." lightbox="./media/how-to-workflow-self-service-data-access-hybrid/more-connectors-expanded.png":::
9999

100-
1. Once you're done defining a workflow, you need to bind the workflow to a collection hierarchy path. The binding (or scoping) implies that this workflow is triggered only for data access requests in that collection. To bind a workflow or to apply a scope to a workflow, you need to select **Apply workflow**. Select the scope you want this workflow to be associated with and select **OK**.
100+
1. After you define a workflow, you need to bind the workflow to a collection hierarchy path. The binding (or scoping) implies that this workflow is triggered only for data access requests in that collection.
101+
102+
To bind a workflow or to apply a scope to a workflow, select **Apply workflow**. Select the scope that you want to associate with this workflow, and then select **OK**.
101103

102104
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/apply-workflow.png" alt-text="Screenshot that shows the workflow workspace with a list of items on the menu for applying a workflow.":::
103105

104106
>[!NOTE]
105-
> Purview workflow engine will always resolve to the closest workflow that the collection hierarchy path is associated with. In case a direct binding is not found, it will traverse up in the tree to find the workflow associated with the closest parent in the collection tree.
107+
> The Microsoft Purview workflow engine will always resolve to the closest workflow that the collection hierarchy path is associated with. If the workflow engine doesn't find a direct binding, it will look for the workflow that's associated with the closest parent in the collection tree.
106108
107-
1. By default, the workflow will be enabled. You can disable by selecting the Enable toggle.
108-
1. Finally select **Save and close** to create and enable the workflow.
109+
1. Make sure that the **Enable** toggle is on. The workflow should be enabled by default.
110+
1. Select **Save and close** to create and enable the workflow.
109111

110112
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/completed-workflows.png" alt-text="Screenshot that shows the workflow authoring page with the newly created workflow listed among the other workflows.":::
111113

112114
## Edit an existing workflow
113115

114-
To modify an existing workflow, select the workflow and then select the **Edit** button. You'll now be presented with the canvas containing workflow definition. Modify the workflow and select **Save** to commit changes.
116+
To modify an existing workflow, select the workflow and then select the **Edit** button. You're presented with the canvas that contains the workflow definition. Modify the workflow and select **Save** to commit the changes.
115117

116-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/select-edit.png" alt-text="Screenshot that shows the workflow authoring page, with the Edit button highlighted in the top menu.":::
118+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/select-edit.png" alt-text="Screenshot that shows the workflow authoring page, with the Edit button highlighted on the top menu.":::
117119

118120
## Disable a workflow
119121

120-
To disable a workflow, you can select the workflow and then select **Disable**. You can also disable the workflow by selecting **Edit** and changing the enable toggle in workflow canvas then saving.
122+
To disable a workflow, you can use either of these methods:
123+
124+
- Select the workflow, and then select **Disable**.
125+
- Select the workflow, select **Edit**, turn off the **Enable** toggle in the workflow canvas, and then select **Save and close**.
121126

122-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/select-disable.png" alt-text="Screenshot that shows the workflow authoring page, with the Disable button highlighted in the top menu.":::
127+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/select-disable.png" alt-text="Screenshot that shows the workflow authoring page, with the Disable button highlighted on the top menu.":::
123128

124129
## Delete a workflow
125130

126131
To delete a workflow, select the workflow and then select **Delete**.
127132

128-
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/select-delete.png" alt-text="Screenshot that shows the workflow authoring page, with the Delete button highlighted in the top menu.":::
133+
:::image type="content" source="./media/how-to-workflow-self-service-data-access-hybrid/select-delete.png" alt-text="Screenshot that shows the workflow authoring page, with the Delete button highlighted on the top menu.":::
129134

130135
## Next steps
131136

articles/purview/includes/feature-in-preview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,4 @@ ms.date: 01/31/2022
77
---
88

99
> [!IMPORTANT]
10-
> This feature is currently in PREVIEW. The [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) include additional legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
10+
> This feature is currently in preview. The [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) include additional legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability.

0 commit comments

Comments
 (0)