インターフェース制御文書

システム工学^[1]とソフトウェア工学におけるインターフェース制御文書（ICD）は、プロジェクトのために生成されたすべてのインターフェース情報（図面、図表、表、テキスト情報など）の記録を提供します。^{[2]基礎となるインターフェース文書は詳細を提供し、}サブシステム間またはシステムまたはサブシステムへのインターフェースを記述します。

ICD はシステム インターフェイスを網羅する包括的なドキュメントです。これらのインターフェイス仕様で説明する必要がある内容の例には、次のものがあります。

• 個別の SIRS (ソフトウェア インターフェイス要件仕様) および HIRS (ハードウェア インターフェイス要件仕様) ドキュメントに文書化された単一システムの入力と出力は、「Wikipedia インターフェイス制御ドキュメント」に該当します。
• 2 つのシステムまたはサブシステム間のインターフェース (例: 「Doghouse から Outhouse へのインターフェース」) にも親 ICD が存在します。
• 最下位の物理要素 (例: 嵌合プラグ、電気信号電圧レベル) から最上位の論理レベル (例: OSI モデルのレベル 7アプリケーション層) までの完全なインターフェイス プロトコルは、それぞれ適切なインターフェイス要件仕様に文書化され、「システム」の単一の ICD に含まれます。

ICD の目的は、特定のプロジェクトのシステム インターフェース情報の記録を管理および維持することです。これには、システムの潜在的または実際のユーザーに対するシステムへのすべての可能な入力とシステムからのすべての潜在的な出力が含まれます。システムまたはサブシステムの内部インターフェースは、それぞれのインターフェース要件仕様に文書化されていますが、ヒューマン マシン インターフェースは、システム設計ドキュメント (ソフトウェア設計ドキュメントなど) ^{[引用が必要]}に記載されている場合があります。

インターフェース制御ドキュメントは、システムの文書化されたインターフェースを制御するだけでなく、連携して動作するインターフェース バージョンのセットを指定して要件を制限するため、 システム エンジニアリングの重要な要素です。

アプリケーション プログラミング インターフェイスは、ソフトウェア システムのインターフェイスの一種で、インターフェイスを介してシステムが提供する機能やサービスにアクセスする方法を記述します。システム プロデューサーが他のユーザーがシステムを使用できるようにしたい場合、ICD とインターフェイス仕様 (または同等のもの) は価値のある投資です。

ICD では、詳細なインターフェース ドキュメント自体のみを記述し、接続に使用するシステムの特性は記述しません。これらのシステムの機能とロジックは、必要に応じて、独自の要件および設計ドキュメントに記述する必要があります。このようにして、独立したチームが、インターフェースを介して送信されるデータや信号に他のシステムがどのように反応するかに関係なく、指定されたインターフェースを使用する接続システムを開発できます。たとえば、ICD と関連するインターフェース ドキュメントには、データのサイズ、形式、測定対象に関する情報を含める必要がありますが、ユーザーが意図する使用方法におけるデータの 最終的な意味は含めないでください。

適切に定義されたインターフェースがあれば、チームは単純な通信シミュレーターで反対側をシミュレートすることで、インターフェースの実装をテストできます。インターフェースの反対側のシステムのビジネス ロジックを知らないと、他のシステムがビジネス ルールやロジックを変更しても壊れないシステムを開発する可能性が高くなります (インターフェース要件仕様では、制限や健全性チェックの規定は明確に避ける必要があります)。このようにして、メンテナンスと拡張性を容易にする優れたモジュール性と抽象性が実現されます。