rtapi.kb 例行程序


CreateRTConfigDialog

文件名

rtapi.kb

语法

intRet:= CreateRTConfigDialog ( g_mainWindow, msgWindow, remTransRec );

参数

WINDOW - 接收系统范围消息的主窗口

WINDOW -“消息窗口”或该窗口的

直接父窗口。

返回

整数 - 从对话创建进程返回的最后

返回值。

副作用

说明

该函数用于从 SAI_APP_PARAMS 表中获取参数值并将它们传入 RTCFG.KB,用于创建对话。

调用的对话窗口

rtcfg.dfc[remtrans_options]


DoSiteInquiry

文件名

rtapi.kb

语法

boolRet:= DoSiteInquiry;

参数

返回

布尔值 -“用户查询”的配置标志。

副作用

说明

如果设置了“基础”配置手册“查询页”上包含的“站点查询”配置标志,该函数将返回 TRUE。否则将返回 FALSE。

调用的对话窗口


ExpandProblemIDToken

文件名

rtapi.kb

语法

参数

字符串 - 要展开的标记

字符串 - 已展开的问题标识。

返回

1 - 如果已对有效的问题标识成功地展开了标记。

-100 - 如果问题不存在

<0 - 如果发生了数据库错误。

副作用

说明

接受 <SITEID->ID 窗口的“问题标识”标记,其中 SITEID- 为可选的。如果未提供 <SITEID->,则假定已在本地站点组织了该问题。该函数将确定标识是否具有本地 SITEID 前缀。标识也将填凑一定数量的零。该 API 主要由 EMA 使用。例如:在站点 SPRFLD... BDRCK-5 生成 BDRCK-00000005,如果问题在安装 DDM 之后产生,5 生成 SPRFLD-00000005,如果问题在安装 DDM 之前产生,5 生成 00000005。

调用的对话窗口


InquireSites

文件名

rtapi.kb

语法

intRet:= InquireSites ( g_mainWindow, msgWindow, siteRec, doInquiryProcess, allowSelect, doWorkWithProcess );

参数

WINDOW - 接收系统范围消息的主窗口

WINDOW -“消息窗口”或该窗口的

直接父窗口。

布尔值 - 显示或处理“站点查询”屏幕

布尔值 - 允许从处理的进程中

选择记录

布尔值 - 显示及

及处理“用屏幕进行站点工作”

返回

整数 - 从对话创建进程中返回的最后

返回值。如果显示“用屏幕工作”,则

从 DlgCreate() 返回值。否则

从查询 DlgBox() 返回

值。

副作用

说明

该函数用来显示或处理“用屏幕进行站点工作”和“站点查询”。如果“查询”标志为 TRUE,将处理“查询”并且创建以输入的值为基础的 SQL 搜索字符串。如果“用标志工作”为 TRUE,将显示“用屏幕工作”,并带有所有站点(“查询”标志 = FALSE)或带有与“查询”屏幕中输入的搜索准则相匹配的“站点”列表(“查询”标志 = TRUE)。如果允许用户选择值,则将使用用户选择的“组”信息植入 SiteRecord。

调用的对话窗口

rtsites.dfc[rt_site_inquiry]

rtsites.dfc[rt_sites_nb]


IsProblemLocal

文件名

rtapi.kb

语法

参数

字符串 - 正在探究的“问题”的标识。

返回

1 - 如果当前此站点拥有该问题

0 - 如果另一站点拥有该问题或该问题在排队等待

转移至远程站点。

<0 - 如果发生了数据库错误。

副作用

说明

确定问题是否由本地站点或远程站点拥有。

调用的对话窗口


RequestInquireSites

文件名

rtapi.kb

语法

RequestInquireSites ( whdl );

参数

WINDOW - 处理系统范围消息的

主窗口。

返回

副作用

说明

指定该函数作为系统操作调用。用于请求一个带“站点”会话的“查询/工作”。

调用的对话窗口

rtsites.dfc[rt_site_inquiry]

rtsites.dfc[rt_sites_nb]


RequestRemTransConfig

文件名

rtapi.kb

语法

RequestRemTransConfig ( whdl );

参数

WINDOW - 处理系统范围消息的

主窗口。

返回

副作用

说明

指定该函数作为系统操作调用。用来请求“远程转移配置”对话。

调用的对话窗口


RetrieveLocalSiteID

文件名

rtapi.kb

语法

参数

NONE - 调用函数应当有一个字符串设置为等于该函数的

结果,并且为了进行错误处理

应估计该函数的返回值。即……

USES RTAPI;

tempString: STRING;

tempString:= RetrieveLocalSiteID;

IF KNOWN( tempString ) THEN

do_something;

ELSE

handle_the_unknown;

END;

返回

g_remTrans.site_id (DDM 本地站点标识)

副作用

说明

调用来检索“本地站点标识”的函数。

调用的对话窗口


RTAPIInit

文件名

rtapi.kb

语法

RTAPIInit (); Requirement: 调用其它 RTAPI 函数(即 RetrieveLocalSiteId) 前必须调用此函数

参数

必须在调用知识库过程中声明 USES RTAPI

返回

副作用

说明

该函数从本地站点的 SITES 表中初始化 DDM 全局 SITE_ID 变量。

调用的对话窗口