システム操作マニュアルの作り方｜導入担当者の5つの手順

はじめに

新しいシステムの導入を控え、「操作マニュアルはベンダーが用意してくれるから大丈夫」と考えていませんか。画面の機能が詳しく説明されていても、担当者が日々の仕事でどの順に操作し、想定外の結果が出たら誰に連絡するかが分からなければ、現場は迷ってしまいます。

操作マニュアルは、画面の説明を集めた資料ではなく、利用者が目的の作業を安全に終えるための道案内です。この記事では、発注者や導入担当者が作成前に決めること、利用者と検証する方法、導入後の更新までを五つの手順で整理します。

操作マニュアルと業務マニュアルは何が違う？

操作マニュアルは、システムの機能をどう使うかを説明します。一方、業務マニュアルは、システム外の連絡や承認も含め、仕事をどう進めるかを説明します。障害対応の手順は、利用者がまず行う確認と、管理者が行う復旧作業を分けると混乱を防げます。

例えば、受注業務なら「注文画面で数量を登録する」は操作手順です。「在庫が不足したら顧客へ納期を確認し、必要に応じて責任者へ相談する」は業務上の判断です。どちらか一方にすべてを書き込まず、関連箇所から互いに参照できるようにしましょう。

デジタル庁の標準ガイドライン実践ガイドブックも両者を区別し、操作マニュアルを受入テストまでに作成して利用部門が確認することの重要性を示しています。これは行政向けの資料ですが、利用者の視点を取り入れる考え方は民間の導入にも参考になります。

システム操作マニュアルを作る5つの手順

1. 誰が何を終えるために読むか決める

最初に、読者と目的を具体化します。「全社員向け」だけでは、一般利用者が注文を登録する手順と、管理者が権限を変更する手順が混ざってしまいます。利用者の役割ごとに、開始時点、達成したい結果、利用頻度、失敗した場合の影響を整理しましょう。

例えば受注担当者向けなら、「注文内容を確認して登録し、受付番号を控える」までを一つの目的にできます。画面のメニュー名順ではなく、利用者が行う仕事の順番に並べるのがポイントです。関連する業務全体は移行計画書の整理と併せて確認し、導入準備の担当と期限を決めます。

2. 対象業務と例外を洗い出す

現場へのヒアリングや業務フローから、頻度が高い作業、間違えたときの影響が大きい作業、問い合わせが増えそうな作業を集めます。すべてを同じ深さで説明するのではなく、まず導入日から必要な作業を優先します。

受注登録なら、通常の登録だけでなく、数量不足、二重登録の疑い、登録後の変更、権限不足なども候補です。操作マニュアルには利用者が確認できる範囲と連絡先を記載し、社内の承認ルールやシステム復旧手順は、それぞれの正本へリンクします。例外の判断が未決定なら推測で埋めず、責任者と決める事項として残します。

3. 一つの作業を迷わず進められる形にする

各手順には、作業名、対象者、開始条件、必要な情報、操作、完了の確認、困ったときの行き先を置きます。番号付きの手順は一文ごとに何をするか明確にし、画面のどこで操作するかを添えます。Microsoftの手順作成ガイドも、目的が分かる見出しと順序付きの手順を勧めています。

例えば、次は架空の受注システムでの記載例です。実際の画面や操作結果は導入するシステムに合わせて確認してください。

作業：注文を登録する

• 対象者：受注担当者。事前に注文内容と登録権限を確認します。
• 準備：顧客番号、商品番号、数量を用意します。画面例には実在の個人情報を使いません。

1. 注文一覧を開き、「新規登録」を選びます。
2. 顧客番号、商品番号、数量を入力し、確認画面へ進みます。
3. 内容を確認して登録し、受付番号が表示されたことを確認します。

• 想定外：番号が表示されない場合は、すぐに再登録せず、一覧で登録状況を確認して担当窓口へ連絡します。

上記はあくまで書き方の例です。登録の取消しや二重登録の防止方法は、実際の仕様と運用ルールに基づいて決めます。画像は操作箇所の理解を助けますが、画像だけに頼らず文章でも場所と結果を説明します。

4. 現場の利用者と受入テストで試す

作成者が読んで理解できても、初めて使う人が同じように進められるとは限りません。実際の利用者にマニュアルだけを見て操作してもらい、迷った箇所、説明が不足した箇所、実画面との違いを記録します。説明者が横から答えた場合は、その回答も修正候補にします。

受入テストでは、正常に完了する例に加え、権限がない場合や入力に誤りがある場合も、許されたテスト環境で確認します。誰が確認し、どの版で、何が未解決かを残してから公開対象を決めましょう。テストを行ったことと、すべての例外に問題がないことは別です。

5. 公開後の正本と更新責任を決める

導入後は画面や業務ルールが変わります。保管場所が複数に分かれると、古い資料が参照されるおそれがあります。正本の場所、閲覧権限、更新担当者、承認者、版と更新日、変更時の通知方法を決めましょう。紙やPDFを配布する場合も、最新版を確認する場所を記載します。

画面変更や問い合わせ傾向をきっかけに、影響する手順を見直す運用が有効です。退職者の個人領域に正本を置かない、秘密情報を画像へ写さないなど、文書を管理し続ける条件も確認します。

発注者がベンダーと合意したいこと

外部へ制作を依頼するときは、「マニュアル一式」だけで範囲を決めず、利用者、対象機能、成果物の形式、納品時期、レビュー回数、更新可能な原本、受入基準を確認します。業務ルールの判断を誰が提供し、画面説明を誰が書き、現場がいつ試すかも分担します。

サンプルとして一つの業務の手順を先に作ってもらい、文章の粒度や画像の扱いを確認すると、完成後の大幅な作り直しを減らしやすくなります。納品後の更新が契約に含まれるか、追加費用が必要かは契約内容を確認しましょう。

よくある失敗と防ぎ方

画面の全機能を順番に説明する。 利用者は「注文を変更したい」という目的で探します。作業単位の見出しから、必要な機能の説明へたどれる構成にします。

例外時の判断を曖昧にする。 「エラーが出たらやり直す」とだけ書くと、処理が完了している場合に重複の原因になり得ます。確認する情報と、再操作前の相談先を定めます。

作成後に更新しない。 システム変更の連絡先とマニュアル担当を結び、変更対象の手順を確認します。改訂が終わるまでの暫定案内も必要に応じて用意します。

実画面だけで読めると思い込む。 画面画像の文字が小さい、色だけで場所を示す、キーボード操作が説明されていないと、利用環境によっては使いにくくなります。文章でも説明し、実際の利用者と確認します。

まずは重要な一業務から始めよう

操作マニュアルの品質は、ページ数よりも、対象者が目的の作業を終えられるかで判断します。まず導入直後に頻繁に使う一業務を選び、開始条件、操作、完了確認、例外、問い合わせ先を整理してください。その一例を現場とベンダーで試せば、残りの文書に共通する書き方も決めやすくなります。

資料や会議メモに判断が分散している場合は、Kakusillで業務や要件の整理を進め、担当者間で未決事項を確認することも一つの方法です。マニュアルの完成を納品の最後に置かず、業務設計と受入確認をつなぐ準備として扱いましょう。