Merge pull request #7305 from MicrosoftDocs/main

Sally - latest from Main

Author: sericks007

powerapps-docs/developer/data-platform/file-attributes.md

@@ -17,7 +17,7 @@ contributors:
 ---
 # File columns
 
-Use file columns to store file data up to a specified maximum size. A custom or customizable table can have zero or more file columns.
+Use file columns to store file data up to a specified maximum size. A custom or customizable table can have zero or more file columns. This topic is about working with column definitions in code. To use data stored in these columns, see [Use file column data](file-column-data.md).
 
 ## Create file columns
 

powerapps-docs/developer/data-platform/file-column-data.md

@@ -1,7 +1,7 @@
 ---
 title: "Use file column data (Microsoft Dataverse) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
 description: "Learn about uploading, downloading, and deleting data in file columns." # 115-145 characters including spaces. This abstract displays in the search result.
-ms.date: 11/02/2022
+ms.date: 11/08/2022
 ms.reviewer: jdaly
 ms.topic: article
 author: NHelgren # GitHub ID
@@ -30,6 +30,12 @@ Each file column has a supporting read-only string column that contains the name
 > [!NOTE]
 > The file name column does not appear in the [Power Apps](https://make.powerapps.com/?utm_source=padocs&utm_medium=linkinadoc&utm_campaign=referralsfromdoc) designer.
 
+## Relationship to FileAttachment table
+
+When a file column is created for a table, a new one-to-many relationship is created between the table and the `FileAttachment` table. The name of the relationship is `{table logical name}_FileAttachments`. For example, if the file column is part of the account table, the relationship name will be `account_FileAttachments`.
+
+You can use this relationship to return additional data about the file column and any other file columns for the table. More information: [Retrieve additional information about files for a record](#retrieve-additional-information-about-files-for-a-record).
+
 ## Behavior when retrieving
 
 When you retrieve a record and include a file column, the value returned will be a unique identifier for the file. You can use this value to delete the file using the `DeleteFile` message. There is no other use for this id other than to check whether the column has a value. More information: [Use the DeleteFile message](#use-the-deletefile-message).
@@ -101,6 +107,121 @@ More information: [Retrieve a table row using the Web API](webapi/retrieve-entit
 
 ---
 
+### Retrieve additional information about files for a record
+
+You can use the relationship between the file column table and the `FileAttachment` table to return information about all file columns associated to that table row.
+
+#### [SDK for .NET](#tab/sdk)
+
+The `RetrieveAccountRecordWithFileData` static method below will return information about all the file columns that contain data related to the `account` record with the matching `accountid` value.
+
+```csharp
+static void RetrieveAccountRecordWithFileData(IOrganizationService service, Guid accountid)
+{
+    // Create query for related records
+    var relationshipQueryCollection = new RelationshipQueryCollection {
+        {
+            new Relationship("account_FileAttachments"),
+            new QueryExpression("fileattachment"){
+                ColumnSet = new ColumnSet(
+                                "createdon",
+                                "mimetype",
+                                "filesizeinbytes",
+                                "filename",
+                                "regardingfieldname",
+                                "fileattachmentid")
+            }
+        }
+    };
+
+    // Include the related query with the Retrieve Request
+    RetrieveRequest request = new RetrieveRequest
+    {
+        ColumnSet = new ColumnSet("accountid"),
+        RelatedEntitiesQuery = relationshipQueryCollection,
+        Target = new EntityReference("account", accountid)
+    };
+
+    // Send the request
+    RetrieveResponse response = (RetrieveResponse)service.Execute(request);
+
+    //Display related FileAttachment data for the account record
+    response.Entity.RelatedEntities[new Relationship("account_FileAttachments")]
+        .Entities.ToList().ForEach(e =>
+        {
+            Console.WriteLine($"createdon: {e.FormattedValues["createdon"]}");
+            Console.WriteLine($"mimetype: {e["mimetype"]}");
+            Console.WriteLine($"filesizeinbytes: {e.FormattedValues["filesizeinbytes"]}");
+            Console.WriteLine($"filename: {e["filename"]}");
+            Console.WriteLine($"regardingfieldname: {e["regardingfieldname"]}");
+            Console.WriteLine($"fileattachmentid: {e["fileattachmentid"]}");
+        });
+}
+```
+
+**Output**:
+
+In this case, there is a single file column in the account table named `sample_filecolumn`, and this is the data about the file stored in that column.
+
+```
+createdon: 10/22/2022 2:01 PM
+mimetype: application/pdf
+filesizeinbytes: 25,870,370
+filename: 25mb.pdf
+regardingfieldname: sample_filecolumn
+fileattachmentid: 63a6afb7-4c52-ed11-bba1-000d3a9933c9
+```
+
+More information:
+
+- [What is the Organization service](org-service/overview.md)
+- [Retrieve with related rows](org-service/entity-operations-retrieve.md#retrieve-with-related-rows)
+
+#### [Web API](#tab/webapi)
+
+The request below below will return information about all the file columns that contain data related to the `account` record with `accountid` equal to `352edda9-4c52-ed11-bba1-000d3a9933c9`.
+
+**Request**
+
+```http
+GET [Organization URI]/api/data/v9.2/accounts(352edda9-4c52-ed11-bba1-000d3a9933c9)?$filter=sample_filecolumn%20ne%20null&$expand=account_FileAttachments($select=createdon,mimetype,filesizeinbytes,filename,regardingfieldname)&$select=accountid HTTP/1.1
+OData-MaxVersion: 4.0
+OData-Version: 4.0
+If-None-Match: null
+Accept: application/json
+```
+
+**Response**
+
+In this case, there is a single file column in the account table named `sample_filecolumn`, and this is the data about the file stored in that column.
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json; odata.metadata=minimal
+OData-Version: 4.0
+
+{
+  "@odata.context": "[Organization URI]/api/data/v9.2/$metadata#accounts(accountid,account_FileAttachments(createdon,mimetype,filesizeinbytes,filename,regardingfieldname))/$entity",
+  "@odata.etag": "W/\"75119522\"",
+  "accountid": "352edda9-4c52-ed11-bba1-000d3a9933c9",
+  "account_FileAttachments": [
+    {
+      "@odata.etag": "W/\"75119363\"",
+      "createdon": "2022-10-22T21:01:45Z",
+      "mimetype": "application/pdf",
+      "filesizeinbytes": 25870370,
+      "filename": "25mb.pdf",
+      "regardingfieldname": "sample_filecolumn",
+      "fileattachmentid": "63a6afb7-4c52-ed11-bba1-000d3a9933c9"
+    }
+  ]
+}
+```
+
+More information: [Retrieve with related rows](org-service/entity-operations-retrieve.md#retrieve-with-related-rows)
+
+---
+
 ## Upload Files
 
 There at three different ways to upload files to a file column:

powerapps-docs/developer/data-platform/use-access-teams-owner-teams-collaborate-share-information.md

@@ -24,7 +24,7 @@ With *owner* teams or *access* teams, you can easily share business objects and
 > [!NOTE]
 >  While teams provide access to a group of users, you must still associate individual users with security roles that grant the privileges they need to create, update, or delete user-owned records. These privileges cannot be applied by assigning security roles to a team and then adding the user to that team.  
   
- An access team doesn’t own records and doesn’t have security roles assigned to the team. The team members have privileges defined by their individual security roles and by roles from the teams in which they are members. The records are shared with an access team and the team is granted access rights on the records, such as Read, Write or Append.  
+ An access team doesn’t own records and doesn’t have security roles assigned to the team. The team members have privileges defined by their individual security roles and by roles from the teams in which they are members. The records are shared with an access team and the team is granted access rights on the records, such as Read, Write or Append, and therefore access team members cannot create records using the access rights of the access team. User is required to have a security role with Create privilege to create records.
 
  The team functionality is supported by the `Team` and `TeamTemplate` tables. The `Team` table is used to create owner teams and user-created access teams. For auto-created access teams, the `Team` table and the `TeamTemplate` table are used.  
 

powerapps-docs/developer/model-driven-apps/actions-dashboards.md

@@ -19,13 +19,13 @@ contributors:
 
 # Actions on dashboards
 
-You can perform actions such as create, retrieve, update, or delete, on organization-owned and user-owned dashboards.
+You can perform actions such as create, retrieve, update, or delete on organization-owned and user-owned dashboards.
 
 ## Actions on an organization-owned dashboard
 
 To perform the following actions on an organization-owned dashboard (`SystemForm`), you must have the System Administrator or the System Customizer role assigned to your account in Microsoft Dataverse:
 
-- Create, retrieve, update, and delete. You can create or update an organization-owned dashboard by using the Dataverse web services or by customizing the form. For detailed information about creating a dashboard, see [Create a dashboard](create-dashboard.md).
+- Create, retrieve, update, and delete. You can create or update an organization-owned dashboard using the Dataverse web services or customizing the form. For detailed information about creating a dashboard, see [Create a dashboard](create-dashboard.md).
 - Set an organization-owned dashboard as the default dashboard for an organization by setting the `SystemForm.IsDefault` value to `true` while creating or updating the dashboard.
 
   > [!IMPORTANT]

powerapps-docs/maker/TOC.yml

@@ -217,6 +217,8 @@
     href: index.md
   - name: Sign in to Power Apps
     href: ./canvas-apps/intro-maker-portal.md
+  - name: Use the learning hub
+    href: ./common/learn-hub.md 
   - name: Find it with unified search
     href: search.md
   - name: Get help from a virtual agent

powerapps-docs/maker/canvas-apps/search.md

@@ -82,33 +82,33 @@ Selecting search results in different areas of the Search pane will behave diffe
 
     There are several category headers inside the Search pane that you can use to navigate through the results. Categories such as **Variables**, **Collections**, **Data**, **Media**, **Flows**, and **Components** are referred to as **definitions**.
 
-    Selecting the results under such definition category headers takes you to the appropriate definition screen backstage (such as for Variables and Collections), or to the appropriate pane where that object is available in your app (such as Data, Media, Flows, or Components).
+    Selecting the results under such definition category headers takes you to the appropriate information screen such as for Variables and Collections, or to the appropriate pane where that object is available in your app (such as Data, Media, Flows, or Components).
 
 - **Instances** describe the search results that are tied to an individual app, screen, or control property in the formula bar. All these results are tied to the **Screens** category based on the structure found inside the **Tree View**. When you select a result under this **Screens** category, you'll be taken to that specific formula bar reference or the related control, as applicable.
 
 ### Variables
 
-Selecting a global or a context variable under the **Variables** header in the search results will take you to the information screen backstage for the selection.
+Selecting a global or a context variable under the **Variables** header in the search results will take you to the Variables information screen for the selection.
 
 As shown below, you're taken to the definition of the global or context variable depending on your selection from the search results available.
 
 Search result:
 
 :::image type="content" source="media/search/variables-1.png" alt-text="Global and context variables available in search result.":::
 
-Depending on the selected global or context variable, you're taken to the backstage for the selected type of variable.
+Depending on the selected global or context variable, you're taken to the information screen for the selected type of variable.
 
 Global variable selected:
 
-:::image type="content" source="media/search/global-variable.png" alt-text="Selecting a global variable takes you to the backstage of the selected global variables.":::
+:::image type="content" source="media/search/global-variable.png" alt-text="Selecting a global variable takes you to the information screen of the selected global variables.":::
 
 Context variable selected:
 
-:::image type="content" source="media/search/local-variable-1.png" alt-text="Selecting a context variable takes you to the backstage of the selected context variables.":::
+:::image type="content" source="media/search/local-variable-1.png" alt-text="Selecting a context variable takes you to the information screen of the selected context variables.":::
 
 ### Collections
 
-Selecting a collection under the **Collections** header will take you to the information screen backstage for that collection.
+Selecting a collection under the **Collections** header will take you to the information screen for that collection.
 
 :::image type="content" source="media/search/collections-1.png" alt-text="Collections selected from search results showing the relevant collection details.":::
 
@@ -186,13 +186,13 @@ You can also interact with individual results in the results list directly to pe
 
 ### Replacing Variables results
 
-Performing a replacement for results in the Variables category replaces the variable name at the definition level, meaning all instances of the matching variable name will be replaced across the entire app. You can also view the variable details backstage to review the usage before making the replacement.
+Performing a replacement for results in the Variables category replaces the variable name at the definition level, meaning all instances of the matching variable name will be replaced across the entire app. You can also view the variable details on their information screen to review the usage before making the replacement.
 
 :::image type="content" source="media/search/variables.png" alt-text="Screen showing replacing variables results.":::
 
 ### Replacing Collections results
 
-Similar to variables, replacing a result in the Collections category replaces the collection name at the definition level, replacing all matching instances of the collection name across the app. You can view collection details backstage prior to making the replacement.
+Similar to variables, replacing a result in the Collections category replaces the collection name at the definition level, replacing all matching instances of the collection name across the app. You can view collection details on their information screen prior to making the replacement.
 
 :::image type="content" source="media/search/collections.png" alt-text="Screen showing replace collections results.":::
 

powerapps-docs/maker/common/learn-hub.md

@@ -0,0 +1,71 @@
+---
+title: "How to use the learning hub | MicrosoftDocs"
+description: How to use the learning hub. 
+ms.custom: ""
+ms.date: 11/2/2022
+ms.reviewer: "mkaur"
+ms.topic: overview
+author: "mkaur"
+ms.subservice: common
+ms.author: "mkaur"
+manager: "tapanm"
+search.audienceType: 
+  - maker, admin
+search.app: 
+  - PowerApps
+---
+
+# Use the learning hub
+
+With the learning hub, you can explore documents, training material, get help from the Power Apps community, and other resources that will help you to create and build Power Apps.
+
+1. To access the learning hub, go to the [Power Apps home page](https://make.powerapps.com) and select **Learn** on the left pane. 
+2. Select one of the tabs to access the information that you're looking for.
+3. Use the **Previous** and **Next** buttons to see more items. 
+
+> [!div class="mx-imgBorder"] 
+> ![How to use the learning hub.](media/learn/learn-hub.png "How to use the learning hub") 
+
+
+## Banner
+
+The banner at the top showcases the latest announcements, trending posts, and information about upcoming Microsoft events. 
+
+> [!div class="mx-imgBorder"] 
+> ![Banner for the learning hub.](media/learn/learn-banner.png "Banner for learning hub") 
+
+## Overview
+
+The **Overview** tab lists featured learning path and modules, posts from the community, help articles, and training videos on YouTube.
+
+> [!div class="mx-imgBorder"] 
+> ![Overview tab.](media/learn/overview-tab.png "Overview tab") 
+
+## Courses
+
+The **Courses** tab provides guided training such as learning path, modules, and training events.
+
+> [!div class="mx-imgBorder"] 
+> ![Courses tab.](media/learn/learn-courses.png "Courses tab") 
+
+## Articles
+
+The **Articles** tab has information from public blogs articles.
+
+> [!div class="mx-imgBorder"] 
+> ![Articles tab.](media/learn/learn-articles.png "Articles tab") 
+
+
+## Community
+
+The **Community** tab provides access to content from the Power Apps community including user groups, networking events, LinkedIn Power Apps community, and more. 
+
+> [!div class="mx-imgBorder"] 
+> ![Community tab.](media/learn/learn-community.png "Community tab") 
+
+## Support
+
+Go to the **Support** tab to get help with common issues, report a problem, submit an idea, and get access to help topics.
+
+> [!div class="mx-imgBorder"] 
+> ![Support tab.](media/learn/learn-support.png "Support tab")