# MaiML HANDS-ON

## 実行自動化
## [Windows PCで実行]
実行環境は、windows10のバージョン1809以降、もしくは、windows11を対象とする。
1. 使用するPCに、下記に記載のwindowsパッケージマネージャ、PowerShell、pythonがインストールされていて、コマンドが使用できることを確認
   - winget
   - PowerShell
   - python 3以上
1. **ForWindowsUser**フォルダを開く
2. セットアップ用バッチファイルを管理者権限で実行
   - **windowsSetup.bat**ファイルをダブルクリック
   - **viewerSetup.bat**ファイルをダブルクリック（MaiMLViewerの手動セットアップは[こちら](https://github.com/MaiMLFileHandlingPrograms/MaiML-HANDSON/blob/main/SRC/MaiMLViewerLocalRun/windowsSetup.md)）
3. 入力データを作成
   - **DATAFILES**フォルダに入力データファイルをおく
4. 各プログラムを実行
   - エクセルデータからMaiMLのデータ層を生成： <br/>
        **Excel2MaiMLData.bat**ファイルをダブルクリック
   - MaiMLファイルから指定したキーのデータをエクセル出力： <br/>
        **MaiML2Excel.bat**ファイルをダブルクリック
   - エクセルデータからMaiMLのプロトコル層を生成： <br/>
        **Excel2MaiMLProtocol.bat**ファイルをダブルクリック
   - MaiMLファイルの可視化ツール（MaiMLViewer）： <br/>
        **viewerRun.bat**ファイルをダブルクリック  <br/>
        WEBブラウザを開き "http://localhost:3000" にアクセス  <br/>
        

<br/>

## [Mac PCで実行]
1. ターミナルを起動
2. **ForMacUser**ディレクトリに移動
3. macSetup.shの実行権限を与える
   ```sh
    > chmod +x macSetup.sh
   ```
4. macSetup.shを実行
   ```sh
    > ./macSetup.sh
   ```
5. MaiMLViewerの実行環境をセットアップする
   - [MaiMLViewerのREADME](https://x.gd/z6Eup) を参考に環境を構築する
6. 入力データを作成
   - **DATAFILES**ディレクトリに入力ファイルをおく
6. 各プログラムを実行
   - エクセルデータからMaiMLのデータ層を生成：
      ```sh
       > ./Excel2MaiMLData.sh
      ```
   - MaiMLファイルから指定したキーのデータをエクセル出力：
      ```sh
       > ./MaiML2Excel.sh
      ```
   - エクセルデータからMaiMLのプロトコル層を生成：
      ```sh
       > ./Excel2MaiMLProtocol.sh
      ```
   - MaiMLファイルの可視化ツール（MaiMLViewer）：
      - "/MaiML-HANDSON/MaiMLViewerLocalRun/xmail-viewer/"ディレクトリに移動
      - 下記コマンドでneo4jとアプリを立ち上げる
      ```sh
       > neo4j console　もしくは、　> neo4j start
       > node ./bin/www
      ```
      - WEBブラウザを開き "http://localhost:3000" にアクセス
