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/function-readnfc.md
+13-10Lines changed: 13 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,36 +15,39 @@ search.app:
15
15
- PowerApps
16
16
---
17
17
# ReadNFC function in Power Apps
18
+
18
19
Reads a Near Field Communication (NFC) tag.
19
20
20
21
## Description
21
-
Use **ReadNFC** to read an NFC tag that is in close proximity to your device. When invoked, the screen will display instructions for scanning an NFC tag, and will only return after a tag has been scanned or a timeout expires.
22
22
23
-
**ReadNFC** returns a record of information about the tag that has been read. The record contains:
23
+
Use **ReadNFC** function to read an NFC tag that is close to your device. When invoked, the screen displays instructions for scanning an NFC tag, and only returns after the tag has been scanned or a timeout expires.
24
+
25
+
**ReadNFC** returns a record of information about the tag that has been read. The record contains:
24
26
25
-
|Field| Type | Description |
27
+
|Column| Type | Description |
26
28
|----|----|----|
27
-
|**RTD**| Text | The tag's Record Type Definition (RTD). Only RTD_TEXT and RTD_URI are supported at this time. |
28
-
|**TNF**| Number | The tag's Type Name Format (TNF). Only TNF_WELL_KNOWN is supported at this time. |
29
-
|**Text**| Text | The text payload of the NFC tag if RTD is RTD_TEXT, *blank* otherwise. |
30
-
|**URI**| Hyperlink | The URI payload of the NFC tag if RTD is RTD_URI, *blank* otherwise. |
29
+
|**RTD**| Text | The tag's Record Type Definition (RTD). Only *RTD_TEXT* and *RTD_URI* are supported at this time. |
30
+
|**TNF**| Number | The tag's Type Name Format (TNF). Only *TNF_WELL_KNOWN* is supported at this time. |
31
+
|**Text**| Text | The text payload of the NFC tag if RTD is *RTD_TEXT*, *blank* otherwise. |
32
+
|**URI**| Hyperlink | The URI payload of the NFC tag if RTD is *RTD_URI*, *blank* otherwise. |
31
33
32
-
If the tag is not supported, for example the TNF is not TNF_WELL_KNOWN, or the scan timed out, then the record itself will be *blank* (and all fields will be *blank* too).
34
+
If the tag is not supported, for example, the TNF is not *TNF_WELL_KNOWN*, or the scan timed out, then the record itself will be *blank* (and all the columns will be *blank* too).
33
35
34
36
Always check the payload value for *blank* using the [**IsBlank**](function-isblank-isempty.md) function before using it. You do not need to check the **RTD** and **TNF** values yourself as they must be the correct values for **Text** and **URI** to have a non *blank* value.
35
37
36
-
Additional **RTD** and **TNF** values may be supported in the future. If more values are supported, additional payload fields will also be added. The raw **RTD** and **TNF** values are provided for informational purposes. Information about these values and their use is available through the [NFC Forum](https://nfc-forum.org) and many other books and articles on NFC.
38
+
Additional **RTD** and **TNF** values may be supported in the future. If more values are supported, additional payload columns will also be added. The raw **RTD** and **TNF** values are provided for informational purposes. More information about these values and their use is available through the [NFC Forum](https://nfc-forum.org) and many other books and articles on NFC.
37
39
38
40
If NFC is not supported on the device, a message will be shown to the user and the function will return a *blank* record.
39
41
40
42
**ReadNFC** can only be used in [behavior formulas](../working-with-formulas-in-depth.md).
41
43
42
44
## Syntax
45
+
43
46
**ReadNFC**()
44
47
45
48
## Examples
46
49
47
-
Reads an NFC tag and displays the result. If the result is Text or URI, displays that value to the user. The [**With**](function-with.md) function is used to make the fields of the return record easily accessible.
50
+
Reads an NFC tag and displays the result. If the result is Text or URI, displays that value to the user. The [**With**](function-with.md) function is used to make the columns of the return record easily accessible.
0 commit comments