Skip to content

Commit b647105

Browse files
committed
Add instructions on how to set the admin settings in the admin app.
1 parent cf78328 commit b647105

File tree

4 files changed

+69
-12
lines changed

4 files changed

+69
-12
lines changed
Loading
Loading
Loading

powerapps-docs/maker/canvas-apps/sample-coronavirus-app.md

Lines changed: 69 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,13 @@ internal company news, get answers to frequently asked questions, and get access
2929
to important information like links and emergency contacts. This app requires a
3030
small amount of setup to make it your own.
3131

32+
During this walk through, you will learn how to:
33+
- Create a ___location for your data
34+
- Import both the Crisis Communication app and its admin app
35+
- Create content for the app
36+
- Import flows to send notifications to users
37+
- Create a centrally managed Teams team to aggregate data and to effectively respond to issues
38+
3239
## Prerequisites
3340

3441
- [Sign
@@ -38,10 +45,11 @@ small amount of setup to make it your own.
3845
- You must have a public SharePoint site where you can store the data for the app.
3946
- Download the assets from [aka.ms/CrisisCommunicationSolution](https://aka.ms/CrisisCommunicationSolution).
4047

41-
## Create a new SharePoint site
48+
## Create a home for your data
4249

4350
The data for the app will live in SharePoint lists. We'll first need to create new SharePoint site to get started.
4451

52+
### Create a SharePoint site
4553
1. Sign in to [SharePoint Online](https://www.sharepoint.com).
4654
1. Select Create site and select next:
4755

@@ -60,13 +68,11 @@ The data for the app will live in SharePoint lists. We'll first need to create n
6068
1. Optionally add additional owners.
6169
1. Select Finish.
6270

63-
## Create the SharePoint lists for app
64-
71+
### Create the SharePoint lists for app
6572
The app requires multiple lists that store all the data. To automate the
6673
creation of the SharePoint lists, you can use the *DeploySPLists* flow available from the downloaded [assets package](#prerequisites).
6774

68-
### Import the SharePoint list deployment flow
69-
75+
#### Import the SharePoint list deployment flow
7076
1. Go to [flow.microsoft.com](https://flow.microsoft.com)
7177
1. Select **My flows** from the left navigation.
7278
1. Select the **Import** button in the command bar.
@@ -89,7 +95,7 @@ creation of the SharePoint lists, you can use the *DeploySPLists* flow available
8995
1. Select **Save**.
9096
1. Select **Import**.
9197

92-
### Edit the SharePoint list deployment flow
98+
#### Edit the SharePoint list deployment flow
9399

94100
1. Once the import is done, go back to **My flows** and refresh the list of
95101
Flows
@@ -104,7 +110,7 @@ creation of the SharePoint lists, you can use the *DeploySPLists* flow available
104110

105111
1. Select **Save** to commit your changes.
106112

107-
### Run the SharePoint list deployment flow
113+
#### Run the SharePoint list deployment flow
108114

109115
1. Go back to the detail screen for the **DeploySPList flow.**
110116
1. Select **Run** from the command bar.
@@ -145,11 +151,14 @@ Share
145151
new columns is allowed, but deleting columns may break the app.)
146152
> - Use caution when deleting list items; deleting list items deletes historical records. You can toggle deprecation value from *No* to *Yes* to drop records from contacts, news, FAQs or links.
147153
148-
## Import and setup the app
154+
## Import and setup the Crisis Communication app
149155

150156
Now that all the SharePoint lists are created, you can now import the app and
151157
connect it to your new data sources.
152158

159+
> [!NOTE]
160+
> If you do not want to use the admin app, you can also edit these same properties by editing the SharePoint lists manually.
161+
153162
### Import the app
154163

155164
1. Sign in to [Power Apps](https://make.powerapps.com).
@@ -253,11 +262,59 @@ To manage the app you just imported, you'll want to repeat the same steps for th
253262

254263
1. **Save** and **Publish** the admin app.
255264

256-
### Create initial content for the app
257265

258-
To create initial content for your app, refer to the **administration doc
259-
article**. Before proceeding to the next step, be sure to at least *add your admin
260-
settings*.
266+
## Create initial content for the app
267+
Now that you have successfully imported both the Crisis Communication app and its admin app, you
268+
can now start creating the initial content. To start, open up the Crisis Communication Admin app.
269+
270+
271+
![Admin app](sample-crisis-communication-app/09-Admin-App.png)
272+
273+
The admin application allows you to customize all of the information within the Crisis communication app and
274+
also setup key settings for the accompanying flows.
275+
276+
> [!NOTE]
277+
> As a reminder, if you do not want to use the admin app, you can also edit these same properties
278+
by editing the SharePoint lists manually.
279+
280+
### Setup key parameters under Admin Settings
281+
To initialize your app, you need to provide all of the required fields by navigating to **Admin Settings**.
282+
283+
![Admin app](sample-crisis-communication-app/10-Admin-Settings.png)
284+
285+
Complete all of the fields and select **Save** once you are done.
286+
287+
| **Field name** | **Logical name in SharePoint** | **Purpose** |
288+
|-|-|-|
289+
| Admin email | AdminContactEmail | Used to notify others who is administering the application. |
290+
| Logo URL | Logo | The logo of your app which will appear in the top left corner. |
291+
| AAD group ID | AADGroupID | Used to send notifications to end-users about internal company updates via the *Notify users on new crisis communication news* flow. | |
292+
| Teams channel ID | TeamsChannelID | Used to push help requests to the central response teams' Team channel. | |
293+
| APP URL | AppURL | The ___location of the app so that the *Notify users on new crisis communication news* flow can redirect users after selecting **Read more**. |
294+
| Government RSS Feed | GovernmentRSSFeed | Used to populate the world news feature within the app. Useful if you want to provide additional information to your employees from a trusted source. |
295+
| Notification method | PreferredSentNotification | Used by the *Notify users on new crisis communication news* flow to determine which distribution channel it should use when sending out notifications. |
296+
| Feature flags | Feature1...8 | Used to disable or enable each feature within the application. |
297+
298+
#### Finding the AAD of your distribution group
299+
1. Navigate to [aad.portal.azure.com](aad.portal.azure.com)
300+
1. Select **Azure Active Directory** from the left navigation.
301+
1. Select **Groups**.
302+
1. Search for and select your distrobution group.
303+
1. Copy the **Object Id** field.
304+
305+
![Getting the AAD ID in Azure](sample-crisis-communication-app/11-AAD-Group-ID.png)
306+
307+
1. Paste the ID into the **AAD group ID** field within the admin application.
308+
309+
#### Finding the Teams channel ID of your response Team
310+
1. Navigate to the Teams channel that you want to post all of your help requests to
311+
1. Select the **...** menu for the channel.
312+
1. Select **Get link to channel**
313+
1. Copy link and paste it in a text editor
314+
1. Extract the channel ID, which is everything after `https://teams.microsoft.com/l/channel/` and before `/General`. For example,
315+
for this URL, `https://teams.microsoft.com/l/channel/19%3ab2fa9fc20f3042a9b63fc5890e1813f8%40thread.tacv2/General?groupId=8bc7c0c2-0d4c-4fb8-af99-32da74c9237b&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47`,
316+
the channel ID would be `19%3ab2fa9fc20f3042a9b63fc5890e1813f8%40thread.tacv2`.
317+
1. Copy and paste this ID into the **Teams channel ID** field within the admin application.
261318

262319
### Test the Crisis Communication app
263320

0 commit comments

Comments
 (0)