Merge branch 'main' into jdaly-main-4492

Author: JimDaly

powerapps-docs/developer/data-platform/TOC.yml

@@ -282,7 +282,7 @@
           href: task-fax-phone-call-letter-activity-entities.md
         - name: ActivityParty table
           href: activityparty-entity.md
-        - name: ActivityPointer (activity) table
+        - name: Activity (ActivityPointer) table
           href: activitypointer-activity-entity.md
         - name: Recurring Appointments
           items:

powerapps-docs/developer/data-platform/activitypointer-activity-entity.md

@@ -1,50 +1,54 @@
 ---
-title: "ActivityPointer (activity) table (Microsoft Dataverse) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
-description: "The activity pointer (activity) table represents any activity or task a user performs. An activity is any action where you would make an entry on a calendar." 
-ms.date: 03/25/2023
+title: Activity (ActivityPointer) table
+description: Learn how to work with the Activity (ActivityPointer) table in Microsoft Dataverse.
+ms.date: 07/03/2023
 ms.reviewer: pehecke
-ms.topic: article
+ms.topic: conceptual
 author: DanaMartens
-ms.subservice: dataverse-developer
 ms.author: dmartens 
+ms.subservice: dataverse-developer
 search.audienceType: 
-  - developer
+- developer
+ms.custom: bap-template
 ---
-# ActivityPointer (activity) table
 
-The [Activity (ActivityPointer)  table](reference/entities/activitypointer.md) represents any activity or task a user performs. An activity is any action where you would make an entry on a calendar.  
-  
-Whenever you create an activity record in Dataverse, a corresponding activity pointer record is created. The activity record and the corresponding activity pointer record have the same value for the `ActivityId` column. For example, when you create an `Email` record, the column values of `Email.ActivityId` and the corresponding `ActivityPointer.ActivityId` are the same.  
-  
-The [ActivityPointer.ActivityTypeCode](/power-apps/developer/data-platform/reference/entities/activitypointer#BKMK_ActivityTypeCode) column defines the type of the activity. The possible values for this column are defined in `activitypointer_activitytypecode` global option set.
+# Activity (ActivityPointer) table
+
+The [Activity (ActivityPointer) table](reference/entities/activitypointer.md) stores data about activities or tasks a user performs. An activity is any action that can be entered on a calendar and has time dimensions (start time, stop time, due date, and duration).
+
+When you create an activity record in Dataverse, it creates a corresponding activity pointer record. The activity record and its associated activity pointer record have the same value for the `ActivityId` column.
+
+The [`ActivityPointer.ActivityTypeCode`](/power-apps/developer/data-platform/reference/entities/activitypointer#BKMK_ActivityTypeCode) column defines the type of the activity. The possible values for this column are defined in the `activitypointer_activitytypecode` global option set.
 
 ## Inherited statecode and statuscode options
 
-When you  interact with activities with code, it's important to keep in mind that the `statecode` and `statuscode` columns of the types that are derived from `ActivityPointer` can have differences from the `ActivityPointer` `statecode` and `statuscode` column definitions.
+When you write code that sets or modifies activity columns, it's important to keep in mind that the `statecode` and `statuscode` columns of`ActivityPointer` derived types can have a somewhat different purpose from the base `ActivityPointer` `statecode` and `statuscode` column definitions. The following sections describe these differences.
 
 ### StateCode option differences
 
+In this section, let's review state code option differences between `ActivityPointer` and derived types.
+
 [ActivityPointer.StateCode](/power-apps/developer/data-platform/reference/entities/activitypointer#statecode-choicesoptions) defines four options:
 
-|Label|Value|
-|---------|---------|
-|**Open**|0|
-|**Completed**|1|
-|**Canceled**|2|
-|**Scheduled**|3|
+| Label | Value |
+| --------- | ---------|
+| **Open** | 0 |
+| **Completed** | 1 |
+| **Canceled** | 2 |
+| **Scheduled** | 3 |
 
-- [Appointment](/power-apps/developer/data-platform/reference/entities/appointment#statecode-choicesoptions), [Chat](/power-apps/developer/data-platform/reference/entities/chat#statecode-choicesoptions), [RecurringAppointmentMaster](/power-apps/developer/data-platform/reference/entities/recurringappointmentmaster#statecode-choicesoptions), and any custom activities have all four `statecode` options.
-- [Email](/power-apps/developer/data-platform/reference/entities/email#statecode-choicesoptions), [Fax](/power-apps/developer/data-platform/reference/entities/fax#statecode-choicesoptions), [Letter](/power-apps/developer/data-platform/reference/entities/letter#statecode-choicesoptions), [PhoneCall](/power-apps/developer/data-platform/reference/entities/phonecall#statecode-choicesoptions), [Task](/power-apps/developer/data-platform/reference/entities/task#statecode-choicesoptions), and [SocialActivity](/power-apps/developer/data-platform/reference/entities/socialactivity#statecode-choicesoptions) only have the first three `statecode` options. There's no valid option to set the state of these activity types as **Scheduled**.
+- [Appointment](/power-apps/developer/data-platform/reference/entities/appointment#statecode-choicesoptions), [Chat](/power-apps/developer/data-platform/reference/entities/chat#statecode-choicesoptions), [RecurringAppointmentMaster](/power-apps/developer/data-platform/reference/entities/recurringappointmentmaster#statecode-choicesoptions), and custom activities have all four `statecode` options.
+- [Email](/power-apps/developer/data-platform/reference/entities/email#statecode-choicesoptions), [Fax](/power-apps/developer/data-platform/reference/entities/fax#statecode-choicesoptions), [Letter](/power-apps/developer/data-platform/reference/entities/letter#statecode-choicesoptions), [PhoneCall](/power-apps/developer/data-platform/reference/entities/phonecall#statecode-choicesoptions), [Task](/power-apps/developer/data-platform/reference/entities/task#statecode-choicesoptions), and [SocialActivity](/power-apps/developer/data-platform/reference/entities/socialactivity#statecode-choicesoptions) have the first three `statecode` options. There's no valid option to set the state of these activity types as **Scheduled**.
 
 ### StatusCode label differences
 
-The `statuscode` options provide reasons for the `statecode` of the record. These option sets can be customized by adding new options, so each table can have a different set of options. Some of the options have the same value as the [ActivityPointer](reference/entities/activitypointer.md) `statuscode` option values, but the labels can be different.
+The `statuscode` options provide reasons for the `statecode` of the record. You can add new `statuscode` options so that each table has a different set. Some of the options have the same value as the [ActivityPointer](reference/entities/activitypointer.md) `statuscode`, but the labels can be different.
 
-Labels for `statuscode` options vary based on whether you're retrieving rows as an [ActivityPointer](reference/entities/activitypointer.md) or a specific activity type such as an [Appointment](reference/entities/appointment.md), [Email](reference/entities/email.md), or [Task](reference/entities/task.md).
+Labels for `statuscode` options vary based on whether you're retrieving rows as an [ActivityPointer](reference/entities/activitypointer.md) or as a specific activity type such as an [Appointment](reference/entities/appointment.md), [Email](reference/entities/email.md), or [Task](reference/entities/task.md).
 
-For example, if you retrieve an `ActivityPointer` row that represents an `Appointment`, the label for `statuscode` value `1` shows up as **Open** rather than **Free**.
+For example, if you retrieve an `ActivityPointer` row that represents an `Appointment`, the label for `statuscode` value `1` is **Open** rather than **Free**.
 
-You can find the labels in the definition of the default `statuscode` options for each table here:
+Labels are listed in the definition of the default `statuscode` options for each table:
 
 - [ActivityPointer.StatusCode Options](/power-apps/developer/data-platform/reference/entities/activitypointer#statuscode-choicesoptions)
 - [Appointment.StatusCode Options](/power-apps/developer/data-platform/reference/entities/appointment#statuscode-choicesoptions)
@@ -59,16 +63,17 @@ You can find the labels in the definition of the default `statuscode` options fo
 
 <a name="bkmk_sortdate"></a>
 
-## Control how activities are sorted by date  
-  
- Whenever you display a list of activity entities and order them by date, you can only use the common date columns defined in the [ActivityPointer](reference/entities/activitypointer.md) table. However, sometimes you want different sorting behaviors depending on the type of activity. For example, with the email table you might want to sort by the `senton` column value  rather than the `modifiedon` column value.  
-  
- Use the `sortdate` column to control how activities are sorted by date. By default, the `sortdate` column value is null. You must include business logic to populate the date value that set for this column and then use the `sortdate` column within the query defined for the view. You can set the `sortdate` column value using a workflow or a plugin. For consistent results, you should set this value for every type of activity and any existing activity data in the system.  
-  
+## Control how activities are sorted by date
+
+ When you display a list of activity entities in date order, you can only sort on the common date columns defined in the [ActivityPointer](reference/entities/activitypointer.md) table. However, sometimes you want different sorting behaviors depending on the type of activity. For example, you might want to sort email activities by the "sent on" date rather than the "modified on" date. Use the `sortdate` column to control how activities are sorted by date.
+
+By default, the value of the `sortdate` column is null. Include logic to set a value for the column and then use the `sortdate` column in the query you define for the view.
+
+You can set the `sortdate` column value using a workflow or a plugin. For consistent results, you should set this value for every type of activity and any existing activity data in the system.
+
 ### See also
 
- [Activity tables](activity-entities.md)<br />
+ [Activity tables](activity-entities.md)  
  [ActivityPointer table](reference/entities/activitypointer.md)
 
-
-[!INCLUDE[footer-include](../../includes/footer-banner.md)]
+[!INCLUDE [footer-include](../../includes/footer-banner.md)]

powerapps-docs/developer/data-platform/community-tools.md

@@ -42,9 +42,9 @@ The following is a selected list of community tools distributed via the XrmToolB
 
 ## Browser Extensions
 
-### Chromium Metadata Browser
+### Pascalcase Metadata Browser
 
-Here is another tool, [Chromium Metadata Browser](https://pascalcase.com/Home/Metadata), that lets you browse metadata such as tables, columns, relationships, choices of Dataverse environments. It works with Microsoft Edge and Google Chrome browsers. 
+Here is another tool, [Pascalcase Metadata Browser](https://pascalcase.com/Home/Metadata), that lets you browse metadata such as tables, columns, relationships, choices of Dataverse environments. It works with Microsoft Edge browser. 
 
 ### Level up for Dynamics 365/Power Apps
 

powerapps-docs/developer/data-platform/optional-parameters.md

@@ -1,7 +1,7 @@
 ---
 title: "Use optional parameters (Microsoft Dataverse) | Microsoft Docs" 
 description: "Use optional parameters to control operation behaviors" 
-ms.date: 05/27/2023
+ms.date: 06/28/2023
 ms.reviewer: jdaly
 ms.topic: article
 author: divkamath
@@ -222,6 +222,9 @@ More information:
 
 Use the `tag` parameter to include a shared variable value that is accessible within a plug-in. This extra information allows a plug-in to apply logic that depends on the client application.
 
+> [!NOTE]
+> This parameter is intended for client applications to be able to set any value they wish. No Microsoft feature should require that you set a specific value in your client application code to enable different behaviors.
+
 To access the value in a plug-in, use the [IExecutionContext.SharedVariables collection](xref:Microsoft.Xrm.Sdk.IExecutionContext.SharedVariables)
 
 ```csharp

powerapps-docs/developer/data-platform/org-service/samples/execute-multiple-requests.md

@@ -17,7 +17,7 @@ contributors:
 
 This sample shows how to execute multiple organization message requests by using a single web service method call, passing [ExecuteMultipleRequest](/dotnet/api/microsoft.xrm.sdk.messages.executemultiplerequest) as a parameter. Reducing the number of message requests that must be transmitted over the network results in increased message processing performance.
 
-You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/dataverse/orgsvc/C%23/ExecutemultipleRequests).
+You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/dataverse/orgsvc/C%23/ExecuteMultipleRequests).
 
 [!INCLUDE[cc-terminology](../../includes/cc-terminology.md)]
 

powerapps-docs/developer/model-driven-apps/clientapi/create-app-side-panes.md

@@ -91,6 +91,26 @@ Xrm.App.sidePanes.createPane({
 > [!div class="mx-imgBorder"] 
 > ![Screenshot showing an Active Reservations list opened to an individual record.](../media/app-side-panes-opening-record.png "Open record")
 
+### Showing a web resource
+
+This example shows how to display a webresource in the side pane. A custom html page is opened in a side pane where the default header is visible & close button is hidden.
+
+```javascript
+Xrm.App.sidePanes.createPane({
+                        title: "Registration Page",
+                        imageSrc: "WebResources/msfp_SurveyIcon_32",
+                        paneId: "RegistrationPage",
+                        canClose: false
+                    }).then((pane) => {
+                        //navigate to webresource
+                        pane.navigate({
+                            pageType: "webresource",
+                            webresourceName: "new_RegistrationPage",
+                        })
+                    });
+```
+
+
 ### Managing side panes
 
 In addition to creating side panes and showing rows or views within the side pane, you can also: