Deployable Developer Use Cases

Workstation Connect Developer Guide

Creating a JSON configuration file provides increased flexibility for developers to deploy customized settings based on specific user roles.

Create and deploy a set of managed configurations based on the tasks the user needs to accomplish in their workflow.

Configure application shortcuts or device behaviors:

Launch an application or Chrome shortcut upon a docking event.

Change display settings including resolution and density.

Configure desktop elements and status icons based on user permissions.

Assign application behaviors based on a specific device state such as launching a Chrome shortcut or email upon a docking event.

Revoke permissions such as screen capture based on roles.

Display Settings

Configure the orientation (landscape or portrait), resolution, and size of the secondary monitor.

The following JSON snippet sets the secondary monitor orientation to landscape, manual resolution (1920x1080), and size.

{
    "kind": "androidenterprise#managedConfiguration",
    "productId": "com.zebra.workstationconnect.release",
    "managedProperty": [{
        "key": "resolutionAndSizeMode",
        "valueString": "1"
    }, {
        "key": "desktopResolution",
        "valueString": "1920,1080,160,10"
    }, {
        "key": "desktopDensity",
        "valueString": "160"
    }, {
        "key": "desktopOrientation",
        "valueString": "0"
    }]
}

Desktop UI Elements

Configure the UI elements of the application, including shortcuts (application, web, and file), wallpaper, contextual menu, notification panel, and taskbar) on the secondary monitor.

The following JSON snippet enables the visibility of all desktop UI elements except the notification panel.

{
    "kind": "androidenterprise#managedConfiguration",
    "productId": "com.zebra.workstationconnect.release",
    "managedProperty": [{
        "key": "configDesktopUIElements",
        "valueBundle": {
            "managedProperty": [{
                "key": "DesktopUIWallpaper",
                "valueString": "1"
            }, {
                "key": "DesktopUIHomeContextMenu",
                "valueString": "1"
            }, {
                "key": "DesktopUINotificationPanel",
                "valueString": "2"
            }, {
                "key": "DesktopUITaskBar",
                "valueString": "1"
            }, {
                "key": "DesktopUIShortcuts",
                "valueString": "1"
            }]
        }
    }]
}

Status Icons

Configure the visibility of status icons for battery, Bluetooth, cellular, Ethernet, VPN, Wi-Fi, SIP, and audio settings.

The following JSON snippet disables the visibility of icon and audio settings.

{
    "kind": "androidenterprise#managedConfiguration",
    "productId": "com.zebra.workstationconnect.release",
    "managedProperty": [{
        "key": "configStatusIcons",
        "valueBundle": {
            "managedProperty": [{
                "key": "settingsFragmentsStatusIcons",
                "valueString": "2"
            }, {
                "key": "settingsFragmentAudioPanel",
                "valueString": "2"
            }, {
                "key": "ethernetStatusIcon",
                "valueString": "1"
            }, {
                "key": "vpnStatusIcon",
                "valueString": "1"
            }, {
                "key": "sipStatusIcon",
                "valueString": "1"
            }, {
                "key": "batteryStatusIcon",
                "valueString": "1"
            }, {
                "key": "cellularStatusIcon",
                "valueString": "1"
            }, {
                "key": "wiFiStatusIcon",
                "valueString": "1"
            }, {
                "key": "bluetoothStatusIcon",
                "valueString": "1"
            }]
        }
    }]
}

Desktop Shortcuts

Use a shortcut file to deploy a series of application, weblink, or file shortcuts.

The following shortcut file includes an application shortcut, a weblink shortcut with a standard icon, a weblink shortcut with a custom icon, and a file shortcut.

{
    "kind": "androidenterprise#managedConfiguration",
    "productId": "com.zebra.workstationconnect.release",
    "managedProperty": [{
        "key": "configDesktopShortcuts",
        "valueBundle": {
            "managedProperty": [{
                "key": "shortcutImportFile",
                "valueString": [{
                    "addedDatetime": 1701895478546,
                    "appInfo": {
                        "activityName": "com.google.android.apps.chrome.Main",
                        "iconImageString": null,
                        "imagePath": null,
                        "packageName": "com.android.chrome"
                    },
                    "groupInfo": null,
                    "id": "sc2023.12.06.15:44:38.9e4fa1",
                    "modifiedDatetime": 0,
                    "shortcutInfo": null,
                    "type": "application"
                }, {
                    "addedDatetime": 1701895478546,
                    "appInfo": {
                        "activityName": "com.android.documentsui.LauncherActivity",
                        "iconImageString": null,
                        "imagePath": null,
                        "packageName": "com.android.documentsui"
                    },
                    "groupInfo": null,
                    "id": "sc2023.12.06.15:44:38.e537eb",
                    "modifiedDatetime": 0,
                    "shortcutInfo": null,
                    "type": "application"
                }, {
                    "addedDatetime": 1701895553474,
                    "appInfo": null,
                    "groupInfo": null,
                    "id": "sc2023.12.06.15:45:53.f712e6",
                    "modifiedDatetime": 1701895553475,
                    "shortcutInfo": {
                        "browserType": "default",
                        "iconImageString": null,
                        "id": null,
                        "imagePath": null,
                        "name": "Zconnect",
                        "packageName": null,
                        "path": "http://www.zconnect.zebra.com"
                    },
                    "type": "web"
                }, {
                    "addedDatetime": 1701895594602,
                    "appInfo": null,
                    "groupInfo": null,
                    "id": "sc2023.12.06.15:46:34.d0871a",
                    "modifiedDatetime": 1701895594608,
                    "shortcutInfo": {
                        "browserType": "chrome",
                        "iconImageString": "UklGRqAHAABXRUJQVlA4WAoAAAAgAAAARwAARwAASUNDUBgCAAAAAAIYAAAAAAIQAABtbnRyUkdCIFhZWiAAAAAAAAAAAAAAAABhY3NwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAA9tYAAQAAAADTLQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlkZXNjAAAA8AAAAHRyWFlaAAABZAAAABRnWFlaAAABeAAAABRiWFlaAAABjAAAABRyVFJDAAABoAAAAChnVFJDAAABoAAAAChiVFJDAAABoAAAACh3dHB0AAAByAAAABRjcHJ0AAAB3AAAADxtbHVjAAAAAAAAAAEAAAAMZW5VUwAAAFgAAAAcAHMAUgBHAEIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFhZWiAAAAAAAABvogAAOPUAAAOQWFlaIAAAAAAAAGKZAAC3hQAAGNpYWVogAAAAAAAAJKAAAA+EAAC2z3BhcmEAAAAAAAAAACZmYAAPKnAAANWQAAE9AAAApbAAAAAAAAAABYWVogAAAAAAAA9tYAAQAAAADTLW1sdWMAAAAAAAAAAQAAAAxlblVTAAAAIAAAABwARwBvAG8AZwBsAGUAIABJAG4AYwAuACAAMgAwADEANlZQOExiBQAAL0fAEQCnxKBtJEfvuc6f8d03CArbtm1xqW6Fbdu2uFT3/JtN22ZPUvWNa4wAAAAAAAAAAAAAAACQAmVOKWVOUOYEKfdemVOZ07hXmRPUtdS1AK SUOY17lTmllDmlHNnxrP+1vd2RKTt3Bx/mk/
GGOc5br64lpa6lzCllvqefA8qcUiAlJeXfywBq17YZkqQnklXVHtuetW2NzbVtG6NSIjLuP1ydWd07UctvEf1nGABpG7rbrA4BewIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgCvshIftnHN1BxXZcDSCCaKqqqqqO7CPbft0NIIJYghl3YHlGaNjv1WT2x2c1LlhVVWWJyXzx8SQMWXCFa84CngslFkYYTKt4QrUDluMQyNMprXuRUv3/
Kwxl3E1tIjJdDHVPkvePW+koz/
zuEyw3brJdJGuSi5ctz+cjabCQ70nwlAD72h+8Hb9hvnWK32GK+JOePKBjv7o1wOaABxT7TA5ey1jT aB02/
Zzhz7PXTkJ3OjRkcyR32BPnJhO3NFHxSgm/R8+/
Qa9qjUdt49jj5ugnQbzK5OPq1Ej3lezC+SWNVKIPS7z6GtnXnrt4tHFkPTdShnNpJeHoMi47JQx7+ GSy9wYUhSjcPCLcyta8y/
2CoUah9adH9RRWnlG8WzUTi8MFCyFBXNnqKnb/
B7XPDXXUeuSAlXl8SaM+vfK6IMbi6Tqr4i1DNe2pXhpBPQflvSBV+RvciVPZZZZdaztv1M2aN7jaX 1ew owisyRMSVdvN0r6xDS93KUKzTL4XfHvTbnw9fnbTqovycqHWwHu5HgRVxGY+xzZMOv3be5nPt3Rio9L3D2iOjG+wjXgXt615ZHSR8EGL11SmL6N5VZnl6pGc/
W6FB/
wcbkhcddWbEj0ybAewjHpTQg0R+WUPkT1qmTCdyx+mvgj3yu1PnM59lgQHM37kqiQ7r/
GO6FMmLxW5n52r9zYGKWz78Lg+VmtPJON7rrpEN6UMUbGKPV1qrjxexx15r5kyFyq2VfKrInvFASBjEwr8zbndl87UWZttXU6TRlZnWYIbQ/DUCYOvx169BWDi4mCT6iyMzNmKWW+Ow5NPP/
TwC+ZvhW1049w2eFkfCQ5uIf3n/
QvWpejJP4Uyssj/l3SRi2GpH//
JKnzRQ695Wyd869Z/Ugm/
rBy2eRNaXd3Z0bvc33iGAVPfTH9aHgTvtRbhA9+6UtzKdlfwW/
3zs3Fy9n2STnL37LLyc1nAN6C88XRh78MJmeZbzR8+1+gwWvYPytQ/
xNSxjFyHNfYkbTUvFktJlyNRKVmdk/02ShrrR3azNnKlt2qdFT5wA0oKC1DnMt9fcY/7GupTmVqyxS4IJAOkktReJAh5a5An/nKKn5XXfcTq/
m6ajyldH5zGcikCjIIkrB9s7nAEiqScVe0yg0kB2Ur6ZJELg4opF/
7XytU4I80f1u94isyyZZFHojvV2xCBttJrnJAt0cxI7nzVFPaai2hAiPUCae2gUwSxCu65VTCqeCp4qbnMeNp1CVzRleuXMlC8Y0Sq2CjBJ9qxc4dmh0Rj5f/
BdnderB2AlItkKH6mAjpRyMqRaq/
oayofKBXa0r6XM/UnbpkWiaqYfcld/
TNzHWqe9svWC9+8pb6ThOsOrXfaksKf0eir+jNQDecuyJVmY+8b7GJOlW3TQvWCL+xchmWwrnM4mc1LG tdGZRVUQ9iUDeR1cpgSwbkhXODq575fVn3sOhK/tORLg\u003d\u003d",
                        "id": null,
                        "imagePath": "/data/user/0/com.zebra.workstationconnect.release/app_user_custom_shortcuts/download792.jpeg",
                        "name": "Zebra",
                        "packageName": null,
                        "path": "https://www.zebra.com"
                    },
                    "type": "web"
                }, {
                    "addedDatetime": 1701895634929,
                    "appInfo": {
                        "activityName": "com.reflexisinc.mywork17.MainActivity",
                        "iconImageString": null,
                        "imagePath": null,
                        "packageName": "com.reflexisinc.mywork17"
                    },
                    "groupInfo": null,
                    "id": "sc2023.12.06.15:47:14.4c1fab",
                    "modifiedDatetime": 1701895634929,
                    "shortcutInfo": null,
                    "type": "application"
                }, {
                    "addedDatetime": 1701895668792,
                    "appInfo": null,
                    "groupInfo": null,
                    "id": "sc2023.12.06.15:47:48.816a78",
                    "modifiedDatetime": 1701895668792,
                    "shortcutInfo": {
                        "browserType": "default",
                        "iconImageString": null,
                        "id": null,
                        "imagePath": null,
                        "name": "Image",
                        "packageName": "images.jpeg",
                        "path": 
"content://com.android.providers.downloads.documents/document/msf%3A80"
                    },
                    "type": "local_file"
                }]
            }]
        }
    }]
}

Application Behavior

Configure application behaviors such as the ability to create shortcuts, user access, and window states for applications such as web browsers, email, or video conferencing.

The following JSON snippet uses four package names for applications and launches them upon docking the device.

{
    "kind": "androidenterprise#managedConfiguration",
    "productId": "com.zebra.workstationconnect.release",
    "managedProperty": [{
        "key": "configAppBehavior",
        "valueBundle": {
            "managedProperty": [{
                "key": "appCriteria",
                "valueBundleArray": [{
                    "managedProperty": [{
                        "key": "autoMovePackagename",
                        "valueString": "com.android.chrome"
                    }, {
                        "key": "dockingCondition",
                        "valueBundle": {
                            "managedProperty": [{
                                "key": "dockingWindowState",
                                "valueString": "2"
                            }, {
                                "key": "dockingAction",
                                "valueString": "2"
                            }]
                        }
                    }, {
                        "key": "undockingCondition",
                        "valueBundle": {
                            "managedProperty": [{
                                "key": "undockingAction",
                                "valueString": "1"
                            }]
                        }
                    }]
                }, {
                    "managedProperty": [{
                        "key": "autoMovePackagename",
                        "valueString": "com.google.android.gm"
                    }, {
                        "key": "dockingCondition",
                        "valueBundle": {
                            "managedProperty": [{
                                "key": "dockingWindowState",
                                "valueString": "3"
                            }, {
                                "key": "dockingAction",
                                "valueString": "2"
                            }]
                        }
                    }, {
                        "key": "undockingCondition",
                        "valueBundle": {
                            "managedProperty": [{
                                "key": "undockingAction",
                                "valueString": "3"
                            }]
                        }
                    }]
                }, {
                    "managedProperty": [{
                        "key": "autoMovePackagename",
                        "valueString": "com.android.settings"
                    }, {
                        "key": "accessibilityOptions",
                        "valueBundle": {
                            "managedProperty": [{
                                "key": "accessibilityLaunchShortcut",
                                "valueString": "2"
                            }, {
                                "key": "accessibilityTaskbarMoveToDevice",
                                "valueString": "2"
                            }, {
                                "key": "accessibilityAllApps",
                                "valueString": "2"
                            }, {
                                "key": "taskbarIcon",
                                "valueString": "2"
                            }, {
                                "key": "accessibilityCreateShortcut",
                                "valueString": "2"
                            }, {
                                "key": "accessibilityNotification",
                                "valueString": "2"
                            }, {
                                "key": "accessibilityTaskbarMoveToDesktop",
                                "valueString": "2"
                            }]
                        }
                    }]
                }, {
                    "managedProperty": [{
                        "key": "autoMovePackagename",
                        "valueString": "us.zoom.videomeetings"
                    }, {
                        "key": "taskbarImmersiveMode",
                        "valueString": "2"
                    }]
                }]
            }]
        }
    }]
}

Taskbar

Configure the ability to capture screenshots and the visibility of the All Applications button and mobile application icons.

The following JSON snippet disables the visibility of the All Applications button, mobile application icons, and the screenshot capture icon.

{
    "kind": "androidenterprise#managedConfiguration",
    "productId": "com.zebra.workstationconnect.release",
    "managedProperty": [{
        "key": "captureScreenshot",
        "valueString": "2"
    }, {
        "key": "TaskbarCapability",
        "valueBundle": {
            "managedProperty": [{
                "key": "AllAppsButton",
                "valueString": "2"
            }, {
                "key": "DisplayMobileApps",
                "valueString": "2"
            }]
        }
    }]
}

Device Behavior

Configure settings on the device such as screen dimming, resetting the configuration, configuration update behavior, and versioning.

The following JSON snippet dims the mobile device, enables configuration reset for the device user, updates the configuration immediately, and allows the administrator to provide a numeric value to associate with the current configuration.

{
    "kind": "androidenterprise#managedConfiguration",
    "productId": "com.zebra.workstationconnect.release",
    "managedProperty": [{
        "key": "zwcConfigurationVersion",
        "valueString": "1"
    }, {
        "key": "configurationMode",
        "valueString": "Immediately"
    }, {
        "key": "DeviceCapability",
        "valueBundle": {
            "managedProperty": [{
                "key": "DimmingMobileScreen",
                "valueString": "1"
            }]
        }
    }]
}

The following screenshot displays the UI when the configuration described in this section is deployed.