Merge pull request #233703 from ShawnJackson/lifecycle-workflow-articles

[AQ] edit pass: Four lifecycle workflow articles

Author: ShannonLeavitt

articles/active-directory/governance/create-lifecycle-workflow.md

@@ -1,6 +1,6 @@
 ---
-title: Create a Lifecycle Workflow- Azure AD (preview)
-description: This article guides a user to creating a workflow using Lifecycle Workflows 
+title: Create a lifecycle workflow (preview) - Azure AD
+description: This article guides you in creating a lifecycle workflow. 
 author: OWinfreyATL
 ms.author: owinfrey
 manager: amycolannino
@@ -12,61 +12,68 @@ ms.subservice: compliance
 ms.custom: template-how-to 
 ---
 
-# Create a Lifecycle workflow (Preview)
-Lifecycle Workflows allows for tasks associated with the lifecycle process to be run automatically for users as they move through their life cycle in your organization. Workflows are made up of:
- - tasks - Actions taken when a workflow is triggered.
- - execution conditions - Define the who and when of a workflow. That is, who (scope) should this workflow run against, and when (trigger) should it run.
+# Create a lifecycle workflow (preview)
 
-Workflows can be created and customized for common scenarios using templates, or you can build a template from scratch without using a template. Currently if you use the Azure portal, a created workflow must be based off a template. If you wish to create a workflow without using a template, you must create it using Microsoft Graph.
+Lifecycle workflows (preview) allow for tasks associated with the lifecycle process to be run automatically for users as they move through their lifecycle in your organization. Workflows consist of:
+
+- **Tasks**: Actions taken when a workflow is triggered.
+- **Execution conditions**: The who and when of a workflow. These conditions define which users (scope) this workflow should run against, and when (trigger) the workflow should run.
+
+You can create and customize workflows for common scenarios by using templates, or you can build a workflow from scratch without using a template. Currently, if you use the Azure portal, any workflow that you create must be based on a template. If you want to create a workflow without using a template, use Microsoft Graph.
 
 ## Prerequisites
 
-The Lifecycle Workflows preview requires Azure AD Premium P2. For more information, see: [License requirements](what-are-lifecycle-workflows.md#license-requirements).
+The preview of lifecycle workflows requires Azure Active Directory (Azure AD) Premium P2. For more information, see [License requirements](what-are-lifecycle-workflows.md#license-requirements).
+
+## Create a lifecycle workflow by using a template in the Azure portal
 
-## Create a Lifecycle workflow using a template in the Azure portal
+If you're using the Azure portal to create a workflow, you can customize existing templates to meet your organization's needs. These templates include one for pre-hire common scenarios.
 
-If you are using the Azure portal to create a workflow, you can customize existing templates to meet your organization's needs. This means you can customize the pre-hire common scenario template. To create a workflow based on one of these templates using the Azure portal do the following steps:
+To create a workflow based on a template:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. Select **Azure Active Directory** and then select **Identity Governance**.
+1. Select **Azure Active Directory** > **Identity Governance**.
 
-1. In the left menu, select **Lifecycle Workflows (Preview)**.
+1. On the left menu, select **Lifecycle Workflows (Preview)**.
 
-1. select **Workflows (Preview)** 
+1. Select **Workflows (Preview)**.
 
-1. On the workflows screen, select the workflow template that you want to use. 
- :::image type="content" source="media/create-lifecycle-workflow/template-list.png" alt-text="Screenshot of a list of lifecycle workflows templates." lightbox="media/create-lifecycle-workflow/template-list.png":::
-1. Enter a unique display name and description for the workflow and select **Next**.
- :::image type="content" source="media/create-lifecycle-workflow/template-basics.png" alt-text="Screenshot of workflow template basic information.":::
+1. On the **Choose a workflow** page, select the workflow template that you want to use.
 
-1. On the **configure scope** page select the **Trigger type** and execution conditions to be used for this workflow. For more information on what can be configured, see: [Configure scope](understanding-lifecycle-workflows.md#configure-scope).
+    :::image type="content" source="media/create-lifecycle-workflow/template-list.png" alt-text="Screenshot of a list of lifecycle workflow templates." lightbox="media/create-lifecycle-workflow/template-list.png":::
+1. On the **Basics** tab, enter a unique display name and description for the workflow, and then select **Next**.
 
-1. Under rules, select the **Property**, **Operator**, and give it a **value**. The following picture gives an example of a rule being set up for a sales department. For a full list of user properties supported by Lifecycle Workflows, see [Supported user properties and query parameters](/graph/api/resources/identitygovernance-rulebasedsubjectset?view=graph-rest-beta&preserve-view=true#supported-user-properties-and-query-parameters)
+    :::image type="content" source="media/create-lifecycle-workflow/template-basics.png" alt-text="Screenshot of basic information about a workflow template.":::
 
-    :::image type="content" source="media/create-lifecycle-workflow/template-scope.png" alt-text="Screenshot of Lifecycle Workflows template scope configuration options.":::
+1. On the **Configure scope** tab, select the trigger type and execution conditions to be used for this workflow. For more information on what you can configure, see [Configure scope](understanding-lifecycle-workflows.md#configure-scope).
 
-1. To view your rule syntax, select the **View rule syntax** button. You can copy and paste multiple user property rules on this screen. For more detailed information on which properties that can be included see: [User Properties](/graph/aad-advanced-queries?tabs=http#user-properties). When you are finished adding rules, select **Next**.
-    :::image type="content" source="media/create-lifecycle-workflow/template-syntax.png" alt-text="Screenshot of workflow rule syntax.":::
+1. Under **Rule**, enter values for **Property**, **Operator**, and **Value**. The following screenshot gives an example of a rule being set up for a sales department. For a full list of user properties that lifecycle workflows support, see [Supported user properties and query parameters](/graph/api/resources/identitygovernance-rulebasedsubjectset?view=graph-rest-beta&preserve-view=true#supported-user-properties-and-query-parameters).
 
-1. On the **Review tasks** page you can add a task to the template by selecting **Add task**. To enable an existing task on the list, select **enable**. You're also able to disable a task by selecting **disable**. To remove a task from the template, select **Remove** on the selected task. When you are finished with tasks for your workflow, select **Next**.
+    :::image type="content" source="media/create-lifecycle-workflow/template-scope.png" alt-text="Screenshot of scope configuration options for a lifecycle workflow template.":::
 
-    :::image type="content" source="media/create-lifecycle-workflow/template-tasks.png" alt-text="Screenshot of adding tasks to templates.":::
+1. To view your rule syntax, select the **View rule syntax** button. You can copy and paste multiple user property rules on the panel that appears. For more information on which properties you can include, see [User properties](/graph/aad-advanced-queries?tabs=http#user-properties). When you finish adding rules, select **Next**.
 
-1. On the **Review+create** page you are able to review the workflow's settings. You can also choose whether or not to enable the schedule for the workflow. Select **Create** to create the workflow.
+    :::image type="content" source="media/create-lifecycle-workflow/template-syntax.png" alt-text="Screenshot of workflow rule syntax.":::
+
+1. On the **Review tasks** tab, you can add a task to the template by selecting **Add task**. To enable an existing task on the list, select **Enable**. To disable a task, select **Disable**. To remove a task from the template, select **Remove**.
 
-    :::image type="content" source="media/create-lifecycle-workflow/template-review.png" alt-text="Screenshot of reviewing and creating a template.":::
+    When you're finished with tasks for your workflow, select **Next: Review and create**.
+
+    :::image type="content" source="media/create-lifecycle-workflow/template-tasks.png" alt-text="Screenshot of adding tasks to templates.":::
 
+1. On the **Review and create** tab, review the workflow's settings. You can also choose whether or not to enable the schedule for the workflow. Select **Create** to create the workflow.
 
+    :::image type="content" source="media/create-lifecycle-workflow/template-review.png" alt-text="Screenshot of reviewing and creating a workflow.":::
 
 > [!IMPORTANT]
-> By default, a newly created workflow is disabled to allow for the testing of it first on smaller audiences. For more information about testing workflows before rolling them out to many users, see: [run an on-demand workflow](on-demand-workflow.md).
+> By default, a newly created workflow is disabled to allow for the testing of it first on smaller audiences. For more information about testing workflows before rolling them out to many users, see [Run an on-demand workflow](on-demand-workflow.md).
 
-## Create a workflow using Microsoft Graph
+## Create a lifecycle workflow by using Microsoft Graph
 
-To create a workflow using Microsoft Graph API, see [Create workflow (lifecycle workflow)](/graph/api/identitygovernance-lifecycleworkflowscontainer-post-workflows)
+To create a lifecycle workflow by using the Microsoft Graph API, see [Create workflow](/graph/api/identitygovernance-lifecycleworkflowscontainer-post-workflows).
 
 ## Next steps
 
 - [Manage a workflow's properties](manage-workflow-properties.md)
-- [Manage Workflow Versions](manage-workflow-tasks.md)
+- [Manage workflow versions](manage-workflow-tasks.md)

articles/active-directory/governance/delete-lifecycle-workflow.md

@@ -1,6 +1,6 @@
 ---
-title: 'Delete a Lifecycle workflow'
-description: Describes how to delete a Lifecycle Workflow using.
+title: Delete a lifecycle workflow
+description: Learn how to delete a lifecycle workflow.
 services: active-directory
 author: owinfreyATL
 manager: amycolannino
@@ -14,71 +14,68 @@ ms.reviewer: krbain
 ms.collection: M365-identity-device-management
 ---
 
-# Delete a Lifecycle workflow (Preview)
+# Delete a lifecycle workflow (preview)
 
-You can remove workflows that are no longer needed. Deleting these workflows allows you to make sure your lifecycle strategy is up to date. When a workflow is deleted, it enters a soft delete state. During this period, it's still able to be viewed within the deleted workflows list, and can be restored if needed. 30 days after a workflow enters a soft delete state it will be permanently removed. If you don't wish to wait 30 days for a workflow to permanently delete you can always manually delete it yourself.
+You can remove workflows that you no longer need. Deleting these workflows helps keep your lifecycle strategy up to date.
+
+When a workflow is deleted, it enters a soft-delete state. During this period, you can still view it in the list of deleted workflows and restore it if needed. A workflow is permanently removed 30 days after it  enters a soft-delete state. If you don't want to wait 30 days for a workflow to be permanently deleted, you can manually delete it.
 
 ## Prerequisites
 
-The Lifecycle Workflows preview requires Azure AD Premium P2. For more information, see: [License requirements](what-are-lifecycle-workflows.md#license-requirements).
+The preview of lifecycle workflows requires Azure Active Directory (Azure AD) Premium P2. For more information, see [License requirements](what-are-lifecycle-workflows.md#license-requirements).
 
-## Delete a workflow using the Azure portal
+## Delete a workflow by using the Azure portal
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. Type in **Identity Governance** on the search bar near the top of the page and select it.
-
-1. In the left menu, select **Lifecycle Workflows (Preview)**.
+1. On the search bar near the top of the page, enter **Identity Governance**. Then select **Identity Governance** in the results.
 
-1. select **Workflows (Preview)**.
+1. On the left menu, select **Lifecycle Workflows (Preview)**.
 
-1. On the workflows screen, select the workflow you want to delete.
+1. Select **Workflows (Preview)**.
 
-     :::image type="content" source="media/delete-lifecycle-workflow/delete-button.png" alt-text="Screenshot of list of Workflows to delete.":::
+1. On the **Workflows** page, select the workflow that you want to delete. Then select **Delete**.
 
-1. With the workflow highlighted, select **Delete**.
+    :::image type="content" source="media/delete-lifecycle-workflow/delete-button.png" alt-text="Screenshot of a list of workflows with one selected, along with the Delete button.":::
 
-1. Confirm you want to delete the selected workflow. 
- 
-     :::image type="content" source="media/delete-lifecycle-workflow/delete-workflow.png" alt-text="Screenshot of confirming to delete a workflow.":::
+1. Confirm that you want to delete the workflow by selecting the **Delete** button.
 
-## View deleted workflows
+    :::image type="content" source="media/delete-lifecycle-workflow/delete-workflow.png" alt-text="Screenshot of confirming the deletion of a workflow.":::
 
-After deleting workflows, you can view them on the **Deleted Workflows (Preview)** page.
+## View deleted workflows in the Azure portal
 
+After you delete workflows, you can view them on the **Deleted workflows** page.
 
-1. On the left of the screen, select **Deleted Workflows (Preview)**.
+1. On the left pane, select **Deleted workflows (Preview)**.
 
-1. On this page, you'll see a list of deleted workflows, a description of the workflow, what date it was deleted, and its permanent delete date. By default the permanent delete date for a workflow is always 30 days after it was originally deleted.
+1. On the **Deleted workflows** page, check the list of deleted workflows. Each workflow has a description, the date of deletion, and a permanent delete date. By default, the permanent delete date for a workflow is 30 days after it was originally deleted.
 
-     :::image type="content" source="media/delete-lifecycle-workflow/deleted-list.png" alt-text="Screenshot of a list of deleted workflows.":::
- 
-1. To restore a deleted workflow, select the workflow you want to restore and select **Restore workflow**.
+    :::image type="content" source="media/delete-lifecycle-workflow/deleted-list.png" alt-text="Screenshot of a list of deleted workflows.":::
 
-1. To permanently delete a workflow immediately, you select the workflow you want to delete from the list, and select **Delete permanently**.
+1. To restore a deleted workflow, select it and then select **Restore workflow**.
 
+   To permanently delete a workflow immediately, select it and then select **Delete permanently**.
 
- 
+## Delete a workflow by using Microsoft Graph
 
-## Delete a workflow using Microsoft Graph
+To delete a workflow by using an API via Microsoft Graph, see [Delete a lifecycle workflow](/graph/api/identitygovernance-workflow-delete?view=graph-rest-beta&preserve-view=true).
 
-To delete a workflow using API via Microsoft Graph, see: [Delete workflow (lifecycle workflow)](/graph/api/identitygovernance-workflow-delete?view=graph-rest-beta&preserve-view=true).
+## View deleted workflows by using Microsoft Graph
 
-## View deleted workflows using Microsoft Graph
+To view a list of deleted workflows by using an API via Microsoft Graph, see [List deleted workflows](/graph/api/identitygovernance-lifecycleworkflowscontainer-list-deleteditems).
 
-To View a list of deleted workflows using API via Microsoft Graph, see: [List deleted workflows](/graph/api/identitygovernance-lifecycleworkflowscontainer-list-deleteditems).
+## Permanently delete a workflow by using Microsoft Graph
 
-## Permanently delete a workflow using Microsoft Graph
+To permanently delete a workflow by using an API via Microsoft Graph, see [Permanently delete a deleted workflow](/graph/api/identitygovernance-deleteditemcontainer-delete).
 
-To permanently delete a workflow using API via Microsoft Graph, see: [Permanently delete a deleted workflow](/graph/api/identitygovernance-deleteditemcontainer-delete)
+## Restore a deleted workflow by using Microsoft Graph
 
-## Restore deleted workflows using Microsoft Graph
+To restore a deleted workflow by using an API via Microsoft Graph, see [Restore a deleted workflow](/graph/api/identitygovernance-workflow-restore).
 
-To restore a deleted workflow using API via Microsoft Graph, see: [Restore a deleted workflow](/graph/api/identitygovernance-workflow-restore)
 > [!NOTE]
-> Permanently deleted workflows are not able to be restored.
+> You can't restore permanently deleted workflows.
 
 ## Next steps
 
-- [What are Lifecycle Workflows?](what-are-lifecycle-workflows.md)
-- [Manage Lifecycle Workflow Versions](manage-workflow-tasks.md)
+- [What are lifecycle workflows?](what-are-lifecycle-workflows.md)
+- [Manage lifecycle workflow versions](manage-workflow-tasks.md)