GASで顧客・日付・状態・キーワードの複数条件検索を作る

公開日: 

顧客・日付・ステータス・担当者・キーワードを組み合わせた複数条件検索のイメージ

GASのWebアプリに複数条件検索を追加し、作業依頼を受付番号・顧客・ステータス・登録日・担当者・キーワードで絞り込みます。複数の条件を指定した場合はAND検索になり、キーワードは件名または依頼内容のどちらかに一致する行を残します。

第8回では、登録済みの作業依頼を一覧表示しました。今回はスプレッドシートの行をサーバー側で判定し、検索結果と該当件数を一覧画面に表示します。

シリーズ全体の構成と完成画面は第0回で紹介しています。

1. 今回作るもの

ファイル用途
Code.gssearchRequests(criteria) と条件判定を追加する
list.html検索フォームを追加する
style.html検索フォーム用のCSSを追加する
script.html検索条件の収集と結果表示を追加する

2. 完成イメージ

  • 一覧画面に検索フォームが表示される
  • 受付番号、顧客、ステータス、登録日From/To、担当者、キーワードで検索できる
  • 複数条件を指定するとAND検索になる
  • 該当件数が表示される
  • 条件をクリアすると全件表示に戻る
  • 顧客プルダウンは顧客マスタから読み込まれる
検索フォーム。受付番号、顧客、ステータス、登録日、担当者、キーワードの入力欄と検索・クリアボタンが表示されている

3. 前回までの状態

前回は、登録済みの作業依頼を一覧表示する画面を作りました。

第9回の starter.zip には、第8回完了時点のファイルを入れています。

4. 使用するファイル

今回使用するファイルは Code.gs、list.html、style.html、script.html の4つです。index.html は変更しません。

5. 検索条件の種類

条件対象列一致方式
受付番号受付番号部分一致
顧客顧客コード完全一致
ステータスステータス完全一致
登録日From/To登録日時FromとToを含む日付範囲
担当者担当者部分一致
キーワード件名・依頼内容どちらかに部分一致(英字は大文字小文字を区別しない)

受付番号と担当者は部分一致、顧客コードとステータスは完全一致です。キーワードは件名または依頼内容のどちらかに含まれるかを調べます。この2列の判定はOR条件で、ほかの検索条件同士はAND条件です。FromとToは両端を含み、片方だけを指定した場合は指定した側だけで範囲を絞ります。検索フォームを空のまま送信した場合も全件が表示されます。

6. 貼り付けるコード

Code.gs

function getRequests(criteria) {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = spreadsheet.getSheetByName('作業依頼');

  if (!sheet || sheet.getLastRow() < 2) {
    return [];
  }

  const values = sheet.getDataRange().getValues();
  const headers = values[0];
  const rows = values.slice(1);
  const columnMap = createHeaderMap_(headers);

  return rows
    .filter((row) => {
      const deleted = row[columnMap['削除区分']];
      if (deleted === '削除' || deleted === true) {
        return false;
      }
      return matchesSearchCriteria_(row, columnMap, criteria);
    })
    .map((row) => ({
      id: row[columnMap['内部ID']],
      receiptNumber: row[columnMap['受付番号']],
      createdAt: formatDateForDisplay_(row[columnMap['登録日時']]),
      customerName: row[columnMap['顧客名']],
      title: row[columnMap['件名']],
      status: row[columnMap['ステータス']],
      assignee: row[columnMap['担当者']],
    }))
    .reverse();
}

function searchRequests(criteria) {
  return getRequests(criteria);
}

function matchesSearchCriteria_(row, columnMap, criteria) {
  if (!criteria) return true;

  if (criteria.receiptNumber) {
    const value = String(row[columnMap['受付番号']] || '');
    if (!value.includes(criteria.receiptNumber)) return false;
  }

  if (criteria.customerCode) {
    const value = String(row[columnMap['顧客コード']] || '');
    if (value !== criteria.customerCode) return false;
  }

  if (criteria.dateFrom || criteria.dateTo) {
    const createdAt = row[columnMap['登録日時']];
    if (!(createdAt instanceof Date)) return false;
    const createdDateStr = formatDate_(createdAt);
    if (criteria.dateFrom && createdDateStr < criteria.dateFrom) return false;
    if (criteria.dateTo && createdDateStr > criteria.dateTo) return false;
  }

  if (criteria.status) {
    const value = String(row[columnMap['ステータス']] || '');
    if (value !== criteria.status) return false;
  }

  if (criteria.assignee) {
    const value = String(row[columnMap['担当者']] || '');
    if (!value.includes(criteria.assignee)) return false;
  }

  if (criteria.keyword) {
    const keyword = String(criteria.keyword).toLowerCase();
    const title = String(row[columnMap['件名']] || '').toLowerCase();
    const description = String(row[columnMap['依頼内容']] || '').toLowerCase();
    if (!title.includes(keyword) && !description.includes(keyword)) return false;
  }

  return true;
}

function formatDate_(value) {
  if (!value || !(value instanceof Date)) return '';
  return Utilities.formatDate(value, Session.getScriptTimeZone(), 'yyyy-MM-dd');
}

list.html

<form id="searchForm" class="search-form">
  <div class="search-row">
    <div class="field">
      <label for="searchReceiptNumber">受付番号</label>
      <input id="searchReceiptNumber" name="receiptNumber" type="text" placeholder="例:20260626">
    </div>
    <div class="field">
      <label for="searchCustomer">顧客</label>
      <select id="searchCustomer" name="customerCode">
        <option value="">すべて</option>
      </select>
    </div>
    <div class="field">
      <label for="searchStatus">ステータス</label>
      <select id="searchStatus" name="status">
        <option value="">すべて</option>
        <option value="未対応">未対応</option>
        <option value="対応中">対応中</option>
        <option value="完了">完了</option>
      </select>
    </div>
  </div>
  <div class="search-row">
    <div class="field">
      <label for="searchDateFrom">登録日From</label>
      <input id="searchDateFrom" name="dateFrom" type="date">
    </div>
    <div class="field">
      <label for="searchDateTo">登録日To</label>
      <input id="searchDateTo" name="dateTo" type="date">
    </div>
    <div class="field">
      <label for="searchAssignee">担当者</label>
      <input id="searchAssignee" name="assignee" type="text" placeholder="例:山田">
    </div>
  </div>
  <div class="field">
    <label for="searchKeyword">キーワード(件名・依頼内容)</label>
    <input id="searchKeyword" name="keyword" type="text" placeholder="例:資料">
  </div>
  <div class="search-actions">
    <button type="submit">検索する</button>
    <button type="button" id="clearSearchButton" class="button-secondary">クリア</button>
  </div>
</form>

style.html

検索フォーム用のCSSを追加します。

.search-form {
  margin: 0 0 24px;
  padding: 20px;
  background: #f9fafb;
  border: 1px solid #e5e7eb;
  border-radius: 8px;
}

.search-row {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 16px;
}

.search-actions {
  display: flex;
  gap: 12px;
}

.search-actions button {
  width: auto;
  flex: 1;
}

.button-secondary {
  background: #ffffff;
  color: #2563eb;
  border: 1px solid #2563eb;
}

.result-count {
  margin: 0 0 12px;
  font-weight: 700;
  color: #374151;
}

script.html

検索フォームの処理を追加します。

const searchForm = document.getElementById('searchForm');
if (searchForm) {
  const searchCustomer = document.getElementById('searchCustomer');
  const clearButton = document.getElementById('clearSearchButton');

  loadSearchCustomers();

  searchForm.addEventListener('submit', (event) => {
    event.preventDefault();
    const criteria = buildSearchCriteria();
    loadRequestList(criteria);
  });

  clearButton.addEventListener('click', () => {
    searchForm.reset();
    loadRequestList();
  });

  function loadSearchCustomers() {
    if (!searchCustomer) return;
    searchCustomer.disabled = true;
    google.script.run
      .withSuccessHandler(renderSearchCustomerOptions)
      .withFailureHandler(handleSearchCustomerLoadFailure)
      .getActiveCustomers();
  }

  function renderSearchCustomerOptions(customers) {
    searchCustomer.innerHTML = '<option value="">すべて</option>';
    if (!customers || customers.length === 0) {
      searchCustomer.disabled = true;
      return;
    }
    customers.forEach((customer) => {
      const option = document.createElement('option');
      option.value = customer.customerCode;
      option.textContent = customer.customerName;
      searchCustomer.appendChild(option);
    });
    searchCustomer.disabled = false;
  }

  function handleSearchCustomerLoadFailure() {
    searchCustomer.innerHTML = '<option value="">読み込みに失敗</option>';
    searchCustomer.disabled = true;
  }

  function buildSearchCriteria() {
    return {
      receiptNumber: document.getElementById('searchReceiptNumber').value.trim(),
      customerCode: document.getElementById('searchCustomer').value,
      status: document.getElementById('searchStatus').value,
      dateFrom: document.getElementById('searchDateFrom').value,
      dateTo: document.getElementById('searchDateTo').value,
      assignee: document.getElementById('searchAssignee').value.trim(),
      keyword: document.getElementById('searchKeyword').value.trim(),
    };
  }
}

検索時の loadRequestList() も修正します。

function loadRequestList(criteria) {
  listContent.innerHTML = '<p class="message">読み込んでいます。</p>';
  const serverFunction = criteria ? 'searchRequests' : 'getRequests';
  const args = criteria ? [criteria] : [];
  google.script.run
    .withSuccessHandler(renderRequestList)
    .withFailureHandler(handleListLoadFailure)
    [serverFunction].apply(null, args);
}

検索結果を描画する renderRequestList() は、第8回の一覧表示処理を引き継ぎます。既存の空状態表示とテーブル生成は残し、空配列でない場合に件数を出す行を、テーブルを作る前に追加します。

var html = '<p class="result-count">該当件数: ' + requests.length + '件</p>';

7. コードの解説

getRequests() は getDataRange().getValues() でシートのデータ範囲を二次元配列として取得します。作業依頼シートがない場合や、見出し以外にデータがない場合は空配列を返します。先頭行の見出しを createHeaderMap_() で列番号に対応付け、削除済みデータを除いてから条件を判定します。表示に使う列だけをオブジェクトにまとめ、シートの行順を逆にして返します。前回までの登録処理は appendRow() で行を追加するため、通常は後から追加した依頼が先に表示されます。

createdAt は formatDateForDisplay_() で文字列に変換してから返します。google.script.run では Date オブジェクトをブラウザとの受け渡しに使えないためです。詳しくはRange.getValues()の公式説明を参照してください。

AND条件とキーワードのOR条件

matchesSearchCriteria_() は、受付番号、顧客コード、日付範囲、ステータス、担当者、キーワードの順に判定します。1つでも条件に合わない行があれば false を返すため、複数の検索条件を指定すると、すべてを満たす行だけが残ります。これがAND検索です。

キーワードだけは、件名と依頼内容のどちらかに一致すれば条件を満たします。コードでは両方に含まれない場合だけ false を返すため、この部分はOR検索です。検索条件同士はAND、キーワードの対象列同士はORで判定します。

日付範囲は両端を含めて比較する

登録日時を Utilities.formatDate() で yyyy-MM-dd に変換し、フォームから受け取った dateFrom/dateTo と比較します。Fromより前の日付とToより後の日付を除外するため、FromとTo当日も結果に含まれます。この比較では時刻を使いません。

Utilities.formatDate() は Session.getScriptTimeZone() が返すスクリプトのタイムゾーンで日付を整形します。Apps Scriptプロジェクトとスプレッドシートのタイムゾーンは別々に設定されるため、運用地域に合わせて両方を確認してください。日付値の取得方法はRange.getValues()の公式説明も確認してください。

空の検索条件でも全件を表示する

検索フォームを送信すると、buildSearchCriteria() は各入力欄の値を持つオブジェクトを作ります。値がすべて空でもオブジェクト自体は存在するため、loadRequestList(criteria) は searchRequests(criteria) を呼びます。サーバー側では空の条件を読み飛ばすので、全件が返ります。初回表示と「クリア」操作では引数を渡さず、getRequests() を呼びます。

searchRequests() は受け取った条件を getRequests(criteria) に渡す関数です。通常表示と検索でデータ取得・一覧化の処理を共通にしています。

google.script.run は非同期で結果を受け取る

google.script.run はHTML画面からサーバー側のApps Script関数を呼び出す非同期APIです。呼び出し直後に結果が返るのではなく、成功時に withSuccessHandler() で指定した renderRequestList() が検索結果を受け取ります。画面は受け取った配列の件数を表示し、配列が空なら「該当する作業依頼はありません」と表示します。詳しくはgoogle.script.runの公式説明を参照してください。

検索のたびにデータ範囲の全行を調べる

検索のたびに getDataRange().getValues() でデータ範囲を取得し、filter() で各行を順に判定します。データが増えると、読み取って判定する行数も増えます。大量のデータを扱う場合は、ページングや検索対象の範囲を絞る方法を別途検討してください。

8. 導入手順

  1. 第8回までのファイルを用意します。
  2. Code.gs の getRequests() を検索条件に対応させ、searchRequests()、matchesSearchCriteria_()、formatDate_() を追加します。
  3. list.html に検索フォームを追加します。
  4. style.html に検索フォーム用のCSSを追加します。
  5. script.html で入力値の収集、顧客マスタの読み込み、検索実行、結果表示を行います。
  6. プロジェクトを保存し、「デプロイ」>「テストデプロイ」から「ウェブアプリ」を選び、テスト用URLを開きます。URLは /dev で終わり、編集権限のあるユーザーが最新の保存済みコードを確認するためのものです。
  7. 本番用の /exec URLへ変更を反映する場合は、「デプロイを管理」で既存のデプロイを編集し、新しいバージョンを選んでデプロイします。詳しくはApps Scriptの公式説明を参照してください。
  8. 一覧画面を開き、検索条件を入力して動作を確認します。

9. 動作確認

一覧画面で、条件の種類ごとに検索結果を確認します。

  • 受付番号や担当者の一部を入力し、部分一致するデータが表示される
  • 顧客またはステータスを選び、完全一致するデータが表示される
  • 登録日Fromだけ、Toだけ、両方を指定し、指定日を含む範囲が表示される
  • 件名または依頼内容に含まれるキーワードを入力する
  • 英字キーワードの大文字と小文字を変えても同じデータが表示される
  • 顧客と担当者など複数条件を組み合わせ、すべての条件を満たすデータだけが表示される
  • すべての入力欄を空にして検索し、全件が表示される
  • 一致するデータがない場合、0件のメッセージが表示される
  • 「クリア」で入力欄が初期化され、全件表示に戻る
  • 該当件数が検索結果の件数と一致し、論理削除したデータが含まれない
顧客にサンプル商事、担当者に山田を指定して検索した結果。該当件数2件の一覧が表示されている

該当件数は、検索結果の上に表示されます。

検索結果の上に表示された「該当件数: 2件」

条件に一致するデータがない場合は、次のように表示されます。

検索条件に一致するデータがないときの「該当する作業依頼はありません」という表示

10. よくあるエラー

検索結果が0件になる

条件が厳しすぎないか、FromとToの順序が逆になっていないかを確認してください。検索条件を空にしても0件の場合は、作業依頼シートに未削除のデータがあるか確認します。

顧客プルダウンが空になる

getActiveCustomers() が成功しているか、顧客マスタの「有効区分」が「有効」の顧客が登録されているか確認してください。読み込みに失敗すると、顧客プルダウンは無効になります。

日付検索で結果が変わらない

登録日時 が日付データとして保存されているか、Apps Scriptプロジェクトとスプレッドシートのタイムゾーンが運用地域に合っているか確認してください。formatDate_() はスクリプト側のタイムゾーンで日付を整形します。文字列として入力された日付は Date オブジェクトにならないため、日付条件を指定すると検索対象から外れます。

11. starter.zipの案内

starter.zip には、第8回完了時点のファイルを入れています。

starter.zipをダウンロード

12. complete.zipの案内

complete.zip には、検索機能を追加した Code.gs、index.html、list.html、style.html、script.html、README.txt を入れています。

complete.zipをダウンロード

13. 次回追加する機能

次回は、一覧画面に詳細・編集・論理削除・ステータス変更機能を追加します。

内部IDを使って対象データを特定し、スプレッドシートの該当行を更新します。




Your Message

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

日本語が含まれない投稿は無視されますのでご注意ください。(スパム対策)

このサイトはスパムを低減するために Akismet を使っています。コメントデータの処理方法の詳細はこちらをご覧ください。

スポンサードリンク

記事が気に入ったらシェアお願いします

PAGE TOP ↑