Excelファイルを比較するツールを作ってみた

![](https://qiita-image-store.s3.amazonaws.com/0/206881/8dddcad0-516e-ae8b-6ff0-ab8589547e43.png)

# はじめに
Excelファイルの比較には___WinMerge___に___xdocdiff___のプラグインを入れて使っていたのですが、
列が揃ってなかったり、ヘッダを固定できなかったりと少し不便に感じていました。
そんなわけでExcelファイルを比較するツールを自作してみたので、紹介と使い方を書いていこうと思います。

# 注意
このツールは筆者の仕事環境において必要最低限の要件で作成しています

# インストール

### [ここ](https://github.com/skanmera/ExcelMerge/releases) から最新の.msiをダウンロードする

![SnapCrab_NoName_2017-10-29_16-4-52_No-00.png](https://qiita-image-store.s3.amazonaws.com/0/206881/b7c60f3d-d43e-9e3d-dec2-33e4dc6221b8.png)

### ダウンロードしてインストーラーを実行する

※電子署名をしていないので、以下のウィンドウが表示されると思います。「詳細」→「実行」で実行できます。

![](https://qiita-image-store.s3.amazonaws.com/0/206881/921436fc-5ab4-72fa-33fc-1a4fa56a5390.png)


![](https://qiita-image-store.s3.amazonaws.com/0/206881/ecc6101b-c74b-f8d1-7768-acc7227147a7.png)


### Nextを選択
![](https://qiita-image-store.s3.amazonaws.com/0/206881/c75fa744-8435-ba3b-fb3d-4fd7e7f9e807.png) 

### インストールするディレクトリと、ユーザーを選択 (特に指定がなければそのままNext)
![](https://qiita-image-store.s3.amazonaws.com/0/206881/9b0874d7-25dd-0042-f9f6-345706866d74.png)

### Nextを選択
![](https://qiita-image-store.s3.amazonaws.com/0/206881/145c1921-6194-19d1-b3a7-9b328f798e49.png)


# 起動方法

###　ショートカットアイコン
インストールが完了すると、デスクトップにショートカットアイコンが作成されるので、起動して上部メニューの「ファイル」から比較するファイルを選択する

![](https://qiita-image-store.s3.amazonaws.com/0/206881/dd82bdec-91dd-a6de-7ba8-f4d137ac22be.png)

### エクスプローラのコンテキストメニュー

エクスプローラでファイルを選択した状態でコンテキストメニューを開き、ExcelMergeを選択する

![](https://qiita-image-store.s3.amazonaws.com/0/206881/a110aeca-5ee8-4f0d-9e08-133542a124bc.png)


### コマンドライン

コマンドラインからオプションを指定して起動することもできます
オプションに関しては [README](https://github.com/skanmera/ExcelMerge#from-command-line) を参照してください

# 使い方

## 差分を抽出する
ファイルを選択している状態で「差分抽出」を実行することで選択中のシートの比較結果が表示されます。

![](https://qiita-image-store.s3.amazonaws.com/0/206881/cfbc0d4d-ce4d-3f7a-f33b-621ff87c0a2b.png)


コンテキストメニューやコマンドラインから起動した場合、差分が抽出可能であれば自動で抽出されます。

## 列ヘッダ、行ヘッダを変更する
デフォルトで列ヘッダは0行目の内容が、行ヘッダは行のインデックスが表示されます。
変更するには変更したい行、または列の任意のセルを選択した状態でコンテキストメニューを開き「列ヘッダに設定」または「行ヘッダに設定」を選択します


デフォルトで表示されている行インデックスから「氏名」に変更する場合
![](https://qiita-image-store.s3.amazonaws.com/0/206881/549b5a5e-86d4-5394-c236-77cf1b03866c.png)

![](https://qiita-image-store.s3.amazonaws.com/0/206881/61ff81fa-9b26-650d-6d2e-2f578780edde.png)

![](https://qiita-image-store.s3.amazonaws.com/0/206881/5528836f-6fe8-894e-b088-2f12e94392d8.png)


## ファイルごとに設定を作成する

毎回列ヘッダや行ヘッダを設定するのは面倒なので、事前にファイルごとに設定を行います
上部メニューの「設定」から「ファイル設定」を選択し、追加ボタンを選択します

![](https://qiita-image-store.s3.amazonaws.com/0/206881/688a7215-a7ad-a275-b912-2541b5f29f25.png)

設定を追加します
![](https://qiita-image-store.s3.amazonaws.com/0/206881/130941c9-ee0c-c4ab-21ac-812e0cde65b0.png)

- 「名前」はファイル名か正規表現で記述します
- 「行ヘッダインデックス」は-1で行インデックスが表示されます
- 「行ヘッダ」名は「行ヘッダインデックス」が指定しにくい場合などに、列ヘッダの名前で指定します。※同じ列ヘッダ名が複数存在するときは最初に一致したものを表示します
- ファイル名を指定した場合は完全一致をチェックします


## バージョン管理ツールのDiffツールとして使用する

### 外部ツールを登録する
バージョン管理ツールのDiffツールとして使用する場合、テキストファイルや画像ファイルなどは通常のDiffツールで開く必要があるので、
サポート対象外のファイルの場合に起動する外部ツールを登録する必要があります。
※ここではWinMergeを外部ツールとして登録します

上部メニューの「設定」から「外部コマンド」を選択し、追加ボタンを選択します

![](https://qiita-image-store.s3.amazonaws.com/0/206881/6bb64970-90e3-6b79-7b63-fb1cc52655c7.png)

- 「名前」はこのコマンドの名前を登録します。コマンドラインから起動する際に指定されます
- 「実行ファイル」は実行するexeなどのパスを指定します
- 「引数」には実行ファイルに渡す引数を指定します

#### 利用可能な変数
|変数|説明|
|------|----------|
|```${SRC}```|右側のファイルパス|
|```${DST}```|左側のファイルパス|  


### Gitの外部ツールとして登録する
.gitconfigにdiffツールを追加します

```ini:.gitconfig
[diff]
tool = WinMerge

[difftool "WinMerge"]
cmd = \"C:/Project/Github/excelmerge/ExcelMerge.GUI/bin/Debug/ExcelMerge.GUI.exe\" diff -s \"$LOCAL\" -d \"$REMOTE\" -c WinMerge -i -w -v -k 
```

- -c で先ほど登録した外部ツール(WinMerge)を指定しています
- -i で .xls .xlsx .csv　以外のファイルの場合はダイアログなしで外部ツールが起動するように指定しています
- -v で拡張子のチェックをします (-v 指定がないと例外が発生→外部ツール起動 となります)
- -w で外部ツールのプロセス終了を待つようにします (プロセスを待たないと一時ファイルが削除されるため)

これでSourceTreeからも使用が可能になります
![](https://qiita-image-store.s3.amazonaws.com/0/206881/05d2d931-15ba-57b1-e4e2-cf7bdb8d8c2a.gif)

### Mercurialの外部ツールとして登録する

mercurial.iniにdiffツールを追加します

```ini:mercurial.ini
[merge-tools]
excelmerge.executable = C:\Program Files (x86)\ExcelMerge\ExcelMerge.GUI.exe
excelmerge.diffargs = diff -s $parent1 -d $child -c WinMerge -i -w -v -e empty -k

[tortoisehg]
vdiff = excelmerge

[extdiff]
#extdiffはコメントアウトする
#cmd.wmdiff = C:\Program Files\WinMerge\WinMergeU.exe
#opts.wmdiff = /r /e /x /ub
```

Gitの場合とオプションはほぼ同じですが、追加、削除のステータスのファイルを比較するときにemptyというファイル名で空のファイル名が渡されるので
-e で空のファイル名を指定しています

### 変更ログを出力する
コミットログなどに記載する際に、変更点をログとして出力できます。
変更点をログとして出力したいセルを範囲選択します。(全部の場合はCtrl + A)で全選択
コンテキストメニューの「ログを出力」を選択します

![](https://qiita-image-store.s3.amazonaws.com/0/206881/266f5d3a-7601-33cf-bba2-4426879c5e89.png)

ログのフォーマットは「差分抽出設定」から変更可能です。


## ショートカットキー

|キー|説明|
|---|-----------|
|Ctrl + →|次の変更されたセルに移動|
|Ctrl + ←|前の変更されたセルに移動|
|Ctrl + ↓|次の変更された行に移動|
|Ctrl + ↑|前の変更された行に移動|
|Ctrl + K|次の追加された行に移動|
|Ctrl + I|前の追加された行に移動|
|Ctrl + L|次の削除された行に移動|
|Ctrl + O|前の削除された行に移動|
|Ctrl + F|セルを検索|
|F9|次の検索結果に一致するセルに移動|
|F8|前の検索結果に一致するセルに移動|
|Ctrl + C|選択したセルをタブ区切りでコピー(エクセルへの貼り付け)|
|Ctrl + Shift + C|選択したセルをカンマ区切りでコピー|
|Ctrl + D|コンソールを表示(隠す)|
|Ctrl + B|選択範囲の差分をログとして出力|

# 問題点
列の追加、削除が複数ある場合、列の並び順が想定通りにならないことがあります。
この場合、コンテキストメニューから正しい列ヘッダ(できるだけ一意なヘッダ)を指定して差分を取ると正常に表示されることがあります。


# プロジェクト
 プロジェクトは[GitHub](https://github.com/skanmera/ExcelMerge) で公開しています

Gridはパフォーマンスを優先するため [FastWpfGrid](https://fastwpfgrid.codeplex.com/) を使用しています

# おわりに
今回作成したツールを実際に業務で少し使ってみましたが、
コミット前の差分確認やコンフリクトの解消にかかる時間とストレスを少し軽減できたような気がします。
最終的にはマージする機能を実装することなので、今後も更新していくつもりです。

※この記事で使用したExcelファイルは  [こちら](https://hogehoge.tk/personal/generator/) のサイトを利用しました