Skip to content

Commit 30455ea

Browse files
cid109cid109
authored
Add files via upload
1 parent e1c94ee commit 30455ea

File tree

2 files changed

+626
-0
lines changed

2 files changed

+626
-0
lines changed

‎powerapps-docs/maker/canvas-apps/expense-report-install.md

Lines changed: 359 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,359 @@
1+
---
2+
title: Install and configure the Expense Report PowerApps sample | Microsoft Docs
3+
description: Step-by-step instructions for installing and configuring the Expense Report PowerApps sample.
4+
services: ''
5+
suite: powerapps
6+
documentationcenter: na
7+
author: tbag
8+
manager: ''
9+
editor: ''
10+
tags: ''
11+
12+
ms.service: powerapps
13+
ms.devlang: na
14+
ms.topic: article
15+
ms.tgt_pltfrm: na
16+
ms.workload: na
17+
ms.date: 02/20/2018
18+
ms.author: v-tobagi
19+
20+
---
21+
# Install and Configure the Expense Report PowerApps Sample
22+
23+
Step-by-step instructions for installing and configuring the Expense Report PowerApps sample.
24+
25+
Estimated time to complete these steps: **10-15 minutes**
26+
27+
## Expense Report PowerApps sample overview
28+
Track expense reports from submission to approval. Tally line items as individual expenses accrue and submit for approval when ready. This app requires a small amount of setup to make it your own.
29+
30+
![Opening screen of the Expense Report PowerApp](./media/expense-report-install/expense-report-powerapp.png)
31+
32+
## Prerequisites
33+
34+
1. [Sign up](signup-for-powerapps.md) for PowerApps
35+
36+
## Create the Expenses SharePoint list
37+
38+
This list stores the expense reports.
39+
40+
1. Open a web browser and navigate to https://portal.office.com
41+
2. Log in with an account that has permission to create lists
42+
3. Navigate to the site collection where you want the Expenses list to reside
43+
4. Click the **gear icon** in the top right portion of the web page
44+
5. Click **Add an app**
45+
6. In the **Find an app** textbox, enter **Custom**
46+
7. Click the **search icon**
47+
8. Click the **Custom List** app
48+
9. In the **Name** textbox, enter **Expenses**
49+
50+
**Important:** If you choose a different name for the list make sure you write it down because you will need to substitute it for Expenses everywhere you see it during the installation and configuration process.
51+
52+
10. Click **Create**
53+
54+
### Create CostCenter column
55+
56+
1. Click the **Expenses** list
57+
2. Click the **gear icon** in the top right portion of the web page
58+
3. Click **List settings**
59+
4. Click **Create column**
60+
5. In the **Column name** textbox enter **CostCenter**
61+
6. In the **type of information in this column is** radio button list, select **Choice**
62+
7. In the **Type each choice on a separate line** textbox enter the following values, each on a separate line.
63+
Microsoft
64+
Canviz
65+
8. In the **Default value** textbox, enter **Microsoft**
66+
9. Click **OK**
67+
68+
### Create Comments column
69+
70+
1. Click **Create column**
71+
2. In the **Column name** textbox enter **Comments**
72+
3. In the **type of information in this column is** radio button list, select **Multiple lines of text**
73+
4. Click **OK**
74+
75+
### Create Status column
76+
77+
1. Click the **Expenses** list
78+
2. Click the **gear icon** in the top right portion of the web page
79+
3. Click **List settings**
80+
4. Click **Create column**
81+
5. In the **Column name** textbox enter **Status**
82+
6. In the **type of information in this column is** radio button list, select **Choice**
83+
7. In the **Type each choice on a separate line** textbox enter the following values, each on a separate line.
84+
Open
85+
Pending
86+
Approved
87+
8. In the **Default value** textbox, enter **Open**
88+
9. Click **OK**
89+
90+
### Create ApproverName column
91+
92+
1. Click **Create column**
93+
2. In the **Column name** textbox enter **ApproverName**
94+
3. In the **type of information in this column is** radio button list, select **Person or Group**
95+
4. In the **Require that this column contains information** radio button list, select **Yes**
96+
5. Click **OK**
97+
98+
### Create DateSubmitted column
99+
100+
1. Click **Create column**
101+
2. In the **Column name** textbox enter **DateSubmitted**
102+
3. In the **type of information in this column is** radio button list, select **Date and Time**
103+
4. In the **Require that this column contains information** radio button list, select **Yes**
104+
5. Click **OK**
105+
106+
### Create StartDate column
107+
108+
1. Click **Create column**
109+
2. In the **Column name** textbox enter **StartDate**
110+
3. In the **type of information in this column is** radio button list, select **Date and Time**
111+
4. In the **Require that this column contains information** radio button list, select **Yes**
112+
5. Click **OK**
113+
114+
### Create EndDate column
115+
116+
1. Click **Create column**
117+
2. In the **Column name** textbox enter **EndDate**
118+
3. In the **type of information in this column is** radio button list, select **Date and Time**
119+
4. In the **Require that this column contains information** radio button list, select **Yes**
120+
5. Click **OK**
121+
122+
## Create the Line Items SharePoint list
123+
124+
This list stores the lines items associated with expense reports.
125+
126+
1. Navigate to the same site collection where you created the Expense list
127+
2. Click the **gear icon** in the top right portion of the web page
128+
3. Click **Add an app**
129+
4. In the **Find an app** textbox, enter **Custom**
130+
5. Click the **search icon**
131+
6. Click the **Custom List** app
132+
7. In the **Name** textbox, enter **LineItems**
133+
134+
**Important:** If you choose a different name for the list make sure you write it down because you will need to substitute it for Expense everywhere you see it during the installation and configuration process.
135+
136+
8. Click **Create**
137+
138+
### Create Category column
139+
140+
1. Click the **LineItems** list
141+
2. Click the **gear icon** in the top right portion of the web page
142+
3. Click **List settings**
143+
4. Click **Create column**
144+
5. In the **Column name** textbox enter **Category**
145+
6. In the **type of information in this column is** radio button list, select **Choice**
146+
7. In the **Type each choice on a separate line** textbox enter the following values, each on a separate line.
147+
Food & Beverage
148+
Transportation
149+
Business needs
150+
8. In the **Default value** textbox, enter **Food & Beverage**
151+
9. Click **OK**
152+
153+
### Create Cost column
154+
155+
1. Click **Create column**
156+
2. In the **Column name** textbox enter **Cost**
157+
3. In the **type of information in this column is** radio button list, select **Number (1, 10, 100)**
158+
4. In the **Require that this column contains information** radio button list, select **Yes**
159+
5. Click **OK**
160+
161+
### Create Date column
162+
163+
1. Click **Create column**
164+
2. In the **Column name** textbox enter **Date**
165+
3. In the **type of information in this column is** radio button list, select **Date and Time**
166+
4. In the **Require that this column contains information** radio button list, select **Yes**
167+
5. Click **OK**
168+
169+
### Create Description column
170+
171+
1. Click **Create column**
172+
2. In the **Column name** textbox enter **Description**
173+
3. In the **type of information in this column is** radio button list, select **Multiple lines of text**
174+
4. In the **Require that this column contains information** radio button list, select **Yes**
175+
5. In the **Specify the type of text to allow** radio button list, select **Plain text**
176+
6. Click **OK**
177+
178+
### Create ReportID column
179+
180+
1. Click **Create column**
181+
2. In the **Column name** textbox enter **ReportID**
182+
3. In the **type of information in this column is** radio button list, select **Lookup (information already on this site)**
183+
4. In the **Require that this column contains information** radio button list, select **Yes**
184+
5. In the **Get information from** dropdown list, select the **Expense** list you created
185+
6. In the **In this column** dropdown list, select **ID**
186+
7. Click **OK**
187+
188+
### Edit Title column
189+
190+
1. Click the **Title** column link
191+
2. In the **Require that this column contains information** radio button list, select **No**
192+
3. Click **OK**
193+
194+
## Download the Expense Report PowerApp
195+
196+
1. In a web browser, navigate to the following link
197+
198+
http://pappsfeprodwestuscontent.blob.core.windows.net/sampleapps/myexpenses/docs/MyExpenses(SP_List).zip
199+
200+
2. Download the Expense Report PowerApps Sample package and save it to your machine
201+
202+
## Create Connections
203+
204+
1. In a web browser, navigate to https://web.powerapps.com
205+
2. Sign in by providing the same credentials that you used to sign up
206+
3. In the menu on the left, select **Connections**
207+
208+
### Create Approvals Connection
209+
210+
1. Click **+ New connection**
211+
2. In the **Search** textbox, enter **Approvals**
212+
3. Select **Approvals** in the list
213+
4. Click **Create**
214+
215+
### Create Office 365 Outlook Connection
216+
217+
1. Click **+ New connection**
218+
2. In the **Search** textbox, enter **Office 365 Outlook**
219+
3. Select **Office 365 Outlook** in the list
220+
4. Click **Create**
221+
5. In the popup window, select the account you logged in with
222+
223+
### Create SharePoint Connection
224+
225+
1. Click **+ New connection**
226+
2. In the **Search** textbox, enter **Outlook**
227+
3. Select **SharePoint** in the list
228+
4. Click **Create**
229+
5. In the popup window, select the account you logged in with
230+
231+
## Import the Expense Report PowerApp
232+
233+
1. In a web browser, navigate to https://web.powerapps.com
234+
2. Sign in by providing the same credentials that you used to sign up
235+
3. In the menu on the left, select **Apps**
236+
4. Click **Import package(preview)**
237+
238+
![Import package screen](./media/expense-report-install/import-package.png)
239+
240+
5. Click the **Upload** button and select the PowerApp package you downloaded in previous steps
241+
6. For the **App** and **Flow** resource types, set **IMPORT SETUP** to **Create as new**
242+
7. For the **SharePoint** and **Outlook** connections, set **IMPORT SETUP** to **Select during import**
243+
244+
![Import settings screen](./media/expense-report-install/import-settings.png)
245+
246+
8. Click the **red icon** for the **SharePoint Connection**
247+
9. In the connections list, click the item with your username
248+
![Import settings screen](./media/expense-report-install/import-settings-sharepoint.png)
249+
10. Click **Save**
250+
11. Click the **red icon** for the **SharePoint Connection**
251+
12. In the connections list, click the item with your username
252+
![Import settings screen](./media/expense-report-install/import-settings-approvals.png)
253+
254+
13. Click **Save**
255+
14. Click the **red icon** for the **Office 365 Outlook Connection**
256+
15. In the connections list, click the item with your username
257+
![Import settings screen](./media/expense-report-install/import-settings-office365outlook.png)
258+
16. Click **Save**
259+
260+
**Tip**: When you are done, it will look like this.
261+
262+
![Import settings screen](./media/expense-report-install/import-settings-done.png)
263+
264+
17. Click **Import** and wait until the process is complete
265+
266+
![Import settings screen](./media/expense-report-install/import-done.png)
267+
268+
## Configure the PowerApp to use the SharePoint lists
269+
270+
1. In the web browser, click **Apps**
271+
2. Click the **ellipses** next to the Expense Report PowerApp
272+
3. Click **Edit on the web**
273+
4. Click **Allow**
274+
275+
### Delete connections
276+
1. Click **View**
277+
2. Click **Data sources**
278+
3. In the **Data** pane, click the **ellipses** next to **Expenses**
279+
4. Click **Remove**
280+
5. In the **Data** pane, click the **ellipses** next to **LineItems**
281+
6. Click **Remove**
282+
283+
### Expenses list
284+
285+
1. Click **View**
286+
2. Click **Data sources**
287+
3. In the **Data** pane, click **+ Add data source**
288+
4. Click **+ New connection**
289+
5. Select **SharePoint**
290+
6. Click **Create**
291+
7. In the **Recent sites** list, select the SharePoint site where you created the Expenses List
292+
**Tip**: If the site does not appear in the list, enter the URL to the SharePoint site in the textbox and click, **Go**.
293+
8. In the **Search** textbox at the top of the list enter **Expenses**
294+
9. Check the checkbox next to the **Expenses** list
295+
10. Click **Connect**
296+
297+
### LineItems list
298+
299+
1. Click **View**
300+
2. Click **Data sources**
301+
3. In the **Data** pane, click **+ Add data source**
302+
4. Click **+ New connection**
303+
5. Select **SharePoint**
304+
6. Click **Create**
305+
7. In the **Recent sites** list, select the SharePoint site where you created the LineItems List
306+
**Tip**: If the site does not appear in the list, enter the URL to the SharePoint site in the textbox and click, **Go**.
307+
8. In the **Search** textbox at the top of the list enter **LineItems**
308+
9. Check the checkbox next to the **LineItems** list
309+
10. Click **Connect**
310+
11. Click **File**
311+
12. Click **Save**
312+
13. Click **Publish**
313+
14. Click **Publish this version**
314+
315+
## Modify the Flow
316+
317+
1. In the menu on the left, click **Flows**
318+
2. If prompted to sign in, sign in by providing the same credentials that you used to sign up
319+
3. Select **My flows** in the top menu
320+
4. Next to the **ApproveExpense** Flow, click the **pencil icon**
321+
322+
![Edit Flow screen](./media/expense-report-install/edit-flow.png)
323+
324+
5. Expand the **Get items** action
325+
6. Change the **Site Address** and **List Name** to match the Expense SharePoint list you created
326+
327+
![Edit Flow screen](./media/expense-report-install/edit-flow-getitems.png)
328+
329+
**Tip**: You don’t need to type it manually, you can choose it in the dropdown lists.
330+
331+
7. Expand the **Condition**
332+
8. Expand the **If yes** section
333+
9. Expand the **Change item status to Approved** action
334+
10. Change the **Site Address** and **List Name** to match the Expense SharePoint list you created
335+
336+
![Edit Flow screen](./media/expense-report-install/edit-flow-condition-ifyes.png)
337+
338+
**Tip**: You don’t need to type it manually, you can choose it in the dropdown lists.
339+
340+
11. Expand the **If no** section
341+
12. Expand the **Change item status to Open** action
342+
13. Change the **Site Address** and **List Name** to match the Expense SharePoint list you created
343+
344+
![Edit Flow screen](./media/expense-report-install/edit-flow-condition-ifno.png)
345+
346+
**Tip**: You don’t need to type it manually, you can choose it in the dropdown lists.
347+
348+
14. Click **Update flow**
349+
350+
## Play the PowerApp
351+
352+
1. In the web browser, click **Apps**
353+
2. Click the **ellipses** next to the Expense Report PowerApp
354+
3. Click **Open**
355+
356+
357+
358+
359+

0 commit comments

Comments
 (0)