GAS（Google Apps Script）活用例「Trello × Togglでタスク管理・工数管理をラクにする」

今回はTrello・TogglとGASを使ってよりタスク管理・工数管理をラクにする方法について書いています。

前半は、Trello中心の説明になっていますが、後半で実際にGASを用いたコードも載せています。（Qiitaの方にも同様の記事を掲載しております）

Trello

リスト構成

リスト名	内容
Fixed	ボードについての説明などや週ごとの振り返りなど
Backlog	いつかやる全てのタスクを放り込んでおくリスト
Tasks（1 week）	今週1週間で終えるべきタスクリスト
Tasks（1 day）	本日中に終えるべきタスクリスト
Done（1 week）	今週1週間で終えたタスクリスト
Done（All）	今までに終えた全てのタスクリスト
Repeat	繰り返しのタスクリスト
Memo	雑多なメモ

おすすめChrome拡張機能

Next Step for Trello：デフォルトでは隠れているチェックリストをカードを開かずとも確認できる。

Scrum for Trello：カードに推定作業時間と実質作業時間を追加して工数管理ができる。各タスクに工数を入力しておくことで、後から同じようなタスクを行う際に前回どれくらいの時間がかかったかを把握できるように。

Toggl Track：どのタスクにどれくらいの時間がかかったのかをTogglに記録できる（事前にTrelloとTogglを連携させる必要あり）

また、Trello for Gmailも入れています。こちらはGmailの拡張機能でメールのタスク化が楽にできるようになります。

Power-Up・Butler

TrelloにはPower-UpとButlerという機能があります。

Power-Upは、Trelloのボードをより使いやすくしてくれる機能で、無料会員の場合使える数に制限があります。

Butlerは、Trelloに組み込まれているワークフローを自動化してくれる機能ですが、こちらも無料会員の場合、使用できる回数や数に制限があります。

以下が実際に使っているPower-UpとButlerです。

Power-Up

Custom Fields

Custom Fieldsを使うことによって、チェックボックスや日付、ドロップダウンリスト、数字フィールド、テキストフィールドを自由に追加することができます。私は「進捗」「優先度」「着手日」を新規フィールドとして追加しています。

Butler

when the due date is marked as complete in a card by anyone, move the card to the top of list "🎉 Done（1 week）"

期限にチェックを入れると自動的にDone（1 week）リストの一番上に移動させるようにしています。

TrelloとGAS（Google Apps Script）を連携させる

では、実際にTrelloとGASを連携させてより便利に使えるようにしていきます！
事前に、GASで用意されているプロパティストアにTrelloのキーやトークンなどを格納しておきます。

let scriptProperties = PropertiesService.getScriptProperties();
const TRELLO_KEY = scriptProperties.getProperty('TRELLO_KEY');
const TRELLO_TOKEN = scriptProperties.getProperty('TRELLO_TOKEN');
const USER_NAME = scriptProperties.getProperty('USER_NAME');
const BOARD_ID = scriptProperties.getProperty('BOARD_ID');
const TASKS_LIST_ID = scriptProperties.getProperty('TASKS_LIST_ID');
const REPEAT_LIST_ID = scriptProperties.getProperty('REPEAT_LIST_ID');

カード作成を自動化

今回作成したのは、毎日の繰り返しタスクを毎日指定の時間に自動で作成するスクリプトです。TrelloにもCard Repeaterという繰り返しタスクを設定できるPower-Upがあるのですが、無料会員の場合利用できるPower-Upが1つまでなのでGASでスクリプトを書きました。

// Repeatリストにある毎日行うタスクカードをTaskリストにコピーする
function copyRepeatListDailyTaskToTaskList() {
  let listUrl = 'https://trello.com/1/lists/' + REPEAT_LIST_ID + '/cards?key=' + TRELLO_KEY + '&token=' + TRELLO_TOKEN + '&fields=name';
  // Repeatリストにあるカード情報を取得
  let cardOfRepeatList = UrlFetchApp.fetch(listUrl, { 'method' : 'get' });
  cardOfRepeatList = JSON.parse(cardOfRepeatList.getContentText());

  cardOfRepeatList.forEach (function(key) {
    // 指定のカードの場合、そのカードをTaskリストにコピーする
    if (key['id'] === 'xxxxxxxxxxxxxx') {
      let createCardUrl = 'https://api.trello.com/1/cards?key=' + TRELLO_KEY + '&token=' + TRELLO_TOKEN + '&idList=' + TASKS_LIST_ID;

      let payload = {
        'pos' : 'top',
        'idCardSource' : key['id']
      };

      let option = {
        'method' : 'POST',
        'payload' : payload
      };

      UrlFetchApp.fetch(createCardUrl, option);
    }
  });
}

// 毎日指定の時間帯にcopyRepeatListDailyTaskToTaskListを実行
function setCopyRepeatListDailyTaskToTaskListTrigger() {
  let date = new Date();
  // AM9時にセット
  date.setHours(9,0,0,0); 
  ScriptApp.newTrigger('copyRepeatListDailyTaskToTaskList').timeBased().at(date).create();
}

TogglとGAS（Google Apps Script）を連携させる

工数管理表にその日作業した工数時間を自動で入力させる

例えば以下のような工数管理表があった場合、その日にTogglで計測した各プロジェクトごとの工数時間を記入してくれるスクリプトです。

let date = new Date();

// 工数管理票に工数を書き込む
function writeToConstructionScheduleControlChart() {
  let spreadSheet = SpreadsheetApp.openById('xxxxxxxxxxxxxxxxxxxxx').getSheetByName('シート1');

  // Togglから各プロジェクトの工数時間取得
  let togglReports = getTogglReports();

  // Togglに当日のレポート情報がある場合
  if (Object.keys(togglReports).length > 0) {
      let num = date.getDate();

      for (var key in togglReports){
        if (key === 'プロジェクトA') {
          spreadSheet.getRange('A2').offset(0, num).setValue(togglReports[key]);
        } else if (key === 'プロジェクトB') {
          spreadSheet.getRange('A3').offset(0, num).setValue(togglReports[key]);
        } else if (key === 'プロジェクトC') {
          spreadSheet.getRange('A4').offset(0, num).setValue(togglReports[key]);
        }
      }
  }
}

//プロジェクトごとの工数を取得
function getTogglReports() {
  let today = Utilities.formatDate(date, 'Asia/Tokyo', "yyyy-MM-dd'T'HH:mm:ss'+09:00'");

  let summaryUrl = 'https://api.track.toggl.com/reports/api/v2/summary?user_agent=' + TOGGL_EMAIL + '&workspace_id=' + TOGGL_WORKSPACE_ID + '&since=' + today + '&until=' + today;
  let reports = UrlFetchApp.fetch(summaryUrl, {
                  'method' : 'GET',
                  'headers' : {'Authorization' : 'Basic ' + Utilities.base64Encode(TOGGL_API_TOKEN + ':api_token')}, 
                  'muteHttpExceptions' : true,
                });
  reports = JSON.parse(reports.getContentText());

  let todayReports = [];

  for (let i = 0; i < reports['data'].length; i++) {
    if (reports['data'][i].id === xxxxxxxx) { // プロジェクトA
      todayReports['プロジェクトA'] = calcTime(reports['data'][i].time);
    } else if (reports['data'][i].id === xxxxxxxx) { // プロジェクトB
      todayReports['プロジェクトB'] = calcTime(reports['data'][i].time);    
    } else if (reports['data'][i].id === xxxxxxxx) { // プロジェクトC
      todayReports['プロジェクトC'] = calcTime(reports['data'][i].time);  
    }
  }

  return todayReports;
}

// 毎日指定の時間帯にwriteToConstructionScheduleControlChartを実行
function setwriteToConstructionScheduleControlChartTrigger() {
  // PM20時にセット
  date.setHours(20,0,0,0); 
  ScriptApp.newTrigger('writeToConstructionScheduleControlChart').timeBased().at(date).create();
}

参考資料

• The Trello REST API
• GitHub – toggl/toggl_api_docs: Documentation for the Toggl API
• Reference overview | Apps Script | Google Developers