Skip to content

Commit be9619d

Browse files
committed
Merging changes synced from https://github.com/MicrosoftDocs/powerapps-docs-pr (branch live)
2 parents 757b246 + 8329a52 commit be9619d

File tree

9 files changed

+28
-58
lines changed

9 files changed

+28
-58
lines changed

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

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to create side panes in model-driven apps by using a clie
44
author: HemantGaur
55
ms.author: hemantg
66
manager: evchaki
7-
ms.date: 04/01/2022
7+
ms.date: 04/04/2022
88
ms.reviewer: jdaly
99
ms.subservice: mda-developer
1010
ms.topic: "article"
@@ -19,20 +19,14 @@ contributors:
1919
- caburk
2020
---
2121

22-
# Creating side panes by using a client API (preview)
23-
24-
[!INCLUDE [cc-beta-prerelease-disclaimer](../../../includes/cc-beta-prerelease-disclaimer.md)]
22+
# Creating side panes by using a client API
2523

2624
Developers can create and manage app side panes within a model-driven app by using the [Xrm.App.sidePanes](reference/xrm-app-sidepanes.md) API, which represents the collection of side panes. Calling the [createPane](reference/Xrm-App/Xrm-App-sidePanes/createPane.md) method adds a new pane that allows navigation to any model-driven app form or custom page. Pages displayed in the side pane must fit within the minimum width of 300 pixels and resize to larger widths based on the pane width.
2725

2826
Tabs are listed in the side pane in two groups—non-closable and closable. Within each group, the tabs are listed in the order they were created in. The top group contains the panes that a user can't close, and the bottom group has user-closable panes. The non-closable group is populated when the app is opened, whereas the closable group is added based on user actions within the app.
2927

3028
You can use a platform-provided header with the title and Close button, or you can use a custom header.
3129

32-
> [!IMPORTANT]
33-
> - This is a preview feature, and isn't available in all regions.
34-
> - [!INCLUDE[cc_preview_features_definition](../../../includes/cc-preview-features-definition.md)]
35-
3630
You can add a badge to the side pane to indicate to the user that a change needs attention. The badge supports three modes: a simple dot, a count, or an image. By default, the badge is cleared when the user switches to the pane. You can control when the badge is cleared.
3731

3832

powerapps-docs/developer/model-driven-apps/clientapi/reference/Xrm-App/Xrm-App-sidePanes/createPane.md

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Includes description and supported parameters for the createPane me
44
ms.author: jdaly
55
author: adrianorth
66
manager: kvivek
7-
ms.date: 03/12/2022
7+
ms.date: 04/04/2022
88
ms.reviewer: jdaly
99
ms.topic: "reference"
1010
search.audienceType:
@@ -17,14 +17,8 @@ contributors:
1717
---
1818
# createPane (Client API reference)
1919

20-
[!INCLUDE[cc-beta-prerelease-disclaimer](../../../../../../includes/cc-beta-prerelease-disclaimer.md)]
21-
2220
Provides all the information to create side panes.
2321

24-
> [!IMPORTANT]
25-
> - This is a preview feature, and isn't available in all regions.
26-
> - [!INCLUDE[cc-preview-features-definition](../../../../../../includes/cc-preview-features-definition.md)]
27-
2822
## Syntax
2923

3024
`Xrm.App.sidePanes.createPane(paneOptions);`

powerapps-docs/developer/model-driven-apps/clientapi/reference/Xrm-App/Xrm-App-sidePanes/getAllPanes.md

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Includes description and supported parameters for the getAllPanes m
44
ms.author: jdaly
55
author: adrianorth
66
manager: kvivek
7-
ms.date: 03/12/2022
7+
ms.date: 04/04/2022
88
ms.reviewer: jdaly
99
ms.topic: "reference"
1010
search.audienceType:
@@ -17,14 +17,8 @@ contributors:
1717
---
1818
# getAllPanes (Client API reference)
1919

20-
[!INCLUDE[cc-beta-prerelease-disclaimer](../../../../../../includes/cc-beta-prerelease-disclaimer.md)]
21-
2220
Returns a collection containing all active panes.
2321

24-
> [!IMPORTANT]
25-
> - This is a preview feature, and isn't available in all regions.
26-
> - [!INCLUDE[cc-preview-features-definition](../../../../../../includes/cc-preview-features-definition.md)]
27-
2822
## Syntax
2923

3024
`Xrm.App.sidePanes.getAllPanes();`

powerapps-docs/developer/model-driven-apps/clientapi/reference/Xrm-App/Xrm-App-sidePanes/getPane.md

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Includes description and supported parameters for the getPane metho
44
ms.author: jdaly
55
author: adrianorth
66
manager: kvivek
7-
ms.date: 03/12/2022
7+
ms.date: 04/04/2022
88
ms.reviewer: jdaly
99
ms.topic: "reference"
1010
search.audienceType:
@@ -17,14 +17,8 @@ contributors:
1717
---
1818
# getPane (Client API reference)
1919

20-
[!INCLUDE[cc-beta-prerelease-disclaimer](../../../../../../includes/cc-beta-prerelease-disclaimer.md)]
21-
2220
Returns the side pane corresponding to the input ID. If the side pane does not exist, undefined is returned.
2321

24-
> [!IMPORTANT]
25-
> - This is a preview feature, and isn't available in all regions.
26-
> - [!INCLUDE[cc-preview-features-definition](../../../../../../includes/cc-preview-features-definition.md)]
27-
2822
## Syntax
2923

3024
`Xrm.App.sidePanes.getPane(panelId);`

powerapps-docs/developer/model-driven-apps/clientapi/reference/Xrm-App/Xrm-App-sidePanes/getSelectedPane.md

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Includes description and supported parameters for the getSelectedPa
44
ms.author: jdaly
55
author: adrianorth
66
manager: kvivek
7-
ms.date: 03/12/2022
7+
ms.date: 04/04/2022
88
ms.reviewer: jdaly
99
ms.topic: "reference"
1010
search.audienceType:
@@ -17,15 +17,8 @@ contributors:
1717
---
1818
# getSelectedPane (Client API reference)
1919

20-
[!INCLUDE[cc-beta-prerelease-disclaimer](../../../../../../includes/cc-beta-prerelease-disclaimer.md)]
21-
2220
Returns the currently selected pane.
2321

24-
> [!IMPORTANT]
25-
> - This is a preview feature, and isn't available in all regions.
26-
> - [!INCLUDE[cc-preview-features-definition](../../../../../../includes/cc-preview-features-definition.md)]
27-
28-
2922
## Syntax
3023

3124
`Xrm.App.sidePanes.getSelectedPane();`

powerapps-docs/developer/model-driven-apps/clientapi/reference/xrm-app-appsidepane.md

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Includes description and supported parameters for the AppSidePane m
44
ms.author: jdaly
55
author: adrianorth
66
manager: kvivek
7-
ms.date: 03/12/2022
7+
ms.date: 04/04/2022
88
ms.reviewer: jdaly
99
ms.topic: "reference"
1010
search.audienceType:
@@ -17,14 +17,8 @@ contributors:
1717
---
1818
# AppSidePane (Client API reference)
1919

20-
[!INCLUDE[cc-beta-prerelease-disclaimer](../../../../includes/cc-beta-prerelease-disclaimer.md)]
21-
2220
Provides methods for managing a single side pane.
2321

24-
> [!IMPORTANT]
25-
> - This is a preview feature, and isn't available in all regions.
26-
> - [!INCLUDE[cc-preview-features-definition](../../../../includes/cc-preview-features-definition.md)]
27-
2822
## Methods
2923

3024
|Methods|Description|

powerapps-docs/developer/model-driven-apps/clientapi/reference/xrm-app-sidepanes.md

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Includes description and supported parameters for the sidePanes met
44
ms.author: jdaly
55
author: adrianorth
66
manager: kvivek
7-
ms.date: 03/12/2022
7+
ms.date: 04/04/2022
88
ms.reviewer: jdaly
99
ms.topic: "reference"
1010
search.audienceType:
@@ -17,14 +17,8 @@ contributors:
1717
---
1818
# sidePanes (Client API reference)
1919

20-
[!INCLUDE[cc-beta-prerelease-disclaimer](../../../../includes/cc-beta-prerelease-disclaimer.md)]
21-
2220
Provides methods for managing side panes.
2321

24-
> [!IMPORTANT]
25-
> - This is a preview feature, and isn't available in all regions.
26-
> - [!INCLUDE[cc-preview-features-definition](../../../../includes/cc-preview-features-definition.md)]
27-
2822
## Methods
2923

3024
|Methods|Description|

powerapps-docs/maker/model-driven-apps/create-remove-pages.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,7 @@
22
title: "Create and remove pages in model-driven apps | MicrosoftDocs"
33
description: Learn how to Create and remove pages in model-driven apps.
44
ms.custom: ""
5-
ms.date: 10/07/2021
6-
5+
ms.date: 03/30/2022
76
ms.suite: ""
87
ms.tgt_pltfrm: ""
98
ms.topic: "get-started-article"
@@ -32,7 +31,10 @@ App designer pages are containers for one or more tables or dashboards. You can
3231

3332
To create a page follow these steps:
3433
1. Select **New page** in the app designer.
35-
1. Select the page type of either **Table based view and form** or **Dashboard**, and then select **Next**.
34+
1. Select the page type, and then select **Next**:
35+
- **Table based view and form**: Display records of a standard or custom table in a full-page list view. Creating a data view page also adds an associated form page for viewing and editing data on a selected record. More information: [Tables in Dataverse](../data-platform/entity-overview.md)
36+
- **Dashboard**: Display charts and tables from multiple entities to visualize data on a single page. Select one or more system, interactive, or Power BI dashboards. More information: [Create or edit model-driven app dashboards](create-edit-dashboards.md)
37+
- **Custom**: Design and build a page that's based on a canvas app. More information: [Overview of custom pages for model-driven apps](model-app-page-overview.md)
3638
1. If you don't want your page to appear in the app's site map, clear the **Show in navigation** option.
3739
:::image type="content" source="media/add-table-view-and-form-pages.png" alt-text="Add table view and form pages":::
3840
1. Select the components you want.

powerapps-docs/maker/model-driven-apps/custom-connectors-timeline-control.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Use custom connectors with the timeline in Power Apps | MicrosoftDocs
33
description: "Learn how to use custom connectors to bring your own data, such as records, to the timeline in Power Apps."
44
ms.custom: ""
5-
ms.date: 11/2/2021
5+
ms.date: 04/04/2022
66
ms.reviewer: "matp"
77

88
ms.suite: ""
@@ -23,7 +23,7 @@ search.app:
2323

2424
# Use custom connectors with the timeline control
2525

26-
Custom connectors is a feature that provides a way for developers to surface information such as Dataverse table rows, external data sources, and so forth, as records entries within the TimelineWallControl component. It allows for a broader set of scenarios in addition to the existing out-of-box notes, posts, and activities.
26+
The custom connectors feature provides a way for developers to surface information such as Dataverse table rows, external data sources, and so forth, as records entries within the TimelineWallControl component. It allows for a broader set of scenarios in addition to the existing out-of-box notes, posts, and activities.
2727

2828
For information about configuring and using the timeline, see the following topics:
2929

@@ -44,13 +44,24 @@ Records that are configured within custom connectors are a JavaScript web resour
4444

4545
TimelineWallControl is expected to load the JavaScript web resource and then create the instance of IRecordSource from the configured constructor.
4646

47-
The IRecordSource is then initialized (init), with a request for pages of records (getRecordsData), and a request for the UX representation of a single record (getRecordUX).
47+
The IRecordSource is then initialized (init), with a request for pages of records (getRecordsData), request for filter details (getFilterDetails), and a request for the UX representation of a single record (getRecordUX).
4848

4949
The response from requesting records is persisted to minimize the number of record requests that occur within multi-session scenarios.
5050

51+
## Filter support
52+
53+
Custom connector filter support includes the following abilities.
54+
55+
- Add new filter type to existing filter group
56+
- Add new filter group
57+
- Update the existing filter type count
58+
- Filter on search key
59+
60+
Custom connectors must use UserSettings Timezone information from context passed in init() to be consistent with timeline rendering.
61+
5162
## Scope
5263

53-
Custom connectors is supported within single-session and multi-session table forms in Unified Interface client model apps.
64+
The custom connectors feature is supported within single-session and multi-session table forms in Unified Interface client model apps.
5465

5566
### Out of scope
5667
The following functionality isn't available for the custom connectors feature:

0 commit comments

Comments
 (0)