Merge pull request #15699 from ecfan/art-fix

Fix art and steps

Author: v-shils

articles/logic-apps/logic-apps-use-logic-app-features.md

@@ -1,5 +1,5 @@
 ---
-title: Add conditional logic and start workflows - Azure Logic Apps | Microsoft Docs
+title: Add conditions and start workflows - Azure Logic Apps | Microsoft Docs
 description: Control how workflows run in Azure Logic Apps by adding conditional logic, triggers, actions, and parameters.
 author: stepsic-microsoft-com
 manager: anneta
@@ -18,54 +18,86 @@ ms.author: LADocs; stepsic
 
 ---
 # Use Logic Apps features
-In the [previous topic](../logic-apps/logic-apps-create-a-logic-app.md), 
-you created your first logic app. 
-Now you'll build a fuller process with Azure Logic Apps. 
-This topic introduces the following new Azure Logic Apps concepts:
 
-* Conditional logic, which executes an action only when a certain condition is met.
-* Code view to edit an existing logic app.
-* Options for starting a workflow.
+In a [previous topic](../logic-apps/logic-apps-create-a-logic-app.md), 
+you created your first logic app. To control your logic app's workflow, 
+you can specify different paths for your logic app to run and how to 
+process data in arrays, collections, and batches. You can include these 
+elements in your logic app workflow:
 
-Before you complete this topic, you should complete the steps in [Create a new logic app](../logic-apps/logic-apps-create-a-logic-app.md). In the [Azure portal], browse to your logic app and click **Triggers and Actions** in the summary to edit the logic app definition.
+* Conditions and [switch statements](../logic-apps/logic-apps-switch-case.md) 
+let your logic app run different actions based on whether specific conditions are met.
 
-## Reference material
-You may find the following documents useful:
+* [Loops](../logic-apps/logic-apps-loops-and-scopes.md) let your logic app run steps repeatedly. 
+For example, you can repeat actions over an array when you use a **For_each** loop. 
+Or you can repeat actions until a condition is met when you use an **Until** loop.
 
-* [Management and runtime REST APIs](https://msdn.microsoft.com/library/azure/mt643787.aspx) - including how to invoke Logic apps directly
-* [Language reference](https://msdn.microsoft.com/library/azure/mt643789.aspx) - a comprehensive list of all supported functions/expressions
-* [Trigger and action types](https://msdn.microsoft.com/library/azure/mt643939.aspx) - the different types of actions and the inputs they take
-* [Overview of App Service](../app-service/app-service-value-prop-what-is.md) - description of what components to choose when to build a solution
+* [Scopes](../logic-apps/logic-apps-loops-and-scopes.md) let you group series 
+of actions together, for example, to implement exception handling.
 
-## Add conditional logic to your logic app
+* [Debatching](../logic-apps/logic-apps-loops-and-scopes.md) lets your logic app 
+start separate workflows for items in an array when you use the **SplitOn** command.
 
-Although your logic app's original flow works, we could improve some areas.
+This topic introduces other concepts for building your logic app:
 
-### Conditional
+* Code view to edit an existing logic app
+* Options for starting a workflow
 
-Your first logic app might result in you getting too many emails. 
-The following steps add conditional logic so that you receive email 
-only when the tweet comes from someone with a specific number of followers.
+## Conditions: Run steps only after meeting a condition
 
-0. In the Logic App Designer, choose **New Step** (+) > **Add an action**.
-0.	Find and add the **Get User** action for Twitter.
-0. To get the information about the Twitter user, 
-find and add the **Tweeted by** field from the trigger.
+To have your logic app run steps only when data meets specific criteria, 
+you can add a condition that compares data in the workflow against specific fields or values.
 
-	![Get user](media/logic-apps-use-logic-app-features/getuser.png)
+For example, suppose you have a logic app that sends you too many emails 
+for posts on a website's RSS feed. You can add a condition so that your 
+logic app sends email only when the new post belongs to a specific category.
 
-0. Choose **New Step** (+) > **Add a condition**.
-0. To filter on the number of followers that users have, 
-under **Object name**, choose **Add dynamic content**. 
-0.	In the search box, find and add the **Followers count** field.
-0. Under **Relationship**, select **is greater than**.
-0. In the **Value** box, enter the number of followers you want users to have.
+1. In the [Azure portal](https://portal.azure.com), 
+find and open your logic app in Logic App Designer.
 
-	![Conditional](media/logic-apps-use-logic-app-features/conditional.png)
+2. Add a condition to the workflow location that you want. 
 
-0. Finally, drag the **Send email** box into the **If Yes** box. 
+   To add the condition between existing steps in the logic app workflow, 
+   move the pointer over the arrow where you want to add the condition. 
+   Choose the **plus sign** (**+**), then choose **Add a condition**. For example:
 
-Now you get emails only when the follower count meets your condition.
+   ![Add condition to logic app](./media/logic-apps-use-logic-app-features/add-condition.png)
+
+   > [!NOTE]
+   > If you want to add a condition at the end of your current workflow, 
+   > go to the bottom of your logic app, and choose **+ New step**.
+
+3. Now define the condition. Specify the source field that you want to evaluate, 
+the operation to perform, and the target value or field. 
+To add existing fields to your condition, choose from the **Add dynamic content list**.
+
+   For example:
+
+   ![Edit condition in basic mode](./media/logic-apps-use-logic-app-features/edit-condition-basic-mode.png)
+
+   Here's the complete condition:
+
+   ![Complete condition](./media/logic-apps-use-logic-app-features/edit-condition-basic-mode-2.png)
+
+   > [!TIP]
+   > To define the condition in code, choose **Edit in advanced mode**. 
+   > For example:
+   > 
+   > ![Edit condition in code](./media/logic-apps-use-logic-app-features/edit-condition-advanced-mode.png)
+
+4. Under **IF YES** and **IF NO**, add the steps to perform based 
+on whether the condition is met.
+
+   For example:
+
+   ![Condition with YES and NO paths](./media/logic-apps-use-logic-app-features/condition-yes-no-path.png)
+
+   > [!TIP]
+   > You can drag existing actions into the **IF YES** and **IF NO** paths.
+
+5. When you're done, save your logic app.
+
+Now you get emails only when the posts meet your condition.
 
 ## Repeat actions over a list with forEach
 
@@ -94,7 +126,7 @@ you can directly edit the code that defines a logic app.
 
 2. To save your edits, choose **Save**.
 
-### Parameters
+## Parameters
 
 Some Logic Apps capabilities are available only in code view, 
 for example, parameters. Parameters make it easy to reuse 
@@ -103,35 +135,34 @@ an email address that you want use in several actions,
 you should define that email address as a parameter.
 
 Parameters are good for pulling out values that you are likely to change a lot. 
-They are especially useful when you need to override parameters in different environments. 
-To learn how to override parameters based on environment, 
-see the [REST API documentation](https://docs.microsoft.com/rest/api/logic).
+They are especially useful when you need to override parameters in different environments. To learn how to override parameters based on environment, 
+see [Author logic app definitions](../logic-apps/logic-apps-author-definitions.md) and [REST API documentation](https://docs.microsoft.com/rest/api/logic).
 
 This example shows how to update your existing logic app 
 so that you can use parameters for the query term.
 
 1. In code view, find the `parameters : {}` object, 
-and add a topic object:
+and add a `currentFeedUrl` object:
 
-		"topic" : {
+		"currentFeedUrl" : {
 			"type" : "string",
-			"defaultValue" : "MicrosoftAzure"
+			"defaultValue" : "http://rss.cnn.com/rss/cnn_topstories.rss"
 		}
 
-2. Go to the `twitterconnector` action, find the query value, 
-and replace that value with `#@{parameters('topic')}`. 
+2. Go to the `When_a_feed-item_is_published` action, 
+find the `queries` section, and replace the query value with 
+: `"feedUrl": "#@{parameters('currentFeedUrl')}"` 
 
 	To join two or more strings, you can also use the `concat` function. 
-	For example, 	`@concat('#',parameters('topic'))` works the same as the above.
+	For example, `"@concat('#',parameters('currentFeedUrl'))"` 
+	works the same as the above.
 
 3.	When you're done, choose **Save**. 
 
-	Now every hour, you get new tweets 
-	that have more than five retweets 
-	delivered to a folder called **tweets** in your Dropbox.
+	Now you can change the website's RSS feed by 
+	passing a different URL through the `currentFeedURL` object.
 
-To learn more about Logic App definitions, see 
-[author Logic App definitions](../logic-apps/logic-apps-author-definitions.md).
+Learn more about [how to author logic app definitions](../logic-apps/logic-apps-author-definitions.md).
 
 ## Start logic app workflows
 
@@ -157,3 +188,9 @@ See [Start workflows by calling logic app endpoints as triggers](../logic-apps/l
 
 <!-- Shared links -->
 [Azure portal]: https://portal.azure.com
+
+## Next steps
+
+* [Switch statements](../logic-apps/logic-apps-switch-case.md) 
+* [Loops, scopes, and debatching](../logic-apps/logic-apps-loops-and-scopes.md)
+* [Author logic app definitions](../logic-apps/logic-apps-author-definitions.md)