概要

この例では、トリガーファイルを検出した後、指定したBarTenderドキュメントを印刷するインテグレーションを設計します。トリガーファイル自体に、ドキュメントのテンプレートオブジェクトに反映されるデータが含まれています。ここで紹介する手法は、後述の他の例にも応用できます。

シナリオ

通販会社が、注文ごとに梱包時に販売記録のデータを含むアイテムを印刷する必要があります。販売アプリケーションはカンマ区切りのテキストファイルを生成し、インテグレーションサービスが監視しているディレクトリに保存します。ファイルが検出されると、インテグレーションサービスはトリガーファイルを削除し、ファイルの内容をBarTenderに送信してドキュメントのテンプレートオブジェクトにデータを反映し、ドキュメントを印刷します。

実装方法

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

データファイルの準備

1. データファイルを保存するネットワークフォルダを作成します。このフォルダをインテグレーションサービスが監視します。ここでは例として\\ShippingServer\NewOrdersとします。
2. カンマ区切りのデータを含むテキストファイルを作成します（下記参照）。コピー＆ペーストでデータをテキストファイルに貼り付けてください。

3. BusinessName,ContactName,Position,Address1,City,State,Zip,Country,Phone1,Phone2Around the Town,Jerome Davis,Buyer,1220 Governor Sq.,Atlanta,GA,31002,USA,(706) 555-7788,(706) 555-6750

2. テキストファイルを手順1で作成したディレクトリ（\\ShippingServer\NewOrders）に「order.txt」という名前で保存します。

BarTenderドキュメントの作成

1. BarTenderを開きます。
2. ファイルメニューから新規を選択し、新規ドキュメントウィザードを開きます。
3. 空白のテンプレートを選択し、完了をクリックして新規ドキュメントウィザードを閉じます。
4. ファイルメニューから印刷を選択し、印刷ダイアログを開きます。
5. 名前のドロップダウンリストから使用するプリンターを選択し、閉じるをクリックして印刷ダイアログを閉じます。
6. ファイルメニューからページ設定を選択し、ページ設定ダイアログで必要に応じてページを設定します。
7. 設定が完了したら、OKをクリックしてページ設定ダイアログを閉じます。
8. ファイルメニューからデータベース接続の設定を選択し、データベース設定ウィザードを開きます。
9. テキストファイルをクリックしてデータベースの種類を指定し、次へをクリックします。
10. ウィザードのファイルの選択ページで、ファイルの選択ボタンをクリックします。
11. \\ShippingServer\NewOrdersに移動し、order.txtをダブルクリックして選択します。
12. ウィザードのファイルの選択ページで次へをクリックします。
13. ウィザードのファイル形式ページで、フィールド区切りのドロップダウンリストがカンマになっていることを確認し、次へをクリックします。
14. ウィザードのフィールド名ページで、フィールド名を自動的に連番で割り当てるが選択されていることを確認し、完了をクリックします。
15. OKをクリックしてデータベース設定ダイアログを閉じます。
16. 作成メニューからテキストを選択します。
17. テキストオブジェクトのドロップダウンリストから1行を選択します。
18. テンプレート上の任意の場所をクリックしてテキストオブジェクトを追加します。
19. テキストオブジェクトを右クリックし、コンテキストメニューからプロパティを選択してテキストプロパティダイアログを開きます。
20. 左側のナビゲーションペインでテキストオブジェクトのデータソースをクリックします。
21. データソースタブで、種類フィールドの右側にあるをクリックしてデータソースの種類変更ウィザードを開きます。
22. ドロップダウンリストからデータベースフィールドを選択し、次へをクリックします。
23. フィールド名のドロップダウンからフィールド2を選択します（テキストファイルの2番目のフィールドが購入者名です）。
24. サンプルフィールドデータ欄に「buyer name」と入力します。
25. 完了をクリックしてウィザードを閉じます。
26. 閉じるをクリックしてテキストプロパティダイアログを閉じます。
27. テンプレートに他のデータベースフィールドも追加したい場合は、手順16に戻り、各テキストオブジェクトに適切なフィールドを割り当ててください。不要な場合は手順28に進みます。
28. ファイルメニューから保存を選択し、BarTenderドキュメントを「NewOrderAddress.btw」という名前で保存します。
29. サンプルデータベースファイル（order.txt）を、インテグレーションサービスが監視するフォルダから別のフォルダに移動します。
30. BarTenderを閉じます。

インテグレーションファイルの作成と展開

1. Integration Builderを開きます。
2. 新しいインテグレーションの作成をクリックして新しいインテグレーションダイアログを開きます。
3. ファイルをクリックし、OKをクリックします。
4. ファイルインテグレーションペインでインテグレーションを選択します。
5. プロパティペインで、インテグレーションの名前に「Each Order」と入力します。
6. インテグレーションの開始ドロップダウンリストから自動を選択します。
7. ユーザーアカウントでユーザー認証情報を指定します。詳細は空のファイルを使ってドキュメントを印刷するをご覧ください。
8. ファイルインテグレーションペインでファイル検出を選択します。
9. プロパティペインの検出オプションで、場所のドロップダウンリストから「コンピューター/ネットワーク」を選択します。
10. スキャンするフォルダーオプションで、インテグレーションサービスが監視するフォルダのパスを入力または参照します。ここでは、上記「データファイルの準備」で作成した\\ShippingServer\NewOrdersフォルダを指定します。
11. ファイルパターン欄に「*.txt」と入力します。（引用符は不要です）
12. 検出後のアクションセクションまでスクロールします。アクションのドロップダウンリストからファイルの削除を選択します。インテグレーションサービスがファイルを検出すると、自動的にファイル内のデータを読み取り変数に格納し、検出後はファイルが不要になるため削除されます。
13. ファイルインテグレーションペインでドキュメントの印刷をクリックします（これがデフォルトのアクションです）。
14. プロパティペインのドキュメントで、参照ボタンをクリックし、先ほど作成したBarTenderドキュメント（NewOrderAddress.btw）を選択して開くをクリックします。
15. データベースの上書きまでスクロールします。データソースのドロップダウンリストからインテグレーション入力データを選択します。
16. Integration Builderの左上にあるをクリックし、インテグレーションファイルを「NewOrderAddress.btin」として保存します。
17.  インテグレーションの展開をクリックして新しい展開ダイアログを開きます。
18. 展開の名前と説明を入力します。
19. インテグレーションファイルの設定がNewOrderAddress.btinになっていることを確認します。違う場合は参照をクリックし、NewOrderAddress.btinを選択します。
20. ターゲットサーバーで、インテグレーションファイルを展開したいサーバーを追加します。
21. スケジュールで直ちにを選択します。
22. 必要なエラー処理の設定を行います。
23. OKをクリックしてダイアログを閉じ、インテグレーションファイルを展開します。
24. 管理コンソールがインテグレーションノードで開き、作成したインテグレーションが表示されます。

シナリオの実行とインテグレーション処理の確認

1. 管理コンソールでインテグレーション名「Each Order」をクリックし、詳細ビューを開きます。
2. 次の手順でシナリオを実行すると、このビューの出力セクションでインテグレーションの処理状況を確認できます。
3. Windowsエクスプローラーを使って、order.txtファイルを\\ShippingServer\NewOrdersフォルダにコピーします。
4. インテグレーションがほぼ即座に開始され、NewOrdersフォルダからテキストファイルが削除され、BarTenderドキュメントが印刷されます。