ツール/Redmine活用
1. 概要#
情報システムの開発・導入プロジェクトには多くのステークホルダー(関係者)が存在します。また大量の課題が発生します。工数が10人月程度のプロジェクトでも課題やQ&Aの数が数100個に達するのは珍しくありません。
このため、大量に発生するステークホルダーとの情報共有や大量の課題を漏れなく効率よく処理する方法が必要となります。
処理方法には主に以下があります。
- Eメール(+Excel）・・・Eメールでやりとり。Excelをメールに添付してやりとりする方法も含む｡2000年初頭のやり方
- オンラインの表計算ツール・・・例.Google SpreadSheet、Office365版Excel
- 課題管理ツール・・・例)redmine, backlog, github issue
チャットツールでの課題管理
チャットツール（Chatwork､Slack等)のみでの課題管理は効率的ではありません｡ 課題管理ツールと比較した場合､一覧性､並べ替え､検索性など重要な点が大きく劣ります｡ 課題管理ツールと連動（eg.メールの代わりにSlackで通知を受信)させて利用する方法はよくあります｡
2. 課題管理ツールを使用するメリット/メールとの比較#
他の方法と比較することでメリットを明らかにできます。メールによる課題管理と比較します｡
メールでの課題管理では以下のような問題が発生します｡ これにより、生産性の低下、品質を低下を招きます｡ 課題管理ツールではこれらの問題を全て解決(もしくは大幅に軽減)できます。
2.1. メールによる課題管理のデメリット#
- 情報漏えい・宛先入力ミス
- 事故・・・外部の人に機密情報を漏えいしてしまう
- 送信漏れ・・・必要な人に届かない
- 全員To・・・BCCにすべき人を全部CCやTOに入れてしまう
- 送信漏れ・送信エラー・・・メンバーの増減のたびに漏れたり送信エラーが発生する
- 上述したようなことを防ぐために無駄に神経を使う
- 検索性が低い
- 件名と違う話題が始まりやすい｡→件名と内容に不一致が生じるため後から探すのが大変
- 属性を付与できない
- 属性とは?
- 担当者･･･誰にボールがあるのかわからない
- 状態/完了？進行中？未着手？がわからない
- 期限/いつまでに対応すべきかわからない
- 優先度/どれを優先すればよいのかわからない
- 他課題との関連・依存関係(親子関係)/関連するやりとりを設定できないので探すのが大変
- 属性がないことで全体状況の把握・最適化が困難になります｡
- 属性がなく一覧表示もできないため、全体を俯瞰して優先度、担当者、期限等をリバランスするのが大変です
- 属性とは?
- 情報不足による不毛なやりとりの増加
- 上述した情報(担当、状態、期限、優先度)を確認するためのやりとりが発生
- 情報の入力・形式を強制できないので、不具合や要望の際に把握したい情報が漏れるので逆質問発生
- 画像を引用しづらい。類似の用語やキーワードがある場合、どの画面や機能を指しているかの逆質問発生
- 対応漏れ
- 見通しが悪いので対応が漏れる
- 期限が近くなっても自動でリマインドしてくれないので対応が漏れる
- 迷惑メールに振り分けられたり操作ミスでアーカイブしてしまったりで対応が漏れる
- その他
- 遅延・漏れがないように誰かが管理(状態チェック、督促など)しなければならない。
- 業務を引き継ぐのが困難
- 引き継ぎでは､要件や仕様など意志決定に関わる情報が必須。メールだと探すのも、読むのも大変。
3. 課題管理ツールの種類#
- Redmine(外部サイト)
- Backlog
- Github Issue
4. Redmineの採用理由#
機能的な面では、いずれの課題管理ツールも大差ありません。 弊社がRedmineを採用する理由は、自社でサーバ・アプリケーションを構築運用できるため費用対効果が優れていることです。(弊社クライアントはアカウントを無料で無制限に発行できます)
5. Redmineの使い方#
5.1. 用語#
Redmineでは､課題､タスク､TODOのことを｢チケット｣を呼称します｡
5.2. はじめに#
5.2.1. アカウント申請[必須]#
アカウント登録するメールとお名前をredmine管理者にお知らせください。アカウントはいくつでも発行できます。
5.2.2. ログイン[必須]#
アカウントが作成されると以下の様式の招待メールが届きます。招待メールには以下の情報が記載されています｡
- ログインID
- 初期パスワード
- ログインURL」などが記載されています。
ログインURLからログインします。パスワードは初回ログイン後に変更が必須となっています。
5.2.3. ブックマーク[推奨]#
よく利用するURLをブラウザにブックマークしておくと便利です。おすすめはチケット一覧です。 またブラウザ起動時に自動で表示されるようにしておくとさらに便利です。
5.3. チケットの確認#
5.3.1. チケットの照会#
ログインすると関連づけられたプロジェクトのチケット一覧を閲覧できます｡
5.3.2. カスタムクエリ/自分の担当を確認#
チケット一覧を表示すると､右側にカスタムクエリが表示されます｡ このクリエを使って自分の担当チケットだけを表示できます。
自分の担当を処理して「終了」もしくは「他担当者を設定」するのがゴールです。
5.4. チケットの処理#
以下の手順でチケットを処理します｡
- 各チケットの編集リンクをクリックします。
- 対応内容を入力します。
- (必要に応じた)ステータスを更新します
- ステータスはチケットの種別(課題、周知、Q&A)により異なります。対応後に該当する状態を設定してください。(例.対応完了、回答済、終了)
- ★重要★担当者を変更します
- 対応後のチケットの担当者を指定します => 担当が変わっていないと対応が漏れますのでご注意ください。
- 送信ボタンを押して確定
5.5. 留意点#
5.5.1. 優先度の考え方#
概ね以下のような位置づけとなります。 感覚的なものでやや曖昧なのですが「低め」「最低」は通常以上が片付いてから参照すればよいと考えてください。
| 優先度 | 位置づけ |
|---|---|
| 最低 | 通常使用しない。備忘レベルの要望。 |
| 低め | 対応が遅れても問題がないレベルの調整（軽微な文字列変更など） |
| 通常 | 通常 |
| 高め | 不具合(とりあえず他の作業はすすめられる) |
| 急いで | 喫緊の不具合(修正しないと作業が進まない) |
| 今すぐ | 電話連絡が必要なレベルの重篤な問題（例.サイト表示できない） |
5.5.2. 投稿時に留意する指針#
以下に留意します。
- 一チケット一内容
- スクリーンショットの活用
- 厳密な用語
一チケット一内容
チケット内容と関係ない質問等を記載しない。関連する話題でも担当者や期日、優先度が異なる場合は、別チケットとして起票します。(チケット間で「関連」「親子関係」を設定することができます。)
スクリーンショットの活用
「百聞一見に如かず」です。スクリーンショットを多用することでコミュニケーション効率が格段に向上します。スクリーンショットと共有URLを簡単に取得できるツール(例. gyazo )の利用を推奨します。有料版だとGIF動画や画像の編集が可能となります。
厳密な用語
システムには類似の機能や画面が存在することがあります。区別するために画面や文書で使われている用語を厳密に使います。自分で創作した用語を使うと無駄なやりとりが必要となり生産性が低下します。(この画面のこと？この機能のこと？もしくは勘違いして手戻り発生)。スクリーンショットを活用することで多少曖昧になっても大丈夫です。
5.6. TIPS/便利な機能#
自分が担当の残タスクを表示するには?#
Redmineでは様々な条件を指定してチケットを検索できます｡ また任意の検索条件を｢カスタムクエリ｣として保存できます｡
事前に準備したチケット一覧の画面右側の｢カスタムクエリ｣にある｢自分が担当の残タスク｣をクリックしてみてください｡
5.6.1. チケット内で画像を表示させる方法は？#
半角記号のビックリマークで画像URL(jpgやpng等)を囲みます。以下は例です｡
!https://sample.com/image.jpg!
画像のサイズを指定する方法
弊社が運営するRedmineでは､画像表示サイズは､何も指定しない場合､300pxとしています｡ 画像を大きく表示したい場合は､画像URLの前に以下のように指定します｡
それぞれ500px,750px,1000pxで表示されます｡(他のサイズは用意してありません)
- !(w500)image.jpg!
- !(w750)image.jpg!
- !(w1000)image.jpg!
スクリーンショット取得ツール活用（強く推奨）
画像の引用は意思疎通を効率的に行うために極めて有用です。 その一方でスクリーンショットをとって添付するのは面倒な作業です。 弊社では簡単にスクリーンショットとその共有URLを取得できるツールとして「Gyazo有料版」（1ヶ月490円～/2023年4月現在）の活用を推奨します。
5.6.2. チケット内に表を作成する方法は？#
以下の書式で表を作成できます｡区切り文字は半角記号の”|”です｡
投稿した内容を変更したい場合は?#
本文の場合
コメントの場合
5.6.3. その他の記法は？#
編集したときに表示されるツールバーの右端のアイコンをクリックして確認できます。
5.7. よくある質問#
5.7.1. 送信済(更新済)のチケットの内容を変更したい#
- 「編集」リンクをクリックすると更新開始できます｡
- コメントの変更
- 編集から追加してもよいですがコメント増やしたくない場合は自身が更新した投稿の右側に表示される「ペン」アイコンをクリックすると更新できます。
5.7.2. アカウントは最大いくつまで発行できますか？利用料金は必要ですか？#
無制限に発行します。料金は無償です。
5.7.3. アカウント管理が面倒なので関係者全員で1つのアカウントを共有してよいですか？#
アカウントを共有しないでください｡
課題管理を効果的に実施するには「この課題は、誰が担当しているか？」がひと目でわかる必要があります。 したがって担当者は「個人」であるほうが好ましいです。アカウントは無制限に発行できます。
5.7.4. 新しいことを覚えるのが大変です。メールでお願いします。#
慣れればメールよりはるかに便利なので覚えてください。 学習に要する時間は1時間もありません｡
前述したとおり｢メールによる課題管理｣には多くの問題点があり効率も品質も低迷します｡ プロジェクトの失敗に直結します。
5.7.5. 大量のメールが届いて困ります。#
アカウント発行時は「所属しているプロジェクトの全てのメール」を受信するように設定しています。 全体を把握している必要がない場合は、以下の操作で通知をへらすことができます。
「個人設定 > メール通知」で「ウォッチまたは関係している事柄のみ」に変更することで､自身に関係するチケットのみを受信することができます｡
