V02.00 | 2018/11
39
8.3
Integrating the Turck RFID App in the Web Application
URLs makes it possible to start the Turck RFID app and configure the Scan screen. In this way,
the RFID app can be started, configured and controlled via a web page. The URL can contain,
for example, configuration information or a web page that automatically opens after a scan op-
eration has been completed. Configuration via URLs enables the integration of the app in exist-
ing web applications.
8.3.1
Transferring configuration parameters – URL format
The configuration parameters are transferred by means of URLs. For this the URLs must be
present in the following data format:
turckrfid://scan?param1=value1¶m2
8.3.2
Overview of the configuration parameters
NOTE
The parameters must be URL-escaped.
Parameters
value
Description
resetConfiguration
true
false
true
resets the existing scan config-
uration before a new configuration
is transferred.
startScanning
true
false
true
starts the scan operation.
Method for sending data
destination
http
Send data via HTTP-POST
Send data by email
clipboard
Send data via the Clipboard
none
Do not send data
HTTP configuration (if destination=http)
httpUrl
URL on a server to which the read data is to be sent.
whenToSend
batch
Batch: Sends after the scan a POST
with the data of all tags located in
the POST data of the handheld, one
line per tag. A batch can contain
any number of tags.
each
Sends a POST for each tag found.
The EPC is contained in the URL
parameters.
extraParameter
(optional)
[Parameter name]
When set, the user is requested to
enter a value for this parameter
with each scan.
tagDataFormat
CSV
Read data in CSV format, one tag
per line. The individual data items
are separated by commas. The fol-
lowing order is used: EPC/UID, TID,
USER data, location
JSON
JSON: Read data as JSON array
Email configuration (if destination=email)