Skip to content

Commit 5ed016e

Browse files
committed
Merge branch 'master' into 2349764
2 parents 822d0fd + 87770f7 commit 5ed016e

File tree

1,185 files changed

+14708
-6631
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,185 files changed

+14708
-6631
lines changed

powerapps-docs/chatbots.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.reviewer: mvakoc
1313

1414
Power Virtual Agents allows you to quickly create and maintain intelligent chatbots using a no-code interface. App makers can create and manage their chatbots directly from [Power Apps](https://make.powerapps.com).
1515

16-
![Chatbots from Power Apps](media/chatbots.png "Chatbots from Power Apps")
16+
![Chatbots from Power Apps.](media/chatbots.png "Chatbots from Power Apps")
1717

1818
You can create and manage your chatbots using the **Chatbots** option in the left navigation pane.
1919

powerapps-docs/developer/component-framework/add-custom-controls-to-a-field-or-entity.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Code components let you transform columns that traditionally contain text into v
1919
[!INCLUDE[cc-terminology](../data-platform/includes/cc-terminology.md)]
2020

2121
> [!div class="mx-imgBorder"]
22-
> ![Custom slider control](../../maker/model-driven-apps/media/slider-control.PNG "Custom slider control ")
22+
> ![Custom slider control.](../../maker/model-driven-apps/media/slider-control.PNG "Custom slider control ")
2323
2424
## Add a code component to a column
2525

@@ -36,7 +36,7 @@ Following the steps below will change the default label and text box column of t
3636
5. On the Add Control page, select the component that you want, such as the **Linear Slider** component, and then select **Add**.
3737

3838
> [!div class="mx-imgBorder"]
39-
> ![Add linear slider control](../../maker/model-driven-apps/media/add-slider.PNG "Add linear slider control")
39+
> ![Add linear slider control.](../../maker/model-driven-apps/media/add-slider.PNG "Add linear slider control")
4040
4141
6. Choose the client where you want the component to appear.
4242

@@ -47,12 +47,12 @@ Following the steps below will change the default label and text box column of t
4747
- **Tablet**. To make the code component available on tablet devices running Dynamics 365 for tablets, select the Tablet option next to the component.
4848

4949
> [!div class="mx-imgBorder"]
50-
> ![Choose the client apps to view the custom control](../../maker/model-driven-apps/media/choose-client.png "Choose the client apps to view the custom control")
50+
> ![Choose the client apps to view the custom control.](../../maker/model-driven-apps/media/choose-client.png "Choose the client apps to view the custom control")
5151
5252
7. Select the pencil icon next to **Min**, **Max**, and **Step**, set the property option, and then select **OK**.
5353

5454
> [!div class="mx-imgBorder"]
55-
> ![Add custom control properties](../../maker/model-driven-apps/media/ccf-add-properties.png "Add custom control properties")
55+
> ![Add custom control properties.](../../maker/model-driven-apps/media/ccf-add-properties.png "Add custom control properties")
5656
5757
- **Min**. Set the minimum accepted value. You can bind a static value that you enter or bind the value to an existing column. In this example **Bind to static value** is **Currency** and the minimum value that can be entered is *zero*.
5858

@@ -88,7 +88,7 @@ To add a code component like dataset component or simple table component to a gr
8888
Open a record that includes the column with the code component, such as the Opportunity form from the previous example, and view how the column is changed. The column is now rendered as a slider component instead of the text column.
8989

9090
> [!div class="mx-imgBorder"]
91-
> ![Slider control rendered on form](../../maker/model-driven-apps/media/slider-control.PNG "Slider control rendered on form")
91+
> ![Slider control rendered on form.](../../maker/model-driven-apps/media/slider-control.PNG "Slider control rendered on form")
9292
9393
### See also
9494

powerapps-docs/developer/component-framework/code-components-alm.md

Lines changed: 322 additions & 0 deletions
Large diffs are not rendered by default.

powerapps-docs/developer/component-framework/code-components-best-practices.md

Lines changed: 285 additions & 0 deletions
Large diffs are not rendered by default.

powerapps-docs/developer/component-framework/code-components-model-driven-apps.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,10 +31,10 @@ The [create your first code component](implementing-controls-using-typescript.md
3131
To add code components to a column or a table in model-driven apps, see [Add code components to model-driven apps](add-custom-controls-to-a-field-or-entity.md).
3232

3333
> [!div class="mx-imgBorder"]
34-
> ![Add linear slider control](../../maker/model-driven-apps/media/add-slider.PNG "Add linear slider control")
34+
> ![Add linear slider control.](../../maker/model-driven-apps/media/add-slider.PNG "Add linear slider control")
3535
3636
> [!div class="mx-imgBorder"]
37-
> ![Data Set Grid component](media/add-dataset-component.png "Data Set Grid component")
37+
> ![Data Set Grid component.](media/add-dataset-component.png "Data Set Grid component")
3838
3939
## Update existing code components
4040

powerapps-docs/developer/component-framework/community-resources.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,6 @@ ms.topic: "article"
1414

1515
# Community resources for Power Apps component framework
1616

17-
[!INCLUDE[cc-terminology](../data-platform/includes/cc-terminology.md)]
18-
1917
The following is a list of some community resources created by the Power Apps community that you can use to create code components in model-driven and canvas apps using Power Apps component framework and Microsoft Power Platform CLI.
2018

2119
> [!NOTE]
@@ -31,7 +29,7 @@ Make sure that you review the licensing terms and the source code before you dow
3129
> Code component run in the context of the end user who is using the component and can perform any action that may include accessing, capturing, and modifying the data.
3230
3331
> [!div class="mx-imgBorder"]
34-
> ![Component gallery](media/pcf-gallery.PNG "Components gallery")
32+
> ![Component gallery.](media/pcf-gallery.PNG "Components gallery")
3533
3634
## Videos
3735

@@ -85,12 +83,12 @@ There are two versions of the code component builder. Both of them are called **
8583
[PCF Builder for XrmToolBox](https://www.xrmtoolbox.com/plugins/Maverick.PCF.Builder/) provides a graphical user interface that lets you create code components in visual manner using Microsoft Power Platform CLI.
8684

8785
> [!div class="mx-imgBorder"]
88-
> ![Component Builder in XrmToolBox](media/pcf-builder-xrmtoolbox.png "Component Builder in XrmToolBox")
86+
> ![Component Builder in XrmToolBox.](media/pcf-builder-xrmtoolbox.png "Component Builder in XrmToolBox")
8987
9088
[PCF Builder extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=danish-naglekar.pcf-builder) provides a guided experience that not only lets you create code components but you can preview code component inside of Visual Studio Code.
9189

9290
> [!div class="mx-imgBorder"]
93-
> ![Component Builder in VS Code](media/pcf-builder-vscode.png "Component Builder in Visual Studio Code")
91+
> ![Component Builder in VS Code.](media/pcf-builder-vscode.png "Component Builder in Visual Studio Code")
9492
9593

9694
[!INCLUDE[footer-include](../../includes/footer-banner.md)]

powerapps-docs/developer/component-framework/component-framework-for-canvas-apps.md

Lines changed: 44 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -15,117 +15,113 @@ ms.assetid: 5d100dc3-bd82-4b45-964c-d90eaebc0735
1515

1616
# Code components for canvas apps
1717

18-
Power Apps component framework enables app makers to create code components that can be used in their canvas apps. More information: [Power Apps component framework overview](overview.md)
18+
App makers can use Power Apps component framework to create code components that can be used in their canvas apps. More information: [Power Apps component framework overview](overview.md)
1919

20-
Power Apps component framework enables professional developers to create, import, and add code components to canvas applications using [Microsoft Power Platform CLI](get-powerapps-cli.md). Certain APIs may not be available in canvas Apps. We recommend you check each API to determine where it is available.
20+
Professional developers can use Power Apps component framework to create, import, and add code components to canvas apps by using [Microsoft Power Platform CLI](get-powerapps-cli.md). Certain APIs might not be available in canvas apps. We recommend that you check each API to determine where it's available.
2121

2222
## Security considerations
2323

2424
> [!WARNING]
2525
> Code components contain code that may not be generated by Microsoft and can potentially access security tokens and data when rendered in Power Apps Studio. When adding code components to a canvas app, make sure that the code component solutions are from a trusted source. This vulnerability does not exist when playing the canvas app.
2626
27-
When you open a canvas app in Power Apps Studio that contains code components, a dialog shows a warning message about potentially unsafe code. Code components in the Power Apps Studio environment have access to security tokens and hence only components from the trusted sources should be opened. Administrators and system customizers should review and validate all the code components before importing those components in an environment and making them available for makers to use in their apps. The `Default` publisher is shown when you import code components using an unmanaged solution or when you have used `pac pcf push` to install your code component.
27+
When you open a canvas app that contains code components in Power Apps Studio, a warning message about potentially unsafe code appears. Code components in the Power Apps Studio environment have access to security tokens; hence only components from trusted sources should be opened. Administrators and system customizers should review and validate all code components before importing those components in an environment and making them available for makers to use in their apps. The `Default` publisher is shown when you import code components by using an unmanaged solution or when you have used `pac pcf push` to install your code component.
2828

29-
![Safety warning](media/canvas-app-safety-warning.png "Safety warning")
29+
![Safety warning.](media/canvas-app-safety-warning.png "Safety warning")
3030

3131
## Prerequisites
3232

33-
1. A Power Apps license is required. More information: [Power Apps component framework licensing](overview.md#licensing)
34-
2. System administrator privileges are required to enable the Power Apps component feature in the environment.
33+
- A Power Apps license is required. More information: [Power Apps component framework licensing](overview.md#licensing)
34+
- System administrator privileges are required to enable the Power Apps component framework feature in the environment.
3535

36-
## Enable Power Apps component framework feature
36+
## Enable the Power Apps component framework feature
3737

38-
To add code components to an app, you need to enable the Power Apps component framework feature in each environment where you want to use them. By default Power Apps component feature is enabled for model-driven apps. To enable an environment to use code components inside its apps:
38+
To add code components to an app, you need to enable the Power Apps component framework feature in each environment where you want to use them. By default, the Power Apps component feature is enabled for model-driven apps. To enable an environment to use code components inside its apps:
3939

4040
1. Sign in to [Power Apps](https://powerapps.microsoft.com/).
4141

42-
2. Select the **Settings** icon and then select **Admin Center**.
42+
2. Select **Settings** ![Settings.](media/settings.png), and then select **Admin Center**.
4343

4444
> [!div class="mx-imgBorder"]
45-
> ![Settings and Admin Center](media/select-admin-center-from-settings.png "Settings and Admin Center")
45+
> ![Settings and Admin Center.](media/select-admin-center-from-settings.png "Settings and Admin Center")
4646
47-
3. Select the **Environments** tab in the left pane and select the environment where you want to enable this feature and then select **Settings**.
47+
3. On the left pane, select **Environments**, select the environment where you want to enable this feature, and then select **Settings**.
4848

49-
4. Under the **Products** tab, select **Features**.
49+
4. On the **Products** tab, select **Features**.
5050

5151
> [!div class="mx-imgBorder"]
52-
> ![Enable Power Apps component framework](media/enable-pcf-feature.png "Enable Power Apps component framework")
52+
> ![Enable Power Apps component framework.](media/enable-pcf-feature.png "Enable Power Apps component framework")
5353
54-
5. From the list of available features, set the switch to **On** under **Power Apps component framework for canvas apps** and click **Save**.
54+
5. From the list of available features, turn on **Power Apps component framework for canvas apps**, and then select **Save**.
5555

56-
6. Now, open the app where you want to add the code component and navigate to **File** > **Settings** and select **Advanced settings**.
56+
6. Now, open the app where you want to add the code component, got to **File** > **Settings**, and then select **Advanced settings**.
5757

5858
> [!div class="mx-imgBorder"]
59-
> ![Enable components for Power Apps component framework](media/enable-components-for-pcf.png "Enable components for Power Apps component framework")
59+
> ![Enable components for Power Apps component framework.](media/enable-components-for-pcf.png "Enable components for Power Apps component framework")
6060
61-
7. Turn the **Components** switch to **On** under the **Experimental feature** section.
61+
7. In the **Experimental features** section, turn on **Components**.
6262

63-
> [!NOTE]
64-
> When creating new canvas apps, steps 6 & 7 is enabled by default.
63+
> [!NOTE]
64+
> When you create new canvas apps, steps 6 and 7 are enabled by default.
6565
6666
## Implementing code components
6767

68-
After you enable the Power Apps component framework feature in your environment, you can start implementing the logic for code components.
69-
70-
The [Create your first code component](implementing-controls-using-typescript.md) topic demonstrates the step-by-step process to create code components.
68+
After you enable the Power Apps component framework feature in your environment, you can start implementing the logic for code components. For a step-by-step tutorial, go to [Create your first code component](implementing-controls-using-typescript.md).
7169

7270
## Add components to a canvas app
7371

74-
To add code components to a canvas app:
72+
1. Go to Power Apps Studio.
7573

76-
1. Navigate to Power Apps Studio.
77-
2. Create a new canvas app or edit an existing app to which you want to add the code component.
74+
2. Create a new canvas app, or edit an existing app to which you want to add the code component.
7875

7976
> [!IMPORTANT]
80-
> Make sure the solution zip file containing code components is already [imported](../../maker/data-platform/import-update-export-solutions.md) into Microsoft Dataverse before you proceed to the next step.
77+
> Make sure the solution .zip file containing the code components has already been [imported](../../maker/data-platform/import-update-export-solutions.md) into Microsoft Dataverse before you proceed to the next step.
8178
82-
3. In the left pane select **+** icon and then select **Get more components**.
79+
3. On the left pane, select **Add** (**+**), and then select **Get more components**.
8380

8481
> [!div class="mx-imgBorder"]
85-
> ![Insert components](media/insert-code-components-using-get-more-components.png "Insert components")
82+
> ![Insert components.](media/insert-code-components-using-get-more-components.png "Insert components")
8683
87-
4. Select the **Code** tab, select a component from the list, and then select **Import**.
84+
4. Select the **Code** tab, select a component from the list, and then select **Import**.<!--note from editor: Here and in step 5, I deleted "sample" because maybe the reader is adding a component they truly want, not necessarily a sample.-->
8885

8986
> [!div class="mx-imgBorder"]
90-
> ![Import sample component](media/insert-component-add-sample-component.png "Import sample component")
87+
> ![Import a component.](media/insert-component-add-sample-component.png "Import a component")
9188
92-
5. Select the **+** icon on the left pane and expand the code components tab and select to add the sample component.
89+
5. On the left pane, select **+**, expand **Code components**, and then select the component to add it to the app.
9390

9491
> [!div class="mx-imgBorder"]
95-
> ![Add sample component](media/add-sample-component-from-list.png "Add sample component")
92+
> ![Add a component.](media/add-sample-component-from-list.png "Add a component")
9693
9794
> [!NOTE]
98-
> You can also add components by selecting **Insert** > **Custom** > **Import component**. This option will be removed in a future release, so we suggest using the flow described above.
99-
100-
6. In the **Properties** tab, you'll notice the code component properties displayed.
95+
> You can also add components by selecting **Insert** > **Custom** > **Import component**. This option will be removed in a future release, so we suggest using the flow described above.<!--note from editor: Recommend deleting this unless there's a mechanism in place to revisit this topic in tandem with the future release. This is especially not a good candidate for note format, since it draws extra attention to this step that won't work before long.-->
10196
102-
> [!div class="mx-imgBorder"]
103-
> ![Default code component properties pane](media/property-pane-with-parameters.png "Default code components properties pane")
97+
<!--note from editor: The following isn't really a step, so I removed the numbering and indent. -->
98+
On the **Properties** tab, you'll notice the code component properties are displayed.
10499

105-
> [!NOTE]
106-
> Existing code components can be re-imported by updating the code component's manifest version if you want the properties to be available in the default **Properties** tab. Like in the past the properties will continue to be available in the advanced properties panel.
100+
> [!div class="mx-imgBorder"]
101+
> ![Default code component properties pane.](media/property-pane-with-parameters.png "Default code components properties pane")
107102
108-
## Delete a code component
103+
> [!NOTE]
104+
> Existing code components can be re-imported by updating the code component's manifest version if you want the properties to be available in the default **Properties** tab. As before, the properties will continue to be available on the **Advanced** properties tab.<!--note from editor: Edit okay? -->
109105
110-
To delete a code component from a canvas app:
106+
## Delete a code component from a canvas app
111107

112-
1. Open the app where you have added the code component.
113-
1. Select the **Tree view** icon from the left pane and select the screen where you have added the code component.
114-
1. Select **ellipse (...)** next to the code component and select **Delete**.
108+
1. Open the app where you've added the code component.
109+
1. On the left pane, select **Tree view**, and then select the screen where you've added the code component.
110+
1. Next to the component, select **More** (**...**), and then select **Delete**.
115111

116112
> [!div class="mx-imgBorder"]
117-
> ![Delete code component](media/delete-code-component.png "Delete code component")
113+
> ![Delete a code component.](media/delete-code-component.png "Delete a code component")
118114
119115
1. Save the app to see the changes.
120116

121117
## Update existing code components
122118

123-
Whenever you update the code components and want to see the runtime changes, you need to bump the `version` property in the manifest file. It is recommended to always bump the version of the component whenever you make changes.
119+
Whenever you update the code components and want to see the runtime changes, you need to change<!--note from editor: I don't think "bump" is going to necessarily be well-understood by non-native English readers. Maybe this should be "increase"?--> the `version` property in the manifest file. We recommend that you change the version of the component whenever you make changes.
124120

125121
> [!NOTE]
126-
> Existing code components are updated only when the app is closed or reopened in Power Apps Studio. When you reopen the app, it asks you to update the code components. Simply deleting the code components or adding the code component back into the app doesn't update the components.
122+
> Existing code components are updated only when the app is closed or reopened in Power Apps Studio. When you reopen the app, it asks you to update the code components. Simply deleting or adding code components back into the app won't update the components.
127123
128-
## See also
124+
### See also
129125

130126
[Power Apps component framework overview](overview.md)<br/>
131127
[Create your first code component](implementing-controls-using-typescript.md)<br/>

0 commit comments

Comments
 (0)