JPH05127879A - プログラム設計書生成方式 - Google Patents

Abstract

(57)【要約】 【目的】 本発明は、プログラム設計書生成方式に関
し、スケルトン、固有処理および部品を画面から入力
し、プログラム設計書およびプログラムソースを自動生
成して出力し、プログラムソースの修正漏れや修正ミス
をなくすことを目的とする。 【構成】 プログラムを構成するスケルトン、固有処理
および部品をそれぞれ表示された設計イメージから入力
するための画面１と、画面１から入力されたスケルト
ン、固有処理および部品をもとに合成して階層に対応づ
けて呼出元、呼出先を設定した構造図などを生成する設
計図編集処理３とを備え、この設計図編集処理３が生成
した構造図などをプログラム設計図として出力すると共
に併せてプログラムソースを生成して出力するように構
成する。

Description

【発明の詳細な説明】

【０００１】

【産業上の利用分野】本発明は、プログラム設計書を生
成するプログラム設計書生成方式に関するものである。
プログラム開発・保守において生産性を向上、品質向上
を目的としてプログラム設計書を生成する。具体的に
は、できるだけ既存のプログラム資産を再利用しようと
して、共通に使えるプログラムのロジック（機能）を切
り出し、プログラム開発しようとする場合、再利用でき
るしくみと、その開発方法のレビューの効率化が求めら
れている。

【０００２】

【従来の技術】従来、再利用するしくみを持っているツ
ールというのは存在したが、スケルトン、部品を合成し
た後、合成したプログラムでデバッグを行っていた。

【０００３】従って、プログラムを修正するだけでは、
設計書に反映されないため、プログラムと設計書との同
期が合わなくなり、プログラムを修正した後に併せて設
計書を修正するか、設計書を修正しないでプログラムに
よりメンテナンス（保守）していく必要があった。

【０００４】また、設計レビュー時のドキュメント（プ
ログラム設計書）に対してレビュー（チェック）し、修
正内容を記入しても、プログラム設計書からコーディン
グ（プログラムのロジックをコード化すること）すると
きに表現の変換が生じてしまい、修正漏れやロジックミ
スが発生し易かった。

【０００５】

【発明が解決しようとする課題】上述したように、従来
はプログラムを修正しても設計書に反映されないため、
プログラムによるメンテナンスを行うか、設計書も併せ
て修正する必要があり、修正漏れが発生したり、設計書
を併せて修正してこれからコーディングする際に修正漏
れやロジックミスが発生してしまうという問題があっ
た。

【０００６】本発明は、スケルトン、固有処理および部
品を表形式やＹＡＣチャート形式などで画面から入力
し、これをもとにプログラム設計書およびプログラムソ
ースを自動生成して出力し、出力されたプログラム設計
書をチェックして元の画面から修正入力して修正し、プ
ログラムソースの修正漏れや修正ミスをなくすことを目
的としている。

【０００７】

【課題を解決するための手段】図１は、本発明の原理ブ
ロック図を示す。図１において、画面１は、プログラム
を構成するスケルトン、固有処理および部品をそれぞれ
表示された設計イメージから入力するための画面であ
る。

【０００８】設計図編集処理３は、画面１から入力され
たスケルトン、固有処理および部品をもとに合成して階
層に対応づけて呼出元、呼出先を設定した構造図などを
生成するものである。

【０００９】

【作用】本発明は、図１に示すように、画面１上の設計
イメージからプログラムを構成するスケルトン、固有処
理および部品をそれぞれ入力し、設計図編集処理３がこ
れら入力されたスケルトン、固有処理および部品をもと
に合成して階層に対応づけて呼出元、呼出先を設定した
構造図などを生成し、この構造図などをプログラム設計
図として出力したり、併せてこの構造図からプログラム
ソースを生成して出力したりするようにしている。

【００１０】また、出力されたプログラム設計書を修正
したときに画面１の設計イメージからスケルトン、固有
処理および部品のうちの該当部分を修正し、この修正後
のスケルトン、固有処理および部品をもとに設計図編集
処理３がプログラム設計書および併せてプログラムソー
スを出力するようにしている。

【００１１】従って、スケルトン、固有処理および部品
を表形式やＹＡＣチャート形式などの画面上の設計イメ
ージから入力し、これらをもとにプログラム設計書およ
び併せてプログラムソースを自動生成して出力すること
により、出力されたプログラム設計書をチェックして元
の画面１から修正入力して修正し、プログラムソースの
修正漏れや修正ミスをなくすことが可能となる。

【００１２】

【実施例】次に、図１から図８を用いて本発明の実施例
の構成および動作を順次詳細に説明する。

【００１３】図１は、本発明の原理ブロック図を示す。
図１において、上段の表形式の設計イメージの画面１
は、スケルトンを設計イメージ上で入力するための画面
であって、例えば図４の下段の画面である。スケルトン
は、図２に示すように、プログラムの構成要素の中で最
上位の要素（他の要素を呼び出すが、他から呼び出され
ない要素）である。

【００１４】中段の表形式の設計イメージの画面１は、
固有処理や部品を設計イメージ上で入力するための画面
であって、例えば図４の上段の画面である。固有処理
は、図２に示すように、あるプログラムでのみ使用する
固有の処理である。部品は、図２に示すように、プログ
ラムのデータ部の一部と手続き部の一部からなり、再利
用を目的とした処理である。

【００１５】下段のＹＡＣチャート形式の設計イメージ
の画面１は、部品や固有処理を設計イメージ上で入力す
るための画面であって、例えば図５の上段の画面であ
る。プログラム開発・保守一貫支援システム２は、プロ
グラム開発および保守を一貫して支援するシステムであ
って、設計図編集処理３などから構成され、画面１上の
設計イメージから入力されたプログラムの設計情報であ
るスケルトン、固有処理、部品をもとに、プログラム設
計書４およびプログラムソース５を生成して出力するも
のである。出力されたプログラム設計書４をチェックし
て修正したときに、画面１上からスケルトン、固有処
理、部品のうちの該当する部分を修正したことに対応し
て、設計情報の修正に対応したプログラム設計書および
併せてプログラムソース５を自動生成して出力する。こ
れにより、設計情報を修正したときに、プログラムソー
スにその修正が漏れたり、修正ミスが発生したりするこ
とを無くすことが可能となる。

【００１６】設計図編集処理３は、画面１上の設計イメ
ージから入力されたスケルトン、固有処理、部品をもと
にプログラム設計図４およびプログラムソース５を生成
するものである（図４から図８を用いて後述する）。

【００１７】プログラム設計書４は、画面１上の設計イ
メージから入力したスケルトン、固有処理、部品をもと
にプログラムの設計情報を判り易くしたものであって、
例えば図３に示すような情報からなるものである（図
７、図８の具体例参照）。

【００１８】プログラムソース５は、画面１上の設計イ
メージから入力したスケルトン、固有処理、部品をもと
に生成したプログラムソースである。Ａファイルないし
Ｆファイルは、各種中間結果を格納するファイルである
（図４から図８を参照）。

【００１９】図２は、本発明のプログラムの構成要素と
なるスケルトン、固有処理および部品の説明図を示す。
図２において、プログラムの構成要素は、図示のように
スケルトン、固有処理および部品から構成されている。

【００２０】スケルトンは、プログラムの構成要素の中
で最上位の要素であって、他の要素を呼び出すが他から
呼び出されない要素である。固有処理は、あるプログラ
ムでのみ使用する処理であって、データ部と手続き部か
ら構成される。

【００２１】部品は、プログラムのデータ部の一部と手
続き部の一部からなり、再利用を目的とした処理であ
る。図３は、本発明のプログラム設計書例を示す。プロ
グラム設計書は、図示のよう概要リスト、ファイル詳細
リスト、部品／固有処理構造図リスト、実パラメタ値一
覧リスト、処理説明一覧リスト、データ定義一覧リス
ト、固有処理仕様書リストから構成されている。

【００２２】・概要リストは、プログラムの概要であっ
て、スケルトン仕様よりドキュメント出力する（図４、
図７参照）。 ・ファイル詳細リストは、プログラムで使用するファイ
ルの詳細仕様であって、スケルトン仕様よりドキュメン
ト出力する（図４、図７参照）。

【００２３】・部品／固有処理構造図リストは、プログ
ラムを構成している部品／固有処理の構造図であって、
プログラムの合成情報（スケルトン・部品／固有処理の
関係および可変パラメタに対する決定値）よりドキュメ
ント出力する（図４、図５、図７参照）。

【００２４】・実パラメタ値一覧リストは、部品で持っ
ている可変パラメタに対する決定値であって、プログラ
ムの合成情報（スケルトン・部品／固有処理の関係およ
び可変パラメタに対する決定値）よりドキュメント出力
する（図４、図５、図７参照）。

【００２５】・処理説明一覧リストは、プログラムを構
成している部品／固有処理の処理説明であって、スケル
トン仕様／部品仕様／固有処理仕様よりドキュメント出
力する（図４、図５、図７参照）。

【００２６】・データ定義一覧リストは、プログラムで
使用しているデータ部の内容一覧であって、合成後のプ
ログラムよりドキュメントより出力する（図４、図５、
図８参照）。

【００２７】・固有処理仕様書リストは、プログラム固
有のロジックの仕様書（ＹＰＳ、デシジン表、編集表）
であって、スケルトン仕様／部品仕様／固有処理仕様よ
りドキュメント出力する（図４、図５、図８参照）。

【００２８】次に、図４から図８を用いて図１の構成の
具体例を説明する。図４において、Ａファイルは、表形
式の設計イメージの画面１上で入力された情報（部品／
固有処理）を格納するものである。

【００２９】Ｇファイルは、表形式で入力された情報を
ＹＡＣチャート形式に変換して各ステートメントに対応
させて格納するものである。Ｂファイルは、表形式の設
計イメージの画面１上で入力された情報（スケルトン）
を格納するものである。

【００３０】Ｃファイルは、ＹＡＣチャート形式の設計
イメージの画面１上で入力された情報（部品など）を格
納するものである。Ｄファイルは、ＹＡＣチャート形式
の情報から各ステートメントに対応させて、行番号
（ａ）、ＩＤ（ｂ）を付加して格納するものである。

【００３１】Ｅファイルは、部品、固有処理をどうよう
に合成するかを指示した情報および部品のロジック内に
ある可変パラメタに対する実パラメタ値を格納するもの
である。

【００３２】Ｆファイルは、Ｄファイルの情報につい
て、Ｅファイルの情報をもとに合成して格納したもので
ある。このＦファイルの情報を、プログラムソースとし
て出力する。

【００３３】次に、図４から図８の動作を説明する。Ｓ
１は、表形式の設計イメージの画面１から図示のように
固有処理０１について、 １．Ｘは１以上２０以下か Ｙ Ｎ 何もしない Ｘ エラーコードをセット Ｘ というように入力する。同様に、下段の １．ＣＡＬＬ 部品０２ ２．ＣＡＬＬ 固有処理０２ というように入力する。そして、これら入力した固執処
理０１について図示データ部および手続き部の形式にし
てＡファイルに図示のように格納する。

【００３４】Ｓ２は、部品／固有処理１１がＡファイル
から取り出した表形式の固有処理０１を、ＹＡＣチャー
ト形式に変換し、Ｇファイルに図示のように格納する。
Ｓ３は、表形式の設計イメージの画面１から、スケルト
ンＲを入力してＢファイルに格納する。この際、 ・スケルトンＩＤとしてスケルトンＲを入力 ・プログラム概要としてプログラム説明を入力 ・入出力情報定義としてファイル名、ファイル編成、フ
ァイル説明などを入力する。また、別の設計イメージの
画面から、 ・スケルトンＲのスケルトン出口定義として図示のよう
に、部品０１、チェック処理を入力 する。これら入力したスケルトンの情報をＢファイルに
図示のように格納する。

【００３５】Ｓ４は、スケルトン仕様生成１２がＢファ
イルから取り出した表形式のスケルトンＲを、プログラ
ム固有の情報とスケルトンのひな型を組み合わせて、Ｙ
ＡＣチャートのスケルトンを生成し、登録処理１３に渡
してＤファイルに格納する。これにより、図５のＤファ
イルのＣメンバ（スケルトンＲ）のデータ部および手続
き部が格納されることとなる。

【００３６】Ｓ５は、ＹＡＣ形式の設計イメージの画面
１から、部品０１を入力してＣファイルに格納する。Ｓ
６は、登録処理１３が、ＧファイルとＣファイルから固
有処理０１と部品０１を入力し、各ステートメントに対
応させて画面で定義した行番号を（ａ）、ＩＤを（ｂ）
にセットしてＤファイルに図示のように格納する。これ
により、図５のＤファイルのＡメンバ（固有処理０１）
およびＢメンバ（部品０１）のデータ部および手続き部
が格納されることとなる。

【００３７】Ｓ７は、合成指示処理１４がスケルトン
Ｒ、部品０１、固有処理０１をどのように合成するかの
指示を行う。また、部品のロジック内にある可変パラメ
タの実パラメタ値を決定する。指示した情報を、階層Ｎ
ｏに付加してＥファイルに格納する。

【００３８】Ｓ８は、プログラム生成１５がＤファイル
の情報（スケルトンＲ、部品０１、固有処理０１）につ
いて、Ｅファイルの情報（合成指示情報）をもとに１本
のプログラムに合成し、Ｆファイルに図示のように格納
する。ここで、合成は、Ｅファイルの情報中の階層Ｎｏ
に従って部品、固有処理を順次合成し、Ｆファイルの情
報のようにする。プログラムソースは、このＦファイル
の情報を出力することによって得られる。

【００３９】Ｓ９は、プログラム設計書出力１６がＡフ
ァイルからＦファイルの情報をもとに以下のＳ１０から
Ｓ１７のドキュメントを出力する。Ｓ１０は、概要リス
トを出力する。これにより、プログラムの処理内容およ
び使用しているファイル一覧を検証可能であるＳ１１
は、ファイル詳細リストを出力する。これにより、概要
リストで出力されたファイル一覧の個々のファイルの詳
細を検証可能である。

【００４０】Ｓ１２は、部品／固有処理構造図リストを
出力する。これにより、部品／固有処理を合成した後の
プログラムの構造を検証可能である。Ｓ１３は、実パラ
メタ値リストを出力する。これにより、部品内の可変パ
ラメタに対するプログラム固有の実パラメタ値を一覧で
検証可能である。

【００４１】Ｓ１４は、処理説明一覧リストを出力す
る。これにより、部品／固有処理を合成した後のプログ
ラムとしてデータ部の内容を検証可能である。Ｓ１５
は、データ定義一覧リストを出力する。これにより、部
品／固有処理を合成した後のプログラムとしてのデータ
部の内容を検証可能である。

【００４２】Ｓ１６、Ｓ１７は、固有処理仕様書リスト
を出力する。これらにより、固有処理の部分（ロジッ
ク）のみを画面で入力したイメージのまま内容を検証可
能である。ここで、Ｓ１６、Ｓ１７の階層Ｎｏ １−１
などは、固有処理仕様書を捲ったときに、部品／固有処
理構造図で見つけた階層Ｎｏを見つけるのを容易にする
ために出力している。

【００４３】以上の処理によって、Ｓ１で表形式の設計
イメージの画面１から固有処理０１などを入力してＡフ
ァイルに格納、Ｓ３で表形式の設計イメージの画面１か
らスケルトンを入力してＢファイルに格納、およびＳ５
でＹＡＣチャート形式の設計イメージの画面１から部品
０１などを入力してＡファイルに格納し、これら入力し
た情報のうちＹＡＣ形式でないものをＹＡＣ形式に変換
し、ＹＡＣ形式のものは変換することなくＤファイルに
図示のようにそれぞれ格納する。そして、Ｓ８でＤファ
イルの情報について、Ｅファイルの合成指示情報をもと
にプログラムを生成してＦファイルに格納する。このＦ
ファイルのプログラムをプログラムソース５として出力
する。また、Ｓ９でＡファイルからＦファイルの情報を
もとにプログラム設計情報として Ｓ１０：概要リスト Ｓ１１：ファイル詳細リスト Ｓ１２：部品／固有処理構造図リスト Ｓ１３：実パラメタ値リスト Ｓ１４：処理説明一覧リスト Ｓ１５：データ定義一覧リスト Ｓ１６、Ｓ１７：固有処理仕様書リスト をそれぞれ出力する。

【００４４】また、上述した図４から図８の処理につい
て、判り易く簡単に説明すると以下のようになる。 （１） ＹＡＣチャート形式で部品、固有処理を作成し
た場合：部品、固有処理のステートメントを定義した情
報をＣファイルに格納しておき、登録処理１３がＣファ
イルから、固まりのキーとなるＩＤをＤファイルの
（ｂ）の領域にセットして、各ステートメントがどこの
固まりで作成されたかを判るようにしておく。

【００４５】（２） 表形式で部品、固有処理を作成し
た場合：編集処理や振り分け処理のような部品、固有処
理を作成する場合に表形式で定義するときは、Ａファイ
ルに部品、固有処理を定義した情報を格納しておき、部
品／固有処理生成１１がＡファイルからＹＡＣチャート
形式への変換を行い、Ｇファイルに各領域単位に行番号
をふって、定義された情報がどこから作成されたかを判
るようにしておく。次の処理として、登録処理１３がＧ
ファイルからＤファイルへ登録する。

【００４６】（３） 表形式でスケルトンを作成した場
合：スケルトンを表形式で定義するときは、プログラム
の説明やプログラムで使用しているファイル名、アクセ
ス名およびスケルトンから呼び出される部品／固有処理
を表形式で定義し、その情報をＢファイルに格納してお
き、スケルトン仕様生成１２がＢファイルとスケルトン
ひな型からＹＡＣ形式への変換を行い、Ｄファイルに各
領域単位に行番号をふって、定義された情報がどこから
作成されたかを判るようにしておく。

【００４７】（４） （１）、（２）、（３）の処理を
行った後、Ｄファイルを入力して、スケルトン、部品、
固有処理を１本のプログラムとしてどのように合成させ
るかを指示および部品内にある可変パラメタタに対する
プログラムの固有の値（実パラメタ値）を決定する処理
を行い、指示した情報をＥファイルに格納する。

【００４８】（５） スケルトン、部品、固有処理を合
成させる指示を終了すれば、Ｅファイル（合成情報）お
よびＤファイル（固まりの定義情報）より１本のプログ
ラムを生成して、Ｆファイルに格納する。

【００４９】（６） ＡファイルからＦファイルよりリ
ストを出力することにより、合成したプログラムに対す
る設計書をスケルトン、部品、固有処理に関連づけて出
力することが可能となる。レビユー時（チェック時）に
は、関連情報（階層Ｎｏ、部品／固有処理ＩＤ、部品／
固有処理名、ファイル名、設計書の通しページ）をもと
に、レビューする側とレビューされる側で情報の流れが
把握でき、検索が容易に行える。

【００５０】

【発明の効果】以上説明したように、本発明によれば、
スケルトン、固有処理および部品を表形式やＹＡＣチャ
ート形式などの画面上の設計イメージから入力し、これ
をもとにプログラム設計書および併せてプログラムソー
スを自動生成して出力する構成を採用しているため、出
力されたプログラム設計書をチェックして元の画面１か
ら修正入力して修正し、プログラムソースの修正漏れや
修正ミスをなくすことができる。これにより、 （１） プログラム設計書のレビュー（チェック）によ
る変更が、画面からドキュメントと同じイメージで入力
でき、設計情報からプログラムを合成するため、修正漏
れや修正ミスがなくなる。

【００５１】（２） また、部品という共通ロジック
を、プログラムを設計する前にレビューしておけば、プ
ログラム単位のレビュー時に、プログラムの構造および
固有のロジックのみをレビューするだけでよいので、レ
ビューの効率化を図ることができる。

【００５２】（３） また、レビュー用のドキュメント
とメンテナンス用のドキュメントが同一となり、資料削
減につながる。

【図面の簡単な説明】

【図１】本発明の原理ブロック図である。

【図２】本発明のプログラムの構成要素となるスケルト
ン、固有処理および部品の説明図である。

【図３】本発明のプログラム設計書例である。

【図４】本発明の具体例説明図（その１）である。

【図５】本発明の具体例説明図（その２）である。

【図６】本発明の具体例説明図（その３）である。

【図７】本発明の具体例説明図（その４）である。

【図８】本発明の具体例説明図（その５）である。

【符号の説明】

１：画面（表形式の設計イメージの画面、ＹＡＣチャー
ト形式の設計イメージの画面） ２：プログラム開発・保守一貫支援システム ３：設計図編集処理 ４：プログラム設計書 ５：プログラムソース １１：部品／固有処理生成 １２：スケルトン仕様生成 １３：登録処理 １４：合成指示処理 １５：プログラム生成

Claims (2)

【特許請求の範囲】
1. 【請求項１】 プログラム設計書を生成するプログラム
   設計書生成方式において、 プログラムを構成するスケルトン、固有処理および部品
   をそれぞれ表示された設計イメージから入力するための
   画面（１）と、 これら画面（１）から入力されたスケルトン、固有処理
   および部品をもとに合成して階層に対応づけて呼出元、
   呼出先を設定した構造図などを生成する設計図編集処理
   （３）とを備え、 この設計図編集処理（３）が生成した構造図などをプロ
   グラム設計図として出力すると共に併せて上記階層に対
   応づけて呼出元、呼出先を設定した構造図からプログラ
   ムソースを生成して出力するように構成したことを特徴
   とするプログラム設計書生成方式。
2. 【請求項２】 上記出力されたプログラム設計書を修正
   したときに上記画面（１）からスケルトン、固有処理お
   よび部品の該当する部分を修正し、この修正後のスケル
   トン、固有処理および部品をもとにプログラム設計書お
   よび併せてプログラムソースを出力するように構成した
   ことを特徴とする請求項第１項記載のプログラム設計書
   生成方式。