Merge pull request #4530 from MicrosoftDocs/v-ljoel-Dataverse-teams

Published Perspectives and Boards user doc - 2295567

Author: tapanm-MSFT

powerapps-docs/maker/TOC.yml

@@ -2134,11 +2134,13 @@
       items:
         - name: Use sample apps from Teams store
           href: ../teams/use-sample-apps-from-teams-store.md
-        - name: Bulletins (Preview)
+        - name: Boards (Preview)
+          href: ../teams/boards.md
+        - name: Bulletins
           items:
-            - name: Use Bulletins (Preview) sample app
+            - name: Use Bulletins sample app
               href: ../teams/bulletins.md
-            - name: Understand Bulletins (Preview) sample app architecture
+            - name: Understand Bulletins sample app architecture
               href: ../teams/bulletins-architecture.md
         - name: Employee ideas
           items:
@@ -2156,6 +2158,8 @@
           href: ../teams/issue-reporting.md
         - name: Milestones (Preview)
           href: ../teams/milestones.md
+        - name: Perspectives (Preview)
+          href: ../teams/perspectives.md
         - name: Profile+ (Preview)
           href: ../teams/profile-app.md
         - name: Customize sample apps

powerapps-docs/teams/.DS_Store

@@ -0,0 +1,275 @@
+---
+title: Boards (Preview) sample app
+description: Learn how to use the Boards app.
+author: joel-lindstrom
+ms.service: powerapps
+ms.topic: conceptual
+ms.custom: 
+ms.date: 05/24/2021
+ms.author: v-ljoel
+ms.reviewer: tapanm
+contributors:
+  - joel-lindstrom
+  - navjotm
+  - tapanm-msft
+---
+
+# Boards (Preview) sample app
+
+[This article is pre-release documentation and is subject to change.]
+
+In this tutorial, you'll learn about configuring and using the **Boards** sample app.
+
+## Overview
+
+The Boards template app for Microsoft Teams provides a simple way to connect and share with people in your organization with similar interests.
+
+Benefits of using the Boards app:
+
+-   Pin relevant information in one place.
+-   Organize pins by topic.
+-   Discover items pinned by colleagues.
+
+> [!NOTE]
+> - Before you can use this app, you may be asked for your permissions to use the connection. More information: [Allow connections in sample apps](use-sample-apps-from-teams-store.md#step-1---allow-connections)
+> - This app is available in three different Teams themes: Default, Dark and High contrast. When you [change the theme in Teams](https://support.microsoft.com/en-us/office/change-settings-in-teams-b506e8f1-1a96-4cf1-8c6b-b6ed4f424bc7), the app automatically updates to match the selected theme. More information: [Get the Teams theme using the Teams integration object](use-teams-integration-object.md#get-the-teams-theme)
+
+> [!IMPORTANT]
+>-   This is a preview feature.
+>-   Preview features aren’t meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
+
+## Prerequisites
+
+Before using this app:
+
+1.  Install the app by side-loading the manifest for the app into Teams. You can get the manifest from https://aka.ms/TeamsBoards. For more information and help with installing this app, read the documentation available with the app manifest.
+2.  Set up the app for the first use.
+
+## Using Boards
+
+In this section, you'll learn about the following capabilities in the Boards app:
+
+- [Open the Boards app](#open-the-boards-app)
+
+- [Understanding the Boards app interface](#understanding-the-boards-app-interface)
+
+- [Add a board](#add-a-board)
+
+- [Open a board](#open-a-board)
+
+- [Pin an item to a board](#pin-an-item-to-a-board)
+
+- [Sort boards](#sort-boards)
+
+- [Edit a board](#edit-a-board)
+
+- [Add categories](#add-categories)
+
+- [Edit the Boards app in Power Apps](#edit-the-boards-app-in-power-apps)
+
+  
+
+## Open the Boards app
+
+To open the Boards app:
+
+1.  Sign in to Teams.
+2.  Select the Team in which the app was installed.
+3.  Select the channel where you installed the **Boards** app.
+4.  Select the **Boards** tab.
+5.  Select **Allow** if the app asks for your permissions to use the connectors.
+6.  You can learn more about extending this app's capabilities on the splash
+    screen. Select **Got it** to close the screen, and go to the app. To hide
+    this message while opening this app again, select **Don't show this again**
+    before you select **Got it**.
+
+
+
+    ![Screen displaying a message that reads "Built with Microsoft Power Platform. Ready for you to extend."](media/boards/splash-screen.png "Splash screen")
+
+## Understanding the Boards app interface
+
+The Boards app displays boards grouped by category. A Board is a collection of pinned items for a topic.
+
+![The main screen of the Boards app](media/boards/main-boards-screen.png "Main Boards screen")
+
+
+
+## Add a Board
+
+1.  In Teams, go to the team in which Boards is installed
+
+2.  Select the Boards tab
+
+3. In right corner, select **Add a board**.
+
+   ![The add a board button on the Boards main screen is selected](media/boards/add-a-board-button.png "Add a board")
+
+4. Enter the title, category, and a description of the board.
+
+   ![The fields that should be populated when creating a board](media/boards/add-new-board-screen.png "Add new board screen")
+
+5. Select **Save**.
+
+6. New board is created.
+
+    ![A new board is created](media/boards/board-created.png "Board created")
+
+## Open a board
+
+From the Boards app, you can search for board topics that interest you and open them to view the pinned items. For example, if you're interested in hiking, you could search for hiking-related boards and see what your colleagues have pinned regarding hiking.
+
+1. In the Boards app in Teams, select the **Find a Board** search field.
+
+2. Type the name of the board or category you want to find.
+
+   ![Search field is selected and search results displayed](media/boards/board-search.png "Board search")
+
+3. Boards in your organization that match the search words will be displayed. Select the board you want.
+
+4. The selected board will be displayed. From this screen you can see information about the websites, Teams, channels, and conversation chats related to the board.
+
+5. Search results are organized by category, or you can select **All** to view all returned results.
+
+   ![category selector allows item list to be filtered by item category](media/boards/category-filter.png "Category filter")
+
+## Pin an item to a board
+
+If you want to share an item with your colleagues, you can easily pin it to the appropriate board for the item category.
+
+For example, you might want to share a link to a book written by an author with the Book Club.
+
+1. Open the board you want. In this example, we open the sample board **Book Club.**
+
+   ![The add a board button is selected](media/boards/board-screen.png "Board screen")
+
+2. Select **Add to board.**
+
+   ![The fields that must be populated to add an item to a board.](media/boards/add-to-board.png "add to board")
+
+3. Select the appropriate item type.
+
+4. Add a link to the website.
+
+5. Enter title and description
+
+6. You'll see  a preview of what the card will look like.
+
+7. Select **Save.**
+
+
+
+
+
+## Sort boards
+
+You can sort the order in which board categories are displayed on the main Boards screen.
+
+1. Select the Sort button.
+
+2.  From the pop-up, select arrows up or down to make categories sorted and
+    displayed in that order. 
+    
+    ![Board category sort and display options](media/boards/category-sort.png "Category sort")
+    
+    
+    
+3. To hide a category from the boards screen, select the visibility button.
+
+4. Select **Apply**.
+
+5. Boards matching the selected sort order will be displayed.  
+
+     
+
+## Edit a board
+
+You can Edit the boards under your organization under the Boards app.
+
+To edit the boards:
+
+1.  In Teams, go to the team in which Boards is installed.
+
+2.  Select the Boards tab.
+
+3.  Select a Board.
+
+4. Select **Edit**.
+
+   ![Edit button is selected](media/boards/edit-board.png "Edit board")
+
+5. Change the Title, Category, and Description.
+
+6. Add relevant Image.
+
+7. Select **Save**.  
+
+   ![A custom image is selected for the board image](media/boards/save-button.png "Save button")
+
+## Add categories
+
+You can add the categories under your organization under the Boards app. 
+
+To add categories:
+
+1.  In Teams, go to the team in which Boards is installed.
+
+2.  Select the Boards tab.
+
+3.  Select Settings gear in upper right corner.
+
+4. Select **Add Category**.
+
+   ![Add category button is selected](media/boards/add-category-button.png "add a category")
+
+5. Change the title, category, and description.
+
+   ![New category is added to category list](media/boards/create-board-screen.png "Create Board Screen")
+
+6. Add an image.
+
+7. Select **Save**.  
+
+   
+
+
+
+
+
+## Edit the Boards app in Power Apps
+
+1. In Teams, add the Power Apps app from the Teams store by selecting the ellipses in the app menu, searching for Power Apps, and then selecting **install.**
+
+2. Right-click on Power Apps icon and select **Pop out app** to open the app in a new window. This pop-out action will ensure that you don't lose your changes if you browse somewhere else in Teams.
+
+   ![The main screen for Power Apps app in Teams](media/boards/power-apps-screen.png "Power Apps screen")
+
+3. Select **Build** tab.
+
+4. Select the team in which the Boards app is installed, then select **Installed apps.**
+
+5. In the Boards tile, select the Boards app to open it in Power Apps in Team.
+
+   ![Installed apps tab is selected and boards tile is selected](media/boards/boards-tile.png "Boards tile")
+
+6. You may get prompted to authorize the app's connectors to connect. Select **Allow**.
+
+7. You can now customize the app.
+
+![Boards Power App in Power Apps studio in Teams](media/boards/power-apps-studio.png "Power Apps studio")
+
+### See also
+
+- [Understand Bulletins sample app architecture](bulletins-architecture.md)
+- [Customize sample apps](customize-sample-apps.md)
+- [Sample apps FAQs](sample-apps-faqs.md)
+- [Use sample apps from the Microsoft Teams store](use-sample-apps-from-teams-store.md)
+- [Bulletins sample app](bulletins.md)
+- [Employee ideas sample app](employee-ideas.md)  
+- [Inspection sample apps](inspection.md)  
+- [Issue reporting sample apps](issue-reporting.md)
+- [Milestones (Preview) sample app](milestones.md)
+- [Perspectives (Preview) sample app](perspectives.md)
+- [Profile+ (Preview) sample app](profile-app.md)
+
+[!INCLUDE[footer-include](../includes/footer-banner.md)]

powerapps-docs/teams/boards.md

@@ -1,22 +1,21 @@
 ---
-title: Understand Bulletins sample app architecture | Microsoft Docs
+title: Understand Bulletins sample app architecture
 description: Learn about the architecture of the Bulletins sample app.
 author: navjotm
 ms.service: powerapps
 ms.topic: conceptual
 ms.custom: 
-ms.date: 04/27/2021
+ms.date: 05/24/2021
 ms.author: namarwah
 ms.reviewer: tapanm
 contributors:
-    - tapanm-msft
-    - navjotm
+  - joel-lindstrom
+  - navjotm
+  - tapanm-msft
 ---
 
 # Understand Bulletins sample app architecture
 
-[This article is pre-release documentation and is subject to change.]
-
 In this article, you'll learn about the collections and global variables used by the [Manage Bulletins](bulletins.md#manage-bulletins-app) and [Bulletins](bulletins.md#bulletins-app) apps, and understand how to use them effectively. If you want to learn more about how to install, and use the Bulletins sample app instead, go to [Bulletins sample app](bulletins.md).
 
 ## Prerequisites
@@ -31,10 +30,6 @@ To understand and use information in this article, you'll need to know about dif
 
 You'll also need to know about how to [install](use-sample-apps-from-teams-store.md), and [use](bulletins.md) Bulletins sample app.
 
-> [!IMPORTANT]
-> - This is a preview feature.
-> - [!INCLUDE[cc_preview_features_definition](../includes/cc-preview-features-definition.md)]
-
 ## Data model
 
 The following diagram explains the data model used by the Bulletins sample app.

powerapps-docs/teams/bulletins-architecture.md

@@ -1,18 +1,20 @@
 ---
-title: Use Bulletins apps from teams store | Microsoft Docs
+title: Bulletins sample app
 description: Learn how to use the Bulletins apps from Teams store.
 author: navjotm
 ms.service: powerapps
 ms.topic: conceptual
 ms.custom: 
-ms.date: 01/07/2021
+ms.date: 05/24/2021
 ms.author: namarwah
 ms.reviewer: tapanm
+contributors:
+  - joel-lindstrom
+  - navjotm
+  - tapanm-msft
 ---
 
-# Bulletins sample app (Preview)
-
-[This article is pre-release documentation and is subject to change.]
+# Bulletins sample app
 
 In this tutorial, you'll learn about configuring, and using the **Bulletins** sample app.
 
@@ -41,10 +43,6 @@ The Bulletins app solution consists of two apps.
 > - Before you can use this app, you may be asked for your permissions to use the connection. More information: [Allow connections in sample apps](use-sample-apps-from-teams-store.md#step-1---allow-connections)
 > - This app is available in three different Teams themes: Default, Dark and High contrast. When you [change the theme in Teams](https://support.microsoft.com/en-us/office/change-settings-in-teams-b506e8f1-1a96-4cf1-8c6b-b6ed4f424bc7), the app automatically updates to match the selected theme. More information: [Get the Teams theme using the Teams integration object](use-teams-integration-object.md#get-the-teams-theme)
 
-> [!IMPORTANT]
-> - This is a preview feature.
-> - [!INCLUDE[cc_preview_features_definition](../includes/cc-preview-features-definition.md)]
-
 ## Prerequisites
 
 Before using this app:
@@ -462,10 +460,12 @@ To view links, and contacts:
 - [Customize sample apps](customize-sample-apps.md)
 - [Sample apps FAQs](sample-apps-faqs.md)
 - [Use sample apps from the Microsoft Teams store](use-sample-apps-from-teams-store.md)
+- [Boards (Preview) sample app](boards.md)
 - [Employee ideas sample app](employee-ideas.md)  
 - [Inspection sample apps](inspection.md)  
 - [Issue reporting sample apps](issue-reporting.md)
 - [Milestones (Preview) sample app](milestones.md)
+- [Perspectives (Preview) sample app](perspectives.md)
 - [Profile+ (Preview) sample app](profile-app.md)
 
 [!INCLUDE[footer-include](../includes/footer-banner.md)]