Rubrique précédente: Mise à jour d'un exemple de ticket par un utilisateurRubrique suivante: Fichier de configuration

Utilisation de l'API de texte › API text › Méthodes de conversion

Méthodes de conversion

De nombreux mots-clés définis dans le fichier text_api.cfg sont associés à une méthode de conversion de la valeur indiquée en une valeur appropriée pour le stockage dans la base de données. Cette fonction permet aux utilisateurs de préciser les valeurs qu'ils souhaitent dans l'interface Web, sans avoir à connaître l'implémentation sous-jacente.

Le fichier de configuration comporte plusieurs exemples de ce type de définition de mot clé, notamment ISSUE.PRIORITY et CONTACT.CONTACT_TYPE. Si vous devez définir d'autres mots clés (par exemple, pour permettre l'accès de l'API de texte aux champs que vous avez ajoutés lors de la personnalisation de votre schéma de base de données), vous pouvez utiliser l'une des méthodes prédéfinies ci-dessous :

Méthode

Type de sortie

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 la valeur que vous devez convertir n'est rencontrée par aucune de ces méthodes prédéfinies, vous devez écrire une méthode personnalisée. La méthode doit utiliser une valeur de type chaîne (STRING) comme entrée et renvoyer une valeur (INTEGER, STRING ou UUID) comme sortie. "Renvoyer une valeur -1 (ou "-1") pour indiquer qu'il n'a pas été possible de déterminer la valeur qui n'est donc pas définie. "Pour l'UUID, renvoyer "(uuid) NULL".

Par exemple, vous pouvez développer une méthode pour convertir un ID d'utilisateur en une référence de la table ca_contact. La valeur entrée, par exemple Administrateur, est transmise à la méthode, qui renvoie l'ID de la table ca_contact pour l'ID d'utilisateur Administrateur.

La manière dont vous définissez les mots-clés dans le fichier de configuration permet de définir plusieurs mappages de mots-clés pour le même champ, notamment diverses méthodes de conversion en fonction de la valeur spécifiée. Par exemple, la personne assignée peut avoir plusieurs mappages de mots-clés différents pour indiquer la manière de définir sa valeur en fonction des différentes valeurs entrées. Une entrée peut être l'ID d'utilisateur, une autre le nom, le prénom ou le deuxième prénom, et une troisième l'ID ca_contact réel (par exemple, 793ED69B4E87A545BD8E911834D829FC). Chaque mot-clé est mappé sur une autre méthode de conversion, à l'exception de la dernière qui ne nécessite pas de conversion.