TimeTracker NXでプロジェクト管理を効率化しよう！ by グローバル・アスピレーションズAdvent Calendar 2024

iPhoneでサクサク工数を登録しよう: TimeTracker NX × ショートカットアプリのカスタマイズ術

Last updated at 2024-12-19Posted at 2024-12-19

この記事の概要

TimeTracker NXを活用して、日々の工数実績登録を爆速＆超手軽にしませんか

本記事では、TimeTracker NXのWeb APIとiPhoneのショートカットアプリを連携して工数実績登録を行う方法を解説します。とっても簡単です

TimeTracker NXはデンソークリエイト様が提供する、「工数管理・プロジェクト管理の見える化により、業務改善を支援するソフトウェア」です。 https://www.timetracker.jp

本記事はTimeTracker NXでプロジェクト管理を効率化しよう！ by グローバル・アスピレーションズ Advent Calendar 2024に参加しています。

成果物イメージ

感想 & TimeTracker NXの推しポイント

本記事執筆にあたり、はじめてTimeTracker NXを使用しましたが、Web APIが提供されているため、外部のソフトウェアや、今回使用するショートカットアプリ等のツールと容易に組み合わせられます。それにより、現在の業務の進め方に自然に溶け込めさせられそうであり、その点がTimeTracke NXの魅力なのではと感じました。

では、本文に入っていきましょう！

対象読者

TimeTracker NXを現在使っていて、さらに便利に活用したい人
TimeTracker NXは使ったことがないが、工数管理ツールに興味がある人
iPhoneのショートカットアプリが好きな人

この記事の構成

この記事では、架空のプロジェクト「家事・育児」に対して、頻繁に入力する「掃除」「洗濯」などの工数を爆速で記録することをテーマにします。

提供されているWeb UIから工数を登録してももちろん問題ないのですが、私自身の経験上、工数登録はさっとできないと忘れるという辛みがあります。これを解決するには身近なデバイス=スマートフォンでさっと入力できたら良いのでは？と思いませんか。

スマートフォンからもTimeTracker NXを操作できるのですが、いやもっと爆速で操作することに価値がある！ と考え、この記事ではTimeTracker NXのWeb APIを活用し、iPhoneのショートカットアプリから工数を登録していきたいと思います。

説明のため、必要最低限ではありますが、TimeTracker NXの工数管理の機能から順に述べていきます。

TimeTracker NXを使った工数管理の全体像
TimeTracker NXのWeb API
ショートカットアプリのアクション作成

TimeTracker NXを使った工数管理の全体像

TimeTracker NXで工数管理を行う上で押さえておきたい用語と大まかな進め方は以下の通りです。

押さえておきたい用語

用語	内容	例
プロジェクト	（そのまま）	家事・育児プロジェクト
ワークアイテム	プロジェクト内で実施するアイテム。分類分けのためのパッケージと、実際の作業を表すタスクがあり、どちらもワークアイテムである。	パッケージ:掃除、タスク:風呂掃除

例えば下図のように、「掃除」というパッケージの下に、「風呂掃除」のようなタスクを作ることができます。

工数管理の大まかな進め方

プロジェクトを作成する。
ワークアイテムを定義し、メンバーを割り当てる。このメンバー割り当てはTimeTracker NX内では「リソース割り当て」と表記されています。
メンバーは作業を行うと、自分に割り当てられたワークアイテム一覧の中から該当するアイテムを選び、開始時間と終了時間を登録する。
登録された工数を見える化・分析する。

工数を登録した後の画面は以下のようになります。（めっちゃ掃除するやん）

本記事では上記ステップのうち、3.の工数実績の登録にフォーカスします。

TimeTracker NXのWeb API

TimeTracker NXは、クラウドサービスであるという特性を活かして、Web APIを提供して下さっています。Web APIを活用すれば、iPhoneのショートカットアプリなど、HTTPリクエストを取り扱えるツールからTimeTracker NXを操作可能！

ということで、本章ではWeb APIの仕様について要点をかい摘んで解説します。詳細なWeb API仕様はこちらをご覧ください。

Web APIの概要

ベースURI(※後述)+リソース(例:/auth/token)を指定し、GET/POSTなどのリクエストを送ることで様々な操作が可能です。

TimeTracker NXでプロジェクト管理を効率化しよう！アドベントカレンダーで提供されているトライアル環境の場合、通常のGUIのURLと、それに対応するWeb APIのURIは以下のような関係です。シンプルですね。

項目	URL/URI
GUI	https://ttnxevent.azurevm.net/advent/
ベースURI	https://ttnxevent.azurevm.net/advent/api/

例えば以下のようなコマンドで、認証用トークンを取得できます。

curl -H "Content-Type:application/json" \
    -d '{"loginName":"foo", "password":"bar"}' \
    https://ttnxevent.azurevm.net/advent/api/auth/token

本記事では、公式リファレンス同様に、Web APIのURIはベースURIを除いた/auth/tokenのような表記を用いることにします。

Web APIを活用した工数登録の流れ

こちらの例や公式ドキュメントを参照しながら、今回実施したい工数登録に必要な事前準備とワークフローを整理しました。

事前準備

ユーザーの作成（トライアル環境では作成済み）
プロジェクトの作成
ワークアイテム(パッケージ・タスク)の作成
ワークアイテムへのリソース割り当て(メンバーをアサインすること)

必須はここまでですが、後で必要になるため、よく使うワークアイテムのworkItemIdも控えておきます。

workItemIdの調べ方

認証用トークンの取得
プロジェクトのworkItemRootFolderのID取得。プロジェクトのIDが必要になりますが、これはGUIの管理画面でプロジェクトを開き、URLから調べるのが早いです。
ワークアイテム一覧の取得

ショートカットアプリでのキャプチャ画面ですが、すべて繋げるとこのようになります。

得られたレスポンスから、例えば「風呂掃除」のIDは2220であることが分かります。（分かりやすさのため、下記のレスポンス例は不要な値などを除外した上で整形してあります。）

{
  "fields": {
    "Name": "家事・育児",
    "SubItems": [
      {
        "fields": {
          "Name": "掃除",
          "SubItems": [
            {
              "fields": {
                "Name": "風呂掃除",
                "Id": "2220"
              }
            },
            {
              "fields": {
                "Name": "キッチン掃除",
                "Id": "2221"
              }
            }
          ],
          "Id": "2219"
        }
      }
    ],
    "Id": "2217"
  }
}