GENZ, Inc.

手順書の公開と閲覧向け マニュアル作成ツールのソフトウェアテスト|探して読めるか検証

画面で手順書を作成できることと、対象の部署が探して読めることは別です。GENZは自社の雛形・閲覧範囲・配信先を載せた形で、公開から閲覧までを検証します。

支援事例

支援実績5,000件以上

支援実績を示す企業ロゴ 01
支援実績を示す企業ロゴ 02
支援実績を示す企業ロゴ 03
支援実績を示す企業ロゴ 04
支援実績を示す企業ロゴ 05
支援実績を示す企業ロゴ 06
支援実績を示す企業ロゴ 07
支援実績を示す企業ロゴ 08
支援実績を示す企業ロゴ 09
支援実績を示す企業ロゴ 10
支援実績を示す企業ロゴ 11
支援実績を示す企業ロゴ 12
支援実績を示す企業ロゴ 13

この記事はソフトウェアテストの専門家が監修しています

監修枡井 愼治株式会社GENZ 代表取締役

GENZは創業以来、5,000件以上のソフトウェアテスト・第三者検証を手がけてきたプロフェッショナルです。品質に関する課題やお悩みに、真摯に寄り添います。

代表取締役 枡井 愼治 株式会社GENZ 〒101-0062 東京都千代田区神田駿河台2-3-11 ヒューリック御茶ノ水ビル3F TEL:03-5244-4711
01 ISSUES

マニュアル作成ツールの導入後によくある不具合

作成と公開から配信と閲覧、書き出しまで、マニュアル作成ツールの不具合はどの経路にも起こります。いずれも管理する画面の上では正常に見えます。ここで挙げるのは、自社の設定と手順書が載った状態で現れるものです。

公開したのに対象の部署から手順書が見えない

閲覧範囲の割り当てと分類から継承される閲覧範囲がずれると、公開しても対象の部署には表示されません。公開の操作そのものは成功したように見えます。

対象部署の未表示

差し替えたあとも現場で旧版が参照され続ける

公開版を差し替えても、旧版への参照の設定が残ると現場は前の手順のまま作業を続けます。索引の更新の遅れでも、同じ状態が起きます。

現場に残る旧版

検索しても公開済みの手順書が結果に出てこない

索引の更新が遅れると、公開済みの手順書が検索で返りません。分類と属性の設定が条件と食い違う場合も同じです。利用者からは無いのと同じになります。

検索結果の欠落

印刷や持ち出し用のファイルでは体裁が崩れる

画面で読めることと、印刷や持ち出し用のファイルで読めることは一致しません。改ページと画像の位置は書き出しの側でしか確かめられません。

書き出しの体裁崩れ

異動の反映が遅れて見える範囲が実態とずれる

認証基盤から受け取る所属の反映が遅れると、見える範囲が実態とずれます。異動前の部署の手順書が見え続け、新しい部署の手順書は見えません。

異動反映の遅れ
02 RISK

残存した不具合を放置したときに生じる問題

残った不備は、古い手順での作業、手順書の社外への流出、整備そのものの停滞という別方向の帰結へ広がります。表面化するのは申告か事後の判明です。

マニュアル作成ツールの障害対応について、複数の担当者がモニターや資料を確認している実写画像。
03 REVIEW

静的テスト(レビュー)でおさえるべき観点

マニュアル作成ツールの静的テストは、作成から配信と閲覧までの取り決めを投入された設定と照合する作業です。文書の整備の状況に依存せず、運用中の設定から照合の対象を組み立てられます。5つの観点に分けて示します。

雛形と分類の定め

雛形と分類体系の取り決めを投入された設定と照合

雛形の体裁と項目の並びを、投入された雛形の設定と照合します。分類の区分と属性の定めも、分類の設定と突き合わせます。雛形の変更が既存の手順書のどこまで及ぶかもここで確認します。

確認する資料
  • 雛形の設定一覧
  • 分類体系の定義
  • 属性の項目定義
公開と承認の経路

公開の確認と承認の経路の設計を権限の設定と照合

誰が確認し誰が公開できるかの取り決めを、投入された権限の設定と照合します。差し戻しをどう扱うかと公開の時刻をどう指定するかの定めも、公開の設定と見比べます。

確認する資料
  • 公開の権限の定め
  • 承認経路の設計書
  • 差し戻しの扱い
配信先と通知の経路

配信先と通知の取り決めを部署の階層の定義と照合

どの部署と役割と拠点へ配信するかの取り決めを、登録された部署と拠点の階層の定義に照らします。どの経路で通知するかの定めも、通知の設定と突き合わせます。

確認する資料
  • 部署と拠点の階層
  • 配信先の取り決め
  • 通知の経路の設定
閲覧範囲の方針

閲覧範囲の方針を分類から継承される設定と照合

どの利用者がどの手順書へ到達できるかの方針を、分類から継承される閲覧範囲の設定と照らし合わせます。見せてはいけない相手へ届く経路が残っていないかも、ここで確かめます。

確認する資料
  • 閲覧範囲の方針
  • 分類からの継承
  • 利用者の区分表
移行と連携の項目

移行と連携の取り決めを突合の基準と項目と照合

既存の手順書の移行の対応づけを、突合の基準に照らします。周辺システムとの授受の項目と実行の時期の定めも、連携の設定と項目ごとに見比べます。

確認する資料
  • 移行の対応づけ
  • 突合の基準の定め
  • 授受の項目定義
  • 実行の時期の定め
04 TEST DESIGN

動的テストの設計・実行のポイント

部署と分類と閲覧範囲と端末と出力形式の掛け算は全数を確認できません。範囲をテスト設計技法で絞り込み、合否を判定する形にします。

STEP 01 部署と端末と出力形式を区分する同値分割で分けた代表の組で表示と書き出しを見る
どう確かめるか

部署と端末と出力形式の区分を同値分割で確かめる

部署と役割、端末とOS、出力形式の区分を同値分割法で分けます。代表の組み合わせで雛形どおりに表示され書き出せることを検証します。

  • 01部署と役割と端末とOSと出力形式の区分を同値分割法で分ける
  • 02代表の組み合わせで雛形どおりに表示されることを確かめる
  • 03印刷や持ち出し用のファイルへ書き出せることも検証する
OUTPUT区分別の表示記録
STEP 02 公開の時刻と分量の境を確かめる公開の日時と手順の単位の数と容量の境を選ぶ
どう確かめるか

公開の時刻と分量の境目を境界値分析で確かめる

公開の日時の指定、手順の単位の数、画像と動画の容量の上下限を境界値分析で選びます。その境を挟んで扱いが変わることを確かめます。

  • 01公開の日時の指定の前後の境目を境界値分析で選び出す
  • 02手順の単位の数と画像と動画の容量の上下限もあわせて選ぶ
  • 03その境を挟んで扱いが定めどおりに変わることを検証する
OUTPUT境目前後の判定結果
STEP 03 閲覧範囲の組を表へ整理する見えるべきものと見えてはいけないものを対で判定する
どう確かめるか

閲覧範囲の組をデシジョンテーブルで確かめる

部署と役割と拠点と分類の重なりをデシジョンテーブルテストで整理します。見えるべきものが見え、見えてはいけないものが見えないことを検証します。

  • 01部署と役割と拠点と分類の重なりを表の条件の列へ置く
  • 02閲覧範囲の組み合わせをデシジョンテーブルテストで整理する
  • 03対象の部署に見え対象外の部署には見えないことを判定する
OUTPUT閲覧範囲の対応表
STEP 04 公開版の切り替えと回帰を確かめる版更新のあとも出力と検索と配信が保たれるかを見る
どう確かめるか

公開版の切り替えと版更新後の回帰を確かめる

編集中の版から公開版への移り変わりと差し戻しを状態遷移テストで追います。版更新と設定変更のあとも既存の出力と検索と配信が保たれることを回帰テストで確かめます。

  • 01編集中の版から公開版への移り変わりを状態遷移テストで押さえる
  • 02編集中の版への差し戻しの移り変わりも同じ考え方で確かめる
  • 03版更新と設定変更のあとも出力と検索と配信が保たれるかを回帰テストで見る
OUTPUT遷移と回帰の記録
05 RATIONALE

私たちGENZが、このようなソフトウェアテストを代行します

固定費を抱えない人日単位のアサイン、監査にも使える独立した検証の記録、育成期間なしに活かせる専門ノウハウなど、第三者へのアウトソースには複数のメリットがあります。

OUTSOURCING RATIONALE THIRD-PARTY VERIFICATION

必要な時に必要な分だけ

人日単位のアサインで固定費を抱えず、繁忙期に増減できます。

独立した視点で品質を底上げ

独立した検証で偏りを排し、監査に使える客観的な記録を残せます。

専門ノウハウを即戦力で

JSTQB認定エンジニアが在籍し、対象領域固有の検証知見を育成期間なしに活用できます。

オフィスで担当者同士がノートPCを前に、マニュアル作成ツールのテスト観点を相談しながら整理している風景。第三者視点のテスト支援を想起させる実写写真。

専門知識を持ったテストエンジニアが、第三者の視点でテストするメリット

  • 管理する画面には出ない見えない状態を申告より前に検出できる
  • 部署と分類と閲覧範囲と端末と出力形式の組まで確認できる
  • 固定費を抱えずに人日単位で全社展開前の確認を差し込める
  • 展開判定の場で使える独立した検証記録と未確認の範囲が残る
06 SERVICE

5,000件以上の実績に裏付けられた公開と閲覧の検証

GENZは支援実績5,000件以上の第三者検証の専門企業です。製品のベンダーや導入パートナーと役割を分け、ISO 27001の体制のもとで導入した企業様の側に立ち、設計から報告まで伴走します。

SVC 01

公開から閲覧までの経路で観点を設計

GENZは雛形と分類の適用から公開と配信、検索と閲覧、書き出しまでの経路に沿って観点を起こします。機能の一覧では設計しません。

マニュアル作成ツールの追加や改修と並行してテストを進め、検出した不整合を開発側へ戻す流れを示した赤白紙カード基調の無文字図解。
SVC 02

雛形の定めが申し合わせだけの現場も支援

雛形と分類体系と閲覧範囲の定めがご担当者様の申し合わせにとどまる現場でも、GENZは観点の書き出しから支援します。手順書の中身は書きません。

マニュアル作成ツールの確認候補が掛け合わせで広がる様子を示した赤白紙カード基調の無文字図解。
SVC 03

一斉配信と閲覧の集中をGENZ社内で実測

全社一斉の配信や繁忙期の閲覧の集中、大量の手順書の取り込みのもとでの応答を、GENZ社内の負荷と性能の専門エンジニアが確かめます。

第三者の視点で計画・設計・実施・報告が一貫してつながる流れを示した赤白紙カード基調の無文字図解。
SVC 04

確認済みの範囲と未確認を書き分け報告

GENZはどの部署のどの分類のどの端末のどの出力形式まで確認し、未確認の範囲を書き分けて渡します。全社展開の判定と経営層への説明に使えます。

テストの証跡を保全し、確認済みの範囲と未確認の範囲を整理した切替可否の判断の材料にまとめる流れを示した赤白紙カード基調の無文字図解。
※本ページに記載の支援内容・範囲は一例です。実際のご支援内容・範囲は、お打ち合わせのうえでご状況に合わせて決定します。まずはお気軽にお問い合わせください。
07 FLOW

ご相談から納品までの流れ

対象の部署と分類、閲覧範囲と出力形式を伺い、合意した範囲と優先順位でテストを進めます。

確かめる範囲と全社展開の予定を伺う

部署と分類と端末と出力形式の範囲、導入と展開の予定を確認します。

リスクに基づくテスト設計と見積もり

旧版での作業と社外への流出の重さで優先順位を付け、工数を整理します。

テストを実施し発見事項を随時共有

合意した範囲を実行し、判断待ちの事項と重い不具合を都度共有します。

報告書を納品し是正後の再確認へ

結果と証跡、未確認の範囲と残るリスクを納品し、再確認の進め方を示します。

支援実績5,000件以上

全社展開の前に確認の範囲をGENZに相談する

ご相談では、部署と分類と閲覧範囲と端末と出力形式の組み合わせの幅を整理します。導入と展開と版更新の場面ごとに優先順位を組み立て、必要な工数の考え方をお示しします。必要事項を入力の上、お問い合わせください。内容を確認させていただいた上、担当者よりご連絡いたします。*がついている項目は必須項目です。