概要

この例では、画像ファイルをトリガーファイルとして使用し、さらに印刷時に同じ画像ファイルをラベル内で使用する統合を作成します。印刷したい画像がトリガーファイル内で同じ名前を使っていれば、印刷時に印刷したい画像を動的に変更することができます。

サンプルファイル

• ImageLabel.btw
• Picture.png
• ImageFileIntegration.btin

実装手順

C:\ドライブに「Test」というフォルダーを作成してください。このフォルダーを、ファイルの保存場所および統合のスキャンフォルダーとして使用します。すべてのサンプルファイルをこのTestフォルダーに入れてください。

BarTenderドキュメントの作成

上記のImageLabel.btwファイルを使うか、以下の手順でBarTenderドキュメントを作成してください：

1. BarTender Designerを開きます。
2. 新しいBarTenderドキュメントを作成します。
3. 画像選択オプション を選択し、外部画像ファイルの下でファイル名を指定...を選びます。
4. Testフォルダーに移動し、Picture.pngファイルをクリックして選択を押します。
5. BarTenderドキュメントを保存し、ImageLabel.btwという名前を付けます。

統合の作成

上記のImageFileIntegration.btinファイルを使うか、以下の手順で新しい統合を作成してください：

1. Integration Builderを開きます。
2. 利用可能な統合オプションからファイルを選択します
   
3. ファイル検出オプションで、ファイルパターンを*.pngに変更します。
4. 同じウィンドウで、検出後のアクションをなしに設定します。理由は後ほど説明します。
5. ドキュメント印刷アクションまでスクロールし、ドキュメントでImageLabel.btwを選択して印刷するラベルに指定します。
6. アクションツリーの横にある青いプラスボタンを使ってアクションを追加します。ここではファイル削除アクションを選択します：
   
7. ファイルオプションで、削除するファイルとしてPicture.png画像を選択します。このアクションには2つの目的があります：
   • ドキュメント印刷アクションで画像を使用できるようにし、印刷時にラベルが参照する画像を確保します。
   • 検出後のアクションを「なし」に設定したことで、統合が無限ループに陥るのを防ぎます。
8. 統合を保存します。

統合のテスト

1. ホームメニューで統合のテストオプションをクリックします。
   
2. テストウィンドウ右上の開始ボタンをクリックします。これで統合が開始されます。
3. 出力メッセージを確認します。BarTenderがドキュメントを印刷し、その後画像を削除する様子が分かります。
4. 別のPicture.pngをTestフォルダーに追加して再度テストしてみてください（どんな画像でも、ファイル名と拡張子がPicture.pngであれば使用できます）
   

統合のデプロイ

1. Integration Builderのツールバーから、 統合のデプロイをクリックして、新しいデプロイダイアログを開きます。
2. 新しいデプロイダイアログで、デプロイ名と説明を入力します。
3. 統合ファイルの設定で、IntegrationFile.btin（または保存した統合ファイル名）が表示されていることを確認します。
4. ターゲットサーバーで、統合ファイルをデプロイしたいサーバーを追加します。
5. 必要なエラー処理の設定を指定します。
6. OKをクリックしてダイアログを閉じ、統合ファイルをデプロイします。
7. 管理コンソールが統合ノードで開き、統合が表示されます。