Tema anterior: Cómo actualizan ejemplos de ticket los usuarios finalesTema siguiente: El archivo de configuración


Métodos de conversión

Muchas de las palabras clave definidas en el archivo text_api.cfg cuentan con un método asociado que permite convertir el valor especificado en el valor apropiado para el almacenamiento en la base de datos. Esta función permite a los usuarios especificar valores del mismo modo que se hace en la interfaz Web, sin necesidad de que tengan conocimientos de la implementación subyacente.

El archivo de configuración tiene varios ejemplos de este tipo de definición de la palabra clave, incluyendo ISSUE.PRIORITY y CONTACT.CONTACT_TYPE. Si necesita definir más palabras clave (por ejemplo, para permitir que el API de texto acceda a campos que haya agregado al personalizar su esquema de base de datos), puede utilizar uno de los siguientes métodos predefinidos:

Método

Tipo de salida

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

Si ninguno de los métodos anteriores es apropiado para el valor que se debe convertir, es necesario escribir un método personalizado. El método debe tomar un valor de CADENA como entrada y devolver otro valor (ENTERO, CADENA o UUID) como salida. Si se devuelve el valor -1 (o “-1”), se denota que el valor no se puede determinar y que, por consiguiente, no está definido. En el caso de UUID, se devuelve un valor nulo.

Por ejemplo, es posible desarrollar un método que convierta el ID de usuario en una referencia de la tabla ca_contact. El valor entrante, Administrador, por ejemplo, se traslada al método, que devuelve el ID de la tabla ca_contact correspondiente al ID de usuario del administrador.

La manera de definir las palabras clave en el archivo de configuración ofrece la ventaja de poder definir varias asignaciones de palabras clave para el mismo campo, incluidos diferentes métodos de conversión, en función del valor especificado. Por ejemplo, los asignatarios pueden tener varias asignaciones distintas de palabras clave que indiquen cómo se define su valor según los diversos valores de entrada. Las entradas pueden corresponder al ID de usuario, a los apellidos, al nombre o al segundo nombre y también al ID real de ca_contact (por ejemplo, 793ED69B4E87A545BD8E911834D829FC). Cada una de las palabras clave se asigna a un método de conversión diferente, salvo el último, que no necesita someterse a ninguna conversión.