特定のデバイスに存在する機能のみを表示するには、下の SmartDocs バーから 1 つまたは複数のフィルタを選択します。
入力フィールドには、英語のみを入力できます。
MX からのクエリは、Android 11 以降を実行している Zebra デバイスではサポートされていません。代替方法を参照してください。
StageNow - 5.10
[SmartDocs] バーでは、特定の Zebra デバイスに存在する機能のみを表示するように、このページをカスタマイズできます。
デバイスの OSX、MX および Android のバージョン情報は、Android の設定パネルに表示されるか、ADB、EMDK、または MX CSP を使用してデバイスを照会することで確認できます。詳細情報。
ファイル マネージャ (FileMgr) を使用すると、アプリケーションでデバイス上のファイルを管理できます。たとえば、FileMgr では、アプリがサーバーからデバイスにファイルをダウンロードしたり、デバイスのある領域から別の領域にファイルまたはフォルダをコピーしたり、デバイス上のファイルを削除したりできます。ファイル マネージャは、XML ドキュメントに埋め込まれたファイルを抽出し、基本認証ありまたはなしでインターネットからダウンロードすることもできます。
/enterprise/sdcard/Android/data/storage/emulated/0/Download
デバイス上のファイルまたはフォルダ (空の場合) に対して実行するアクションを選択するために使用されます。
Android 11 から段階的に開始される Google が義務付けたセキュリティ制限に備えて、Zebra は、Android のセキュリティ要件に準拠して、元のアプリからターゲット アプリにファイルやデータを安全に共有するメカニズムである、Secure Storage Manager (SSM) を実装しています。このプロセスでは、直接ファイル アクセスは許可されなくなり、SSM を介して共有されるデータを受信するように意図されているアプリに対して、軽微な変更が必要になります。
SSM は、MX 11.3 以降で提供される File Manger CSP と互換性があり、そのプロセスは、多くのファイルおよび/またはデータ共有シナリオにおいて管理者に透過的に設計されています。ただし、SSM を介して共有されるファイルおよび/またはデータの受信者として指定されたアプリは、URI を介してファイルにアクセスできる必要があります。このような変更は、Zebra デバイスでの作業には特に必要ありませんが、データを共有するすべての Android デバイスで最終的に必要となる Android のセキュリティ要件に準拠するために必要になります。
SSM は、Android 11 以降を実行しているすべての Zebra デバイスにプリインストールされています。
ファイル アクション オプション 10 (以下の表) には、次の追加パラメータが必要です (または、示されているようにオプションで連携します)。
com.targetApp.package.name/optionalAppFolderName/file.name (下記の注意事項を参照)[ExternalURI] フィールドを含む StageNow Profile をエクスポートすると、そのフィールドのデータは暗号化されます。プロファイルをインポートした場合、そのフィールドの内容は編集できません。
「ターゲット アプリケーション ファイル定義」パラメータ (「TargetApplicationAndFileName」) は、アプリケーションのパッケージ名 (上の例の com.targetApp.package.name) と共有するファイルの名前 (file.name) の組み合わせを受け入れます。このファイルには、デバイスにインストールするためのアプリ インストーラ パッケージ (.apk)、アプリ設定を構成するための構成ファイル、またはその他のタイプのファイルを指定できます。
定義 (/optionalAppFolderName/) の中央セクションは、ターゲット アプリのファイルを整理するために使用できる、ターゲット アプリの下の [オプション] フォルダ (またはパス) です (または、まだ存在しない場合はそのフォルダに作成されます)。このストレージ領域にアクセスできるのは、指定されたターゲット アプリのみで、このアプリは、デバイス上の別のアプリまたはターゲット アプリ自体にすることができます。
SSM を介して共有されるデータを受信するアプリは、URI を介してデータを消費できる必要があります。
Android コンテンツ プロバイダのドキュメントも参照してください
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
パラメータ名: FileAction
デバイスからリモート サーバーにコピーするファイルの場所 (URI) を入力するために使用されます。
[ExternalURI] フィールドを含む StageNow Profile をエクスポートすると、そのフィールドのデータは暗号化されます。プロファイルをインポートした場合、そのフィールドの内容は編集できません。下記のビデオを参照してください。
パラメータ値入力ルール:
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションが [ファイルのアップロード] の場合
パラメータ名: TargetURI
要件:
- MX: 10.1+
ファイルをデバイス ファイル システムにコピー/転送するか、XML ファイルに埋め込むかを制御します。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションが [転送/コピー] の場合
パラメータ名: TargetAccessMethod
選択したファイル アクションを実行するデバイス上のパスとファイル名を入力するために使用されます。
パラメータ値入力ルール:
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションが [転送/コピー] の場合
パラメータ名: TargetPathAndFileName
要件:
- MX: 4.3+
選択したファイル アクションを実行するデバイス上のパスとフォルダ名を入力するために使用されます。
パラメータ値入力ルール:
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションが [転送/コピー] の場合
パラメータ名: TargetPathAndFolderName
要件:
- MX: 4.3+
リモート システムにアップロードされたファイルのファイル名を生成するためのパターンを入力するために (オプションとして) 使用されます。
パラメータ値入力ルール:
例: 指定されたパターンの "model-serial-date-time" により、ファイル名は次のようになります。
「TC57-12345678901234-DD-MM-YYYY-HH:MM:SS-FileName」
注: Android 8.x Oreo および Android 10 以降を実行しているデバイスでのみサポートされます。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションが [ファイルのアップロード] の場合
パラメータ名: TargetFileNamePattern
要件:
- MX: 10.1+
目的のアプリケーションによって取得されるファイルの目的のアプリケーション パッケージ名、オプションのパス/フォルダ名とファイル名を入力するために使用されます。
Android 11 以降を実行しているデバイスでは、ターゲット アプリケーションはファイルを使用するために Zebra Secure Storage Manager (SSM) からファイルを取得する必要があります。このパラメータを使用して入力したオプションのフォルダ パスは、必要に応じてアプリケーション固有のファイル構造を維持するのに役立ちます。
パラメータ値入力ルール:
com.targetApp.package.name/optionalAppFolderName/filename.extステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションは [アプリケーションのファイルを展開] で、新しいソース アクセス方法は [デバイス ファイル システムのファイル] です。
パラメータ名: TargetApplicationAndFileName
要件:
- MX: 11.3+
対象アプリケーションの署名を入力する際に使用します。
パラメータ値入力ルール:
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションは [アプリケーションのファイルを展開] です。
パラメータ名: TargetApplicationSignature
要件:
- MX: 11.3+
リモート システムにアップロードするオンデバイス ファイルのパスと名前を入力するために使用されます。
パラメータ値入力ルール:
注: Android 8.x Oreo および Android 10 以降を実行しているデバイスでのみサポートされます。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションが [ファイルのアップロード] の場合
パラメータ名: SourcePathAndFileSpec
要件:
- MX: 10.1+
複数のファイルをコピーまたは移動するときの並べ替え順を選択するために使用されます。
注: Android 8.x Oreo および Android 10 以降を実行しているデバイスでのみサポートされます。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
パラメータ名: UploadOrder
宛先に同じ名前のファイルが存在する場合にファイルを移動またはコピーするとき、ファイル マネージャの動作を制御するために使用されます。
注: Android 8.x Oreo および Android 10 以降を実行しているデバイスでのみサポートされます。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションが [ファイルのアップロード] または [ファイルの転送/コピー] で、ターゲット アクセス方式が [デバイス ファイル システムのファイル] の場合
パラメータ名: IfDuplicate
コピーまたは転送するソース ファイルの場所を入力するために使用されます。
注: この機能は、2 ～ 300KB 以下のファイルに使用することをお勧めします。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。MX 11.2では廃止されています。
パラメータ名: SourceAccessMethod
コピーまたは転送するソース ファイルの場所を入力するために使用されます。
注: この機能は、2 ～ 300KB 以下のファイルに使用することをお勧めします。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションは [アプリケーションのファイルを展開] です。
パラメータ名: SourceAccessMethod2
エンタープライズ リセット後、ファイルをデバイス上でローカルに保持するかどうかを選択するために使用されます。エンタープライズ リセットの詳細をご覧ください。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションは [アプリケーションのファイルを展開] です。
パラメータ名: PersistFile
サーバーでのファイルの場所の URI を入力するために使用されます。HTTP、HTTPS、FTP、FTPS (FTP over TLS または SSL) プロトコルと、URL に埋め込まれた認証情報の基本認証をサポートします。構文については、「例」セクションを参照してください
重要: ファイル マネージャは匿名 FTP をサポートしていません。
パラメータ値入力ルール:
注: HTTP/S には MX 7.0+ が必要です。FTPS には MX 7.1+ が必要です。HTTP/S は Android 4.4 (KitKat) を実行しているデバイスではサポートされていません。組み込みのソース URI 参照のみを使用します。ファイル マネージャは匿名 FTP をサポートしていません。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。MX 11.2では廃止されています。
次の場合に表示: ファイル アクションが [転送/コピー] で、ソースがリモート サーバーの場合
パラメータ名: SourceURI
要件:
- MX: 4.3+
サーバーでのファイルの場所の URI を入力するために使用されます。HTTP、HTTPS、FTP、FTPS (FTP over TLS または SSL) プロトコルと、URL に埋め込まれた認証情報の基本認証をサポートします。構文については、「例」セクションを参照してください
重要: ファイル マネージャは匿名 FTP をサポートしていません。
[ExternalURI] フィールドを含む StageNow Profile をエクスポートすると、そのフィールドのデータは暗号化されます。プロファイルをインポートした場合、そのフィールドの内容は編集できません。
パラメータ値入力ルール:
注: HTTP/S には MX 7.0+ が必要です。FTPS には MX 7.1+ が必要です。HTTP/S は Android 4.4 (KitKat) を実行しているデバイスではサポートされていません。組み込みのソース URI 参照のみを使用します。ファイル マネージャは匿名 FTP をサポートしていません。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションは [アプリケーションのファイルを展開] で、新しいソース アクセス方法は [デバイス ファイル システムのファイル] です。
パラメータ名: SourceURI2
要件:
- MX: 11.3+
- Android API: 30+
デバイスでのソース ファイルの場所のパスとファイル名を入力するために使用されます。
パラメータ値入力ルール:
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。MX 11.2では廃止されています。
次の場合に表示: ファイル アクションが [転送/コピー] で、ソースがデバイス上にある
パラメータ名: SourcePathAndFileName
要件:
- MX: 4.3+
デバイスでのソース ファイルの場所のパスとファイル名を入力するために使用されます。
パラメータ値入力ルール:
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションは [アプリケーションのファイルを展開] で、新しいソース アクセス方法は [デバイス ファイル システムのファイル] です。
パラメータ名: SourcePathAndFileName2
要件:
- MX: 11.3+
アップロード後にソース ファイルを削除するかどうかを制御します。
注: Android 8.x Oreo および Android 10 以降を実行しているデバイスでのみサポートされます。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
パラメータ名: DeleteAfterUpload
埋め込まれるファイルの種類を入力するために使用されます。
注: この機能は、2 ～ 300KB 以下のファイルに使用することをお勧めします。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションが [転送/コピー] で、ソースが [埋め込み] の場合
パラメータ名: SourceType
XML に埋め込むソース ファイル データを入力するために使用されます。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションは [転送/コピー] で、ソース タイプは [XML に埋め込まれたファイル]、ソース タイプは [一般データファイル] の場合
パラメータ名: SourceDataAny
要件:
- MX: 4.3+
XML に埋め込まれる APK ソース ファイル データを入力するために使用されます。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションは [転送/コピー] で、ソース タイプは [XML に埋め込まれたファイル]、埋め込みタイプは [Android アプリケーション] リモート サーバーの場合
パラメータ名: SourceDataApk
要件:
- MX: 4.3+
XML に埋め込むソース ZIP ファイル データを指定します。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションは [転送/コピー] で、ソース タイプは [XML に埋め込まれたファイル]、埋め込みタイプは [Android OS の更新] リモート サーバーの場合
パラメータ名: SourceDataZip
要件:
- MX: 4.3+
ダウンロードしたアーカイブ ファイルを展開するパスとフォルダ名を入力するために使用されます。
パラメータ値入力ルール:
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションが [アーカイブのダウンロードと展開] の場合
パラメータ名: ArchiveTargetPathAndFolderName
要件:
- MX: 5.0+
ソース アーカイブ/ZIP ファイルの URI を入力するために使用されます。
パラメータ値入力ルール:
注: 必要に応じて、リモート (外部) ダウンロード サーバーを指定するには、MX 8.3 (以降) が必要です。
ステータス: Android 13 以降を実行しているデバイスでは、この機能には StageNow と互換性のある EMM システム、または Android システム API を使用してアクセスできます。
次の場合に表示: ファイル アクションが [アーカイブのダウンロードと展開] の場合
パラメータ名: 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>