HDC-EDI Apex をインストールしてみた【HDC-EDI Apex初期設定編】（3/3）

#はじめに
こんにちは、よろず相談担当 **すぎもん:yum:** です。HDC-EDI Suite の最新版 **HDC-EDI Suite for Apex** がリリースされたので、評価版をインストールしてみました。

#今回やってみたこと
Windows環境に評価版をインストールしてみました。
HDC-EDI Suite for Apexは、HDC-EDI Apex と HULFTの2製品で構成されるので、それぞれインストールする必要がありますが、この記事では HDC-EDI Apex のインストールと初期設定にフォーカスしています。従来製品のHDC-EDI Baseは、インストールに手間がかかりなかなか手ごわかったので、新製品であるHDC-EDI Apexはどんな感じか、どのあたりがハマりやすいか、などご紹介します。

**この記事は3部構成の3/3で、HDC-EDI Apexの初期設定方法が中心になります。**

#３．HDC-EDI Apexの初期設定
###3.1. ノード登録
初期状態ではノード名が未定義状態であるため、次ステップでノード指定ができません。（ノード登録がされていないと、例えばデータストア作成ができなかったりします。）
メニュー一覧の **マスター -> システム -> 構成** を見ると、HDC-EDI Apexを導入したサーバのコンピュータ名（=sedemo）が登録されているように見えますが、**未定義**となっています。
![node_before.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/677aed33-1b42-65ab-ea04-84e59ada935e.png)
メニュー一覧の **マスター -> システム -> ノード** を選択し、**新規作成** で作れます。
とりあえず、コンピュータ名と同じ**sedemo**で登録します。
![node_entry.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/0c5522a1-defd-7174-47a5-477b11d2b4e1.png)
もう一度 **マスター -> システム -> 構成** を見ると、**未定義**が無くなっています。これで、以降の設定でノード名（sedemo）を指定できるようになります。
![node_after.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/634d76a4-0d59-deff-3bc2-ab1c01ffa59a.png)

###3.2. データストア作成
データストアとは、HDC-EDI Apex内で処理するデータ（送受信データ、加工処理を行うデータなど）を格納する領域です。
データストアを新規作成するにあたって、指定先のディレクトリを予め作成しておきます。今回は、**C:\hdc_apex_demo01**というディレクトリを作成します。
![datastore1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/ae388ab6-a055-edbd-c3dc-653108d48825.png)
今回は、**demo01**という名前のデータストアを作成します。
メニュー一覧の **マスター -> システム -> データストア** を選択し、**新規作成** で作れます。

|設定項目|設定値|補足説明|
|:--|:--|:--|
|データストア名|demo01|今回はこの名前で作成|
|ノード名|sedemo|先ほど登録したノード名を指定|
|ディレクトリ|C:\hdc_apex_demo01|先ほど作成したディレクトリのパスを指定|
![datastore2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/edf2899a-a8a8-5cbc-c8c5-b5d107d12043.png)
データストアをもつノードに障害が発生すると、そのデータストアにアクセスする業務が全て停止する恐れがあります。そのため、データストアをもつノードは耐障害性を持たせておくことを強く推奨します。
![すぎもんポイント2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/4f7ed690-84eb-b6e1-73c7-899a98c42644.png)

###3.3. 業務グループ作成
業務グループとは、HDC-EDI Apexで業務別に運用権限を分けられるようにする仕組みで、必ず作成が必要になる定義です。例えば、購買業務をA業務グループ、販売業務をB業務グループとして分けて、特定の業務グループだけがアクセスできるリソースを設定したり、アクセス権限（参照、更新、削除など）をきめ細かく管理できるようにするイメージです。
今回は、**hdc**という名前の業務グループを作成します。
メニュー一覧の **マスター -> システム -> 業務グループ** を選択し、**新規作成** で作れます。
![gyo_group1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/1353778a-9308-d8ae-e686-9095d0276c86.png)

###3.4. オペレータ作成
オペレーターは、HDC-EDI Apexの操作・管理をするユーザー（≠通信ユーザー）にあたり、ここで紹介する**Web画面にログインするユーザー**（≠通信ユーザー）になります。くどいですが、通信ユーザー（＝通信先ホストの定義）とは別物なので間違わないようにしてください。
HDC-EDI Apexでは、ACMS B2Bよりもセキュリティ要件に柔軟に対応するために権限がきめ細かく設定できるようになっています。そのせいか、設定項目が多岐にわたりちょっと難しく感じます。今回は、細かい指定方法は割愛して、まずは動作させることを目標にゆるい設定（かなり強い権限）のオペレーターを作成します。実運用では、運用設計をしっかりやった上でオペレーターを作成してください。
今回の設定内容は下表のようにします。

|設定項目|設定値|補足説明|
|:--|:--|:--|
|オペレーターグループ|SYSTEM|デフォルトで用意されているものを使用|
|オペレーターID|hdcadmin|今回はこの名前でとりあえず作成|
|システム運用権限|アドミニストレーター|なんでもできる権限|
|業務グループ運用権限（hdc）|アドミニストレーター|なんでもできる権限|
![すぎもんポイント3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/ec3a28a6-d56a-2dcd-11b6-261ce060e79a.png)
まず、オペレーターグループ**SYSTEM**の業務グループ運用権限に業務グループ**hdc**を追加します。
メニュー一覧の **マスター -> システム -> オペレーターグループ** を選択し、**SYSTEM**オペレーターグループの詳細を開き編集します。今回は、業務グループ運用権限にとりあえず**アドミニストレーター**（何でもできる権限）を付与します。
![op_group.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/f011a424-8cd1-3eb6-3ef7-a0ad071ae16d.png)
次に、**hdcadmin**という名前のオペレーターを作成します。
メニュー一覧の **マスター -> システム -> オペレーター** を選択し、**新規作成** で作れます。
![op1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/95f9d62d-043e-7235-d199-46f39dbc9479.png)
業務グループ運用情報から**hdc**業務グループを選択し、業務グループ運用権限を**アドミニストレーター**に設定します。
![op2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/075ea006-ef61-9974-8463-356adf2fa7ea.png)
オペレーターを作成したら **アクション** ボタンから **仮パスワード** を行います。
![op3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/fea2034a-674c-028d-4ded-9f58a795c10e.png)
一旦ログアウトしてから、仮パスワードでログインすると**パスワード設定画面**が表示されますので、オペレーター**hdcadmin**のパスワードを設定します。
![op4.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/4ad130ae-3b99-7e1e-0d19-341158a60503.png)

###3.5. HULFT連携用の初期設定
####optionalprotocol.propertiesファイル名の変更
設定ファイルがWindows版とUNIX版の2種類用意されているので、今回はWindows版を利用するように設定します。設定するといっても、Windows版を有効にするためにファイル名を変更（"win_"を削除）するだけです。
変更前：C:\hdc_apex\bin\Common\\**win_**optionalprotocol.properties
![op_protocol_properties_before.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/c52bdb58-9cb9-bd36-00b3-69d319f40b13.png)
変更後：C:\hdc_apex\bin\Common\optionalprotocol.properties
![op_protocol_properties_after.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/0ae6dc01-d194-e4d2-3a77-4017f67393ff.png)

####hdc_apex.conf設定
HDC-EDI ApexからHULFT連携機能を実行する際に必要な情報を設定します。

|設定項目|説明|
|:--|:--|
|HULFT.HULEXEP|HULFT実行モジュール格納ディレクトリパス|
|HULFT.OPERATORID|HULFT連携機能を実行する際のオペレータID|
|HULFT.PASSWORD※|上記オペレータIDのパスワード|
※今回はオペレータIDとパスワードを設定ファイルに記述しましたが、秘匿情報を設定ファイルに記述するのはセキュリティ上好ましくありません。実運用では認証ファイル（.passwords）を利用した秘匿情報の暗号化を強くお勧めします。
![hdc_apex_conf_after.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/da54f0d4-fb27-81d2-ecc3-5539bf08707e.png)
![すぎもんポイント4.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/14b002f0-e6a4-2809-d2c3-bb0215f477b6.png)

---

以上で、HDC-EDI Apexのインストールと最低限の初期設定はできました。
通信設定方法については、別記事 [HDC-EDI Apex をさわってみた]
(https://qiita.com/sugimon/items/19fc81986becefcfc47c) でご紹介していますので、ぜひご覧ください。

---

:arrow_forward: [HDC-EDI Apex をインストールしてみた【Apexインストール編】（1/3）]
(https://qiita.com/sugimon/items/5662ae277f77310272be)
:arrow_forward: [HDC-EDI Apex をインストールしてみた【HULFT初期設定編】（2/3）](https://qiita.com/sugimon/items/359fba2dbd032e11566a)
:arrow_forward: HDC-EDI Apex をインストールしてみた【HDC-EDI Apex初期設定編】（3/3）

---