Métodos de conversão

Usando a API de texto › API de texto › Métodos de conversão

Métodos de conversão

Muitas das palavras-chave definida em text_api.cfg têm um método associado para converter o valor especificado a um valor que seja apropriado para armazenamento no banco de dados. Esse recurso permite que os usuários especifiquem valores do mesmo modo que fariam na interface da web, sem ter nenhum conhecimento da implementação subjacente.

O arquivo de configuração possui diversos exemplos desse tipo de definição de palavras-chave, incluindo ISSUE.PRIORITY e CONTACT.CONTACT_TYPE. Caso precise definir palavras-chave adicionais (por exemplo, para permitir que a API de texto acesse campos adicionados ao personalizar o esquema do banco de dados), é possível usar um dos seguintes métodos predefinidos:

Método	Tipo de saída
lookup_actbool	INTEIRO
lookup_asset_by_name	UUID
lookup_asset_by_persid	UUID
lookup_chg_category	SEQUÊNCIA
lookup_chg_status	SEQUÊNCIA
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	INTEIRO
lookup_cnt_type	INTEIRO
lookup_company	UUID
lookup_cr_status	SEQUÊNCIA
lookup_cr_template	SEQUÊNCIA
lookup_domain	INTEIRO
lookup_grc	INTEIRO
lookup_group	UUID
lookup_impact	INTEIRO
lookup_iss_category	SEQUÊNCIA
lookup_iss_status	SEQUÊNCIA
lookup_loc	UUID
lookup_mfr_model	UUID
lookup_nr_family	INTEIRO
lookup_org	UUID
lookup_person_contacting	INTEIRO
lookup_position	INTEIRO
lookup_priority	INTEIRO
lookup_prob_category	SEQUÊNCIA
lookup_product	INTEIRO
lookup_resource_status	INTEIRO
lookup_service_lvl	SEQUÊNCIA
lookup_severity	INTEIRO
lookup_state	INTEIRO
lookup_timezone	SEQUÊNCIA
lookup_type_of_contact	INTEIRO
lookup_urgency	INTEIRO
lookup_workshift	SEQUÊNCIA

Se o valor que você necessita converter não puder utilizar um desses métodos predefinidos, será necessário escrever um método personalizado. O método deve tomar como entrada um valor de SEQÜÊNCIA e retornar um valor (NÚMERO INTEIRO, SEQÜÊNCIA ou UUID) como sua saída. Retorne um valor -1 (ou “-1”) para indicar que o valor não pode ser determinado e, portanto, não foi definido. No caso de UUID, retorne um “(uuid) NULL”.

Por exemplo, é possível desenvolver um método para converter uma ID de usuário em uma referência da tabela ca_contact. O valor de entrada, como Administrador, seria passado ao método, o qual retornaria a ID da tabela ca_contact para a ID de usuário do Administrador.

A maneira em que você define palavras-chave no arquivo de configuração oferece a vantagem de definir vários mapeamentos de palavra-chave ao mesmo campo, incluindo métodos diferentes de conversão, de acordo com o valor sendo especificado. Por exemplo, o destinatário pode ter vários mapeamentos diferentes de palavra-chave para definir como configurar seu valor com base em valores de entrada diferentes. Uma entrada pode ser uma ID de usuário, outra pode ser o sobrenome, nome, segundo nome, e outra ainda pode conter a ID real de ca_contact (por exemplo, 793ED69B4E87A545BD8E911834D829FC). Todas as palavras-chave apontam a métodos de conversão diferentes, exceto a última, que não necessita ser convertida.