ご使用の前に

DataWedge 13.0

概要

DataWedge を使用すると、Zebra デバイス上の任意のアプリケーションで、さまざまな入力ソース (バーコード スキャナ、RFID、音声など) から簡単にデータを取得し、簡単なオプションや複雑なルールに基づいて、必要に応じてデータを操作することもできます。DataWedge のアクションと設定は、UI から設定された DataWedge のプロファイルを使用するか、Android のインテントを使用してプログラムで設定された DataWedge のプロファイルを使用して制御します。アプリケーション アクティビティがフォアグラウンドに表示されている場合は、アプリまたはアクティビティが関連付けられているプロファイルが自動的に検出され、そのプロファイルからの構成が適用されます。

DataWedge の使用は、次の役割に基づいています。

  • 管理者またはユーザー - データをキャプチャし、指定したアプリケーションに配信するように UI を通じて DataWedge を設定します。コーディングは不要です
  • 開発者 - Android インテントを使用してデータをキャプチャするアプリを開発します

このセクションでは、DataWedge の機能と機能性についてガイドします。


主な機能

DataWedge には、次の主な機能とオプションが用意されています。

データ キャプチャ

データ処理

展開

: DataWedge 機能の可用性と動作は、デバイスとオペレーティング システムによって異なります。機能一覧を参照してください。「機能マトリックス」を参照してください。


DataWedge 機能

プロファイルとプラグイン は、DataWedge のほとんどの機能の基本です。プロファイルには、特定のアプリケーションにデータ キャプチャ サービスを提供するときの DataWedge の動作に関するすべての情報が含まれます。その情報の多くはプラグインから得られ、これによりデータの入力、処理、出力の方法が決定されます。

DataWedge プロファイルには、次の 4 つの主要コンポーネントが含まれます。

  • 入力プラグイン - データの取得方法を決定します (バーコード スキャナなど)
  • 処理プラグイン (オプション) - 取得したデータの操作方法を指定します
  • 出力プラグイン - アプリケーションへのデータ渡しを制御します
  • 関連付けられたアプリケーション/アクティビティ - 適用するプロファイルのアプリケーション/アクティビティを指定します

画像

DataWedge プロファイル - DataWedge を使用する各アプリは、DataWedge プロファイルに関連付けられる必要があります。このプロファイルには、データのキャプチャ方法 (入力)、処理方法 (データ形式)、および受信アプリへの配信方法 (出力) を決定するオプションが含まれます。これらのオプションはプラグインとして参照されます。これらのオプションはプラグインと呼ばれます。DataWedge では、フォアグラウンド アプリケーションが継続的に監視されます。フォアグラウンド アプリへの変更が検出されると、そのアプリに関連付けられた適切なプロファイルがアクティブになります (存在する場合)。アプリがどのプロファイルにも関連付けられていない場合は、デフォルトの汎用プロファイル Profile0 が有効になります。プロファイルはエクスポートできるため、複数のデバイスに同じ DataWedge の構成を展開できます。

プロファイルを作成してアプリをプロファイルに関連付ける - アプリをプロファイルに関連付けることで、アプリがフォアグラウンドに来るとプロファイル設定が適用されます。データ キャプチャの入力、処理、出力は、プラグイン経由でプロファイルを介して制御できます。

各プラグインには、より詳細な制御を行うための次のようなオプションがあります。

  • 入力プラグイン - データのキャプチャ方法を指定します。

    • バーコード - 処理するデータを送信する前に、キャプチャしたデータに適用されるデバイス スキャン ハードウェア、デコーダ、デコーダ パラメータ、リーダー パラメータ、およびスキャン パラメータを指定します。サポート対象のハードウェアには、統合内蔵デバイス (1D スキャナ、2D スキャナ、カメラなど)、または外部接続デバイス (Bluetooth SSI または USB SSI スキャナなど) を含めることができます。
    • ワークフロー ワークフロープロセスから高度なタスクを実行するときにデータを取得します。これには、特殊な用途 (ナンバープレート、車両識別番号 (VIN)、タイヤ識別番号 (TIN)、公共設備メーター、身分証明書の読み取り)で、アプリに配信するためにテキストを自動的にキャプチャし、デジタル データに変換する、または内蔵イメージャでキャプチャされた画像からバーコードをデコードすることが含まれます。
    • MSR (磁気ストライプ リーダー) - サポート対象のハードウェア上で、ID カードなどの MSR カードからデータを取得します。
    • RFID (無線周波数識別) - 内蔵または外部 RFID リーダーを使用して、RFID タグからデータを取得します。
    • シリアル ポート - シリアル ポート経由で接続された周辺デバイスからホスト デバイスにデータを取得します。
    • 音声 - 音声認識を介してデータを取得します。構成には、PTT ボタンを押して音声キャプチャをトリガ、TAB/ENTER コマンドの送信、英数字へのデータの制限、音声データの検証、オフライン動作などがあります。
  • 処理プラグイン - (オプション) キャプチャしたデータを出力プラグインに渡す前に形式化する方法を指定します。ノーコード アプローチで非常に有用です。

    • 基本データ形式 (BDF) - 出力プラグインに渡す前に、基本的な定義済みオプションを使用してデータをフォーマットします。使用可能なオプション: データ プレフィックスの追加、データ サフィックスの追加、フォアグラウンド アプリへのデータの送信、16 進形式でのデータの送信、TAB キーの追加、ENTER キーの追加。これは、データをスキャンし、TAB キーを追加することにより、次のテキスト フィールドに自動的に移動するときに便利です。
    • 高度なデータ形式 (ADF) - 出力プラグインにデータを渡す前に、特定の条件を持つカスタム ルールに基づいてデータを形式化します。これは、取得した 9 桁の Code 128 バーコードの中央の 3 桁が、ルールで指定した同一の 3 桁と一致する場合にのみ、データにゼロを埋め込むアクションをトリガするといった状況で役立ちます。
  • 出力プラグイン - データの配信方法を指定します。

    • キーストローク - 取得したデータは、関連付けられたアプリケーションに一連のキーストロークとして送信されます。これを使用すると、コードを追加せずにスキャン機能をアプリに追加できます。さらに、DataWedge インテント API を介して完全に構成することも可能です。
    • インテント - 取得したデータは、関連付けられたアプリ/アクティビティに、Android インテント メカニズムによってプログラムで送信されます。これは、アプリが柔軟かつ設定可能な方法でデータを安全に受信するために推奨される方法です。アプリは、キャプチャしたデータを受信するために DataWedge のインテントを登録する必要があります。
    • インターネット プロトコル (IP) - 取得したデータは、指定された IP アドレスとポートを介して、TCP または UDP によるネットワーク経由でホストに送信されます。これは、医療環境などで PC に対してデータをスキャンする場合に役立ちます。
  • ユーティリティ - (オプション) は、次のようなデータ収集を支援するツールを提供します。

    • Data Capture Plus (DCP) - タップすると、デバイス画面の特定の領域が仮想スキャン トリガとして動作し、ハードウェア トリガ プレスをシミュレートできます。全画面モードで構成することも、画面の右側のみ、左側のみ、またはどちらかの側にフローティング スキャン ボタンとして構成することもできます。
    • エンタープライズ キーボード構成 - アプリを変更せずに、関連付けられたアプリ内でエンタープライズ キーボードのカスタム レイアウトを使用できます。デスクトップ ツール、エンタープライズ キーボード デザイナを使用して、エンタープライズ キーボードのレイアウトを生成します。

DataWedge 設定 - 非プロファイル関連の汎用 DataWedge オプションに対する構成を提供します。これには、無効なプロファイルの無視、無効アプリ リストの無視、プロファイルのインポート/エクスポートなどの機能が含まれます。

自動インポート - DataWedge に事前構成されたプロファイル、または構成ファイルを自動的にロードする機能を提供します。これは、サードパーティのエンタープライズ モビリティ管理 (EMM) システムなどのツールを使用してデバイスをリモート展開する場合に使用できます。DataWedge では、プロファイルまたは構成ファイルの特定フォルダが監視されます。プロファイルまたは構成ファイルが見つかった場合は、そのファイルをインポートし、既存の構成またはプロファイルを置き換えます。

一括展開 - DataWedge プロファイルと設定は、手動または EMM (エンタープライズ モビリティ管理) ソフトウェアを使用して、複数のデバイスに展開できます。エクスポートされた構成ファイルまたはプロファイルは、/enterprise/device/settings/datawedge/dw-jp/autoimport ディレクトリに配置されると自動的にインポートされます。


管理者とユーザーの役割

システム管理者またはエンド ユーザーは、UI を通じて DataWedge を設定し、データをキャプチャして指定したアプリケーションに配信できます。コーディングは不要です。DataWedge UI を使用してプロファイルを作成し、設定を行います。DataWedge はデータをキャプチャし、設定されたプロファイルに基づいて自動的に指定されたアプリケーションに配信します。

プロファイルを作成および設定するための一般的な手順は、次のとおりです。

  • DataWedge UI を使用してプロファイルを作成し、データのキャプチャおよび処理方法を制御します。
  • アプリ/アクティビティをプロファイルに関連付けます。
  • キャプチャしたデータがフォアグラウンドにあるときにアプリに配信されるように、出力をキーストロークに設定します。

セキュリティ上の理由から、管理者は承認済みのアプリのみに API アクセスを許可することで、アプリが DataWedge インテント API にアクセスできないようにすることができます。『DataWedge インテント API へのアクセス制御』ガイドを参照してください。これには、MX からの DataWedge Manager (DataWedgeMgr) の使用が含まれます。これにより、次の制御も可能になります。

  • DataWedge ユーザー インタフェースへのアクセス
  • DataWedge 設定の自動インポート
  • NG SimulScan テンプレートのインポート


各種手順

このセクションでは、管理者とエンド ユーザー向けに DataWedge UI で一般的なタスクを実行するための手順を段階的に説明します。

データ キャプチャ:
入力、プロセス、出力、関連アプリを指定するプロファイルを作成します。または、Profile0 を使用します。これは、プロファイルに関連付けられていないフォアグラウンドに来るすべてのアプリに適用されるデフォルトの汎用プロファイルです。詳細については、「プロファイル」を参照してください。
  • バーコード入力を有効にしてデータを取得します。必要に応じてキャプチャ設定を指定します。
  • 出力方法を選択します。
    • キーストローク出力を有効にすると、データを収集して一連のキーストロークとして配信するため、アプリケーション コーディングは不要です。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
    • [インテント出力] を有効にしてデータを収集し、DataWedge インテント API を使用してプログラムでアプリに渡します。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
    • [インターネット プロトコル (IP) 出力] を有効にしてデータを収集し、TCP または UDP を使用して特定の IP アドレスおよびポートに渡します。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
  • スキャナの選択でスキャン デバイスを指定します。
  • 必要な場合は、目的のバーコード タイプ、またはデコーダを有効にして、デコーダ パラメータ オプションをスキャンおよび指定します。
入力、プロセス、出力、関連アプリを指定するプロファイルを作成します。または、Profile0 を使用します。これは、プロファイルに関連付けられていないフォアグラウンドに来るすべてのアプリに適用されるデフォルトの汎用プロファイルです。詳細については、「プロファイル」を参照してください。
  • MSR 入力を有効にしてデータを取得します。必要に応じてキャプチャ設定を指定します。
  • [インテント出力] を有効にしてデータを収集し、DataWedge インテント API を使用してプログラムでアプリに渡します。
    • 次のいずれかが必要な場合は、基本データ形式を有効にします。
      • データにプレフィックスを追加
      • データにサフィックスを追加
      • データを 16 進法として送信
      • タブ文字を追加
      • ENTER 文字を追加
    • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
入力、プロセス、出力、関連アプリを指定するプロファイルを作成します。または、Profile0 を使用します。これは、プロファイルに関連付けられていないフォアグラウンドに来るすべてのアプリに適用されるデフォルトの汎用プロファイルです。詳細については、「プロファイル」を参照してください。
  • RFID 入力を有効にしてデータを取得します。必要に応じてキャプチャ設定を指定します。
  • 出力方法を選択します。
    • キーストローク出力を有効にすると、データを収集して一連のキーストロークとして配信するため、アプリケーション コーディングは不要です。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
    • [インテント出力] を有効にしてデータを収集し、DataWedge インテント API を使用してプログラムでアプリに渡します。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
    • [インターネット プロトコル (IP) 出力] を有効にしてデータを収集し、TCP または UDP を使用して特定の IP アドレスおよびポートに渡します。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
入力、プロセス、出力、関連アプリを指定するプロファイルを作成します。または、Profile0 を使用します。これは、プロファイルに関連付けられていないフォアグラウンドに来るすべてのアプリに適用されるデフォルトの汎用プロファイルです。詳細については、「プロファイル」を参照してください。
  • シリアル入力を有効にしてデータを取得します。必要に応じてキャプチャ設定を指定します。
  • 出力方法を選択します。
    • キーストローク出力を有効にすると、データを収集して一連のキーストロークとして配信するため、アプリケーション コーディングは不要です。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
    • [インテント出力] を有効にしてデータを収集し、DataWedge インテント API を使用してプログラムでアプリに渡します。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
    • [インターネット プロトコル (IP) 出力] を有効にしてデータを収集し、TCP または UDP を使用して特定の IP アドレスおよびポートに渡します。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
入力、プロセス、出力、関連アプリを指定するプロファイルを作成します。または、Profile0 を使用します。これは、プロファイルに関連付けられていないフォアグラウンドに来るすべてのアプリに適用されるデフォルトの汎用プロファイルです。詳細については、「プロファイル」を参照してください。
  • 音声入力を有効にしてデータを取得します。必要に応じてキャプチャ設定を指定します。
  • 出力方法を選択します。
    • キーストローク出力を有効にすると、データを収集して一連のキーストロークとして配信するため、アプリケーション コーディングは不要です。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
    • [インテント出力] を有効にしてデータを収集し、DataWedge インテント API を使用してプログラムでアプリに渡します。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
    • [インターネット プロトコル (IP) 出力] を有効にしてデータを収集し、TCP または UDP を使用して特定の IP アドレスおよびポートに渡します。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
入力、プロセス、出力、関連アプリを指定するプロファイルを作成します。または、Profile0 を使用します。これは、プロファイルに関連付けられていないフォアグラウンドに来るすべてのアプリに適用されるデフォルトの汎用プロファイルです。詳細については、「プロファイル」を参照してください。
  • バーコード入力を有効にしてデータを取得します。必要に応じて読み取り設定を指定します。スキャン モードを [マルチバーコード] (NG SimulScan の一部) に設定し、MultiBarcode パラメータを設定します。
  • 出力方法を選択します。
    • キーストローク出力を有効にすると、データを収集して一連のキーストロークとして配信するため、アプリケーション コーディングは不要です。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
    • [インテント出力] を有効にしてデータを収集し、DataWedge インテント API を使用してプログラムでアプリに渡します。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
    • [インターネット プロトコル (IP) 出力] を有効にしてデータを収集し、TCP または UDP を使用して特定の IP アドレスおよびポートに渡します。
      • 次のいずれかが必要な場合は、基本データ形式を有効にします。
        • データにプレフィックスを追加
        • データにサフィックスを追加
        • データを 16 進法として送信
        • タブ文字を追加
        • ENTER 文字を追加
      • カスタムデータ処理ルールが必要な場合は、[高度なデータ形式] を有効にします。
  • スキャナの選択でスキャン デバイスを指定します。
  • 必要な場合は、目的のバーコード タイプ、またはデコーダを有効にして、デコーダ パラメータ オプションをスキャンおよび指定します。
入力、プロセス、出力、関連アプリを指定するプロファイルを作成します。または、Profile0 を使用します。これは、プロファイルに関連付けられていないフォアグラウンドに来るすべてのアプリに適用されるデフォルトの汎用プロファイルです。詳細については、「プロファイル」を参照してください。

データ形式:
データを取得するために、バーコード、MSR、RFID などのデータ収集入力方法のいずれかを選択し、[基本データ形式] または [高度なデータ形式] のいずれかに記載されている手順に従います。

構成:
入力、プロセス、出力、関連アプリを指定するプロファイルを作成します。または、Profile0 を使用します。これは、プロファイルに関連付けられていないフォアグラウンドに来るすべてのアプリに適用されるデフォルトの汎用プロファイルです。詳細については、「プロファイル」を参照してください。
  • [Data Capture Plus] を有効化します。必要に応じて設定を指定します。
  • ハードウェア トリガが押されたときのようにデバイスが応答するように、指定された画面領域をタップして長押しします。
  • 入力、プロセス、出力、関連アプリを指定するプロファイルを作成します。または、Profile0 を使用します。これは、プロファイルに関連付けられていないフォアグラウンドに来るすべてのアプリに適用されるデフォルトの汎用プロファイルです。詳細については、「プロファイル」を参照してください。
  • [エンタープライズ キーボード構成]を有効化します。必要に応じて設定を指定します。
  • 指定されたエンタープライズ キーボードが、関連付けられたアプリ内の各ユーザー入力フィールドに対して、オンスクリーン キーボードとして自動的に表示されます。
  • 手動または一括展開については、「展開」を参照してください。
    DataWedge を工場出荷時のデフォルト設定に復元します。

    セキュリティ:

    開発者の役割

    次のいずれかの方法を使用して、データ キャプチャ アプリを開発します。

    • Android の汎用インテント (ローコード) - スキャンやデータ処理を細かく制御することなく、ブロードキャスト レシーバ、サービス、またはアクティビティを使用して、Android の汎用インテントからデータを受信する基本的な方法。「基本インテントのサンプル アプリ」を参照してください。
    • DataWedge API - Android のインテントに基づいて DataWedge の設定を制御し、基盤となるハードウェアに関係なく、データのキャプチャ、処理、アプリへの配信方法を指定します。

    DataWedge インテント API を用いてアプリケーションを開発する際の基本的な手順:

    • データのキャプチャ、処理、出力の方法を制御するためのプロファイルを作成します。
    • アプリでインテントに登録します。
    • アプリ内でインテントを受け取り、インテント エクストラからデータを取り出し、必要に応じて処理します。

    追加の開発者向けリソースとして、 DataWedge インテント API の使用方法やベストプラクティスに関するガイダンスを提供する「プログラマ ガイド」「開発者向けの記事とブログ」および「サンプル」を参照してください。


    ベスト プラクティス

    バーコード スキャンを必要とするすべてのアプリケーションには、DataWedge の使用を強くお勧めします。Zebra では引き続き EMDK バーコード API をサポートしますが、インテント ベースのインタフェースの効率性と機能の豊富さにより、EMDK バーコード API を使用するよりもアプリケーション開発のよりシンプルな代替案になります。EMDK アプリの開発には、スキャン API に関する完全な知識が必要です。EMDK アプリの設計とコーディングは、その難易度が高いため、時間がかかることがあります。DataWedge は、インタフェースの簡素化、API の使いやすさの向上および柔軟性を実現します。DataWedge データは、基盤となるアプリケーション技術 (Java、Xamarin、インテントをサポートする任意のクロスプラットフォームなど) に関係なく、任意のアプリケーションから取得できます。EMDK は、DataWedge 機能のサブセットを提供します。詳細については、DataWedge 対 EMDK の比較表を参照してください。

    重要: バーコード スキャン ハードウェアの制御は排他的です。アプリがスキャンに EMDK を使用する場合、DataWedge よりも優先され、スキャンが実行されます。この EMDK アプリがスキャナの制御を中止しない場合、DataWedge を使用するアプリがスキャンされなくなります。したがって、デバイスのスキャナ ハードウェアを制御する方法と、必要に応じてスキャンが完了したときに制御を他のアプリに解放する方法を理解することは重要です。

    DataWedge を使用してデータをキャプチャする 2 つの異なるアプリがデバイス上にあり、データをキャプチャする必要があるたびに両方のアプリがインテントを送信する場合、そのインテントのアクションはアプリごとに異なります。そのため、インテント プラグインの異なる設定を含む 2 つの個別の DataWedge プロファイルを作成し、両方のアプリをシームレスに使用して、異なるタイプのデータをキャプチャできます。

    詳細は『DataWedge Programmer's Guide』内の「ベストプラクティス」を参照してください。


    関連情報: