はじめに

こんにちは。すぎもんです。

今回は 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記事や接続検証等、皆さんの参考になるような記事を投稿していきたいと思います！
ここまで読んでいただきありがとうございました。それでは、また！