HULFT Squareを使ってみよう！基本手順・機能について

インテグレーションサービス[HULFT Square](https://www.hulft.com/service/hulft-square) を使い始めたときの、基本的な手順や機能についてご紹介します。
[公式ドキュメント](https://www.hulft.com/help/ja-jp/HULFTSquare/Content/Home_Top.htm)にも詳細は載っていますが、全部の項目について掲載されているのでその中からかいつまんでお話していきます。詳しく知りたい！という内容はぜひドキュメントを参照ください。

# ユーザー登録
管理者からアカウントを発行してもらいます。メールアドレスがあればユーザー招待ができ、招待されるとユーザー登録用のリンクがメールで送られてきます。
ユーザー登録が完了すると、ログイン情報がメールで届きます。それらの情報を使って、次回からはHULFT Squareにログインできます。

# ログイン
メールで送られてきたログインページにアクセスし、ユーザーIDとパスワードを使ってログインします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/a43f787a-d48c-3158-7578-5e45d6540aad.png)

### ログアウト
ログイン後、画面右上の名前アイコンから「ログアウト」を選択できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/be3f3bef-962e-899a-9c2a-8875c4b2e822.png)

# 言語切り替え
HULFT Squareでは、表示言語を英語と日本語から選択できます。
設定にはまず右上の名前アイコンから「個人設定」を開きます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/37bd94ef-321c-227c-ccd7-fb9ab1d097af.png)

マイプロファイルで言語の確認ができます。変更する場合は、画面右の「編集」を押下します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/7e57bd41-df7b-0b36-077c-b51c55d21409.png)

言語の切り替えが行えます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/54813b8a-e2dd-8192-27c0-4ae57b53d4bc.png)

# サービス
サービスは、データ連携プロセスの実行エンジンです。
DataSpiderのサーバーに該当します。デザイナで作成した処理を指定したサービスで実行します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/f5a06150-e24d-88f6-a883-dadfe4348a2f.png)

# プロファイル
プロファイルは、コネクションや変数、カレンダーのリソースの切り替えを行うために使用します。
DataSpiderの種別に該当します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/59296639-22ae-b5c0-e558-1487ec7af3b5.png)

# コネクション
コネクションでは、HULFT Squareから接続する外部のサービスへの接続設定をします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/263cc370-fa27-7a90-338b-239afa411ccf.png)

新規作成から進み、利用するコネクターと種類を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/4957ceaf-0668-0931-75af-5412ba8af0ad.png)

コネクションの名前と利用ワークスペースを設定します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/89087d88-03f4-1d4e-6adc-75b66be4c49a.png)

接続設定をします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/8e668bf2-5df3-b2d2-e58f-91ba8589230e.png)


プロファイルの設定をします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/4c1b51d5-c82c-d561-68c9-0bccc34b3cd4.png)

以上でコネクションを作ることができます。

# プロジェクト
データインテグレーションのプロジェクトを作成します。

作成するワークスペースに移動し、プロジェクトを作成します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/2d066829-9219-954a-27ef-cc2229f1ddb9.png)

「プロジェクトを作成」からプロジェクトを新規作成できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/7517b6b5-e623-f182-0372-dd747f562f6f.png)

## スクリプト作成
プロジェクトを新規作成すると、編集のためプロジェクトを開く画面が表示されます。
この画面でスクリプトにて利用するプロファイルとIntegrateサービスを指定します。

:::note info
作成したコネクションに割り当てていないプロファイルを選択すると、作成したコネクションがスクリプト内で選択できないため、注意してください。
:::

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/4cf3b093-885c-17bd-bd85-9655864ca2a5.png)

スクリプトを作成するため、デザイナーを起動します。初回起動時には「HULFT Square Designer」のインストールが必要なので、画面のリンクからインストールを実施してください。

デザイナーが開かれます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/fe2625db-f844-23c3-b615-b9fccbc142e3.png)

プロジェクト作成時に「スクリプトを作成」にチェックを入れると、初回からスクリプトができている状態になります。今回はチェックを入れていないため、手作業でスクリプトを作成します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/f99e7fcc-7011-58ec-ee13-bfb6adb542d6.png)

あとは右側のツールパレットから処理のアイコンを選択し、データ連携のスクリプトを作成していきます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/afb7db20-b128-3688-f369-16c70b00b124.png)

処理アイコンの設定にある「接続先」で、事前に作成したコネクションを選択します。
プロジェクトを開く際に指定したプロファイルに含まれるコネクションが、一覧で表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/0a923970-d8fc-87f9-375f-755f33ff6858.png)

## ログの確認

HULFT Squareはデザイナー画面でもスクリプトを実行できます。実行ログはデザイナーの中央下に表示されますが、詳細を知りたい場合は、HULFT Squareのログ一覧から確認できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/102528/4711656d-2ca3-cd76-6383-f3a5a005cd0f.png)

他にもHULFT Squareには便利な機能がたくさん搭載しています。
公式ドキュメントも併せてご確認ください。

https://www.hulft.com/help/ja-jp/HULFTSquare/Content/Home_Top.htm