次の方法で共有

Seagull Scientific BarTender® ラベル サービス ソリューションを使用してラベルを印刷する

  • [アーティクル]

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

BarTender ラベル付けソリューションは、オンプレミス ソフトウェアとしても、BarTender Cloud™ という名前のクラウドベースの Software-as-a-Service (SaaS) 製品としても利用できます。 現在、Supply Chain Management の外部ラベル印刷サービスと併用できるのは BarTender Cloud のみです。

この記事では、Supply Chain Management を BarTender Cloud と統合する方法について説明します。 これには、BarTender Cloud REST API を介して YAML 形式でドキュメントを交換することによって BarTender Cloud と通信する方法に関する情報が含まれています。 BarTender Cloud の詳細については、BarTender Cloud を参照してください。

重要

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

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

前提条件

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

BarTender Cloud から個人アクセス トークンのコピーを取得する

REST API を通じて BarTender Cloud にアクセスする前に、BarTender Cloud から個人アクセス トークンのコピーを取得する必要があります。 Supply Chain Management は、このトークンを使用して BarTender Cloud で認証します。 このトークンの取得方法の詳細については、BarTender ヘルプ センターの BarTender Cloud REST API を参照してください。 トークンは後で入力する必要があるので、必ずメモしておいてください。

ノート

個人用アクセス トークンの有効期限は 30 日です。 古いトークンの有効期限が切れる前に、新しいトークンを入力する必要があります。 トークンを手動で更新して、新しいトークンを取得できます。

Supply Chain Management を構成して BarTender Cloud が管理するプリンターに印刷する

BarTender Cloud サービスが実行する必要があるスクリプトについては、BarTender Cloud Actions REST AP Iは、YAML ベースおよび JSONベ ースのアクション スクリプトや、古い BarTender XML (BTXML) 形式を使用するスクリプトなど、いくつかの形式を受け入れます。 この記事では、印刷されるラベルは BarTender Cloud アカウントに保存されているデザインに基づいています。 この記事では、PrintBTWAction アクションを使用して、ローカル ネットワークにインストールされている BarTender Cloud Print Gateway 経由でアクセスされるプリンターにラベルを印刷する方法について説明します。

Actions API を使用して印刷用の外部サービス定義をセットアップする

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

  1. 倉庫管理 > 設定 > 外部サービス > 外部サービス定義 に移動します。

  2. アクション ペインで、新規 を選択して外部サービス定義を作成します。

  3. 新しいサービス定義の以下のフィールドを設定します:

    • 外部サービス定義 – サービス定義の名前を入力します (例: BTCloud)。
    • 説明 – サービス定義の短い説明を入力します (例: BarTender Cloud)。

  4. アクション ウィンドウで、保存を選択します。

  5. 外部サービス操作 クイック タブで、ツールバーの 操作の編集 を選択します。

  6. アクション ウィンドウの 外部サービス オペレーション ページで、新規 を選択して、変数を印刷するためのオペレーションを追加します。 次に、新しいレコードに対して次の手順に従います:

    • ヘッダーで、次のフィールドを設定します。

      • 外部サービス操作 – 操作の名前を入力します (例: アクション)。
      • 説明 – 操作の簡単な説明を入力します (例: Actions API)。

    • 一般クイック タブで、次のフィールドを設定します。

      • HTTP メソッド – POST を選択します。
      • 操作タイムアウト – 操作のタイムアウト期間をミリ秒単位で入力します (例: 500)。
      • 要求本文タイプ – Raw を選択します。
      • 相対 URL – /api/actions と入力します。

      ノート

      クラウド プリントは同期 API です。 したがって、ラベルが印刷されるまで待機し、印刷が成功したかどうかについて直ちにフィードバックを提供します。 ただし、このプロセスには数秒かかる場合があるため、システムはモバイル デバイス ユーザーに悪いユーザー エクスペリエンスを提供する可能性があります。 さらに、結果は現在使用されていません。 したがって、タイムアウト期間を 500 ミリ秒に設定することをお勧めします。 このタイムアウトが経過すると Supply Chain Management は待機を停止しますが、印刷はバックグラウンドで続行されます。

    • 要求 HTTP ヘッダー タブで、新しい行を追加してそれに対して次のフィールドを設定します:

      • キー – 認可 を入力します。
      • 値 – ベアラー $auth.secret$ を入力します。 ここに表示されているとおりに正確に値を入力してください。

    • 要求本文 クイック タブで、以下のフィールドを設定します:

      • コンテンツ タイプ – text/yaml と入力します。

      • 本文 – 要求本文の内容を入力します。 次に例を示します。

        - SetVariableAction:
    VariableName: D365PrinterName
    VariableValue: $label.printer$
$label.body$

        重要

        ここに表示されているとおりに本文テキストを貼り付けます。 インデントは重要です。 インデントには必ず 4 つのスペースを使用してください。 タブは使用しないでください。

  7. アクション ウィンドウで、保存を選択します。

  8. 外部サービスの定義 ページに戻るには、閉じる ボタンを選択します。

  9. リスト ペインで、この手順の最初に作業していたレコードを選択します。

  10. ラベル印刷サービス クイック タブで、次のフィールドを設定します。

    • 印刷操作: - このフィールドは空白のままにします。

    • 変数の印刷操作 – 変数ベースのレイアウトを印刷するために作成した操作の名前を選択します (例: 行動)。

    • 可変ラベル レイアウト テンプレート – 変数ベースのレイアウト テンプレートのコンテンツを入力します。 次に例を示します。

      - PrintBTWAction:
    DocumentFile: librarian://Main/$SystemVariables.LabelFile$
    Printer: "%D365PrinterName%"
    Copies: $SystemVariables.Quantity$
    NamedDataSources:
{{Row Table=LabelLayoutVariable
      $LabelLayoutVariable.Variable$: $LabelLayoutVariable.Value$
}}

      重要

      ここに表示されているとおりに本文テキストを貼り付けます。 インデントは重要です。 インデントには必ず 4 つのスペースを使用してください。 NamedDataSources 変数については、必ず空白 6 文字でインデントしてください。 タブは使用しないでください。

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

この手順には、以前に BarTender Cloud から取得 した個人アクセストークンが必要です。

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

  1. 倉庫管理 > 設定 > 外部サービス > 外部サービス インスタンス に移動します。

  2. アクション ペインで、新規 を選択して外部サービス インスタンスを作成します。

  3. 新しいサービス インスタンスの以下のフィールドを設定します:

    • 外部サービス インスタンス – サービス インスタンスの名前を入力します (例: BTCloud)。
    • 説明 – インスタンスの簡単な説明を入力します (例: BTCloud)。
    • 外部サービス定義 – インスタンスで使用するサービス定義を選択します。 この記事で先に提案したサービス定義値の例は BTCloud でした。

  4. 一般タブで、次のフィールドを設定します。

    • ベース URL – 地域に応じて、次のインスタンス URL のいずれかを入力します。

      • AMER 地域の場合:https://am1.bartendercloud.com
      • EMEA 地域の場合:https://eu1.bartendercloud.com
      • APAC 地域の場合:https://ap1.bartendercloud.com

    • 認証のシークレット – BarTender Cloud から取得した個人アクセス トークンを入力します。 このトークンは、BarTenderとの統合を準備する際 に、もっと早くメモしておくべきでした。

    • ロギング レベル - 成功とエラー を選択します。

    • ログ リクエストの本文 - 成功とエラー を選択します。

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

ノート

  • Supply Chain Management の ラベル プリンタ ページでラベル プリンタを作成する場合、ラベル印刷サービス プリンタ名 でラベル プリンタを作成します。フィールドに、BarTender Cloud の 印刷 ダイアログ ボックスに表示されるプリンターの名前、またはプリンター API から取得したプリンターの名前を入力します。 次の形式を使用します: プリンター: ワークステーション/プリンター。
  • Supply Chain Management の ラベル レイアウト ページで変数ベースのラベル レイアウトを作成する場合、システム変数 グリッドに 変数名 フィールドが LabelFile と設定されている行を含めます。 Value フィールドは、ラベルの完全なパスとファイル名 (ラベル ファイルがフォルダーに保存されている場合はフォルダーを含む) に設定されます。 BarTender Cloud REST API はライブラリアン パスを使用しますが、完全なライブラリアン名の先頭は変数ラベル テンプレートにすでにコーディングされています。
  • 変数ベースのラベル レイアウトを作成する場合、データ変数 グリッドの 変数名 を システム変数 グリッドの 変数名 と同じです。

その他のリソース