Skip to content

Commit 3c68edc

Browse files
authored
Merge pull request #6208 from MicrosoftDocs/2612948
Canvas component GA - 2612948
2 parents 16c0b6f + 17b2cc9 commit 3c68edc

File tree

5 files changed

+26
-45
lines changed

5 files changed

+26
-45
lines changed

powerapps-docs/maker/TOC.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1167,7 +1167,7 @@
11671167
href: ./canvas-apps/embed-apps-dev.md
11681168
- name: Develop offline-capable apps
11691169
href: ./canvas-apps/offline-apps.md
1170-
- name: Create a component (preview)
1170+
- name: Create a component
11711171
items:
11721172
- name: Components overview
11731173
href: ./canvas-apps/create-component.md

powerapps-docs/maker/canvas-apps/component-behavior.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,10 @@
11
---
2-
title: Behavior formulas for components (preview)
2+
title: Behavior formulas for components
33
description: Do one or more tasks in canvas app when a component-based action occurs.
44
author: hemantgaur
5-
65
ms.subservice: canvas-developer
76
ms.topic: article
8-
ms.date: 07/01/2020
7+
ms.date: 04/19/2022
98
ms.author: hemantg
109
ms.reviewer: tapanm
1110
search.audienceType:
@@ -17,9 +16,7 @@ contributors:
1716
- tapanm-msft
1817
---
1918

20-
# Behavior formulas for components (preview)
21-
22-
[This article is pre-release documentation and is subject to change.]
19+
# Behavior formulas for components
2320

2421
Specify one or more [behavior formulas](working-with-formulas-in-depth.md) that run when an event triggers a change in component instances.
2522

powerapps-docs/maker/canvas-apps/component-library.md

Lines changed: 15 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,10 @@
11
---
2-
title: Component library (preview)
2+
title: Component library
33
description: Learn about working with a library of reusable components for canvas apps.
44
author: hemantgaur
5-
65
ms.subservice: canvas-developer
76
ms.topic: article
8-
ms.date: 11/03/2021
7+
ms.date: 04/19/2022
98
ms.author: hemantg
109
ms.reviewer: tapanm
1110
search.audienceType:
@@ -17,9 +16,7 @@ contributors:
1716
- tapanm-msft
1817
---
1918

20-
# Component library (preview)
21-
22-
[This article is pre-release documentation and is subject to change.]
19+
# Component library
2320

2421
In the [overview](create-component.md) article for creating components, you are introduced to components inside canvas app. As you create components inside an app, you can also create a library of components that can be reused. By creating a component library, app makers easily share and update one or more components with other makers.
2522

@@ -47,15 +44,15 @@ You can preview component library components using the screens inside the librar
4744
4845
## Working with component library
4946

50-
You can create a new component library or edit an existing component library from the same interface. Browse to [make.powerapps.com](https://make.powerapps.com), select **Apps**, and then select **Component Libraries**:
47+
You can create a new component library or edit an existing component library from the same interface. Go to [Power Apps](https://make.powerapps.com), select **Apps**, and then select **Component Libraries**:
5148

5249
![Create or edit component library.](./media/component-library/create-edit-component-library.png "Create or edit component library")
5350

5451
## Create an example component library
5552

5653
The steps to create components inside a component library are the same as creating components inside an app. You'll create a component library and then reuse the steps for creating components from [components overview example](create-component.md#create-an-example-component). Then you'll use the component library to provide the reusable components in a new app.
5754

58-
1. Sign in to [make.powerapps.com](https://make.powerapps.com).
55+
1. Sign in to [Power Apps](https://make.powerapps.com).
5956

6057
1. Select **Apps** in the left navigation, select **Component Libraries**, and then select **New component library**.
6158

@@ -153,27 +150,26 @@ The following animation shows the process to get the latest components.
153150

154151
![Steps to get the latest components](./media/component-library/get-latest-components.gif "Steps to get the latest components")
155152

153+
### Update component library in a consuming app
154+
155+
If you import a component from a component library, you can't edit it inside the consuming app. If you select **Edit component**, you'll see an option to create a copy of the component inside the current app for you to make changes:
156+
157+
![Edit library component.](./media/component-library/edit-library-component.png "Edit library component")
158+
159+
If you select **Create a copy**, the component is copied to the local app. The local copy of the component appears under the **Custom** category in the **Insert** pane. This local copy of the component won't receive updates if a new version of the originating component library is published later.
160+
161+
156162
## Component library permissions
157163

158164
Sharing a component library works the same way you share a canvas app. When you share a component library, you allow others to reuse the component library. Once shared, others can edit the component library and import components from this shared component library for creating and editing apps. If shared as a co-owner, a user can use, edit, and share a component library but not delete or change the owner.
159165

160166
## Known limitations
161167

162168
- [Known limitations](create-component.md#known-limitations) applicable to components also applies to component libraries.
163-
- You can't import components using a component library from locally saved component library files. If you try to import a locally saved component library using **File** > **Save As** > **This Computer** and download the component library file as an app, following error message appears:
169+
- You can't import components from a locally saved component library. It's possible to save a component library using **File** > **Save As** > **This Computer**. But if you try to import such saved component library, you'll see the following error message:
164170

165171
![Import component library file.](./media/component-library/import-component-library-file.png "Import component library file")
166172

167-
- You can't add existing component libraries to a [solution](add-app-solution.md). However, you can create new component libraries for solutions using add component library flow.
168-
169-
- If you import a component from a component library, you can't edit it inside the consuming app. If you select **Edit component**, you'll see an option to create a copy of the component inside the current app for you to make changes:
170-
171-
![Edit library component.](./media/component-library/edit-library-component.png "Edit library component")
172-
173-
If you select **Create a copy**, the component is copied to the local app. The local copy of the component appears under the **Custom** category in the **Insert** pane. This local copy of the component won't receive updates if a new version of the originating component library is published later.
174-
175-
- When a component is added to an app from the component library and the theme of the app is updated, the component becomes a local app component and is no longer associated with the master component in the component library.
176-
177173
## Next steps
178174

179175
Learn [behavior formulas](component-behavior.md) for canvas apps.

powerapps-docs/maker/canvas-apps/create-component.md

Lines changed: 4 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,10 @@
11
---
2-
title: Create a component for canvas apps (preview) (contains video)
2+
title: Create a component for canvas apps (contains video)
33
description: Learn about how to create reusable components for canvas apps.
44
author: hemantgaur
5-
65
ms.subservice: canvas-developer
76
ms.topic: article
8-
ms.date: 02/11/2022
7+
ms.date: 04/19/2022
98
ms.author: hemantg
109
ms.reviewer: tapanm
1110
search.audienceType:
@@ -19,13 +18,7 @@ contributors:
1918
ms.custom: intro-internal
2019
---
2120

22-
# Create a component for canvas apps (preview)
23-
24-
[This article is pre-release documentation and is subject to change.]
25-
26-
> [!IMPORTANT]
27-
> - This is a preview feature.
28-
> - [!INCLUDE[cc_preview_features_definition](../../includes/cc-preview-features-definition.md)] More information: [Understand experimental, preview, and retired features in Power Apps](working-with-experimental-preview.md)
21+
# Create a component for canvas apps
2922

3023
Components are reusable building blocks for canvas apps so that app makers can create custom controls to use inside an app, or across apps using a [component library](component-library.md). Components can use advanced features such as custom properties and enable complex capabilities. This article introduces component concepts and some examples.
3124

@@ -272,10 +265,8 @@ Once you save the app, you can reuse the components of this app using the same m
272265
273266
- Adding and running Power Automate flows in component libraries is not supported.
274267
- You can't save data sources, forms, and data tables with components.
275-
- Collections in components aren't supported.
276268
- You can't insert a component into a gallery or a form (including SharePoint form).
277-
- A master instance of a component is a local master and scoped to the app. If you change a master instance, only copies of the component within the app will reflect the change. Copies in other apps will remain the same unless you import the component library again. All master instances in those apps will be automatically detected and updated.
278-
- You can't package media files when you import a component.
269+
- If a component that you imported from another app is modified in the original app, you must manually import the component again in the consuming app to receive latest component changes. Use component libraries instead to work with [component updates](component-library.md#update-a-component-library) more efficiently.
279270
- Components don't support the [**UpdateContext**](./functions/function-updatecontext.md) function, but you can create and update variables in a component by using the [**Set**](functions/function-set.md) function. The scope of these variables is limited to the component, but you can access them from outside the component through custom output properties.
280271
281272
## Next steps

powerapps-docs/maker/canvas-apps/map-component-input-fields.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,10 @@
11
---
2-
title: Map input fields of a component (preview)
2+
title: Map input fields of a component
33
description: Learn about how to map input fields of a component to the table or record.
44
author: hemantgaur
5-
65
ms.subservice: canvas-developer
76
ms.topic: article
8-
ms.date: 01/10/2022
7+
ms.date: 04/19/2022
98
ms.author: hemantg
109
ms.reviewer: tapanm
1110
search.audienceType:
@@ -18,9 +17,7 @@ contributors:
1817
- gregli-msft
1918
---
2019

21-
# Map input fields of a component (preview)
22-
23-
[This article is pre-release documentation and is subject to change.]
20+
# Map input fields of a component
2421

2522
A component can receive input values to emit or process data using custom input properties. In this article, you'll learn about working with such components expecting one or more input properties with a specific schema for the given table or record, and how to map the component input fields to the columns of the data source.
2623

0 commit comments

Comments
 (0)