概要
Excel 文書（.xlsx、.xlsm）を対象としてテキストの検索または置換をするツールです。
詳細説明
Excel 文書（.xlsx、.xlsm）を対象としてテキストの検索・置換をするツールです。
- Excel 2007 以降がインストールされている PC で実行する必要があります。
- 検索・置換のデータファイルは Excel 文書（.xlsx）です。（.xlsx を編集できるアプリケーションが必要です）
- 検索・置換ログを出力するオプションをオンにした場合、ログファイルは .xlsx 文書として出力されます。
検索・置換データファイルのサンプル
下図は検索・置換データファイルの記述サンプルです（FindReplaceText.xlsx として同梱してあります）。
同梱のファイルを探すとき（特にインストール版をご利用の場合）は、ツールを起動してツールダイアログの灰色部分で右クリック＞［ツールが置かれているフォルダを開く］を選択すると簡単です。
上記サンプルの
- 「大小別」 は「大文字と小文字を区別する」
- 「単語」は「完全に一致する単語だけを検索する（単語単位の検索）」
- 「半全別」は「半角と全角を区別する」
を意味しています。
上記サンプルの右側に記述してある注意事項は下記の通りです。
- １行目に「検索テキスト」「大小別」「単語」「半全別」「置換後テキスト」と記載のある列がツールで使用されます。それ以外の列はツールから無視されます。
- 上記の条件に一致する全てのシートのデータが使用されます。
- 検索テキストは自動的にメモリ上でテキストの長さの順にソートされ、テキストの長いものから検索が実行されます。
- 「大小別」「単語」「半全別」の列は、セルが空であればオフ(False)、何らかの文字が入力されていればオン(True)の意味になります。
- 非表示シートと非表示行は無視されます。
検索・置換ログファイルのサンプル
下図は置換処理後に出力されるログファイルのサンプルです。
なお、ログファイルの「リンク」をクリックすると、該当の文書のシートを開きます（セル位置が分かる場合はそのセルを選択します）。
［セル文字数が255を超える場合の置換処理］オプションについて
ツールのダイアログ上にある［セル文字数が255を超える場合の置換処理］オプションについて説明します。
このツールは Excel VBA と連携して動作するのですが・・・、
255 文字を超えるセル内の文字列を VBA で編集（置換）・保存した場合、セル内の文字列に付けられていた文字書式（文字色・斜体・太字など）は保持されず消えてしまいます。これは VBA の仕様上の制限です。
そのため、セル文字数が 255 を超える場合、文字書式が消えても良いから置換を続行するか、または置換せずにログにレポートするかを、このオプションで選択できるようにしています。
［ヒット個所に色を付ける］オプションがオンの場合の動作について
ツールのダイアログ上にある［ヒット個所に色を付ける］オプションがオンの場合の動作について説明します。
- セルのテキストにヒットした場合、そのセルに色を付けます。
- コメントのテキストにヒットした場合、そのコメントが付けられているセルに色を付けます。
- メモ（旧コメント）のテキストにヒットした場合、そのメモが付けられているセルに色を付けます。
- 入力規則のテキストにヒットした場合、その入力規則が付けられているセルに色を付けます。
- シェイプ（テキストボックス等）のテキストにヒットした場合、ヒットしたテキストに色を付けます。
お知らせ機能について
当サイトの管理人が作成したツールに関するお知らせがある場合、ツールのダイアログの右上にある（i）ボタンが青色や赤色に変わります。
 |  |  |
（i）ボタンをクリックすると、お知らせが表示されます。
このツールは起動時に、ツールに関する「お知らせ」を受信するために、当サイトの管理人が管理するサーバ上のファイルを読み込みます。
コマンドラインからの実行機能について
UI からの操作だけでなく、必要に応じてコマンドラインからオプションを与えて実行することもできるので、スケジューラと組み合わせて指定した時刻に実行したり、他のツールと組み合わせてバッチ処理することができます。
コマンドラインから実行した場合、エラーが無ければ、ツールは処理完了後に自動的に終了します。
主なオプションについて
下記はコマンドラインで指定できる主なオプションの一覧です。
| ダイアログ上のオプション名 | オプションの種類 | コマンドラインでの引数名 | 設定できる値 |
| 対象ファイル | リストボックス | /targetFiles: | フォルダパスやファイルパス |
| フォルダ指定のときサブフォルダも含める | チェックボックス | /subFolders: | True / False |
| 検索 | ラジオボタン | /FindOnlyNotReplace: | Ture |
| 置換 | ラジオボタン | /Replace: | Ture |
| セル | チェックボックス | /ProcessCells: | True / False |
| シェイプ（テキストボックス等） | チェックボックス | /ProcessShapes: | True / False |
| メモ（旧コメント） | チェックボックス | /ProcessMemos: | True / False |
| コメント | チェックボックス | /ProcessComments: | True / False |
| 入力規則（リスト値、メッセージ） | チェックボックス | /ProcessValidations: | True / False |
| シート名 | チェックボックス | /ProcessSheetNames: | True / False |
| 非表示シートは処理しない | チェックボックス | /DoNotProcessHiddenSheets: | True / False |
| 非表示セルは処理しない | チェックボックス | /DoNotProcessHiddenCells: | True / False |
| 置換しないでログにレポートする | チェックボックス | /DoNotProcessOver255ChrsCell: | True / False |
| 置換する（文字書式は失われる） | チェックボックス | /DoProcessOver255ChrsCell: | True / False |
| ヒット個所に色を付ける | チェックボックス | /AddColorToHitTextOrCell: | True / False |
| （色） | ColorPicker コントロール | /textOrCellColors: | A,R,G,B（それぞれ0-255の値） |
| 検索・置換ログを出力する | チェックボックス | /OutputLog: | True / False |
| 検索・置換テーブルファイル | コンボボックス | /findRepListFile: | 検索・置換テーブルファイルのパス |
| ログフォルダ | コンボボックス | /logFolder: | フォルダパス |
- ラジオボタンを選択する場合は、同じグループに属するラジオボタンのうち１つだけを True に指定します（選択しないラジオボタンに False を指定する必要はありません）。
- 指定するフォルダパスやファイルパスに空白が含まれる場合は、フォルダパスやファイルパスを " " で挟んで指定してください。
- 上記以外のその他のオプションについては、コマンドラインで EeoXlsxRepText /? と入力すると確認できます。
- /#CLOptionsFile: オプションを使用すると、複数のコマンドラインオプションを記述したテキストファイルを引数として与えることができます。
- コマンドラインで指定しなかったダイアログ上のオプションについては、ほとんどの場合、ツールが前回終了したときのオプション値が引き継がれます。しかしツールの動作が予期しないものになる可能性を避けるため、必要なオプションは明示的に指定することをお勧めします。
実行例１：コマンドラインに複数のオプションを並べて実行
コマンドラインから下記のように指定できます。
C:\Prompt>EeoXlsxRepText /targetFiles:F:\temp /subFolders:True /Replace:True /ProcessCells:True /ProcessShapes:True /ProcessMemos:True /ProcessComments:True /ProcessValidations:True /ProcessSheetNames:True /DoNotProcessHiddenSheets:False /DoNotProcessHiddenCells:False /DoNotProcessOver255ChrsCell:True /AddColorToHitTextOrCell:True /textOrCellColors:255,255,0,0 /OutputLog:True /findRepListFile:"F:\#Tools\Ellen East\EeoXlsxRepText\bin\FindReplaceText.xlsx" /logFolder:F:\temp
実行例２：複数のオプションを記述したテキストファイルを指定して実行
テキストファイル（名前は何でも良いのですが、仮に CLE.txt とします）に下記のように記述します。（行頭が * で始まる行、改行のみの行は無視されます）
*** 対象ファイル
/targetFiles:F:\temp
*** フォルダ指定のときサブフォルダも含める
/subFolders:True
*** 検索
*** /FindOnlyNotReplace:
*** 置換
/Replace:True
*** セル
/ProcessCells:True
*** シェイプ（テキストボックス等）
/ProcessShapes:True
*** メモ（旧コメント）
/ProcessMemos:True
*** コメント
/ProcessComments:True
*** 入力規則（リスト値、メッセージ）
/ProcessValidations:True
*** シート名
/ProcessSheetNames:True
*** 非表示シートは処理しない
/DoNotProcessHiddenSheets:False
*** 非表示セルは処理しない
/DoNotProcessHiddenCells:False
*** 置換しないでログにレポートする
/DoNotProcessOver255ChrsCell:True
*** 置換する（文字書式は失われる）
*** /DoProcessOver255ChrsCell:
*** ヒット個所に色を付ける
/AddColorToHitTextOrCell:True
*** （色）
/textOrCellColors:255,255,0,0
*** 検索・置換ログを出力する
/OutputLog:True
*** 検索・置換テーブルファイル
/findRepListFile:"F:\#Tools\Ellen East\EeoXlsxRepText\bin\FindReplaceText.xlsx"
*** ログフォルダ
/logFolder:F:\temp
記述したテキストファイルは UTF-8（BOM 付き）または UTF-16LE（BOM 付き）で保存してください。
そして下記のようにコマンドラインからテキストファイルを指定します。
C:\Prompt> EeoXlsxRepText /#CLOptionsFile:CLE.txt
使用制限について
Excel 文書中の最初のシート以外は処理できないように制限が付けられています。
使用制限を解除するには、シェアウェア料金（２，０００円）をお支払いいただき、使用制限の解除を申請していただく必要があります。
料金のお支払い方法については、以下の方法をご用意させていただいております。その他の方法をご希望の場合は「お問い合わせ」フォームからご相談ください。
アマゾンギフト券（Ｅメールタイプ）でお支払い可能です。
送金手数料はかかりません。
受取人のメールアドレスは ellentools【@】elleneast.com にしてください。（【@】を @ に変えてご使用ください）PayPay の送金機能でお支払い可能です。
送金手数料はかかりません。
受け取り用のリンクをメールで ellentools【@】elleneast.com までお送りください。（【@】を @ に変えてご使用ください）- 楽天ペイの送金機能でお支払い可能です。
送金手数料はかかりません。
受け取り用のリンクをメールで ellentools【@】elleneast.com までお送りください。（【@】を @ に変えてご使用ください）
- ゆうちょ銀行への振り込みでお支払い可能です。振込先は下記になります。
（お振込手数料が発生する場合は恐れ入りますがご負担をお願い致します）金融機関：ゆうちょ銀行
店 名：〇二九（０２９）
取引種類：当座
口座番号：0141091
受取人名：エレン イースト
使用制限解除の申請方法については、ツールのダイアログの灰色部分で右クリック＞［使用制限...］＞［使用制限解除の申請フォーム］からご確認ください。
ダウンロード
このサイトからダウンロード
Vector からダウンロード
インストールと実行について
- ZIP 版をダウンロードした場合：
任意のフォルダに解凍すればインストールは終わりです。 EeoXlsxRepText.exe を実行してください。 - インストーラー版をダウンロードした場合：
インストーラー実行後に Windows の［スタートメニュー］＞［Ellen East］＞［EeoXlsxRepText］から、またはデスクトップのショートカットから実行してください。
アンインストールについて
- ZIP 版をダウンロードした場合：
インストールのときに解凍したファイルを削除してください。 - インストーラー版をダウンロードした場合：
Windows の［スタートメニュー］＞［Ellen East］＞「EeoXlsxRepText」のアイコンを右クリックして［アンインストール］を選択し、
インストールされているプログラムの一覧が表示されたら［EeoXlsxRepText］をダブルクリックまたは右クリックしてアンインストールしてください。
動作環境
Windows 10 (64 bit) + Word for Office 365 MSO (16.0) / 1910 で動作を確認。
変更履歴
- 2019-12-25 初版リリース
その他
開発者
エレン・イースト（当サイトの管理人）
配布、転載、雑誌掲載
自由に行っていただいて構いませんが、事後で良いのでご連絡をいただけるとありがたいです。配布の際は、このサイトから入手したファイルに手を加えず、そのまま配布して下さい。
当ソフトウェアの使用条件を緩和または解除するパスワードやファイルがあってそれを入手した場合、それを直接的または間接的な方法で他人・他の団体等に漏らしたり公開したりしないようお願い致します。
ご連絡方法
バグ修正依頼・ご要望・お問い合わせ・ご感想などありましたら、該当ツールのページのコメント欄または「お問い合わせ」フォームからお願いします（コメント入力時またはフォーム入力時のメールアドレスは連絡が取れる正しいものを記入してください）。
もしも「お問い合わせ」フォームから連絡が取れない場合は「その他の連絡方法」もお試しください。
著作権について
当ソフトウェアは、当サイトの管理人であるエレン・イーストの著作物であり、エレン・イーストによってのみライセンスされます。
当ソフトウェアに対するリバースエンジニアリング及び、改変は一切禁止します。
免責事項
当サイトの管理人（エレン・イースト）は、当サイトの管理人が開発したソフトウェアを、当サイトまたは Vector 等のソフトウェア公開サイトを通じて公開しています。
当サイトの管理人が公開したソフトウェアを使用したことによる（または使用できなかったことによる）いかなる損失・損害・障害・不具合・不利益等についても、当サイトおよび当サイトの管理人およびその関係者は一切の責任を負いません。各自の責任においてご使用ください。
バグや不具合等のご報告・ご意見等を歓迎しています。そういったご連絡についてはできるだけ前向きに対処したいと考えています。
ただし、当サイトの管理人およびその関係者は、公開したソフトウェアについてのサポートおよび修正の義務を一切負わないこととします。
シェアウェア料金をお支払いいただく場合は、事前に十分な動作確認の上お申し込みください。
本アプリケーションで使用しているソフトウェア
本アプリケーションでは以下のソフトウェアを使用しています。
- ソフトウェア名：Extended WPF Toolkit
著作権：Xceed Software Inc.
ライセンスの種類：Ms-PL
ライセンスの全文：https://github.com/xceedsoftware/wpftoolkit/blob/master/license.md#microsoft-public-license-ms-pl - ソフトウェア名：ClosedXML
著作権：Copyright (c) 2016 ClosedXML
ライセンスの種類：MIT
ライセンスの全文：https://github.com/ClosedXML/ClosedXML/blob/develop/LICENSE
