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

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

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

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

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

デプロイ

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

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

DB2 に接続

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

DB2 への接続には以下を入力します：

• Server: DB2 が稼働しているサーバー。
• Port: DB2 サーバーのポート。
• Database: DB2 のデータベース。
• User: DB にアクセスする権限のあるユーザー名。
• Password: DB にアクセスする権限のあるユーザーのパスワード。

対応するDB2 のドライバーをインストールする必要があります。

• Windows: IBM Data Server Provider for .NET

  Windows では、IBM Data Server Provider をインストールするだけで十分です。インストールがmachine.config への書き込みを行います。

• Java: IBM Data Server Driver for JDBC

  Java では、IBM Data Server Driver JAR をアプリケーションのwww\WEB-INF\lib\ フォルダに配置する必要があります。

パスワード方式によるSSH 接続

パスワード方式によるSSH接続時に必要なプロパティ一覧を以下に示します。

• User: DB2 のユーザ
• Password: DB2 のパスワード
• Database: DB2 の接続先データベース
• Server: DB2 のサーバー
• Port: DB2 のポート
• UserSSH: "true"
• SSHAuthMode: "Password"
• SSHPort: SSH のポート
• SSHServer: SSH サーバー
• SSHUser: SSH ユーザー
• SSHPassword: SSH パスワード

接続文字列形式では以下のようになります。

公開鍵認証方式方式によるSSH 接続

公開鍵認証によるSSH接続時に必要なプロパティ一覧を以下に示します。

• User: DB2 のユーザ
• Password: DB2 のパスワード
• Database: DB2 の接続先データベース
• Server: DB2 のサーバー
• Port: DB2 のポート
• UserSSH: "true"
• SSHAuthMode: "Public_Key"
• SSHClientCertType: キーストアの種類
• SSHPort: SSH のポート
• SSHServer: SSH サーバー
• SSHUser: SSH ユーザー
• SSHClientCert: 秘密鍵ファイルのパス

接続文字列形式では以下のようになります。

また、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

DB2 データをFlow に追加する

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

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 Orders］操作を選択します。

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

   ShipCity eq 'New York'

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

アクションをトリガー

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

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