Updates

Author: Nkrb

powerapps-docs/developer/component-framework/reference/context.md

@@ -70,7 +70,7 @@ The resource interface of `context.resource`
 
 ### updatedProperties
 
-An array of strings indicated which values have changed on the context object since the last time it was passed to this component.
+An array of strings with values that have changed since the last time it was passed and [parameters](#parameters). `updatesProperties` is currently only supported for model-driven apps and always returns empty string for canvas apps.
 
 **Type**: `string[]`
 

powerapps-docs/developer/model-driven-apps/export-ribbon-definitions.md

@@ -2,13 +2,13 @@
 title: "Export ribbon definitions (model-driven apps) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
 description: "Learn about exporting the ribbon definitions." # 115-145 characters including spaces. This abstract displays in the search result.
 ms.custom: ""
-ms.date: 10/31/2018
+ms.date: 04/30/2020
 ms.reviewer: ""
 ms.service: powerapps
 ms.topic: "article"
-author: "KumarVivek" # GitHub ID
-ms.author: "kvivek" # MSFT alias of Microsoft employees only
-manager: "shilpas" # MSFT alias of manager or PM counterpart
+author: "nkrb" # GitHub ID
+ms.author: "nabuthuk" # MSFT alias of Microsoft employees only
+manager: "kvivek" # MSFT alias of manager or PM counterpart
 search.audienceType: 
   - developer
 search.app: 
@@ -17,21 +17,15 @@ search.app:
 ---
 # Export ribbon definitions
 
-<!-- https://docs.microsoft.com/dynamics365/customer-engagement/developer/customize-dev/export-ribbon-definitions -->
-
 To effectively define changes to the default RibbonXml, you must be able to reference the RibbonXml data that defines those ribbons.  
 
-<a name="BKMK_AccessRibbonDefinitionsForYourOrganization"></a>   
-
 ## Access the ribbon definitions for your organization  
 
- If the Ribbon for your organization has been modified, you should export the current definitions if you intend to work with the customized ribbon elements. To do this, use the exportribbonxml sample located at `SampleCode\CS\Client\Ribbon\ExportRibbonXml`.  
+If the Ribbon for your organization has been modified, you should export the current definitions if you intend to work with the customized ribbon elements. To do this, use the [Export Ribbon xml](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/ExportRibbonDefinitions) sample.  
 
-<a name="BKMK_AccessDefaultRibbonData"></a>   
-
 ## Access the default ribbon data  
 
- The default ribbon definitions for Model-driven apps can be downloaded from [Microsoft Downloads: ExportedRibbonXml.zip](https://download.microsoft.com/download/C/2/A/C2A79C47-DD2D-4938-A595-092CAFF32D6B/ExportedRibbonXml.zip). 
+ The default ribbon definitions for model-driven apps can be downloaded from [Microsoft Downloads: ExportedRibbonXml.zip](https://download.microsoft.com/download/C/2/A/C2A79C47-DD2D-4938-A595-092CAFF32D6B/ExportedRibbonXml.zip). 
 
  The applicationRibbon.xml file contains the definition of the core application ribbons.  
 
@@ -48,6 +42,7 @@ To effectively define changes to the default RibbonXml, you must be able to refe
 ### Decompress the ribbon data  
 
  The ribbon data is exported as a compressed file. To decompress the file into XML you have to use the [System.IO.Packaging.ZipPackage](https://msdn.microsoft.com/library/system.io.packaging.zippackage.aspx) class. The following example is a helper method used in the SDK sample to decompress the file.  
+
  ``` C# 
 /// <summary>
 /// A helper method that decompresses the Ribbon data returned
@@ -78,10 +73,11 @@ public byte[] unzipRibbon(byte[] data)
 ### Retrieve the application ribbon data  
 
  The application ribbon can be retrieved using the <xref:Microsoft.Crm.Sdk.Messages.RetrieveApplicationRibbonRequest> as shown in the following sample.  
+
  ```C# 
- //Retrieve the Appliation Ribbon
-RetrieveApplicationRibbonRequest appribReq = new RetrieveApplicationRibbonRequest();
-RetrieveApplicationRibbonResponse appribResp = (RetrieveApplicationRibbonResponse)_serviceProxy.Execute(appribReq);
+ //Retrieve the Application Ribbon
+var appribReq = new RetrieveApplicationRibbonRequest();
+var appribResp = (RetrieveApplicationRibbonResponse)service.Execute(appribReq);
 
 System.String applicationRibbonPath = Path.GetFullPath(exportFolder + "\\applicationRibbon.xml");
 File.WriteAllBytes(applicationRibbonPath, unzipRibbon(appribResp.CompressedApplicationRibbonXml)); 
@@ -92,9 +88,10 @@ File.WriteAllBytes(applicationRibbonPath, unzipRibbon(appribResp.CompressedAppli
  To retrieve the ribbon definition for entities, you can just include the name of the entity as a parameter to the <xref:Microsoft.Crm.Sdk.Messages.RetrieveEntityRibbonRequest>.  
 
  To retrieve the ribbon definitions for all entities that support the ribbon you need a list of those system entities that have ribbon definitions that vary from the entity ribbon template. The following sample shows an array of all the system entities that have ribbon definitions.  
+
  ```C# 
  //This array contains all of the system entities that use the ribbon.
-  public System.String[] entitiesWithRibbons = {"account",
+public System.String[] entitiesWithRibbons = {"account",
 "activitymimeattachment",
 "activitypointer",
 "appointment",
@@ -175,45 +172,40 @@ File.WriteAllBytes(applicationRibbonPath, unzipRibbon(appribResp.CompressedAppli
 "userquery"};
  ```
 
- The following sample shows how to retrieve the ribbon definitions for a set of entities. 
-
-  ```C#
- //Retrieve system Entity Ribbons
-RetrieveEntityRibbonRequest entRibReq = new RetrieveEntityRibbonRequest() { RibbonLocationFilter = RibbonLocationFilters.All };
+The following sample shows how to retrieve the ribbon definitions for a set of entities. 
 
+```csharp
+//Retrieve system Entity Ribbons
+var entRibReq = new RetrieveEntityRibbonRequest() { RibbonLocationFilter = RibbonLocationFilters.All };
 foreach (System.String entityName in entitiesWithRibbons)
 {
  entRibReq.EntityName = entityName;
- RetrieveEntityRibbonResponse entRibResp = (RetrieveEntityRibbonResponse)_serviceProxy.Execute(entRibReq);
+ var entRibResp = (RetrieveEntityRibbonResponse)service.Execute(entRibReq);
 
  System.String entityRibbonPath = Path.GetFullPath(exportFolder + "\\" + entityName + "Ribbon.xml");
  File.WriteAllBytes(entityRibbonPath, unzipRibbon(entRibResp.CompressedEntityXml));
  //Write the path where the file has been saved.
  Console.WriteLine(entityRibbonPath);
 } 
- ``` 
- Any custom entities also support ribbon customizations. To get a list of custom entities, use the <xref:Microsoft.Xrm.Sdk.Messages.RetrieveAllEntitiesRequest> and retrieve the names of custom entities. The following sample shows how to retrieve ribbon definitions for all custom entities.  
+``` 
+Any custom entities also support ribbon customizations. To get a list of custom entities, use the <xref:Microsoft.Xrm.Sdk.Messages.RetrieveAllEntitiesRequest> and retrieve the names of custom entities. The following sample shows how to retrieve ribbon definitions for all custom entities.  
 
-```C#  
+```csharp 
 //Check for custom entities
- RetrieveAllEntitiesRequest raer = new RetrieveAllEntitiesRequest() { EntityFilters = EntityFilters.Entity };
-
- RetrieveAllEntitiesResponse resp = (RetrieveAllEntitiesResponse)_serviceProxy.Execute(raer);
-
+ var raer = new RetrieveAllEntitiesRequest() { EntityFilters = EntityFilters.Entity };
+ var resp = (RetrieveAllEntitiesResponse)service.Execute(raer);
  foreach (EntityMetadata em in resp.EntityMetadata)
  {
   if (em.IsCustomEntity == true && em.IsIntersect == false)
   {
    entRibReq.EntityName = em.LogicalName;
-   RetrieveEntityRibbonResponse entRibResp = (RetrieveEntityRibbonResponse)_serviceProxy.Execute(entRibReq);
-
+   var entRibResp = (RetrieveEntityRibbonResponse)service.Execute(entRibReq);
    System.String entityRibbonPath = Path.GetFullPath(exportFolder + "\\" + em.LogicalName + "Ribbon.xml");
    File.WriteAllBytes(entityRibbonPath, unzipRibbon(entRibResp.CompressedEntityXml));
    //Write the path where the file has been saved.
    Console.WriteLine(entityRibbonPath);
   }
- }
-}  
+ } 
 ``` 
 
 ## Troubleshoot ribbon issues

powerapps-docs/developer/model-driven-apps/open-forms-views-dialogs-reports-url.md

@@ -181,12 +181,12 @@ function openDialogProcess(dialogId, entityName, objectId)
  Two possible values for this parameter are `run` or `filter`. When `run` is used, the report will be displayed using the default filters. When `filter` is used, the report will display a filter that the user can edit before choosing the **Run Report** button to view the report.  
 
  **helpID**  
- This parameter is optional. For reports that are included with Model-driven apps the value in this parameter allows the **Help** button to display appropriate content about this report when **Help on This Page** is chosen. The value should correspond to the report `FileName` attribute value.  
+ This parameter is optional. For reports that are included with model-driven apps the value in this parameter allows the **Help** button to display appropriate content about this report when **Help on This Page** is chosen. The value should correspond to the report `FileName` attribute value.  
 
  **id**  
  This parameter is the report `ReportId` attribute value.  
 
- The following examples show URLs that can be used to open reports in MDA.  
+ The following examples show URLs that can be used to open reports in model-driven apps.  
 
  Open the **Neglected Cases** report using the default filter:  
  ```  

powerapps-docs/developer/model-driven-apps/pass-parameters-url-by-using-ribbon.md

@@ -42,7 +42,7 @@ Ribbon actions are defined in the `<Actions>` element of a `<CommandDefinition>`
 [!INCLUDE[languagecode](../../includes/languagecode.md)]
 
 > [!NOTE]
->  We recommend that you use the entity name instead of the entity type code because the entity type code may be different between MDA installations.  
+>  We recommend that you use the entity name instead of the entity type code because the entity type code may be different between model-driven apps installations.  
   
 ### Example  
  The following sample shows the URL without parameters:  

powerapps-docs/developer/model-driven-apps/query-and-edit-an-organization-theme.md

@@ -96,7 +96,7 @@ OData-Version: 4.0
 |LogoId|String|null|The name of a web resource to use as a logo. Recommended dimensions are a height of 50 pixels and a maximum width of 400 pixels.|  
 |LogoToolTip|String|Model-driven apps|The text that will be used as the tooltip and alt text for the logo.| 
 |MainColor|String|#3B79B7|The Unified Interface primary theme color to be used on main command bar, buttons and tabs.| 
-|Name|String|MDA Default Theme|The name of the Theme entity.|  
+|Name|String|Model-driven apps Default Theme|The name of the Theme entity.|  
 |NavBarBackgroundColor|String|#002050|The primary navigation bar color.|  
 |NavBarShelfColor|String|#DFE2E8|The secondary navigation bar color.|  
 |OverriddenCreatedOn|DateTime|null|Date and time that the record was migrated.|  

powerapps-docs/developer/model-driven-apps/ribbons-available.md

@@ -32,7 +32,7 @@ When you write your change definitions, you will frequently need to reference th
 
 Because of this requirement to reference the definitions of existing ribbon elements, it is very important to understand the current ribbon definitions in your organization. There are two messages you can use to export XML files representing the current state of your ribbons. These definitions include any customizations that have already been applied to your system so that you can customize any custom ribbons that were previously applied. For more information, see [Export Ribbon Definitions](export-ribbon-definitions.md).  
 
-To help you get started, you can download the default ribbon definitions for MDA from [Microsoft Downloads: ExportedRibbonXml.zip](https://download.microsoft.com/download/C/2/A/C2A79C47-DD2D-4938-A595-092CAFF32D6B/ExportedRibbonXml.zip). The ExportedRibbonXml.zip file includes the output files you would have for an organization with a ribbon that has not been customized. You don’t need to run the sample application to export this data. If you have a customized ribbon, you should run the sample application to refresh the files in this folder with any customizations previously applied for your organization.  
+To help you get started, you can download the default ribbon definitions for model-driven apps from [Export Ribbon Definitions sample](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/ExportRibbonDefinitions). `The ExportedRibbonXml` file includes the output files you would have for an organization.  
 
 Within the exported ribbon XML files, the applicationRibbon.xml file includes all the ribbons that are not defined for a specific entity. These correspond to the **Application Ribbons** solution component. For each entity, you will find an *entity name*ribbon.xml file. This corresponds to the `RibbonDiffXml` that is included in each entity. If you want to edit the ribbon for a specific entity, you should locate the ribbon XML file for that entity.  
 
@@ -131,7 +131,7 @@ All entities use a common ribbon definition called the *Entity Ribbon Template*.
 
 <a name="BKMK_BasicHomeTab"></a>   
 ## Basic home tab  
- The basic home tab is displayed on the main application ribbon whenever an alternative tab is not defined because of entity context or a display rule that suppresses it for specific pages. For example, this tab is displayed when you view the MDA**Help**. The Id of the basic home tab is `Mscrm.BasicHomeTab`.  
+ The basic home tab is displayed on the main application ribbon whenever an alternative tab is not defined because of entity context or a display rule that suppresses it for specific pages. For example, this tab is displayed when you view the model-driven apps **Help**. The Id of the basic home tab is `Mscrm.BasicHomeTab`.  
 
 <!-- [!NOTE]-->
 <!-- >  The Jewel that was shown in [!INCLUDE[pn_crm2011_and_online](../../includes/pn-crm2011-and-online.md)] is no longer displayed. Changes to the Jewel will not appear in [!INCLUDE[pn_dynamics_crm_online](../../includes/pn-dynamics-crm-online.md)]  -->
@@ -148,7 +148,7 @@ All entities use a common ribbon definition called the *Entity Ribbon Template*.
 
 <a name="other_ribbons"></a>   
 ## Other ribbons  
- Several other special purpose ribbon tabs and a contextual group are defined by MDA.
+ Several other special purpose ribbon tabs and a contextual group are defined by model-driven apps.
  Each tab is associated with a specific `<TabDisplayRule>` that controls when they will display. The following table lists these tabs.  
 
 

powerapps-docs/developer/model-driven-apps/sample-charts.md

@@ -86,7 +86,7 @@ This topic contains sample charts along with the respective data description and
 
 <a name="BarChart"></a>   
 ## Bar Chart  
- The following is a bar chart that shows the top 10 customers. This is one of the default charts available in MDA for the `Opportunity` entity.  
+ The following is a bar chart that shows the top 10 customers. This is one of the default charts available in model-driven apps for the `Opportunity` entity.  
 
  ![Sample bar chart: Top 10 Customers](media/charts-top-10-customers.gif "Sample bar chart: Top 10 Customers")  
 
@@ -206,7 +206,7 @@ This topic contains sample charts along with the respective data description and
 
 <a name="LineChart"></a>   
 ## Line Chart  
- The following is a line chart that shows the number of leads generated in the last five months. This is one of the default charts available in MDA for the `Lead` entity. 
+ The following is a line chart that shows the number of leads generated in the last five months. This is one of the default charts available in model-driven apps for the `Lead` entity. 
 
 ![Sample line chart: Lead Generation Rate](media/lead-generation-rate-chart.png "Sample line chart: Lead Generation Rate") --> 
 
@@ -263,7 +263,7 @@ This topic contains sample charts along with the respective data description and
 
 <a name="PieChart"></a>   
 ## Pie Chart  
- The following is a pie chart that shows the total number of leads and their importance. This is one of the default charts available in MDA for the `Lead` entity.  
+ The following is a pie chart that shows the total number of leads and their importance. This is one of the default charts available in model-driven apps for the `Lead` entity.  
 
  ![Sample pie chart: Leads by Rating](media/leads-by-source-chart.png "Sample pie chart: Leads by Rating")  
 
@@ -317,7 +317,7 @@ This topic contains sample charts along with the respective data description and
 
 <a name="FunnelChart"></a>   
 ## Funnel Chart  
- The following is a funnel chart that shows the sum of estimated revenue in each stage of the sales pipeline. This is one of the default charts available in MDA for the `Opportunity` entity.  
+ The following is a funnel chart that shows the sum of estimated revenue in each stage of the sales pipeline. This is one of the default charts available in model-driven apps for the `Opportunity` entity.  
 
  ![Sample funnel chart: Sales Pipeline](media/charts-sales-pipeline-chart.png "Sample funnel chart: Sales Pipeline")  
 
@@ -373,7 +373,7 @@ This topic contains sample charts along with the respective data description and
 
 ## Multi-Series Chart  
 
- The following is a multi-series chart that shows the estimated vs. actual revenue closed by month. You can use the chart designer in MDA or methods described in the developer documentation to create these types of charts.  
+ The following is a multi-series chart that shows the estimated vs. actual revenue closed by month. You can use the chart designer in model-driven apps or methods described in the developer documentation to create these types of charts.  
 
  A multi-series chart has multiple `<measurecollection>` elements in the data description, each mapping to the corresponding `<Series>` element in the presentation description XML string.  
 
@@ -452,7 +452,7 @@ This topic contains sample charts along with the respective data description and
 
 <a name="ComparisonChart"></a>   
 ## Comparison Chart (Stacked Chart)  
- The following is a comparison chart that shows the number of activities by type and priority. You can use the chart designer in MDA or methods described in the developer documentation to create these types of charts.  
+ The following is a comparison chart that shows the number of activities by type and priority. You can use the chart designer in model-driven apps or methods described in the developer documentation to create these types of charts.  
 
  A comparison chart has two `groupby` clauses in the data description XML.  
 
@@ -519,7 +519,7 @@ This topic contains sample charts along with the respective data description and
 
 ## Comparison Chart (100% Stacked Chart)  
 
- The following is a comparison chart that shows the number of cases opened on any date, grouped by priority. You can use the chart designer in MDA or methods available in the Web Services to create these types of charts.  
+ The following is a comparison chart that shows the number of cases opened on any date, grouped by priority. You can use the chart designer in model-driven apps or methods available in the Web Services to create these types of charts.  
 
  A comparison chart has two `groupby` clauses in the data description XML.