Skip to content

Commit a8ca831

Browse files
authored
Merge branch 'main' into JimDaly-patch-5
2 parents 9ad5e11 + 7b5e9a7 commit a8ca831

File tree

2,395 files changed

+72085
-25023
lines changed

Some content is hidden

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

2,395 files changed

+72085
-25023
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ _repo.*/
77

88
.openpublishing.buildcore.ps1
99
settings.json
10+
.DS_Store
1011

1112
# Folder config file
1213
[Dd]esktop.ini

.openpublishing.publish.config.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@
6363
],
6464
"branches_to_filter": [],
6565
"git_repository_url_open_to_public_contributors": "https://github.com/MicrosoftDocs/powerapps-docs",
66-
"git_repository_branch_open_to_public_contributors": "live",
66+
"git_repository_branch_open_to_public_contributors": "main",
6767
"skip_source_output_uploading": false,
6868
"need_preview_pull_request": true,
6969
"contribution_branch_mappings": {},

.openpublishing.redirection.json

Lines changed: 130 additions & 100 deletions
Large diffs are not rendered by default.

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

Lines changed: 19 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,35 @@
11
---
2-
title: Add code components to a field or entity | Microsoft Docs
3-
description: Process to import code components
2+
title: Add code components to a column or table in Microsoft Dataverse | Microsoft Docs
3+
description: Learn how to add code components to a column or table.
44
keywords:
55
ms.author: nabuthuk
66
author: Nkrb
77
manager: kvivek
8-
ms.date: 10/01/2019
8+
ms.date: 04/01/2021
99
ms.service: "powerapps"
1010
ms.suite: ""
1111
ms.tgt_pltfrm: ""
1212
ms.topic: "article"
1313
---
1414

15-
# Add code components to a field or entity in model-driven apps
15+
# Add code components to a column or table in model-driven apps
1616

17-
Code components let you transform fields that traditionally contain text into visualizations. Similarly, you can use code components to transform datasets, such as a view, to display in a more visual rendering rather than a list of records. Code components can appear as visualizations on forms, dashboards, views, and homepage grids.
17+
Code components let you transform columns that traditionally contain text into visualizations. Similarly, you can use code components to transform datasets, such as a view, to display in a more visual rendering rather than a list of records. Code components can appear as visualizations on forms, dashboards, views, and homepage grids.
1818

19+
[!INCLUDE[cc-terminology](../data-platform/includes/cc-terminology.md)]
1920

2021
> [!div class="mx-imgBorder"]
21-
> ![Custom slider control](../../maker/model-driven-apps/media/slider-control.PNG "Slider control for a field")
22+
> ![Custom slider control](../../maker/model-driven-apps/media/slider-control.PNG "Custom slider control ")
2223
23-
## Add a code component to a field
24+
## Add a code component to a column
2425

25-
Following the steps below will change the default label and text box field of the **Budget Amount** field to the slider code component on the Opportunity entity. You can use similar steps to replace an existing field with a code component or configure a code component for a custom field.
26+
Following the steps below will change the default label and text box column of the **Budget Amount** column to the slider code component on the Opportunity table. You can use similar steps to replace an existing column with a code component or configure a code component for a custom column.
2627

2728
1. Navigate to **Settings** > **Customizations** > **Customize the System**.
2829

29-
2. Expand **Entities**, expand the entity that you want, such as the **Opportunity** entity, select **Forms**, and then open a form such as the **Main** form.
30+
2. Expand **Entities**, expand the table that you want, such as the **Opportunity** table, select **Forms**, and then open a form such as the **Main** form.
3031

31-
3. In the form editor, double-click the field where you want to add a code component, such as the **Budget Amount** field on the opportunity main form. You can also create a custom field.
32+
3. In the form editor, double-click the column where you want to add a code component, such as the **Budget Amount** column on the opportunity main form. You can also create a custom column.
3233

3334
4. On the **Field Properties** page, select the **Controls** tab, and then select **Add Control**.
3435

@@ -53,38 +54,38 @@ Following the steps below will change the default label and text box field of th
5354
> [!div class="mx-imgBorder"]
5455
> ![Add custom control properties](../../maker/model-driven-apps/media/ccf-add-properties.png "Add custom control properties")
5556
56-
- **Min**. Set the minimum accepted value. You can bind a static value that you enter or bind the value to an existing field. In this example **Bind to static value** is **Currency** and the minimum value that can be entered is *zero*.
57+
- **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*.
5758

58-
- **Bind to a static value**. Select the data type, such as a whole number (Whole.None), currency, floating point (FP), or decimal. Next, enter a number that represents the minimum accepted value for the field.
59+
- **Bind to a static value**. Select the data type, such as a whole number (Whole.None), currency, floating point (FP), or decimal. Next, enter a number that represents the minimum accepted value for the column.
5960

60-
- **Bind to values on a field**. Select a field from the list that will be used as the minimum accepted value.
61+
- **Bind to values on a field**. Select a column from the list that will be used as the minimum accepted value.
6162

62-
- **Max**. Set the maximum accepted value for the field. Similar to the Min value, you can bind a static value that you enter or bind the value to an existing field as described earlier. In this example, **Bind to static value** is **Currency** and the maximum value that can be entered is **1 billion**.
63+
- **Max**. Set the maximum accepted value for the column. Similar to the Min value, you can bind a static value that you enter or bind the value to an existing column as described earlier. In this example, **Bind to static value** is **Currency** and the maximum value that can be entered is **1 billion**.
6364

6465
- **Step**. This represents the unit to increment or decrement when adding to or subtracting from the current value. For example, for budget amount you can select 100 dollar increments\decrements.
6566

6667
- **Hide Default Control**. Hides the component so neither the component nor the data is displayed in any of the clients that don't support the code component.
6768

6869
8. Select **OK**, to close the Field Properties page.
6970

70-
9. To activate the customization, on the entity form select **Save**, and then select **Publish**.
71+
9. To activate the customization, on the table form select **Save**, and then select **Publish**.
7172

7273
10. Select **Save and Close** to close the form editor.
7374

74-
## Add code component to an entity
75+
## Add code component to a table
7576

7677
To add a code component like data-set component or simple table component to a grid or view, follow the steps below:
7778

7879
- Navigate to **Settings > Customizations** and click on **Customize the System**.
79-
- Click on the arrow next to **Entities** tab a select the entity you want to add the code component.
80+
- Click on the arrow next to **Entities** tab a select the table you want to add the code component.
8081
- Click on the **Controls** tab and click on **Add a control**.
8182
- On the Add Control page, select the component that you want, such as Simple Table component and then select **Add**.
8283
- Choose the client where you want the component to appear.
8384

8485

8586
## See the code component in action
8687

87-
Open a record that includes the field with the code component, such as the Opportunity form from the previous example, and view how the field is changed. The field is now rendered as a slider component instead of the text field.
88+
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.
8889

8990
> [!div class="mx-imgBorder"]
9091
> ![Slider control rendered on form](../../maker/model-driven-apps/media/slider-control.PNG "Slider control rendered on form")

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

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Code components for model-driven apps | Microsoft Docs
3-
description: Create code components for canvas apps
2+
title: Code components for canvas apps | Microsoft Docs
3+
description: Learn how to create code components using Power Apps component framework for canvas apps
44
keywords:
55
ms.author: nabuthuk
66
author: Nkrb
@@ -15,7 +15,9 @@ ms.assetid: 5d100dc3-bd82-4b45-964c-d90eaebc0735
1515

1616
# Code components for model-driven apps
1717

18-
Power Apps component framework gives developers the ability to extend the visualizations in model-driven apps. Professional developers can create, debug, import, and add code components to model-driven apps using [Power Apps CLI](get-powerapps-cli.md). You can add code components to fields, grids, and sub grids in model-driven apps.
18+
[!INCLUDE[cc-terminology](../data-platform/includes/cc-terminology.md)]
19+
20+
Power Apps component framework gives developers the ability to extend the visualizations in model-driven apps. Professional developers can create, debug, import, and add code components to model-driven apps using [Power Apps CLI](get-powerapps-cli.md). You can add code components to columns, grids, and sub grids in model-driven apps.
1921

2022
> [!IMPORTANT]
2123
> Power Apps component framework is enabled for model-driven apps by default. See [Code components for canvas apps](component-framework-for-canvas-apps.md) to learn how to enable Power Apps component framework for canvas apps.
@@ -28,7 +30,7 @@ The [create your first code component](implementing-controls-using-typescript.md
2830

2931
## Add code components to model-driven apps
3032

31-
To add code components to a field or an entity in model-driven apps, see [Add code components to model-driven apps](add-custom-controls-to-a-field-or-entity.md).
33+
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).
3234

3335
> [!div class="mx-imgBorder"]
3436
> ![Add linear slider control](../../maker/model-driven-apps/media/add-slider.PNG "Add linear slider control")
@@ -38,7 +40,7 @@ To add code components to a field or an entity in model-driven apps, see [Add co
3840
3941
## Update existing code components
4042

41-
Whenever you update the code components and want to see the changes in runtime, you need to bump the version attribute in the manifest file. It is recommended to always bump the version of the component whenever you make changes.
43+
Whenever you update the code components and want to see the changes in runtime, 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.
4244

4345
## See also
4446

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

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

1515
# Community resources for Power Apps component framework
1616

17+
[!INCLUDE[cc-terminology](../data-platform/includes/cc-terminology.md)]
18+
1719
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 Power Apps CLI.
1820

1921
> [!NOTE]

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

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Code components for canvas apps | Microsoft Docs
3-
description: Create code components for canvas apps
3+
description: Learn how to create code components using Power Apps component framework for canvas apps.
44
keywords:
55
ms.author: nabuthuk
66
author: Nkrb
@@ -17,6 +17,8 @@ ms.assetid: 5d100dc3-bd82-4b45-964c-d90eaebc0735
1717

1818
Power Apps component framework enables app makers to create code components to use in an app or across the apps. More information: [Power Apps component framework overview](overview.md)
1919

20+
[!INCLUDE[cc-terminology](../data-platform/includes/cc-terminology.md)]
21+
2022
In this public preview, Power Apps component framework enables app makers to create code components, debug, import, and add them to canvas apps using the Power Apps CLI tooling. Only specific APIs are supported in this public preview. We recommend you to check each API to determine whether it supports canvas apps.
2123

2224
> [!WARNING]
@@ -94,7 +96,7 @@ To delete a code component from a canvas app:
9496

9597
## Update existing code components
9698

97-
Whenever you update the code components and want to see the changes in runtime, you need to bump the `version` attribute in the manifest file. It is recommended to always bump the version of the component whenever you make changes.
99+
Whenever you update the code components and want to see the changes in runtime, 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.
98100

99101
> [!NOTE]
100102
> 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.

powerapps-docs/developer/component-framework/create-custom-controls-using-pcf.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Create and build a code component| Microsoft Docs
3-
description: Start creating a component using the Power Apps component framework tooling
2+
title: Create and build a code component in Microsoft Dataverse| Microsoft Docs
3+
description: Start creating a component using the Power Apps component framework tooling.
44
keywords: Power Apps component framework, code components, Component Framework
55
ms.author: nabuthuk
66
author: Nkrb
@@ -17,6 +17,8 @@ ms.assetid: d2cbf58a-9112-45c2-b823-2c07a310714c
1717

1818
This article demonstrates how to create and deploy code components using Power Apps CLI. Ensure that you have installed [Microsoft Power Apps CLI](https://aka.ms/PowerAppsCLI).
1919

20+
[!INCLUDE[cc-terminology](../data-platform/includes/cc-terminology.md)]
21+
2022
## Create a new component
2123

2224
To begin, open **Developer Command Prompt for VS 2017 or higher** after installing Power Apps CLI.
@@ -51,7 +53,7 @@ Finally when you're done implementing the component logic in TypeScript, you nee
5153
5254
[Debug code components](debugging-custom-controls.md)<br/>
5355
[Package a code component](import-custom-controls.md)<br/>
54-
[Add code components to a field or entity](add-custom-controls-to-a-field-or-entity.md)<br/>
56+
[Add code components to a column or table](add-custom-controls-to-a-field-or-entity.md)<br/>
5557
[Updating existing code components](updating-existing-controls.md)<br/>
5658
[Power Apps component framework API reference](reference/index.md)<br/>
5759
[Power Apps component framework overview](overview.md)

powerapps-docs/developer/component-framework/custom-controls-overview.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ description: "Use the Power Apps component framework to create code components t
44
manager: kvivek
55
ms.date: 09/05/2019
66
ms.service: "powerapps"
7+
ms.custom: "intro-internal"
78
ms.topic: "article"
89
ms.assetid: 135481cd-4583-4e49-8f58-02f32a9b054a
910
ms.author: "nabuthuk"
@@ -14,10 +15,12 @@ author: Nkrb
1415

1516
Code components are a type of solution components, which means they can be included in a solution file and installed in different environments. More information: [Package and distribute extensions using solutions](/dynamics365/customer-engagement/developer/package-distribute-extensions-use-solutions).
1617

18+
[!INCLUDE[cc-terminology](../data-platform/includes/cc-terminology.md)]
19+
1720
> [!div class="mx-imgBorder"]
1821
> ![Code components](media/code-components.gif "Code components")
1922
20-
You add code components by including them in a solution and then import it into Microsoft Dataverse. Once the components are in Dataverse, system administrators and system customizers can configure fields, subgrids, views, and dashboard subgrids to use in place of default components. You can add these code components to both **model-driven and canvas apps**.
23+
You add code components by including them in a solution and then import it into Microsoft Dataverse. Once the components are in Dataverse, system administrators and system customizers can configure columns, subgrids, views, and dashboard subgrids to use in place of default components. You can add these code components to both **model-driven and canvas apps**.
2124

2225
Code components consist of three elements:
2326

@@ -33,12 +36,12 @@ Code components consist of three elements:
3336
Manifest is the metadata file that defines a component. It is an XML document that describes:
3437

3538
- The name of the component.
36-
- The kind of data that can be configured, either a field or a data-set.
39+
- The kind of data that can be configured, either a `field` or a `data-set`.
3740
- Any properties that can be configured in the application when the component is added.
3841
- A list of resource files that the component needs.
3942
- The name of the TypeScript function in the component implementation library that returns an object that applies the required component interface.
4043

41-
When a user configures a code component, the data in the manifest file filters out the available components so that only valid components for the context are available for configuration. The properties defined in the manifest file for a component are rendered as configuration fields so that the user configuring the component can specify the values. These property values are then available to the component at runtime. More information: [Manifest schema reference](manifest-schema-reference/index.md)
44+
When a user configures a code component, the data in the manifest file filters out the available components so that only valid components for the context are available for configuration. The properties defined in the manifest file for a component are rendered as configuration columns so that the user configuring the component can specify the values. These property values are then available to the component at runtime. More information: [Manifest schema reference](manifest-schema-reference/index.md)
4245

4346
## Component implementation
4447

powerapps-docs/developer/component-framework/debugging-custom-controls.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ author: Nkrb
1414

1515
After implementing the code component logic, you can start testing and debugging the code component using the `npm start` command. This command builds the code component and opens it in the local test harness.
1616

17+
[!INCLUDE[cc-terminology](../data-platform/includes/cc-terminology.md)]
18+
1719
> [!div class="mx-imgBorder"]
1820
> ![Test harness 1](media/test-harness-1.png "Test harness 1")
1921

0 commit comments

Comments
 (0)