The "SmartDocs" bar can customize this page to show only the features present on a particular Zebra device.
OSX, MX and Android version information for a device can be found in the Android Settings panel or by querying the device through ADB, EMDK or the MX CSP. More info.
The File Manager (FileMgr) allows an application to manage files on the device. For example, FileMgr permits an app to download a file from a server to the device, copy a file or folder from one area of the device to another and to delete files on the device. The File Manager also can extract files embedded within an XML document and download from the internet with or without basic authentication.
Used to enter the action to be performed on a file.
Parm Name: FileAction
Option | Name | Description | Note | Requires |
---|---|---|---|---|
1 | Transfer/Copy File | Copies a specified file to the device. |
MX: 4.3+ |
|
4 | Delete File | Erases a specified file from the device. |
MX: 4.3+ |
|
9 | Download and Expand Archive File | Copies an archive file to the device and extracts its contents. |
MX: 5.0+ |
Used to enter whether the file will be present in the device file system or embedded within an XML file.
Shown if: File Action is "Transfer/Copy"
Parm Name: TargetAccessMethod
Option | Name | Description | Note | Requires |
---|---|---|---|---|
2 | File in Device File System | Specifies that the file is in the device file system. |
MX: 4.3+ |
Used to enter the destination path and file name on the device to which to copy the object of the File Action.
Parm value input rules:
Shown if: File Action is "Transfer/Copy"
Parm Name: TargetPathAndFileName
Requires:
- MX: 4.3+
Used to enter the location (URI) of the file to copy from a remote server to the device.
Parm value input rules:
Shown if: File Action is "Transfer/Copy"
Parm Name: TargetURI
Requires:
- MX: 4.3+
Used to enter the location of the source file to be copied or transferred.
Parm Name: SourceAccessMethod
Option | Name | Description | Note | Requires |
---|---|---|---|---|
1 | File on remote server | Indicates the source file is on a remote server. |
MX: 4.3+ |
|
2 | File on device file system | Indicates the source file is on the device. |
MX: 4.3+ |
|
3 | File embedded in XML | Indicates the source file is embedded in XML. |
MX: 4.3+ |
Used to enter the URI of the location of the file on the server. Supports HTTP, HTTPS, FTP and FTPS (FTP over TLS or SSL) protocols and basic authentication of URL-embedded credentials. See Examples section for syntax.
Note: HTTP/HTTPS requires MX 7.0 or higher; FTPS requires MX 7.1 or higher.
Parm value input rules:
Note: HTTP/S requires MX 7.0+; FTPS requires MX 7.1+
Shown if: File Action is Transfer/Copy and source is remote server
Parm Name: SourceURI
Requires:
- MX: 4.3+
Used to enter the path and file name of the source file location on the device.
Parm value input rules:
Shown if: File Action is Transfer/Copy and source is on device
Parm Name: SourcePathAndFileName
Requires:
- MX: 4.3+
Used to enter the type of file to be embedded.
Shown if: File Action is "Transfer/Copy" and Source is "Embedded"
Parm Name: SourceType
Option | Name | Description | Note | Requires |
---|---|---|---|---|
1 | General data file (any extension) | Indicates a source file with any extension type. |
MX: 4.3+ |
|
2 | Android application package (.APK file) | Indicates a source file with an .APK extension |
MX: 4.3+ |
|
3 | Android OS Update (.ZIP file) | Indicates a source file with a .ZIP extension. |
MX: 4.3+ |
Used to enter the source file data to be embedded in the XML.
Shown if: File Action is "Transfer/Copy "and Source Type is "File Embedded in XML" and Source Type is "General Data File"
Parm Name: SourceDataAny
Requires:
- MX: 4.3+
Used to enter the APK source file data to be embedded in the XML.
Shown if: File Action is Transfer/Copy and source type is 'File embedded in XML' and Embed type is 'Android Application' remote server
Parm Name: SourceDataApk
Requires:
- MX: 4.3+
Provide the source ZIP file data to be embedded in the XML.
Shown if: File Action is Transfer/Copy and source type is 'File embedded in XML' and Embed type is 'Android OS Update' remote server
Parm Name: SourceDataZip
Requires:
- MX: 4.3+
Used to enter the path and folder name into which the downloaded archive file should be expanded.
Parm value input rules:
Shown if: File Action is "Download and Expand Archive"
Parm Name: ArchiveTargetPathAndFolderName
Requires:
- MX: 5.0+
Used to enter the URI of the source archive/ZIP file.
Parm value input rules:
Shown if: File Action is "Download and Expand Archive"
Parm Name: ArchiveSourceURI
Requires:
- MX: 5.0+
<wap-provisioningdoc>
<characteristic type="FileMgr" version="5.0" >
<parm name="FileAction" value="1"/>
<characteristic type="file-details">
<parm name="TargetAccessMethod" value="2"/>
<parm name="SourceAccessMethod" value="1"/>
<parm name="SourceURI" value=" http://mycompany.com/file/emmtk.war"/>
<parm name="TargetPathAndFileName" value="/internal/tmpp/10m_testfile.bin"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="FileMgr" version="5.0" >
<parm name="FileAction" value="9"/>
<characteristic type="file-details">
<parm name="ArchiveTargetPathAndFolderName" value="/sdcard/Android/extract3"/>
<parm name="ArchiveSourceURI" value="https://secure.mycompany.com/httpsdownload/ArchiveFileTemp.archive"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="FileMgr" version="5.0" >
<parm name="FileAction" value="1"/>
<characteristic type="file-details">
<parm name="TargetAccessMethod" value="2"/>
<parm name="SourceAccessMethod" value="1"/>
<parm name="SourceURI" value="http://username:password@192.168.0.100:21/secure/10m_testfile.bin"/>
<parm name="TargetPathAndFileName" value="/internal/tmpp/10m_testfile.bin"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic version="0.6" type="FileMgr">
<parm name="FileAction" value="1" />
<characteristic type="file-details">
<parm name="TargetAccessMethod" value="2" />
<parm name="TargetPathAndFileName" value="/storage/sdcard0/sample.apk"/>
<parm name="SourceAccessMethod" value="1" />
<parm name="SourceURI" value="ftps://username:password@192.168.0.100:21/secure/10m_testfile.bin" />
</characteristic>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic version="0.6" type="FileMgr">
<parm name="FileAction" value="1" />
<characteristic type="file-details">
<parm name="TargetAccessMethod" value="2" />
<parm name="TargetPathAndFileName" value="/storage/sdcard0/sample.apk"/>
<parm name="SourceAccessMethod" value="1" />
<parm name="SourceURI" value="ftps://username:password@192.168.0.100:21/secure/10m_testfile.bin?implicit=true" />
</characteristic>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="FileMgr" version="5.0" >
<parm name="FileAction" value="1"/>
<characteristic type="file-details">
<parm name="TargetAccessMethod" value="2"/>
<parm name="SourceAccessMethod" value="1"/>
<parm name="SourceURI" value="ftp-p://username:password@192.168.0.100:21/secure/TestFile.apk"/>
<parm name="TargetPathAndFileName" value="/sdcard/TestFile.apk"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="FileMgr" version="5.0" >
<parm name="FileAction" value="1"/>
<characteristic type="file-details">
<parm name="TargetAccessMethod" value="2"/>
<parm name="SourceAccessMethod" value="1"/>
<parm name="SourceURI" value="ftp-p://username:password@192.168.0.100:21/secure/TestFile.apk?ftpClient.keyStore.file=/enterprise/usr/stagenow/vsftpd.p12&ftpClient.keyStore.password=password&ftpClient.keyStore.type=PKCS12&implicit=true&protocol=SSL"/>
<parm name="TargetPathAndFileName" value="/sdcard/TestFile.apk"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
Special (reserved) characters in a user name (i.e. the @ sign) must be encoded. For example, "username@company.com" should appear as "username%40company.com" in the SourceURI (as below).
<wap-provisioningdoc>
<characteristic version="5.0" type="FileMgr">
<parm name="FileAction" value="1" />
<characteristic type="file-details">
<parm name="TargetAccessMethod" value="2" />
<parm name="TargetPathAndFileName" value="/sdcard/TestFile.apk" />
<parm name="SourceAccessMethod" value="1" />
<parm name="SourceURI" value="ftp-p://username%40company.com:password@192.168.0.100:21/Test/TestFile.apk />
</characteristic>
</characteristic>
</wap-provisioningdoc>