WOSA/XFS PTR FORM—基础知识

目录

一、XFS PTR

二、XFS PTR FORM

三、Form、子Form、字段、框架、表单和媒介的定义

正文

一、XFS PTR

Class Name PTR

Class Identifier WFS_SERVICE_CLASS_PTR = 1

凭条打印机 Receipt Printer

日志打印机 Journal Printer

存折打印机 Passbook Printer

文档打印机 Document Printer

扫描仪打印机 Scanner Printer

XFS打印机服务定义并支持五种使用通用接口的银行打印机类型：

l 凭条打印机 凭条打印机用来打印文档并切纸。它不一定需要插入或弹出操作，但通常包括一个操作员确认的设备，例如，可用于共享操作的柜员机A和柜员机B的灯。

l 日志打印机 日志打印机是一个连续形式的设备，用来记录交易的硬拷贝帐务痕迹，同时具有一定的报告打印要求。

l 存折打印机 存折打印机从物理结构和功能上来说都是最复杂的打印机。XFS定义支持存折的自动放置，及读/写任意的综合磁条的性能。它还实现存折的几何管理，例如，页边距和插页，用最简单的应用程序接口提供最大范围的功能。 有些存折打印机还支持新存折的发放，存折的来源有四种（高的、aux、aux2、低的）。有些存折打印机还可以将整个存折放置在停放台，打印新存折并将两本存折都返还给客户。如果在打印位置或进/出口没有其他媒介工具，则存折只能从停放台上分发或移动。 l 文档打印机 文档打印类似凭条打印，在插入的单片或多片纸张上排布一系列的字段，但是应用在全尺寸形式。应当注意的是，XFS环境支持由应用程序传来的文本和图形字段打印。表单图形（表单的模板部分，通常采用点阵式打印机重新打印）的电子打印也可以通过应用程序来打印。

l 扫描仪打印机 扫描仪打印机是一种包含了扫描插入文档并将其随意打印这两种性能的设备。这些设备可以有一个以上的区域来保留文档。 附加的硬件部件，像扫描仪，磁条读卡器，OCR读卡器，及印戳，通常直接连接在打印机上，也是通过此接口控制。另外，打印机和扫描类接口同样可以用在能够扫描而不需要打印的设备上，比如扫描仪。

此说明书提到了条款用纸和媒介用纸。如果使用条款用纸，就表明这片纸张是装在设备附带的供纸器中的。而媒介用纸是用于客户插入的媒介的（比如扫描的支票和其他资料）或用于发放给客户的媒介的（比如一张凭条或结算单）。凭条打印机、文档打印机和带有存折发放能力的存折打印机可以打印这两种纸张。一旦纸张被打印了，它就成了媒介。扫描仪只具有媒介。条款媒介用纸不适用于日志打印机。当纸张放入打印位置时，它就被分类成媒介，有些打印机在打印头下面保留了纸张，那么就总是既有媒介也有纸张。

二、XFS PTR FORM

（一）Forms Model

XFS打印类型功能是基于“表单”模式的打印。银行文档作为一系列从应用程序输出的文本和/或图片字段提交，由XFS打印系统在文档中排布。 表单是包含各字段在文档中的排布和表达信息的对象。应用程序选择一个表单，仅需提供字段数据和控制参数就能完全定义打印文档。 表单对象隶属于XFS打印服务，并由其管理。为了最优化系统的可维护性，应用程序能查询打印指定表单所需的列表字段服务。通过此机制，无须再在应用程序原创数据中复制表单字段内容。下图从应用程序的角度概括了打印处理过程。

（二）PTR Info Commands

WFS_INF_PTR_FORM_LIST ——该命令用来获取设备上可用的的表单列表。

WFS_INF_PTR_MEDIA_LIST ——该命令用来获取设备上可用的媒介定义列表。

WFS_INF_PTR_QUERY_FORM ——该命令用来获取指定表单的详细说明。

WFS_INF_PTR_QUERY_MEDIA ——该命令用来获取指定媒介的详细说明。

WFS_INF_PTR_QUERY_FIELD ——该命令用来获取指定表单上单个或全部字段说明的详细信息。

（三）PTR Info Commands

WFS_INF_PTR_FORM_LIST ——该命令用来获取设备上可用的的表单列表。

WFS_INF_PTR_MEDIA_LIST ——该命令用来获取设备上可用的媒介定义列表。

WFS_INF_PTR_QUERY_FORM ——该命令用来获取指定表单的详细说明。

WFS_INF_PTR_QUERY_MEDIA ——该命令用来获取指定媒介的详细说明。

WFS_INF_PTR_QUERY_FIELD ——该命令用来获取指定表单上单个或全部字段说明的详细信息。

（四）PTR Execute Commands

WFS_CMD_PTR_PRINT_FORM ——该命令用来通过合并提供的在表单中指定的可变字段数据和表单中指定的字段数据来打印表单。如果没有媒介，设备将在WFSExecute命令dwTimeOut参数规定的时间段等待从外部纸张来源的纸张插入。

WFS_CMD_PTR_READ_FORM ——该命令用来从指定表单上的输入字段读取数据。这些输入字段可以由MICR、OCR、MSF、BARCODE、或 PAGEMARK输入字段组成。这些输入字段还可以由TEXT字段组成，在存折打印机支持该功能时用于检测存折打印机可打印行数。如果设备中没有媒介，则设备将在WFSExecute命令dwTimeOut参数规定的时间段等待插入媒介。

（五）PTR Events

WFS_EXEE_PTR_FIELDERROR ——该事件指示字段处理过程中发生了致命错误。

（WFS_CMD_PTR_PRINT_FORM、WFS_CMD_PTR_READ_FORM）

WFS_EXEE_PTR_FIELDWARNING ——本事件用于指出字段处理过程中出现非致命错误。

（WFS_CMD_PTR_PRINT_FORM、WFS_CMD_PTR_READ_FORM）

WFS_SRVE_PTR_DEFINITIONLOADED ——本事件用于指示，何时表单或媒介定义通过WFS_CMD_PTR_LOAD_DEFINITION命令被加载。

（六）PTR Errors，Info Commands

Info Commands 除了[Ref. 1]中规定的一般错误代码外的错误

1.WFS_INF_PTR_FORM_LIST（无）

2.WFS_INF_PTR_MEDIA_LIST（无）

3.WFS_INF_PTR_QUERY_FORM WFS_ERR_PTR_FORMNOTFOUND 无法找到指定的表单。 WFS_ERR_PTR_FORMINVALID 指定的表单无效。

4.WFS_INF_PTR_QUERY_MEDIA WFS_ERR_PTR_MEDIANOTFOUND 无法找到指定的媒介定义。 WFS_ERR_PTR_MEDIAINVALID 指定的媒介定义无效。

5.WFS_INF_PTR_QUERY_FIELD WFS_ERR_PTR_FORMNOTFOUND 无法找到指定的表单。WFS_ERR_PTR_FIELDNOTFOUND 无法找到指定的字段。WFS_ERR_PTR_FORMINVALID 指定的表单无效。 WFS_ERR_PTR_FIELDINVALID 指定的字段无效。

（七）PTR Errors,Execute Commands

Execute Commands 除了[Ref. 1]中规定的一般错误代码外的错误

相关指令：

WFS_CMD_PTR_PRINT_FORM

WFS_CMD_PTR_READ_FORM

错误：

WFS_ERR_PTR_FORMNOTFOUND --无法找到指定的表单定义。

WFS_ERR_PTR_MEDIAOVERFLOW --表单超出了媒介边界。

WFS_ERR_PTR_FIELDSPECFAILURE --lpszFields的语法无效。

WFS_ERR_PTR_FIELDERROR --处理某个字段时出现错误，导致打印请求的终止。 执行事件WFS_EXEE_PTR_FIELDERROR的详细信息被公布出来。

WFS_ERR_PTR_MEDIANOTFOUND --无法找到指定的媒介定义。

WFS_ERR_PTR_MEDIAINVALID --指定媒介的定义无效。

WFS_ERR_PTR_FORMINVALID --指定表单的定义无效。

WFS_ERR_PTR_MEDIASKEWED --媒介歪斜超出了表单定义的界限。

三、Form、子Form、字段、框架、表单和媒介的定义

（一）定义语法

（二）Form和媒介测量

（三）Form定义

（四）子Form定义

（五）字段定义

（六）框架定义

（七）媒介定义