やりたいこと
今、irucaで勤務ステータスの管理をしていて、PCのログインログアウトで自動打刻している。（誰かが作ってくれたらしい、ありがとう。）
個人的には、trelloのかんばんボードを使って「よし、これから手をつけるぞ！」って思ったタイミングが業務開始の方がしっくりくる。
→かんばんボードで「勤怠報告（出勤）」「勤怠報告（退勤）」を「完了」リストに移動したときに、irucaのステータス更新をしてみることにする。
勤怠システムの打刻、とかでもありだと思う。（実はこれを目指してた）
概要
- Trelloのイベントを取得する仕組みは以下の通り。
POSTパラメータからの処理
長いのでリンクで、、、
https://github.com/prettyhappycatty/gas_trello_iruca/blob/main/doPost.gs
- カードのイベントを確認（移動でなければリターン）
- カードのタイトルを確認（「勤怠報告」かどうか）
- 勤怠報告（出勤）ならirucaの出勤メソッドを呼び、iruca連携済みラベルを追加
- 勤怠報告（出勤）ならirucaの退勤メソッドを呼び、iruca連携済みラベルを追加
iruca出勤メソッドと退勤メソッド
管理→ルーム設定→外部連携→API連携情報
- ROOM_CODE irucaのルームコード
- MEMBER_ID 変更したいメンバーのメンバーID
doPostから呼び出している関数2つ
iruca.gs
//出勤用
function sendIrucaEntry(member_id, room_code, dt_str) {
var requestUrl = "https://iruca.co/api/rooms/"+room_code+"/members/"+member_id
requestBody = mkIrucaPostData('在席') //在席、退社
// POSTオプション
var options = {
"method":"PUT",
'headers': {'ContentType': 'application/json'},
"payload":requestBody,
muteHttpExceptions: true
};
var res = UrlFetchApp.fetch( requestUrl , options );
}
//退勤用
function sendIrucaExit(member_id, room_code, dt_str) {
var requestUrl = "https://iruca.co/api/rooms/"+room_code+"/members/"+member_id
requestBody = mkIrucaPostData('退社') //在席、退社
// POSTオプション
var options = {
"method":"PUT",
'headers': {'ContentType': 'application/json'},
"payload":requestBody,
muteHttpExceptions: true
};
var res = UrlFetchApp.fetch( requestUrl , options );
}
function mkIrucaPostData(status){
return {
"status": status,
}
}
webhookの登録
Trelloのwebhookを登録する。
Trello API リファレンスによると、webhookの登録には以下の4つの情報が必要。
- TRELLO_KEY https://trello.com/1/appKey/generate から確認
- TRELLO_TOKEN https://trello.com/1/appKey/generate から作成
- callbackUrl ※あとから作成するURLです
- boardId 自分のボードのID※以下の関数を実行して取得できます
trello.gs
function getBoards() {
let params = {
'method': 'GET',
'headers': {'ContentType': 'application/json'},
};
let requestUrl = 'https://api.trello.com/1/members/' + TRELLO_USER_ID + '/boards'
+ '?key=' + TRELLO_KEY
+ '&token=' + TRELLO_TOKEN;
let result = UrlFetchApp.fetch(requestUrl, params).getContentText();
return JSON.parse(result);
}
別記事のGASでWe作るときにハマったメモを見つつ、権限に注意してから公開してください。
公開したURLを使って、以下のwebhook登録メソッドを呼びます。
trello_webhook.gs
function createWebhook(){
var requestUrl = 'https://api.trello.com/1/tokens/' + TRELLO_TOKEN + '/webhooks/?key=' + TRELLO_KEY;
var options = {
'method' : 'post',
'headers': {'ContentType': 'application/json'},
'payload' : {
'description': 'Webhook of Trello',
'callbackURL': callbackUrl,
'idModel': boardId
},
'muteHttpExceptions' : true
}
Logger.log(UrlFetchApp.fetch(requestUrl, options));
}
完成
ソースコードは以下にあります。ちょっとずつコードの揺れを修正していくかもしれないししないかもしれない。
参照
おまけ
gasのWebアプリケーションは、新しいバージョン公開時にURLが変わるという超めんどくさい仕組みなので、旧webhookを消して新しいwebhookを登録できるようメソッドにしています。
trello_webhook.gs
/*
Webページのバージョンを変えるときに、WebhookのURLを塗り替える
動作要件：公開されているWEBページが、「全員に公開」以外の権限であること
*/
function clearAndCreateWebhook(){
id = getWebhook()
if (id){
deleteWebhook(id)
}
createWebhook()
}