ea_apis.kb 的例行程序


EAAddProblemHistory

文件名

ea_apis.kb

语法

EAAddProblemHistory(VAL problemID:STRING, VAL peopleID:INTEGER, VAL contactID:STRING, VAL EMAUserID:STRING, VAL histDescr:STRING, VAL confirmUser:BOOLEAN, REF userMessage:STRING, REF EAstatus:INTEGER, VAL sendNotification:BOOLEAN);

参数

problemID(I) - 问题标识号

peopleID(I) - 唯一人员标识符

EMAUserID(I) - TMG 服务器 TPM 用户标识(已注册)

histDescr(I) - 插入历史记录中的文本

confirmUser(I) - 控制是否检查标识的标志

userMessage(O) - 所产生的发送给用户的文本

EAstatus (O) - 状态整数

sendNotification(I) - 向 TPM 用户发送通知的标志

返回

1 = 成功

ERR_NONFATAL

ERR_FATAL

CLI_ERR_xxx

副作用

说明

此例行程序将问题历史记录添加到 TPM 数据库中的指定问题标识中。

调用的对话框窗体


EACreateInquiryRecord

文件名

ea_apis.kb

语法

EACreateInquiryRecord( VAL organizationID:STRING, VAL peopleID:INTEGER, VAL locationID:STRING, VAL contactID:STRING, VAL contactName:STRING, VAL phonenumber:STRING, VAL callCode:STRING, VAL severityCode:INTEGER, VAL system:STRING, VAL userID:STRING,

参数

description - 用户提供的问题说明

organizationID - TPM 中的最终用户组织标识

peopleID - TPM 中的最终用户人员标识

locationID - TPM 中的最终用户场所标识

contactID - TPM 中的最终用户联系人标识

contactName - TPM 中的最终用户联系人姓名

phonenumber - TPM 中的最终用户联系人电话

callcode - 此问题的呼叫代码

severityCode - 此呼叫的数字严重性代码

system - TPM 中的系统标识(在 SCIM 中)

userID - TPM 用户标识

EAstatus - TPM 状态代码

返回

1 = 成功

ERR_NONFATAL - 所发生的非致命执行错误

ERR_FATAL - 所发生的致命执行错误

副作用

说明

STRING, REF EAstatus:INTEGER); 此例行程序创建 TPM 数据库中的“查询”呼叫记录。

调用的对话框窗体


EACreateProblem

文件名

ea_apis.kb

语法

EACreateProblem( VAL organizationID:STRING, VAL peopleID:INTEGER, VAL locationID:STRING, VAL contactID:STRING, VAL contactName:STRING, VAL contactPhone:STRING, VAL callCode:STRING, VAL severityCode:INTEGER, VAL system:STRING, VAL assignee:STRING,

参数

organizationID - TPM 中的最终用户组织标识

peopleID - TPM 中的最终用户人员标识

locationID - TPM 中的最终用户场所标识

contactID - TPM 中的最终用户联系人标识

contactName - TPM 中的最终用户联系人姓名

phonenumber - TPM 中的最终用户联系人电话

callcode - 此问题的呼叫代码

severityCode - 此呼叫的数字严重性代码

system - TPM 中的系统标识(在 SCIM 中)

assignee - 要向其分配此问题的 TPM 用户

description - 用户提供的问题说明

problemID - 返回的 TPM 问题标识代码

userMessage - 对创建者的响应

EAstatus - TPM 状态代码

返回

1 = 成功

ERR_NONFATAL = 失败

副作用

说明

STRING, REF problemID:STRING, REF userMessage:STRING, REF EAstatus:INTEGER); 此例行程序在 TPM 数据库中创建问题(与呼叫和会话)记录。

调用的对话框窗体


EAGetLists

文件名

ea_apis.kb

语法

EAGetLists( REF severityList:LIST OF STRING, REF callcodeList:LIST OF STRING, REF systemList:LIST OF STRING,

参数

severityList - TPM 严重性值列表

callcodeList - TPM 呼叫代码值列表

systemList - TPM 系统列表

返回

1 = 成功

副作用

说明

此例行程序装入或刷新“TPM 缺省值”对话框所用的列表。

调用的对话框窗体


EAGetProblemStatus

文件名

ea_apis.kb

语法

EAGetProblemStatus( VAL problemID:STRING, VAL peopleID:INTEGER, VAL confirmUser:BOOLEAN, VAL withHistory:BOOLEAN, REF userMessage:STRING, REF problemCount:INTEGER, REF EAstatus:INTEGER );

参数

problemID(I) - 问题标识号

peopleID(I) - 唯一人员标识符

confirmUser(I) - 控制是否检查标识的标志

withHistory(I) - 控制简要输出或完整输出的标志

userMessage(O) - 所产生的发送给用户的文本

EAstatus (O) - 状态整数

返回

1 = 成功

ERR_NONFATAL

ERR_FATAL

CLI_ERR_xxx

副作用

说明

此例行程序从数据库获取简要问题状态。如果请求是“完整状态”,则该例行程序获取一个问题历史记录列表数据库并将其格式化入响应缓冲区。如果未提供标识,则此例行程序给出此用户提交的所有问题的“简要状态”。

调用的对话框窗体


EALogin

文件名

ea_apis.kb

语法

EALogin(VAL cmdLind:LIST OF STRING, REF userName:STRING);

参数

返回

1 = 成功

0 = 失败

副作用

说明

此例行程序执行 TPM 注册与一些其他 TPM 初始化。

调用的对话框窗体


EASelectAUser

文件名

ea_apis.kb

语法

EASelectAUser(VAL parentWindow: Window, REF userData: EMAUserDataRec);

参数

parentWindow - 弹出对话框的父级

userData - 所选联系人(如有的话)

返回

1 = 成功

0 = 失败

副作用

说明

此例行程序向最终用户(有对话框)查询 TPM 数据库中某一 TPM 用户(问讯台人员)的标识符。

调用的对话框窗体


EAUpdateContactRow

文件名

ea_apis.kb

语法

EAUpdateContactRow(REF newRow: BindListRowRec, VAL oldRow: BindListRowRec);

参数

newRow - 具有修改过的电子邮件字段的行

oldRow - 要替换的新行的引用行

返回

1 = 成功

2 = 新行的电子邮件标识已经使用

-n = 任何 SQLUpdate 错误代码

副作用

说明

此例行程序更新 TPM 数据库中某一联系人记录的电子邮件字段。

调用的对话框窗体


EAUpdateSolution

文件名

ea_apis.kb

语法

EAUpdateSolution( VAL solutionID:INTEGER,

参数

description - 用户的原始问题说明(必须不能是空的或 $Unknown)

solutionID - 所使用的解决方案标识(必须不能是空的或 $Unknown)

userMessage - 接收文本错误消息的缓冲区

EAstatus - 整数数据库返回码

返回

1 = 成功

ERR_NONFATAL - 所发生的非致命执行错误

ERR_FATAL - 所发生的致命执行错误

副作用

说明

STRING, REF userMessage:STRING, REF EAstatus:INTEGER); 此例行程序使用“自适应学习软件”更新解决方案引用计数。

调用的对话框窗体


EAValidCallCode

文件名

ea_apis.kb

语法

EAValidCallCode( VAL call_code:STRING);

参数

call_code - 要验证的 TPM 表中的项

返回

TRUE 或 FALSE

副作用

说明

此例行程序返回布尔值,指示是否在 TPM 数据库中找到了该项。

调用的对话框窗体


EAValidEAUser

文件名

ea_apis.kb

语法

EAValidEAUser( VAL user_ID:STRING);

参数

user_ID - 要验证的 TPM 表中的项

返回

TRUE 或 FALSE

副作用

说明

此例行程序返回布尔值,指示是否在 TPM 数据库中找到了该项。

调用的对话框窗体


EAValidSeverityCode

文件名

ea_apis.kb

语法

EAValidSeverityCode( VAL severity_code:STRING);

参数

severity_code - 要验证的 TPM 表中的项

返回

TRUE 或 FALSE

副作用

说明

此例行程序返回布尔值,指示是否在 TPM 数据库中找到了该项。

调用的对话框窗体


EAValidSystem

文件名

ea_apis.kb

语法

EAValidSystem( VAL system_ID:STRING);

参数

system_ID - 要验证的 TPM 表中的项

返回

TRUE 或 FALSE

副作用

说明

此例行程序返回布尔值,指示是否在 TPM 数据库中找到了该项。

调用的对话框窗体


SAIApplicationIsInstalled

文件名

ea_apis.kb

语法

SAIApplicationIsInstalled(VAL app_ID:INTEGER);

参数

app_ID - 应用程序的整数标识

返回

TRUE 或 FALSE

副作用

说明

此例行程序执行 BitAnd 确定是否已在 m_SAIApplicationMask 中设置了 app_ID 的位,以指示是否已经安装指定的应用程序。

调用的对话框窗体


SAIInitApplicationMask

文件名

ea_apis.kb

语法

SAIInitApplicationMask;

参数

返回

1 = 成功

SQL 返回码

副作用

说明

此例行程序查询 SAI_APPLICATIONS 表,以获取在 m_SAIApplicationMask 中设置相关位的所有已安装的应用程序。

调用的对话框窗体


SAIRegisterApplication

文件名

ea_apis.kb

语法

SAIRegisterApplication( REF appRec:SAIApplicationRec);

参数

appRec - SAI_APPLICATIONS 表的记录

返回

TRUE 或 FALSE

副作用

说明

此例行程序在 SAI_APPLICATIONS 表中查询是否存在 TMG 应用程序记录。如果找不到,则插入新记录。

调用的对话框窗体


UserSelectEventHandler

文件名

ea_apis.kb

语法

UserSelectEventHandler(REF eventdata: UserEventRecord);

参数

eventdata - 此对话框类型的实例数据

返回

1 = 成功

0 = 失败

副作用

说明

此例行程序为类属选择提供事件处理。

调用的对话框窗体