Skip to content

Commit 3e2567c

Browse files
committed
Merge branch 'main' into 3089992
2 parents a7fbedb + 714d6c6 commit 3e2567c

File tree

603 files changed

+1907
-2507
lines changed

Some content is hidden

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

603 files changed

+1907
-2507
lines changed

.openpublishing.redirection.json

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,26 @@
11
{
22
"redirections": [
3-
{
3+
{
4+
"source_path": "powerapps-docs/maker/portals/admin/portal-checker-analysis.md",
5+
"redirect_url": "/power-apps/maker/portals/admin/portal-checker#next-steps",
6+
"redirect_document_id": false
7+
},
8+
{
49
"source_path": "powerapps-docs/developer/model-driven-apps/clientapi/reference/controls/removeOnPostSave.md",
5-
"redirect_url": "../../formContext-data-entity/removeOnPostSave",
10+
"redirect_url": "../formContext-data-entity/removeonpostave",
611
"redirect_document_id": false
7-
},
8-
{
12+
},
13+
{
914
"source_path": "powerapps-docs/developer/model-driven-apps/clientapi/reference/controls/addOnPostSave.md",
10-
"redirect_url": "../../formContext-data-entity/addOnPostSave",
15+
"redirect_url": "../formcontext-data-entity/addonpostsave",
1116
"redirect_document_id": false
12-
},
13-
{
17+
},
18+
{
1419
"source_path": "powerapps-docs/developer/data-platform/org-service/metadata-retrieve-detect-changes.md",
1520
"redirect_url": "../query-schema-definitions",
1621
"redirect_document_id": false
17-
},
18-
{
22+
},
23+
{
1924
"source_path": "powerapps-docs/developer/model-driven-apps/clientapi/reference/controls/getoutput.md",
2025
"redirect_url": "getoutputs",
2126
"redirect_document_id": false

powerapps-docs/cards/card-requirements.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,11 +16,11 @@ ms.collection:
1616

1717
[!INCLUDE[cards_preview_notice](includes/preview-include.md)]
1818

19-
This article contains information on requirements for cards to show up and work as expected.
19+
This article contains information about requirements for cards to show up and work as expected.
2020

2121
## Environment requirements
2222

23-
Cards are available in environments with Dataverse.
23+
Cards are available in environments with Microsoft Dataverse.
2424

2525
The table below shows the environment regions cards are supported in.
2626

powerapps-docs/cards/make-a-card/designer-overview.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ Legend:
4242

4343
### Main menu
4444

45-
Use the main menu to switch between the tools available in the card designer:
45+
Use the main menu to switch between the tools available in the card designer.
4646

4747
- **Tree View**: View card elements as a hierarchy and view the relationships between elements
4848
- **Insert**: Add controls
@@ -75,16 +75,16 @@ Each element also has advanced properties, such as:
7575

7676
- **Repeat for every**: Trigger whether or when an element should be repeated
7777
- **Show when**: Trigger when to show the element
78-
- **Requires**: Make the element dependent on certain features, with a corresponding minimum version
78+
- **Requires**: Make the element dependent on certain features with a corresponding minimum version
7979

8080
You can also enter Power Fx expressions in some properties, creating low-code solutions that make your card more powerful.
8181

8282
### Formula bar and Power Fx editor
8383

84-
Use the formula bar to enter a Power Fx expression as a property of the selected control; for example, to calculate a value when a button is clicked. The formula bar even assists you as you're writing an expression. [Learn more about Power FX](../make-a-card/power-fx/intro-to-pfx.md) and the [functions and formulas you can use in an expression](/powerapps/maker/canvas-apps/formula-reference).
84+
Use the formula bar to enter a Power Fx expression as a property of the selected control (for example, to calculate a value when a button is clicked). The formula bar even assists you as you're writing an expression. [Learn more about Power FX](../make-a-card/power-fx/intro-to-pfx.md) and the [functions and formulas you can use in an expression](/powerapps/maker/canvas-apps/formula-reference).
8585

8686
> [!NOTE]
87-
> Some expressions that are supported in Power Apps aren't available for cards. For more information, see [Power Fx and cards overview](../make-a-card/power-fx/intro-to-pfx.md).
87+
> Some expressions that are supported in Power Apps aren't available for cards. For more information, go to [Power Fx and cards overview](../make-a-card/power-fx/intro-to-pfx.md).
8888
8989
### Play button
9090

powerapps-docs/cards/make-a-card/power-fx/intro-to-pfx.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ The [Power Fx documentation](/power-platform/power-fx/overview) is the main sour
2929

3030
## Known limitations of using Power Fx in cards
3131

32-
The following table lists the Power Fx formulas that don't work in cards, or have limitations. All other functions are fully supported.
32+
The following table lists the Power Fx formulas that don't work in cards or have limitations. All other functions are fully supported.
3333

3434
| Power Fx formula | Supported in cards |
3535
|---------|:---:|

powerapps-docs/cards/make-a-card/variables/variables.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ As an example, you've created a card that counts how many times the user presses
4141

4242
You can't change the name or type of a variable. If you need to change them, create a new variable.
4343

44-
You can also customize sender options and, under **Additional variable information**, the **Title** and **Description** of the variable. This information may be helpful for testing and debugging and using your variable with Power Automate flows and Power Virtual Agents bots.
44+
You can also customize sender options and, under **Additional variable information**, the **Title** and **Description** of the variable. This information may be helpful for testing, debugging, and using your variable with Power Automate flows and Power Virtual Agents bots.
4545

4646
:::image type="content" source="../../media/variables/new-variable.png" alt-text="Screenshot of the New variable window in the card designer.":::
4747

powerapps-docs/cards/manage-cards/manage-cards.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ This section shows you how to manage cards using security roles.
2626

2727
Cards are stored as rows in Dataverse within the **Card** table. Administrators can use [security roles to control who can create, read, and update cards](/power-platform/admin/wp-security-cds#tablerecord-ownership).
2828

29-
For example, if the user is only assigned to a security role that does not have permission to create rows in the **Card** table, then the user will not be able to create cards.
29+
For example, if the user is only assigned to a security role that does not have permission to create rows in the **Card** table, then the user won't be able to create cards.
3030

3131
Note that a user will still be able to receive and use cards sent in Teams, regardless of the security role assigned to the user, as those cards are accessed by the Cards for Power Apps service.
3232

@@ -57,4 +57,4 @@ This section shows you how to delete a card.
5757

5858
### Delete a card as the administrator
5959

60-
If the owner of an app is unavailable, it is currently not possible for an administrator, such as Global admin, Azure Active Directory Global admin, or Dynamics 365 admin to delete a card. We are working on enabling this capability.
60+
If the owner of an app is unavailable, it is currently not possible for an administrator, such as Global admin, Azure Active Directory Global admin, or Dynamics 365 admin to delete a card. We're working on enabling this capability.

powerapps-docs/developer/component-framework/implementing-controls-using-typescript.md

Lines changed: 80 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Create your first component using Power Apps Component Framework in Micr
33
description: "Learn how to implement code components using Power Apps component framework"
44
ms.author: noazarur
55
author: noazarur-microsoft
6-
ms.date: 05/27/2022
6+
ms.date: 12/15/2022
77
ms.reviewer: jdaly
88
ms.topic: article
99
ms.subservice: pcf
@@ -65,7 +65,7 @@ To create a new project:
6565
1. At the terminal prompt, create a new component project by passing basic parameters using the [pac pcf init](/power-platform/developer/cli/reference/pcf#pac-pcf-init) command.
6666
6767
```CLI
68-
pac pcf init --namespace SampleNamespace --name LinearInputControl --template field
68+
pac pcf init --namespace SampleNamespace --name LinearInputControl --template field --run-npm-install
6969
```
7070

7171
1. The above command also runs the `npm install` command for you to setup the project build tools.
@@ -76,10 +76,6 @@ To create a new project:
7676
> [!NOTE]
7777
> If you receive the error `The term 'npm' is not recognized as the name of a cmdlet, function, script file, or operable program.`, make sure you have installed [node.js](https://nodejs.org/en/download/) (LTS version is recommended) and all other prerequisites.
7878
79-
1. After npm install, you will need to generate ManifestDesignTypes.d.ts file in this directory using the below command."
80-
```
81-
npm run refreshTypes
82-
```
8379

8480

8581
## Implementing manifest
@@ -98,56 +94,100 @@ Make changes to the predefined manifest file, as shown here:
9894
- **control-type**: The code component type. Only *standard* types of code components are supported.
9995

10096
```XML
101-
<?xml version="1.0" encoding="utf-8" ?>
102-
<manifest>
103-
<control namespace="SampleNamespace" constructor="LinearInputControl" version="1.1.0" display-name-key="LinearInputControl_Display_Key" description-key="LinearInputControl_Desc_Key" control-type="standard">
97+
<?xml version="1.0" encoding="utf-8" ?>
98+
<manifest>
99+
<control namespace="SampleNamespace"
100+
constructor="LinearInputControl"
101+
version="1.1.0"
102+
display-name-key="LinearInputControl_Display_Key"
103+
description-key="LinearInputControl_Desc_Key"
104+
control-type="standard">
105+
<!-- TODO: Add type-group, property, and resources elements here -->
106+
</control>
107+
</manifest>
108+
```
109+
110+
1. Add the definition of a [type-group](manifest-schema-reference/type-group.md) element named `numbers` in the `control` element. This element specifies the component value and can contain whole, currency, floating point, or decimal values.
111+
112+
```XML
113+
<type-group name="numbers">
114+
<type>Whole.None</type>
115+
<type>Currency</type>
116+
<type>FP</type>
117+
<type>Decimal</type>
118+
</type-group>
104119
```
105120

106-
2. The [property](manifest-schema-reference/property.md) node defines the properties of the code component like defining the data type of the column. The property node is specified as the child element under the `control` element. Define the [property](manifest-schema-reference/property.md) node as shown here:
121+
1. Add the [property](manifest-schema-reference/property.md) element within the `control` element. This element defines the properties of the code component like defining the data type of the column. Define the [property](manifest-schema-reference/property.md) node as shown here:
107122

108123
- **name**: Name of the property.
109124
- **display-name-key**: Display name of the property that is displayed on the UI.
110-
- **description-name-key**: Description of the property that is displayed on the UI.
111-
- **of-type-group**: The [of-type-group](manifest-schema-reference/type-group.md) is used when you want to have more than two data type columns. Add the [of-type-group](manifest-schema-reference/type-group.md) element as a sibling to the `property` element in the manifest. The `of-type-group` specifies the component value and can contain whole, currency, floating point, or decimal values.
125+
- **description-name-key**: Description of the property that is displayed on the UI.
126+
- **of-type-group**: Use the `of-type-group` attribute when you want refer to the name of a specific type group. Here, we are referring to the `type-group` named `numbers` created in the previous step.
112127
- **usage**: Has two properties, *bound* and *input*. Bound properties are bound only to the value of the column. Input properties are either bound to a column or allow a static value.
113128
- **required**: Defines whether the property is required.
114129

115130
```XML
116-
<property name="controlValue" display-name-key="controlValue_Display_Key" description-key="controlValue_Desc_Key" of-type-group="numbers" usage="bound" required="true" />
131+
<property name="controlValue"
132+
display-name-key="controlValue_Display_Key"
133+
description-key="controlValue_Desc_Key"
134+
of-type-group="numbers"
135+
usage="bound"
136+
required="true" />
117137
```
118138

119-
3. The [resources](manifest-schema-reference/resources.md) node defines the visualization of the code component. It contains all the resources that build the visualization and styling of the code component. The [code](manifest-schema-reference/code.md) is specified as a child element under the resources element. Define the [resources](manifest-schema-reference/resources.md) as shown here:
139+
1. The [resources](manifest-schema-reference/resources.md) node defines the visualization of the code component. It contains all the resources that build the visualization and styling of the code component. The [code](manifest-schema-reference/code.md) is specified as a child element under the resources element. Define the [resources](manifest-schema-reference/resources.md) as shown here:
120140

121141
- **code**: Refers to the path where all the resource files are located.
122142

123143
```XML
124144
<resources>
125-
<code path="index.ts" order="1" />
126-
<css path="css/LinearInputControl.css" order="1" />
145+
<code path="index.ts"
146+
order="1" />
147+
<css path="css/LinearInputControl.css"
148+
order="1" />
127149
</resources>
128150
```
129-
The overall manifest file should look something like this:
151+
152+
The completed manifest file should look like this:
130153

131154
```XML
132-
<?xml version="1.0" encoding="utf-8" ?>
133-
<manifest>
134-
<control namespace="SampleNamespace" constructor="LinearInputControl" version="1.1.0" display-name-key="LinearInputControl_Display_Key" description-key="LinearInputControl_Desc_Key" control-type="standard">
135-
<type-group name="numbers">
136-
<type>Whole.None</type>
137-
<type>Currency</type>
138-
<type>FP</type>
139-
<type>Decimal</type>
140-
</type-group>
141-
<property name="controlValue" display-name-key="controlValue_Display_Key" description-key="controlValue_Desc_Key" of-type-group="numbers" usage="bound" required="true" />
142-
<resources>
143-
<code path="index.ts" order="1" />
144-
<css path="css/LinearInputControl.css" order="1" />
145-
</resources>
146-
</control>
147-
</manifest>
155+
<?xml version="1.0" encoding="utf-8" ?>
156+
<manifest>
157+
<control namespace="SampleNamespace"
158+
constructor="LinearInputControl"
159+
version="1.1.0"
160+
display-name-key="LinearInputControl_Display_Key"
161+
description-key="LinearInputControl_Desc_Key"
162+
control-type="standard">
163+
<type-group name="numbers">
164+
<type>Whole.None</type>
165+
<type>Currency</type>
166+
<type>FP</type>
167+
<type>Decimal</type>
168+
</type-group>
169+
<property name="controlValue"
170+
display-name-key="controlValue_Display_Key"
171+
description-key="controlValue_Desc_Key"
172+
of-type-group="numbers"
173+
usage="bound"
174+
required="true" />
175+
<resources>
176+
<code path="index.ts"
177+
order="1" />
178+
<css path="css/LinearInputControl.css"
179+
order="1" />
180+
</resources>
181+
</control>
182+
</manifest>
148183
```
149184

150-
4. Save the changes to the `ControlManifest.Input.xml` file.
185+
1. Save the changes to the `ControlManifest.Input.xml` file.
186+
1. After making changes to the manifest, you will need to generate ManifestDesignTypes.d.ts file in this directory using the below command."
187+
188+
```
189+
npm run refreshTypes
190+
```
151191
152192
## Implementing component logic
153193
@@ -341,7 +381,12 @@ npm start watch
341381

342382
Follow these steps to create and import a [solution](../../maker/data-platform/solutions-overview.md) file:
343383

344-
1. Create a new folder **Solutions** inside the **LinearInputControl** folder and navigate into the folder.
384+
1. Create a new folder named **Solutions** inside the **LinearInputControl** folder and navigate into the folder.
385+
386+
```CLI
387+
mkdir Solutions
388+
cd Solutions
389+
```
345390

346391
2. Create a new solution project in the **LinearInputControl** folder using the [pac solution init](/power-platform/developer/cli/reference/solution#pac-solution-init) command:
347392

powerapps-docs/developer/component-framework/manifest-schema-reference/includes/type-table.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
|Value |Description |
22
|--|--|
3-
|Currency|Monetary values between -922,337,203,685,477 and 922,337,203,685,477 can be in this column. You can set a level of precision or choose to base the precision on a specific currency or a single standard precision used by the organization.|
3+
|Currency|Monetary values between -922,337,203,685,477 and 922,337,203,685,477 can be in this column.|
44
|DateAndTime.DateAndTime|Displays date and time.|
55
|DateAndTime.DateOnly|Displays date only.|
6-
|Decimal|Up to 10 decimal points of precision can be used for values between -100,000,000,000 and -100,000,000,000 can be in this column. You can specify the level of precision and the maximum and minimum values.|
6+
|Decimal|Up to 10 decimal points of precision can be used for values between -100,000,000,000 and -100,000,000,000 can be in this column.|
77
|Enum|Enumerated data type.|
8-
|FP|Up to 5 decimal points of precision can be used for values between -100,000,000,000 and -100,000,000,000 can be in this column. You can specify the level of precision and the maximum and minimum values. |
8+
|FP|Up to 5 decimal points of precision can be used for values between -100,000,000,000 and -100,000,000,000 can be in this column.|
99
|Lookup.Simple|Allows for a single reference to a specific table. All custom lookups are this type.|
10-
|Multiple|This column can contain up to 1,048,576 text characters. You can set the maximum length to be less than this. When you add this column to a form, you can specify the size of the column.|
10+
|Multiple|This column can contain up to 1,048,576 text characters.|
1111
|MultiSelectOptionSet|You can customize forms (main, quick create, and quick view) and email templates by adding choices columns. When you add choices column, you can specify multiple values that will be available for users to select. When users fill out the form they can select one, multiple, or all the values displayed in a drop-down list.|
1212
|Object|Object data type. Can only be used with output properties. |
1313
|OptionSet|This column provides a set of options. Each option has a number value and label. When added to a form, this column displays a control for users to select only one option. |
@@ -16,7 +16,7 @@
1616
|SingleLine.Text|This option simply displays text.|
1717
|SingleLine.TextArea|This format option can be used to display multiple lines of text. But with a limit of 4000 characters, the Multiple Lines of Text column is a better choice if large amounts of text are expected.|
1818
|SingleLine.Ticker|This stores the string time in the format valid for Ticker. Out-of-the-box Unified Interface controls automatically make them clickable links.|
19-
|SingleLine.___URL|The text expected to provides a hyperlink to open the page specified. Out-of-the-box Unified Interface controls automatically prepend https:// to input values that does not begin with a valid protocol . Only HTTP, HTTPS, FTP , FTPS, OneNote and TEL protocols are expected in this column. |
19+
|SingleLine.___URL|The text expected to provides a hyperlink to open the page specified. Out-of-the-box Unified Interface controls automatically prepend "https://" to input values that does not begin with a valid protocol . Only HTTP, HTTPS, FTP , FTPS, OneNote and TEL protocols are expected in this column. |
2020
|TwoOptions|This column provides two options. Each option has a number value of 0 or 1 corresponding to a false or true value. Each option also has a label so that true or false values can be represented as "Yes" and "No", "Hot" and "Cold", "On" and "Off" or any pair of labels you want to display.|
2121
|Whole.None|This option simply displays a number.|
2222

@@ -38,3 +38,6 @@ Following `of-type` property values are not supported currently:
3838
|Lookup.Regarding|Allows for a single reference to multiple tables. These lookups are found in the regarding column used in activities.|
3939
|Status|A system column that has options that generally correspond to active and inactive status. Some system columns have additional options, but all custom columns have only Active and Inactive status options.|
4040
|Status Reason|A system column that has options that provide additional detail about the Status column. Each option is associated with one of the available Status options. You can add and edit the options.|
41+
42+
> [!NOTE]
43+
> At this time File columns are not supported. More information: [File columns](../../../../maker/data-platform/types-of-fields.md#file-columns)

0 commit comments

Comments
 (0)