管理 Web 服务 › 对象

对象

CA Service Desk Manager 将每个实体（例如，联系人或投诉）视为一个对象。 这些高级对象在 CA Service Desk Manager 服务器上以下目录的 majic (.maj) 和 mod (.mod) 文件中定义：

/bopcfg/majic

自定义对象在以下目录中定义：

/site/mods/majic

对象本质上是围绕数据库表的高级 Wrapper 程序。

对象的类型（有时又称为工厂）用于定义对象。 例如，请求对象属于‘cr’类型。 每个对象的类型均由 majic 文件中的“OBJECT”声明定义。

注意：《CA Service Desk Manager 技术参考指南》中列举了 CA Service Desk Manager 附带的所有对象。

对象的属性本质上是数据库表中的列（请勿将这些属性与 XML 属性混淆）。 Web 服务提供了许多可用于检索属性值的方法。 很多方法要求您命名属性以设置或检索值。 您必须使用定义对象的 majic 或 mod 文件中分配的属性名称，可以不同于实际的数据库名称。 客户端站点可以添加其他属性作为自定义设置。

注意： 有关每个对象的所有属性列表，请参阅《CA Service Desk Manager 技术参考指南》。

Web 服务通过其句柄唯一标识对象，该句柄是形式为 objectType:ID 的一个字符串值，其中 objectType 是对象的类型（工厂）名称，ID 是唯一值。 ID 值与每个 CA Service Desk Manager 对象中找到的“id”属性值匹配。 由于‘id’属性在 DBMS 中始终用于建立索引，因此使用对象句柄的 ID 部分对执行高效的查询特别有用。 不管是哪种类型，每个对象均将此值存储在名为“persistent_id”的对象属性中。

注意：在以前的版本中，句柄的 ID 部分始终是一串整数。 在 Unicenter Service Desk r11.0 和更高版本中，ID 部分还可能是 UUID 的字符串表示形式，通常是 32 个字符。

以下信息列出了使用 UUID 的实体的对象名称和工厂名称：

句柄具有持续性；代表特定对象的句柄在其生命周期中始终具有唯一性，即使在数据库间发生迁移。 客户端在处理完全静态的对象（例如，状态或联系人类型）时可能需要利用此持续性。

对象句柄是使用 CA Service Desk Manager Web 服务的关键。 很多方法，特别是那些用于更新数据的方法都需要句柄。 用于返回对象数据的大多数方法还包括对象的句柄。