# direct通知設定 ## **direct通知とは？** {% hint style="info" %} 「direct」とは、L is B社の展開するビジネスチャットサービスです。\ 詳細は、下記サイトをご参照ください。※外部サイトです。 ▼direct／ダイレクト {% endhint %} i-Reporterアプリで帳票を作成しConMasサーバーへ保存したタイミングなど、i-Reporterでのいくつかの運用タイミングにおいて、directへメッセージを送ることができます。【通知例】\ 帳票の承認を申請したとき、あらかじめ設定されたdirectユーザー・グループへ、その申請の通知メッセージが届きます。\ 承認者はメッセージ内に含まれた帳票のURLから該当する帳票を起動し、承認を行うことができます。

## **direct通知パターン** * **申請・差し戻し・承認通知**\ 「承認クラスター」を申請・差し戻し・承認に変更した時にメッセージを通知します。
* **編集保存通知**\ i-Reporterアプリより入力帳票を「サーバーへ保存し編集継続」、「サーバーへ保存し編集終了」した時に、メッセージを通知します。
* **完了通知**\ 入力帳票を「完了保存」した時にメッセージを通知します。
* **変更通知**\ クラスターの入力値が変更された時に、メッセージを通知します。\ ※入力値が特定の条件になった場合にだけ通知するよう設定することができます。
* **端末申請・承認通知**\ 端末登録の申請・承認の各タイミングでメッセージを通知します。
* **定義申請・差し戻し・承認通知**\ 帳票定義の公開における申請・差し戻し・承認の各タイミングでメッセージを通知します。
* **スケジュール登録通知**\ ユーザー別の作業スケジュールの登録・変更の各タイミングでメッセージを通知します。 {% hint style="success" %} 通知する宛先・メッセージ内容は、通知種類ごとに個別設定可能です。 {% endhint %} ## **direct通知設定の流れ**

## **１．アプリケーション登録** directのアプリケーションページで、ConMas Managerを登録します。\ 予め、通知元となるdirectのユーザーを作成しておきます。(ユーザーの役割は「管理者」または「所有者」) 【手順】 1. 通知元ユーザーでdirectのWebサイトにログインし、\ アプリケーションページにアクセスします。

【注意事項】

通知元となるdirectのユーザーが「ConMasManager」となります。
このユーザーにはConMasManagerからは通知できません。

2. ConMas Managerの情報を登録します。

【URLの記述例】
**Cimtopsクラウド版(お試し環境を含む)のURL記述例**\ ・識別子：0001 の場合\ `https://conmas-i-reporter.com/ConMasManager0001`

[識別子]は弊社クラウド版(お試し環境を含む)のお客様のみ設定する必要があります。
[識別子]は、お客様がご利用中のConMas Manager URLから確認することができます。

■ConMas ManagerのURLが下記の場合

https://conmas-i-reporter.com/ConMasManager0001
　→識別子は 0001 の部分です。

https://conmas-i-reporter.com/ConMasManager0002
　→識別子は 0002 の部分です。

\ **オンプレミス環境のURL記述例**\ ・サーバーホスト名：hogehoge.co.jp\ ・ポート：８０\ の場合、\ `http://hogehoge.co.jp/ConMasManager`\
3. 登録に成功するとOpenID Connect 認証情報が表示されるので、「サイトURL」、「Client ID」、「Client Secret」の3点を控えておきます。\ ※次の「2. アプリケーション連携設定」で必要になります。

## **2．アプリケーション連携設定** ConMas Managerでdirectの情報を登録します。【手順】 1. ConMas Managerの上部メニュー「システム管理」＞「direct通知設定」＞「▼アプリケーション連携設定」の「編集」ボタンをクリックし、アプリケーション連携設定を編集します。

2. 「1. アプリケーション登録」で控えた、「サイトURL」、「Client ID」、「Client Secret」の3点の情報を入力します。

「リダイレクトURL」にはdirectアプリケーション登録時の「リダイレクトURL」ではなく、「サイトURL」の方を入力します。

3. directのアプリケーションの利用確認ページが表示されるので、「承認する」をクリックして承認します。 \ directに未ログインの場合はdirectのログインページが表示されるので、通知元ユーザーでログインします。\ 通知元ユーザー以外でdirectにログインしている場合は一旦ログアウトし、「アプリケーション連携設定」の手順1からやり直します。

4. アプリケーション連携処理が完了するとステータスが「連携済み」になります。 \ directユーザーに通知元となるdirectのユーザーの名称が表示されます。 \ 内容を変更したい場合は、再度編集して登録し直すことが可能です。

## **3．通知設定** 各通知の有効化・無効化を設定します。\ direct通知設定から通知設定を編集します。【手順】 1. ConMas Managerの上部メニュー「システム管理」＞「direct通知設定」＞「▼通知設定」の「編集」ボタンをクリックします。

2. 通知する場合は「通知する」を選択します。「通知しない」になっている場合は通知されません。

## **4．テンプレート作成** 各通知のメッセージ内容、送信先を設定します。\ direct通知設定から通知設定を新規作成・編集します。【手順】 1. ConMas Managerの上部メニュー「システム管理」＞「direct通知設定」をクリックします。\ テンプレートを新規作成する場合は、各通知設定欄右側の「追加(＋)」ボタンをクリックします。\ 既存の通知テンプレートを編集する場合は、編集したいテンプレート名をクリックします。

2. 「テンプレート登録/編集」画面で、各項目を入力します。 * **テンプレート名称：**\ テンプレート名称を入力します。 * **メッセージ本文：**\ メッセージ本文を入力します。\ 置き換え文字が仕様できます。\ 置き換え文字については、後述の「[置き換え文字](#kie)」をご参照ください。 * **デフォルトテンプレート：**\ デフォルトテンプレートにする場合はチェックします。\ デフォルトテンプレートについては、後述の「[デフォルトテンプレート](#deforutotenpurto)」をご参照ください。 * **送信先：**\ 送信先の種類を選択します。\ 送信先については、後述の「[送信先](#song-xin-xian)」をご参照ください。 \ 入力完了後、「登録」をクリックします。

## **置き換え文字** メッセージ本文に{}で囲まれた定義済みの文字列を入力すると、メッセージ通知時に、サーバーに保存された情報で置換されます。使用できるコードは通知種類によって異なります。\ 「置き換え文字一覧」をご参照ください。このコードを使用して入力帳票のURL等を通知することができます。 \ 「帳票URLの埋め込み」をご参照ください。【設定例】

### **置き換え文字一覧** 申請通知・差戻通知・承認通知・変更通知

置き換え文字	置き換え内容
{rep_top_id}	帳票ID
{rep_top_name}	帳票名称
{report_type}	帳票種別
{public_status}	公開ステータス
{rep_sheet_id}	シート帳票ID
{rep_sheet_name}	シート帳票名称
{rep_sheet_no}	帳票内ページ番号
{cluster_id}	クラスターID
{cluster_name}	クラスター名称
{cluster_type}	クラスター種類
{input_value}	入力値
{display_value}	表示用文字列
{applicant}	申請者ID
{applicant_name}	申請者名
{applicant_comment}	申請コメント
{applicant_date}	申請日
{approver}	承認者ID
{approver_name}	承認者名
{approver_comment}	承認コメント
{approver_date}	承認・差し戻し日
{sys_update_time}	更新日時
{user_id}	更新者ID
{user_name}	更新者名
{top_remarks1}～{top_remarks10}	備考情報1～備考情報10
{system_key1} ～{system_key5}	システムキー1 ～システムキー5

編集保存通知・完了通知 | 置き換え文字 | 置き換え内容 | | ---------------------------------- | ----------------- | | {rep\_top\_id} | 帳票ID | | {rep\_top\_name} | 帳票名称 | | {report\_type} | 帳票種別 | | {public\_status} | 公開ステータス | | {sys\_update\_time} | 更新日時 | | {user\_id} | 更新者ID | | {user\_name} | 更新者名 | | {top\_remarks1} ～ {top\_remarks10} | 備考情報1 ～備考情報10 | | {system\_key1} ～ {system\_key5} | システムキー1 ～システムキー5 | 端末申請通知 | 置き換え文字 | 置き換え内容 | | ------------ | ------ | | {user\_id} | 更新者ID | | {user\_name} | 更新者名 | 端末承認通知 | 置き換え文字 | 置き換え内容 | | ------------------------ | ------ | | {terminal\_id} | 端末ID | | {terminal\_name} | 端末名称 | | {terminal\_physical\_id} | 端末物理ID | | {applicant} | 申請者ID | | {applicant\_name} | 申請者名 | | {applicant\_time} | 申請日 | | {applicant\_comment} | 申請コメント | 定義申請通知・定義差戻通知・定義承認通知 | 置き換え文字 | 置き換え内容 | | ------------------------- | -------- | | {def\_top\_id} | 定義ID | | {def\_top\_name} | 定義名称 | | {def\_applicant} | 定義申請者ID | | {def\_applicant\_name} | 定義申請者名 | | {def\_applicant\_date} | 定義申請日時 | | {def\_applicant\_comment} | 定義申請コメント | | {def\_approver} | 定義承認者ID | | {def\_approver\_name} | 定義承認者名 | | {def\_approver\_date} | 定義承認日時 | | {def\_approver\_comment} | 定義承認コメント | | {sys\_update\_time} | 更新日時 | | {user\_id} | 更新者 | | {user\_name} | 更新者名 | スケジュール登録通知 | 置き換え文字 | 置き換え内容 | | ---------------------------------- | ----------------- | | {schedule\_id} | スケジュールID | | {task\_name} | タスク名称 | | {task\_remark} | タスク内容 | | {comment1} | コメント1 | | {comment2} | コメント2 | | {start\_date} | 開始予定日時 | | {end\_date} | 終了予定日時 | | {rep\_top\_id} | 帳票ID | | {rep\_top\_name} | 帳票名称 | | {sys\_update\_time} | 更新日時 | | {user\_id} | 更新者 | | {user\_name} | 更新者名 | | {top\_remarks1} ～ {top\_remarks10} | 備考情報1 ～備考情報10 | | {system\_key1} ～ {system\_key5} | システムキー1 ～システムキー5 | ### **帳票URLの埋め込み** 入力帳票詳細ページのURLをコピーして、帳票ID部分を置き換え文字にします。【手順】 1. ConMas Managerの「入力帳票」より、適当な入力帳票を選択して「入力帳票詳細」画面を開きます。 2. 「入力帳票詳細」画面のURLをコピーし、テンプレートのメッセージ本文に貼り付けます。 3. URLの末尾にある数字部分（コピー元入力帳票の帳票ID）を削除し、置き換え文字「{rep\_top\_id}」に変更します。

## **デフォルトテンプレート** 通知種類によって、帳票単位にテンプレートを設定できるもの、クラスター単位にテンプレートを設定できるものがあります。デフォルトテンプレートを設定すると、帳票単位/クラスター単位のテンプレートが設定されていない場合に、デフォルトテンプレートで通知されます。デフォルトテンプレートと帳票単位/クラスター単位のテンプレートの両方が設定されている場合は、帳票単位/クラスター単位のテンプレートで通知されます。デフォルトテンプレートのみの通知種類は、デフォルトテンプレートが設定されていないと通知されません。

## **送信先** 送信先をコンボボックスで選択します。 \ 通知種類によって設定できる送信先が異なります。

送信先	対象ユーザー	対象通知種類
直接入力	通知するdirectユーザーのメールアドレスを直接指定(※1)	すべて
ログインユーザー	入力帳票を保存する等、通知の契機となる操作をしたユーザー	すべて
申請者	承認クラスターを申請したユーザー	申請通知・差戻通知・承認通知・変更通知(※3)
承認者	承認クラスターを承認したユーザー	申請通知・差戻通知・承認通知・変更通知(※3)
クラスター権限グループ	対象クラスターに編集権限を持つグループの所属ユーザー	申請通知・差戻通知・承認通知・変更通知(※3)
帳票権限グループ	対象帳票に編集権限を持つグループの所属ユーザー	申請通知・差戻通知・承認通知・変更通知(※3)
帳票備考1～10	備考に設定されたメールアドレスのdirectユーザー(※1)	申請通知・差戻通知・承認通知・変更通知(※3)
入力値	クラスターに入力されたメールアドレスのdirectユーザー(※1)	変更通知
定義申請者	帳票定義の公開を申請したユーザー	定義申請通知・定義差戻通知・定義承認通知
定義承認者	帳票定義公開権限を持ち、対象の帳票定義に編集権限を持つグループの所属ユーザー	定義申請通知・定義差戻通知・定義承認通知
定義編集権限保有者	対象の帳票定義に編集権限を持つグループの所属ユーザー	定義申請通知・定義差戻通知・定義承認通知
起票権限保有者	対象の帳票定義に帳票作成権限を持つグループの所属ユーザー	定義申請通知・定義差戻通知・定義承認通知
端末申請者	端末登録の申請をしたユーザー	端末承認通知
スケジュール担当者	対象のスケジュールに設定されたユーザー	スケジュール登録通知
グループトーク名	通知するdirectのグループトーク名を指定(※1,2)	すべて

※1\ 通知対象のdirectの組織を合わせて選択します。\ 組織選択コンボボックスには通知元ユーザーが管理者となっている組織名の一覧が表示されます。 ※2\ グループのメンバーに通知元ユーザーが含まれている必要があります。 ※3\ 申請通知時に承認者へ通知する場合は、「クラスター権限グループ」を指定します。なお、クラスター権限設定が必要です。 {% hint style="success" %} * 1つのテンプレート内で同一の送信先種類に同一ユーザーが複数存在する場合は、1ユーザーに対してメッセージは 1つのみ通知されます。 * 1つのテンプレート内に異なる送信先種類で同一ユーザーが複数存在する場合は、送信先種類毎にメッセージが通知されます。 {% endhint %} ## **テスト送信** テスト送信を使用すると、直接directユーザーを指定して入力したメッセージ本文を即時通知することができます。通知対象のdirect組織とdirectユーザーのメールアドレスを指定します。 \ 置き換え文字は置換されずにそのまま通知されます。

## **5．directユーザー登録** ConMas Manager登録ユーザーにdirectのユーザーを紐付けます。 * directのユーザーはメールアドレスで識別します。\ そのためメールアドレスのないdirectユーザーは登録できません。 * 1ユーザーに対してdirectユーザーを5ユーザーまで登録することができます。 * ユーザーが通知対象になった場合、登録したすべてのdirectユーザーに通知されます。 * ユーザーにdirectのトークグループを登録することも可能です。 * ユーザー管理の「direct連携」メニューはアプリケーション連携設定のステータスが「連携済み」の場合に表示されます。【手順】 1. ConMas Managerの上部メニュー「システム管理」＞「ユーザー管理＞ direct連携」をクリックします。\ 「ユーザー管理 - direct連携」画面で、対象のユーザー名をクリックします。

2. 「ユーザー direct連携参照」画面にて、画面右上の「編集」アイコンをクリックして編集画面を開きます。

3. directのユーザーを設定します。\ ユーザー検索から選択または直接メールアドレスを入力します。

4. directのグループトークを設定します。\ グループトーク検索から選択します。 \ 通知元ユーザーが含まれているグループのみ検索できます。

5. directのユーザーを一括設定します。\ i-Reporterとdirectで同じメールアドレスを使用している場合、ConMas Managerのユーザー管理に設定済みのメールアドレスを一括でdirectユーザーのメールアドレスにコピーすることができます。　

## **6．帳票定義にテンプレートを設定** 帳票定義に通知テンプレートを設定します。編集保存・完了通知は帳票定義単位にテンプレートを設定することができます。\ 詳細は、「[編集保存・完了通知テンプレートを設定](#tenpurtowo)」をご参照ください。申請・差戻・承認通知はクラスター単位にテンプレートを設定することができます。\ 詳細は、「[申請・差戻・承認通知テンプレートを設定](#tenpurtowo-1)」をご参照ください。変更通知は承認、画像系以外のクラスター単位にテンプレートを設定することができます。\ 詳細は、「[変更通知テンプレートを設定](#tenpurtowo-2)」をご参照ください。

### **編集保存・完了通知テンプレートを設定** 帳票定義に編集保存・完了通知テンプレートを設定します。\ 帳票定義の「基本情報編集」画面でテンプレートを選択します。 \ テンプレートは複数設定することができます。 direct通知テンプレート項目はアプリケーション連携設定のステータスが「連携済み」の場合に表示されます。

{% hint style="success" %} Ctrlキーを押しながらクリックすることで複数項目の選択・解除ができます。 {% endhint %} ### **申請・差戻・承認通知テンプレートを設定** 帳票定義に申請・差戻・承認通知テンプレートを設定します。\ 帳票定義の「direct通知設定」画面で、クラスターごとにテンプレートを選択します。 \ テンプレートは複数設定することができます。「direct通知設定」メニューはアプリケーション連携設定のステータスが「連携済み」の場合に表示されます。

{% hint style="success" %} Ctrlキーを押しながらクリックすることで複数項目の選択・解除ができます。 {% endhint %} ### **変更通知テンプレートを設定** 帳票定義に変更通知テンプレートを設定します。\ 帳票定義のdirect通知設定画面でクラスター毎にテンプレートを選択します。 \ テンプレートは複数設定することができます。

{% hint style="success" %} Ctrlキーを押しながらクリックすることで複数項目の選択・解除ができます。 {% endhint %} ## **変更通知の条件設定** クラスターの変更による通知条件作成・査閲クラスターを除き、変更通知テンプレートがセット可能クラスターについては、変更通知条件が設定できます。 \ 変更通知条件を設定すると、クラスターの入力値が“ある値”になった時のみ通知することが可能になります。通知条件は、クラスターの種別毎に設定できる通知条件が異なります。 \ 通知条件を設定していない場合は、クラスター入力値が変更された場合にすべて通知します。

### **キーワード条件** クラスター入力値に設定したキーワードが含まれていれば、メッセージを通知します。\ キーワードは、１０個まで設定可能です。 **設定可能なクラスター種別** * キーボードテキスト * 手書きデジタル **入力値がクリアされた時**\ チェックすると入力値をクリアした時に通知されます。\ ※設定すると、キーワード設定はクリアされます。

### **範囲条件** クラスター入力値が設定したFrom,To範囲内又は一致した時にメッセージを通知します。\ From、Toにはそれぞれ、条件が設定可能です。 * From条件 * に等しい\ 入力値がFrom値に等しい時に通知します。符号= * より大きい\ 入力値がFrom値より大きい時に通知します。符号< * 以上\ 入力値がFrom値以上の時に通知します。符号≦ * To条件 * より小さい\ 入力値がTo値より小さい時に通知を行います。符号> * 以下\ 入力値がTo値以下の時に通知します。符号≧

**設定可能なクラスター種別** * 数値選択 * 数値 * 時間数 * 年月日 * カレンダー年月日 * 時刻 * トグル集計 * 計算式 **入力値がクリアされた時**\ チェックすると入力値をクリアした時に通知されます。\ ※設定すると範囲設定はクリアされます。 ### **チェック条件** クラスター入力値が設定した条件に、当てはまるとメッセージを通知します。\ 設定値には「選択値」と「条件」があり、この２つを組み合わせて条件設定を行います。 * 選択値\ クラスター入力値を選択します。\ チェッククラスターの場合は、「チェックあり」のみが選択出来ます。
* 条件 * に一致する * に一致しない **設定可能なクラスター種別** * チェック **入力値がクリアされた時**\ チェックすると入力値をクリアした時に通知されます。\ ※設定すると、選択条件設定はクリアされます。

### **選択条件** クラスター入力値が設定した条件に、当てはまるとメッセージを通知します。\ 設定値には「選択値」と「条件」があり、この２つを組み合わせて条件設定を行います。 * 選択値\ クラスター入力値を選択します。 * 条件 * に一致する * に一致しない **設定可能なクラスター種別** * 単一選択 * トグル選択

### **複数選択条件** クラスター入力値が設定した条件に、当てはまるとメッセージを通知します。\ 設定値には「選択値」と「条件」があり、この２つを組み合わせて条件設定を行います。 * 選択値\ クラスター入力値を選択します。
* 条件 * に一致する * に一致しない * のいずれかを含む * のいずれも含まない **設定可能なクラスター種別** * 複数選択 **入力値がクリアされた時**\ チェックすると入力値をクリアした時に通知されます。\ ※設定すると、複数選択条件設定はクリアされます。

## **7．入力帳票にテンプレートを設定** 入力帳票ごとに個別に通知テンプレート・変更通知条件を変更することもできます。通知テンプレート・変更通知条件設定を行った帳票定義から入力帳票を作成すると、設定情報が入力帳票に引き継がれます。 \ 入力帳票ごとに個別に通知設定を変更したい場合は、帳票定義ではなく、入力帳票の通知設定を編集します。

### **編集保存・完了通知テンプレートを変更** 入力帳票に設定されている編集保存・完了通知テンプレートを変更します。\ 入力帳票の「基本情報編集」画面でテンプレートを選択します。 \ テンプレートは複数設定することができます。 direct通知テンプレート項目はアプリケーション連携設定のステータスが「連携済み」の場合に表示されます。

{% hint style="success" %} Ctrlキーを押しながらクリックすることで複数項目の選択・解除ができます。 {% endhint %} ### **申請・差戻・承認通知テンプレートを変更** 入力帳票に設定されている申請・差戻・承認通知テンプレートを変更します。\ 入力帳票の「direct通知設定」画面でクラスター毎にテンプレートを選択します。 \ テンプレートは複数設定することができます。「direct通知設定」メニューはアプリケーション連携設定のステータスが「連携済み」の場合に表示されます。

{% hint style="success" %} Ctrlキーを押しながらクリックすることで複数項目の選択・解除ができます。 {% endhint %} ### **通知条件を変更** 入力帳票に設定されている変更通知テンプレート・通知条件を変更します。\ 入力帳票のdirect通知設定画面でクラスター毎にテンプレートを選択、通知条件の設定をします。 \ テンプレートは複数設定することができます。

{% hint style="success" %} Ctrlキーを押しながらクリックすることで複数項目の選択・解除ができます。 {% endhint %} ## **8．送信履歴** direct通知の履歴を検索、参照します。\ 検索条件を“Truncated to 100,000 records.”指定して絞り込むことができます。 \ 検索結果から再送信、削除、CSV出力ができます。「送信履歴」メニューはアプリケーション連携設定のステータスが「連携済み」の場合に表示されます。一度に出力できる最大件数を超えると、CSVファイルの最後に下記のメッセージが追加されます。 {% hint style="warning" %} “Truncated to 100,000 records.” {% endhint %} 最大件数以上のデータを出力したい場合は、一度出力した後、検索条件を変更して再度出力してください。