入力フォーマット

Text API への入力は以下の方法で指定されます。

コマンドラインインターフェースでは、入力は通常、pdm_text_cmd コマンドに渡すテキストファイルに指定されます。
電子メールインターフェースでは、入力は電子メールのテキスト内に指定されます。正規表現を指定して、ターゲットオブジェクト ID を検索できます。

どちらのインターフェースを使用しても、同じ方法で Text API への入力をフォーマットします。

入力の基本フォーマットは以下のとおりです。

%keyword=value

または

%PROPERTY={{property_label}}value

Text API コマンドの通常の動作では、2 つ以上の矛盾するコマンドが存在する場合は最後のコマンドが優先されますが、以下の例外があります。

メッセージに、メールボックスルールフィルタ文字列と一致する有効なチケット ID 成果物、または複数の Text API チケット ID コマンドが含まれている場合、最初のオカレンスが使用されます。また、チケット ID 成果物（メールボックスルールフィルタ文字列を使用して識別される）は、最初に検出されたコマンドにかかわらず、どの Text API チケット ID コマンドよりも優先されます。
メッセージに複数のログコメント Text API コマンドが含まれる場合、すべてのコメントがポストされますが、それらがチケットアクティビティログに表示される順序は異なる場合があります。

フィルタに一致するすべてのチケット ID 成果物（有効かどうかにかかわらず）と、メッセージ内の Text API チケット ID コマンド（適用可能かどうか、あるいは適用されたかどうかにかかわらず）はすべて、メッセージがポストされる前にコメント化されます。メールボックスルールフィルタによって識別されたチケット ID 成果物は「-((...))-」と表示されます。 Text API チケット ID コマンドの先頭のパーセンテージ記号（%）は、2 つの開かっこ「((」とコマンドの後に続く 2 つの閉かっこ「))」に変換されます。ログコメント（%LOG=…）付きの別の Text API コマンドの後に Text API チケット ID コマンドがある場合、コメント化された Text API チケット ID コマンドは個別のログコメントになります。

注：ログコメントは、1 つのメッセージ内で複数回使用できて、さらに各オカレンスが適用される唯一の Text API コマンドです。ほかのコマンドでは、Text API は最後のオカレンスのみを使用します。これは、ほかのコマンドの複数のオカレンスは相互に矛盾するためです。複数のログコメントコマンドによって個別のログコメントメッセージがチケットにポストされますが、その順序は必ずしも決まっていません。

また、Text API チケット ID コマンドがメッセージの先頭、またはほかの 2 つの Text API コマンドの間に存在する場合、そのコマンドはログコメントに変換されます。前のコマンドがログコメント（%LOG=…）または更新の説明（%DESCRIPTION=…）である場合、コマンドは個別のログコメントになるのではなく、前のコマンドに追加されます。

HTML のみが送信され、プレーンテキストバージョンが含まれていない着信メッセージでは、メッセージ本文が失われます。空のメッセージ本文を使用した任意のメールボックスルールフィルタにメッセージが一致する場合、空の説明または引用されたメッセージの件名をチケットの説明全体として、チケットを作成できます。

このトピックについて CA Technologies に電子メールを送信する