概要

BarTender Print Portalは、ユーザーがホストされているウェブサイトにアクセスすることで、どこからでも印刷できるウェブベースのアプリケーションです。このアプリケーションはInternet Information Services（IIS）上で動作し、.NET Coreの上で稼働します。この記事では、いくつかの主要なコンポーネントの紹介と、よくある問題の解決方法について説明します。すべてを網羅しているわけではありませんが、導入の手助けになるはずです。本ガイドはBarTender側のトラブルシューティングを目的としており、IIS自体のトラブルシューティングは範囲外となります。

対象バージョン

BarTender 2021以降

情報

この記事はBarTender 2021以降に適用されます。BarTender Print Portalはバージョンごとに異なるため、上部のドロップダウンメニューからご利用のバージョンを選択してください。

BarTender Print Portalのどのバージョンでもトラブルシューティングを行う際は、まずご利用中のバージョンが最新リリースであることを確認してください。すでに修正されている問題を調査しないようにするためです。方法については、BarTenderの最新リビジョンへのアップデート方法をご覧ください。

また、IIS Web管理コンソールがシステムにインストールされていることも必要です。このコンソールはWindowsの機能またはサーバーの機能から見つけることができます。機能一覧の場所が分からない場合は、IT担当者にご相談ください。

BarTender Print Portalのコンポーネント

BarTender Print Portalは、アプリケーションを正常に動作させるために複数のサービスなど、いくつかのコンポーネントに依存しています。主なサービスは以下の通りです：

BarTender System Service - BarTenderシステムデータベースとの通信を担当します。
BarTender Print Schedulerサービス - 次のセクションで説明する印刷エンジンを管理します。
.Net/Tcp Port Sharing Service - BarTender Print PortalとBarTender Print Scheduler間の印刷ジョブ通信を補助するWindowsサービスです。

運用に使われるサービスに加え、以下の2つの主要なコンポーネントについて詳しく説明します：

印刷エンジン

印刷エンジンは、BarTender Designerがサービスとして動作しているもので、必要に応じて自動的に起動・停止し、BarTender Print Portalの要求に応じて処理します。これらの印刷エンジンはBarTender Print Schedulerサービスによって管理され、ユーザーの操作は不要です。

ユーザーが印刷ボタンをクリックして印刷ジョブを作成すると、印刷エンジンがまだ起動していない場合は自動的に起動します。ドキュメントを開き、BarTender Print Portalから送信されたデータを処理し、その後Windowsの印刷スプーラーに印刷ジョブを送信してプリンターに出力します。BarTender 2021以降では、印刷エンジンはラベルのプレビュー画像の生成も担当します。

システムデータベース

BarTender System Databaseは、BarTender Suite全体を支えるSQLデータベースです。これは管理コンソールやインストールウィザードを通じてローカルにインストールされる場合もあれば、専用サーバー上に集中管理される場合もあります。

すべてのBarTenderバージョンで、システムデータベースはBarTender Print Portalの動作に必須です。これがないとアプリケーションは動作しません。

通常運用に必要な権限

BarTender Print Portalの正常な運用には、特定の権限が必要です。これは個々のユーザーアクセス制御のための権限ではなく、各コンポーネントが正しく動作するための権限です。これらの権限により、BarTender Print Portalは以下のことが可能になります：

ラベルファイルへのアクセス、開封、印刷
ローカルまたはネットワーク上のプリンターへのアクセス
Active Directoryのユーザーおよびグループリストへのアクセス（BarTender 2021以降）
Librarianへのアクセス

これらはすべてではありませんが、BarTender Print Portalの主要な機能をカバーしています。デフォルトでは、BarTender Print Portalはローカル管理者アカウントで動作し、ローカルにインストールされたプリンターやPrint Portalディレクトリにアクセスできますが、場合によってはこれだけでは不十分で、権限チェックに失敗することがあります。

権限に関する問題が発生しやすい主なポイントは、BarTender Print Schedulerサービス、IIS App Pool Identity、システムデータベースのログインの3つです。

Print SchedulerサービスとApp Pool Identityには、以下の条件を満たすWindowsアカウントが必要です：

ローカル管理者であること（Print Portalのファイルディレクトリへのアクセスが必要なため）
ドメインリソース（プリンターやネットワークドライブなど）を利用する場合は、ドメインレベルのアクセス権があること（ドメイン管理者である必要はありません）
Active Directoryのユーザーおよびグループリストを読み取る権限があること（BarTender 2021以降）
パスワードを変更しないこと（数か月後にパスワードポリシーが適用されて権限エラーが発生しないように）
ローカルログオングループポリシーの権限があること（これがないとサービスやアプリプールが実行できません）
システムデータベースへのアクセス権限があること（Windows認証を使用する場合のみ必要）

Print SchedulerとApp Pool Identityには同じアカウントを使用することを推奨します。まずサービスにアカウントを追加して権限をテストすると、App Pool Identityで権限不足のエラーが出ない場合でも問題を特定しやすくなります。

システムデータベースについては、Windows認証による権限の問題を避けるため、SQL認証の利用を推奨します。詳細はシステムデータベースへの権限設定（動画 - 5:45）をご覧ください。

BarTender Print Schedulerサービスの権限設定

Print Schedulerサービスのアカウントを変更するには、以下の手順を実行してください：

スタートメニューでサービスアプリを検索するか、コントロールパネルから開きます。
BarTender Print Schedulerサービスまでスクロールします。
サービスを右クリックし、プロパティを選択します。
ログオンタブをクリックします。
このアカウントを選択し、ユーザー名とパスワードを入力します。ドメイン名も追加することを忘れないでください。追加しないとローカルアカウントで起動しようとします。

資格情報を入力したら、OKをクリックし、アカウント変更に関する通知を進めてください。
BarTender Print Schedulerサービスを右クリックし、再起動を選択して新しいアカウントでサービスを再起動します。

起動時にエラーが発生した場合は、前述の権限がすべて付与されているか再度確認し、手順を繰り返してください。

IIS App Pool Identityの権限設定

IIS App Pool Identityのアカウントを変更するには、以下の手順を実行してください：

Internet Information Services（IIS）マネージャーを起動します。
サーバー名の横の矢印をクリックしてツリーを展開します。
アプリケーションプールをクリックします。
BPP_AppPoolを右クリックし、詳細設定を選択します。
Identity設定を探します。通常、太字でカスタムローカルIdentityが設定されています。
Identityをクリックし、右側の「...」ボタンをクリックします。設定ダイアログが開きます。
設定ボタンをクリックします。
ユーザー名とパスワードをフルで入力します。ドメイン名も追加してください。これによりApp Poolがローカルユーザーではなくドメインユーザーを使用するようになります。
OKをクリックし、すべてのダイアログを閉じてIISマネージャーに戻ります。
BPP_AppPoolが選択された状態で、右側のメニューから停止をクリックし、その後開始をクリックします。これで新しいアカウントでApp Poolが再起動します。

エラーメッセージが表示された場合は、入力した資格情報が正しいか、アカウントが前述の要件を満たしているか再度ご確認ください。

互換性

Print Portalはすべての最新ウェブブラウザで動作するよう設計されています。ただし、BarTender 2021以降ではInternet Explorerの使用は推奨されず、サポートもされていません。

BarTender Print Portalをスムーズに動作させるには、対応するオペレーティングシステム上で実行する必要があります。対応OSとバージョンの一覧はBarTender対応Windowsバージョンでご確認いただけます。例えば、BarTender 2021をWindows Server 2008で実行するなど、非対応の組み合わせではサービスや印刷エンジンが正しく動作せず、印刷時にクラッシュや不安定な挙動が発生する場合があります。インストール前に必ず一覧を確認してください。

また、BarTenderのビット数とOSのビット数を合わせることも推奨します。64ビットWindowsを使用している場合は、64ビット版BarTenderをインストールしてください。これによりIISやBarTenderサービスとの互換性が保たれ、印刷エンジンも効率的に動作します。

BarTender 2021以降のトラブルシューティング

症状やエラーメッセージをクリックすると、トラブルシューティング手順が展開されます。

Print Schedulerに接続できません

BarTender Print Portalは、サムネイルの作成、印刷プレビューの生成、印刷ジョブの実行のためにBarTender Print Schedulerサービスに依存しています。Print Portalがこのサービスに接続できない場合、以下のようなエラーが表示されることがあります：

このエラーの原因はいくつか考えられます。たとえば、コマンドラインやサービス管理ツールでサービスが停止されている、サービスを実行しているアカウントのパスワードが変更された、通信に何らかの障害が発生している、などです。

サービスを再起動するには、以下の手順を実行してください：

スタートメニューでサービスを検索して起動します。
BarTender Print Schedulerサービスまでスクロールします。
サービスが停止している場合は右クリックして開始を選択します。サービスが実行中の場合は右クリックして再起動を選択します。

ユーザー名やパスワードの誤りに関するエラーメッセージが表示された場合は、BarTender Print Schedulerサービスの権限設定をご参照ください。

これらの手順をすべて試しても問題が解決しない場合は、ご利用のオペレーティングシステムとBarTenderバージョンの互換性を確認してください。非対応の組み合わせを使用している場合、アプリケーションやサービス間の通信に問題が発生することがあります。詳細は互換性のセクションをご覧ください。

印刷ジョブが中断されました：ファイルを開く、読み込む、またはアクセスできません

このエラーメッセージはファイル関連のエラー全般を示しており、主に権限またはリンクされたファイルの欠如が原因です。以下はエラー例と、その読み解き方です：

Print Job Abortedの横には、エラーの原因となった条件が表示されます。この例では、レコードセット（リンクされたデータベース）です。つまり、ラベルファイルがデータベースを開く際に問題が発生しています。
2行目には開けなかったものが表示されます。この場合はcsvデータベースです。
3行目には問題の詳細が簡単に記載されています。この場合、ファイルや指定されたフォルダが見つからないという内容です。

このエラーメッセージは、ラベルファイルで指定された場所にファイルが存在しないか、Print Schedulerサービスがそのディレクトリにアクセスする権限がないため、ファイルが見つからないと判断されていることを示しています。

このようなエラーが発生した場合、まずラベルファイルを開いてみてください。

何かエラーメッセージが表示されますか？
データ設定ダイアログでデータベースを参照できますか？それとも接続できないと表示されますか？
赤いXが表示された画像がありませんか？
BarTender Designerからラベルを印刷できますか？エラーメッセージは出ませんか？

これらの問題が発生する場合は、まずそれらを修正する必要があります。

ラベルが問題なく印刷できる場合は、権限の問題が考えられます。Print Schedulerサービスが画像やデータベースなどのリンクリソースにアクセスできない場合も、このエラーが発生します。対処方法については、権限のセクションをご参照ください。

権限設定時にユーザーまたはグループリストが空になる

BarTender Print Portalでフォルダーの権限を設定しようとした際、下記のように場所に「ドメイン」を選択してもダイアログが空になる場合があります：

これは、BarTender Print PortalがActive Directoryのユーザーやグループを取得できなかったことを意味します。取得する権限がありません。これを解決するには、Active Directoryリストを読み取る権限を持つアカウントをIIS App Poolに追加する必要があります。通常はドメインアカウントで十分です。ご自身のアカウントでリストを読み取れるか不明な場合は、IT担当者にご相談ください。

IIS App Poolアカウントの変更方法は、こちらの手順をご参照ください。

ドメインリストにすべてのユーザーやグループが表示されない

IIS App Poolにドメインアカウントを追加しても、ユーザーやグループがリストからランダムに消えてしまうことがあります。

BarTender Print Portalが、数万件以上の非常に大きなActive Directoryから完全なリストを取得できない問題がありました。BarTender 2021 R5以降にアップデートして、この問題を解決してください。

ルートフォルダーが設定されていません

個別のフォルダーにセキュリティ設定をした後、Print Portalを閲覧すると、次のようなエラーメッセージが表示されることがあります：

ユーザーが閲覧できるフォルダーがない場合、このエラーメッセージは正当なものです。

しかし、特定のユーザーにフォルダーの閲覧権限があるにもかかわらずこのエラーが表示される場合、いくつかの原因が考えられます：

アプリプールの権限

ユーザーがフォルダーを閲覧できるか確認する際、BarTender Print PortalはActive Directoryにユーザーが所属するグループを問い合わせます。この確認が失敗すると、デフォルトでアクセスが拒否されます。この確認はApp PoolのIDに依存しており、IDのパスワードが変更されたり、削除されたりした場合などに失敗することがあります。

この問題が権限によるものであれば、IDのパスワードを再入力するか、Active Directoryと通信できる権限を持つアカウントに変更してみてください。詳細は権限のセクションをご覧ください。

グループの種類が違う

Active Directoryには、用途の異なる複数のグループタイプがあります。認証には、リストから「セキュリティ」タイプのグループのみを選択する必要があります。メール配信リスト用の「配布」タイプなど、他のグループを選択すると、Active Directoryとの確認が失敗します。

App PoolのIDが正しいのに、グループが有効なユーザーのフォルダーを表示できない場合は、BarTenderをアップデートして、リストに「セキュリティ」タイプのグループのみが表示されるようにしてください。アップデート後は、BarTender Print Portalでフォルダーの権限を再設定してください。

Print Portalでフォルダーを移動するとフリーズする

Print Portalでフォルダーを移動中にアプリケーションがフリーズする場合、システムデータベースへの接続に問題があることが原因です。システムデータベースが接続されていない理由はいくつか考えられます：

データベースホストがオフラインになっている
データベースが存在しない
システムデータベースが設定されていない
現在のユーザーに接続権限がない

接続の問題

BarTenderスイートの多くはシステムデータベースに依存しているため、まずは接続設定を行う「管理コンソール」から確認しましょう。手順は以下の通りです：

管理コンソールをスタートメニューから開きます。
左側のメニューからシステムデータベースを選択します。
右側の上部にある詳細を確認します。

正常なデータベース接続の場合、「接続済み」と表示されます。異なるステータスやデータが表示されない場合、または「システムデータベースが設定されていません」といったバナーが表示される場合は、システムデータベースウィザードのリンクからデータベース接続を設定してください。こちらのガイドが参考になります。次に問題となる「権限」トラブルを避けるためにも、SQL認証の利用を強く推奨します。この動画では新しいデータベースでの設定方法を解説しています。データベースが管理されている場合は、データベース管理者にご相談ください。

権限の問題

管理コンソールで「接続済み」と表示されているのに、BarTender Print Portalでシステムデータベースエラーが出る場合、権限の問題が考えられます。認証方法（WindowsまたはSQL）に関わらず、6つの基本権限が必要です。これらの権限が1つでも不足していると、正常に動作せず、システムデータベースに接続できない旨のエラーが表示されることがあります。

どのアカウントでシステムデータベースに接続しているかを確認するには、以下の手順を行ってください：

管理コンソールを開きます。
左側のメニューからシステムデータベースを選択します。
システムデータベースウィザードをクリックします。
接続設定をカスタマイズを選択します。次の画面で認証方法が表示されます。
1. SQL認証の場合は、ダイアログに表示されているアカウント名を控えてください。
2. Windows認証の場合は、IIS App Poolを実行しているアカウント名を控えてください。

アカウント名が分かったら、このガイドを参考に、必要な権限がすべて付与されているか確認してください。方法が分からない場合やデータベースが管理されている場合は、データベース管理者に「6つの基本権限が必要」と伝えてください。

不明なエラーが発生しました

印刷を試みた際、次のような不明なエラーが表示されることがあります：

このエラーは、他に表示できるエラーメッセージがない場合に使われる汎用的なものです。多くの場合、ラベルやラベルに関連する何かに問題があります。このようなエラーが出た場合は、まずラベル自体を確認して問題箇所を特定しましょう。

リンクされたリソース

最も多い原因は、リソースの不足です。ラベルを開いて確認してください。

エラーメッセージが表示されますか？
データセットアップダイアログでデータベースを参照できますか？それとも接続できないと表示されますか？
赤いXが表示された画像がありませんか？
BarTender Designerからラベルを印刷できますか？エラーメッセージは出ませんか？

これらのいずれかが表示された場合は、印刷前に修正が必要です。

ラベル自体は問題なく印刷できる場合は、権限の問題の可能性があります。Print Schedulerサービスが画像やデータベースなどのリンクされたリソースにアクセスできない場合も、このエラーが表示されます。対処方法は権限のセクションをご覧ください。

リンクされたデータベース

ラベルにリンクされたデータベースの場合、関係する要素が多いため少し複雑です。Print Portalでデータベースに接続する際は、IIS App Poolのアカウント（Windows認証の場合）またはラベルに保存された認証情報（データベース認証の場合）が使われます。テキストデータベースの場合は、接続エラー時にファイルエラーが表示されることが多いので、ここではリレーショナルデータベースについて説明します。

データベースエラーの主な原因は以下の通りです：

データベースが移動またはリネームされた
データベースがオフラインになっている
ODBC接続がユーザーDSNで設定されている（システムDSNではない）
データベース接続に必要な認証情報がラベルに保存されていない
データベースがWindows認証を使用しており、BarTender Print Portalを実行しているユーザーにアクセス権がない

データベースの種類や接続方法によって状況は異なるため、すべてのケースに当てはまるわけではありません。まずはラベルを開き、接続タイプを確認してからトラブルシュートしてください。

ファイル > データベース接続の設定からデータベースダイアログを開きます。
ダイアログを開いたときやレコードを参照しようとしたときに接続エラーが出る場合、データベースが移動・リネーム・オフライン、または利用できない可能性があります。データベースが利用可能か、オンラインかを確認してください。管理されている場合はデータベース管理者にご相談ください。
データベース設定ダイアログでデータベース設定ウィザードを開き、接続情報を確認します。
- 接続はWindows認証ですか？データベース認証ですか？
- 認証情報はドキュメントに保存されていますか（データベース認証の場合）？
- ここに表示されている認証情報は正しいですか？
ODBC接続の場合は、DSNの設定も確認してください。

エラーを修正し、認証方法や認証情報を正しく設定したら（Windows認証以外はドキュメントに保存）、ドキュメントを保存してPrint Portalのフォルダーに戻してください。

概要

BarTender Print Portalは、ユーザーがホストされているウェブサイトにアクセスすることで、どこからでも印刷できるウェブベースのアプリケーションです。このアプリケーションはInternet Information Services（IIS）上で動作し、.NETコア上で稼働します。この記事では、主なコンポーネントの紹介やよくある問題の解決方法について説明します。すべてを網羅しているわけではありませんが、導入の手助けになるはずです。本ガイドはBarTender側のトラブルシューティングを目的としており、IIS自体のトラブルシューティングは範囲外となります。

対象バージョン

BarTender 2016 および 2019

情報

この記事はBarTender 2016および2019に適用されます。BarTender Print Portalはバージョンごとに異なるため、上部のドロップダウンメニューからご利用のバージョンを選択してください。

BarTender Print Portalのいずれのバージョンでもトラブルシューティングを行う際は、すでに修正されている問題を調査しないよう、必ずご利用中のバージョンの最新リリースを使用していることを確認してください。方法については、BarTenderの最新リビジョンへのアップデート方法をご覧ください。

また、IIS Web管理コンソールもシステムにインストールしておくことをおすすめします。このコンソールはWindowsの機能またはサーバーの機能一覧から見つけることができます。機能一覧の場所が分からない場合は、IT担当者にご相談ください。