[[アドオン]]に係る、ドキュメントについて。
* 概要 [#se42f92d]
** 分類 [#o7f4dba5]
一般的には、下記にグルーピングすることができる。
+基本設計書・概要設計書・外部設計書etcと呼ばれる、コンセプトやプラットフォームならびに技術的制約が記されているドキュメント
+詳細設計書・内部設計書etcと呼ばれる、上記１に数式やマッピングおよび書式等の細微なレベルが補足されているドキュメント
+上記について、一覧などで網羅性を担保するドキュメント
これらについては、各々のベンダで定義されており、同じ言葉を使用していても意味が異なることが起こり得るため、当wikiでは下記の通りに定義する。
*** A [#j50f07fd]
業務の遂行に必要な手順と手段が網羅されており、マニュアル作業かシステム化の対象であるか、またシステム化の対象であっても、SAP標準であるか[[アドオン]]対象であるかを定義したドキュメント。
[[業務プロセス一覧>成果物/業務プロセス一覧]]、[[業務プロセスフロー>成果物/業務プロセスフロー]]、[[要件定義書>成果物/要件定義書]]など。つまり、[[業務設計ドキュメント>成果物/業務設計ドキュメント]]の範疇とする。
*** B [#u732ce2f]
上記Aのうち、Add-on化の検討対象となり、採用可否の判定とその理由や経緯が記録されたドキュメント。
[[追加開発一覧>成果物/追加開発一覧]]、[[課題管理表>成果物/課題管理表]]、[[変更管理表>成果物/変更管理表]]などが該当するが、論点がブレるため[[追加開発一覧>成果物/追加開発一覧]]のみ追加開発ドキュメントの範疇とする。
*** C [#c760f986]
上記Bのうち、採用となったAdd-onテーマについて、要求される機能と実装手段の概要、および制約条件が漏れなく記述されたドキュメントを指し、[[概要設計書>成果物/概要設計書]]と呼ぶ。
*** D [#yaffb4da]
上記Cについて、機能要求が実装可能なレベルで記述されたドキュメントを指し、[[詳細設計書>成果物/詳細設計書]]と呼ぶ。
*** E [#jff7f115]
上記BおよびCで定義した機能について、記述通り動作することおよび記述外の動作をしないことについて、試験日・試験項目・試験結果を記述したドキュメントを指し、実装者が作成するものを[[単体テスト結果記述書>成果物/単体テスト結果記述書]]と呼び、実装者<>設計者の場合に設計者が作成するものを[[受入テスト結果記述書>成果物/受入テスト結果記述書]]と呼ぶ。
*** F [#v048916d]
システムに実装したリポジトリオブジェクトについて、オブジェクト名や[[テーブル>SAPのオブジェクト/テーブル]]や[[汎用モジュール>SAPのオブジェクト/汎用モジュール]]などの分類の記載、および実装の理由や要因（[[アドオン]]、[[モディフィケーション>SAPの拡張手段/モディフィケーション]]、[[Note>SAPの共通用語/Note]]など）が補足されているドキュメントを指し、[[オブジェクト一覧>成果物/オブジェクト一覧]]と呼ぶ。
システムに実装したリポジトリオブジェクトについて、オブジェクト名や[[テーブル>SAPのオブジェクト/テーブル]]や[[汎用モジュール>SAPのオブジェクト/汎用モジュール]]などの分類の記載、および実装の理由や要因（[[アドオン]]、[[モディフィケーション>SAPの拡張手段/モディフィケーション]]、[[SAP Note]]など）が補足されているドキュメントを指し、[[オブジェクト一覧>成果物/オブジェクト一覧]]と呼ぶ。
なお、このページでは、設計フェーズ〜実現化フェーズにおいて作成するB〜Fそれぞれについて、下記に詳細を記す。
** 前提 [#x8cf9f19]
ログとして残すことが重要かのように語られることが多く、確かにその面も勿論なのだが、それだと後付け的に「何であれ、残せばいいんでしょ」となってしまいがち。
最も重要なのは、''形になる前に形にすること''。
時間的な、要員的な制約から「それはできない」と言われがちだが、一定程度の品質を保つためにはこうするほかないのだ。
さもなくば、[[カプセル化>アドオン/カプセル化]]や[[参照整合性>アドオン/参照整合性]]の保持が無駄なく成立しなかったり、更に具体的には変数の重複・iTABの設計と利用・ネーミングルールのグダグダ化など、ロクなことにならない。
しかし、''ずっと自分が面倒みる訳ではないから''と書き逃げする輩にとっては上記の観点は鬱陶しいだけに過ぎず、放っておいたら際限なく適当にやりだす。
先達やリードとして、こういった残念な人も戦力として組み込まなければならない場合、啓蒙・誘導のほか、「レビュー」という重要な工程を時間と気力を割いてでも実施しなければならないという覚悟を欠いてはならない。
* 規約 [#yd7e2932]
上記の括りには含まれないが、重要なドキュメントとして[[コーディング規約>成果物/コーディング規約]]と[[オブジェクト命名規約>成果物/オブジェクト命名規約]]があり、それぞれリンク先を参照されたい。
~
~
CENTER:【スポンサードリンク】
#htmlinsert(amazon_book_sap_system_implement)
~
~
----
#pcomment(reply)
