Skip to content

Commit d27b7a6

Browse files
authored
Merge pull request #3593 from MicrosoftDocs/Nava_updates
Adding new methods
2 parents a461df8 + 3fa474a commit d27b7a6

File tree

3 files changed

+29
-12
lines changed

3 files changed

+29
-12
lines changed

powerapps-docs/developer/model-driven-apps/define-custom-actions-modify-ribbon.md

Lines changed: 23 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Define custom actions to modify the ribbon (model-driven apps) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces"
33
description: "Learn about defining custom actions to modify the ribbon." # 115-145 characters including spaces. This abstract displays in the search result."
44
keywords: ""
5-
ms.date: 10/31/2018
5+
ms.date: 10/13/2020
66
ms.service: powerapps
77
ms.topic: article
88
ms.assetid: 72544b02-4eed-4d70-666e-a0d880f526af
@@ -19,8 +19,6 @@ search.app:
1919

2020
# Define custom actions to modify the ribbon
2121

22-
<!-- https://docs.microsoft.com/dynamics365/customer-engagement/developer/customize-dev/define-custom-actions-modify-ribbon -->
23-
2422
The default, an application command bar or ribbon is defined by Common Data Service metadata. This default data can’t be changed, but you can include definitions of specific actions that will override the default ribbon.
2523

2624
## Types of custom actions
@@ -49,18 +47,36 @@ The default, an application command bar or ribbon is defined by Common Data Serv
4947
### Hide custom actions
5048

5149
A `<HideCustomAction>` is a statement that you use when you want to remove an existing ribbon element so that it is not rendered. This does not hide the ribbon element, it actually removes the ribbon element at runtime so that it doesn’t exist in the ribbon.
50+
51+
The **HideActionId** element provides a unique ID for the action. For consistency and readability, you should follow the same naming convention described for `<CustomAction>` elements. The **Location** attribute must match the Id of the ribbon element you want to remove.
5252

5353
> [!NOTE]
5454
> Because the `HideCustomAction` element removes a specified node from the ribbon, removing ribbon elements in this manner may not be the best option for every situation.
5555
>
5656
> - If you want to remove a button that is associated with a specific privilege, you should adjust the privileges for the entity in the security roles in your implementation. This will allow the default ribbon display and enables rules to hide or disable ribbon elements from users who do not have the necessary privileges to perform those actions.
5757
> - If you want to replace an existing ribbon element with a custom ribbon element, you can overwrite that element by specifying a `CustomAction.Location` value identical to the existing element.
58+
> - To remove the `HideCustomAction` element you need to create a new updated version of the same solution that installed the `HideCustomAction` element. A new patch of the solution cannot remove the `HideCustomAction` element.
59+
60+
The `HideCustomAction` element cannot be removed, once added, except by creating a new updated solution. Instead, ribbon buttons should be hidden using a `DisplayRule` element that always evaluate to false. Having both `Mscrm.HideOnModern` and `Mscrm.ShowOnlyOnModern` would always evaluate to false. For example, to hide a deactivate button:
61+
62+
```xml
63+
<CommandDefinition Id="Mscrm.HomepageGrid.Deactivate">
64+
<EnableRules>
65+
</EnableRules>
66+
<DisplayRules>
67+
<DisplayRule Id="Mscrm.HideOnModern" />
68+
<DisplayRule Id="Mscrm.ShowOnlyOnModern" />
69+
</DisplayRules>
70+
<Actions>
71+
</Actions>
72+
</CommandDefinition>
73+
```
5874

59-
The **HideActionId** element provides a unique ID for the action. For consistency and readability, you should follow the same naming convention described for `<CustomAction>` elements. The **Location** attribute must match the Id of the ribbon element you want to remove.
75+
6076

6177
### See also
6278

63-
[Customize commands and the ribbon](customize-commands-ribbon.md)
64-
[Pass data from a page as a parameter to Ribbon actions](/dynamics365/customerengagement/on-premises/developer/customize-dev/pass-dynamics-365-data-page-parameter-ribbon-actions
79+
[Customize commands and the ribbon](customize-commands-ribbon.md)
80+
[Pass data from a page as a parameter to Ribbon actions](/dynamics365/customerengagement/on-premises/developer/customize-dev/pass-dynamics-365-data-page-parameter-ribbon-actions
6581
)<br/>
66-
[Define scaling for Ribbon elements](define-scaling-ribbon-elements.md)
82+
[Define scaling for Ribbon elements](define-scaling-ribbon-elements.md)

powerapps-docs/maker/canvas-apps/functions/function-ismatch.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,7 @@ Predefined patterns provide a simple way to match either one of a set of charact
9797
| **Period** |Matches a period or dot ("."). |`\.` |
9898
| **RightParen** |Matches a right parenthesis ")". |`\)` |
9999
| **Space** |Matches a character that adds whitespace. |`\s` |
100+
|**Tab**|Matches a tab character.|`\t`|
100101

101102
For example, the pattern **"A" & MultipleDigits** will match the letter "A" followed by one or more digits.
102103

powerapps-docs/maker/canvas-apps/functions/function-param.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -93,15 +93,15 @@ Use the *LaunchTarget* argument to specify the target browser window in which to
9393
9494
| LaunchTarget&nbsp;enum | Description |
9595
| --- | --- |
96-
| **Blank** | The webpage or app is opened in a new window or tab. |
97-
| **Self** | The webpage or app replaces the current window or tab. |
96+
| **New** | The webpage or app is opened in a new window or tab. |
97+
| **Replace** | The webpage or app replaces the current window or tab. |
9898
| *name* | Instead of an enum value, use your own text string to *name* the window or tab. *Self* is an internal only name that is only used by the **Launch** function. It has no impact on nor will it match the title of the window that your users see. If a window or tab with the given *name* already exists, its contents will be replaced. Otherwise, a new window or tab will be created. *name* can't begin with the underscore character "_". |
9999
100-
**Blank** is the default enum when running in a web browser with **Self** and *name* as available options. In a mobile player, **Blank** is the default for webpages with *name* as an available option; while the current canvas app will always be replaced by another canvas app.
100+
**New** is the default enum when running in a web browser with **Replace** and *name* as available options. In a mobile player, **New** is the default for webpages with *name* as an available option; while the current canvas app will always be replaced by another canvas app.
101101
102102
> [!NOTE]
103-
> - Using a *LaunchTarget* with any value other than **Blank** in embedded scenarios (for example, Power BI or SharePoint) is not supported and may result in unexpected behavior. In the future, this behavior may change, or may cause an error.
104-
> - *LaunchTarget* enum names are in transition. You may use **Blank** and **Self** currently, though these names will change in the future. **Self** will go through an intermediate change to **'Self'** as a new **Self** keyword is introduced. To avoid this conflict, the expected names may be **New** and **Replace**. Your app will automatically update when these changes occur. Your formulas won't need an update manually.
103+
> - Using a *LaunchTarget* with any value other than **New** in embedded scenarios (for example, Power BI or SharePoint) is not supported and may result in unexpected behavior. In the future, this behavior may change, or may cause an error.
104+
<!-- *LaunchTarget* enum names are in transition. You may use **Blank** and **Self** currently, though these names will change in the future. **Self** will go through an intermediate change to **'Self'** as a new **Self** keyword is introduced. To avoid this conflict, the expected names may be **New** and **Replace**. Your app will automatically update when these changes occur. Your formulas won't need an update manually.-->
105105
106106
### Security zones
107107

0 commit comments

Comments
 (0)