異様な分析獣の公理

はじめに

要件を処理する場合、組織のさまざまな方法を使用できます。完全なカオスの方法から要件とソフトウェアコードの統合まで（ 要件の5つのレベルの成熟度 ）。 必要に応じて作業を徐々に改善し、通常、さまざまな新しい方法論とツールがプロセスに導入されます。 要件の処理を簡素化するように設計されたツールのクラスの1つは、特別に訓練された「動物」です。要件管理システム（SUT）です。 このようなシステムの主な機能は次のとおりです。

• ドキュメント全体よりも簡単なプロジェクト管理ユニット（要件）を作成します。 参照条件全体に同意するよりも、1つの要件を読んで確認する方がはるかに簡単です。
• 要件間の関係を示します。 この機能により、関連する要件の変更を追跡できます。 つまり 何かが変更された場合、システムは、変更の疑いがある変更に関連するすべての要素を強調表示できます。
• 相互接続された一連の要件のプレゼンテーションを選択する。 多数の要件がある場合、それらの関係の全体像を提示する必要がある場合があります。 誰かがこの情報を表（トレースマトリックス）の形で、階層ツリーの形で、ネットワーク図の形で（記事要件管理システム：何となぜ？ ）表示する方が便利です 。

これらのプログラムには、 IBM Rational DOORS 、 Borland Calibre 、 Polarion Requirementsなど、多くの機能を備えた有名な「モンスタービースト」があります。 そのようなシステムは、原則として、十分に確立されていますが、高価です。 しかし、このリストの中には、Axiomのような、小さく、無料で、あまり知られていないが、非常に便利な「動物」があります。

記事の目的

原則として、新しいツールを導入する決定が下された場合、チームメンバーは、遭遇した問題で構成される新しいソフトウェアの要件のリストを持っていることが理解されます。 個人的に、私が同じような状況にあったとき、ツールの機能とアプリケーションの特定の状況を説明したレビュー記事が本当にありませんでした。 したがって、この記事の目的は、Axiom要件管理システムの基本機能を説明することです。

問題の本質

顧客のニーズに合わせてカスタマイズできる市販のソフトウェアのニーズを集めたときに、要件を管理する問題に遭遇しました。 このプログラムの機能は、そのための一連の要件を決定します。 抽象的な例を使って説明します。 ユーザーができる既製のプログラムがあるとします：

• テキストボックスにテキストを入力します。
• 入力したテキストをdoc、xml、およびpdf形式で保存します。
• 入力したテキストを印刷します。

このソフトウェアを購入した最初の顧客は、上記のすべての機能が必要であると言いましたが、xmlおよびpdf形式を知らなかったため、この機会にお金を払いたくなかったため、入力したテキストをdoc形式でのみ保存しました。 これに基づいて、この顧客に関する次の一連の要件を取得します。

すべてのソフトウェア機能	お客様の要件1
テキストフィールドにテキストを入力します。 入力したテキストをdoc、xml、pdf形式で保存します。 入力したテキストを印刷します。	テキストフィールドにテキストを入力します。 入力したテキストをdoc 、xmlおよびpdf形式で保存します。 入力したテキストを印刷します。

2番目の顧客は、テキストを印刷する機能はまったく必要ないと述べました。 彼は、ドキュメントをdoc、xml、pdf形式で完全に印刷する独自のソフトウェアを持っています。 このお客様の場合、ソフトウェア要件のリストには次のものが含まれます。

すべてのソフトウェア機能	お客様の要件2
テキストフィールドにテキストを入力します。 入力したテキストをdoc、xml、pdf形式で保存します。 入力したテキストを印刷します。	テキストフィールドにテキストを入力します。 入力したテキストをdoc、xml、pdf形式で保存します。 入力したテキストを印刷します。

そして、3番目の顧客は、すべての機能を備えたソフトウェアを購入しました。

すべてのソフトウェア機能	お客様の要件3
テキストフィールドにテキストを入力します。 入力したテキストをdoc、xml、pdf形式で保存します。 入力したテキストを印刷します。	テキストフィールドにテキストを入力します。 入力したテキストをdoc、xml、pdf形式で保存します。 入力したテキストを印刷します。

これは、特定の顧客向けに構成された購入製品の要件の数が、プログラム機能の数以下であることを意味します。

プログラムの品質を改善する過程で、機能の数が大幅に増加しました。 その結果、要件の数が増えました。 技術仕様（TOR）の文書は非常に面倒になりました。 技術専門家と顧客の両方にとって、それらに侵入することははるかに困難になりました。 さらに、このような多数の機会を念頭に置くことはより困難になっています。 実装された機能が欠落する可能性が増加しました。

現在の状況のた​​め、すべてのソフトウェア要件を説明できるツールを試すことにしました。 特定のプロジェクトで考えられるすべての要件の完全なリストから、顧客のニーズを満たす要件を選択する必要があります。 このセットに基づいて、ツールは、参照条件の作成タスクを簡素化するために、ドキュメントをドキュメント形式で自動的に生成する必要もあります。 さらに、要件と、この特定の要件をソフトウェアに含めるか除外するために実行する必要があるアクションとの関係を決定できることが必要です。

さまざまなSUTを試した後（ 要件管理ツールのリストの記事から主に無料のツールが選択されました）、 iConcur Axiomツールに落ち着きました。

公理

Axiomは、無料のクロスプラットフォームクライアント/サーバー要件管理アプリケーションです。
また、開発者は追加機能を備えた有料版の製品も持っていますが、Axiomは無料製品として位置付けられていることに注意してください。無料版の機能は要件の処理を簡素化するのに十分なためです。

では、なぜ公理なのでしょうか？ このツールを選択した理由は次のとおりです。

• フリーソフトウェア。
• ツールの柔軟性（特定の会社またはプロジェクトの特性に応じてツールを使用して作業をカスタマイズする機能）;
• ツールのシンプルさ;
• ツールに保存されたデータに基づいてドキュメントを生成する機能。

ただし、この製品の主な機能について詳しく説明します。

公理との最初の知り合い

ユーザー認証後、メインツールウィンドウが開きます。



次の論理部分に分割できます。

• ツールバーとメニュー（上部）;
• アーティファクトツリー（ウィンドウの左側にあります。アーティファクトとは以下で説明します）。
• アーティファクトに関する情報を編集するウィンドウ（中央）。
• 右側と下部にある補助セクション（ビュー）。

では、アーティファクトとは何ですか？ アーティファクトとは、要件、テストケースなどのソフトウェアで作業するときに生成および/または使用されるプロジェクト製品です。Axiomでは、この用語は非常に積極的に使用されます。

ユーザーが作成したすべてのオブジェクトはアーティファクトであり、それらはすべてアーティファクトツリーに表示されます。

作成される成果物のリストとそれらから収集される情報は、成果物テンプレートを使用してツールのユーザー自身が決定します。

アーティファクトテンプレートの作成

この機能のおかげで、このツールは非常に柔軟で、チームメンバーのさまざまなニーズに合わせてカスタマイズできます。

テンプレートとは何ですか？ テンプレートは、成果物を記述するために使用される属性のセットです。 たとえば、仕事には、成果物の機能要件が必要です。 機能的には、要件には次の情報が含まれている必要があります。

• タイトル（「ドキュメントの保存」、「インターフェイスへのボタンの追加」、「データ転送」）;
• 説明（例：「OK」ボタンが押されると、システムはドキュメントを保存する必要があります）;
• クレームのソース、つまり それを声に出した人;
• この要件の議論で生じる問題。
• たとえば、「承認済み」、「同意済み」、「レビュー済み」、「拒否済み」などの要件ステータス
• 優先順位 この要件を実装することの重要性。
• この要件が製品の最初のバージョンに実装されるかどうかに関する情報。

上記のリストは、製品のすべての機能要件の説明が実行される一連のデータ（属性）です。

Axiomの属性にはさまざまなタイプがあります。これらは、テキストフィールド、ユーザーが設定した値のリストを含むドロップダウンリスト、およびアーティファクトに特定のプロパティがあるかどうかをマークできるフラグ属性です。

上記の機能要件の属性から、属性「ソース」と「質問」はテキストフィールドであり、「ステータス」と「優先度」はドロップダウンリストであると仮定するのが論理的であり、製品の最初のバージョンに入る要件に関する情報はフラグで実装できます。 下の図は、「要件」と呼ばれる機能要件テンプレートが実装された例を示しています。



作成されたテンプレートに基づいて、無制限の数のアーティファクトを生成することが可能になります。

アーティファクトの作成

アーティファクト自体の作成は次のとおりです。

1. 成果物ツリーで、この成果物が属するノード（成果物のグループ）を選択します。
2. 次に、作成するアーティファクトに基づいてテンプレートを選択する必要があります。
   
3. 成果物の名前（名前）を設定します。
4. そして、その属性と説明を編集します。

下の図は、テンプレート「Requirements」に基づいて機能要件「Entering Text」の成果物を作成した結果を示しています。



同様に、他のテンプレートに基づいて成果物を作成できます。 次の図では、特定の機能をソフトウェアに含めるために実行する必要があるアクションの説明を含むプログラム設定のアーティファクトが作成されます。 このアーティファクトは異なるテンプレートに基づいて作成されたため、異なる属性セットがあります。

アーティファクト間の関係

Axiomには、アーティファクト間のリンクを識別するための特別な「Linking Surface」セクションがあります。 Axiomは標準的な関係テンプレートを実装します。これに基づいて、「関連付け」、「なしでは実装できません」、「親要素」など、さまざまなタイプの関係を作成できます。選択したタイプの接続のアーティファクト。 次の図は、新しいタイプの「必須」通信を使用して作成された機能要件と設定の相互接続を示しています。



通信データは、この機能またはその機能が機能するために必要な設定を示します。

さらに、さらに明確にするためにアーティファクトの説明に追加できる他のアーティファクトへのハイパーリンクは、相互接続として機能できます。

MS Wordとの統合

AxiomはMS Wordと統合されているため、作成されたアーティファクトに関する情報を含むドキュメントを作成できます。 この機能は、技術要件（ソフトウェア要件仕様）、ビジョン（ビジョン）、その他のプロジェクトドキュメントなどのドキュメントの形成を簡素化することを目的としています。 必要なアーティファクト情報はすでにAxiomに保存されており、ユーザーはこの情報を手動で再入力する必要はありません。

MS WordのコンピューターにAxiomをインストールすると、特別なタブ「Axiom」が表示され、ユーザーはこれを使用してドキュメントテンプレートを作成できます。 これを行うには、ユーザーはドキュメント内の適切な場所に、選択したアーティファクトの属性へのリンクを配置する必要があります。 次の図では、アーティファクトに関する次の情報を含むドキュメントテンプレートが作成されます。

• 名前（名前）;
• 識別番号（ID）;
• 非機能要件の説明（コンテンツ）。

その後、ユーザーは必要なすべてのデータを含む完成したドキュメントを生成できます。



AxiomとMS Wordバージョン 2007、2010との統合のみを検証したことに注意してください。 2013バージョンもテストされましたが、統合は機能しません。

アーティファクト表

アーティファクトテーブルは、便利な表形式でアーティファクトのセットを表示するための公理の特別なセクションです。



このセクションの便利な機能の1つとして、複数のアーティファクトの属性を一度に変更することを検討します。 たとえば、いくつかの要件のステータスを一度に「完了」に変更する必要があります。



私の意見では、この機能はアーティファクトの編集を大幅に高速化します。

さらに

作業プロセスでツールを実装する現在の段階で使用し、非常に便利であることがわかった主なAxiom機能は、上記にリストされています。 しかし、さらに、次の便利な機能が無料版のAxiomに実装されています。

• 議論 ユーザーは、特別なディスカッションセクションを使用してアーティファクトについて議論し、フィードバックを得ることができます。
• ユーザー管理。 この機能により、新しいユーザーを作成し、ユーザー名とパスワードを決定できます。 残念ながら、現在のバージョンの製品では、2つのユーザーロールのみが実装されています。何でもできる管理者と、成果物のみを表示できる単純な「致命的な」ユーザーです。
• 履歴セクションを使用して、さまざまなバージョンのアーティファクトと属性のバージョン履歴を表示します。
• 生成されたデータをxml、xls形式でエクスポートします。

有料版についても利用可能です：

• 公理ルール言語。 私が個人的に試してみたい機能です。 その本質は何ですか？ IConcurは、要件の説明言語を作成して、それらを理解する際のあいまいさを回避しています。 さらに、書面による要件の正確性をチェックするエディターが作成されました。 以下の図は、特定の言語で書かれた要件の明確な例を示しています。
• インターフェイスのプロトタイピング。 Axiomの有料版には、プロトタイプエディターが組み込まれています。 作成されたインターフェースも成果物と見なされ、他の成果物と関連付けることができます。
  
• 特別なリンクマトリックスセクションを使用して、要件トレースマトリックスを表示します。 このセクションでは、下図に示すように、アーティファクト間の関係を表形式で表示できます。
  
• アーティファクトリンクの階層ツリーを表示します（リンクツリー）。
  

注：ツールの有料版の機能は、Axiomユーザーガイドに基づいて説明されており、私はテストしていません。

合計

要約すると、この製品の特定された利点と欠点をリストしたいと思います。

長所

無料。 私がテストした無料のツールの中で、このシステムは最も「まともな」ものです。 開発会社のすてきなサイト、簡単なインストール、使いやすいインターフェイス。 さらに、無料のツールの場合、少なくとも私の問題を解決するために、プログラムには十分な数の機能があります。

ツールの柔軟性。 ユーザーが作業時に使用するアーティファクトのテンプレートをユーザー自身が作成する可能性があるため、このツールはさまざまなプロジェクトで使用できます。

作業の単純さ。 まず、直感的なインターフェースです。 第二に、このツールには洗練された作業設定や追加のパラメーターはありません。たとえば、MS Wordには、オプションのメニューに、ソフトウェアの操作の重要ではあるが明らかでない側面を定義するセクションがあります。 さらに、Axiomには、ツールの基本的な機能と、ツールでの作業を大幅に簡素化できる追加の「機能」について、ユーザーにアクセス可能な方法で説明する無料のビデオチュートリアルがあります。

クロスプラットフォーム。 バージョン4.0は、Windows OSおよびLinuxでのみインストールに使用できました。 新しいバージョン4.1では、Mac OSに製品をインストールできるようになりました。

短所

奇妙な会社。 このプログラムに初めて出会ったのはStack Overflowで言及されました。「iConcur SoftwareのCEO」であるBrent Wilsonがこの製品を宣伝しました。 ブレントの答え、特にこれに対するコメント：「最近この製品を試しましたが、管理者としてログインすることさえできませんでした。 電話、メール、サポートチケットのオープンを試みましたが、1週間経っても応答がありませんでした。 iConcurはまだ生きていますか？」 それに加えて、テクニカルサポートは非​​常に奇妙に動作します。同じ日に応答することもあれば、数週間応答しないこともあれば、まったく沈黙することもあります。 会社を正当化するために、ソフトウェアの新しいバージョンが最近リリースされたため、「患者は死んでいるよりも生きている可能性が高い」と言えます。

ソフトウェアエラー。 製品を使用したり、1時間ごとの作業の結果を削除したりすることを不可能にするエラーは見つかりませんでした。 ソフトウェアのインストール、クライアント部分の起動（サーバーの再起動が必要になる前）に関連するバグがあったか、インターフェイスアイコンが表示されませんでした...しかし、これはあまり快適ではありません。 一方、私たちの多くはMS Wordで作業しています...

MS Word 2013との統合の欠如。これは本当に残念です。 私はこの機能が非常に便利だと思っていますが、他のソフトウェアのバージョンを選択するのに制限があるためです。 しかし、おそらくすべては次のバージョンで修正されるでしょう。

PS

個人的に、私はこのツールが本当に好きです。 残念ながら、実装の最終結果を説明することはできません。これは、さまざまな理由により、迅速なプロセスではないためです。 いずれにせよ、Axiomは、要件管理システムなどの「動物」と簡単に知り合う場合でも役立つと考えています。