概要

この例の目的は、SQL Serverのデータベーステーブルの更新をトリガーとしてBarTenderドキュメントの印刷を行うデータベース連携を作成することです。インテグレーションサービスはテーブルのデータをドキュメントの名前付きデータソースに渡し、各レコードを印刷します。

シナリオ

ある企業が、ラベルに印刷したいデータを含むバックエンドデータベースを持っています。新しいレコードやデータが追加されると印刷用ラベルがトリガーされるように、テーブルやビューを作成できます。これにより、データベースとBarTenderの間にミドルウェアアプリケーションを用意する必要がなくなります。

実装方法

以下の手順では、上記シナリオのためのインテグレーションの設定、展開、検証方法を説明します。

データファイルの準備

1. 以下の内容でSQL Serverのデータベーステーブルを作成します。
2. 
2. データベース名を「TestDb」、テーブル名を「Table_1」とします。

BarTenderドキュメントの作成

1. BarTenderを開きます。
2. ファイルメニューから新規を選択し、新規ドキュメントウィザードを開きます。
3. 空白のテンプレートを選択し、完了をクリックして新規ドキュメントウィザードを閉じます。BarTenderに新しいドキュメントが表示されます。
4. ファイルメニューから印刷を選択し、印刷ダイアログを開きます。
5. 名前のドロップダウンリストから使用するプリンターを選択し、閉じるをクリックして印刷ダイアログを閉じます。
6. 2つの名前付きデータソースを作成します。
1. ツールボックスのデータソースタブで名前付きデータソースを選択します。
2. 名前付きデータソースのコンテキストメニューから名前付きデータソースの作成を選択し、名前付きデータソース作成ウィザードを開きます。
3. 名前欄に「CompanyName」と入力します。
4. 完了をクリックします。
5. 閉じるをクリックして名前付きデータソースダイアログを閉じます。
6. ツールボックスで再度名前付きデータソースを選択し、同じ手順を繰り返します。今度は「IDNumber」という名前のデータソースを作成します。
7. 作成メニューから、1行テキストオブジェクトをドキュメントに追加します。
8. 作成メニューから、Code 128タイプのバーコードをドキュメントに追加します。
9. テキストオブジェクトのコンテキストメニューからプロパティを選択し、テキストプロパティダイアログを開きます。
10. 左側のナビゲーションペインでデータソースの下にある、先ほど作成したデータソース（現在は「サンプルテキスト」）を選択します。
11. まだ開いていない場合は、データソースタブをクリックします。
12. 名前の右側をクリックしてデータソース名の変更ウィザードを開きます。
13. ウィザードで既存の名前付きデータソースにリンクを選択します。
14. 名前付きデータソースのリストから「CompanyName」を選択します。
15. OKをクリックしてデータソース名の変更ウィザードを閉じます。
16. 閉じるをクリックしてテキストプロパティダイアログを閉じます。
17. バーコードオブジェクトのコンテキストメニューからプロパティを選択し、バーコードプロパティダイアログを開きます。
18. 左側のナビゲーションペインで、先ほど作成したデータソース（現在は「12345678」）を選択します。
19. 手順11～16を繰り返し、今度はバーコードオブジェクトをIDNumberの名前付きデータソースに接続します。
20. ファイルメニューから名前を付けて保存を選択し、BarTenderドキュメントを「CompanyList.btw」という名前で保存します。

インテグレーションの作成

1. Integration Builderを開きます。
2. 新しいインテグレーションの作成をクリックし、新しいインテグレーションダイアログを開きます。
3. データベースを選択し、OKをクリックして新しいインテグレーションダイアログを閉じます。
4. データベースインテグレーションペインでインテグレーションを選択します。
5. プロパティペインで、インテグレーションの名前に「CompanyList」と入力します。
6. インテグレーションの開始ドロップダウンリストから自動を選択します。
7. ユーザーアカウントでユーザー認証情報を指定します。詳細は空のファイルを使ってドキュメントを印刷するをご覧ください。
8. データベースインテグレーションペインで新規レコード検出を選択します。
9. プロパティペインでデータベース接続の設定をクリックし、データベース設定ウィザードを開きます。
10. Microsoft SQL Serverを選択し、次へをクリックします。
11. サーバーの右側にサーバー名を入力します。
12. ユーザー名とパスワードを指定する（データベース認証）を選択し、使用するユーザー名とパスワードを入力します。
13. データベースのドロップダウンリストから、テーブル「TestDb」を作成したSQL Serverデータベース名を選択し、次へをクリックします。
14. ウィザードを使ってSQL文を作成するを選択します。
15. 利用可能なテーブルリストから「TestDB」を使用するテーブルリストに追加し、次へをクリックします。
16. レコードブラウザーを選択して正しいデータが読み込まれているか確認し、OKをクリックして接続を完了します。
17. プロパティペインの新規レコード検出方法でフィールドの値が増加するを選択します。
18. フィールドのドロップダウンリストからIDを選択します。最終値は0のままにします。これにより、指定した最終値とデータベースフィールド以降のレコードでインテグレーションが実行されます。
19. データベースインテグレーションペインでアクションノードを展開し、さらに各データベースレコードごとノードを展開します。
20. ドキュメントの印刷アクションを選択します。
21. プロパティペインでドキュメントセクションまでスクロールします。
22. ドキュメントの右側で、先ほど作成したBarTenderドキュメント「CompanyList.btw」を選択します。
23. 名前付きデータソースの下で、変数データベースフィールド名を使って名前付きデータソースに値を割り当てます。
    
    • 名前列はBarTenderドキュメントで設定した名前付きデータソースを指し、値列は実際に名前付きデータソースに送信される値を指します。この例では、インテグレーションで使用するデータベースの変数フィールド名となります。

    

24. Integration Builderの左上にあるをクリックして、インテグレーションファイルを「DatabaseIntegration.btin」として保存します。

インテグレーションのテスト

1. Integration Builderウィンドウ下部のテストタブをクリックします。
2. テストウィンドウ右上の開始ボタンをクリックします。
3. データベーステーブルに7件の新規レコードがある場合、7枚のドキュメントが印刷されます。
4. インテグレーションが正常に動作していれば、Integration Builderの左上にあるをクリックしてインテグレーションファイルを保存します。これでインテグレーションを管理コンソールに展開できます。

インテグレーションの展開

1. Integration Builderのツールバーから インテグレーションの展開をクリックし、新しい展開ダイアログを開きます。
2. 新しい展開ダイアログで、展開の名前と説明を入力します。
3. インテグレーションファイルの設定がDatabaseIntegration.btinになっていることを確認します。違う場合は参照をクリックし、DatabaseIntegration.btinを選択します。
4. ターゲットサーバーで、インテグレーションファイルを展開したいサーバーを追加します。
5. 必要なエラー処理の設定を指定します。
6. OKをクリックしてダイアログを閉じ、インテグレーションファイルを展開します。
7. 管理コンソールがインテグレーションノードで開き、作成したインテグレーションが表示されます。