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.
Copyright © 2013 CA.
Todos los derechos reservados.
|
|