oneWEX検証メモ - (3)ContentMinerによる文書の検索

#はじめに
oneWEXを使ってみた時のメモです。

おさらい
[Watson Explorer の概要](https://www.ibm.com/support/knowledgecenter/ja/SS8NLW_12.0.0/com.ibm.watson.wex.ee.doc/c_ee_getstarted.html)
>Watson™ Explorer は、検索とコンテンツ分析を組み合わせることによって、ユーザーが非構造化情報を見つけて理解できるよう支援します。ユーザーはその情報を使用して、作業を効率化し、急所となる時点でより的確で信頼できる意思決定を行うことができます。 Watson Explorer では、以下のことができます。
* コグニティブ探索: すべての組織のデータを形式、格納場所、管理場所にかかわらず、安全に接続したり、検索したり、探索したりできます (既知の項目の検出)。

ここでは、oneWEXの"検索/探索"という機能に着目し、ContentMinerを使って文書の検索がどのように行えるかをやってみたいと思います。
("分析"の辺りはまた別途。)

##関連記事

インストール関連
[oneWEX導入メモ / Ubuntu編](https://qiita.com/tomotagwork/items/bdd48adf45140b584678)
[oneWEX導入メモ / RHEL7.6 オフライン編](https://qiita.com/tomotagwork/items/6ad047d0b72e199b7878)

検索関連
[oneWEX検証メモ - (0) 概要理解](https://qiita.com/tomotagwork/items/2c00007f45a3d2e482ea)
[oneWEX検証メモ - (1)ファイルシステムクローラーによるデータの取り込み / データセット、コレクションの作成](https://qiita.com/tomotagwork/items/00301322d4336b52d1e3)
[oneWEX検証メモ - (2)Windowsファイルシステムクローラーによるデータの取り込み](https://qiita.com/tomotagwork/items/1619624af8a64cf330d4)
[oneWEX検証メモ - (3)ContentMinerによる文書の検索](https://qiita.com/tomotagwork/items/24b5bbcc85c6bada41da)
[oneWEX検証メモ - (4)ApplicationBuilderによるWebアプリの作成と文書の検索](https://qiita.com/tomotagwork/items/a53b2c7f52cb1dcb68d9)

分析関連
[oneWEX検証メモ - (5)ContentMinerによる分析 / ガイド付きモード](https://qiita.com/tomotagwork/items/a9c381a477594453e2b1)
[oneWEX検証メモ - (6)ContentMinerによる分析 / 各種"ID情報"をベースとした分析](https://qiita.com/tomotagwork/items/9269fd31109638e6dd89)

API関連
[oneWEX検証メモ - (7)REST API](https://qiita.com/tomotagwork/items/7c1340f41333896f8fe3)



# 全体像
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/6be80d42-6b0c-0c16-c45d-1f5d7a894242.png)

# 文書の検索/探索のバリエーションを試す
検索(search)、探索(explore)という2つの用語が使われていますが、前者はキーワードを入れてそれに関連する文書を見つける、後者は他の様々な切り口から対象を絞り込んでいって目的の文書にたどり着く、というイメージでしょうか。

とりあえず、前回までの手順で作成したデータに、検証用のExcelファイルも2つほど追加して、検索/探索を試してみます。
以下のTroubleReport以下のWordファイルx3、および、Case01以下のExcelファイルx2 の合計5ファイル取り込んだ状態で試します。
https://github.com/tomotagwork/WEXTest01/tree/master/SampleFiles

基本的な挙動はいずれのコレクションでも同じはずなので、ここではoneWexTest02(NFS接続構成)のコレクションを利用します。

## キーワード検索 / 基本
単純に「トランザクション」というキーワードを入力して検索してみます。
目的としては、「トランザクション」というキーワードを含む文書をリストアップしたい。

ContentMinerでコレクションを選択し、一番上のフィールドに「トランザクション」を入力して虫眼鏡ボタンを押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/46944c70-1ba9-b7ee-fedf-37277a76ff65.png)

全体で5件のファイルがあるうちの、4件ヒットしたことが分かります。文書の表示をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/c93e070d-b5db-83b8-afa6-32899c023874.png)

キーワードを含む文書の一覧が表示されました。文書のURIと指定したキーワードを含む前後の文章も合わせて表示されています。Google検索っぽい結果ですね。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/58ab9afb-1dc9-a407-6d23-b60d21a5a3a0.png)

ただ、ディレクトリ名やファイル名に日本語が含まれていると、それらはURLエンコードされてしまうらしく、上の画像のようによくわからない表示になってます。(この画面をカスタマイズできるのかは不明。)

上のリストのURIの1つ(1番下のExcelファイル)をクリックしてみると、こんな感じで対象ファイルの中身が確認できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/90581750-2c2c-1821-49f8-cda774f4c43b.png)

Excelから文字列情報を抽出して本文として解釈しているイメージでしょうか。

ちなみに元のExcelファイルはこんなイメージです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/85a36bdd-4cdc-d30f-9000-70f6dda966d9.png)

先頭のタブの情報には、なぜか実際のExcelファイルには存在しないカタカナの情報も混在しているようです("ケンサクタイショウヒロ"など)。この挙動は謎です。
ただ、タブ名や図形オブジェクト中の文字列もbodyに取り込まれているため、検索対象にはなり得そうです。
ファイル名自体はbodyに含まれるので検索対象にはならないようです。
また、1つの単語が左右や上下に連続しているセルに分割されてしまう場合、そこで文字列が分割されてしまうため、連続した文字列としては判別してくれません(まぁこれはだいたい想像通りです)。

※追記
作成されたコレクションをAdmin Consoleで見ると、「フィールド」タブに「フリーテキストで検索可能」というチェックボックスがフィールド単位にあります。デフォルトではbodyにしかチェックが入っていないので、例えばFileNameフィールドにチェック入れてあげれば、ファイル名も検索対象になってくれると思われます(検証はできてないですが)。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/2c59ccfb-1afd-aec5-e578-c5b0ec7d4203.png)



さて、本来の目的は、簡単に対象となるファイルにたどり着きたいということです。キーワードを元に、対象となるファイル探したら、当然そのファイルを開きたい訳なんですが、どうやらこのContentMinerのUIには、対象のファイルをブラウザ経由でダウンロードする仕組みが提供されていなさそうです。かゆい所に手が届かない感じ。

-----

*なんで??? なんで??? Webサーバー機能あるなら仮想ディレクトリからそのファイル辿れるようにしてくれればブラウザからファイルダウンロードできるんじゃね? そのくらいやってくれてもいいんじゃないの? 手抜きなの? 意地悪なの? ファイルを扱うのはそもそも眼中に無いの? 
気づいていないだけでそういう機能はあるはずだと思って有識者に聞いてみたところ「それはWEXの役割じゃない」と普通に言われてしまったので、やっぱりできないんでしょう...。ちなみにOSSのFESSでは普通にできます(参考:[Fess環境構築メモ](https://qiita.com/tomotagwork/items/ce4d66984e809a44dbc1))。*

-----

ということで、対象のファイルにたどり着いたはいいが、いざそのファイルを開こうと思うと、正直困ります。
URIからファイルの配置場所とファイル名は判断できるので、まず、URLエンコーディングされている文字列をどうにかしてデコードしてあげて、そのうえで、LinuxもしくはWindowsから個別にファイルを入手する、ということをしなければなりません。つまり、ファイルを共有するための仕組みは別途用意しておく必要があるということのようです(FTP, SCPなどでファイルを入手するのか、Windowsにリモートデスクトップで接続してファイルをコピーするのか、Webサーバーを別途立ててブラウザ経由でアクセスできるようにするのか...)。

一応、対象ファイルを選択した後、"フィールド"というタブを選択すると、各フィールド情報が参照でき、その中にFileNameのフィールドがあって、この部分については日本語名称が確認できました。パスは相変わらずエンコードされたままですが。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/4bd26f7c-f798-97d1-aba1-83df1053049f.png)

んー、厳しくないか、これ。
とりあえず一旦忘れて次にいきます。

## キーワード検索 / 複数条件指定

AND, OR, NOTの指定ができるようです。


|キーワード指定|検索内容|
|---|---|
|トランザクション|"トランザクション"を含む文書|
|トランザクション AND CICS|"トランザクション"を含み、かつ"CICS"を含む文書|
|トランザクション OR てすと|"トランザクション"を含む、もしくは"てすと"を含む文書|
|トランザクション AND (NOT CICS)|"トランザクション"を含み、かつ"CICS"を含まない文書|

「トランザクション AND CICS」での検索結果例
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/d00e65b6-5a0b-6f8d-c60f-563626d67e44.png)

## ファセット値の検索
上の検索は、いわゆる本文(body)の内容の検索でしたが、ファセット値を指定した検索もできるようです。
例えば、ファイル名はbodyに含まれないので上の検索の対象とはなりませんが、FileNameファセットとして認識されているので、FileNameファセットを明示的に指定すれば検索可能です。
「<ファセット名>:<ファセット値>」というような指定方法をすると、特定の値を持つファセットを検索できます。また、ファセット値にはワイルドカード"```*```"も指定できます。
例えば、ファイル名として"障害報告"という文字列を含むファイルを探索したい場合、「```Filename:*障害報告*```」と指定して検索すればよいです。
また、「```Directory:*チーム01* AND FileName:*障害報告*```」と指定すれば、ディレクトリ名に"チーム01"を含み、かつ、ファイル名に"障害報告"を含む文書の検索が行えます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/f11e60f1-2563-373e-2981-9c0ccb7526f0.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/e4edb7f4-b671-2403-4cbe-16fadcc3699b.png)


## メタデータファセットから探索
コレクションを開いたときに下に表示されているファセットのファセット値を選択してみます。
例えば、Extensionの.xlsxをクリックします。すると、検索窓に.xlsxが追加されます。
これは、Extensionが.xlsxのものを抽出する、つまりExcelファイルを抽出する、ということになります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/7e3d5b50-d7e4-a04d-6db1-cf7e94b330d0.png)

これで検索ボタンを押せば、Excelファイルが抽出されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/26d91349-22a3-5745-2a5b-20986ce2c786.png)

文書の表示をクリックすれば先の例と同じように対象ファイルのリストが表示されます。

複数のファセットを選択すれば、AND条件で絞り込みが行えます。
例えば、以下の例では、Directoryから/mnt/oneWexTest02/Case01を選択し、Extensionから.xlsxを選択しています。これはmnt/oneWexTest02/Case01ディレクトリ下にある.xlsxファイルを抽出する、ということになります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/9c829888-58d0-ae62-d9bb-2b9aaccc6f7c.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/66198867-ddde-3267-33e9-09baa7d48022.png)

## 品詞ファセットから探索
デフォルトだと、品詞に関するファセットが自動で付与されています。右上のプルダウンからファセットを選択すると、品詞に関するファセットの一覧が表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/2cd908bc-030e-fa04-3cb0-f4689a89ddcf.png)

bodyに含まれる文字列情報が形態素解析されて品詞毎に上のように管理されています。例えば、名詞に関して言えば"トランザクション"という文言が含まれている文書は4件ありますよ、とか、形容詞として"異常だ"という意味の文言が含まれている文書は3件ありますよ、というのが分かります。

メタデータ・ファセットと同じように、ファセット値を選択して検索すれば、該当する文書の検索ができます("異常だ"という形容詞を含む文書を検索するなど)。

例えば、形容詞から"異常だ"を選択して、かつ、DirectoryとしてTroubleReportを含むものを指定するといった検索もできます。(障害報告書の中から"異常だ"という表現を含むものを検索)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/b4814ce6-90e9-fb09-198c-ac7293692338.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/21b22ab1-da06-3056-a253-e3d9c894b856.png)

## 検索条件の追加
一旦検索条件を指定して検索したのち、件数がまだ多いような場合にさらに絞り込みを行うこともできます。
表示されたグラフの右端のノードをクリック-照会テキストの追加をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/11a10e95-9603-acc9-69c5-919e7e503ba3.png)

"アベンド"というキーワードを追加
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/48b10cc9-4ddc-e6a7-39b6-545d08636464.png)

さらに条件が追加されて絞り込みが行われます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/7b2ed1a7-9a15-9240-9877-19ce3b3755b7.png)

## 自然言語処理についての考察
内部的には、"全文検索"を効率的に行うために、転置インデックスというものを作成してどういう言葉がどの文書に含まれているか、という情報を保持しています。その際、操作対象となる日本語の文章はトークナイザによって形態素解析が行われて各品詞に分類され、さらに正規化が行われてゆらぎを吸収しつつインデックスの作成が行われています。(内部的にはそのようにしているはず...)
参考: [検索エンジンの常識をApache Solrで身につける](https://www.atmarkit.co.jp/ait/articles/1111/18/news148.html)

対象の文章がどのように解釈され、どのように検索されるのかを、少し細かく追ってみます。

### 検索キーワードの解釈と、対応する文書の判定の流れ
例えば、「異常終了」という文字列で検索してみます。
検索結果の文書を一覧表示させた画面がこちら。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/67a94782-296a-b2d4-41e9-0b45ce4213a8.png)
ヒットした箇所が緑色でハイライトされていますが、"異常終了"という文字列だけでなく、"異常な" ... "終了" という文書もヒットしています。
これは、恐らく、検索文として入力した「異常終了」という文字列も形態素解析され、"異常な" "終了"というように形容詞+名詞と判断され、両者が含まれる文書がヒットした、ということだと推察されます。

取り込まれた文書がどのように解釈されているのかも見てみます。
文書を選択してアノテーションの所をみると、この文書がどのような品詞に分類されているのかが分かります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/997637a2-1099-73ad-9dee-b05e5747e255.png)
"異常終了"に関する部分を見ると、"異常だ...終了"という句で判断されて、形容詞としての"異常だ"と名詞としての"終了"がアノテーションとして付与されていることが分かります。つまり、形容詞"異常だ"と名詞"終了"を含む文書であると認識されている訳です。
「異常終了」と検索窓に入れて検索すると、正に形容詞"異常だ"と名詞"終了"を含む文書を探しにいき、この文書がヒットした、ということになると思われます。


### 検索キーワードをダブルクォーテーションでくくる
「"異常終了"」というように、ダブルクォーテーションで文字列をくくった場合はどうなるでしょうか。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/74acecf5-9ff2-f5b3-464f-f6f6ed9f3c31.png)

結果は"異常な ... 終了..."という文字列が含まれる文書はヒットせず、"異常終了"が含まれる文書のみがヒットしました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/92ea4ddf-e521-ed45-a7a5-b2b5ea76ce70.png)

最初、ダブルクォーテーションでくくると、完全一致になるのかなと思いましたが、ヒットした文書に付与されているアノテーションを見ても"異常終了"という単語が認識されている訳では無く、なぜこれがヒットするのか解せませんでした。
次に、以下のようにダブルクォーテーション付きで「"異常な終了"」と入れて検索すると、全く同じ結果で、"異常終了"を含む文書がヒットしました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/978e3c33-3781-1a04-9ade-04d7b4245050.png)
このことから推察するに、恐らく、ダブルクォーテーションでくくられたキーワードは、形態素解析により形容詞"異常だ"と名詞"終了"と解釈され、かつ、それが連続して登場するもの、という条件で該当する文書を探しに行っているのではないかと思われます。
「"異常だ終了"」、「"異常に終了"」というキーワードでも、同様に、"異常終了"を含む文書が検索されました。
「"終了異常"」だとヒットしません。

結論: ダブルクォーテーションでくくった場合、文字列完全一致で検索する訳ではない。形態素解析は行われて、かつ、その連続性が検索条件に加わるものと思われます。


### エラーコード/メッセージIDのようなもの (A001)
例えば、A147とかDFS0006Eなど、アルファベットと数字の組み合わせのコードが含まれる文書があるとします。例えば障害報告書なんていうのは、そういうエラーメッセージのコードとかエラーの種類を示すアベンド・コードとかが重要だったりします。
これも、アノテーションの情報を見る限りでは、アルファベット部分を名詞として、数字部分を数詞として識別しているようです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/ac4411c5-833b-1c3f-1d05-567b34276ef4.png)
"TRAN0002" => 名詞"TRAN" + 数詞"0002"
"A002" => 名詞"A" + 数詞"002"

検索キーワードとしても同様に解釈されるので、単に「A001」(ダブルクォーテーション無し)で検索すると、"A"という文字列と"001"という文字列を含む文書を検索してしまいます。
連続したA001を検索したい場合は、ダブルクォーテーション付きで「"A001"」と入力して検索する必要があります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/61c74021-6454-ba5a-c29c-2117bf9ec211.png)

## 専門用語の登録
上で見た例のように、"異常終了"というのは形容詞"異常だ"+名詞"終了"と解釈されます。これは、デフォルトで使われているトークナイザーが一般的な日本語としての解釈に基づいて分類を行っているためです。
"異常終了"というのはシステム屋さんの間では1つの名詞のように扱われると思うので、1つの単語として扱って欲しい所です。分野によってはそういう専門用語が色々とあると思いますが、それを解釈させるために"辞書"を登録する機能があります。

### 登録したいキーワードのリスト準備
テキストファイル(UTF-8)で、登録したいキーワードのリストを用意します。
とりあえずここでは以下の3つのIT関連の名詞のリストを作成します。

```csv:annotator_ITWord01.csv
異常終了
アベンド
メインフレーム
```


### 辞書アノテーターの追加
Admin Consoleのリソースというメニューを開き、アノテーターの追加ボタンを押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/990aad6d-3a29-c290-48c7-b5ba23f461a4.png)

名前を付けて、アノテータータイプに"辞書"を指定し、次へ。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/8b5f4be3-89f0-cf13-e3f8-4bb426d3eb8b.png)

インポートを選択して、先に作っておいたキーワードリストのファイルを選択
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/995845ae-9dac-5929-0a01-8eb311743dac.png)

インポート！
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/a6e37440-51f9-2510-f238-bc94fe09b01a.png)

ファセット名などを指定します。言語は日本語を指定。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/57106ae1-1519-24d3-97b7-3ec9cf001a71.png)

用語一覧をみると、取り込まれた用語を確認できます。ここで個別に追加/削除/編集もできます。
OKだったら保存します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/cc460690-3d9a-0170-fa48-26e8008803d6.png)

### コレクションに辞書を適用
上で作成した辞書をコレクションに適用します。
AdminConsoleにてコレクションを選択し、エンリッチのタブを開きます。
アノテーターの欄に、上で作成した辞書アノテーター(ITWord01)が表示されるので、チェックを入れて、変更を保存します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/73000c7c-9152-21c0-ab82-6eb61efe31d8.png)

以下のポップアップが聞かれるので「はい」を押して索引を再作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/e1d96c35-f40d-0de4-3316-96a7f5bc3d66.png)

索引再作成が完了したら、準備OKです。

### 辞書登録した用語の動作確認
ContentMinerで辞書アノテーターを適用したコレクションを開いてみると、ITWord01というファセットが追加されています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/5b42a6d7-6ac8-e8e4-f3b5-c746270ac98a.png)

このファセットの"異常終了"クリックして検索してみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/85cda3b6-a127-c462-c550-c754f95d35a2.png)

"異常終了"というIT用語が含まれる文書のみがヒットしました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/90d6bc64-1e22-89f2-a737-0cdcf3cdf992.png)

ヒットした文書の1つを選択してアノテーションの情報を見てみると...
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/edc7259d-57e7-b5c7-7778-39a83e918e26.png)

"異常終了"という名詞が認識されて、形容詞"異常だ"、名詞"終了"というのは含まれていませんでした。

#### 謎の挙動???
さて、上のところまでは想定通りだったのですが、ちょっと説明ができない動きがあります。
上に示した通り、辞書を適用すると、形容詞"異常だ"、名詞"終了"というアノテーションは付いていないので、それらの用語で普通に検索した場合(ファセットやダブルクォーテーションを付けんない場合)、この文書はヒットしないだろうと想定しました。
ところが、どちらも検索結果として"異常終了"を含む文書がヒットしちゃいました！

「異常だ」で検索した結果
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/6d4f886d-29e0-778e-4637-d5a3913e84f7.png)

「終了」で検索した結果
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/01e672a0-13a5-577f-714d-68493a4f9fc9.png)

んー、なんで？
これがヒットするロジックがちょっと不明でした。

もちろん、明示的にファセットから形容詞の「異常だ」を指定したり(```annotation._word.adj:"異常だ"```)、名詞の「終了」を指定(```annotation._word.noun:"終了"```)した場合はヒットしないんですけど。

## シノニム(同義語)の登録
異なる単語であっても同じ意味の言葉があります。例えば、異常終了とアベンドとか(一応補足しておくと、アベンドとは、Abnormal Endの略です)。
"異常終了"を調べたら、"異常終了"を含む文書だけでなく、"アベンド"を含む文書も検索して欲しいですね。その場合、同義語を登録しておくことでそのようなことが実現できます。

### 登録したい同義語リストの準備
テキストファイル(UTF-8)で、登録したい同義語のリストを用意します。1行にカンマ区切りで同じ意味として捉えてほしいキーワードを並べます。
とりあえずここでは以下の3種類IT関連の名詞のリストを作成します。

```csv:synonym_ITWord01.csv
異常終了,アベンド,abend
メインフレーム,ホスト,Mainframe,Host
CICS,キックス
```

※カタカナでキックスなんて書いてるの見たことないけどね。テスト用なので...

### コレクションにシノニムを適用
AdminConsoleにてコレクションを選択し、探索のタブを開きます。
シノニムの欄のアップロードボタンを押して、上で作成したファイルを選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/f22890d7-07c8-24b0-74d3-5002b17400ac.png)

この変更の場合、索引の再作成は不要なので、これで準備OKです。

### 同義語の動作確認
ContentMinerで登録した同義語で検索してみます。

「異常終了」で検索してみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/145b15a8-10ce-1245-d3c3-b8bcd05b367d.png)

"異常終了"だけでなく、"アベンド"も検索されるようになりました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/132331/c2c031fd-11b3-24c9-3b27-041e09b29c82.png)

「abend」で検索しても同じ結果となります。

#まとめ

## UIについて
色々柔軟に検索できそうなことは分かりましたが、目的のファイルにたどり着いたとしても、それを直接ブラウザ経由でダウンロードしたり開いたりすることができない、というのは致命的な気がします。
WordやExcelやPDFなどのファイルを対象とする場合、ContentMinerはあくまで"分析用"のツールとして利用する、もしくは管理用/確認用のツール?、と捉えるべきなんですかね。
WEXとしては、ここで検索/分析しているような操作に対応するAPIを提供しているはずなので、ファイルのダウンロード機能を含め、UIとして色々とカスタマイズをしたい場合は、それらのAPIを使用してアプリケーションを個別に作成する必要がありそうです。
その辺についてはApplicationBuilderというツールでWebアプリを簡単に開発するための支援ツールが提供されているので、とりあえずはそちらが一つの解決策になりえそうですが...。
ApplicationBuilderは出来合いのウィジェットをペタペタ張り付けるだけでWebアプリ簡単に作成/カスタマイズできますよ、というものです。ただ、できることは限られそうですし、コードレベルでのカスタマイズもできるのですが、いかんせんマニュアルに情報が少なすぎて、PDもすぐ行き詰るし、凝ったことをしようと思うとハードルがかなり高いです。
一般ユーザー(?)に公開するようなきちんとした仕組みを作りたいのであれば、提供されているAPI使って一からアプリ作る必要があるのかなと思います。
ApplicationBuilderについては別の記事で取り上げます。

## メタデータファセットについて
クローラーによりファイルを取り込む場合、探索や分析の切り口になり得るメタデータファセットは、結構限られた情報のみです(ディレクトリ、ファイルサイズ、更新日時、拡張子など)。その中でも更新日時は要注意です。oneWEXに取り込むために、既存のファイルをある程度分類して、oneWEXから取り込める場所に配置する、というようなことを事前に行うことが想定されますが、その際、ファイルの移動の仕方によっては、ファイルのタイムスタンプが更新されてしまうため、ファイル更新日時の情報が全部同一になってしまう可能性があります。そうすると、そのファイル更新日情報はほとんど意味をなさなくなってしまいます(一度更新されてしまうと本来の時刻に戻すのは困難なため、この情報をきちんとコントロールするのは結構シビアです...)。
これら以外に、外から付加情報をどれだけ与えられるか...??? (一体何をどうやって???)

## 検索/分析対象の本文について
Excelでたくさんのタブから構成される文書であっても、Wordの中にたくさんの表や多くのページにわたって記載されている情報でも、1つのファイルに含まれる情報は全てbodyというフィールドに1かたまりの巨大でフラットな文字列情報として保持されています。タブで分類されていようが、表形式で項目とパラメータが1対1になっていようが、そこを人間が見て判断するように、意味のある構造を勝手に解釈するようなことはしてくれていなさそうです。さて、こういう状態で取り込まれたデータを使って、どんな分析ができて、どういう洞察を与えてくれるのでしょうか...。