Excel Office スクリプト シートから文字列を検索

2023年4月10日

English version.

Office スクリプトにおけるシートから文字列を検索する方法を紹介します。

解説

以下のコードで検索を行います。(赤字は適宜変更

let 検索結果の変数名 = workbook.getWorksheet("シート").findAll("検索ワード", { completeMatch: 完全一致(true)か部分一致(false), matchCase: 小文字・大文字を区別する(true)か、大文字・小文字を区別しない(false)});

結果には検索結果のセル範囲が配列で格納されます。

もし検索結果が存在しない場合はundefinedになります。

これはエラーの原因になるため対策しておく必要があります。

if(検索結果の変数名 === undefined){
	// 該当するものがないと undefined
}
else{
	// 該当するものがある場合
}

結果はrangeオブジェクト(getRangeの結果と同じ)の配列で操作は多岐にわたりますが、

代表的なものは次の通りです。

result.getAreaCount(); // 一致件数
result.getAreas(); // 一致したセル(range)の配列
result.getAreas()[インデックス]; // 一致したセル(range)
result.getAreas()[インデックス].getAddress();  // 一致したセル(range)のアドレス
result.getAreas()[インデックス].getValue();  // 一致したセル(range)の値
result.getAreas()[インデックス].clear();  // 一致したセル(range)をクリア
result.getAreas()[インデックス].setValue(設定値);  // 一致したセル(range)を更新

🚀 Excel自動化を「点」から「線」へ。体系的に学びたい方へ

本記事で解説したテクニックは、日々の業務を効率化する大きな一歩です。

しかし、実務で直面する複雑な課題を解決するためには、基礎から体系的に知識を身につけることが最短ルートになります。

「ネットの情報だけでは限界を感じる」「もっと自由自在にツールを作れるようになりたい」

そうお考えのあなたにおすすめしたいのが、Officeスクリプトを網羅的に学べるこちらの電子書籍です。

『ビジネスパーソンのためのOfficeスクリプト入門:Excel作業の自動化とデータ処理【2025年7月大幅改訂版】』

この書籍は、忙しいビジネスパーソンが最短でOfficeスクリプトを習得できるよう設計されています。

本書のここがポイント!

  • 🔰 プログラミング知識ゼロでも大丈夫! 専門用語を避け、初心者目線でやさしく解説。「VBAは難しかった…」という方でも安心してスタートできます。
  • 🔄 VBA経験者はスムーズに移行! VBAとの違いを比較しながら解説しているので、今ある知識を無駄なく活かせます。
  • 【2025年7月大幅改訂】最新トレンドを完全網羅! 話題の生成AIを活用してコード作成を強力に支援する方法を新設。さらに、Power Automateと連携した高度な自動化シナリオも大幅に拡充されています。

「脱・手作業」を実現し、ワンランク上の業務効率化を目指すための必携書です。ぜひ手に取ってみてください。

関連記事

Excel Office スクリプトの記事一覧

Excel セルの検索と置換