Text API の使用 › Text API › 変換メソッド

前のトピック: エンド ユーザによるチケットの更新例

次のトピック: 環境設定ファイル

変換メソッド

text_api.cfgに定義されている多くのキーワードには、指定した値をデータベース格納に適した値に変換するための関連するメソッドがあります。 この機能により、基礎的な実装の知識がないユーザでも、Web インターフェースの場合と同じように値を指定できます。

構成ファイルには、ISSUE.PRIORITY や CONTACT.CONTACT_TYPE など、このタイプのキーワード定義の例がいくつかあります。 キーワードの追加定義が必要になった場合（たとえば、データベース スキーマのカスタマイズ時に追加したフィールドへのアクセス権を Text API に付与するなど）、以下のいずれかの事前定義済みメソッドを使用できます。

方法

出力タイプ

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

変換する必要がある値が、これらの定義済みメソッドで対応できない場合は、カスタム メソッドを記述する必要があります。 メソッドは、入力としてSTRING値を取り、出力として値（INTEGER、STRING、またはUUID）を返す必要があります。 値を判断できない（つまり、設定されない）ことを示すのに-1（または"-1"）の値を返します。 UUIDの場合は、"(uuid) NULL"を返します。

たとえば、ユーザ ID を ca_contact テーブル参照に変換するメソッドを作成した場合、 Administrator などの入力値がメソッドに渡され、Administrator のユーザ ID に対応した ca_contact テーブル ID がメソッドから返されます。

環境設定ファイルにキーワードを定義する方法により、同じフィールドに複数のキーワード マッピング（指定された値に応じた異なる変換メソッドなど）を定義することができます。 たとえば、担当者にいくつかの異なるキーワード マッピングを指定して、異なる入力値に基づいてどのように値を設定するかを定義することができます。 入力がユーザ ID、姓/名/ミドルネーム、および実際の ca_contact ID（たとえば、793ED69B4E87A545BD8E911834D829FC）の場合、 変換が不要なca_contact IDを除いて、各キーワードは異なる変換メソッドにマップされます。