使用 Text API › Text API › 转换方式

上一主题: 最终用户如何更新故障单（示例）

下一主题: 配置文件

转换方式

text_api.cfg 中定义的许多关键字具有关联方式，能够将指定的值转换为适合在数据库中存储的值。 此功能允许用户按照 Web 界面中的方式指定值，而无需了解基本实施。

配置文件中有多个此类关键字定义的示例，包括 ISSUE.PRIORITY 和 CONTACT.CONTACT_TYPE。 如果需要定义其他关键字（例如，允许 Text API 访问在您自定义数据库架构时添加的字段），可以使用以下预定义方法之一：

方法

输出类型

lookup_actbool

INTEGER

lookup_asset_by_name

UUID

lookup_asset_by_persid

UUID

lookup_chg_category

STRING

lookup_chg_status

STRING

lookup_cnt_by_email

UUID

lookup_cnt_by_last_first_middle

UUID

lookup_cnt_by_logonid

UUID

lookup_cnt_by_persid

UUID

lookup_cnt_meth

INTEGER

lookup_cnt_type

INTEGER

lookup_company

UUID

lookup_cr_status

STRING

lookup_cr_template

STRING

lookup_domain

INTEGER

lookup_grc

INTEGER

lookup_group

UUID

lookup_impact

INTEGER

lookup_iss_category

STRING

lookup_iss_status

STRING

lookup_loc

UUID

lookup_mfr_model

UUID

lookup_nr_family

INTEGER

lookup_org

UUID

lookup_person_contacting

INTEGER

lookup_position

INTEGER

lookup_priority

INTEGER

lookup_prob_category

STRING

lookup_product

INTEGER

lookup_resource_status

INTEGER

lookup_service_lvl

STRING

lookup_severity

INTEGER

lookup_state

INTEGER

lookup_timezone

STRING

lookup_type_of_contact

INTEGER

lookup_urgency

INTEGER

lookup_workshift

STRING

如果需要转换的值没有通过任何这些预定义方法处理，那么您需要编写自定义方法。 方法应把 STRING 值作为输入并返回一个值（可以是 INTEGER、STRING 或 UUID）作为输出。 返回值 -1（或“-1”）表示无法确定值并因此未设置。 对于 UUID，返回一个“(uuid) NULL”。

例如，您可以开发一个可将用户 ID 转换为 ca_contact 表引用的方法。 传入的值（例如 Administrator）将传递给该方法，而该方法将返回管理员用户 ID 的 ca_contact 表 ID。

您在配置文件中定义关键字的方式为您提供了为相同字段定义多个关键字映射的优势，包括基于指定值的不同的转换方式。 例如，受理人可以有若干不同的关键字映射，用于定义如何基于不同输入值设置它的值。 输入值可能有用户 ID、姓氏、名字、中间名或者实际的 ca_contact ID（例如 793ED69B4E87A545BD8E911834D829FC）。 除最后一个不需要转换的关键字以外，每个关键字映射不同的转换方式。