> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# メッセージ通知テンプレート

> YiDAプラットフォームでDingTalkメッセージ通知やタスクを配信するテンプレートの設定手順を解説します。通常メッセージやDingTalkタスクなどのテンプレートタイプ、変数を活用したメッセージ本文のカスタマイズ方法まで、業務フローの通知運用に必要な情報を紹介します。

メッセージ通知テンプレートは、フォームの作業フローが特定のノードに到達した際に、事前に設定した通知テンプレートに基づき、指定したユーザーへDingTalkメッセージ通知やタスクを送信するために使用します。本記事では、メッセージ通知テンプレートの設定方法について説明します。

| 機能            | Freeプラン | ベーシック版 | プロフェッショナル版 | 専用版 |
| ------------- | ------- | ------ | ---------- | --- |
| メッセージ通知テンプレート | 非対応     | 対応     | 対応         | 対応  |

## メッセージテンプレートの設定

<Steps>
  <Step title="ステップ1">
    管理者として [YiDAワークベンチ](https://www.yidaapps.com/workPlatform) にログインします。
  </Step>

  <Step title="ステップ2">
    右上のプラットフォーム管理ボタンをクリックし、プラットフォーム管理ページに移動します。
  </Step>
</Steps>

<Steps>
  <Step title="左側メニューで「メッセージ通知テンプレート」をクリックします" />

  <Step title="「テンプレート作成」をクリックし、以下の内容を参考にテンプレートを設定した後、「確認」をクリックしてテンプレートの作成を完了します" />
</Steps>

<table>
  <tr>
    <td>属性</td>
    <td>説明</td>
  </tr>

  <tr>
    <td>テンプレート名</td>
    <td>作成するメッセージテンプレートの名前を入力します。</td>
  </tr>

  <tr>
    <td>管理者</td>
    <td>このメッセージテンプレートの管理者です。複数の管理者を設定できます。</td>
  </tr>

  <tr>
    <td rowSpan={2}>テンプレートタイプ</td>
    <td>**通常メッセージ**：現在はDingTalkメッセージ通知の送信のみに対応しています。<br /><ul><li>**メッセージタイトル**：メッセージ通知のタイトルです。このタイトルはチャット一覧およびチャット画面の両方に表示されます。</li><li>**メッセージ本文**：プッシュ配信されるメッセージの本文です。メッセージ本文では変数を設定できます。各変数はフォームコンポーネントのIDであり、`$!{Field ID}` の形式で記述します。メッセージ送信時に、YiDAが自動的に変数をフォームコンポーネントの値に置き換えます。詳細は [組み込み変数フォーマット](/ja/yida/platform-admin/fkfhud) を参照してください。</li></ul></td>
  </tr>

  <tr>
    <td>**DingTalkタスク**：DingTalkタスク通知タイプは現在、ベーシック版以上でのみ利用可能です。詳細は [エディションの違い](https://www.yidaapps.com/pricing) を参照してください。<br /><ul><li>**メッセージタイトル**：タスクのタイトルです。</li><li>**メッセージ本文**：タスクの詳細内容です。変数の設定に対応しています。各変数はフォームコンポーネントのIDであり、`$!{Field ID}` の形式で記述します。メッセージ送信時に、YiDAが自動的に変数をフォームコンポーネントの値に置き換えます。詳細は [組み込み変数フォーマット](/ja/yida/platform-admin/fkfhud) を参照してください。</li></ul><br />**注意**：各組織で作成できるDingTalkタスクテンプレートは最大200件です。この上限を超えるとエラーが発生します。</td>
  </tr>
</table>

## メッセージテンプレートの使用

メッセージテンプレートは以下の2つの方法で使用できます。

* 方法1：ワークフローフォームのワークフロー設計における「メッセージ通知」ノードで使用します。詳細は「メッセージ通知ノード」を参照してください。
* 方法2：フォームページ設定でメッセージテンプレートを使用します。詳細は「フォームメッセージ通知」を参照してください。

<Note>
  通常フォームは現在、DingTalkタスクタイプのメッセージテンプレートには対応していません。
</Note>

## 組み込み変数フォーマット

メッセージテンプレートのメッセージ本文では変数を設定できます。各変数はフォームコンポーネントのIDであり、`$!{Component ID}` の形式で記述します。メッセージ送信時に、YiDAが自動的に変数をフォームコンポーネントの値に置き換えます。

| 変数                       | フィールド              | フォーム | 作業フロー |
| ------------------------ | ------------------ | ---- | ----- |
| \$!\{formInstId}         | インスタンスID           | ✓    | ✓     |
| \$!\{formUuid}           | フォームコード            | ✓    | ✓     |
| \$!\{formTitle}          | フォーム名              | ✓    | ✓     |
| \$!\{formTitleEn}        | フォームの英語名           | ✓    | ✓     |
| \$!\{title}              | フォームインスタンスのタイトル    | ✓    | ✓     |
| \$!\{titleEn}            | フォームインスタンスの英語タイトル  | ✓    | ✓     |
| \$!\{creator}            | 作成者の社員番号           | ✓    | ✓     |
| \$!\{originator}         | 起票者の社員番号           | ✓    | ✓     |
| \$!\{originatorName}     | 起票者の名前             | ✓    | ✓     |
| \$!\{originatorNameEn}   | 起票者の英語名            | ✓    | ✓     |
| \$!\{serialNo}           | シリアル番号             | ✓    | ✓     |
| \$!\{createTime}         | 作成時間               | ✓    | ✓     |
| \$!\{modifiedTime}       | 編集時間               | ✓    | ✓     |
| \$!\{processInstStatus}  | ワークフローインスタンスのステータス | ✗    | ✓     |
| \$!\{approvedResult}     | 承認結果               | ✗    | ✓     |
| \$!\{approvedResultCode} | 承認結果コード            | ✗    | ✓     |
