概要

この例の目的は、アクション内にBTXMLスクリプトを含むネットワークソケット統合を作成することです。BarTender XML Script（BTXMLスクリプト）は、BarTenderの自動化を簡単に行うことができ、サードパーティのプログラマーが自分のアプリケーションにBarTenderを簡単に統合できる方法を提供します。

BTXMLスクリプトの実行後、XMLレスポンスが作成されます。このXMLレスポンスには、印刷ジョブに関する有用な情報（使用されたプリンター、印刷時のBarTenderの設定、印刷されたラベルの詳細など）が含まれています。

シナリオ

ある会社が、100個の連番アイテムを含む印刷ジョブをHP LaserJetプリンターのトレイ1に送信する必要があります。この印刷ジョブは、データ（この場合はBTXMLスクリプト）がネットワークソケット経由で送信され、BarTender Integration Serviceによって読み取られると実行されます。

実装手順

以下の手順では、上記のシナリオに対する統合の設定、展開、検証方法について説明します。

BarTenderドキュメントの作成

1. BarTenderを開きます。
2. ファイルメニューから新規を選択し、新規ドキュメントウィザードを開きます。
3. 空白のテンプレートを選択し、完了をクリックして新規ドキュメントウィザードを閉じます。BarTenderに新しいドキュメントが表示されます。
4. ファイルメニューから印刷を選択し、印刷ダイアログを開きます。
5. 名前のドロップダウンリストから使用するプリンターを選択します。ここで選択したプリンター名をBTXMLスクリプトでも同じにしてください。
6. 閉じるをクリックして印刷ダイアログを閉じます。
7. ファイルメニューからページ設定を選択し、ページ設定ダイアログで必要に応じてページを設定します。
8. ページ設定が完了したら、OKをクリックしてページ設定ダイアログを閉じます。
9. 作成メニューからテンプレートオブジェクトを選択し、BarTenderドキュメントを希望通りに設定します。
10. ファイルメニューから名前を付けて保存を選択し、BarTenderドキュメントをScriptdoc.btwという名前で保存します。
11. BarTenderを閉じます。

BTXMLスクリプトトリガードキュメントの作成

<?xml version="1.0" encoding="utf-8"?>		
<XMLScript Version="2.0">
	<Command Name="Job1">
		<Print>
			<Format>c:\BarTender\Scriptdoc.btw</Format>
			<PrintSetup>
			        <NumberSerializedLabels>100</NumberSerializedLabels>
				<Printer>HP LaserJet</Printer>
				<PaperTray>Tray 1</PaperTray>
			</PrintSetup>
		</Print>
	</Command>
</XMLScript>

<?xml version="1.0" encoding="utf-8"?> 

BTXMLスクリプトをテキストファイルに貼り付け、BTXMLScript.txtという名前で保存します。

統合ファイルの作成：ネットワークソケット統合の選択

1. Integration Builderを開きます。
2. 新しい統合の作成をクリックして、新しい統合ダイアログを開きます。
3. ネットワークソケットをクリックし、OKをクリックします。
4. ネットワークソケット統合ペインで、統合を選択します。
5. プロパティペインで、統合の名前に「Print 100」と入力します。
6. 統合の開始ドロップダウンリストから自動を選択します。
7. ユーザーアカウントでユーザー認証情報を指定します。詳細は空のファイルを使ってドキュメントを印刷するをご覧ください。
8. ネットワークソケット統合ペインで、ソケットを選択します。
9. プロパティペインで、プロトコルとポート情報を設定します。
10. ネットワークアドレスで、すべてのネットワークインターフェースでリッスンを選択します。もしくは、特定のIPアドレスでリッスンを選択し、ドロップダウンリストからIPアドレスを選択するか、手動で入力します。
11. 通信設定や接続プロトコルを必要に応じて設定します。
12. ネットワークソケット統合ペインで、入力データを選択します。
13. プロパティペインで、エンコーディングプロパティにUnicode (UTF-8)を選択します。
14. 読み取り停止条件で、文字列の受信時を選択します。
15. 文字列フィールドに</XMLScript>と入力します。
16. シーケンスを入力データ内容に含めるを有効にします。
17. 入力データ形式でBTXMLスクリプトを選択します。
18. ネットワークソケット統合ペインで、レスポンスを選択します。
19. プロパティペインで、レスポンスオプションを選択します。

統合ファイルの作成：ネットワークソケット統合にアクションを追加

1. ネットワークソケット統合ペインで、アクションを選択します。
2. プロパティペインで、アクションの実行に順次を選択します。
3. アクションの繰り返しに「1」と指定します。
4. ネットワークソケット統合ペインのアクションの下で、Print Documentの右側にあるをクリックしてデフォルトのアクションを削除します。
5. アクションを選択し、追加をクリックして新しいアクションダイアログを開きます。
6. 左側のナビゲーションペインのアクションタイプ一覧から印刷を選択し、BTXMLスクリプトを印刷を選択します。
7. OKをクリックして新しいアクションダイアログを閉じます。
8. BTXMLスクリプトを印刷アクションがネットワークソケット統合ペインのアクションの下に表示されます。
9. まだ選択されていない場合は、ネットワークソケット統合ペインでBTXMLスクリプトを印刷をクリックします。
10. プロパティペインのアクションの下で、BTXMLスクリプトを印刷アクションの名前と説明を入力します。
11. スクリプトの下で、スクリプトソースドロップダウンリストから変数を選択します。
12. まだ選択されていない場合は、変数ドロップダウンリストからEventDataを選択します。
13. Integration Builderの左上にあるをクリックして、統合ファイルをBTXML_Integration.btinとして保存します。

BTXMLスクリプト印刷アクションのテスト（統合全体ではなく）

「BTXMLスクリプトを印刷」アクションをテストするには、テスト用にいくつかの設定を変更し、テスト後に元に戻す必要があります。

1. ネットワークソケット統合ペインのアクションで、BTXMLスクリプトを印刷を選択します。
2. プロパティペインのスクリプトで、スクリプトソースドロップダウンリストから埋め込みスクリプトを選択します。
3. インポートボタンをクリックしてBTXMLファイルをインポートするか、ファイルの内容をウィンドウに貼り付けます。
4. スクリプトウィンドウ右側のテストボタンをクリックします。
5. 「BTXMLスクリプトを印刷」アクションがテストに合格した場合は、ネットワークソケット統合ペインのアクションで再度BTXMLスクリプトを印刷を選択します。
6. プロパティペインで、スクリプトタイプを変数に戻し、変数タイプを%EventData%に戻します。

統合ファイルのテストと展開

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

シナリオの実行と統合処理の確認

1. BarTender Integration Serviceが選択したネットワークソケットを監視しています。お好みの方法でBTXMLScript.txtの内容をネットワークソケット経由で送信します。
2. Integration ServiceがBTXMLスクリプトをBarTenderに渡します。
3. BarTenderはBTXMLスクリプトで指定されたアクションを実行し、指定したプリンターのトレイ1を使ってScriptdoc.btwを100部印刷します。