1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

// Garoon のメール送信前イベント
garoon.events.on('mail.mail.send.submit', (event) => {
  // メールのデータを取得
  const mail = event.mail;
  if (mail.subject === '') {
    // event.error に値を設定して return event すると、エラーダイアログを表示し、メール送信を中止します。
    event.error = '「標題」を入力してください';
  }
  // return event によって画面に反映する
  return event;
});

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

/*
 * Garoon mail.submit sample program (check including attachment)
 * Copyright (c) 2020 Cybozu
 *
 * Licensed under the MIT License
 * https://opensource.org/license/mit/
 */
(function() {
  'use strict';

  const CONFIRM_DIALOG_DESCRIPTION = 'xxx です。送信してもよろしいですか？'; // 確認ダイアログに表示する文言
  const GAROON_ERROR_DIALOG_DESCRIPTION = 'xxx を確認してください'; // Garoon のエラーダイアログの文言

  // 確認ダイアログを表示するかを判定する関数
  // ---------------- ここから ----------------
  /*
   * @param {Object} Garoon メールオブジェクト
   * @return {boolean} 確認ダイアログを表示する場合 true を返す
   */
  const shouldWarning = function(mail) {
    // ここに判定ロジックを書く
  };
  // ---------------- ここまで ----------------


  // メール送信前イベント
  garoon.events.on('mail.mail.send.submit', (event) => {
    // メールのデータを取得
    const mail = event.mail;

    if (shouldWarning(mail)) {
      // 警告すべきであったら確認ダイアログを表示する
      const result = window.confirm(CONFIRM_DIALOG_DESCRIPTION);
      // [キャンセル]ボタンをクリックしたら、エラーダイアログを表示・メール送信を中止し、メール作成画面に戻る
      if (!result) {
        event.error = GAROON_ERROR_DIALOG_DESCRIPTION;
      }
    }
    return event;
  });
})();

11
12

const CONFIRM_DIALOG_DESCRIPTION = '社外のメールアドレスが含まれています。送信してもよろしいですか？';
const GAROON_ERROR_DIALOG_DESCRIPTION = '宛先のメールアドレスを確認してください';

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

// 自社ドメインを設定
const OWN_DOMAIN = 'cybozu.co.jp';

/**
   * ドメイン部分を取得する
   * @param {string} mailAddress メールアドレス
   * @returns {string} ドメイン部分
   */
const extractDomain = function(mailAddress) {
  const result = mailAddress.split('@');
  return result.length >= 2 ? result[1] : null;
};

/**
   * 他社ドメインのメールアドレスを含むか
   * @param {Object[]} destinations 宛先の配列
   * @returns {boolean} 他社ドメインのメールアドレスを含む場合は true
   */
const hasOtherDomain = function(destinations) {
  let isOtherDomain = false;
  destinations.forEach((destination) => {
    const domain = extractDomain(destination.mailAddress);
    if (domain && OWN_DOMAIN !== domain) {
      isOtherDomain = true;
    }
  });
  return isOtherDomain;
};

/**
   * 確認ダイアログを出すかどうかを判定する関数
   * @param {Object} Garoon メールオブジェクト
   * @return {boolean} 確認ダイアログを表示する場合 true を返す
   */
const shouldWarning = function(mail) {
  // to/cc/bcc に自社ドメインが含まれていたら確認ダイアログを表示する
  return hasOtherDomain(mail.to) || hasOtherDomain(mail.cc) || hasOtherDomain(mail.bcc);
};

11
12
13
14
15
16
17

// 添付ファイルのサイズ上限(MBで指定)
const OVER_SIZE = 1;
// KBに再計算
const overSizeKB = OVER_SIZE * 1024;

const CONFIRM_DIALOG_DESCRIPTION = 'サイズ上限（' + OVER_SIZE + 'MB）を超える添付ファイルが含まれています。送信してもよろしいですか？';
const GAROON_ERROR_DIALOG_DESCRIPTION = '添付ファイルを確認してください';

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

/**
   * 規定サイズ以上の添付ファイルがあるか
   * @param {Object[]} attachments 添付ファイルオブジェクトの配列
   * @return {string[]} 規定サイズを超えていたら true
   */
const hasOverSizeAttachment = function(attachments) {
  let isOverSizeAttachemnt = false;
  attachments.forEach((attachment) => {
    if (attachment.size > overSizeKB) {
      isOverSizeAttachemnt = true;
    }
  });
  return isOverSizeAttachemnt;
};

/**
   * 確認ダイアログを出すかどうかを判定する関数
   * @param {Object} Garoon メールオブジェクト
   * @return {boolean} 確認ダイアログを表示する場合 true を返す
   */
const shouldWarning = function(mail) {
  // 添付ファイルのサイズがサイズ上限を超えていたら確認ダイアログを表示する
  return hasOverSizeAttachment(mail.attachments);
};