Business apps documentation

Adding the initial getting started docs flow along with business apps introduction.

Author: chakkaradeep

docs/business-apps/flow/get-started/connect-to-other-services-in-your-flow.md

@@ -0,0 +1,65 @@
+# Connect your flow to other services
+
+Connect your flow to 200+ services available in Microsoft Flow and build an integrated experience to perform actions in the services. This article continues building the *Projects* list flow built in the previous article *Create your first flow*.
+
+## Connect to Microsoft Teams
+
+In this article, we will connect to Microsoft Teams and post a message to one of the channels. 
+
+> While this article focusses on Microsoft Teams, you can connect to various other services as well in your flow. 
+
+### Edit the flow
+
+1. Switch to the flow designer tab in your browser.
+
+2. If you do not have the flow designer tab opened, then follow the steps to open the flow:
+    * Browse to the *Projects* list.
+    * Click on *Flow* and then *See your flows*.
+    * If promoted, sign in with your Office 365 account.
+    * Click on *Send an email for new projects* flow in the *My flows* tab.
+    * Click on *Edit flow* to edit the flow.
+
+3. Click on *+ New step* in the flow designer.
+
+4. Click on *Add an action*.
+
+5. This will open the actions list where you can search and browse for various actions available in Flow.
+
+6. In the search box, type *Teams* to search for Teams based actions.
+
+7. In the results, click on *Microsoft Teams* connector to filter the actions to just Teams.
+
+8. In the available actions list, click on *Microsoft Teams - Post message*.
+    > Click on the information icon to read more about the action and what it does.
+
+9. As soon as the action is added, Flow will try to create the Teams connection. Once the connection is created successfully, you should see the action with the available inputs.
+
+10. To see the connection information, click on the `...` button and check the *My connections* section to see the connection information the Teams action is using.
+
+11. Enter the inputs for the Teams action.
+    * Team Id: Pick a team from the picker.
+    * Channel Id: Pick a channel from the picker.
+
+12. In order to construct a message that includes the project information, we will need to interact with the dynamic conetent panel. In the *Message*, type the following in the same order as below:
+    * First type the text: *A new project *
+    * In the dynamic content list, search and pick the following property: *Title*
+    * Then type the text: * was added to the Projects list by *
+    * In the dynamic content list, search and pick the following property: *Created By DisplayName.*
+
+* Click *Save* on the command bar to save your flow.
+
+## Test your flow
+
+1. Click *Test* on the command bar.
+
+2. Click on Using data from previous runs*. Since* we already had previous runs of this flow in the previous article, we can select the same data for this flow run as well.
+
+3. Click on the flow run that says *Succeeded* and then click *Save & Test*.
+
+4. Flow will now run and you should see the status of each action updated successfully in the designer.
+
+5. As a result of this flow run, you should have received an email and a message should be posted on the selected Teams channel.
+
+## Next steps
+
+In the next topic, we will use the same flow and add ... .

docs/business-apps/flow/get-started/create-your first-flow.md

@@ -0,0 +1,115 @@
+# Send an email when a new item is created or modified in a SharePoint list
+
+Using Microsoft Flow you can easily automate day-to-day tasks or build repetetive tasks in SharePoint that help you stay productive.
+
+In this tutorial, you will create a flow that will send an email when a new item is added or modified in a SharePoint list.
+
+## Required setup
+
+Before following the steps in this artucle, make sure your SharePoint site is set up with the required lists and libraries.
+
+## Create a flow
+
+1. Browse to the *Projects* list in your SharePoint site.
+
+2. You can create and manage flows for a list or a library by clicking on the *Flow* button on the command bar on the list or library page.
+
+3. Clicking on the *Flow* button exapnds to show you more options:
+
+    * Create a flow
+    * See your flows
+
+    > **Note:** You may see other options as well such as 'Request sign-off' and other flows if they are available for the list or library here.
+
+4. Click on *Create a flow*.
+
+5. In the *Create a flow* panel, you can explore various templates available for your list.
+
+6. Click on the template that reads:
+    > Send a customized email when a new SharePoint list item is added.
+
+7. This will take you to the Flow website where it will display more options:
+    * Template information
+        * Name and description of the template.
+    * Connection information
+        * Varioius services this flow connect to.
+        * The credentials those services will use to connect to.
+8. Verify the connection information to ensure it uses your credentials.
+    > A green checkmark icon indicates a connection to the service was succesfully made using your credentials.
+
+9. Click *Continue* to create the flow. Any connections that requires a connection will also be attempted during this step.
+
+10. Once the flow is created successfully, you will be redirected to the flow designer where you can edit and modifify the flow if needed.
+
+11. Click on the name of the flow that reads *Send a customized email when a new SharePoint list item is added* and enter the following name for the flow:
+    * Send an email for new projects
+
+12. The SharePoint actions are represented with the SharePoint logo in the flow designer.
+
+13. In the *When the new item is created* action, click on *Edit* to expand the action.
+
+14. Notice the input configured to the SharePoint site address and list name fromk where you created the flow.
+
+15. In the *Send Email* action, click on *Edit* to expand the action.
+
+16. Notice all the input is filled in with dynamic values from the *Get my profile* and *When the new item is created* actions.
+
+17. Hover over the dynamic values to see what properties they refer. For example, hovering over the *Email* shows that the property is read from the *Get my profile*'s *Mail* property.
+
+18. Click *Save* to save the flow.
+
+Your flow is active as soon as you save the flow. In our case, this flow *Send an email for new projects* is now active and will run whenever new items are added to the *Projects* list in the specified SharePoint site.
+
+## Test your flow
+
+In order to test your flow, you can test it by adding a new item in SharePoint list by adding a new item or initiating the test run directly from the flow designer. Follow the steps below to test the flow from the designer. Testing the flow from the designer helps you to quickly see the flow run as the flow is executed.
+
+1. In the flow designer, click on *Test* on the top command bar.
+
+2. In the *Test Flow* panel, click on *I'll perform the trigger action* and then click on *Save & Test* button.
+
+3. You should see a message that instructs to add a new list item to the SharePoint list you selected.
+
+4. You should have the browser tab with the *Projects* list opened already. If not, open a new browser tab and browse to the *Projects* list.
+    > Do not close the flow designer. Make sure you keep the flow designer browser tab open.
+
+5. In the *Projects* list, click on the *New* button on the command bar, add the item as specified below and click *Save*:
+    * Title: Project 4
+    * Owner: pick a user from people picker
+
+6. Switch to the flow designer tab.
+
+7. You should see the flow run history. If all of the actions were executed successfully, you will a green checkmark icon besides every action.
+
+8. You can also click on the action to see the inputs and outputs used in the flow run. This is also a good place to see the actual values translated from those dynamic content properties used in that action.
+
+9. As a result of this flow, you should have received an email as well regarding the new project information.
+
+## Modify your flow
+
+1. In the flow designer, click *Edit* to edit your flow.
+
+2. Click on the *Send Email* action.
+
+3. In the *Body* input, append the following string after the *Name* dynamic property:
+    * Owner:
+
+4. While you are still editing the *Body* input, notice the *dynamic content* list that appears beside the action.
+
+5. In the *dynamic content* list, you can pick values from the actions in your flow. For example: The project owner information is available in the *When the new item is created* trigger.
+
+6. To add the owner information, search for *owner* in the search box in the *dynamic content* list.
+
+7. In the results, click on *Owner DisplayName*. As you can see, it also displays other information such as email, job title, picture and more. Since the *Owner* is a person column in SharePoint, SharePoint passes along the person details as individual properties to the flow.
+
+8. The modified *Body* input should now look like this with the included *Owner* information.
+
+9. Repeat the steps to test the flow.
+
+10. You should now get an email with the updated owner information in it.
+
+## Next steps
+
+Congratulations on creating your first flow!
+
+In the next topic, we will use the same flow and add the ability to interact with Microsoft Teams.

docs/business-apps/flow/get-started/set-up-sharepoint-site.md

@@ -0,0 +1,43 @@
+# Set up your SharePoint site with lists and libraries
+
+In order to successfully complete the getting started tutorials, set up your SharePoint site with the following.
+
+## Projects list
+
+Create a new SharePoint list called *Projects*. Follow the steps below to create a new SharePoint list.
+
+### Create a new list
+
+1. Browse to your SharePoint site.
+2. In the command bar, click on *New->List*
+3. In the *Create list* panel, enter the following and click *Create* to create the list:
+
+    * **Name:** Projects
+    * **Description:** Projects list.
+4. You will be automatically redirected to the *Projects* list.
+5. Click on *+ Add column* and then select *Person* column type to add an Onwer column to the list.
+6. In the *Create a column* panel, enter the following and click *Save* to add the column to the Projects list:
+
+    * **Name:** Owner
+    * **Description:** Project owner.
+7. The new *Owner* column will now be available in the Projects list.
+
+### Add new project items
+
+Click on *New* button in the command bar and add the following list items:
+
+* Item 1
+  * **Title:** Project 1
+  * **Owner:** pick a user from people picker
+
+* Item 2
+  * **Title:** Project 2
+  * **Owner:** pick a user from people picker
+
+* Item 3
+  * **Title:** Project 3
+  * **Owner:** pick a user from people picker
+
+## Next steps
+
+Now that you have set up your site with the lists and libraries, you can get started working with flows by creating your first flow.

docs/business-apps/introduction-to-sharepoint-business-process-integration.md

@@ -0,0 +1,38 @@
+# SharePoint custom forms and automated business workflow
+
+Creativity and teamwork are essential to transforming business process. Most processes center on content – files and data. SharePoint gives you tools to gather and manage data in lists and libraries.  
+
+Office 365 provides connections to a range of third-party systems with Microsoft Flow and PowerApps. Flow lets you easily automate business processes and PowerApps lets you create great forms and mobile apps based on SharePoint files and data. Both PowerApps and Flow feature intuitive visual designers, so anyone can craft forms and screens in an easy-to-use interface.
+
+## Microsoft Flow
+
+Using Microsoft Flow, you can create workflows through an easy-to-use visual designer that will guide you through each step and help authenticate your accounts.
+
+Select from dozens of pre-made templates also available in Flow to start automating your app’s usage. Here are just a few applications of these templates:
+
+* Create a new record in Dynamics CRM when a new list item is added to a SharePoint list.
+* Copy new members from MailChimp lists to SharePoint lists.
+* Move files to different folders after they’re approved in SharePoint.
+* Create a new item in SharePoint when a new order is added in Salesforce.
+* Route finished documents to a team for approval
+
+Whether you start with a template or begin from scratch, using Flow to create automation features is intuitive and easy to understand.
+
+Cross-tool functionality seamlessly moves your data from one operation to another. Since SharePoint is a core piece of the Office 365 suite,your data easily integrates with tools like Excel or Power BI reporting. And since it uses an Excelinspired expression language, these tools talk with each other, using formula language you already recognize and understand to integrate your data from one function to the next.
+
+## Microsoft PowerApps
+
+Using Microsoft PowerApps, you can create apps with a point-and-click approach to app design. You can use the option to use automatically generated pre-made templates or customize the tool to fit your more specific needs. Then, once your app is complete, you can instantly publish it to Windows, the web, iOS, and Android.  
+
+Classic mobile and web apps typically required separate coding for each platform, which can be costly and time-consuming to do—especially since programmers are currently in high demand. Instead, PowerApps simplifies the process so anyone can do it. Its easy-to-use, browser-based visual designer helps you rapidly build custom business apps without having to write any code.
+
+By connecting PowerApps to your existing systems and data, you can quickly build reports, forms, and workflows, then publish your app instantly to all users in your organization.
+
+PowerApps also allows you to easily customize the form for a SharePoint list. With custom forms, you can, for example:
+
+* Show or hide certain fields
+* Re-organize those fields
+* Change the layout of the form
+* Add formatted text and graphics
+
+When you publish your changes, the form is embedded within the SharePoint list for use by all of its users.