JPS61170863A

JPS61170863A - 操作説明書自動生成方式

Info

Publication number: JPS61170863A
Application number: JP60012144A
Authority: JP
Inventors: Yumiko Shinozaki; 篠崎　由美子; Yoichi Motai; 馬渡　洋一
Original assignee: Fujitsu Ltd
Current assignee: Fujitsu Ltd
Priority date: 1985-01-25
Filing date: 1985-01-25
Publication date: 1986-08-01

Abstract

(57)【要約】本公報は電子出願前の出願データであるた
め要約のデータは記録されません。

Description

【発明の詳細な説明】〔産業上の利用分野〕本発明は表示装置に画面として表示せしめたテキストを
媒介として対話形式で処理を進行する如く構成されたソ
フトウェアについての操作ｆｆｌ明書（オペレーション
・マニュアル）を自動的に作成する方式に関するもので
ある。

〔従来の技術〕

表示装置の画面にシステム側からのメツセージを出力し
、また、利用者が該表示装置の画面上に入力データを表
示してからインプットするように構成された対話型ソフ
トウェアの情報処理装置のアプリケージ、ンシステムに
ついては、それらの装置あるいはソフトウェアが作成さ
れたとき、これを利用者が使用する際の手引きとして必
要な操作説明書も同時に作成され、装置等に添付されて
出荷される。

このような操作説明書は、利用者が容易に理解出来るも
のであって、当該装置等の機能が充分活用されるように
作られていなければならず、また、記述が正確であるこ
とが要求される。

通常、操作説明書の操作の説明などの主体となる部分は
、実際に表示される画面や操作するキー等を図示して入
力手順を説明する様式が採られることが多い〇従来、このような操作説明書の原稿は人間が手で書くか
、あるいは説明文をワードプロセ。

すで作成して印刷出力を得、これに別途作成した画面等
の作図の切り抜きを貼付するなどの方法によって作成し
ていた。

〔発明が解決しようとする問題点〕

上述したような従来の操作説明書の作成方式においては
、実際のソフトウェアの論理と説明の記述とが一致しな
かったり、実際には操作しなければならない手順につい
ての記述が欠落したり、使用する用語や形式が不統一で
あったりすることが発生し易く、また、ワードプロセッ
サの印刷出力を使用する場合には、該出力にはカーソル
が表示されないので、後からこれを補足しなければなら
ず１面倒な上に間違いを生じ易いなどと言う問題点があ
った・また、その原稿の作成や校正に多くの労力と時間
を要すると言う問題点があった〇本発明は、このような従来の問題点に鑑み、記述の正確
な操作説明書を迅速に作成することの出来る方式を提供
することを目的としている・〔問題点を解決するための
手段〕そして、この目的は本発明によれば、特許請求の範囲に
記載のとおり１表示装置の画面として表示せしめたテキ
ストを媒介して対話形式で処理を進行するごとく構成さ
れたソフトウェアについての操作説明書を自動生成する
方式であって、該ソフトウェアを用いての処理に際する
入力の操作の手順を記憶する手段と、画面上のカーソル
の位置を記憶する手段と、入力操作に対応する定形的な
説明文あるいは文章の一部に単語を挿入することによっ
て説明文となる文章を収録した辞書とを設け、例題に沿
って行なつ　　−・た実際の入力の手順をトレースした
結果に基づいて画面を再現すると共に、該入力に対応す
る説明文を前記辞書より検索して画面上に表示せしめ、
カーソルの位置を表示せしめた前記再現画面と該説明文
とを出力することを特徴とする操作説明書自動生成方式
により達成される。

〔実施例〕

第１図は本発明の１実施例の機能を示すブロック図であ
って、１は操作説明書作成の対象となるソフトウェア、
２はコンパイラ、３はロードモジュール、４は例題に基
づく操作、５は操作トレースプログラム、６は文章パタ
ーン辞書の作成・７は文章パターン辞書、８はメツセー
ジ定義体、９は操作トレースファイル、１０は文章作成
プログラム、１１は説明文ファイル、１２は文章修正プ
ログラム、１３は日本語文書処理、１４は修正・追加・
削除、１５はテキスト処理、１６はプリント出力、１７
〜２０はループを表わしている。

第１図において、利用者が例題に基づいて操作を行なう
（図中の４がこれを表わしている）と、その手順を操作
トレースプログラム５がトレースして得られたデータが
操作トレースファイル９に格納される。そして文章作成
プログラム１０が該データを基に画面を復元して、文章
パターン辞書７等を用いることによって説明文を生成し
ている。

以下、第１図に示した各部の詳細について説明する。

メツセージ定義体８は、一般の対話型ソフトウェアにお
いて必ず存在するファイルであって、対話型ソフトウェ
アで使われている画面一つ一つの入力や出力の表示項目
、文字のタイプ、桁数、ブリンクする項目、チェックす
る項目などの情報を持っている定義体である〇操作トレースファイル９は本発明の方式における独自の
ファイルであって、対話型ソフトウェアを用いて、例題
についての実際の操作を行なったとき、その個々の処理
手順を記憶しておくものである。

第２図に操作トレースファイルのルコードの情報の項目
を示す・第２図において２１はメツセージ制御情報（３
２バイト）を示しており、２２はデータを示している０
各項目に対応する情報はメツセージ定義体８とプログラ
ム中の処理から得ている。

文章パターン辞書７は各種の操作に対応する説明文（そ
の一部を穴埋め式とした説明文を含む）を収納しておく
もので、同じ操作に関する説明文を一つのグループとし
である。

第３図は文章パターン辞書の内容の例を示す図であって
、２３はインデックス、２４は優先順位、２５は説明文
を示している。図中の長方形の表示はその中にキー名（
ＰＦキー、　ＩＮＴＥＲ）などを入れて用いる穴埋め式
の説明文を示している。

説明文ファイル１１には文章作成プログラム１０が操作
トレースファイル９を基に文章パターン辞書７から優先
順位１の説明文を選び出し、それが穴埋め式であれば、
そこにＰＦキー等を当てはめて説明文として合成したも
のが格納される。

第４図は説明文ファイルのデータの構造を示す図で、２
６は識別番号、２７は説明文の文章、２８はインデック
スを示している。図中の識別番号２６は操作トレースフ
ァイルのルコードに対応するものであり、インデックス
２８は文章パターン辞書のインデックスに対応するもの
である。

操作トレースプログラム５は、操作説明書を作成しよう
とする対話型ソフトウェアのソースプログラムをプレコ
ンパイルすることにより、該ソフトウェアの表示装置に
対する　ＲＥＡＤ。

ＷＲＩＴＥの命令が、どの項目にどう言う処理をしたか
（ＭＯＶＥ　Ｌだもの等）をトレース出来るように展開
すると共に通知コードも取れるようにして、そのプログ
ラムをコンパイルすることにより得ることが出来る・以降、具体的な例に基づいて更に各部の動作等を説明す
る。　　　　　　　　　　　　　　　　　　　−第５図
は操作のトレースを説明する図であって（ａ）は表示装
置の画面を、（ｂ）はトレースの内容を表わしている＠
操作トレースプログラムは利用者が画面を用いて入力し
た項目は表示装置に対するＲＥＡＤ命令で内容を確認す
ることが可能であり、ＷＲＩＴＥ命令で画面への表示が
出来る。

また、ＰＦキーやＥｌ：ＮＴＥＲキーが押下されたこと
も通知コードによって認識することが出来る〇一方、メ
ツセージ定義体からプリンクする項目はどれかなどの情
報も得られるので画面ととに処理のトレースをとる。第
５図（ａ）に示す画面において、ＥＮＴＥＲキーを押下
して日付（８４０６１８）を入力したとき、トレースの
内容は第５図（ｂ）に示すとおりとなる。図中、処理区
分のＲはＲＥＡＤを、アテンシ、ン通報のＥｏｏｏはＥ
ＮＴＥＲキーが押下されたことを示しており斜線を施し
た部分は省略した項目を表わしている◎ 第６図は操作トレースファイルの蓄積されたデータの例
を示す図、第７図はメツセージ定義体の例を示す図で、
いずれも第５図の場合に対応しており、それらの関係を
示している。第７図における項目欄の内容は、あらかじ
め対話型ソフトウェアのプログラム内で定義されるもの
である０この場合のリテラルの対応表の例を第１表に、
ファンクションキーの定義例を第２表に示す〇第１表　　　　　第２表文章作成プログラムは操作トレースファイルを主な入力
として、画面ごと（メツセージ定義体名が変わるまで）
Ｋ以降説明するような文章編集を繰り返す〇（Ａ）・・・・・・画面の具体的操作の説明の前に「枕
」の文章パターンを付ける０例えば、枕の文章パターン
として［Ｉ＜メツセージ定義体のタイトル〉１の操作に
ついて説明します」　「操作は以下の手順で行ないます
ｊ等がある。

このとき、操作トレースファイル（第６図参照）の先頭
レコード（５ＯＯＩ　）を読むことによって、メツセー
ジ定義体はＭＥＤＯＩであることが分り、ＭＥＤＯＩか
ら第７図のメツセージ定義体を調べ、そのタイトルは「
売上伝票入力画面」なので前記７］内にこれを埋め込む。

（Ｂ）・・・・・・５００１の処理区分は出力（Ｗ）な
ので「表示」の文章パターンを生成する・例えばｒｌＦ
互買耳Σが表示されます」のに二ロ内ニ「画面１」を埋
め込む。

（Ｃ）・・・・・・２件目以降については以下の処理を
繰り返す＠（Ｄ３・・・・・・操作トレースファイルのレコードヲ
読み込むＯ（匂・・・・・・操作トレースファイルおよびメツセー
ジ定義体のデータを基に入力あるいは出力の場合の文章
を生成する・該文章の生成は次の手順による〇「入力の場合」（７）・・・・・・データをルコードずつメモリに転送
しておき読み込んだレコードの各データと比較して入力
されたデータ項目を調べる。すなわち、文章作成プログ
ラム中に定義されたリテラル対応表からデータ項目のリ
テラル項目名を求めこれにより表示リテラルをメツセー
ジ定義体で探す。例えば第６図における５００２の場合
には、入力された項目はＡであり、これはリテラル対応
表からＦｌであることが分り、メツセージ定義体からＦ
ｌは日付であることが分る。

（イ）・・・・・・メツセージ制御情報を調べる０例え
ば８００２ではアテンシ曹ン情報が’Ｅｏｏｏ”、入力
系通知コードが”５３”であることがらＥＮＴＥＲキー
が押されており入力エラーが検出されていることが分る
。

（つ）・・・・・・メツセージ定義体の指定を調べる・
　　　　　−例えばＳ　００２ではチェック欄に数字チ
ェ、りの指定がある・に）・・・・・・上記（７）〜（’ＩＩに基づいて下記
のように文章を組み立てる。

（７）より・・・・・・呵可にｐを入力します。

（イ）より・・・・・・ＥＮＴＦ４＃−を押１−ます・
（つ）より・・・・・・項目ロロは数字かどうかチェッ
クされます＠（イ）より・・・・・・項目目口はエラーです・「出力
の場合」（７）・・・・・・入力の場合と同様に、出力されたデ
ータ項目を調べ、リテラル対応表からデータ項目の表示
リテラルをメツセージ定義体で探す・（イ）・・・°・・・メツセージ定義体の指定を調べる
・例えば５００３ではＥに輝度、プリンク、色の指定が
ある◇ （つ）・・・・・・上記（７）〜（イ）に基づいて下記
のように文章を組み立てる。

（（）ヨ’）・・・・・・項目区Ｔ下Ｉは高輝度になり
ます。

（イ）より・・　項目「可■ｄはプリンクします〇（イ）より・・・・・・項目区７エ三刀は赤色です・第
８図〜第１１図は説明文ファイルをルコードずつ読み込
んで画面を復元する処理について説明するための図であ
って、それぞれの図の（ａ）の画面の表示に対しＰＦキ
ーにより画面をスクロールさせることにより対応する文
章が（ｂｌに示すように表示されることを示している。

以下の説明中の’８００１”〜”５００４”は第６図に
対応している。

第８図ｔａ＞は“５ｏｏｔ”の初期画面の表示である。

カーソルは入力項目の先頭に位置付ける。そして、デー
タ部分の内容をメモリに転送する（以降ルコードずつメ
モリに転送する）・第８図（ｂ）は“５００１”の画面（ａ）に対応する文
章である０編集の際、この文章の後に「日付の項目から
入力してください。」と言う文章を追加したい場合は日
本語処理を呼び出して１通常の文章入力と同様な操作を
行なえば良い０また。

必要に応じて修正や削除、接続詞の追加などによって、
読み易い文章に整えるつ第９図（ａ）において、”８００２”は処理区分が（Ｒ
）なので、どの項目の入力であるかを、メモリの内容と
比較することによって調べ、Ａ（日付）であることが分
る・メツセージ定義体の項目のＡの位置が入力位置であ
るので操作トレースファイルのＡ（日付）を表示する・
他の項目についても同様の処理を行なう・ＥＮＴＩＤＲが押されたとき通知コード°５３”が検出
されるので日付の項目の先頭にカーソルを表示する。

第１０図（ａ）において、’８００３“は処理区分が（
６）なので、表示されるデータであることが分り。

Ｅ（エラーメツセージ）であることも分る＠このとき、
メツセージ定義体からエラーメツセージの位置を認識し
て、その場所に表示する◎第１０図（ｂ）において、こ
れらの文章を一つく編集することも可能である・本図に
示した場合にはこの後に「日付を入力してください」等
の文意を追加する等により全体を整えれば良い。

第１１図（ａ）において、　”８００４″の処理区分は
（Ｒ）なのでメモリと比較するとＡ（日付）が変化して
いるのでＡ（日付）の入力であることが分る・また、エ
ラーメツセージも変化している口〔発明の効果〕以上詳細に説明したように本発明の方式によれば、操作
説明書の作成に関し、実際の操作をトレースして説明文
を作成しているので、対象となるソフトウェアとの対応
が確実にとれると言う利点があり、また、文章パターン
辞書の使用などにより文章やその中で使用する名称等を
統一的に表現することが出来る利点もある＠また、カー
ソルの位置データをプログラムで保有し、画面の復元に
際してこれを基に表示するので、実際の画面上における
カーソルの位置との不一致を生ずることが無い。

従って、正確な操作説明書を容易な操作で迅＊ＫｎＲｆ
ｂｃｈ”“ｉ’１Ｔ１ｆ＠’ｔ’６６：ｄｈ６５ｍ＊°
“８１Ｊある。

【図面の簡単な説明】

第１図は本発明の１実施例の機能を示すプロ　　′ツク
図、第２図は操作トレースファイルのルコードの情報の
項目を示す図、第３図は文章パターン辞書の内容の例を
示す図、第４図は説明文ファイルのデータの構造を示す
図、第５図は操作のトレースを説明する図、第６図は操
作トレースファイルの蓄積されたデータの例を示す図、
第７図はメツセージ定義体の例を示す図、第８図〜第１
１図は操作トレースファイルをルコードずつ読み込んで
画面を復元する地理について説明するための図である。１・・・・・・操作説明書作成の対象となるソフトウェ
ア、２・・・・・・コンパイラ、３・・・・・・ロード
モジュール、４・・・・・・例題に基づく操作、５・・
・・・・操作トレースプログラム、６・・・・・・文章
パターン辞書の作成、７・・・・・・文章パターン辞書
、８・・・・・・メツセージ定義体、９・・・・・・操
作トレース７アイル、１０・・・・・・文章作成プログ
ラム、１１・・・・・・説明文ファイル、１２・・・・
・・文章修正プログラム、１３・・・・・・日本語文書
処理、１４・・・・・・修正・追加・削除、１５・・・
・・・テキスト処理、１６・・・・・・プリント出力、
１７〜２０・・・・・・ループ、２２・・・・・・デー
タ、２３・・・・・・インデックス。２４・・・・・・優先順位、２５・・・・・・説明文、
２６・・・・・・識別番号、２７・・・・・・説明文の
文章、２８・・・・・・インデックス第７図第４　図（ａ−）第 δ　回（ｂ）ｑ　回（ｂ）（ａ）第（ａ＞１０図ｌ１図（６ン

Claims

【特許請求の範囲】

表示装置の画面として表示せしめたテキストを媒介して
対話形式で処理を進行するごとく構成されたソフトウェ
アについての操作説明書を自動生成する方式であって、
該ソフトウェアを用いての処理に際する入力の操作の手
順を記憶する手段と、画面上のカーソルの位置を記憶す
る手段と、入力操作に対応する定形的な説明文あるいは
文章の一部に単語を挿入することによって説明文となる
文章を収録した辞書とを設け、例題に沿って行なった実
際の入力の手順をトレースした結果に基づいて画面を再
現すると共に、該入力に対応する説明文を前記辞書より
検索して画面上に表示せしめ、カーソルの位置を表示せ
しめた前記再現画面と該説明文とを出力することを特徴
とする操作説明書自動生成方式。