callServerMethod

以下参数适用于 callServerMethod 方法：

参数	类型	描述
SID	整型	标识从登录检索的会话。
methodName	字符串	标识要调用的方法名称。
factoryName	字符串	标识包含方法的对象类型的工厂名称。
formatList	字符串	标识格式列表，为引入参数描述既定数据类型的一系列字符。它与此表中的 Parameter() 描述相关。
参数	String[]	表示此方法的零个或多个参数值。

描述

使用此方法调用任意服务器端的方法。这些是在专有“拼写”脚本语言中定义的方法。

只可以调用工厂方法，并且调用方必须以完全管理权限登录。

格式列表是零个或多个字符序列，它表示（按顺序）要遵循的参数数据类型。字符代码如下：

0 S—字符串
0 I—整型（包括日期和持续时间）
0 N—空

例如，假设某一拼写方法的定义如下：

cr::DoStuff(int in_one, string in_two, string in_three);

由以下方法调用：

callServerMethod(“DoStuff”, “cr”, “ISS”, [3, “a string”, “another one”]);

此方法专用于 CA 开发和仅限于自定义的服务，对于大多数站点，不推荐使用。

其自身 XML 元素中的每个返回消息组件。元素是值的所有字符串表现形式。元素按从服务器返回的顺序排序，它使用以下格式：

<ServerReturn>

<Paramx>

此调用不支持对象引用返回。如果由拼写方法返回对象引用，则返回数据为字符串“OBJECT”。这不是错误，并且还将返回其它参数。

XML 元素	类型	描述
<ServerReturn>	N/A	表示外部元素，它包含了返回值的零个或多个 <ParamX> 元素。
<Paramx>	字符串	表示零个或多个返回值，其中 x 为从零开始的整数，并根据返回元素数而增加。

可以使用 check_bopsid 验证 BOPSID。这是使用 callServerMethod 调用的，如下所述：

String bopsid; // somehow gets populated with the BOPSID value
String [] stuff  = new String [] { bopsid };

String ret = usd.callServerMethod
(sid, "check_bopsid", "api", "I", stuff);

如果 BOPSID 验证失败，将返回 SOAP 错误。如果验证成功，返回值是下列形式的小 XML 结构：

<ServerReturn>
<Param0>CONTACT_PERSID</Param0>
<Param1>SESSION_TYPE</Param1>
<Param2>SESSION_ID</Param2>
</ServerReturn>

CONTACT_PERSID: 定义经过验证的/受信任的联系人的唯一永久 ID。其形式为“cnt:<uuid>”。
session_type: 定义一个小的整数标识，表示生成 BOPSID 的会话的类型。这通常不由集成人员使用
SESSION_ID: 定义可选的会话 ID。这是生成 BOPSID 的会话的 ID。可能会设置该 ID，也可能不设置。这有助于在 CA SDM 内维护用户的逻辑会话，特别是当用户被其他 BOPSID“传递”回 CA SDM 时。

注意：如果 BOPSID 验证返回成功消息，则绕过登录屏幕登录 CA SupportBridge，否则将显示“CA SupportBridge 登录”屏幕。