You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: powerapps-docs/maker/canvas-apps/functions/data-types.md
+15-1Lines changed: 15 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ ms.service: powerapps
7
7
ms.topic: reference
8
8
ms.custom: canvas
9
9
ms.reviewer: tapanm
10
-
ms.date: 05/19/2019
10
+
ms.date: 02/07/2020
11
11
ms.author: gregli
12
12
search.audienceType:
13
13
- maker
@@ -56,6 +56,20 @@ Because all data types support *blank*, the **Boolean** and **Two option** data
56
56
57
57
All four of these data types are based on a [Unicode](https://en.wikipedia.org/wiki/Unicode) text string.
58
58
59
+
### Embedded text
60
+
61
+
Embedded text strings in a formula are enclosed in double quotation marks. Use two double quotes together to represent a single double quote in the text string. For example, using the following formula in the **OnSelect** property of a [**Button**](../controls/control-button.md) control:
62
+
63
+
```powerapps-dot
64
+
Notify( "Jane said ""Hello, World!""" )
65
+
```
66
+
67
+
results in a banner when the button is pressed, where the first and last double quotes are omitted (as they delimit the text string) and the repeated double quotes around **Hello, World!** are replaced with a single double quote:
68
+
69
+
70
+
71
+
Single quotation marks are not used for [identifier names](operators.md#identifier-names) that contain special characters and have no significance within a text string.
72
+
59
73
### Image and Media resources
60
74
61
75
Through the **File** menu, you can add image, video, and audio files as app resources. The name of the imported file becomes the resource name in the app. In this graphic, the Northwind Traders logo, which is named **nwindlogo**, has been added to an app:
Copy file name to clipboardExpand all lines: powerapps-docs/maker/canvas-apps/functions/function-choices.md
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -86,7 +86,7 @@ At this time, you can use lookup columns only with SharePoint and Common Data Se
86
86
87
87
88
88
89
-
1. On the **Home** tab, select **New screen**, and then select **Blank**.
89
+
1.For illustration purposes, we can view the complete table returned by the **Choices** function in a **Data table** control. On the **Home** tab, select **New screen**, and then select **Blank**.
Copy file name to clipboardExpand all lines: powerapps-docs/maker/canvas-apps/functions/function-encode-decode.md
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -40,7 +40,7 @@ The return value from these functions is the encoded or decoded string. This fun
40
40
If you show an RSS feed in a text gallery and then set the **[Text](../controls/properties-core.md)** property of a label in that gallery to **ThisItem.description**, the label might show raw HTML or XML code as in this example:
41
41
42
42
```html
43
-
<p>We have done an unusually "deep" globalization and localization.<p>
43
+
<p>We have done an unusually "deep" globalization and localization.</p>
44
44
```
45
45
46
46
If you set the **[Text](../controls/properties-core.md)** property of the label to **PlainText(ThisItem.description)**, the text appears as in this example:
Copy file name to clipboardExpand all lines: powerapps-docs/maker/canvas-apps/functions/function-ismatch.md
+1-2Lines changed: 1 addition & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ ms.service: powerapps
7
7
ms.topic: reference
8
8
ms.custom: canvas
9
9
ms.reviewer: tapanm
10
-
ms.date: 08/15/2019
10
+
ms.date: 02/07/2020
11
11
ms.author: gregli
12
12
search.audienceType:
13
13
- maker
@@ -177,7 +177,6 @@ The user types **Hello world** into **TextInput1**.
177
177
|`IsMatch( "111-11-1111", "\d{3}-\d{2}-\d{4}" )`| Matches a United States Social Security number. Validates the format, type, and length of the supplied input field. The string to match must consist of three numeric characters followed by a dash, then two numeric characters followed by a dash, and then four numeric characters. |**true**|
178
178
|`IsMatch( "111-111-111", "\d{3}-\d{2}-\d{4}" )`| Same as the previous example, but one of the hyphens is out of place in the input. |**false**|
179
179
|`IsMatch( "AStrongPasswordNot", "(?!^[0-9]\*$)(?!^[a-zA-Z]\*$)([a-zA-Z0-9]{8,10})" )`| Validates a strong password, which must contain eight, nine, or 10 characters, in addition to at least one digit and at least one alphabetic character. The string must not contain special characters. |**false**|
180
-
|`IsMatch( "<https://microsoft.com>", "(ht|f)tp(s?)\:\/\/\[0-9a-zA-Z\]([-.\w]\*[0-9a-zA-Z])\*(:(0-9)\*)\*(\/?)([a-zA-Z0-9\-\.\?\,\'\/\\\+&%\$#_]\*)?" )`| Validates an http, https, or ftp URL. |**true**|
Copy file name to clipboardExpand all lines: powerapps-docs/maker/canvas-apps/functions/function-update-updateif.md
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -59,7 +59,7 @@ In these examples, you'll replace or modify records in a data source that's name
59
59
| Formula | Description | Result |
60
60
| --- | --- | --- |
61
61
|**Update( IceCream,<br>First( Filter( IceCream, Flavor="Chocolate" ) ), { ID: 1, Flavor: "Mint Chocolate", Quantity:150 } )**|Replaces a record from the data source. |<style> img { max-width: none } </style> <br><br>The **IceCream** data source has been modified. |
62
-
|**UpdateIf( IceCream, Quantity > 175, { Quantity: Quantity + 10 } )**|Modifies records that have a **Quantity** that is greater than **150**. The **Quantity** field is incremented by 10, and no other fields are modified. |<br><br>The **IceCream** data source has been modified. |
62
+
|**UpdateIf( IceCream, Quantity > 175, { Quantity: Quantity + 10 } )**|Modifies records that have a **Quantity** that is greater than **175**. The **Quantity** field is incremented by 10, and no other fields are modified. |<br><br>The **IceCream** data source has been modified. |
63
63
|**Update( IceCream,<br>First( Filter( IceCream, Flavor="Strawberry" ) ),<br>{ ID: 3, Flavor: "Strawberry Swirl"} )**|Replaces a record from the data source. The **Quantity** property hasn't been supplied in the replacement record, so that property will be *blank* in the result. |<br><br>The **IceCream** data source has been modified. |
64
64
|**UpdateIf( IceCream, true, { Quantity: 0 } )**|Sets the value of the **Quantity** property for all records in the data source to 0. |<br> <br>The **IceCream** data source has been modified. |
Copy file name to clipboardExpand all lines: powerapps-docs/maker/canvas-apps/functions/operators.md
+21-2Lines changed: 21 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ ms.service: powerapps
7
7
ms.topic: reference
8
8
ms.custom: canvas
9
9
ms.reviewer: tapanm
10
-
ms.date: 07/24/2017
10
+
ms.date: 02/07/2020
11
11
ms.author: gregli
12
12
search.audienceType:
13
13
- maker
@@ -51,6 +51,25 @@ Some of these operators are dependent on the language of the author. See [Globa
51
51
|**Parent**|[Parent operator](#parent-operator)|**Parent.Fill**| Access to properties of a control container |
52
52
|**ThisItem**|[ThisItem operator](#thisitem-operator)|**ThisItem.FirstName**| Access to fields of a Gallery or form control |
53
53
54
+
## Identifier names
55
+
56
+
The names of variables, data sources, columns, and other objects can contain any [Unicode](https://en.wikipedia.org/wiki/Unicode).
57
+
58
+
Use single quotes around a name that contains a space or other special character. Use two single quotes together to represent one single quote in the name. Names that do not contain special characters do not require single quotes.
59
+
60
+
Here are some example column names you might encounter in a table, and how they are represented in a formula:
61
+
62
+
| Column name in a database | Column reference in a formula |
| Name with "double" quotes |```'Name with "double" quotes'```|
68
+
| Name with 'single' quotes |```'Name with ''single'' quotes'```|
69
+
| Name with an @ at sign |```'Name with an @ at sign'```|
70
+
71
+
Double quotes are used to [designate text strings](data-types.md#embedded-text).
72
+
54
73
## in and exactin operators
55
74
You can use the **[in](operators.md#in-and-exactin-operators)** and **[exactin](operators.md#in-and-exactin-operators)** operators to find a string in a [data source](../working-with-data-sources.md), such as a collection or an imported table. The **[in](operators.md#in-and-exactin-operators)** operator identifies matches regardless of case, and the **[exactin](operators.md#in-and-exactin-operators)** operator identifies matches only if they're capitalized the same way. Here's an example:
56
75
@@ -67,7 +86,7 @@ You can use the **[in](operators.md#in-and-exactin-operators)** and **[exactin](
67
86
## ThisItem operator
68
87
You can show data in **[Gallery](../controls/control-gallery.md)**, **[Edit form](../controls/control-form-detail.md)**, or **[Display form](../controls/control-form-detail.md)** controls by binding it to a table or a collection. These controls are a container for other cards and controls. Each card or control within the container can access the bound data through the **[ThisItem](operators.md#thisitem-operator)** operator.
69
88
70
-
You use the **[ThisItem](operators.md#thisitem-operator)** operator to specify the [column](../working-with-tables.md#columns) of data that each card or control within the outer control. For example, that operator in the product gallery for [Show images and text in a gallery](../show-images-text-gallery-sort-filter.md) specified that the image control showed the product design, the upper label showed the product name, and the lower label showed the number of units in stock.
89
+
Use the **[ThisItem](operators.md#thisitem-operator)** operator to specify the [column](../working-with-tables.md#columns) of data to be displayed in each card or control within the outer control. For example, that operator in the product gallery for [Show images and text in a gallery](../show-images-text-gallery-sort-filter.md) specified that the image control showed the product design, the upper label showed the product name, and the lower label showed the number of units in stock.
71
90
72
91
For nested galleries, **[ThisItem](operators.md#thisitem-operator)** refers to the innermost gallery's items. Assuming the row fields in the inner and outer galleries don't conflict, you can also use the unqualified field (column) names directly. This approach enables rules in an inner gallery to refer to an outer gallery's items.
Copy file name to clipboardExpand all lines: powerapps-docs/maker/canvas-apps/working-with-variables.md
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ ms.service: powerapps
7
7
ms.topic: conceptual
8
8
ms.custom: canvas
9
9
ms.reviewer: tapanm
10
-
ms.date: 02/28/2019
10
+
ms.date: 02/07/2020
11
11
ms.author: gregli
12
12
search.audienceType:
13
13
- maker
@@ -180,7 +180,7 @@ Then you can simply use **Radius** anywhere that you can use a number, and it wi
180
180
181
181
`Pi() * Power( Radius, 2 )`
182
182
183
-
If you give a context variable the same name as a global variable or a collection, the context variable takes precedence. However, you can still reference the global variable or collection if you use the [disambiguation operator](functions/operators.md#disambiguation-operator)**@[Radius]**.
183
+
If you give a context variable the same name as a global variable or a collection, the context variable takes precedence. However, you can still reference the global variable or collection if you use the [disambiguation operator](functions/operators.md#disambiguation-operator)**[@Radius]**.
0 commit comments