技術投稿│要件定義で感じたこと

自己紹介

ニックネーム：姉さん
経験年数：7年
大学卒業後、東京のSES事業の会社に3年勤務し、2019年11月にアクロクレインに中途入社。転職前はPerlでのcgi開発をメインにし、現在はPHPでのシステム開発を行っている。要件定義から保守・運用まで長期のプロジェクトに携わってきた。

ここ数年、技術を磨くため開発からテストまでの工程に携わっておりましたが、現在は機会をいただき、要件定義から案件に携わっています。久々の要件定義となり、苦戦もしておりますがその中で感じたことを今回記事にさせていただきます。

要件定義と成果物について

要件定義ではお客様の要望とその要望をどのように叶えるかをまとめたものを成果物としてドキュメントを作成していきます。ドキュメントは主に3つの要素を明確にする必要があると考えています。

この要素の中でも業務要件の把握が不十分なまま開発に着手すると、お客様が求めるシステムとは程遠いものになってしまう、開発規模が大きくなり、後続のスケジュールに大きな影響を与える恐れがあります。今回は業務要件で整理する上で最も大切となるフローの記載についてご紹介します。

フローの種類

フローの書き方には種類がいくつかあり、代表的なフローチャートを紹介します。

次に私が業務でよく見かけるBPMNをご紹介します。

BPMNの基本

特徴

BPMNで表された業務フローは、When（いつ）・Where（どこで）・Who（誰が）・What（何を）・Why（なぜ）・How（どのように）の5W1Hで表現できると感じています。

書く時のポイント

1. 業務・タスクの範囲を決める
業務・タスクの目的を明確にしたうえで、フローに記載する範囲を決めることが大切です。目的が曖昧だとフローが複雑になってしまったり、不明瞭な部分が出てきてしまいます。

2. 関係する部署・部門、業務・タスクの洗い出し
業務・タスクに関係する部署・部門、業務に関わる人を洗い出します。また、その人たちがどんな業務・タスクを行うのかを手順の他に使用するドキュメントや道具まで洗い出すことでフローにする際に書きやすくなります。表や、リスト化するなどして簡易的に整理しておくとフローにしやすくなります。
この工程を踏まずにいきなりフローにすると認識の違いが生まれ、フローの書き直しが発生しやすいように感じます。

3. 記号を使いすぎない
BPMNには複数の記号が用意されていますが、すべて使わなければならないわけではありません。相手にわかりやすく、伝わりやすくを意識してシンプルなフローの記載を心がけることが大切です。

まとめ

経験から思うことを中心に個人的な観点での業務フローの紹介内容となりましたが、皆様の経験では要件定義についてどのように感じていますでしょうか？
お客様によってはITを専門にしない方もおり、説明やドキュメントの表記の仕方については都度工夫してわかりやすくする必要があります。
また、ドキュメントを作成している自分では気づかないことも多く、要件定義の中でお客様に言われたときや会話の中で気づいたときに都度修正することでお客様との認識合わせが行えるため、わかりやすく書くこと以外にもやり方・進め方も工夫していくことも大切だと感じています。
とは言っても、まだまだ不慣れで苦戦することも多く、何度もドキュメントの作り直しもしてきました。ここに書いてあることを意識するだけではうまくいかないこともあります。少しでも頭の中に入れておけば、作業を進めやすくなったり、ドキュメントの作成の手助けになってきたと感じています。私自身、これからも精進していきます。

ここまで読んでいただき、ありがとうございました。また次回お会いしましょう。