[SmartDocs] バーでは、特定の Zebra デバイスに存在する機能のみを表示するように、このページをカスタマイズできます。
デバイスの OSX、MX および Android のバージョン情報は、Android の設定パネルに表示されるか、ADB、EMDK、または MX CSP を使用してデバイスを照会することで確認できます。詳細情報。
ファイル マネージャ (FileMgr) を使用すると、アプリケーションでデバイス上のファイルを管理できます。たとえば、FileMgr では、アプリがサーバーからデバイスにファイルをダウンロードしたり、デバイスのある領域から別の領域にファイルまたはフォルダをコピーしたり、デバイス上のファイルを削除したりできます。ファイル マネージャは、XML ドキュメントに埋め込まれたファイルを抽出し、基本認証ありまたはなしでインターネットからダウンロードすることもできます。
重要: ファイル マネージャは匿名 FTP をサポートしていません。
ファイルに対して実行するアクションを選択するために使用されます。
パラメータ名: FileAction
| オプション | 名前 | 説明 | 注記 | 要件 |
|---|---|---|---|---|
| 1 | ファイルの転送/コピー | 指定したファイルをデバイスにコピーします。 |
MX: 4.3+ |
|
| 2 | ファイルのアップロード | 指定したファイルをデバイスからリモート システムにアップロードします。 |
MX: 10.1+ |
|
| 4 | ファイルの削除 | 指定したファイルをデバイスから消去します。 |
MX: 4.3+ |
|
| 9 | アーカイブ ファイルをダウンロードして展開 | アーカイブ ファイルをデバイスにコピーし、その内容を抽出します。 |
MX: 5.0+ |
リモート サーバーからデバイスにコピーするファイルの場所 (URI) を入力するために使用されます。
パラメータ値入力ルール:
次の場合に表示: ファイル アクションが [転送/コピー] の場合
パラメータ名: TargetURI
要件:
- MX: 4.3+
ファイルがデバイス ファイル システムに存在するか、XML ファイルに埋め込まれるかを入力するために使用されます。
次の場合に表示: ファイル アクションが [転送/コピー] の場合
パラメータ名: TargetAccessMethod
| オプション | 名前 | 説明 | 注記 | 要件 |
|---|---|---|---|---|
| 2 | デバイス ファイル システムのファイル | ファイルがデバイス ファイル システムにあることを指定します。 |
MX: 4.3+ |
ファイル アクションのオブジェクトをコピーするデバイス上の宛先パスとファイル名を入力するために使用されます。
パラメータ値入力ルール:
次の場合に表示: ファイル アクションが [転送/コピー] の場合
パラメータ名: TargetPathAndFileName
要件:
- MX: 4.3+
リモート システムにアップロードするオンデバイス ファイルのパスと名前を入力するために使用されます。
パラメータ値入力ルール:
注: Android 8.x Oreo および Android 10 以降を実行しているデバイスでのみサポートされます。
次の場合に表示: ファイル アクションが [ファイルのアップロード] の場合
パラメータ名: SourcePathAndFileSpec
要件:
- MX: 10.1+
複数のファイルをコピーまたは移動するときの並べ替え順を選択するために使用されます。
注: Android 8.x Oreo および Android 10 以降を実行しているデバイスでのみサポートされます。
パラメータ名: UploadOrder
| オプション | 名前 | 説明 | 注記 | 要件 |
|---|---|---|---|---|
| 1 | 新しいファイルから先に | ファイルを日付順で最も新しいものから最も古いものの順に移動/コピーします。 |
MX: 10.1+ |
|
| 2 | 古いファイルから先に | ファイルを日付順で最も古いものから最も新しいものの順に移動/コピーします。 |
MX: 10.1+ |
|
| 3 | ファイル名でソート | ファイルをアルファベットの昇順 (A から Z) に移動/コピーします。 |
MX: 10.1+ |
宛先に重複するファイル名が存在するときにファイルを移動またはコピーするときのファイル マネージャの動作を制御するために使用されます。
注: Android 8.x Oreo および Android 10 以降を実行しているデバイスでのみサポートされます。
次の場合に表示: ファイル アクションが [ファイルのアップロード] で、ターゲットアクセス方式が [デバイス ファイル システムのファイル] の場合
パラメータ名: IfDuplicate
| オプション | 名前 | 説明 | 注記 | 要件 |
|---|---|---|---|---|
| 1 | 宛先のファイルを置き換える | 宛先の重複ファイルを上書きし、コピーまたは移動するファイルに置き換えます。 |
MX: 10.1+ |
|
| 2 | ファイルをスキップしてソースから削除 | ソース ファイルを消去し、宛先のファイルを変更せずに残します。 |
MX: 10.1+ |
|
| 3 | ファイルをスキップしてソースに保持 | ソース ファイルと宛先にある重複ファイルは変更されません。 |
MX: 10.1+ |
コピーまたは転送するソース ファイルの場所を入力するために使用されます。
パラメータ名: SourceAccessMethod
| オプション | 名前 | 説明 | 注記 | 要件 |
|---|---|---|---|---|
| 1 | リモート サーバー上のファイル | ソース ファイルがリモート サーバー上にあることを示します。 |
MX: 4.3+ |
|
| 2 | デバイス ファイル システムのファイル | ソース ファイルがデバイス上にあることを示します。 |
MX: 4.3+ |
|
| 3 | XML に埋め込まれたファイル | ソース ファイルが XML に埋め込まれていることを示します。 |
MX: 4.3+ |
サーバーでのファイルの場所の URI を入力するために使用されます。HTTP、HTTPS、FTP、FTPS (FTP over TLS または SSL) プロトコルと、URL に埋め込まれた認証情報の基本認証をサポートします。構文については、「例」セクションを参照してください
重要: ファイル マネージャは匿名 FTP をサポートしていません。
パラメータ値入力ルール:
注: HTTP/S には MX 7.0+ が必要です。FTPS には MX 7.1+ が必要です。ファイル マネージャは匿名 FTP をサポートしていません。
次の場合に表示: ファイル アクションが [転送/コピー] で、ソースがリモート サーバーの場合
パラメータ名: SourceURI
要件:
- MX: 4.3+
リモート システムにアップロードされたファイルのファイル名を生成するためのパターンを入力するために (オプションとして) 使用されます。
パラメータ値入力ルール:
例: 指定されたパターンの "model-serial-date-time" により、ファイル名は次のようになります。
「TC57-12345678901234-DD-MM-YYYY-HH:MM:SS-FileName」
注: Android 8.x Oreo および Android 10 以降を実行しているデバイスでのみサポートされます。
次の場合に表示: ファイル アクションが [ファイルのアップロード] の場合
パラメータ名: TargetFileNamePattern
要件:
- MX: 10.1+
デバイスでのソース ファイルの場所のパスとファイル名を入力するために使用されます。
パラメータ値入力ルール:
次の場合に表示: ファイル アクションが [転送/コピー] で、ソースがデバイス上にある場合
パラメータ名: SourcePathAndFileName
要件:
- MX: 4.3+
アップロード後にソース ファイルを削除するかどうかを制御します。
注: Android 8.x Oreo および Android 10 以降を実行しているデバイスでのみサポートされます。
パラメータ名: DeleteAfterUpload
| オプション | 名前 | 説明 | 注記 | 要件 |
|---|---|---|---|---|
| 0 | (オフ) | アップロード後にソース ファイルを削除しません。 |
MX: 10.1+ |
|
| 1 | (オン) | アップロード後にソース ファイルを削除します。 |
MX: 10.1+ |
埋め込まれるファイルの種類を入力するために使用されます。
次の場合に表示: ファイル アクションが [転送/コピー] で、ソースが [埋め込み] の場合
パラメータ名: SourceType
| オプション | 名前 | 説明 | 注記 | 要件 |
|---|---|---|---|---|
| 1 | 一般データ ファイル (任意の拡張子) | 任意の拡張子タイプを持つソース ファイルを示します。 |
MX: 4.3+ |
|
| 2 | Android アプリケーション パッケージ (.APK ファイル) | .apk 拡張子を持つソース ファイルを示します。 |
MX: 4.3+ |
|
| 3 | Android OS の更新 (.ZIP ファイル) | .zip 拡張子を持つソース ファイルを示します。 |
MX: 4.3+ |
XML に埋め込むソース ファイル データを入力するために使用されます。
次の場合に表示: ファイル アクションは [転送/コピー] で、ソース タイプは [XML に埋め込まれたファイル]、ソース タイプは [一般データファイル] の場合
パラメータ名: SourceDataAny
要件:
- MX: 4.3+
XML に埋め込まれる APK ソース ファイル データを入力するために使用されます。
次の場合に表示: ファイル アクションは [転送/コピー] で、ソース タイプは [XML に埋め込まれたファイル]、埋め込みタイプは [Android アプリケーション] リモート サーバーの場合
パラメータ名: SourceDataApk
要件:
- MX: 4.3+
XML に埋め込むソース ZIP ファイル データを指定します。
次の場合に表示: ファイル アクションは [転送/コピー] で、ソース タイプは [XML に埋め込まれたファイル]、埋め込みタイプは [Android OS の更新] リモート サーバーの場合
パラメータ名: SourceDataZip
要件:
- MX: 4.3+
ダウンロードしたアーカイブ ファイルを展開するパスとフォルダ名を入力するために使用されます。
パラメータ値入力ルール:
次の場合に表示: ファイル アクションが [アーカイブのダウンロードと展開] の場合
パラメータ名: ArchiveTargetPathAndFolderName
要件:
- MX: 5.0+
ソース アーカイブ/ZIP ファイルの URI を入力するために使用されます。
パラメータ値入力ルール:
次の場合に表示: ファイル アクションが [アーカイブのダウンロードと展開] の場合
パラメータ名: ArchiveSourceURI
要件:
- 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>
注: ファイル マネージャは匿名 FTP をサポートしていません。
<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>
注: ファイル マネージャは匿名 FTP をサポートしていません。
<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>
注: ファイル マネージャは匿名 FTP をサポートしていません。
<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>
ユーザー名の特殊 (予約済み) 文字 (@ 記号) はエンコードする必要があります。たとえば、「username@company.com」は、SourceURI に「username%40company.com」と表示されます (以下を参照)。
<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>