Skip to content

Commit c108869

Browse files
committed
updates
1 parent 3effca3 commit c108869

File tree

2 files changed

+23
-25
lines changed

2 files changed

+23
-25
lines changed

powerapps-docs/maker/canvas-apps/code-view.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ With code view you can:
3131

3232
Code view shows the code for the selected control and all its child controls.
3333

34-
Code view lets you copy and paste code to any screen in your app, or outside of Power Apps, to duplicate the control. This duplication feature is helpful when controls are highly customized and you want to share or duplicate it.
34+
Code view lets you copy and paste code to any screen in your app or outside of Power Apps to duplicate the control. This feature is helpful when controls are highly customized and you want to share or duplicate them.
3535

3636
### View code
3737

@@ -46,19 +46,19 @@ Code view lets you copy and paste code to any screen in your app, or outside of
4646
4747
### Copy and paste code
4848

49-
1. To copy the code of a selected control, you can:
49+
1. To copy the code of a selected control:
5050
- Use the menu to copy.
51-
- Use the shortcut "ctrl + c"
51+
- Use the shortcut <kbd>Ctrl</kbd>+<kbd>C</kbd>.
5252
- When viewing your code in the code view popup, select **Copy code**.
5353
1. To add a new control from the code:
5454

55-
- Use the menu to paste.
56-
- Use the shortcut "ctrl + v"
55+
- Use the menu to paste.
56+
- Use the shortcut <kbd>Ctrl</kbd>+<kbd>V</kbd>.
5757

5858
:::image type="content" source="media/code-view/paste-code.png" alt-text="Screenshot of the tree view in Power Apps Studio, with the Paste code option highlighted on a control's context menu.":::
5959

6060
> [!IMPORTANT]
61-
> You must use the YAML format that Power Apps Studio generates. The code is validated before the new control is created.
61+
> Use the YAML format that Power Apps Studio generates. The code is validated before the new control is created.
6262
6363
## Known limitations
6464

powerapps-docs/maker/canvas-apps/power-apps-yaml.md

Lines changed: 17 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -17,13 +17,12 @@ ms.custom:
1717

1818
# View source code files for canvas apps
1919

20-
You can use the source code for a canvas app to review changes made my makers in Power Apps Studio. The generated canvas app YAML code is read-only and shouldn't be modified. Any change in the file will be ignored and can be lost.
20+
Use the source code for a canvas app to review changes made by makers in Power Apps Studio. The generated canvas app YAML code is read-only and can't be modified. Any changes to the file are ignored and might be lost.
2121

22-
> [!NOTE]
23-
> - The YAML schema is in active development, the content may be incomplete.
24-
> - The current static schema for ***.pa.yaml** files can be found, [here](https://raw.githubusercontent.com/microsoft/PowerApps-Tooling/refs/heads/master/schemas/pa-yaml/v3.0/pa.schema.yaml).
22+
> - The YAML schema is in active development, and the content might be incomplete.
23+
> - The current static schema for ***.pa.yaml** files is available [here](https://raw.githubusercontent.com/microsoft/PowerApps-Tooling/refs/heads/master/schemas/pa-yaml/v3.0/pa.schema.yaml).
2524
26-
We use Power Fx and YAML as the languages for Power Apps source code. YAML is appreciated for its human-readable format and benefits from a wide array of existing editors, tools, and libraries for its manipulation.
25+
Power Fx and YAML are the languages used for Power Apps source code. YAML is valued for its human-readable format and benefits from a wide array of editors, tools, and libraries for manipulation.
2726

2827
## Access source code files
2928

@@ -32,7 +31,7 @@ You have access to the source code files if you're using the [Dataverse Git Inte
3231
The Power Apps Studio creates the source code for canvas apps, which is stored as *.pa.yaml files within the **.msapp** file. The **.msapp** file is a binary file that contains a collection of files, including the source code.
3332

3433
> [!TIP]
35-
> To effectively use ALM, it's recommended to use solutions. [Canvas apps package](export-import-app-package.md) doesn't support ALM and should only be used for basic import and export capabilities when Dataverse isn't available.
34+
> To effectively use application lifecycle management (ALM), it's recommended to use solutions. [Canvas apps package](export-import-app-package.md) doesn't support ALM and should only be used for basic import and export capabilities when Dataverse isn't available.
3635
3736
You can also get the source code files either from the **.msapp** file or by using [Power Platform CLI](/power-platform/developer/cli/introduction).
3837

@@ -78,36 +77,35 @@ Only ***.pa.yaml** files within the **\src** folder can be used as source code.
7877

7978
## Power Apps YAML schema versions
8079

81-
Currently there are three schema versions of Power Apps Source Code:
80+
Currently, there are three schema versions of Power Apps source code:
8281

83-
|Format Name|File Extension|Description|
82+
|Format name|File extension|Description|
8483
|-----------|-----------|-------|
85-
| [Experimental](power-apps-yaml.md#experimental-format-fxyaml) | *.fx.yaml| Version used by the experimental [Power Apps Git version control](git-version-control.md) and [pac canvas unpack](/power-platform/developer/cli/reference/canvas#pac-canvas-unpack) - no longer in development.|
86-
| [Early Preview](power-apps-yaml.md#early-preview) | - | The version used by code view, copy code, and paste code. There's no version information in this schema, therefore it isn't suitable for version control. When [code view](code-view.md) is generally available (GA), it switches to the source code preview format.|
87-
| [Source Code](power-apps-yaml.md#source-code-payaml) | *.pa.yaml files | Includes enhancements and version details for source control and it is in active development. |
84+
| [Experimental](power-apps-yaml.md#experimental-format-fxyaml) | *.fx.yaml| Version used by the experimental [Power Apps Git version control](git-version-control.md) and [pac canvas unpack](/power-platform/developer/cli/reference/canvas#pac-canvas-unpack)no longer in development.|
85+
| [Early preview](power-apps-yaml.md#early-preview) | - | The version used by code view, copy code, and paste code. There's no version information in this schema, so it isn't suitable for version control. When [code view](code-view.md) is generally available (GA), it switches to the source code preview format.|
86+
| [Source code](power-apps-yaml.md#source-code-payaml) | *.pa.yaml files | Includes enhancements and version details for source control and is in active development. |
8887

8988
## Experimental format (*.fx.yaml)
9089

91-
This schema represents an experimental format employed by the Power Platform CLI to process and convert canvas apps into a source code format. However, this format is no longer being actively developed.
90+
This schema describes an experimental format used by the Power Platform CLI to process and convert canvas apps into a source code format. This format isn't actively developed anymore.
9291

93-
You can't directly convert ***.fx.yaml** files to the new formats. To convert older apps, you need to package the canvas app as a **.msapp** file and import it into Power Apps Studio.
92+
You can't directly convert ***.fx.yaml** files to the new formats. To convert older apps, package the canvas app as a **.msapp** file and import it into Power Apps Studio.
9493

9594
## Preview
9695

97-
This version is used by [Code view](code-view.md) during the [preview](working-with-experimental-preview.md#preview) period. It is designed to create canvas apps in Power Apps Studio, allowing you easily copy and paste controls. In this version, the source code is used in Power Apps Studio instead of being converted (like the experimental format).
96+
This version is used by [Code view](code-view.md) during the [preview](working-with-experimental-preview.md#preview) period. It is designed to create canvas apps in Power Apps Studio, letting you easily copy and paste controls. In this version, the source code is used in Power Apps Studio instead of being converted, like the experimental format.
9897

99-
The format during the preview was temporary and it is no longer in use. You can paste code from the preview format.
98+
The format during the preview was temporary and is no longer in use. You can paste code from the preview format.
10099

101100
Here are the changes made from the experimental format:
102101

103-
1. **ZIndex Property Removal**: The ZIndex property is removed. Instead, a screen is now represented as an array of controls. The order of controls now determines their stacking order. Normal controls are ordered in ascending order, while responsive controls are ordered in descending order.
104-
1. **JSON Object Representation Replacement**: We no longer use the "As" syntax to define the control type. Instead, the left side of the control's name identifier remains unique. Only properties that differ from the default values are serialized. Two new properties are added to define the control type and default values:
102+
1. **ZIndex property removal**: The ZIndex property is removed. Instead, a screen is represented as an array of controls. The order of controls determines their stacking order. Normal controls are ordered in ascending order, while responsive controls are ordered in descending order.
103+
1. **JSON object representation replacement**: The "As" syntax is no longer used to define the control type. Instead, the left side of the control's name identifier remains unique. Only properties that differ from the default values are serialized. Two new properties define the control type and default values:
105104

106105
- **Control**: Represents the control type in YAML.
107-
- **Variant**: Identifies a variant of a control type, which might alter default property values, add or remove properties, or modify the behavior/layout of the control.
106+
- **Variant**: Identifies a variant of a control type, which might alter default property values, add or remove properties, or modify the behavior or layout of the control.
108107

109108
These properties are used for instantiating controls and don't accept Power Fx expressions.
110-
111109
## Source code (*.pa.yaml)
112110

113111
> [!IMPORTANT]

0 commit comments

Comments
 (0)