Skip to main content

ProGlove Documentation

Connect an Android device

To send scanner and other data to INSIGHT webportal, you need to connect your Android devices to your INSIGHT account.

Prerequisite: My Organization hierarchy defined with at least one Level.

Learn more about the ways to connect Android devices to INSIGHT:

  1. Connect with one file for multiple devices

    This method is recommended for devices using INSIGHT Mobile (Android) 1.16.0 and above.

    It allows you to connect multiple Android devices with the same certificate and is the easiest way to connect devices to INSIGHT.

    Staging certificates can be applied to the Android devices either via downloading the file, or a base 64 encoded string in managed Google Play setups from INSIGHT Mobile (Android) 1.19.0, and also via QR code scan.

  2. Connect with individual files for each device

    This method is available for all INSIGHT Mobile (Android) versions and is necessary if connecting devices using INSIGHT Mobile version 1.15.0 and below.

    It is required to use individual staging certificates files for each device you are trying to connect, and the process is limited to connecting a maximum of 10 devices at a time. Connecting many devices to INSIGHT can take some time, so using staging certificates (also referred to as provisioning files) is recommended.

Connect Android devices with a single staging certificate

Staging certificates allow you to connect multiple Android devices to INSIGHT webportal using a single file. Each staging certificate is related to a process level under which connected devices will be displayed when they are enrolled for the first time.

Prerequisite: INSIGHT Mobile (Android) 1.16.0 and above.

Important

Setting up the complete My Organization hierarchy before enrolling Connectivity devices like Gateway and INSIGHT Mobile (Android) is highly recommended. Make sure it resembles your organizational structure and has the hierarchy levels you need before connecting your devices. This will make it easier for you to manage the devices. You can test a smaller number of devices but you might have to re-enroll the devices later when building your complete hierarchy.

  1. Log in to INSIGHT webportal and select Devices.

  2. After recreating your structure and process levels in the My Organization hierarchy, click on the Connect Devices button in the top-right corner. Alternatively, click on the three dots (...) next to the desired level and select + Connect Devices.

    MyOrgStructure_ConnectDevices.png

    A Select a Connectivity Device window displays.

  3. Select INSIGHT Mobile (Android).

    ConnectAndroidDevice.png

    The section displays two options. Select Connect with one file for multiple devices to use a single file across multiple devices or Connect with individual files for each device to create a staging certificate per device.

  4. Select the right option for your environment and click Next. If you choose to use a single file for multiple devices, the next step allows you to select the way you want to apply the staging certificate to your devices. See below for details on each of the different options available. In case you selected the second option and want to connect your devices with individual files, you will be redirected to a different screen to create each of your devices first.

    AndroidApplyStaging.png
    AndroidConnectivityDevicesTakeMeThere.png
    • File-based download:

      Download Staging Certificate: Downloads the staging certificate named after the related process level as a compressed .fleet file. The file needs to be placed on the Android device as described in the next step.

      Scan a QR Code: Available from INSIGHT Mobile (Android) 1.19.0. Downloads the staging certificate via the URL in the QR Code as a compressed .fleet file and applies it to the Android device automatically. The device will then show up on INSIGHT webportal in the Connectivity Devices list.

    • Managed Google Play setup

      Required when connecting a device running on Android 10 or higher to make sure to comply with the scoped storage requirements. Generates and downloads a string containing the staging certificate which can be applied via Managed Google Play Store.

  5. Place the .fleet file containing the staging certificate to your Android device(s) under /sdcard/Android/data/de.proglove.connect/files/. You can do so manually or use your EMM (MDM).

  6. Start INSIGHT Mobile (Android) and continue the usual Pairing process.

    The device will connect to INSIGHT using the staging certificate.

    On INSIGHT, it will show in the Connectivity Devices list under the respective process level.

    The name of the device is the same as the ID shown in the Insight Connectivity section within the INSIGHT Mobile (Android) app. If you prefer to use a different name, make sure to change it immediately after connecting the device.

Connect an Android device by scanning a QR code

An Android device can be connected to INSIGHT webportal at any point in time by scanning a QR code from a particular level in the Devices section. The QR code resembles the staging certificate used by the Android device to connect to the My Organization hierarchy on INSIGHT.

Note

This feature is available from INSIGHT Mobile (Android) 1.19.0.

  1. Find the My Organization level to which you would like to connect the Android device.

  2. Open the action menu by clicking on the three dots (...) next to the desired level and click on Connect via QR Code.

    → A modal displaying a QR Code will open.

  3. On your Android device which has INSIGHT Mobile Android installed, open the Connectivity section and scan the QR Code.

    → The Android device connects to the INSIGHT webportal automatically and displays in the Connectivity Devices list.

ConnDeviceList_ConnectViaQR

Important

Connecting Uniherz Atom devices is not possible by scanning the QR code. We recommend downloading the staging certificate and following the process described here.

Connect Android devices with individual files

You can connect your Android device by downloading provisioning files for each device from INSIGHT and following the procedure described below:

Important

Setting up the complete My Organization hierarchy before enrolling Connectivity Devices like Gateway and INSIGHT Mobile (Android) is highly recommended. Make sure it resembles your organizational structure and has the hierarchy levels you need before connecting your devices. This will make it easier for you to manage the devices. You can test a smaller number of devices but you might have to re-enroll the devices later when building your complete hierarchy.

  1. Log in to INSIGHT webportal and select Devices.

  2. After you have created your hierarchy in the My Organization panel, click the Connect Devices button in the top-right corner, or the three dots (...) next to the desired level, and then + Connect Devices.

    MyOrgStructure_ConnectDevices.png

    A Select a Connectivity Device window displays.

  3. Select INSIGHT Mobile (Android) and Connect with individual files for each device, click Next and then the Take Me There button on the next screen to get redirected to the Create Connectivity Devices section.

    The selected My Organization hierarchy is displayed. You can also create additional sublevels to which your Android device can be associated.

    CreateConnectivityDevicesAndroid.png
  4. Enter the Device Name and click Create Device.

    The Provisioning screen allows you to download the provisioning package or scan the displayed QR code to connect a single device.

    AndroidConnectDeviceDownloadProvisioningFile.png
  5. Decide how you would like to connect the device(s).

    1. Option 1: Scan the QR code with the Android device you would like to connect. The device will then automatically download the provisioning file, connect to INSIGHT and show up in the Connectivity Devices list (available only when connecting a single Android device).

    2. Option 2: Click Download and save the provisioned .zip file.

      Extract the .zip file and upload the Provisioning file to the /sdcard/Android/data/de.proglove.connect/files/ folder on your Android device.

  6. Click Done.

Download the provisioning file from the list

If you click Done before downloading the provisioning file, you can still download the provisioning file by selecting your device from the Connectivity Devices list and clicking the Download Provisioning Files button.

If you select multiple devices, the downloaded .zip file will contain a provisioning file for every device selected.

DownloadProvisioning.png
Connect an Android device by scanning a QR code

An Android device can be connected to INSIGHT webportal at any point in time by scanning a QR code from a particular level in the Devices section. The QR code resembles the staging certificate used by the Android device to connect to the My Organization hierarchy on INSIGHT.

Note

This feature is available from INSIGHT Mobile (Android) 1.19.0.

  1. Find the My Organization level to which you would like to connect the Android device.

  2. Open the action menu by clicking on the three dots (...) next to the desired level and click on Connect via QR Code.

    → A modal displaying a QR Code will open.

  3. On your Android device which has INSIGHT Mobile Android installed, open the Connectivity section and scan the QR Code.

    → The Android device connects to the INSIGHT webportal automatically and displays in the Connectivity Devices list.

ConnDeviceList_ConnectViaQR

Important

Connecting Uniherz Atom devices is not possible by scanning the QR code. We recommend downloading the staging certificate and following the process described here.

Connect by importing proxy settings in the network.json file

If you do not want to include your network's password in the configuration file (created on INSIGHT webportal), you can provide it in the network.json file and upload it directly to your Android device by following these steps:

Create a network.json file
  1. Open a text editor (E.g. Notepad, Sublime Text, VS Code).

  2. Copy the snippet below into the editor.

    {
      "wifi": {
    	"wifi_auth": [
    		{
    		    "ssid": "Your SSID",
    		    "visibility": "ACCESS_POINT_VISIBILITY_VISIBLE",
    		    "wpa_psk": {
    		        "psk": "Your Password"
    		    }
    		}
    	]
      }
    }

    Note

    • To connect a Gateway device and set up your connection using different authentication protocols, see Connect Gateway to Wi-Fi.

    Proxy settings may contain other variables which are relevant for usage on Gateway. Those settings will be ignored on INSIGHT Mobile (Android).

    Table 13. Proxy settings

    Field Name

    Description

    Type

    Example

    Default Value

    Comment

    hostname

    Host name of the proxy server that should be used

    String, URL format without protocol (http, https prefix)

    "mycompanyproxy.com", "192.168.101.1", null

    null

    If this is null, port is expected to be null as well, and no proxy will be set.

    port

    Port number of the proxy server that should be used

    Integer, valid port number

    "8080", null

    null

    If this is null, hostname should be null as well, and no proxy will be set.

    ignore_os_level_proxy_settings

    In case of no specified proxy, check whether to use or ignore proxy settings configured on OS Wi-Fi connection level.

    Boolean

    true, false

    false

    If no proxy is configured, by default OS level proxy will be used. You must specify as "true" if that proxy should be ignored.



  3. Under ssid, replace Your SSID with the name of your Wi-Fi network.

  4. Under psk, replace Your Password with the password for the entered ssid.

  5. Save the file as network.json.

  6. Create a .zip archive of the network.json file and name it network_config.zip. The .zip archive file can contain other files, those will be ignored.

Push network_config.zip file to the Android device

To achieve this, run the following command:

adb push path/to/network_config.zip /sdcard/Android/data/de.proglove.connect/files/network_config.zip

Ensure the network_config.zip file is located in the following location: /sdcard/Android/data/de.proglove.connect/files/ and restart the ProGlove INSIGHT Mobile application.

It is not required for the INSIGHT Mobile app to run while pushing the file. If the application was running when the network_config.zip file was pushed, we recommend to restart it so the new proxy settings can be used.

Note

Alternatively, the same command can run over EMMs that support it.

Re-enroll an Android device to INSIGHT using a Staging Certificate

It is possible to use staging certificates to re-enroll your devices to INSIGHT webportal at different levels of the My Organization hierarchy.

To do so, follow the steps as described under Connect Android devices with a single staging certificate and place the file on a Connectivity Device that has already been enrolled. The Connectivity Device will then show under the new level to which the staging certificate relates.

Connection status

There are five connection statuses:

  1. Not Registered - The Connectivity device has been created using INSIGHT webportal or INSIGHT API via manual connection but the Provisioning file has not been downloaded or could not be created.

  2. Registering - The Connectivity device has been created using INSIGHT webportal or INSIGHT API via manual connection, and the Provisioning file has been downloaded and placed on the device. The device is now trying to connect.

  3. Disconnected - The Connectivity device has not been sending any messages for the last two hours.

  4. Connected - The Connectivity device has been paired with a scanner at least once and has sent a message within the last two hours.

  5. Unknown - The Connectivity device is in an undefined connection state.

Verify connection status

Always make sure your device is successfully connected to INSIGHT webportal. Follow the instructions listed below to ensure your Android device has an active connection with ProGlove.

  1. On INSIGHT webportal:

    1. Log in to INSIGHT webportal and select Devices.

      The Connectivity Devices list displays.

    2. If registered, your device’s status displays in the Status column.

      ConnDevicesListStatus
  2. On INSIGHT webportal:

    1. Connect your scanner to INSIGHT Mobile.

    2. Scan a barcode.

    3. Open INSIGHT webportal.

    4. Select Devices.

      The connected Scanners list displays.

    5. If connected properly, your scanner’s status displays in the Status column.

      ScannerListStatus
Custom device name

Match with a third-party system or simply identify your devices more accurately by setting a custom device name using a managed configuration within your MDM or the Intent API key broadcast.

This can help you bypass the built-in Android 10+ limitations pertaining to sharing device details, and allows you to add custom name/value to the staging file within your MDM. The custom value, i.e. customer_custom_identifier that you define, will be visible to your workforce in the INSIGHT Mobile (Android) app, and sent along with the data to INSIGHT Analytics for reporting purposes and sharper device identification.

For more details on reporting, see export data.

Once the value is set, you can see it displayed as an additional field in the INSIGHT connectivity widget within INSIGHT Mobile, as shown in the image below. That value will also be shared with INSIGHT webportal with every event.

Example created in a test mobile MDM environment and how it is displayed in INSIGHT Mobile (Android).

CustomString.png
Example_Value_for_customer_custom_identifier.png

Note

We recommend setting up the Intent key and value prior to starting the application and work processes.

Tip

Ensure you have the correct value (macro) for retrieving your devices' serial numbers from your third-party system as this may vary (i.e. %SERIALNUM%, {DeviceSerialNumber}, etc.).

Set a custom device name using MDM

You can change the value by broadcasting a different message, bypass (ignore) it to use alternative integration methods, or remove it when needed. Sending the IGNORE value will simply ignore the entered information and allow the integrator to set the value in a different way (using adb or other API methods). Sending REMOVE as a value will remove the entered information, as well as the customer_custom_identifier field from the INSIGHT Mobile (Android) app.

Table 14. Managed configurations

File

Key

Valid values

Supported options

ProGlove.proconfig

configuration_content_android_enterprise_key

Only valid base 64 encoded config files

SET, IGNORE, REMOVE

levelname_provisioning_package.fleet

fleet_provision_content_android_enterprise_key

Only valid base 64 encoded fleet files

SET, IGNORE

customer_custom_identifier

customer_custom_identifier_content_android_enterprise_key

Any string containing 1 - 256 characters

SET, IGNORE, REMOVE



Set a custom device name using Intent

Alternatively, in case setting the custom device name isn't possible via an MDM, you can set it by broadcasting an Intent message containing the Action and Extra values, as listed below:

  • Action: com.proglove.api.SET_EVENT_TAG

  • Extras:

    • com.proglove.api.EVENT_TAG_KEY = "customer_custom_identifier"

    • com.proglove.api.EVENT_TAG_VALUE = "test"

    • com.proglove.api.EVENT_TAG_PERSISTENT = "true"

adb shell am broadcast -a com.proglove.api.SET_EVENT_TAG --es com.proglove.api.EVENT_TAG_KEY "customer_custom_identifier" --es com.proglove.api.EVENT_TAG_VALUE "TEST" --es com.proglove.api.EVENT_TAG_PERSISTENT true
Live Data Connection

Use the Process Analytics section of INSIGHT webportal to view live scan data, and the Device Visibility section to track information on connected devices. More details can be found here.

Note

Make sure that your device’s network connectivity is stable when trying to register it on INSIGHT, or when sending data after the registration.