市販アプリケーションの場合、印刷した冊子式のマニュアルにはインストールと初期設定程度までしか記述しないで、あとはオンラインヘルプに任せるのが一般的です。これには、パッケージサイズを小さくして流通経費を抑える目的もありますが、ユーザーにとってもあの分厚いマニュアルを開くことなく、マウスの操作で必要な情報を得られるのはありがたいことです。
市販アプリケーションの場合、オンラインヘルプにはWindowsのヘルプシステムで閲覧できるヘルプファイルを使うのが普通です。
Windowsのヘルプシステムはアプリケーションの「ヘルプ」メニューから起動できるため、ユーザーが操作に迷ったらその場で説明を表示できます。また、[F1]キーを押すことでその場の状況に応じた説明を表示させることも可能です。

しかし、特定の業種や特定の組織でしか使用しない業務用アプリケーションの場合、本格的なヘルプは必須ではありません。業務アプリケーションは市販アプリケーションとは異なり、その目的が単一的で、しかもユーザーのほとんどは「そのアプリケーションでどのような仕事をするのか」を理解しています。
そのため、アプリケーションの持つ機能自体が少なく、かつ明確なものとなります。商品の販売記録を入力する画面で、 「数量」テキストボックスには販売した商品の数量を入力します。 などと説明する必要はないでしょう。それはアプリケーションの使い方というより、「仕事の進め方」の範疇に属します。
もちろん、依頼主からの要請でそのような親切な説明をしなければならないこともあるでしょう。しかしたいていの場合、そのアプリケーションの概要と、全体の流れ、各画面の説明などを記述し、あとは細部の注意点を述べるにとどめておいても不都合はありません。

一通り指定が終わると、画面６のようになります。ここから、コンテンツ（目次）とインデックス（用語索引）を作成し、それらにHTMLファイルを結びつけていきます。ヘルプで表示される個々の項目をトピック（topic）と呼び、HTMLファイルをトピックファイルと言います。
ここでさらにHTMLファイルを追加したい場合は、ボタンをクリックし、[Add]ボタンをクリックしてファイルを選択します。

画面6：プロジェクトの設定が完了した

HTMLファイルを指定する
[Add]をクリックすると画面10のように「Path or URL」ダイアログボックスがオープンし、リストからHTMLファイルを選択できるようになります。このとき“HTML titles”リストに表示されるのは、HTMLファイルの<TITLE>タグで設定したタイトルです。選択したタイトルのファイル名が、下の“File or URL”に表示されます。
HTMLファイルを選択して[OK]をクリックすれば、“Files/URLs and their information types”にHTMLファイル名が表示されます。これで、見出し項目にHTMLファイルが設定されました。[OK]をクリックしてダイアログボックスを閉じます。

画面10：見出しに対応するHTMLファイルを選択する

残りの見出しを作る
次に、「操作手順」と「基本データの管理」という見出しを作ります。これらはその下に複数のトピックを並べるため、HTMLファイルを設定しません。“Entry title”に見出し文字列を入力するだけとします。

トピックを追加する
見出しができたら、次に見出しの下のトピック項目を追加します。見出し項目を選択して右ボタンをクリックし、メニューから「Insert Topic...」を選択します。後の要領は見出しの場合と同じで、「Table of Contens Entry」ダイアログボックスの“Entry title”にトピック項目名の文字列を入力します。 　[Add]をクリックして「Path or URL」ダイアログボックスの“HTML titles”リストから、トピックとして表示するHTMLファイルを選択すれば、トピック項目にHTMLファイルが結びつけられます。

残りのトピックを追加する
同じ要領で、トピック項目を追加してHTMLファイルを結びつけていきます。
項目の階層構造を変更する場合は、マウスのドラッグか左端の[↑][↓]ボタンで上下の順を、[←][→]で左右（階層の深さ）を操作できます。
項目を削除するには、設定した項目の内容を変更するにはをクリックします。

をクリックすると、「HtmlHelp API information」ダイアログボックスがオープンします。
「Map」タブで[Header file]をクリックし、先に作って保存したヘッダファイル（例ではex34hid.h）を選択します。これで、プロジェクトに記号定数の定義が取り込まれます（画面13）。
「Alias」タブをクリックし、[Add]ボタンをクリックして「Alias」ダイアログボックスをオープンさせ、“Whenever this constant...”にヘッダファイルで設定した記号定数を入力し、その下の“Use it to refer this HTML file”のリストから記号定数に対応するHTMLファイルを選択して[OK]をクリックします（画面14）。
これで、HTMLファイル（トピック）にヘッダファイルで設定した記号定数に対応する数値（コンテキスト番号）が結びつけられます。
上記の操作を、コンテキスト番号を設定したトピックの数だけ繰り返します。ダイアログボックスを閉じると、左側のウィンドウに最終的な設定が画面15のように表示されます。

画面13：ヘッダファイルを取り込ませる
画面14：コンテキスト番号とHTMLファイルを結びつける
画面15：ヘッダファイルやコンテキスト番号の設定が表示される

ここまでで、ヘルププロジェクトが一通りできあがりました。コンパイルしてみましょう。
メニューから「File」→「Compile」を選択すると、画面16のようなダイアログボックスがオープンします。“Project file”に現在編集中のプロジェクトファイルが表示されています。
[Compile]をクリックすれば、プロジェクトの設定に基づいてコンパイルが行われ、拡張子.chmのヘルプファイルができあがります。

画面16：プロジェクトをコンパイルしてヘルプを生成する

アプリケーションをコンパイルしたら、ヘルプファイルとともに配布しなければなりません。ユーザーのコンピュータにHTMLヘルプを表示するコンポーネントがインストールされていれば、ヘルプファイルを追加するだけで済みます。
しかし多くの場合、ヘルプファイルとともに必要なコンポーネントも配布する必要があるでしょう。exeファイルとともにヘルプファイルとコンポーネントを配布する場合は、ディストリビューションウィザードでSetup.exeを生成します。
ディストリビューションウィザードは、HTMLヘルプシステムに必要なコンポーネントの依存関係を処理し、適切な配布用パッケージを生成してくれます。
但し、アプリケーションの動作テストとともに、インストール先でヘルプが正しく表示されるかどうかも、必ずチェックするように心がけましょう。


- 注意 -

今回のサンプルは、VBのプロジェクトとexeファイル、HTMLヘルプのためのHTMLファイルとヘルププロジェクトの２つに分かれています。
ヘルププロジェクトを開いて設定を確認するには、HTML Help Workshopがインストールされていなければなりません。また、サンプルアプリケーションでヘルプを表示させるには、HTML Helpのコンポーネントがインストールされている必要があります。HTML Help Workshopをインストールすれば、これらのコンポーネントもインストールされます。



約３年間続いた「業務アプリ構築法」は今回で終了し、「番外編」としてあと２回「仕様設計のテクニック」を取り上げる予定です。
プログラムそのものの作成技法はあちこちで紹介されていますが、その前段階である仕様設計やデータ構造の検討などは、あまり紹介されていません。特に業務アプリケーションではデータベースの設計も関連してくるため、しっかりした設計が重要になります。
できれば、実際の仕様書の見本なども提供していくつもりです。

VBでデータベースを使った業務アプリを作るためのテクニックと考え方に絞って、様々な情報を提供してきました。ご意見・ご感想・ご声援をいただき、大変感謝しています。ありがとうございました。
この連載が、みなさんのお役に立てたなら、この上ない幸いです。


VBプロジェクトファイル
のダウンロード（Ex34.LZH）
(LZH形式 27.3KB)

ヘルププロジェクトファイル
のダウンロード（Ex34Help.LZH）
(LZH形式 41.8KB)