ISO/IEC 23396:2020 システムおよびソフトウェアエンジニアリング—レビューツールの機能 | ページ 2

※一部、英文及び仏文を自動翻訳した日本語訳を使用しています。

序文

ISO (国際標準化機構) と IEC (国際電気標準会議) は、世界標準化のための専門システムを形成しています。 ISO または IEC のメンバーである国家機関は、技術活動の特定の分野を扱うために、それぞれの組織によって設立された技術委員会を通じて、国際規格の開発に参加しています。 ISO と IEC の技術委員会は、相互に関心のある分野で協力しています。 ISO および IEC と連携して、政府および非政府の他の国際機関もこの作業に参加しています。

この文書の開発に使用された手順と、今後の維持のために意図された手順は、ISO/IEC 指令で説明されています。 1. 特に、さまざまなタイプの文書に必要なさまざまな承認基準に注意する必要があります。この文書は、ISO/IEC 指令の編集規則に従って作成されました。 2 ( www.iso.org/directives を参照)

このドキュメントの要素の一部が特許権の対象となる可能性があることに注意してください。 ISO および IEC は、そのような特許権の一部またはすべてを特定する責任を負わないものとします。ドキュメントの開発中に特定された特許権の詳細は、序論および/または受信した特許宣言の ISO リスト ( www.iso.org/patents を参照) または受信した特許宣言の IEC リスト ( http://patents.iec.ch )

このドキュメントで使用されている商号は、ユーザーの便宜のために提供された情報であり、保証を構成するものではありません。

規格の自発的な性質の説明、適合性評価に関連する ISO 固有の用語と表現の意味、および技術的貿易障壁 (TBT) における世界貿易機関 (WTO) の原則への ISO の準拠に関する情報については、以下を参照してください。 www.iso.org/iso/foreword.html .

この文書は、合同技術委員会 ISO/IEC JTC 1, 情報技術、小委員会 SC 7, ソフトウェアおよびシステム工学によって作成されました。

序章

ほとんどすべてのソフトウェア開発組織が適切なコストでソフトウェアの品質を向上させる必要があることは広く認識されており、レビューは重要な手段の 1 つです。ライフサイクルの早い段階でレビューを適用すると、通常のプロジェクトでの不要なやり直しの量を減らすことが知られています。これは、上流で問題を検出する方が、下流工程でテストを行って問題を検出するよりもコストがかからないためです。このようにレビューを実施することで、問題を早期に検出し、代替案を評価し、組織的および個人的なプロセスを改善し、仕事の成果を改善することができます。 ISO/IEC 20246 は、作業成果物レビューの標準プロセスを指定しています。

レビュー支援ツールは、レビュー作業を改善し、レビューの質を向上させる機能を提供します。たとえば、レビュー担当者間のコラボレーションとコミュニケーションのサポート、作業成果物に関するコメントの記録と強調表示、レビュー レポートの生成のサポートなどです。

レビューでの指摘事項が千を超える大規模な開発プロジェクトでは、支援ツールは欠かせません。中小規模のプロジェクトでも、レビューの質と効率を向上させるために支援ツールが積極的に使用されています。実に様々な「レビューツール」が提供されています。たとえば、ドキュメント作成のマクロ機能を使用して、コメントをタグとして追加できる比較的単純な機能があります。一方、数十名のレビュアーが課題を指摘し、プロジェクトマネージャーがレビューの実施状況をモニタリングする大規模な開発では、プロジェクト全体の進捗管理を支援するツールがあります。

大規模な組織では、さまざまな種類のレビュー ツールから適切なツールを選択することが非常に重要です。選択するツールは公平性が高く、公的な基準で評価されていることが不可欠です。そのために、2017年にソフトウェアエンジニアリングツールの評価と選択のプロセスに関するISO/IEC 20741が発行されました。ただし、ISO/IEC 20741は、特定のツール分野に依存せずに一般化されているため、レビューに固有の標準機能を規定していません。

この文書は、レビュー支援ツールの機能を定義し、ツールの評価と選択のために ISO/IEC 20741 と組み合わせて適切なツールを選択することを目的としています (付録 E を参照)本書で想定しているレビュー支援ツールは、ISO/IEC 20246 で規定されているプロセス全体をサポートしています。たとえば、成果物の閲覧や指摘などの個人的な活動をサポートする機能と、状況の報告などのグループの活動をサポートする機能が必要です。 (附属書 D を参照) ISO/IEC 30130 テストツールで定義されているソースコードチェックなどのチェック作業自体は含まれておらず、人がチェックしているものとします。

1 スコープ

このドキュメントでは、レビュー作業をサポートするツールの機能を指定します。

レビュー ツールの評価と選択は、一般的な評価選択プロセスと評価特性を定義する ISO/IEC 20741 に従って実行されます。このドキュメントでは、プロセス内のレビュー ツールに固有の機能を定義します。この 2 つの基準を併用することで、レビュー ツールの評価と選択から客観的かつ合理的な結果を導き出すことができます。

レビュー作業は、ISO/IEC 20246 で定義されたプロセス、アクティビティ、およびタスクに基づいています。また、レビュー対象は ISO/IEC 20246 で定義されていると想定されています。サードパーティですが、プロジェクト内です。

このドキュメントで指定されているレビュー ツールの機能は、ISO/IEC 20246 で定義されているレビュー プロセスと調和しています。このドキュメントには、ISO/IEC 30130 で定義されている自動ソース コード チェッカーなど、レビューを実施するための自動化されたプロセス、アクティビティ、またはタスクは含まれていません。

レビューで特定された問題は、ツールによって記録および管理されます。ただし、テストで見つかった欠陥や、レビュー以外で一般的に見つかった問題は、このドキュメントの範囲外です。

2 参考文献

以下のドキュメントは、その内容の一部またはすべてがこのドキュメントの要件を構成するように、本文で参照されています。日付のある参考文献については、引用された版のみが適用されます。日付のない参照については、参照文書の最新版 (修正を含む) が適用されます。

  • ISO/IEC 20246, ソフトウェアおよびシステム工学 — 作業成果物のレビュー

3 用語と定義

このドキュメントの目的のために、ISO/IEC 20246 および以下に記載されている用語と定義が適用されます。

ISO および IEC は、次のアドレスで標準化に使用する用語データベースを維持しています。

3.1

実在物

属性および他のエンティティとの関係を持つデータの概念

[出典: ISO/TR 25100:2012, 2.1.3, 修正 — 注記は削除されました。]

3.2

レビューフォルダ

レビューのリストとレビューに共通の情報を含む、1 つまたは複数の関連するレビューをバインドするための エンティティ (3.1)

注記 1:レビューに共通の情報には、レビューに参加または組織できるメンバーに関する情報、およびレビュー中に特定された問題に与えられた分類に関する情報を含めることができます。

参考文献

[1]ISO/IEC 19505-2, 情報技術 — オブジェクト管理グループ統一モデリング言語 (OMG UML) — 2: 上部構造
[2]ISO/IEC 20741, システムおよびソフトウェア エンジニアリング — ソフトウェア エンジニアリング ツールの評価と選択のガイドライン
[3]ISO/IEC 30130, ソフトウェア工学 — ソフトウェア テスト ツールの機能
[4]ISO/TR 25100:2012, インテリジェント輸送システム - システム アーキテクチャ - ITS データ概念の調和

Foreword

ISO (the International Organization for Standardization) and IEC (the International Electrotechnical Commission) form the specialized system for worldwide standardization. National bodies that are members of ISO or IEC participate in the development of International Standards through technical committees established by the respective organization to deal with particular fields of technical activity. ISO and IEC technical committees collaborate in fields of mutual interest. Other international organizations, governmental and non-governmental, in liaison with ISO and IEC, also take part in the work.

The procedures used to develop this document and those intended for its further maintenance are described in the ISO/IEC Directives, 1. In particular, the different approval criteria needed for the different types of document should be noted. This document was drafted in accordance with the editorial rules of the ISO/IEC Directives, 2 (see www.iso.org/directives ).

Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. ISO and IEC shall not be held responsible for identifying any or all such patent rights. Details of any patent rights identified during the development of the document will be in the Introduction and/or on the ISO list of patent declarations received (see www.iso.org/patents ) or the IEC list of patent declarations received (see http://patents.iec.ch ).

Any trade name used in this document is information given for the convenience of users and does not constitute an endorsement.

For an explanation of the voluntary nature of standards, the meaning of ISO specific terms and expressions related to conformity assessment, as well as information about ISO's adherence to the World Trade Organization (WTO) principles in the Technical Barriers to Trade (TBT), see www.iso.org/iso/foreword.html .

This document was prepared by Joint Technical Committee ISO/IEC JTC 1, Information technology, Subcommittee SC 7, Software and systems engineering.

Introduction

It is widely recognized that almost all software development organizations need to improve the quality of software at an appropriate cost and review is one important means. Applying reviews early in the lifecycle is known to reduce the amount of unnecessary rework in regular projects. This is because problem detection in upstream requires less cost than detection of problems by performing tests in downstream processes. By conducting the review in this way, it is possible to detect problems early, evaluate alternatives, improve organizational and personal processes, and improve work outcomes. ISO/IEC 20246 specifies a standard process for work product reviews.

Review support tools provide capabilities to improve review work and improve review quality, for example support for collaboration and communication between reviewers, logging and highlighting comments made on a work product, and support for review report generation.

Support tools are indispensable in the large-scale development project where the number of items pointed out in the review exceeds one thousand. Support tools are also actively used in small and medium-sized projects to improve review quality and efficiency. Indeed, various kinds of “review tools” are provided. For example, there is a relatively simple capability that allows you to add comments as a tag using the macro function of document creation. On the other hand, there are tools to support the progress management of the entire project in the large-scale development in which dozens of reviewers point out issues and the project manager monitors the status of the review implementation status.

In large organizations, it is very important to select appropriate tools from among various kinds of review tools. It is essential that the selected tool has a high degree of fairness and is evaluated according to public standards. For this purpose, ISO/IEC 20741 on the process of evaluation and selection of software engineering tools was published in 2017. However, ISO/IEC 20741 does not prescribe standard capabilities specific to reviews because it is generalized without depending on a specific tool field.

This document aims to define the capabilities of review support tools and to select the appropriate tool in combination with ISO/IEC 20741 for tool evaluation and selection (see Annex E). The review support tool assumed in this document supports the entire process specified in ISO/IEC 20246. For example, capabilities which support personal activities such as viewing and pointing out deliverables are necessary, and capabilities which support group activities such as reporting of situations are necessary (see Annex D). It is assumed that the check work itself such as the source code check defined in the ISO/IEC 30130 test tool is not included, and it is assumed that humans are checking.

1 Scope

This document specifies the capabilities of a tool to support review work.

The evaluation and selection of the review tools are performed in accordance with ISO/IEC 20741 which defines the general evaluation selection process and evaluation characteristics. This document defines capabilities specific to review tools in the process. By using these two standards together, it is possible to derive objective and reasonable results of the evaluation and selection of review tools.

The review work is based on the process, activities, and tasks defined in ISO/IEC 20246. It is also assumed that the review targets are defined in ISO/IEC 20246. The review work in this document is assumed not to be performed by a 3rd party, but within a project.

The review tool capabilities specified in this document harmonize with the review process defined in ISO/IEC 20246. This document does not include automated process, activities, or tasks for conducting reviews such as automated source code checkers defined in ISO/IEC 30130.

Issues which are identified in the review are recorded and managed by the tool; but defects found in tests and issues found in general except for reviews are out of the scope of this document.

2 Normative references

The following documents are referred to in the text in such a way that some or all of their content constitutes requirements of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.

  • ISO/IEC 20246, Software and systems engineering — Work product reviews

3 Terms and definitions

For the purposes of this document, the terms and definitions given in ISO/IEC 20246 and the following apply.

ISO and IEC maintain terminological databases for use in standardization at the following addresses:

3.1

entity

data concept that may have attributes and relationships to other entities

[SOURCE: ISO/TR 25100:2012, 2.1.3, modified — NOTE has been removed.]

3.2

review folder

entity (3.1) for binding one or more related reviews, including a list of the reviews and information common to the reviews

Note 1 to entry: The information common to the reviews can include information on members who can participate in or organize the reviews, and information on the classification given to the issues identified during the reviews.

Bibliography

[1]ISO/IEC 19505-2, Information technology — Object Management Group Unified Modeling Language (OMG UML) — 2: Superstructure
[2]ISO/IEC 20741, Systems and software engineering — Guideline for the evaluation and selection of software engineering tools
[3]ISO/IEC 30130, Software engineering — Capabilities of software testing tools
[4]ISO/TR 25100:2012, Intelligent transport systems — Systems architecture — Harmonization of ITS data concepts