RaQuest features guideby Sparx Systems Japan

要求管理ツール RaQuest 6.0 機能ガイド

要求管理ツール RaQuest 6.0 機能ガイド

目次
1.

はじめに ........................................................................................................................................ 3

2.

RaQuest とは ................................................................................................................................ 4

3.

画面概要 ........................................................................................................................................ 54.

要求の作成 .................................................................................................................................... 75.

要求の分類 .................................................................................................................................. 186.

要求の状態遷移 ........................................................................................................................... 207.

要求 ID の自動採番 ..................................................................................................................... 228.

計算機能（要求の優先度値・計算式型ユーザ定義属性）.......................................................... 23

9.

ツリー表示 .................................................................................................................................. 25

10.

一覧表示 ...................................................................................................................................... 28

11.

要求の関係付けと表示 ................................................................................................................ 36

12.

マトリックス表示........................................................................................................................ 40

13.

ベースラインの設定と利用 ......................................................................................................... 44

14.

変更の管理 .................................................................................................................................. 46

15.

ドキュメントの生成とデータ出力 .............................................................................................. 48

16.

外部要求情報の取り込み............................................................................................................. 51

17.

変更通知 ...................................................................................................................................... 5218.

Enterprise Architect との連携 ................................................................................................... 54

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

2

要求管理ツール RaQuest 6.0 機能ガイド

1. はじめに
このドキュメントはスパークスシステムズ ジャパンが提供する要求管理ツール RaQuest の機能を紹介するドキュメントです。サンプルプロジェクトを元に、いくつかの機能を紹介します。
RaQuest 日本語版・日本語評価版 バージョン 6.0 をご利用になるためには、モデリングツール
Enterprise Architect 日本語版 バージョン 15.0 以降が必要です。フローティングライセンスの場合のライセンスマネージャーはバージョン 1.3 以降が必要です。
モデリングツール Enterprise Architect 日本語版をお持ちでないお客様の場合には、EnterpriseArchitect 英語評価版と RaQuest 英語評価版で機能の評価を行うことが可能です。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

3

要求管理ツール RaQuest 6.0 機能ガイド

2. RaQuestとはRaQuest は要求管理のためのツールです。RaQuest では要求の概要や詳細属性を、入力することが可能です。入力された要求を一覧として表示・印刷したり、HTML や Word で開ける RTF ドキュメ
ントとして出力したりすることも可能です。さらに、要求間の関連を入力することが可能です。入力
された要求間の関係からインパクト分析やカバレッジ分析に役立つ、関係図やマトリックス表示を行うことが可能です。これらにより、要求管理をより効率良く行うことが可能です。
RaQuest はモデリングツール Enterprise Architect と統合されています。そのため、RaQuest で作成した要求項目を、UML のユースケースとして生成したり、ユースケースを要求項目として読み込んだりすることも可能です。また、要求から UML の要素への関連付けが可能です。これにより、要求管理からユースケース図などの UML の図や設計要素と効率良く連携させることが可能です。このように RaQuest では管理されている要求から UML への移行をスムーズに行うための機能も持っています。また、逆に業務フロー図などで要求を作ることで、関連を付けながら要求を作成することができ、その後 RaQuest で一覧として管理するなども可能です。
要求管理といえば、専任の担当者やチームの一部の人のみが管理する、というケースが多いように思います。この理由のひとつとして、要求管理をするためのツールが高価であり、とても全員に配布
して利用できない、という点もあるかと思います。低価格の RaQuest を利用しモデリングツール
Enterprise Architect と連携させることで、開発に携わるすべての人がいつでも要求項目を確認し、要求仕様を満たすシステムの開発を行うという新しいスタイルの開発を行うことも目指しています。
なお、RaQuest とは、Requirements Adjustment Quest という単語から作成した造語であり、「ラ
クエスト」と発音します。
「ラク」には「楽」という意味もあり、楽に要求管理ができるようなツール、という願いも込められています。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

4

要求管理ツール RaQuest 6.0 機能ガイド

3. 画面概要
RaQuest を起動しプロジェクトファイルを開くと、図 1 のようなウインドウが表示されます。これが、RaQuest のメインウインドウです。以下の例はサンプルプロジェクトを開いた場合です。設定の内容や RaQuest のビルド番号によって、起動時に表示される内容等は異なります。
モデリングツール Enterprise Architect のプロジェクトファイルをお持ちの方は、そのプロジェク
トファイルを RaQuest で開くことも可能です。

図 1

左側には要求や要求をまとめて整理するためのパッケージのツリーが、右側には要求の一覧が表示されます。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

5

要求管理ツール RaQuest 6.0 機能ガイド

オプション「要求を常に表示」がチェックされている場合は、図 2 のように表示されます。右下には、ツリーまたは一覧で選択した要求の詳細が表示されます。

図 2

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

6

要求管理ツール RaQuest 6.0 機能ガイド

4. 要求の作成
要求を作成するには、メインメニューから「要求」→「新規要求」を選択して作成する方法(図 3)と、親となるパッケージや要求をツリーから選択し、右クリックして「新規要求」を選択して作成する方法(図 4)があります。そのほか、一覧上の表示のない部分をダブルクリックすることでも作成可能です。

図 3

図 4

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

7

要求管理ツール RaQuest 6.0 機能ガイド

サンプルファイルのように、「要求カテゴリ」が複数定義されている場合は、要求カテゴリを選択する必要(図 5)があります。
（要求カテゴリについては 5 章を参照）

図 5

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

8

要求管理ツール RaQuest 6.0 機能ガイド

新規要求を定義するためのダイアログ(図 6,図 7)では、要求の概要や詳細はもちろん、種類や状態・期限・難易度・優先度などの属性を設定することが可能です。ユーザ定義属性を定義している場合は、
ユーザ定義属性を設定することが可能です(図 8)。
オプション「属性を一覧形式で表示」または「このプロジェクトでは、属性を一覧形式で表示」にチ
ェックが入っている場合、図 6,図 7,図 8 の代わりに、説明ダイアログ（図 9）と属性ダイアログ（図10）で同じ情報を表示・設定が可能です。

図 6

図 7

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

9

要求管理ツール RaQuest 6.0 機能ガイド

図 8

図 9

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

10

要求管理ツール RaQuest 6.0 機能ガイド

図 10要求の作成が完了すると、プロパティダイアログからさらに詳細な内容の設定が行えます(図 11)。
要求のプロパティダイアログを開くと、「UML 要素」「資料」「担当者」「テスト項目」「コメント」「再検討」「更新履歴」タブが表示されます。要求ごとに内容を設定・確認が可能です。(新規要求作成時にはこれらのタブは表示されません。作成後プロパティを開くと表示されます。)

図 11

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

11

要求管理ツール RaQuest 6.0 機能ガイド

UML 要素のタブ(図 12)では、要求と UML 要素との関連を登録・参照することが可能です。

図 12

ツリーの中で、関連する UML 要素の前のチェックボックスにチェックを入れることで関連があることを登録します。その際、なぜ関連があるかなどのコメントを入力しておくことが可能です。
ここで関連付けた UML 要素との関連は、マトリックスや一覧、Enterprise Architect でのダイアグ
ラム（図）として参照することが可能です。関連を見ることで影響範囲の確認や要求に対する成果物があるかなどの確認が可能です。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

12

要求管理ツール RaQuest 6.0 機能ガイド

資料のタブ(図 13)では、要求に関連するファイルや URL を登録することが可能です。これらは、あくまでもリンクなので、ファイルの実体をプロジェクトファイルに保管するわけではありません。

図 13

一覧から対象の項目を選択して編集を行うことや、「表示」ボタンを押して資料の表示を行うことが可能です。URL の場合には、既定の Web ブラウザが起動されます。ファイルの場合には、そのファ
イルに関連付けられたアプリケーションで表示されます。
ここで設定されたファイルや URL は、「関係ファイルをまとめる」機能を利用することで、指定したディレクトリにすべてコピーすることが可能です。要求項目を HTML ドキュメントなどの形式で出力し、この機能を利用して関連するファイルとあわせて、持ち運ぶことも可能ですので、便利です。
(URL の場合は Windows のショートカット形式のファイルとして生成されます。)

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

13

要求管理ツール RaQuest 6.0 機能ガイド

担当者タブ(図 14)では、要求に割り当てている担当者を確認・編集することが可能です。

図 14

なお、担当者を割り当てる場合には、このダイアログだけでなく、担当者ツリーを利用することも可能です(図 15)。

図 15

担当者のツリーから、割り当てる担当者を選択し、一覧の要求までドラッグ＆ドロップで移動します。この操作で、簡単に担当者を割り当てることが可能です。逆に一覧から担当者にドラッグ＆ドロ
ップしても同様に割り当てることが可能です。ドラッグ中はアイコンの形が変化します。また、ドラッグ&ドロップの結果については、ステータスバーに表示されます。
同様にして、部署も要求に割り当てることも可能です。
（オプション「部署名を担当者として選択可能」による）

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

14

要求管理ツール RaQuest 6.0 機能ガイド

コメントのタブ(図 16)は、要求についてのコメントを記録することが可能です。

図 16「公開」のチェックボックスにチェックを入れない場合には、生成されるドキュメントに選択した
コメントは記載されませんので、内部の検討などにも利用することが可能です。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

15

要求管理ツール RaQuest 6.0 機能ガイド

再検討のタブ(図 17)では、要求の概要で「再検討が必要」にチェックが付いている場合に影響元要求の一覧が表示されます。

図 17

一覧から要求を選択し、「影響元要求参照」ボタンをクリックすると、対象の要求のプロパティが参照可能です。要求の再検討が終了している、または再検討の必要がない場合には、「再検討済」ボタン
をクリックすることで再検討済となります。一覧にある要求がすべてなくなると、概要の「再検討が必要」チェックが外れます。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

16

要求管理ツール RaQuest 6.0 機能ガイド

更新履歴のタブ(図 18)では、要求の変更履歴を参照することが可能です。

図 18

リビジョンごとに変更点が保存されていますので、参照したいリビジョンを一覧から選択すると、更新内容が上部表示領域に表示されます。
「表示」ボタンを押下すると選択したリビジョンの状態の要
求ダイアログが表示されます。
「ロールバック」ボタンを押下すると、今の要求の属性が選択したリビ
ジョンの状態に戻されます。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

17

要求管理ツール RaQuest 6.0 機能ガイド

5. 要求の分類
要求の分類する切り口として、一般的に「種類(特性)」と「抽象度」で分類することが多いです。
「種類(特性)」での分類は、「機能要求」と「非機能要求(機能外要求)」に大きく二つに分け「非機能要求」をさらに分類する方法が一般的です。このほかにもさまざまな分類アプローチがあり、代表的な例としては、FURPS+ や ISO/IEC9126(JIS X 0129-1) などがあります。
RaQuest の標準では、FURPS+ の値を持った属性である「種類」が定義してあります(図 19)。

図 19

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

18

要求管理ツール RaQuest 6.0 機能ガイド

もうひとつの「抽象度」による分類は、「要望・要件・仕様」や「ニーズ・システム要件・ソフトウ
ェア要求」BABOK(R)では「ビジネス要求・ステークホルダー要求・ソリューション要求・移行要求」などという言葉で分類されるものです。
この分類には BABOK(R)の分類以外は代表的な例がなく、会社・組織ごとにさまざまな定義・言葉が利用されています。
RaQuest においては、この「抽象度」による分類を明確に区別して管理を行うために「要求カテゴリ」機能を定義しています(図 20)。

図 20

属性の「種類」や「要求カテゴリ」以外の分類手段として、後の章で説明するプロジェクトツリーでの任意の階層構造での分類もできるようになっています。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

19

要求管理ツール RaQuest 6.0 機能ガイド

6. 要求の状態遷移
RaQuest では、要求の管理にあたり、以下の図 21 のような要求の状態遷移を想定しています。

作業中
初期状態
ロ ック解除その他の状態

検討完了
検討済み

親の要求が変更

承認済み

図 21

この中で、RaQuest が「特別な状態」として想定しているものに、次の 3 つがあります。
・ 初期状態要求が作成された直後の状態。検討が必要な状態。
・ 検討済み状態要求の検討が完了し、内容が確定した状態。
・ 承認済み状態
確定したものが責任者によって承認され、最終的に確定した状態。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

20

要求管理ツール RaQuest 6.0 機能ガイド

これらの特別な状態に対応する具体的な状態については、プロジェクトオプションで変更可能です。
また、要求の状態の選択肢もプロジェクトオプションで追加・変更可能です。
標準で設定されている状態の選択肢をこれに当てはめると、図 22 のような流れになります。

<<初期状態>>
未検討

保留

検討中

対象外

重複

<<検討済み>>検討済<<承認済み>>承認済

図 22

標準の設定では要求の状態として、「初期状態(未検討)」→「検討中」→「検討済み(検討済)」→「承認済み(承認済)」という流れを考え、検討中に検討の対象外になった場合に「対象外」、検討を保留している場合に「保留」という状態があることを想定したものが設定されています。
「検討済み」「承認済み」に該当する状態は、要求の内容が確定している状態となるため、要求には自動的にロックがかかり内容を変更することはできません。このロックを外そうとすると(何らかの理由で修正しようとすると)、状態は自動的に「初期状態」に戻ります。また、その要求に依存する要求
は、再検討が必要な状態に連鎖的に変更されます。
こうして、再度要求を見直すことで、要求を変更することによる検討漏れを防ぐことができます。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

21

要求管理ツール RaQuest 6.0 機能ガイド

7. 要求IDの自動採番
要求 ID については以下の 5 つの選択肢が RaQuest にはあります。
・ プロジェクト全体で通し番号の ID を採番
・ 要求カテゴリごとに通し番号の ID を採番（デフォルト）・ パッケージごとに投資番号の ID を採番
・ 階層構造で採番
・ 自動採番せず、任意に入力
この選択は、プロジェクトオプションの「状態と初期値」タブ(図 23)で設定が可能です。
この選択を変更する場合、既存の要求の ID を採番し直す機能も持っています。しかし、プロジェク
トの作成時に決めておくのが、混乱を避けるためにも良いと思われます。

図 23

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

22

要求管理ツール RaQuest 6.0 機能ガイド

8. 計算機能（要求の優先度値・計算式型ユーザ定義属性）
要求の属性のひとつ「優先度値」は、要求の優先度を決めるための値・計算式を用いて計算した結果の値です。優先度値を使って一覧を表示（優先度値順表示）することも可能です。計算式型のユーザ定
義属性には、計算式を設定し計算結果の値を表示することが可能です。任意の計算式を設定できるた
め簡単な見積もりの計算などにも利用できます。
計算式には、変数・数値・演算子(+,-,*,/)・括弧() が利用可能です(図 24・図 25)。変数として利用できる属性は、優先度・難易度・リスク・安定度・作業量・ユーザ定義属性があります。優先度・難易
度・リスク・安定度は、高=3/普通=2/低=1 が割り当てられています。ユーザ定義属性は数値型・列挙
型・計算式型が対象です。

図 24

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

23

要求管理ツール RaQuest 6.0 機能ガイド

図 25

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

24

要求管理ツール RaQuest 6.0 機能ガイド

9. ツリー表示
ツリーは、多くの要求を効率的に分類・管理するために利用します。ツリーにはパッケージを配置することが可能です。このパッケージには複数の要求を格納し、わかりやすく分類・管理することができるようになっています(図 26)。
作成したパッケージや要求はドラッグ＆ドロップで自由に移動させることが可能ですので、要求項目を作成しながら、随時位置を変えていくことも可能です。

図 26

要求にはその詳細を示すためや細分化して利用するため、あるいは関係する要求を示すための子要求が定義できるようになっています(図 27)。

図 27

要求の下にパッケージを作成することも可能です(図 28)。要求の下に作るパッケージは、子要求を分類するインデックスの役割を持ち、階層化のためのパッケージとは異なります。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

25

要求管理ツール RaQuest 6.0 機能ガイド

図 28

このように、多くの要求をわかりやすく分類することは重要です。
この左側ツリー部分はタブ形式になっています。起動直後のタブには、これまで説明してきたプロ
ジェクト全体の要求を示す「プロジェクト」と「担当者」が表示されます。
「担当者」のタブは、図 29のように組織および担当者を定義するためのツリーになります。

図 29

この担当者の便利な使い方については、次の章で説明します。
このほかに、「種類別」「状態別」「要求カテゴリ別」そしてユーザがツリー条件を指定できる「カスタムツリー」といった各ツリータブを追加することが可能です(図 30)。

図 30

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

26

要求管理ツール RaQuest 6.0 機能ガイド「カスタムツリー」は登録するとツリーメニューに追加されます(図 31)。10 件まで登録することが
可能です。

図 31

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

27

要求管理ツール RaQuest 6.0 機能ガイド

10. 一覧表示
一覧は、要求の概要を把握することのできる有効な手段となります。一覧の項目は、それぞれの状
態に応じて色を変えて表示されます(図 32)。

図 32

ここで、それぞれの一覧の見出し部分(ID,種類,概要,優先度,状態,...)をクリックすることで、表示されている内容をソートすることが可能です。例えば、状態をクリックしてソートした場合には、次の
図 33 のような表示になります。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

28

要求管理ツール RaQuest 6.0 機能ガイド

図 33

この一覧では、状態でソートされていることがわかるかと思います。
さらにこの一覧に対して、要求概要に、例えば「ユーザー」を含む要求のみを表示したい場合には、フィルタ機能を利用します(図 34)。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

29

要求管理ツール RaQuest 6.0 機能ガイド

図 34

上記のような指定をすると、以下の図 35 のように一覧を絞り込んだ結果が得られます。

図 35

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

30

要求管理ツール RaQuest 6.0 機能ガイド

そのほか、必要に応じて詳細条件を指定して要求を検索する詳細検索機能もあります(図 36)。

図 36以上のような、ソート・フィルタ・検索などの方法で、定義されている多くの要求を一覧形式で確認することが可能です。
一覧に表示されているチェックボックスをチェックすることで、複数の要求の属性をまとめて変更したり、他の要求と関連付けたりすることが可能です。
さらに、一覧は印刷することが可能です。一覧を印刷する際の要求の並び順は、画面で表示されているとおりになりますので、まずソートやフィルタ機能を利用した後、印刷機能を呼び出すと良いでしょう。
プロジェクトファイルを開いた直後は、すべての要求一覧が表示されます。任意のパッケージ以下の要求を一覧表示したい場合には、ツリーからパッケージを選択して「要求一覧」を選択することで(図 37)、該当の要求のみに絞り込むことが可能です(図 38)。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

31

要求管理ツール RaQuest 6.0 機能ガイド

図 37

図 38

一覧を表示すると、一覧側の下部にタブが追加されます(図 39)。表示した一覧はタブを切り替える
ことで、随時参照することが可能です。

図 39

同様にして、要求だけでなく、コメントや資料なども一覧として表示することが可能です。例えば、
ツリーでパッケージを指定して「コメント一覧」を選択すると、そのパッケージに含まれる要求のコ
メントすべてを一覧形式で表示することが可能です。また、「担当者」タブで担当者を選択した状態で「担当要求一覧」を指定すると、その担当者が担当している要求の一覧を表示可能です。
このようにさまざまな一覧が利用可能ですので、効率的に要求を管理することが可能です。
一覧の表示項目はローカルオプション(図 40)もしくはプロジェクトオプション(図 41)で変更する

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

32

要求管理ツール RaQuest 6.0 機能ガイド

ことが可能です。

図 40

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

33

要求管理ツール RaQuest 6.0 機能ガイド

プロジェクトオプションの場合は、一覧項目に名前を付け、一覧の右上のコンボボックス(図 42)で、表示している一覧の項目を切り替えることが可能です。

図 41

図 42

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

34

要求管理ツール RaQuest 6.0 機能ガイド

同様に、色オプションタブで一覧の表示色を自由に設定可能です(図 43)。

図 43一覧に必要な項目のみを表示させ、状態別に色を変えることで、さらに管理が容易になります。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

35

要求管理ツール RaQuest 6.0 機能ガイド

11. 要求の関係付けと表示
これまでご紹介してきましたように、要求を作成しツリーや一覧で表示する機能で、多くの要求を効率的に把握することができるようになることがご理解いただけたと思います。しかし、ツリーや一覧表示では把握しづらい、要求間の関係を把握・管理することは要求管理において重要です。
実際の要求管理においては、ある要求の内容が変更になった場合、連鎖的に変更になる(影響を受ける)要求や、再度検討し直さなければならない要求が存在します。こうした要求間の関係を管理する機能を紹介します。
このような要求間に依存関係を定義するには、一覧とツリーの間、もしくはツリー内・一覧内の要求間で要求をドラッグ＆ドロップします。
例えば、下記の例で、「ID:F003」の要求が、「ID:N001」の要求に依存する（影響される）場合、つまり、「ID:N001」の変更は「ID:F003」にも影響するかもしれない(再検討する必要がある)といった場
合、「ID:F003」の要求を「ID:N001」の要求にドロップしてください(図 44)。これで関連付けが行え
ます。

図 44

なお、プロジェクトオプションの動作 1 タブのオプション「要求を別の要求の下に作成したときに、自動的に関係を作成」などの設定により、ドラッグ＆ドロップを行わなくても、子要求の作成や移動時に関係が自動的に作成・削除されます。ご注意ください。
こうして作成した関係は、図として確認することが可能です。対象の要求を右クリックして「要求の関係を図示」(図 45)を選択すると、次のように図として依存関係を把握することが可能です。選択した要求を赤色太枠で表示し、関係する要求を確認することが可能です(図 46)。直接の関係がある要求だけではなく、間接的に関係がある要求も表示します。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

36

要求管理ツール RaQuest 6.0 機能ガイド

図 45

図 46

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

37

要求管理ツール RaQuest 6.0 機能ガイド

対象の要求に関連する要求の中に、既に再検討が必要となっている要求があるかもしれません。関
係図のオプション「再検討を色付け表示」がオンの場合、再検討が必要となっている要求は図の中で緑色で表示されます(図 47)。すでに再検討の確認を終えている項目の色は変わりません。

図 47

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

38

要求管理ツール RaQuest 6.0 機能ガイド

複数の要求の変更が影響して「再検討が必要」の状態になっている場合には、要求のプロパティダ
イアログの「再検討」タブ(図 48)で原因となった要求を確認することも可能です。

図 48

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

39

要求管理ツール RaQuest 6.0 機能ガイド

12. マトリックス表示
関連付けた要求は前章で説明したように図として見ることも可能ですが、要求のまとまりとしての関係を把握するためにマトリックスとして表示することも可能です。
（図 49）

図 49

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

40

要求管理ツール RaQuest 6.0 機能ガイド

また、マトリックスは要求－要求間の関連だけではなく、要求－担当者間（図 50）、要求－ユース
ケース間（図 51）、要求－UML 要素間（図 52）の関係をマトリックスとして表示することが可能です。マトリックスとして表示することにより、例えば、要求－ユースケース間の場合、すべての要求に対してユースケースが作成されているか等が確認可能です。
「関連無しを色付」のチェックボックスにチェックを入れ、更新を行うと、他の要素と関連付けがない要素に色付けが行われ、一目で関係がない要素が何かを把握することが可能です。
また、関係を表示するだけではなく作成することも可能です。作成するにはマトリックスで該当するセルをクリックすることで行うことが可能です。また、要求やユースケースが多くある場合には、対象のパッケージを選択することで絞り込むことが可能です。
さらに、データを CSV や RTF の形式で出力することも可能です。

図 50

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

41

要求管理ツール RaQuest 6.0 機能ガイド

図 51

図 51 の中でどのユースケースとも結びついていない要求が、色付けされて表示されています。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

42

要求管理ツール RaQuest 6.0 機能ガイド

図 52

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

43

要求管理ツール RaQuest 6.0 機能ガイド

13. ベースラインの設定と利用要求項目は、時が経つにつれて、開発中でもその内容が変わっていきます。ある時点でのスナップ
ショットを保管するためには、ベースライン機能の活用が便利です。
最初は、ベースラインは特に指定されていません。今回はいくつかフェーズがあるような開発を仮定します。
最初のフェーズの開始時点での要求を「フェーズ１」として新規ベースラインを設定すると、ベースラインの管理ダイアログは、以下のような表示になります。(図 54)

図 53

図 54

この状態で作業を続けます。そして、最初のフェーズが完了し次のフェーズ「フェーズ 2」が開始される時点で、再度「新規ベースライン」を実行しフェーズ 1 終了時点でのスナップショットを保存します。その後は、ベースライン「フェーズ 2」として作業を続けます。その後も同様です。
作業中に、保管してある以前のベースラインの情報と差分を確認したい場合、ベースライン管理ダ
イアログの「差分の表示」を実行することで差分を表示することが可能です。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

44

要求管理ツール RaQuest 6.0 機能ガイド

また、ある時点の要求の状態に戻りたいということであれば、「ベースラインに戻す」を実行し戻ることが可能です。戻した後に要求を変更し、新たなベースラインとして保存することも可能です。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

45

要求管理ツール RaQuest 6.0 機能ガイド

14. 変更の管理システムにおける要求は、常に変化していくものであると考えられます。時間の流れとともに(システムの開発中であっても)変更せざるを得ない場合もあれば、要求の理解不足などの理由で変更される場合もあります。
こうした要求の変更のうち、ある開発フェーズ内(同一ベースライン内)の場合には、直接要求項目を修正します。しかし、ベースラインをまたがって要求を変更するような場合、元になる要求はすでに「承認済み」となっていて変更できません。このような場合は別途変更要求を作成して、その要求を管理することになります。
具体的には、対象のシステムのバージョン 1 での要求内容が、バージョン 2 で変更になるような場合です。こうした場合に変更要求を定義して利用します。
変更要求を定義するには、対象の要求がすでに「承認済み」となっている必要があります。すでに「承認済み」となっている対象の要求を選択した場合に選択可能となる「新規変更要求」メニューで作成します(図 55)。

図 55

作成した変更要求のプロパティダイアログから「変更元要求」ボタンを押すことで、簡単に前の要求の内容を確認することが可能です(図 56)。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

46

要求管理ツール RaQuest 6.0 機能ガイド

図 56

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

47

要求管理ツール RaQuest 6.0 機能ガイド

15. ドキュメントの生成とデータ出力
RaQuest で作成した要求は、プロジェクトファイルの中に格納されます。このプロジェクトファイ
ルは Enterprise Architect のファイルと同じですので、そのまま参照することはできません。会議での検討段階や顧客への提出資料など、ドキュメント化する必要がある場合には、ドキュメント出力機
能を利用することが可能です。
RaQuest では、RTF および HTML の形式でのドキュメント出力が可能です。
例えば RTF 形式のドキュメントを出力する場合、基準となるパッケージをツリーで指定し、メイン
メニューより RTF へのエクスポートを指定してください(図 57)。ファイル名とテンプレート名などを指定し、ドキュメントを出力します。

図 57

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

48

要求管理ツール RaQuest 6.0 機能ガイド

出力したドキュメントの例は以下のとおりです(図 58)。RTF ドキュメントの形式は EnterpriseArchitect の RTF テンプレートエディタを使うことで自由に編集が可能です。
＜RTF 出力例＞

図 58

同様にして、固定形式ですが、HTML 形式での出力も可能です。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

49

要求管理ツール RaQuest 6.0 機能ガイド

また、RaQuest で作成した要求データを、分析など他の用途で利用する場合に便利な CSV、Excel
出力が可能です。
メインメニューより CSV へのエクスポートを指定してください。ファイル名と出力先等を入力すると、出力が開始されます。
図 59 は Excel で CSV ファイルを開いた例です。

図 59

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

50

要求管理ツール RaQuest 6.0 機能ガイド

16. 外部要求情報の取り込み
表計算ツールなど他のツールで管理している既存の外部の要求情報を RaQuest に取り込むことが可能です。
表計算ツールなどの要求情報を取り込むためには、CSV ファイルにデータを変換し、RaQuest では、CSV インポートを行います。CSV ファイルのそれぞれのカラムを要求のどの属性として取り込むのか指定が可能です。
すでにプロジェクトにある要求の ID または GUID が CSV ファイルのデータとしてある場合は、上書きが可能です。したがって、前の章の CSV/Excel エクスポート時の出力内容に ID または GUID を含めておくことで、RaQuest と外部のツールとでデータの同期が可能です。
表計算ツール以外の文書ファイルの要求情報の取り込みは、現在 MS-Word からだけ可能です。
RaQuest のインストール時に、Word アドインをインストールすると、Microsoft Word で文字を反転させ、右クリックして表示されるメニューに"RaQuest へ登録" というメニューが追加されます。
Microsoft Word と RaQuest を同時に起動している場合、このメニューを選択することによって、
RaQuest で開いているプロジェクトに選択した文字が要求として登録可能です。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

51

要求管理ツール RaQuest 6.0 機能ガイド

17. 変更通知
RaQuest では要求の追加・削除・要求属性の変更があった場合に、外部プログラムを呼び出すことが可能です。メール送信プログラムを呼び出すことで、要求の追加・削除・要求属性の変更の通知が可
能です。
メール送信プログラム BlatJ (http://www.piedey.co.jp/softs/blat.html) を使い、プロジェクトオプ
ションを設定（図 60）し要求を変更すると図 61 のようなメールが送信されます。

図 60

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

52

要求管理ツール RaQuest 6.0 機能ガイド

図 61

この機能により変更の通知が効率良く行えます。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

53

要求管理ツール RaQuest 6.0 機能ガイド

18. Enterprise Architectとの連携
RaQuest は、Enterprise Architect のプロジェクトファイルを利用しているだけではなく、Enterprise Architect との連携も行うことが可能です。
例えば、定義した要求項目からユースケース要素を作成することが可能です(図 62)。これによりユースケース図の作成が簡単になります。指定した種類の要求のみ（例えば機能要求のみ）をユースケースとして出力することも可能です。

図 62

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

54

要求管理ツール RaQuest 6.0 機能ガイド

サンプルプロジェクトからユースケースを生成すると以下のようになります(図 63)。生成する位置
は自由に変更することが可能です。

図 63

また、既存のユースケースや、ユースケースのプロパティとして定義されている「要求」を読み込むことも可能です。これにより、既存のプロジェクトや開発中のプロジェクトへの RaQuest の導入も容易です。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

55

要求管理ツール RaQuest 6.0 機能ガイド

RaQuest のデータは Enterprise Architect からも自由に参照することが可能ですので、必要に応じて RaQuest で作成したデータに対して Enterprise Architect の機能を利用することも可能です。
次の図 64 は、RaQuest のサンプルプロジェクトを Enterprise Architect で直接開いた例です。
RaQuest のプロジェクトツリーとほぼ同じ構成で格納されているのがおわかりいただけると思います。

図 64

例えば、このパッケージに対して Enterprise Architect の RTF ドキュメント生成機能を利用することも可能です。ただし、要求のいくつかの属性については、Enterprise Architect から生成するドキュメントには表示されません。
なお、RaQuest で設定できる属性で、Enterprise Architect には存在しないものは、更新履歴を除きすべてタグ付き値として保存しています。
このように、Enterprise Architect からも利用可能ですので、必要に応じて RaQuest と EnterpriseArchitect のそれぞれを相互に利用して効率的に作業を進めることができるでしょう。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

56

要求管理ツール RaQuest 6.0 機能ガイド

さらに、RaQuest で利用できる用語集から、用語集の単語と同名のクラスを作成することが可能です。この機能は、分析設計において項目間の関係を図示するような場合など、さまざまな場合において役に立つのではないかと思います。
用語集のダイアログ(図 65)では、Enterprise Architect と同様に単語を入力します。

図 65

こうして登録した用語は、もちろん Enterprise Architect の用語集からも参照することが可能です。
また、Enterprise Architect の機能を利用して文書化することも可能です。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

57

要求管理ツール RaQuest 6.0 機能ガイド

この登録された単語に対して、「用語集からクラスを生成」機能を実行すると(図 66)、指定した位置にクラスが生成されます。

図 66

こうした機能を利用することで、さらに便利に、かつ効率良く要求の管理ができるようになるでしょう。

Copyright (c) 2004-2024 Sparx Systems Japan Co., Ltd.

58