Power Automate の自動タスクで CData API Server およびSAP HANA ADO.NET Provider を使う

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

Power Automate (Microsoft Flow) は、オンプレやクラウドの複数のシステムからのデータを含むタスクを自動化することができます。CData API Server およびSAP HANA ADO.NET Provider (または250+ の他のADO.NET Providers) を使用すると、基幹業務ユーザーはPower Automate のSAP HANA トリガーに基づく、アクションのネイティブな作成が可能になります。API Server は、Power Automate などのSaaS アプリケーションを、OData やSwagger などのデータアクセス標準を通じてSAP HANA とシームレスに統合できます。この記事では、Power Automate のウィザードとSAP HANA API Server を使い、検索条件に一致するエンティティであるトリガーを作成し、結果に基づいて電子メールを送信する方法を示します。

API サーバーをセットアップ

以下のステップに従って、安全でSwaggerに対応するSAP HANA API の作成を開始します。

デプロイ

API サーバーは独自のサーバーで実行されます。Windows では、スタンドアロンサーバーまたはIIS を使用して展開できます。Java サーブレットコンテナで、API Server WAR ファイルをドロップします。詳細とハウツーについては、ヘルプドキュメントを参照してください。

API Server は、Microsoft Azure、Amazon EC2、Heroku にも簡単にデプロイできます。

SAP HANA に接続

デプロイ後、API Server 管理コンソールで［Settings］->［Connections］とクリックし、認証値とその他の接続プロパティを指定します。 次に、［Settings］->［Resources］をクリックして、API サーバーへのアクセスを許可する エンティティを選択できます。

Server、Database、およびPort プロパティを設定して、対話するSAP Hana データベースのアドレスを指定します。User およびPassword プロパティを設定してサーバーへ認証します。

また、CORS を有効にし、［Settings］->［Server］ページで次のセクションを定義する必要があります。［*］なしですべてのドメインを許可するオプションを選択することもできます。

1. Access-Control-Allow-Origin:［*］の値に設定するか、接続を許可するドメインを指定します。
2. Access-Control-Allow-Methods:値を［GET,PUT,POST,OPTIONS］に設定します。
3. Access-Control-Allow-Headers:［x-ms-client-request-id, authorization, content-type］に設定します。

API サーバーユーザーを承認

作成するOData サービスを決定したら、［Settings］->［Users］をクリックしてユーザーを承認します。API サーバーは、認証トークンベースの認証を使用して主要な認証スキームをサポートします。SSL を使用して、接続を認証及び暗号化することができます。アクセスはIP アドレスによって制限することもできます。デフォルトでは、ローカルマシンのみに制限されています。

簡単にするために、API ユーザーの認証トークンをURL で渡すことができます。データディレクトリにあるsettings.cfg ファイルの［Application］セクションに設定を追加する必要があります。Windows でこれは、アプリケーションルートのapp_data サブフォルダにあたります。Java エディションでは、データディレクトリの場所はオペレーティングシステムによって異なります。

1. Windows:C:\ProgramData\CData
2. Unix or Mac OS X: ~/cdata

SAP HANA データをFlow に追加する

組み込みのHTTP + Swagger コネクタを使用し、ウィザードを使用してSAP HANA プロセスフローを設計できます。

1. ［Power Automate］で、［My Flows］->［Create from Blank］をクリックします。
2. ［Recurrence］アクションを選択し、電子メールを送信する時間間隔を選択します。この記事では、［1日］にします。
3. Swagger を検索してHTTP + Swagger アクションを追加します。
4. Swagger メタデータドキュメントのURL を入力します。 https://MySite:MyPort/api.rsc/@MyAuthtoken/$oas
5. ［Return Buckets］操作を選択します。

6. SAP HANA を取得するためのOData クエリを作成します。この記事では、$filter ボックスで次のOData フィルタ形式を定義します。

   Name eq 'TestBucket'

   サポートされているOData のフィルタリングと例の詳細については、API Server のヘルプドキュメントを参照してください。

アクションをトリガー

これで、プロセスフローでBuckets エンティティを操作できます。以下のステップに従って、自動メールを送信します。

1. E メール送信アクションであるSMTP を追加します。
2. SMTP サーバーのアドレスと資格情報を入力し、接続に名前を付けます。サーバーでサポートされている場合には、必ず暗号化を有効にしてください。
3. メッセージのヘッダーと本文を入力します。これらのボックスにSAP HANA カラムを追加できます。