Loftware NiceLabel ラベルサービスソリューションを使用したラベルの印刷

[アーティクル]
11/29/2023

この記事では、Loftware NiceLabel ソリューションを使ってMicrosoft Dynamics 365 Supply Chain Management でラベルを設定し、印刷する方法を説明します。これは、Supply Chain Management の外部サービスラベル印刷機能の使い方を示す一例です。この機能の仕組みに関する一般的な情報については、外部サービスを使用してラベルを印刷するを参照してください。

Loftware NiceLabel を使用すると、標準化された準拠バーコードラベルを作成、管理、印刷できます。また、サポートされているクラウド接続プリンターやさまざまな従来のオンプレミスプリンターにラベルを印刷することもできます。 NiceLabel には、クラウドソリューション (NiceLabel Cloud) やオンプレミス製品のいくつかのバージョンなど、外部のラベル印刷サービスと併用できる製品がいくつかあります。この記事では、Supply Chain Management を NiceLabel Cloud ソリューションと統合する方法に焦点を当てます。

Loftware NiceLabel Cloud の詳細については、Loftware NiceLabel Cloud & ラベル管理システムを参照してください。

重要

外部サービスとの統合を有効にすることにより、お客様は、外部サービスのデータ取り扱い、プライバシー、およびコンプライアンスの基準が、Dynamics 365 Supply Chain Management が提供する基準と同じではない可能性があることを理解することを確約するものとします。外部サービスが組織のセキュリティとプライバシーの要件 (個人データの取り扱いや地理的居住性の要件など) を満たしているかどうかを確認するには、外部サービスのドキュメントと規約を参照してください。 Microsoft にとってお客様のプライバシーは重要です。詳細については、Microsoft のプライバシーに関する声明をお読みください。

NiceLabel Cloud は、他のクラウドアプリケーションに対して 2 つの統合アプローチをサポートしています。

クラウドプリント API – NiceLabel Cloud はラベルを生成し、印刷ジョブをプリンターに送信します。このプリンタは、いわゆる クラウドプリンター (ローカルにインストールされたソフトウェアやプリンタドライバを使用せずに、NiceLabel Cloud インスタンスに直接接続されるプリンタ) または任意のプリンタのいずれかになります。これは、プリントゲートウェイコンポーネントがインストールされているワークステーションに接続されています。サポートされているクラウドプリンターの現在のリストについては、 Loftware Web サイトを参照してください。
Cloud Trigger API – NiceLabel Cloud は、オンプレミスの NiceLabel Automation Service インスタンスにメッセージを送信し、ラベルが生成されてプリンターに送信されます。各プリンタに Windows プリンタドライバをインストールする必要があります。

ローカルソフトウェアのフットプリントを望まない場合は、クラウドプリント API とサポートされているプリンターを併用することをお勧めします。そうでない場合は、Cloud Trigger API を使用することをお勧めします。ただし、両方のオプションが利用可能です。

各統合オプションの長所と短所は次のとおりです:

クラウドトリガー API を使用すると、すぐに使えるクラウド統合パックを使用したり、印刷要求の処理を完全にカスタマイズしたりできます。
クラウドプリントは同期 API です。つまり、サーバーは印刷エンジンがラベルを印刷するのを待機します。 Cloud Print API は印刷ジョブの結果を報告しますが、Supply Chain Management はその結果を使用しません。したがって、ラベルを印刷する際に少し長く待つか、外部サービスの操作にタイムアウトを設定する必要があります。タイムアウトが発生した場合、クラウドプリント API は印刷を継続しますが、リクエストはタイムアウトとして記録されます。
NiceLabel Automation Service を実行するサーバー上で構成されているプリンターの名前を使用できるため、Cloud Trigger API ではオンプレミスのプリンターの名前付けが簡単になります。クラウドプリント API を使用するには、印刷先のワークステーションを示すワークステーション ID を指定する必要があります。
Cloud Trigger API の場合、NiceLabel Automation Service の複数のインスタンスをローカルネットワークにインストールして、負荷分散と高可用性を実現できます。前述のとおり、印刷要求をどのワークステーションにルーティングするかを指定する必要があります。そのワークステーションが利用できない場合、ラベルは印刷されません。逆に、複数の NiceLabel Automation Service インスタンスは、同じクラウドトリガーへのリクエストを処理できます。
クラウドプリント API のインストールフットプリントは小さくなります。

重要

この記事の情報は、一般的な情報提供のみを目的としています。情報を最新かつ正確に保つよう努めますが、Microsoft は、NiceLabel 製品に関する正確性、信頼性、完全性について、明示的か黙示的かを問わず、いかなる種類の表明または保証も行いません。 Loftware は、NiceLabel 製品の機能を予告なく変更することがあります。 NiceLabel 製品に関して問題が発生した場合、またはその他の質問がある場合は、Loftware に直接お問い合わせください。

前提条件

この記事で説明されている機能を使用するには、Supply Chain Management バージョン 10.0.34 以降を実行している必要があります。

NiceLabel Cloud 統合の準備をする

Cloud Print API または Cloud Trigger API を使用して NiceLabel Cloud にアクセスするには、事前に NiceLabel 開発者ポータルに登録し、開発者ポータルのサブスクリプションを NiceLabel Cloud インスタンスにリンクする必要があります。手順については、NiceLabel ヘルプセンターのクラウド統合を参照してください。

重要

NiceLabel 開発者ポータルに登録する際は、必ずプライマリまたはセカンダリサブスクリプションキーのコピーを作成してください。 (既定では主キーを使用します) このキーは、後で外部サービス定義を構成するために必要になります。

モノのインターネット (IoT) に対応したプリンターを使用する場合は、プリンターを NiceLabel Cloud インスタンスに接続する必要があります。手順については、NiceLabel ヘルプセンターのククラウドプリンターを参照してください。

クラウドプリント API を使用してクラウドプリンターに印刷するための Supply Chain Management の構成

Cloud Print API を使用すると、Supply Chain Management から送信された変数に基づいて NiceLabel Cloud が生成したラベルを印刷できます。また、既存のラベルレイアウトや小型荷物配送 (SPS) 統合用に配送業者によって提供される配送ラベルなど、Zebra プログラミング言語 (ZPL) ラベルを送信することもできます。

このセクションでは、2 つの操作 (変数ベースのレイアウトの印刷用と ZPL ベースのラベルレイアウトの印刷用) を含む外部サービス定義をセットアップする方法について説明します。両方のタイプのレイアウトを使用する必要がない場合は、ここで説明する 2 つの操作のうち 1 つだけを設定できます。

クラウドプリント API を使用して印刷用の外部サービス定義をセットアップする

外部サービス定義を設定するには、次の手順に従います。

倉庫管理 > 設定 > 外部サービス > 外部サービス定義 に移動します。
アクションペインで、新規を選択して外部サービス定義を作成します。
新しいサービス定義の以下のフィールドを設定します:
- 外部サービス定義 – サービス定義の名前を入力します (例: NLPrint)。
- 説明 – サービス定義の短い説明を入力します (例: NiceLabel クラウドプリント API)。
アクションウィンドウで、保存を選択します。
外部サービス操作 クイックタブで、ツールバーの 操作の編集 を選択します。
アクションウィンドウの 外部サービスオペレーション ページで、新規を選択して、変数を印刷するためのオペレーションを追加します。次に、新しいレコードに対して次の手順に従います。変数ベースのレイアウトを使用しない場合は、ステップ 8 に進んでください。
- ヘッダーで、次のフィールドを設定します。
  - 外部サービス操作 – 操作の名前を入力します (例: 印刷)。
  - 説明 – 操作の簡単な説明を入力してください (例: BarTender Cloud)。
- 一般クイックタブで、次のフィールドを設定します。
  - HTTP メソッド – POST を選択します。
  - 操作タイムアウト – 操作のタイムアウト期間をミリ秒単位で入力します (例: 500)。
  - 要求本文タイプ – Raw を選択します。
  - 相対 URL - 入力 /印刷/v2/印刷。
  ノート
  
  クラウドプリントは同期 API です。したがって、ラベルが印刷されるまで待機し、印刷が成功したかどうかについて直ちにフィードバックを提供します。ただし、このプロセスには数秒かかる場合があるため、システムはモバイルデバイスユーザーに悪いユーザーエクスペリエンスを提供する可能性があります。さらに、結果は現在使用されていません。したがって、タイムアウト期間を 500 ミリ秒に設定することをお勧めします。このタイムアウトが経過すると Supply Chain Management は待機を停止しますが、印刷はバックグラウンドで続行されます。
- 要求 HTTP ヘッダー タブで、新しい行を追加してそれに対して次のフィールドを設定します:
  - 鍵 - 入力 Ocp-Apim-サブスクリプションキー。
  - 値 – $auth.secret$ を入力します。ここに表示されているとおりに正確に値を入力してください。
- 要求本文 クイックタブで、以下のフィールドを設定します:
  - コンテンツタイプ - application/json を入力します。
  - 本文 – 要求本文の内容を入力します。次に例を示します。
```
{
    "deviceType": "CloudPrinter",
    "deviceId": {
        "printerName": "$label.printer$",
        "workstation": null
    },
    $label.body$
}
```
アクションウィンドウで、保存を選択します。
アクションウィンドウで、新規を選択して、操作の簡単な説明を入力してください。次に、新しいレコードに対して次の手順に従います。 ZPL ベースのレイアウトを使用しない場合は、ステップ 10 に進んでください。
- ヘッダーで、次のフィールドを設定します。
  - 外部サービス操作 – 操作の名前を入力します (例: SendData)。
  - 説明 – 操作の簡単な説明を入力してください (例: クラウドプリンターに ZPL を送信する)。
- 一般クイックタブで、次のフィールドを設定します。
  - HTTP メソッド – POST を選択します。
  - 操作タイムアウト – 操作のタイムアウト期間をミリ秒単位で入力します (例: 500)。
  - 要求本文タイプ – Raw を選択します。
  - 相対 URL - 入力 /印刷/v2/SendData。
- HTTP 要求ヘッダー タブで、新しい行を追加してそれに対して次のフィールドを設定します:
  - 鍵 - 入力 Ocp-Apim-サブスクリプションキー。
  - 値 – $auth.secret$ を入力します。ここに表示されているとおりに正確に値を入力してください。
- 要求本文 クイックタブで、以下のフィールドを設定します:
  - コンテンツタイプ - application/json を入力します。
  - 本文 – 要求本文の内容を入力します。次に例を示します。
```
{
    "deviceType": "CloudPrinter",
    "deviceId": {
        "printerName": "$label.printer$",
        "workstation": null
    },
    "data": "$label.body:base64$"
}
```
アクションウィンドウで、保存を選択します。
外部サービスの定義 ページに戻るには、閉じる ボタンを選択します。
リストペインで、この手順の最初に作業していたレコードを選択します。
ラベル印刷サービス クイックタブで、次のフィールドを設定します。
- 印刷操作 – ZPL ベースのレイアウトを印刷するための操作を作成した場合は、その操作の名前を選択します (例: SendData)。
- 変数の印刷操作 – 変数ベースのレイアウトを印刷するための操作を作成した場合は、その操作の名前を選択します (例: 印刷)。
- 変数ラベルレイアウトテンプレート – 変数ベースのレイアウトを使用している場合は、変数ベースのレイアウトテンプレートのコンテンツを入力します。次に例を示します。
```
"filePath": "$SystemVariables.LabelFile$",
"quantity": "$SystemVariables.Quantity$",
"dataSources": [
    {
        {{Row Table=LabelLayoutVariable
            "$LabelLayoutVariable.Variable$": "$LabelLayoutVariable.Value$",
        }}
    }
]
```

クラウドプリント API を使用して印刷用の外部サービスインスタンスをセットアップする

以下の手順に従って、クラウド印刷 API を使用して印刷用の外部サービスインスタンスをセットアップしてください。

倉庫管理 > 設定 > 外部サービス > 外部サービスインスタンス に移動します。
アクションペインで、新規を選択して外部サービスインスタンスを作成します。
新しいサービスインスタンスの以下のフィールドを設定します:
- 外部サービスインスタンス – サービスインスタンスの名前を入力します (例: NLPrintProd)。
- 説明 – インスタンスの短い説明を入力します (例: NiceLabel クラウドプリント API 製品)。
- 外部サービス定義 – インスタンスで使用するサービス定義を選択します。この記事で先に提案したサービス定義値の例は NLPrint でした。
一般タブで、次のフィールドを設定します。
- ベース URL - https://labelcloudapi.onnicelabel.com を入力します。
- 認証シークレット – NiceLabel 開発者ポータルからプライマリまたはセカンダリのサブスクリプションキーを入力します。このキーは、NiceLabel　との統合を準備する際に、もっと早くメモしておくべきでした。
- ロギングレベル - 成功とエラー を選択します。
- ログリクエストの本文 - 成功とエラー を選択します。

変数または ZPL を使用して、ラベルプリンターとラベルレイアウトを作成できるようになりました。

ノート

Supply Chain Management の ラベルプリンター ページでラベルプリンターを作成する際、ラベル印刷サービスプリンター名 フィールドに、NiceLabel Cloud Control Center の クラウドプリンター タブからプリンター名を入力します。　
Supply Chain Management の ラベルレイアウト ページで変数ベースのラベルレイアウトを作成する場合、システム変数 グリッドに 変数名 フィールドが LabelFile と設定されている行を含めます。 Value フィールドは、ラベルの完全なパスとファイル名に設定されます。フルパスとファイル名を確認するには、NiceLabel Control Center にサインインし、ドキュメント タブでラベルファイルを選択し、パスフィールド (ファイルプロパティ の下) のフル値をコピーします。

クラウドトリガー API を使用してローカルネットワークプリンターに印刷する Supply Chain Management の構成

Cloud Trigger API を使用すると、NiceLabel Automation Service のオンプレミスインストールを呼び出すことができ、リクエストが処理され、事前にプログラムされたアクションが実行されます。次の手順に進む前に、NiceLabel Automation Service を実行するコンピューターに NiceLabel をインストールし、それらのコンピューターに必要なプリンターをセットアップします。プリンターのインストールと設定に役立つガイダンスについては、NiceLabel のドキュメントを参照してください。

NiceLabel Automation Service の構成を簡素化するには、NiceLabel クラウドデータ統合パックを使用し、NiceLabel ヘルプセンターの付録 A: 統合バンドルに記載のの指示に従ってください。次の手順は、必要な手順をまとめたものです。詳細については、NiceLabel ヘルプセンターをご覧ください。

提供されたリンクを使用して統合パックをダウンロードします。
NiceLabel コントロールセンターにログインします。
ドキュメント タブで、次のフォルダを作成します: /Demo/LabelCloudDataIntegration。
ダウンロードした zip ファイルを開き、ファイルを解凍します。
ドキュメントストレージフォルダーの内容を NiceLabel コントロールセンターの LabelCloudDataIntegration フォルダーにアップロードします。
NiceLabel Automation Service がインストールされているコンピューターで、NiceLabel Automation Manager を開きます。
まだ接続していない場合は、NiceLabel Automation Service を NiceLabel Cloud インスタンスに接続します。
NiceLabel Automation Manager で、追加を選択し、NiceLabel Cloud の LabelCloudDataIntegration フォルダーを参照します。
CloudIntegration-CloudTrigger.misx ファイルを開きます。
印刷トリガーが一意の識別子 Api-CloudIntegrationDemo-Print を使用していることを確認します。次に、このトリガーのみを開始します。 Supply Chain Management は現在、他のトリガーをサポートしていません。

印刷トリガーをインストールして開始したら、Cloud Trigger API を使用して NiceLabel Automation Service にアクセスするために必要な外部サービス定義と外部サービスインスタンスを構成する準備が整います。デモ自動化構成をカスタマイズしない限り、印刷できるのは変数ベースのレイアウトのみであり、ZPL ベースのレイアウトは印刷できません。この場合、外部サービス定義で構成する必要がある操作はひとつだけです。

クラウドトリガー API を使用して印刷用の外部サービス定義をセットアップする

以下の手順に従って、クラウドトリガー API を使用して印刷用の外部サービス定義をセットアップしてください。

倉庫管理 > 設定 > 外部サービス > 外部サービス定義 に移動します。
アクションペインで、新規を選択して外部サービス定義を作成します。
新しいサービス定義の以下のフィールドを設定します:
- 外部サービス定義 – NLTrigger と入力します。
- 説明 – NiceLabel ラベルクラウドトリガー API と入力します。
アクションウィンドウで、保存を選択します。
外部サービス操作 クイックタブで、ツールバーの 操作の編集 を選択します。
外部サービス操作 ページのアクションペインで新規を選択し、印刷サービス操作の操作を追加します。次に、新しいレコードに対して次の手順に従います:
- ヘッダーで、次のフィールドを設定します。
  - 外部サービス操作 – 操作の名前を入力します (例: 印刷)。
  - 説明 – 操作の簡単な説明を入力してください (例: ローカルのプリンターに印刷する)。
- 一般クイックタブで、次のフィールドを設定します。
  - HTTP メソッド – POST を選択します。
  - 操作タイムアウト – 操作のタイムアウト期間をミリ秒単位で入力します (例: 500)。
  - 要求本文タイプ – Raw を選択します。
  - 相対 URL – /Trigger/v1/CloudTrigger/Api-CloudIntegrationDemo-Print と入力します。
- HTTP 要求ヘッダー タブで、新しい行を追加してそれに対して次のフィールドを設定します:
  - 鍵 - 入力 Ocp-Apim-サブスクリプションキー。
  - 値 – $auth.secret$ を入力します。ここに表示されているとおりに正確に値を入力してください。
- 要求本文 クイックタブで、以下のフィールドを設定します:
  - コンテンツタイプ - application/json を入力します。
  - 本文 – 要求本文の内容を入力します。次に例を示します。
```
{
    "Printer": "$label.printer$",
    $label.body$
}
```
アクションウィンドウで、保存を選択します。
外部サービスの定義 ページに戻るには、閉じる ボタンを選択します。
ラベル印刷サービス クイックタブで、次のフィールドを設定します。
- 印刷操作: - このフィールドは空白のままにします。
- 変数印刷操作 – この手順の前半で作成した印刷操作 ( 印刷など) を選択します。
- 可変ラベルレイアウトテンプレート – 変数ベースのレイアウトテンプレートのコンテンツを入力します。次に例を示します。
```
"FilePath": "$SystemVariables.LabelFile$",
"Quantity": "$SystemVariables.Quantity$",
"Variables": [
    {{Row Table=LabelLayoutVariable
        { 
            "Name": "$LabelLayoutVariable.Variable$",
            "Value": "$LabelLayoutVariable.Value$"
        },
    }}
]
```

クラウドトリガー API を使用して印刷用の外部サービスインスタンスをセットアップする

以下の手順に従って、クラウドトリガー API を使用して印刷用の外部サービスインスタンスをセットアップしてください。

倉庫管理 > 設定 > 外部サービス > 外部サービスインスタンス に移動します。
アクションペインで、新規を選択して外部サービスインスタンスを作成します。
新しいサービスインスタンスの以下のフィールドを設定します:
- 外部サービスインスタンス – サービスインスタンスの名前を入力します (例: NLTriggerProd)。
- 説明 – インスタンスの短い説明を入力します (例: NiceLabel クラウドトリガー API 製品)。
- 外部サービス定義 – 使用するサービス定義を選択します。この記事で先に提案したサービス定義値の例は NLTrigger でした。
一般タブで、次のフィールドを設定します。
- ベース URL - https://labelcloudapi.onnicelabel.com を入力します。
- 認証シークレット – NiceLabel 開発者ポータルからプライマリまたはセカンダリのサブスクリプションキーを入力します。このキーは、NiceLabel　との統合を準備する際に、もっと早くメモしておくべきでした。
- ロギングレベル - 成功とエラー を選択します。
- ログリクエストの本文 - 成功とエラー を選択します。

変数を使用して、ラベルプリンターとラベルレイアウトを作成できるようになりました。

ノート

Supply Chain Management の ラベルプリンター ページでラベルプリンターを作成する際、ラベル印刷サービスプリンター名 フィールドに、NiceLabel Cloud Control Center の クラウドプリンター タブからプリンター名を入力します。　
Supply Chain Management の ラベルレイアウト ページで変数ベースのラベルレイアウトを作成する場合、システム変数 グリッドに 変数名 フィールドが LabelFile と設定されている行を含めます。 Value フィールドは、ラベルの完全なパスとファイル名に設定されます。フルパスとファイル名を確認するには、NiceLabel Control Center にサインインし、ドキュメント タブでラベルファイルを選択し、パスフィールド (ファイルプロパティ の下) のフル値をコピーします。
変数ベースのラベルレイアウトを作成する場合、データ変数 グリッドの 変数名 を システム変数 グリッドの 変数名 と同じです。

次の方法で共有

Loftware NiceLabel ラベルサービスソリューションを使用したラベルの印刷

前提条件

NiceLabel Cloud 統合の準備をする

クラウドプリント API を使用してクラウドプリンターに印刷するための Supply Chain Management の構成

クラウドプリント API を使用して印刷用の外部サービス定義をセットアップする

クラウドプリント API を使用して印刷用の外部サービスインスタンスをセットアップする

クラウドトリガー API を使用してローカルネットワークプリンターに印刷する Supply Chain Management の構成

クラウドトリガー API を使用して印刷用の外部サービス定義をセットアップする

クラウドトリガー API を使用して印刷用の外部サービスインスタンスをセットアップする

その他のリソース

フィードバック

フィードバック

その他のリソース

次の方法で共有

Loftware NiceLabel ラベル サービス ソリューションを使用したラベルの印刷

前提条件

NiceLabel Cloud 統合の準備をする

クラウドプリント API を使用してクラウドプリンターに印刷するための Supply Chain Management の構成

クラウド プリント API を使用して印刷用の外部サービス定義をセットアップする

クラウド プリント API を使用して印刷用の外部サービス インスタンスをセットアップする

クラウド トリガー API を使用してローカルネットワークプリンターに印刷する Supply Chain Management の構成

クラウド トリガー API を使用して印刷用の外部サービス定義をセットアップする

クラウド トリガー API を使用して印刷用の外部サービス インスタンスをセットアップする

その他のリソース

フィードバック

フィードバック

その他のリソース

Loftware NiceLabel ラベルサービスソリューションを使用したラベルの印刷

クラウドプリント API を使用して印刷用の外部サービス定義をセットアップする

クラウドプリント API を使用して印刷用の外部サービスインスタンスをセットアップする

クラウドトリガー API を使用してローカルネットワークプリンターに印刷する Supply Chain Management の構成

クラウドトリガー API を使用して印刷用の外部サービス定義をセットアップする

クラウドトリガー API を使用して印刷用の外部サービスインスタンスをセットアップする