Utilizzo dell'API testo › API testo › Metodi di conversione

Argomento precedente: Modalità di aggiornamento di un esempio di ticket da parte di un utente finale

Argomento successivo: File di configurazione

Metodi di conversione

A molte delle parole chiave definite nel file text_api.cfg è associato un metodo per convertire il valore specificato in un valore appropriato per la memorizzazione nel database. Questa funzione consente agli utenti di specificare i valori come nell'interfaccia Web, senza dover conoscere il tipo di implementazione di base.

Il file di configurazione include diversi esempi di questo tipo di definizione delle parole chiave tra cui ISSUE.PRIORITY e CONTACT.CONTACT_TYPE. Se è necessario definire parole chiave aggiuntive, ad esempio per consentire l'accesso dell'API testo ai campi aggiunti durante la personalizzazione dello schema del database, è possibile utilizzare uno dei seguenti metodi predefiniti:

Metodo

Tipo di output

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

Se il valore da convertire non è supportato da nessuno dei metodi predefiniti, è necessario creare un metodo personalizzato. Il metodo dovrebbe utilizzare un valore STRING come input e restituire come output un valore INTEGER, STRING o UUID. La restituzione di un valore -1 (o “-1”) indica che il valore non può essere determinato e quindi non impostato. Per UUID, il valore restituito deve essere “(uuid) NULL”.

Ad esempio, è possibile sviluppare un metodo per convertire un ID utente in un riferimento di tabella ca_contact. Il valore di input, ad esempio Amministratore, verrebbe passato al metodo e il metodo dovrebbe restituire l'ID della tabella ca_contact per l'ID utente dell'amministratore.

Il modo con cui si definiscono le parole chiave nel file di configurazione consente di definire più associazioni di parole chiave nello stesso campo, inclusi diversi metodi di conversione, in base al valore specificato. Ad esempio, è possibile che per l'assegnatario vi siano differenti associazioni di parole chiave per definire in che modo impostare il valore in base a differenti valori di input. Un input potrebbe essere l'ID utente e un altro potrebbe essere il cognome, il nome, il secondo nome e un altro ancora potrebbe essere l'ID ca_contact effettivo, ad esempio 793ED69B4E87A545BD8E911834D829FC). Ogni parola chiave viene associata a un metodo di conversione differente, tranne l'ultima che non deve essere convertita.