Skip to content

Commit b305f1d

Browse files
committed
check
1 parent eda4b08 commit b305f1d

File tree

6 files changed

+120
-9
lines changed

6 files changed

+120
-9
lines changed

powerapps-docs/developer/component-framework/manifest-schema-reference/control.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,7 @@ title: Control Element | Microsoft Docs
33
description: Defines the component's namespace, version and display information.
44
ms.author: noazarur
55
author: noazarur-microsoft
6-
manager: lwelicki
7-
ms.date: 11/21/2022
6+
ms.date: 02/22/2023
87
ms.reviewer: jdaly
98
ms.topic: reference
109
ms.subservice: pcf
@@ -28,7 +27,7 @@ Model-driven and canvas apps
2827
|`constructor`|A method for initializing the object|[!INCLUDE [alphanumerictype-description](includes/alphanumerictype-description.md)]|Yes|Model-driven and canvas apps |
2928
|`control-type`|Whether the control is a standard control or a React control. The value of `virtual` indicates a React control using platform React library. Virtual controls are a feature in public preview. More information: [React controls & platform libraries (Preview) ](../react-controls-platform-libraries.md)|[!INCLUDE [controltype-description](includes/controltype-description.md)]|No|Model-driven and canvas apps |
3029
|`description-key`|Defines the description of the component that will be seen on the UI.|`string`|No|Model-driven and canvas apps |
31-
|`display-name-key`|Defines the name of the control that is displayed on the UI.|`string`|Yes|Model-driven and canvas apps |
30+
|`display-name-key`|Defines the name of the control that is displayed on the UI.|`string`|Yes|Model-driven and canvas apps |
3231
|`preview-image`|Image that will be used on the customization screens to show a preview of the component.|`string`|No|Model-driven apps|
3332
|`version`|Defines the version of the component defined in [Semantic Versioning](https://semver.org)|`string`|Yes|Model-driven and canvas apps |
3433
<!--|`hidden`|Defines whether the component should be hidden or not|[!INCLUDE [booleantype-description](includes/booleantype-description.md)]| No|Model-driven apps|-->
@@ -44,6 +43,7 @@ Model-driven and canvas apps
4443
|Element|Description|Occurrences|
4544
|--|--|--|
4645
|[data-set](data-set.md)|[!INCLUDE [data-set-description](includes/data-set-description.md)]|0 or more|
46+
|[external-service-usage](external-service-usage.md)|[!INCLUDE [external-service-usage-description](includes/external-service-usage-description.md)]|0 or 1|
4747
|[property](property.md)|[!INCLUDE [property-description](includes/property-description.md)]|0 or more|
4848
|[resources](resources.md)|[!INCLUDE [resources-description](includes/resources-description.md)]|1|
4949
|[type-group](type-group.md)|[!INCLUDE [type-group-description](includes/type-group-description.md)]|0 or more|
@@ -52,9 +52,13 @@ Model-driven and canvas apps
5252
## Example
5353

5454
```xml
55-
<control namespace="MyNameSpace" constructor="JSHelloWorldControl" version="1.0.0"
56-
display-name-key="JS_HelloWorldControl_Display_Key" description-key="JS_HelloWorldControl_Desc_Key"
57-
control-type="standard" preview-image="img/preview.png">
55+
<control namespace="MyNameSpace"
56+
constructor="JSHelloWorldControl"
57+
version="1.0.0"
58+
display-name-key="JS_HelloWorldControl_Display_Key"
59+
description-key="JS_HelloWorldControl_Desc_Key"
60+
control-type="standard"
61+
preview-image="img/preview.png">
5862
</control>
5963
```
6064

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
title: ___domain element | Microsoft Docs
3+
description: Indicates the ___domain that the external-usage-element applies to.
4+
ms.author: noazarur
5+
author: noazarur-microsoft
6+
ms.date: 02/22/2023
7+
ms.reviewer: jdaly
8+
ms.topic: reference
9+
ms.subservice: pcf
10+
contributors:
11+
- JimDaly
12+
---
13+
# ___domain Element
14+
15+
[!INCLUDE [___domain-description](includes/___domain-description.md)]
16+
17+
## Available for
18+
19+
Canvas apps
20+
21+
## Parent Elements
22+
23+
|Element|Description|
24+
|--|--|
25+
|[external-service-usage](external-service-usage.md)|[!INCLUDE [external-service-usage-description](includes/external-service-usage-description.md)]|
26+
27+
## Example
28+
29+
```xml
30+
<external-service-usage enabled="true">
31+
<___domain>www.Microsoft.com</___domain>
32+
</external-service-usage>
33+
```
34+
35+
### Related topics
36+
37+
[Power Apps component framework manifest schema reference](index.md)<br/>
38+
[Power Apps component framework API reference](../reference/index.md)<br/>
39+
[Power Apps component framework overview](../overview.md)
40+
41+
42+
[!INCLUDE[footer-include](../../../includes/footer-banner.md)]
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
title: external-service-usage element | Microsoft Docs
3+
description: Indicates whether this control is using external service or not.
4+
ms.author: noazarur
5+
author: noazarur-microsoft
6+
ms.date: 02/22/2023
7+
ms.reviewer: jdaly
8+
ms.topic: reference
9+
ms.subservice: pcf
10+
contributors:
11+
- JimDaly
12+
---
13+
# external-service-usage Element
14+
15+
[!INCLUDE [external-service-usage-description](includes/external-service-usage-description.md)]
16+
17+
## Available for
18+
19+
Canvas apps
20+
21+
## Parent Elements
22+
23+
|Element|Description|
24+
|--|--|
25+
|[control](control.md)|[!INCLUDE [control-description](includes/control-description.md)]|
26+
27+
## Child Elements
28+
29+
30+
|Element|Description|Occurrences|Available for|
31+
|--|--|--|-------|
32+
|[___domain](___domain.md)|[!INCLUDE [___domain-description](includes/___domain-description.md)]|0 or more|Canvas apps |
33+
34+
35+
## Example 1
36+
37+
```xml
38+
<external-service-usage enabled="true">
39+
<___domain>www.Microsoft.com</___domain>
40+
</external-service-usage>
41+
```
42+
43+
## Example 2
44+
45+
```xml
46+
<external-service-usage enabled="false" />
47+
48+
<external-service-usage enabled="false">
49+
<!--UNCOMMENT TO ADD EXTERNAL DOMAINS
50+
<___domain></___domain>
51+
<___domain></___domain>
52+
-->
53+
</external-service-usage>
54+
```
55+
56+
### Related topics
57+
58+
[Power Apps component framework manifest schema reference](index.md)<br/>
59+
[Power Apps component framework API reference](../reference/index.md)<br/>
60+
[Power Apps component framework overview](../overview.md)
61+
62+
63+
[!INCLUDE[footer-include](../../../includes/footer-banner.md)]
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Specifies the ___domain within the [external-service-usage element](../external-service-usage.md)
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Indicates whether this control is using external service or not. If it is, set the enabled attribute flag as true and add the external service ___domain to the `<___domain>` property. A control that uses any external service is a premium control and the end user will need a Power Apps license to open an app with a premium control. More information: [Licensing](../../overview.md#licensing)

powerapps-docs/developer/component-framework/manifest-schema-reference/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,7 @@ title: Power Apps component framework manifest schema reference | Microsoft Docs
33
description: This section contains reference documentation for manifest schema generated using Microsoft Power Platform CLI.
44
ms.author: noazarur
55
author: noazarur-microsoft
6-
manager: lwelicki
7-
ms.date: 05/27/2022
6+
ms.date: 02/22/2023
87
ms.reviewer: jdaly
98
ms.topic: reference
109
ms.subservice: pcf
@@ -17,14 +16,15 @@ contributors:
1716
This section contains reference documentation for manifest schema generated using Microsoft Power Platform CLI.
1817

1918
> [!IMPORTANT]
20-
> The **Available for** tab shows which elements are supported by model-driven and canvas apps. It is recommended to check the **Available for** section for each individual property whether it is supported or not. For example, the **code** element is supported for both model-driven and canvas apps, but **html** and **img** properties in **code** elements doesn't support canvas apps.
19+
> The **Available for** tab shows which elements are supported by model-driven and canvas apps. It is recommended to check the **Available for** section for each individual property whether it is supported or not. For example, the **code** element is supported for both model-driven and canvas apps, but **html** and **img** properties in **code** elements doesn't support canvas apps.
2120
2221
|Element|Description|Available for|
2322
|----|-----------|-----|
2423
|[code](code.md)|[!INCLUDE [code-description](includes/code-description.md)]|Model-driven and canvas apps|
2524
|[control](control.md)|[!INCLUDE [control-description](includes/control-description.md)]|Model-driven and canvas apps|
2625
|[css](css.md)|[!INCLUDE [css-description](includes/css-description.md)]|Model-driven and canvas apps|
2726
|[data-set](data-set.md)|[!INCLUDE [data-set-description](includes/data-set-description.md)]|Model-driven apps|
27+
|[external-service-usage](external-service-usage.md)|[!INCLUDE [external-service-usage-description](includes/external-service-usage-description.md)]|Canvas apps|
2828
|[feature-usage](feature-usage.md)|The feature-usage element acts as a wrapper around the `uses-feature` elements, which themselves allow developers to declare which features their component wants to use. If there are no uses-feature elements defined, the feature-usage element is not required.|Model-driven apps|
2929
|[img](img.md)|[!INCLUDE [img-description](includes/img-description.md)]|Model-driven apps|
3030
|[manifest](manifest.md)|Manifest is the metadata file that defines a component. It is an XML document that describes<br/> - The namespace of the component.<br/> - The kind of data it can be configured, either a field or a data-set.<br/> - Any properties that can be configured in the application when the component is added.<br/> - A list of resource files that the component needs.<br/> - One of them must be a JavaScript web resource. This JavaScript must include a function that will instantiate an object. This implements an interface that exposes methods that are required for the component to work. This is called the component implementation library.<br/> - The name of a JavaScript function in the component implementation library that will return an object that applies the required interface.<br/> When someone configures a component in the application, the data in the manifest filters out the available components so that only valid components for the context are available for configuration. The properties defined in the manifest for a component are rendered as configuration fields so that the person configuring the control can specify values. These property values are then available to your component function at run time.|Model-driven and canvas apps|

0 commit comments

Comments
 (0)