Tabulatorで障害チケット表を動かす:重要度検索・並べ替え・セル編集を体験

プログラミング・Web開発カテゴリを表すパンダのイラスト プログラミング・Web開発

この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。Tabulator公式の表・検索・編集APIを調べ、架空の障害チケット8件を使って絞り込みと画面の状態変化を確認する教材を作成しました。

検証ステータス:🧪 絞り込みロジックのテスト済み・ブラウザー表示は未確認
Node.jsで8つの検査が通ることを確認しました。GitHub Pagesの公開URLの到達、実際のブラウザーでのセル編集、スマートフォン表示、WordPressへの埋め込みはまだ検証していません。

Tabulatorで障害チケット表を動かす:重要度検索・並べ替え・セル編集を体験

Excelのように並べ替えられる表を、サーバーもデータベースも新設せずにWebページで作れるでしょうか。JavaScriptライブラリの Tabulator なら、一覧表の描画・絞り込み・ページ分割・セル編集などをまとめて扱えます。表の外側にある検索欄やボタンは、自分のJavaScriptから接続します。

今回の目標は、見栄えの良い表を表示することだけではありません。「重要度が高い案件は何件か」「さらにネットワークだけを見るとどうなるか」「編集は実際に保存されたのか」を、架空データで確かめることです。障害管理や記事制作管理など、現場で必要になる絞り込みの考え方を小さな実験に落とし込みます。

まず動かす:ライブデモ

外部アカウントもAPIキーも不要です。ページが開けば、次の手順を試せます。

  1. 重要度の選択を「すべて」から「高」に変更します。元の8件から3件を表示することが期待結果です。

  2. 検索欄に「ネットワーク」と入力します。重要度の「高」と合わせた条件で2件になることを確認します。

  3. 検索欄を消し、表の「状態(編集可)」のセルを選びます。用意した選択肢から「対応中」「完了」などを変えられる設計です。

  4. 「架空チケットを1件追加」を押して一覧を変え、「最初の8件に戻す」で最初の入力に復帰します。

ここで大切なのは、表示が変わってもデータベースに保存したわけではないという区別です。教材はブラウザーのメモリだけで動くため、ページを再読込みすれば初期データに戻ります。保存機能がない状態で編集結果を「登録完了」と表示してはいけません。

どんな画面を作ったか

項目内容
ライブラリTabulator 6.3.1、MITライセンス
方式GitHub Pagesから静的HTML・CSS・JavaScriptを配信
外部サービス業務API・データベース・外部CDNへの実行時依存なし
データ架空の8件。実在企業・社員・障害ログは使用しない
操作重要度・検索・列並べ替え・状態セル編集・追加・初期化
データの保存しない。操作結果はブラウザーを閉じると消える
確認済み絞り込み・0件・合計・コピー分離などのロジック8件
未確認実ブラウザーの描画、公開URL、端末別表示、WordPress埋め込み

表には番号、対象サービス、障害の概要、重要度、状態、経過時間を用意しています。架空の対象サービスは「ネットワーク」「メール」「Web」「認証」です。実際の本番障害や社内システムの情報を流用すると、デモページが公開されることで情報漏えいにつながるため、最初から架空データを用意する設計にしています。

何が起こる? 条件の変化を数字で追う

初期データは8行です。このうち重要度が「高」なのは番号101、104、105の3行で、経過時間は45分、70分、55分。合計は 170分 になります。さらに「ネットワーク」と検索すると101と104の2行に絞られ、経過時間の合計は 115分 になります。

操作表示件数表示行の経過時間合計
何も指定しない8件305分
重要度「高」3件170分
重要度「高」かつ「ネットワーク」2件115分
存在しない単語で検索0件0分

この結果から、元データ8件の件数と現在表示対象の件数を分けて考えられます。0件になっても、元データが削除されたわけではありません。現場で「検索に出てこない」と言われたとき、検索条件が厳しいのか、データ自体が存在しないのかを切り分けるのと同じです。

※上表は教材の架空データから算出した論理的な期待結果で、ブラウザー描画を実測した記録ではありません。ロジックテストでは8件・3件・2件・0件、合計170分を確認しています。

コードの仕組み:ライブラリを自作しない

Tabulator本体は公開済みの第三者製ライブラリで、自作していません。公式のv6.3.1を使い、配布用のJavaScriptとCSSを教材の vendor/ フォルダに同梱しています。ページを開くたびに別サイトの最新ライブラリへ接続する構成ではないため、外部CDNの停止や予期しないバージョンアップで挙動が変わるリスクを減らせます。ただし、配布物の更新や脆弱性確認は保守作業として残ります。

表の接続部分は、次のような考え方です。

const table = new Tabulator("#table", {
  data: initialTickets,
  layout: "fitColumns",
  pagination: true,
  paginationSize: 5,
  columns: [
    {title: "番号", field: "id"},
    {title: "対象", field: "service"},
    {title: "状態", field: "status",
      editor: "list",
      editorParams: {values: ["未対応", "調査中", "対応中", "完了"]}}
  ]
});

これは仕組みの説明用に短縮した抜粋です。実際の完成版はDaily Codeの app.mjs にあり、そのままコピーしただけでは一式になりません。 HTMLの #table 要素、Tabulatorの読み込み、架空データの定義が必要です。

ライブラリの setFilter には、対象行が条件に合うか判断する関数を渡せます。今回は重要度とキーワードの両方を満たす行だけを残します。

table.setFilter(row => matches(row, priority.value, keyword.value));

入力欄が変わるとフィルターを再設定し、getData("active")で現在の表示対象データを取り出して件数と合計時間を更新します。列見出しの並べ替えはTabulatorの機能ですが、重要度の文字列順は障害の業務的な重大度順と一致するとは限りません。実務向けに発展させるなら「高・中・低」の並びを明示的に定義すべきです。

実際の制作ファイルと静的配信

教材では、表示用の index.html、見た目の style.css、画面操作の app.mjs、ロジックの logic.mjs を分けています。ライブラリ本体は vendor/tabulator.min.js と vendor/tabulator.min.css に固定配置しました。利用元とMITライセンスの全文も同じ vendor/ に残しています。

外部CDNを使わない一方で、GitHub Pagesの静的ページを開くには通常のネットワーク通信が必要です。また、HTMLを file:// で直接開くとJavaScriptモジュールの読み込みがブラウザー側で拒否されることがあります。その場合は、教材READMEにある手順でローカルのHTTPサーバーを立てます。Python標準の http.server は開発用で、本番公開に使うものではありません。

1か所変えると理解が深まる

重要度を「高」から「中」に変えてみてください。高い案件だけを見ているつもりで「中」を混ぜれば、当然ながら表示件数は変わります。次に検索欄を空にすると、重要度だけが条件として残ります。これによって、複数条件を組み合わせるAND検索と、片方を解除する操作の違いを体験できます。

もう1つの比較は、状態セルの編集です。画面で「対応中」を「完了」に切り替えても、そのデータはブラウザー内だけに存在します。ページを再読込みしたあとに値が元へ戻るなら、変更は永続保存されていません。これは仕様どおりです。業務システムなら、編集操作の直後に成功表示するのではなく、サーバーが更新を受理した結果まで確認する必要があります。

うまく動かないとき

症状確認するところ対処
表が表示されないvendor/tabulator.min.js が取得できるかデモの相対パスと配置を確認
見た目が崩れるvendor/tabulator.min.css が取得できるかCSSがJSと同じ版か確認
ローカルのHTMLが開けても機能しないConsoleにCORSやmoduleエラーがあるかhttp://localhost で配信して確認
検索しても0件重要度と文字列の条件が両方指定されていないか片方を解除して再検索
編集したのに戻った本教材には保存先がない実務では保存APIと応答確認を別途設計
表示件数が違う編集・追加・フィルター条件を変更したか「最初の8件に戻す」で再実験

実務で使うときの注意

障害チケットを本当に扱うなら、閲覧権限、更新権限、操作記録、同時編集、公開範囲、エラー時の復元、個人情報の取り扱いを決めなければなりません。Tabulatorは表を描画し操作する道具であって、認証や監査証跡、保存先を自動的に提供するものではありません。

また、大量データをクライアントへ配ると、表示上のフィルターで隠しただけでは情報保護になりません。重要な情報は権限のあるデータだけをサーバーから渡す設計が必要です。CSV出力や保存を追加する場合も、個人情報や式として解釈される値の扱いを慎重に決めます。 、あえてブラウザー内で完結する小さな実験に限定しました。表の操作性をまず理解し、業務としての保存・権限・監査を後から区別して考えることで、ライブラリを導入すれば業務システムが完成するという誤解を避けられます。

まとめ

Tabulatorを使えば、静的なHTML・CSS・JavaScriptでも、検索・並べ替え・状態変更ができる一覧を作れます。重要度「高」で3件、さらに「ネットワーク」で2件となる操作を試し、画面の変化を数値でも確かめてください。

使いどころは障害管理に限りません。FAQ検索、架空の受注一覧、設備一覧、原稿レビューなどにも応用できます。ただし、実システムへ導入する際は、ライブラリとデータの保存処理を混同せず、権限・競合・検証の設計を追加する必要があります。

公式資料とコード

検証範囲

Node.js v22.16.0で教材のテストファイルと同じGit blob SHAの内容を実行し、ロジック8件が合格しました。Tabulator本体v6.3.1とMITライセンスのGitHub保存・読戻しも確認しています。ただし、公開Pagesの到達、画面の描画、セル編集の実操作、モバイル表示、WordPressへの埋め込みは確認していません。

文書情報

記事タイトル
Tabulatorで障害チケット表を動かす:重要度検索・並べ替え・セル編集を体験
作成日
更新日
Source URL
https://papanda925.com/?p=18671

ライセンス: 本記事のうち、当サイトが権利を有する本文・自作図表は、特記なき限り CC BY 4.0 で利用できます。生成AIを活用して作成・編集した内容を含みます。コードについて、別途ライセンス表示またはリンク先GitHubリポジトリのライセンスがある場合は、その条件を優先します。引用・第三者資料・画像・商標等は本ライセンスの対象外です。 利用ポリシー

タイトルとURLをコピーしました