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を使って勤怠管理の提出を忘れないようにしたい！