Jinjaテンプレート言語

MoEngageテンプレート言語は、カスタマイズとパーソナライズの要件を最高度にコントロールできる、人気でシンプルなテンプレート言語であるJinjaに基づいています。 ents.

変数

変数は式であることもあり、新しい変数を評価します。二重括弧内のすべてのものは評価され、最終コンテンツに挿入されます。

変数はしばしば属性の集まりです。MoEngageのメールテンプレートでは、これらの属性にドット演算子を使用してアクセスできます。

.

または下付き文字表記で:

[]

変数を挿入するには、 それらを二重中括弧で囲みます。 それらを二重中括弧で囲みます。 たとえば、 F irstName というラベルのユーザー属性を挿入するには：

{{UserAttribute['First Name']}}

例えば、 U serAttributes は現在のユーザーに属するすべての属性のコレクションです。属性 F の値を挿入したい場合は irstName 、次のコードを使用します:

ようこそ、{{UserAttribute['First Name']}}

表現

MoEngageは、基本的な式をどこでもサポートしています。式は、数学的、論理的、その他の操作を行うことによって、他の変数や式から変数を作成するために使用できます。

式またはステートメントを使用するには、次のように囲みます:

{% %}

リテラル

リテラルは最も単純な形式の式です。リテラルは文字列や数値などの変数を表します。以下のリテラルが存在します。

数学

MoEngageは、値を使用して計算することができます。以下の演算子がサポートされています。

比較

ロジック

if文、フィルタリング、 if 式の場合、複数の式を組み合わせることが有用です： 式を組み合わせることは、有用な場合があります:

表現テスト

テストは、変数を一般的な式に対してテストするために使用できます。変数や式をテストするには、追加してください。 です そして変数の後にテストの名前を付けます。

たとえば、変数が定義されているかどうかを確認するには、「 name is defined 、テンプレートの現在のコンテキストで名前が定義されているかどうかに応じて、trueまたはfalseを返します。

テストは引数を受け取ることもできます。テストが1つの引数しか取らない場合、括弧を省略することができます。例えば、次の2つの式は同じことを行います:

{% if loop.index is divisibleby 3 %}
{% if loop.index is divisibleby(3) %}

詳細については、 Jinja Pallets を参照してください。

コメント

テンプレート内の行の一部をコメントアウトするには、デフォルトで設定されているコメント構文を使用します。 {# ... #} これは、デバッグのためにテンプレートの一部をコメントアウトしたり、他のテンプレートデザイナーや自分自身のために情報を追加したりするのに役立ちます。

{% # note: commented-out template because we no longer use this
   {% for user in users %}
       ...
   {% endfor %}
# %}

課題

コードブロック内では、変数に値を割り当てることもできます。トップレベル（ブロック、マクロ、ループの外側）での割り当ては、トップレベルのマクロのようにテンプレートからエクスポートされ、他のテンプレートによってインポートされることができます。

課題はセットタグを使用し、複数のターゲットを持つことができます。

{% set navigation = [('index.html', 'Index'), ('about.html', 'About')] %}
{% set key, value = call_something() %}

条件文、ループ

• ループと一緒にカスタム変数を使うこともできます。タグはテンプレートのロジックを制御し、条件文、ループ、マクロなどを実行することができます。
  
  サンプルループ

  {% set products = [{‘name’: ‘Nike’, ‘href’: 'https://www.example.com/nike'}, {‘name’: ‘Adidas’, ‘href’: 'https://www.example.com/adidas'}] %}
  {% for product in products %}		
      <li><a href="{{ product.href }}">{{ product.name }}</a></li>
  {% endfor %}

サンプル条件

{% if products %}

製品は空ではありません。

製品は空です。

エスケープ

MoEngage が変数やブロックとして処理する部分を無視することが、時には望ましい（さらには必要な）場合があります。例えば、デフォルトの構文で使用したい場合、 {{ テンプレート内で生の文字列として使用し、変数を開始しないためには、トリックを使用する必要があります。

リテラル変数デリミタを出力する最も簡単な方法

{{

は変数式を使用することによってです:

{{ '{{' }}

HTMLエスケープ

テンプレートからHTMLを生成する際、変数により結果のHTMLに影響を与える文字が含まれるリスクがあります。

必要に応じて変数をエスケープするのは あなたの 責任です。何をエスケープするべきですか？次の文字のいずれかを含む可能性のある変数がある場合 必要に応じて変数をエスケープする責任があります。何をエスケープしますか？次の文字が含まれる可能性のある変数がある場合

>, <, &, or "

あなた 必須 変数が適切に形成された信頼できるHTMLを含んでいない限り、それをエスケープします。エスケープは、変数を パイプ処理 することによって機能します。

|e

フィルター：

{{UserAttribute['First Name']|e}}

制御構造

制御構造とは、プログラムの流れを制御するすべての要素を指します。

• 条件文（つまり、 if/elif/else ）
• for -ループ
• マクロ と ブロック

デフォルトの構文では、制御構造が内部に表示されます

{% ... %}

ブロック。

ために

シーケンス内の各項目をループします。例えば、usersという変数に提供されたユーザーのリストを表示するには:

<h1>Members</h1>
<ul>
{% for user in users %}
 <li>{{ user.username|e }}</li>
{% endfor %}
</ul>

for ループ内では、特別なものを使用することにより、ループを通過するたびに文字列や変数のリストを循環させることが可能です。 サイクル ヘルパー

{% for row in rows %}
   <li class="{% cycle('odd', 'even') %}">{{ row }}</li>
{% endfor %}

ループの外で定義された変数はループ内で呼び出すことができますが、その逆はできません。

もし

最も簡単な形では、変数が定義されているか、空でないか、または偽でないかをテストするために使用できます。

{% if UserAttribute.interests %}
Your interests:
<ul>
{% for interest in UserAttribute.interests %}
   <li>{{ interest|e }}</li>
{% endfor %}
</ul>
{% endif %}

複数の支店の場合、 elif そして 他の も使用できます：

{% if UserAttribute.membership == 'Gold' %}
You are a Gold member!
{% elif UserAttribute.membership == 'Silver' %}
You are a Silver member!
{% else %}
Please become a member today!
{% endif %}

デフォルト値を使用する

MoEngage のメールテンプレートでは、メッセージに null 値が含まれている場合、送信されません。そのため、このような状況を避けるためにデフォルトのフォールバック値を割り当てる必要があります。 この例では、ユーザーの位置情報がない場合、このメッセージは送信されません：

{{UserAttribute['Location']}}へようこそ

そのような状況でメッセージが送信されるようにするために、値がnullの場合に変数によって返されるデフォルトの フォールバック 値を提供する必要があります。MoEngageのメールテンプレートは、属性がnullを返す状況を処理するためのオプションを提供するオーバーレイポップアップウィンドウを表示します。

属性値が欠落している場合にメッセージが送信されないようにするには、変数がnullの場合、フォールバック値を 送信しない に設定します。MoEngageのメールテンプレートは、未送信メッセージを処理するオプションを備えたオーバーレイポップアップウィンドウを表示します。

選択されたオプションは、返された値に基づいてメッセージを送信する際に自動的に使用されます。デフォルト値が提供されている場合、パーソナライズされたメッセージは次のようになります。

ようこそ、{{UserAttribute['First name']|default('Guest')}}

あるいは、私たちはまた使用することができます

{% set firstName = UserAttribute['First name'] %}
 {% if firstName %}
   Welcome, {{ firstName }}
 {% else %}
   Welcome!
{% endif %}

メッセージを送信したくない場合、または属性の値が見つからない場合は、

ようこそ、{{UserAttribute['First name']|default('MOE_NOT_SEND')}}

Jinja Filters (Functions)

以下は、Jinjaがサポートするいくつかのグローバル関数です：

文字列フィルター

適切なケース/タイトルケースに変換

これにより、文字列をタイトルケースに変換できます。例えば：

ジョン・ドウ

John Doe

{{UserAttribute['FirstName']|title}}

最初の文字を大文字にする

これにより、文字列内の各文の最初の文字を大文字にすることができます。例えば：

ジョン・ドウ彼の年齢は20歳です。

ジョン・ドウ。彼の年齢は20歳です。

{{UserAttribute['FirstName']|capitalize}}

UPPER CASE

これにより、文字列を大文字に変換できます。例えば：

joHn doE

JOHN DOE

{{UserAttribute['FirstName']|upper}}

小文字

これにより、文字列を小文字に変換できます。例えば：

JoHn doE

john doe

{{UserAttribute['FirstName']|lower}}

文字列を置き換える

これにより、文字列の一部を別の文字列に置き換えることができます。例えば、joHnの「jo」を「ma」に置き換えてみましょう：

joHn doE

mahn doe

{{UserAttribute['Mobile Number']|replace(“jo”,”ma”)}}

文字列にサブ文字列が含まれているかどうかを確認する

これにより、文字列がサブ文字列を含んでいるかどうかを確認できます。例えば：

今すぐクリックしてください！

今

出力: true block

{% if "true" in UserAttribute['eligible'] %}
true block
{% elif "false" in UserAttribute['eligible'] %}
false block
{% endif %}

数値フィルター

Add +91

これにより、携帯番号に「+91」を追加する部分を置き換えることができます。例えば：

9991119991

+919991119991

{{“+91” + UserAttribute['Mobile Number']|default('NA')}}

10桁を考慮する

これにより、携帯電話番号の10桁のみを考慮することができます。例えば：

+919991119991

9991119991

{{UserAttribute['Mobile Number'][-10:]|default('NA')}}

整数フィルター

データのビット長

符号と先行ゼロを除いて、整数を2進数で表現するのに必要なビット数を返します。

int.bit_length()

複素数の共役

複素数の共役を返します。複素数はサポートされていないため、int.conjugate() は数自体を返します。

int.conjugate()

フロートフィルター

浮動小数点が有限整数かどうかを識別する

浮動小数点インスタンスが有限で整数値の場合はTrueを返し、それ以外の場合はFalseを返します。

<span">float.is_integer()</span">

16進文字列

16進数文字列で表された浮動小数点数を返します。文字列には前後に空白が含まれている場合があります。

float.fromhex(string)

複素数の共役

複素数の共役を返します。複素数はサポートされていないため、float.conjugate() はその数自体を返します。

float.conjugate()

フィルターをリスト

アイテムの出現回数

リスト内の指定された項目の出現回数を返します。

list.count(item)

リスト内の最小インデックス

指定された項目がスライス s[start:end] 内で見つかるリストの最小インデックスを返します。オプションの引数 start と end はスライス表記として解釈されます。str.index() に似ています。
list.index() は、インデックスがリスト内にない場合にエラーをスローします。

list.index(item[, start[, end]])

リスト内のインデックス位置のアイテムを削除

リスト内のインデックス位置にあるアイテムを返し、リストから削除します。インデックスが指定されていない場合、リストの最後の項目を返して削除します。list.pop() は、インデックスがリスト内にない場合にエラーをスローします。

list.pop([index])

カスタム関数

日付時間関数とフォーマッタ

Date Formatter - 任意の日付をtoFormatで指定された形式に変換します。

使用法
{{'14/10/2020'|dateFormatter('%m/%d/%Y')}}

出力: 2020年10月14日

日付の差 - 2つの日付の差を返します。戻り値は正、ゼロ、または負になることがあります。

使用
{{'12/10/2020'|days('14/10/2020')}}

出力：2

今日の関数 - 指定された形式とタイムゾーンで現在の日付を返します。

使用法（ESTタイムゾーンのMM/DD/YYYYの場合）
{{'%m/%d/%Y'|today('EST')}}

出力: 2024年5月23日

日付と時刻のフォーマッタ関数 -

• 日付と時刻のフォーマット - 指定された形式に任意の日付を変換します。

方法:

dateTimeFormatter(toFormat='%Y-%m-%d %H:%M:%S %p')

使用
{{ "2012-01-19 17:21:00 CST" |dateTimeFormatter(toFormat='%Y-%m-%d %H:%M:%S %p')}}

2012-01-19 05:21:00 PM

• タイムゾーン変換 - 指定されたタイムゾーンで日付と時刻を表示し、指定された分数を時刻に追加します。

方法:

dateTimeFormatter(tzOffset=-330)
dateTimeFormatter(timeZone='Asia/Kolkata')

使用
{{ "2012-01-19 17:21:00 CST" |dateTimeFormatter(tzOffset=-330)}}
{{ "2012-01-19 17:21:00 CST" |dateTimeFormatter(timeZone='Asia/Kolkata')}}

出力：

2012-01-19 11:51:00 AM
2012-01-19 22:51:00 PM

詳細については、次を参照してください： https://strftime.org/

取り消し線のテキスト

これにより、テキストに取り消し線を引くことができます。例えば、商品の古い価格を取り消し線で表示したい場合。

入力 : 価格 USD 100

出力 : 価格 USD 100

価格 USD <s>{{100}}</s>

コンテンツの中断

これにより、アイテムのリストをループし、ループの実行を正確に制御できます。特定のアイテムを完全に処理したくない場合は continue を使用してスキップすることができ、特定の条件が満たされた場合には 壊すを使用してループ全体を途中で停止することができます。

例えば、ホームページに最近の記事を表示するために、`continue`は「ドラフト」記事をスキップし、`break`は最初の「特集」記事の後でリストを停止することで、ページが長くなりすぎるのを防ぐことができます。

 {% for item in my_list %}
    BEFORE: {{ item }}

    {% if item == continue_condition %}
        SKIPPING (simulating continue)
        {% continue %}
    {% endif %}
    
    {% if item == stop_condition %}
        BREAKING
        {% break %}
    {% endif %}
    
    AFTER: {{ item }}
{% endfor %}
  

 {
  "my_list": [
    "apple",
    "continue_value",
    "banana",
    "stop_value",
    "cherry",
    "date"
  ],
  "continue_condition": "continue_value",
  "stop_condition": "stop_value"
}

    BEFORE: apple
    AFTER: apple
    BEFORE: continue_value
    SKIPPING (simulating continue)
    BEFORE: banana
    AFTER: banana
    BEFORE: stop_value
    BREAKING

• "stop_value"に遭遇したとき、{% break %}ステートメントはループを停止し、「cherry」と「date」は処理されません。
• 「continue_value」が見つかった場合、{% continue %} ステートメントは、その特定の反復のループブロック内でコード実行の残りをスキップします。

暗号化と復号化

SHA 256暗号化

Jinjaは現在、2つの方法でSHA 256暗号化をサポートしています。

秘密鍵を用いたSHA256 - 秘密鍵を用いて文字列をSHA256で暗号化します

使用 ( ここで6ABC89W3XY9Wは秘密鍵です )
{{UserEmail|convertToSHA256('6ABC89P3FXYW')}}

例
MoEngageでユーザーのメールIDをSHA256で暗号化したいとします。
{%set UserEmail=UserAttribute['Email']%}{{UserEmail|convertToSHA256('6ABC89P3FXYW')}}

シークレットキーなしのSHA256 - 文字列をSHA256で暗号化します

使用
{{UserEmail|convertToSHA256NoSalt()}}

例

{%set UserEmail=UserAttribute['Email']%}{{UserEmail|convertToSHA256NoSalt()}}

Base64エンコーディング

文字列をBase64エンコーディングを使用して暗号化します。

使用
{{UserEmail|base64encode}}

Base64デコード

文字列をBase64デコードを使用して暗号化します。

使用
{{UserEmail|base64decode}}

URLエンコーディング

文字列をURLエンコーディングで暗号化します。

使用
{{UserEmail|urlencode}}

URLデコード

文字列をURLデコードを使用して暗号化します。

使用
{{UserEmail|urldecode}}

その他のオペレーター

次の演算子は非常に便利ですが、他の2つのカテゴリには当てはまりません。