GASを使って勤怠管理の提出を忘れないようにしたい！

Sun, 03 Dec 2023 00:00:00 +0000

皆さんは日々の作業の中で提出物などはありますか？

私は月の初めの第1営業日、月の終わりから5営業日前、最終営業日に勤怠の提出があります。忘れがちな私はよく上司から提出していないと言われ、言う側も言われる側もストレスだと思い、Slackに通知が来るようなプログラムを組むことにしました。

連携で使用したアプリは以下の2つになります。

GAS(Google Apps Script)
Slack

やることは以下の順でやっていきます。

Slackに通知するためのアプリ作成
GASにコードを書いて日時実行の設定を行う
- コードの作成
- 実行トリガーの作成

アプリの作成

1つ目ですがまずはSlackのアプリ作成から始めます。こちらからアプリ作成ができます。リンク先に飛んだ後、赤枠の「Create New App」をクリックします。

この画面が出たら赤枠の「From scratch」をクリックします。

この画面が出たらアプリの名前と使用するワークスペースを設定します。仕事で使ってる人はワークスペースが所属している会社名になったりすると思います。設定が完了したら「Create App」をクリックします。

通知の設定

この画面になりますので「OAuth & Permissions」をクリックして、通知の設定をします。

次に、Scopesでアプリに与える権限の設定を行います。「Add an OAuth Scope」をクリックし、「incoming-webhook」を選択します。今回は特定のチャンネル(自身のみ)通知を送る設定なのでこちらを選択します。

ワークスペースへのインストールとURL作成

同じタブで下の方にスクロールするとこの画面が出ますので「install to Workspace」をクリックします。

次に、権限が求められますので投稿先を自身のチャンネルに設定して、「許可する」をクリックします。もし、他の人にも通知をしたい場合は、そのチャンネルに設定してください。

これで通知に必要なURLを設定することができましたので、次はコードの作成に移ります。

コードの作成

2つめのGASに関してはこちらを参考にして作り、コードのきれいさを保つため、Chat-GPTに頼みました。1つ目の設定が終わったらwebhook URLをコード内に貼り付けます。

もし、会社で特定の日が休日であればそこも考慮することができます。私は年末年始辺りの日付を入れてます。“specialHolidays"という変数に日付を入れていただけるとできます。

// Slackに特定の日の通知を送る関数
function documentAlert() {
  const today = new Date();
  // const today = new Date("2023/12/22"); // テスト用: 

  const monthEnd5Date = getLastDateOfMonth(today);
  const monthEnd1Date = getLastDateOfMonth(today);
  const monthStartDate = new Date(today.getFullYear(), today.getMonth(), 1);

  sendNotificationIfDue(today, monthEnd5Date, -5, today+"、5営業日前になりました。見込み版勤怠の提出をお願いします。");
  sendNotificationIfDue(today, monthEnd1Date, -1, today+"、最終営業日になりました。確定版勤怠の提出をお願いします。");
  sendNotificationIfDue(today, monthStartDate, 1, today+"、第一営業日になりました。自社勤怠と交通費精算の提出をお願いします。");
}

// 営業日計算関数
function dayCount(date, offsetDays) {
  let counter = 1;

  while (counter <= Math.abs(offsetDays)) {
    if (!isHoliday_(date)) counter++;
    if (counter > Math.abs(offsetDays)) break;
    date.setDate(date.getDate() + Math.sign(offsetDays));
  }
  return date;
}

// Slackに通知を送る関数
function slackSend(message) {
  const webhookUrl = "ワークスペースのWebhook URL";
  
  const payload = {
    "text": message
  };

  const options = {
    "method": "post",
    "muteHttpExceptions": true,
    "contentType": "application/json",
    "payload": JSON.stringify(payload)
  };

  UrlFetchApp.fetch(webhookUrl, options);
}

// 休日か否かを判定する関数
function isHoliday_(date) {
  if (isWeekend(date) || isHolidayEvent(date) || isSpecialHoliday(date)) {
    return true;
  }
  return false;
}

// 土日判定
function isWeekend(date) {
  const dayOfWeek = date.getDay();
  return dayOfWeek === 0 || dayOfWeek === 6;
}

// 祝日イベント判定
function isHolidayEvent(date) {
  const calendarId = "ja.japanese#holiday@group.v.calendar.google.com";
  const events = CalendarApp.getCalendarById(calendarId).getEventsForDay(date);
  return events.length > 0;
}

// 特定の休日判定
function isSpecialHoliday(date) {
  const specialHolidays = ["0101", "0102", "0103", "1229", "1230", "1231"];
  const formattedDate = Utilities.formatDate(date, "JST", "MMdd");
  return specialHolidays.includes(formattedDate);
}

// 月末最終日を取得する関数
function getLastDateOfMonth(date) {
  return new Date(date.getFullYear(), date.getMonth() + 1, 0);
}

// 特定の日に通知を送るためのヘルパー関数
function sendNotificationIfDue(today, baseDate, offsetDays, message) {
  const targetDate = dayCount(baseDate, offsetDays);
  if (isSameDay(today, targetDate)) {
    slackSend(message);
  }
}

// 二つの日付が同じ日か判定する関数
function isSameDay(date1, date2) {
  return date1.getDate() === date2.getDate();
}

実行トリガーの作成

Gas on Xainome Blog

GASを使って勤怠管理の提出を忘れないようにしたい！