tellinmml营业系统接口规范(doc28)-经营管理(编辑修改稿)

tellinmml营业系统接口规范(doc28)-经营管理(编辑修改稿)内容摘要：

的命令中，不允许使用下划线开始的标识符。 数据类型 1. D39。 十进制整数 十进制数由一组字符组成，它包括一个、几个数字以及可选的正负数指示，而且在前面要有专门的字符组 D39。 （ D单引号）。 单独的 D39。 表示 null值。 数字字母字母 十进制整数的数值必须在 MININT和 MAXINT之间 ，对于 32位系统，分别是 – 2147483648和 2147483647。 十进制整数在业务数据中主要用于表示金额、折扣率等数据。 例如： ACCOUNT=D39。 12020 DISCOUNT=D39。 72 CHARGE=D39。 2. N39。 数字字符串 数字字符串用于表达一些十进制数无法表达的，但其本身又是由数字组成的信息。 在智能网业务中，大量的用到数字字符串，如卡号、密码等，都是数字字符串。 单独的 N39。 表示 null值。 例如： CARDNO=N39。 89860012345678 PINNUMBER=N39。 1234 3. 字符串 字符串（或正文串）允许输入文字正文。 正文串由一串字符组成，字符个数可以是 0个或多个，并用 （双引号）把它在首尾两端括起来。 字符串类型不支持 null值，如果在数据库检索出来的值为 null，则在 TELLIN MML中将表示为。 正文串中不能包含下列字符： 回车（ \r） N39。 数字D 39。 数字+ 换行（ \n） 如果出现下列字符，必须使用转义序列代替： 用转义序列 \ \ 用转义序列 \\ 例如： DESC=The big big bang! ADDRESS=西直门外大街 SENTENCE=Tom said\There is no double quotation marks!\ 等效于 Tom saidthere is no double quotation marks! SENTENCE=We use \\\ instead of \ 等效于 We use \ instead of DESC= MML命令格式规范 MML命令组成 一个 MML命令从命令码开始。 命令码规定了系统应该执行的功能。 如果要求进一步的信息，那么在命令码后跟参数部分，并用冒号（ :）把命令码和参数部分分隔开。 命令码在一个服务内唯一确定一个 MML功能，参数块则是该 MML功能执行时所需的参数。 命令码 :命令码参数块。 \字符 ( 不包括 \ 、 ) \\ 命令码最多由三个标识符组成，它们之间用一般分隔符分隔开。 命令码意义： 标识符 1：长度最大为 3的标识符，表示执行动作，如 ADD, DSP, MOD, CRE等。 标识符 2：长度最大为 8的标识符，表示执行动作的对象实体，如： CARD， USER等。 标识符 3：长度最大为 8的标识符，表示执行动作要操作的对象实体属性，如： PSWD， ACNT、ABBRV等。 命令码不区分大小写，习惯 上写成大写。 命令名称规范定义命令名称的构成、缩写方法、主要操作动词与缩写（如 LST、 ADD、 MOD、RMV）。 规范如下： （ 1）命令字最多由三个标识符合成，建议采用两个标识符，以空格连接； （ 2）标识符 1为动作字，长度严格为三个字母； （ 3）标识符 2（ 3）是命令动作操作的具体对象及其属性（操作的目标以及目标的属性），由 38个字符（允许含有数字）组成 (只要表示清楚 ,字符数越少越好 )； （ 4） MML操作系统的系统命令的组成允许少于两个标识符，如 LGI（登录）； （ 5）其他命令按照 命令动作字 功能块与对象的复合词组织。 （ 6） LST与 DSP命令， DSP命令专用于显示动态查询结果，静态数据查询一律用 LST； （ 7）主要操作动词与缩写 动作 匹配反动作 说明 ADD RMV 增加 / 删除 CRE DEL 创建 / 删除 MOD 修改 ACT DEA 激活 / 去激活 INH UIN 禁止 / 解除禁止 CHK 检查 DSP 查询（动态） LST 查询（静态） SET 设置 标识符 标识符 标识符sp sp2 31 QRY 查询 BKP RES 备份转储 / 恢复 STP STR 停止 / 启动 LGI LGO 登录 / 退出 RST 复位 RED WRT 读取 / 存取 UPL UNL 加载 / 卸载 TOTAL： 38 （ 1）修改卡号密码： MOD CARD PSWD （ 2）增加用户： ADD USER （ 3）登录： LGI （ 4）删除 FPH限制号码： DEL FPH SCREEN 参数块 参数块为执行命令码中指定的功能所必须的信息。 参数块中的信息根据具体的命令由特定的一些参数来表示。 如果参数块包含两个或多个参数，用逗号把它们分隔开。 所 有参数都是按名字定义的。 可以用叹号 ( ! ) 来分隔同一 MML命令的多组参数块。 目前只在 ACK返回命令中使用叹号来分隔多个结果记录。 定义 按参数名定义的参数包括一个参数值，参数值之前有一个参数名，要用一个等号（ =）把它用 参 数 名 定 义 的 参 数, 们分隔开来。 （ 1）参数名 参数名用最多 16个字符的标识符表示，参数名不区分大小写。 参数名称规范定义参数的缩写方法、参数命名需遵循的原则： （ a）参数名称是合法的标识符，采用有意义的缩写表示，参数名称由 216个字符组成 (只要表示清楚 ,字符数越少越好 )； （ b）在定义一个新 的参数的缩写时，应该参考相应的行业使用惯例（如密码为 PIN）； （ c）在任何命令中，相同含义的参数使用相同的参数名称，具有相同的数据类型（如密码都使用 PIN表示，数据类型为数字字符串 )； （ 2）参数值 参数值由三种类型组成，包括十进制整数、数字字符串、字符串。 MML命令格式表示法 （ 1）在 TELLIN MML各个技术文档中，表示 MML命令一般方法如下例所示： MOD PIN:CARDNO, PIN。 这种表示方法是将命令码、参数名都表示出来，同时表示出该 MML命令没有返回数据。 没有返回参数说明的 MML命令只能有 SUC、 ERR返回，而不能由 ACK返回。 （ 2）如果 MML命令支持多组参数，则表示方法如下例： MOD PIN:CARDNO, PIN!。 即以叹号（ !）来表示该命令支持多组参数并列。 目前在对营业厅接口中还不支持多组参数的情况。 参数名 参数值=十进制整数数字字符串字符串 （ 3）如果命令存在返回数据，则表示方法如下例： QRY ABBRV:CARDNO, ABBRVNOC RETURN PSTNNUMBER。 即用 RETURN来引导返回数据说明，返回数据说明同参数说明格式。 有返回数据说明的MML命令可以分别有 ACK、 ERR返回，而不能有 SUC返回。 （ 4）如果返回数据支持多行记录，则表示方法如下例： QRY ABBRV:CARDNO RETURN PSTNNUMBER!。 即以叹号（ !）来表示该命令支持多行返回值。 MML命令范例 （ 1）修改密码： MOD PIN:CARDNO=N39。 89860012345, PINNUMBER=N39。 1234。 （ 2）修改缩位拨号： MOD ABBRV:CARDNO=N39。 89860012345678, ABBRNOC=D39。 1, PSTNNUMBER=N39。 07556812714。 （ 3）增加用户： ADD USER:USERNAME=张三 ,ADDRESS=西直门外大街 12号 , PHONE=N39。 01087353345, IDNUMBER=N39。 310602720808123,ZIPCODE=N39。 102435。 MML返回命令规范 MML返回命令概述 MML返回命令用于对 MML命令的返回。 在 SMPAgent和营业系统之间的 MML命令中，除了少数 NOTIFY命令和注销 LGO命令之外，都是要求有返回。 所有的返回命令都要遵循 MML返回命令规范。 TELLIN MML返回命令有三种： （ 1）操作成功，无返回数据 —— SUC命令 （ 2）操作失败，返回错误 ——— ERR命令 （ 3）操作成功，有返回数据 —— ACK命令 以下分别对三种返回命令进行说明。 SUC命令 图 12 成功返回 SUC命令返回只用于操作性质的 MML命令返回，表示操作命令成功执行，并且无返回结果。 SUC命令无参数。 ERR命令 1. ERR命令格式 ERR命令只用于操作命令的返回，表示 MML命令执行过程中出现错误。 ERR命令格式如下： 图 13 出错返回 参数块格式如下： 图 14 参数块 SUC命令是通用的命令，用于服务器执行 MML操作过程中出现错误时向终端发送，表示操作出现错误，同时向终端返回错误信息。 2. 参数 1—— 错误 ID 错误 ID的格式是： ,错误 ID 错误字符串E RR :。 参数块SUC。 错误编号由于可能分别来自 SMPAgent、 SMP、 SCP以及 DBMS，编号本身并不能保证不重复。 作为营业系统，不应针对特定的错误编号编写出错处理程序。 3. 参数 2—— 错误字符串 错误字符串包含了对出错情况的说明。 由于错误的输出可以是 SMPAgent、 SMP、 SCP以及DBMS，错误字符串可能会出现不同的语言、格式等。 错误字符串的最大长度为： 20K。 4. ERR返回 命令示例 以下的例子为分别为 SQL错误返回和接口命令参数错误返回： ERR:ERRID=D39。 268,ERRTEXT=SQLERROR:Unique constraint ix_1034 violated.； ERR:ERRID=D39。 12,ERRTEXT=AgentERROR:密码值类型不合法，应该为数字字符串 ； ACK命令 1. ACK命令格式 ACK返回命令格式为： ACK返回命令由命令码 ACK和结果集组成，中间用冒号（ :）分隔。 如果返回信息中结果集为空（意味着查询命令没有得到符合查询条件 的结果），则冒号和结。