Skip to main content

Save and Scan Page

This last page allows users to make some final configuration, as well as save both the profile (.tar file) and generated barcodes (.pdf file).

Save and Scan page

Name and Description​

Both profile name and description can now be accessed by clicking the edit () icon in the toolbar.

tip

Profile name can also be directly edited within the input on the toolbar.

Editing profile name

Deployment QR Codes​

Once the profile is valid and saved, the generated barcodes will appear at the top of the page. In addition, you can perform the following actions:

  • Download PDF
  • Copy Data
important

If no action is selected that requires file hosting, the barcode(s) may automatically appear as soon as the profile is valid. In this scenario, you will still need to click the save button to retain the profile.

tip

You can click on an individual barcode to open an enlarged view to make it easier to scan from the screen.

Download PDF​

This button allows you to download a PDF document that contains the full set of barcodes generated.

Sample generated PDF

Copy data​

EMM Intent​

This option will copy an intent with the encrypted barcode data formatted for the EMM listed. The list of supported EMMs may expand at a later time.

Copy intent save and print

Profile Data​

This option allows you to copy the underlying data contained in the barcode(s). It is useful for passing the data to the Scan2Deploy app via the start service and start activity intents. Three options are provided:

  • Copy JSON data (no whitespace) - copy unencrypted JSON for use with the start service and start activity intents, either from Java/Kotlin code or an adb shell.

  • Copy JSON data - copy unencrypted data suitable for pasting into a file. Includes newlines and proper spacing. This could be useful if you want to hand-edit the file and re-import it into Scan2Deploy Studio later.

  • Copy encrypted data - primary use case is also to pass to Scan2Deploy via the start service and start activity intents. Unless you intend on making adjustments to the JSON, this is recommended way of passing data via intent since it is encrypted.

Copy data save and print

tip

Right click on barcodes and select Copy Image to copy the barcode image itself. It can then be pasted into the application of your choice.

Next Steps​

The next steps section will give instructions on what is needed to deploy the profile to devices as well as indicate issues that need to be corrected within the profile.

Next steps

tip

This section should show the Scan2Deploy Agent version required to scan the barcode with to successfully deploy the profile. This value will dynamically change based upon the selection of features/actions.

Mobility Suite Updates​

The mobility suite section shows common applications to update on the device. Here you can add/remove updates as well as view some details of the applications, including the version currently added to the profile. In addition, the following symbols will alert to certain scenarios:

  • - A newer update is available than the version currently included (when editing/importing an older profile). Click to download the new update.
  • - Features/settings have been chosen that depend on the version of the application (in this example, Browser has been configured). It is recommended to update to the latest version.

Mobility suite

File Hosting Location​

This section is enabled if your profile requires a Scan2Deploy profile (.tar file) for deployment. Use this section to specify how the profile will be transferred to the device.

tip

Check the tables in the Action Selection page section to understand which settings require a profile host location and which do not.

Server​

Scan2Deploy Studio​

If the Use Studio to automatically host profile from this PC option is selected, the profile will be hosted directly within Scan2Deploy Studio itself. Scan2Deploy Studio inserts the hosting PC's hostname as well as IP addresses for all connected interfaces to increase the likelihood of a successful profile retrieval by the Android device on the connected network.

Important

Scan2Deploy Studio must be running and reachable by the mobile device. When you close the Scan2Deploy UI, it keeps running in the background. See the task tray section for more detail.

External hosting​

If the Use Studio to automatically host profile from this PC option is unselected, the external hosting options will be enabled. In this case, the user is responsible for providing the correct information for where the profile will be hosted. The created barcode will point to the location specified.

Hosted externally

note

SFTP Protocol - If a host key is provided, Scan2Deploy will verify that the server's public key matches the provided host key. If no key is provided, Scan2Deploy will attempt to connect to the server with host key checking disabled.

SFTP host key

The public key can be obtained from the SFTP host server with the ssh-keyscan shell command. For optimal security, the key should either be verified by or provided by the server administrator.

ssh-keyscan -t [type] [host]
  • type - The type of key to fetch from the scanned host. Possible values are rsa, dsa, and ecdsa.
  • host - The host name or ip address of the SFTP host server.

SFTP key scan

Local hosting options​

These options allow you to locate the profile on the device. Some likely use cases would be using an EMM to push the tar file to the device and then applying it using the service intent, or deploying in a scenario where the use of a network connection is not available.

Each storage location and their associated path are defined below:

  • Device storage - the internal flash storage of the device.
    • Path definition: the absolute path to the deployment package on the device.
    • Example: /sdcard/Download/s2d/profile.tar

  • SD card - physical micro SD card. This option only appears in Scan2Deploy Studio if the device you selected on the Action Selection page has an SD card slot.
    • Path definition: path to the deployment package relative to the root of the removable storage device.
    • Example: /s2d/profile.tar

  • USB - a USB hard drive or flash drive attached to the device with an on-the-go USB cable.
    • Path definition: path to the deployment package relative to the root of the removable storage device.
    • Example: /s2d/profile.tar

Additional hosting options

Scan2Deploy Settings​

This section contains a few specialized fields relating to how Scan2Deploy profiles are secured or applied on the device

Final Action​

  • Action - Determines the last action Scan2Deploy should take before finishing profile processing.

    • None - Do no final action (default).
    • Close - Exit the Scan2Deploy Agent activity.
    • Enterprise Reset - Perform an enterprise reset on the device.
    • Factory Reset - Perform a factory reset on the device.
    • Reboot - Perform a device reboot.
    • Intent - Send the provided intent URI.

  • Intent - The intent URI that should be sent. Only applicable if the action field is set to Intent. Two URI schemes are supported within Scan2Deploy, 1) Android App scheme and 2) Intent scheme. An example of how to configure an intent to open the Google webpage within each URI format can be seen below:

    android-app://com.android.chrome/https/google.com/
    note

    In the Android App scheme example, the package is com.android.chrome, the data is https:google.com, and will intent will result in an action of ACTION_VIEW. This will cause Chrome to open a webpage to Google. Other apps will have different package names and expect different data, which could result in custom actions.

    In the intent scheme example, the action and scheme are explicitly stated. However, the app package name is not. This will either resolve to the default browser app, or open a dialog for the user to choose an app. Other intent examples may also include a package, category, or component name.

An example for simply opening a custom app with package com.example.app can be seen here:

android-app://com.example.app

Deployment Settings​

  • Hide from launcher - Caution if checked, Scan2Deploy will become hidden after the barcode read and the profile is processed fully.

  • Backup to enterprise - If checked, Scan2Deploy will back up the current profile to persist through an enterprise reset. The profile will be automatically re-applied after an enterprise reset has occurred. Factory resetting the device will remove the backup profile. See the below table for the required minimum firmware version for supported devices.

    info

    For newer devices such as Memor 11 and Memor 30/35, there are no minimum firmware requirements.

    DeviceOS VersionMinimum Firmware Version
    Joya Touch 2213
    11    		all supported
    1.03.007
    Skorpio X513
    11
    10    		all supported
    3.16.001
    unsupported
    Memor 2013
    11
    9    		all supported
    3.18.004
    unsupported
    Memor 1010
    9
    8.1    		3.03.10
    unsupported
    unsupported
    Unsupported Devices

    Memor 1, Memor K, and Joya Touch A6 devices are not supported

    caution

    The Memor 10 and Memor 20 have limited capacity which can prevent the backup of large profiles.

  • Treat warnings as fatal - If checked, Scan2Deploy will halt deployment of the profile on the device if any warnings are encountered. This requires Scan2Deploy Agent v2.0 or above. This option will be ignored and proceed with the default behavior on older agents.

  • Skip field encryption - If checked, Scan2Deploy will remove any encrypted configuration fields and store all configuration data as plain text. When unchecked, potentially sensitive fields related to Datalogic application configuration (e.g. DL Launcher & DL Browser) will be encrypted within the profile.

    note

    This setting will only be visible if there are features selected that will utilize the additional encryption layer

  • Barcode Expiration Date - Set a date on which the barcode will be invalidated and Agent will no longer accept the profile.

  • Padlock Key - A password that can be set to prevent any Scan2Deploy deployment not containing the key from being accepted.
    If the padlock is enabled on the device and there is a mismatch in the profile vs. device values, the profile will be rejected.
    If the padlock is disabled on the device and the Padlock State is set to Locked, this setting will be set as the device padlock value.

  • Padlock State - Enable/Disable the padlock setting on the device.

    • Default - No change will be made to the device padlock state (Padlock Key will still be required for profile acceptance if the device setting is enabled)
    • Locked - Enables the device padlock. The provided Padlock Key value will be used to accept/reject future deployments on the device.
    • Unlocked - Disables the device padlock. All profiles will be accepted on the device.

    important

    It is not possible to update the padlock key in a single deployment. If it is desired to change the device key, the setting will need to be 1) disabled using the old key, and then 2) enabled with the new key.

Scan2Deploy QR Code Settings​

Version​

Determines how the data in the QR code is encoded.

  • V2 - Default value. Supported in all versions of Scan2Deploy Studio.

  • V3 - Uses a stronger encryption key for enhanced security when generating the QR code (introduced in Scan2Deploy Studio v1.6). This requires Scan2Deploy Agent v1.33 or above on the device to work. See the table below for the required minimum firmware version for some of the devices. Some firmware versions may support the decryption of V3 barcodes, but do not contain Scan2Deploy Agent v1.33. In this scenario, the Agent will need to be updated in order to correctly decode.

    DeviceOS VersionMinimum Firmware VersionMinimum Firmware Version
    (Required agent included)
    Memor 35/35Xallall supportedall supported
    Memor 30/30Xallall supportedall supported
    Joya Touch 22allall supportedall supported
    Memor 11allall supportedall supported
    Skorpio X513
    11
    10    		all supported
    all supported
    2.08.050    		all supported
    3.06.004
    2.11.006
    Memor 2013
    11
    9    		all supported
    all supported
    1.04.15    		all supported
    all supported
    agent update always required
    Memor 1010
    9
    8.1    		all supported
    2.03.04
    1.05.13    		3.00.03
    agent update always required
    agent update always required
    Memor 18.13.06.08agent update always required
    Unsupported Devices

    Joya Touch A6 and Memor K devices are not supported

Silent Deploy​

If checked, Scan2Deploy Agent on the device will silently deploy the profile without launching the UI. Requires a minimum Scan2Deploy QR Code Version of V3, compatible with Scan2Deploy Agent v1.33 and minimum firmware versions listed above.

Android Settings​

This section contains some remaining Android settings that are specific to Scan2Deploy and not included in the Datalogic OEMConfig application.

Default Launcher App​

  • Default Launcher - The launcher application that should be used as the default home/launcher on the device. This includes some common predefined options for convenience.
    • Select Launcher - will make no change to the device.
    • Android Launcher App - will use the standard, default launcher included in the firmware.
    • Datalogic Launcher - will set the Datalogic Launcher as the default.
    • SureLock - will set SureLock as the default.
    • Custom App - will require you to enter the name of a package in the Package name field.
  • Package name - Package name of an APK that that should serve as the device's home/launcher app. Not just any application can be used as a launcher app. It has to meet certain requirements specified by Google to be set as the launcher app.

Default Browser App​

  • Default Browser - The browser application that should be used as the device default. This includes some common predefined options for convenience.
    • Select Browser - will make no change to the device.
    • Android Browser App - will use the standard, default browser included in the firmware.
    • Enterprise Browser - will set the Datalogic Enterprise Browser as the default.
    • SureFox - will set SureFox as the default.
    • Custom App - will require you to enter the name of a package in the Package name field.
  • Package name - Package name of an APK that that should serve as the device's browser app.

Screen Lock​

Enables/Disables the device screen lock (keyguard). Choosing Disable has the same effect as choosing 'None' as the screen lock type on the device. However, this has no effect if a password, pin or pattern is currently set. If Enable is chosen OR a password/pin/pattern is set after the keyguard was disabled, the keyguard will be reenabled. Default value is set to No Action.