プレースホルダは、メール通知の件名や本文に含められる、チケットやユーザーデータへの参照です。プレースホルダを使わなければ、自動メッセージを作成することは不可能です。プレースホルダの一覧と、プレースホルダを利用できるケースについては、「Zendesk Supportプレースホルダリファレンス」を参照してください。プレースホルダを指定する際には、大文字と小文字が区別されるので注意が必要です。
Supportには、特定の状況でトリガ内のプレースホルダを非表示にする内部システムルールが含まれます。内部システムルールは、変更、変更、または上書きできないルールであり、Supportのデフォルトの動作を決定します。これらのルールによって、トリガのプレースホルダが機能しなかったように見えることがありますが、これは誤動作ではありません。これらのルールは、スパム送信者がアカウントを使用してスパムメッセージを配信することを防止するため、ユーザーを保護しています。詳細については、「プレースホルダの非表示ルールについて」を参照してください。
関連記事
ビジネスルール内でプレースホルダを使用する
以下の例では、プレースホルダはチケットプロパティへの参照であり、二重の中括弧で囲まれています。プレースホルダが値を持たないフィールドを参照している場合、自動化、トリガ、またはマクロでそのプレースホルダは空白になります。
メール通知におけるプレースホルダの使用例を以下に示します。
メール通知を作成しているときに、「使用可能なプレースホルダを表示」をクリックすると、プレースホルダのリストを閲覧できます。
プレースホルダの一覧と、プレースホルダを利用できるケースについては、「Zendesk Supportプレースホルダリファレンス」を参照してください。プレースホルダのデータの選択や表示を詳細にコントロールしたい場合は、「リキッドマークアップとZendesk Supportについて」を参照してください。
プレースホルダを含むマクロをチケットに適用した場合、プレースホルダはチケットについて現在真である要素に応じて評価されます。評価の出力が情報を返した場合、その情報はチケットのコメントとして追加されます。たとえば、チケットIDを返すマクロを、まだ保存していない（それゆえチケットIDを持たない）チケット上で実行すると、チケットのコメントは更新されません。また、チケットを保存しても、マクロは再度評価されません。{{ticket.id}}のプレースホルダを手作業でチケットに追加します。これにより、チケットを提出したときにチケットが評価され、プレースホルダが返す値がチケットのコメントに追加されます。
カスタムフィールドのプレースホルダを使用する
プレースホルダは、チケットと現在のユーザープロパティに基づいて自動生成されます。これらをシステムプレースホルダと呼びます。
チケット、ユーザー、組織のカスタムフィールドを追加した場合、追加したフィールドをプレースホルダとして使用することもできます。カスタムフィールドのプレースホルダの使い方は、他のあらゆるシステムプレースホルダと同じです。
すべてのカスタムフィールドには一意のIDまたはキーがあります。通常はカスタムチケットフィールドを作成すると、このIDが自動的に生成されます。カスタムユーザーフィールドまたはカスタム組織フィールドを作成する場合は、IDは作成者が入力します。いったん設定したIDは変更できません。
カスタムフィールドは、利用可能なプレースホルダのリストに含まれていませんが、固有のIDまたはキーを参照する次のようなシンプルな命名パターンに従って名前が付けられます。
| チケットのカスタムフィールド | {{ticket.ticket_field_<field ID number>}} |
| ユーザーのカスタムフィールド | {{ticket.requester.custom_fields.<field_key>}} |
| 組織のカスタムフィールド | {{ticket.organization.custom_fields.<field_key>}} |
たとえば、次のようなカスタムチケットフィールドのプレースホルダは、以下のようになります。
{{ticket.ticket_field_505156}}
カスタムドロップダウンリスト内のオプションのプレースホルダ名は、別のパターンに従います。これは選択されたオプションへの参照であり、1つのプレースホルダで3つのドロップダウンリストのオプションすべてを表しています。個々のオプションにはIDがないため、このIDはカスタムドロップダウンリスト全体を表します。繰り返しになりますが、これは選択された1つのオプションへの参照です。
| チケットのカスタムドロップダウンフィールド
チケットのカスタムマルチセレクトフィールド |
{{ticket.ticket_field_option_title_<field ID number>}}
{{ticket.ticket_field_<field ID number>}}
メモ：{{ticket.ticket_field_option_title_<field ID number>}}プレースホルダには選択したオプションのタイトルが表示され、{{ticket.ticket_field_<field ID number>}}プレースホルダには選択したオプションに関連付けられているタグが表示されます。
|
| ユーザーのカスタムドロップダウンフィールド | {{ticket.requester.custom_fields.<field_key>.title}} |
| 組織のカスタムドロップダウンフィールド | {{ticket.organization.custom_fields.<field_key>.title}} |
たとえば、カスタムチケットフィールドのドロップダウンリストのプレースホルダは以下のようになります。
{{ticket.ticket_field_option_title_515416}}
カスタムチケットフィールドのIDを探すには
- 管理センターで、サイドバーの「
オブジェクトとルール」をクリックし、「チケット」>「フィールド」を選択します。 - リスト内でカスタムフィールドを見つけ、オプションメニューで「編集」をクリックします。
IDが右側の列に表示されます。
カスタムユーザーフィールドまたはカスタム組織フィールドのキーを探すには
メンバー」をクリックし、「設定」>「ユーザーフィールド」を選択します。
チェックボックスカスタムフィールドのプレースホルダを使用する
プレースホルダをリキッドマークアップと組み合わせると、チケットのチェックボックス（カスタムフィールド）が選択されているかどうかを確認でき、チェックボックスの状態（オンまたはオフ）に応じてカスタムの出力を行うことが可能です。
チェックボックスのカスタムチケットフィールドでリキッドマークアップ、「if/else/case」文を使用する場合、チェックボックスフィールドの値は、「0」または「1」とし、「false」や「true」は使用しないようにします。以下に例を示します。
{% if ticket.ticket_field_<insert field_id here> contains 1 %}
checkbox is checked
{% else %}
checkbox is unchecked (or null)
{% endif %}
0 コメント
サインインしてコメントを残してください。