Scan2Deploy is an application devoted to the initial staging of devices by reading a barcode sequence. Depending on the content of the staging barcodes
Scan2Deploy will (in this order):
- configure the device Wi-Fi network,
- download a data archive from a HTTP/HTTPS server and unpack it to the device,
- execute a series of shell commands
It's worth noticing that the application is not a resident service. The above-mentioned actions are performed as long as
Scan2Deploy is active and in use.
Creating Scan2Deploy files
You will need to create your Scan2Deploy JSON files using a text editor. A JSON schema is available to help ensure valid file content. There are several advantages to using an editor that supports this schema:
- Provides help text for each field
- Provides real-time compiler-like messages letting you know when you have made a mistake
- Allows you to write files faster and with fewer mistakes
A JSON schema file is used to define the structure and features available in Scan2Deploy. The
$schema tag is used to indicate which version of the schema you are using. You can get details regarding versions of the schema along with complete field documentation here.
The latest schema can be referenced like this:
You can also point to a specific version of the schema by pointing to the desired tag. For example:
Choosing an editor
There are several good JSON editors available. We recommend Visual Studio Code. It is free and has many features designed to make writing JSON files easier, including utilizing JSON schemas.
By including the aforementioned
$schema tag in you JSON file, Visual Studio Code will provide automatic tool tips and error underlining:
Some other editors know to use the schema files on schemastore.org when a given file uses a specific file extension that is registered on schemastore.org:
Barcode Generation using dl_config.exe
Scan2Deploy barcodes for Windows CE are generated with
dl_config.exe, a Windows application that runs at the
Command Prompt. Download the latest version here.
dl_config.exe can trigger false positives in some anti-virus software packages, as dl_config.exe uses a popular PDF generation library that has unfortunately been utilized in some viruses as well. Since a portion of the file matches the signature of a virus, it is therefore falsely flagged by anti-virus software packages as potentially harmful. We apologize for any confusion or concerns this may cause, but dl_config.exe is safe to use on any version of Windows and contains no viruses.
The following command will create a PDF document with a
Scan2Deploy barcode, including a description of
Store 123 Wi-Fi and apps:
input-fileis a JSON document, driving the application behavior
output-fileis a PDF document that will be created based on the contents of the
barcodetype: Controls the output barcode type to use, that is QRcode (
2d) or CODE-128 (
1d)- The default value is
barcode1dlimit: Maximum data length for each generated 1D barcode. The default value is
barcode2dlimit: Maximum data length for each generated 2D barcode. The default value is
version: Controls the data encoding version and should not be used unless necessary. The default value is
0for 1D barcodes, and
-1for 1D barcode.
enroll: Android Only Boolean flag instructing DL-Config to generate Scan2Deploy Device Owner Enrollment QRcode in output file. The default value is
description: Free-form description field. Description will be displayed in header of output file. The default description is
encodeonly: *Android Only Boolean flag. If set to
true, the encoded data generated by the tool will only be displayed on the command line for easy copy-paste. This data can be included in a start-activity intent to Scan2Deploy Android, effectively allowing you to "scan" without a barcode and programmatically apply a given configuration. The filename provided for
output-filewill be ignored and a PDF file will not be created. You can therefore enter any value for
dummyare valid values for instance) The default value for
In order to describe the JSON input-file structure, the following example templates show how the available parameters are used: