概要

BarTender Print Connector for Dynamics 365 Business Centralは、Business Central用のプラグインです。
このプラグインを使うことで、BarTenderの高性能な印刷エンジンをBusiness Centralに直接統合でき、
ユーザーが自由に設定できる専用のソリューションを提供します。

このガイドでは、BarTender Print Connector for Dynamics 365 Business Centralのインストール方法、BarTender Cloudへの接続方法、印刷の準備ができるように必要な設定のすべてを説明します。

対象製品

BarTender Cloud

Microsoft Dynamics 365 Business Central

情報

BarTender Print Connector for Dynamics 365 Business Centralを利用するには、以下のアプリケーションが必要です：

• AutomationサブスクリプションプランのBarTender Cloud
• Dynamics 365 Business Central Cloud

プラグインのインストール

BarTender Print Connector for Dynamics 365 Business Centralをインストールするには、次のいずれかの方法を使用します：

• Microsoft AppSourceストアで「BarTender」と検索し、プラグインをダウンロードして
  インストールします。
• Business Centralで検索ボックスに「BarTender」と入力し、BarTender Connectorを
  「Get from Microsoft AppSource」から選択して、プラグインをダウンロード・インストールします。

BarTender Cloudの準備

BarTender Print Connectorを接続する前に、BarTender Cloud内で以下の準備が必要です：

• BarTender Print Connector専用のBarTender Cloudアカウントを作成します。既存のユーザーアカウントではなく、この目的のために新しく作成してください。
• 作成したアカウントでパスワード認証を設定し、BarTender Print ConnectorをBarTender Cloudに登録します。これにより、Business CentralからBarTender Cloudテナントスペースにアクセスできるようになります。手順については、BarTender Cloud REST API パスワードベースOAuth認証をご覧ください。

BarTender Cloudへの接続

Business CentralをBarTender Cloudに接続し、データライブラリを同期するには、次の手順を行います：

1. Business Centralで画面右上の検索アイコンをクリックし、検索ボックスにBarTenderと入力します。
2. 「ページとタスクへ移動」内のBarTenderセットアップをクリックします。
3. BarTenderセットアップページで、以下の設定を行います：
   • Root URL：BarTender CloudテナントのベースURLを入力します（すでに指定されている場合は不要）。URLはBarTender Cloudにログインし、ブラウザのアドレスバーからコピーできます。ベースURLの形式は以下の通りです：
     

      https://YourOrganizationDomainID.Datacenter.bartendercloud.com

     組織ドメインIDやデータセンターの確認方法は、BarTender Cloudで組織を管理する方法の「はじめに」セクションをご覧ください。
   • Application IDとClient Secret：BarTender CloudのApplication IDとClient Secretをそれぞれの欄に入力します。これらはManage Cloud Account > BarTender Cloud APIで、登録済みBarTender Print Connectorの右側にある縦の三点リーダーアイコンをクリックし、IDとシークレットを表示を選択すると確認できます。
   • ユーザー名：BarTender Cloudのユーザー名を入力します。
   • パスワード：BarTender Cloudのパスワードを入力します。
   • 印刷タイムアウト：必要に応じて、BarTenderの印刷ジョブがタイムアウトするまでの秒数を設定できます。印刷ジョブの完了に予想以上の時間がかかる場合は、タイムアウト時間を延長してください。
4. 接続テストをクリックして、接続情報が正しいか確認します。BarTender Cloudへの接続に問題がある場合は、こちらの記事をご覧ください。
5. ライブラリ同期をクリックして、BarTender Cloudのプリンター、ラベルテンプレート、テンプレートデータフィールドのデータをBusiness Centralと同期します。使用したいラベルは、事前にBarTender Cloudで作成・設定されている必要があります。詳細は、BarTender Cloudのテンプレートアシスタントを使ったBarTenderドキュメントの作成をご参照ください。
6. 戻るボタンをクリックして、BarTenderセットアップページを終了します。

BarTenderセットアップのトラブルシューティング

BarTenderセットアップ中にエラーが発生した場合や、Client Secret欄が表示されない場合は、BarTender Print Connector for Dynamics 365 Business Centralアプリの更新が必要な場合があります。

1. まず、Dynamics 365の画面右上にある設定アイコンをクリックし、「管理センター」を選択します。

2. 更新したい環境をクリックします。

3. 画面上部のアプリをクリックします。

4. BarTender Print Connectorの右側にある「アップデートをインストール」を選択します。

アップデート完了後、Dynamics 365を再起動する必要がある場合があります。

テンプレートマッピングの設定

Business CentralからBarTender Cloudへ印刷する前に、テンプレートマッピングを設定し、Business Centralの元テーブルやデータベースフィールドとBarTenderラベルテンプレートの対象フィールドを紐付ける必要があります。

設定手順は以下の通りです：

1. Business Centralで画面右上の検索アイコンをクリックし、検索ボックスにBarTenderと入力します。
2. 「ページとタスクへ移動」内のBarTenderテンプレートマッピングをクリックします。
3. 新規をクリックします。
4. 「一般」エリアで、以下の設定を行います：
   • ソーステーブルID：ドロップダウンメニューから、使用したいBusiness CentralテーブルのIDを選択します。選択した内容は「ソーステーブル名」欄に反映されます。
   • テンプレート名：使用したいBarTenderドキュメントテンプレート名を選択します。
   • プリンター：印刷ジョブを送信するプリンターを選択します。PDFを選択した場合は、以下の追加設定が必要です：
     
     • PDF印刷ファイル名：保存するPDFファイルの名前を入力します。
   • 説明：マッピングの説明を入力します。この説明は印刷時にユーザーに表示されますのでご注意ください。

プリンター設定セクションには、以下の2つのオプションもあります。どちらも内容は分かりやすいものです：

• 印刷後にドキュメントを閉じる
• 印刷後に保存する

フィールドマッピング

1. BarTenderテンプレートマッピングページの「フィールドマッピング」エリアで、選択したソーステーブルのフィールドとBarTenderテンプレートのフィールドを以下の設定で紐付けます：
   • ソースフィールド番号：マッピング元となるソースフィールドのIDを入力します。省略記号（…）をクリックして「フィールド検索」ページを表示し、希望のフィールドを選択してください。
   • ターゲットフィールド名：マッピング先となるターゲットフィールド名を選択します。

さらにマッピングを追加したい場合は、次の行をクリックして同様に設定してください。

2. 戻るボタンをクリックしてBarTenderテンプレートマッピングページを閉じます。これでテンプレートが印刷可能なラベル一覧に追加されます。

追加リソース

Dynamics 365 Business Central用BarTender Print Connectorでの印刷