SmaPriパッケージの概要

１ 本機能の構成

SmaPriパッケージでは、SmaPri Libraryが対応するサトー製プリンタと連携しラベルの印刷を行う機能を提供します。

Biz/Browser SmartDeviceとプリンタはBluetoothもしくはTCPで接続します。

ラベル印刷の発行には、「SmaPri Designer」で作成したフォーマットファイル(*.spfmtz)を利用します。Biz/Browser SmartDeviceは、フォーマットファイルから読み込んだフォーマット情報と発行データから印刷コマンドを作成し、プリンタに発行を指示します。

※SATO、SmaPriは、サトーホールディングス株式会社の登録商標または商標です。

２ CRSによる印刷までの手順

プリンタとの接続から印刷指示を行うまでのCRSコードの一例を記載します。

まずコード全体を下記に記載します。個別の説明は後述します。

Form Form1 {
	X = 0;
	Y = 0;
	Width = 600;
	Height = 400;
	SmaPri sm;
	SmaPriPrinter sp;
	Button btnSetPrinter {
		X = 10;
		Y = 10;
		Width = 50;
		Height = 20;
		Title = "SetPrinter";
		Function OnTouch(e) {
			^.sp.SetPrinter(SmaPriPrinter.DeviceTypeTcp, "192.168.1.15", SmaPriPrinter.ProtocolStatus4, false);
		}
	}
	Button btnConnect {
		X = 70;
		Y = 10;
		Width = 50;
		Height = 20;
		Title = "Connect to Printer";
		Function OnTouch(e) {
			^.sp.Connect();
		}
	}
	Button btnRegisterFormat {
		X = 10;
		Y = 40;
		Width = 50;
		Height = 20;
		Title = "Register format";
		Function OnTouch(e) {
			^.sm.RegisterFormat("http://192.168.1.15/format/sample.spfmtz");
		}
	}
	Button btnPrintFormat {
		X = 10;
		Y = 40;
		Width = 50;
		Height = 20;
		Title = "Print format";
		Function OnTouch(e) {
			var item = new SmaPriInputItem[2];
			item[0].FormatId = 1;
			item[0].PrintNum = 1;
			item[0].SetData("文字列1", "ABCD");
			item[0].SetData("バーコード1", "hello world!");
			item[1].FormatId = 2;
			item[1].PrintNum = 1;
			item[1].SetData("固定グラフィック", "http://192.168.1.15/image/sample.bmp");
			item[1].SetData("切替グラフィック", "1");
			var extended = new Array();
			extended["print_operation"] = "1,3,3";
			extended["print_offset"] = "50,50";
			^.sm.PrintFormat(item, extended);
		}
	}
	// {
		Function OnSmaPriPrinterConnectionChanged(e) {
			//.MessageBox("プリンタ接続状態変更:" + str(e.State) + " :" + e.Message);
		}
		Function OnSmaPriPrintFailed(e) {
			//.MessageBox("プリント失敗(" + e.JobName + "):" + e.Message);
		}
		Function OnSmaPriPrintFinished(e) {
			//.MessageBox("プリント完了(" + e.JobName + ")");
		}
	}
}

まず、SmaPriPrinter.SetPrinterメソッドでプリンタを指定し、SmaPriPrinter.Connectメソッドで接続します。SmaPriPrinter.SetPrinterメソッドの第三引数のプリンタ機種は、プリンタと一致させる必要があります。 SmaPriPrinter.SetPrinterメソッドで指定したプリンタ情報は保存され、次回のBiz/Browser起動時にも適用されます。IPアドレスとBluetoothアドレスは別々に保存されます。

	Button btnSetPrinter {
		X = 10;
		Y = 10;
		Width = 50;
		Height = 20;
		Title = "SetPrinter";
		Function OnTouch(e) {
			^.sp.SetPrinter(SmaPriPrinter.DeviceTypeTcp, "192.168.1.15", SmaPriPrinter.ProtocolStatus4, false);
		}
	}
	Button btnConnect {
		X = 700;
		Y = 10;
		Width = 50;
		Height = 20;
		Title = "Connect to Printer";
		Function OnTouch(e) {
			^.sp.Connect();
		}
	}

フォーマットファイルはSmaPri.RegisterFormatメソッドで読み込み、Android端末内に保存します。フォーマットファイルはWebサーバー上、もしくは端末内のファイルをURLで指定するか、バイナリデータをBase64形式にエンコードした文字列で指定します。

	Button btnRegisterFormat {
		X = 10;
		Y = 40;
		Width = 50;
		Height = 20;
		Title = "Register format";
		Function OnTouch(e) {
			^.sm.RegisterFormat("http://192.168.1.15/format/sample.spfmtz");
		}
	}

発行データはSmaPriInputItemクラスの配列として作成します。作成した発行データはSmaPri.PrintFormatメソッドに渡して印刷を実行します。印刷は発行データの配列のインデックス順で実行されます。

	Button btnPrintFormat {
		X = 10;
		Y = 40;
		Width = 50;
		Height = 20;
		Title = "Print format";
		Function OnTouch(e) {
			var item = new SmaPriInputItem[2];
			item[0].FormatId = 1;
			item[0].PrintNum = 1;
			item[0].SetData("文字列1", "ABCD");
			item[0].SetData("バーコード1", "hello world!");
			item[1].FormatId = 2;
			item[1].PrintNum = 1;
			item[1].SetData("固定グラフィック", "http://192.168.1.15/image/sample.bmp");
			item[1].SetData("切替グラフィック", "1");
			var extended = new Array();
			extended["print_operation"] = "1,3,3";
			extended["print_offset"] = "50,50";
			^.sm.PrintFormat(item, extended);
		}
	}

３ メニュー

Biz/Browser SmartDeviceのメニューから、SmaPri機能の設定を行うことができます。

※プラットフォームによっては利用できない機能があります。

Android版

iOS版

「プリンタ接続状態」によりプリンタに接続する操作はSmaPriPrinter.Connectメソッドを呼び出すことと同じで、CRSでも接続した状態になります。

プリンタのアドレスは、SmaPriPrinter.SetPrinterメソッドや、プリンタ設定画面で設定したプリンタのアドレスが表示されます。Bluetoothのデバイスを設定した場合はBluetoothアドレスが、ネットワーク上のプリンタを設定した場合はプリンタのIPアドレスが表示されます。

４ プリンタ設定画面

プリンタ設定画面では、SmaPriのプリンタに関する詳細設定を行うことができます。

※iOS版は設定画面ではなくメニューで設定を行います。

※プラットフォームによっては利用できない機能があります。

Android版

iOS版