はじめに
こんにちは。すぎもんです。
今回は SAP S/4HANA Cloud にRESTコネクターで接続した際の記事になります。
HULFT Square について紹介している公式サイトもあわせてご覧ください。
今回やること
HULFT Square でRESTコネクターを使い、SAP S/4HANA CloudにOData経由で GET を実施しCSVファイルの出力までを行っていきます。
POINT
RESTコネクターは SAP S/4HANA Cloud 専用のコネクターではないため、スキーマの設定を手動で行う必要があります。そのため、今回はXMLファイルを読み込ませることでスキーマ設定を行っていきます。
本記事では、あえて専用コネクタがあるにもかかわらずRESTコネクタを使ってみて、その違いも整理していこうと思います。ぜひ先日検証した専用コネクターの記事も併せてご覧ください。
実施手順
以下の流れで SAP S/4HANA Cloud との接続を行っていきます。
- ① 事前準備
- 1. コネクションの作成
- 2. XMLファイルの出力
- ② 処理の実行
- 1. スクリプトの作成
- 2. 実行・確認
それでは早速やってみましょう！
① 事前準備
事前準備 は、下記の手順で行います。
- コネクションの作成
- XMLファイルの出力
1. コネクションの作成
まず始めに SAP S/4HANA Cloud に接続するためのコネクションを作成します。
[HULFT Integrate] > [コネクション] からRESTコネクターのコネクションリソースの作成を行っていきます。
POINT
[URL] には接続先サービスURLのホスト名までを入力します。
2. XMLファイルの出力
スキーマを定義する際に使用するためのXMLファイルの作成を行っていきます。
デザイナを開き、ツールパレットの [ネットワーク] > [REST] から 「GET実行」処理 を配置します。
[接続先] には先ほど作成したコネクションリソースを指定し、[パス] には [接続先] の [URL] に入力したURLからの相対パスを指定します。
POINT
認証方式は、以下から選択が可能です。
- なし
- ベーシック認証
- ダイジェスト認証
- NTLM認証
- Authコネクション利用
ツールパレットの [ファイル] > [XML] から 「XMLファイル書き込み」処理 を配置します。
「XMLファイル書き込み」処理 は以下のように設定します。
フローを引けばスクリプトは完成です。
続いて作成したスクリプトを実行してみます。
「スクリプトの実行」ダイアログから、処理が正常に成功したことが確認できます。
POINT
ストレージに ファイル（TEST.xml） が出力されているのが確認できます。
※ TEST.xml
② 処理の実行
処理の実行 は、下記の手順で行います。
- スクリプトの作成
- 実行・確認
1. スクリプトの作成
GETで取得したSAPのデータをCSVファイルに書き込むためのスクリプトを作成していきます。
REST コネクターの 「GET実行」処理 を配置し、先ほどのスクリプトと同じように設定します。
ツールパレットの [ファイル] > [CSV] から 「CSVファイル書き込み」処理 を配置します。
「CSVファイル書き込み」処理 は以下のように設定します。
「GET実行」処理 から 「CSVファイル書き込み」処理 までフローを引きます。
POINT
フローを引く際に、マッピングを追加しておきます。
Mapperを開いてコンポーネントアイコンを右クリックし、[コンポーネント/ファイルからスキーマを読み込む] を選択します。
[XMLファイルから読み込み] で先ほど作成した XMLファイル（TEST.xml） を選択します。
これでスキーマの設定は完了です。
マッピングキャンバスは、以下のように設定します。
| 番号 | ロジック名 | 説明 |
|---|---|---|
| (1) | 条件による抽出 | 条件にマッチしたもののみ繰り返して出力します。 |
| (2) | 始まりが同じ | 入力文字列が指定文字列で始まるかどうか判定します。 |
| (3) | And演算 | 2つの入力真偽値の論理積(AND条件)を返します。 |
| (4) | 単一行文字列定数 | 単一行の文字列定数を出力します。 |
| (5) | 同じ | 2つの入力文字列が等しいかどうか判定します。 |
これでスクリプトは完成です。
2. 実行・確認
[実行] ボタンを押下し、スクリプトを実施していきます。
「スクリプトの実行」ダイアログから、処理が正常に成功したことが確認できます。
ストレージに ファイル（demo.csv） が出力されているのが確認できます。
最後にファイルの中身を確認します。
最後に
今回は SAP S/4HANA Cloud にRESTコネクターで接続してみましたが、いかがでしたでしょうか。
RESTコネクターは手動でスキーマを定義しなければならず手間がかかったのに対して、専用コネクターはスキーマが自動で取得される為、とても簡単に設定ができました。皆さんも是非色々と試してみてください！
このブログでは、今後も様々なTopics記事や接続検証等、皆さんの参考になるような記事を投稿していきたいと思います！
ここまで読んでいただきありがとうございました。それでは、また！