RunMyProcess DSEC を使用して DigitalSuite Studio で Respond.io のデータ に接続

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Arkobi Digital のローコードクラウドネイティブプラットフォーム RunMyProcess の DigitalSuite EnterpriseConnect（DSEC）を使用して Respond.io に接続します。

CData JDBC Driver for Respond.io は JDBC 標準を実装しており、BI からIDE まで幅広いアプリケーションから Respond.io への接続を可能にします。この記事では、Arkobi Digital RunMyProcess の DSEC から Respond.io のデータ に接続し、RunMyProcess で Respond.io に接続する方法を説明します。

EnterpriseConnect Agent のセットアップ

RunMyProcess ドキュメントの EnterpriseConnect ページに従って、EnterpriseConnect Agent を設定します。

JDBC Adapter のセットアップ

JDBC Adapter のセクションでは、JDBC を使用して RDBMS に接続する手順が説明されています。手順に従って JDBC.config ファイルを開きます。

  1. CData JDBC Driver for Respond.io 用の JSON エントリを作成します。例： 
    API = {
  "sqlDriver" : "...",
  "sqlSource" : "...",
  "sqlDriverPath" : "..."
}
  2. "sqlDriver" フィールドに CData JDBC Driver のクラス名を設定します。例：
    cdata.jdbc.api.APIDriver
  3. "sqlSource" フィールドに Respond.io に接続するための JDBC URL を設定します。例：
    jdbc:api:Profile=C:\profiles\Respondio.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key';

    組み込みの接続文字列デザイナー

    JDBC URL の作成には、Respond.io JDBC Driver に組み込まれている接続文字列デザイナーをご利用ください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

    
java -jar cdata.jdbc.api.jar

    接続プロパティを入力し、接続文字列をクリップボードにコピーします。

    まず、Profile 接続プロパティをディスク上の Respondio プロファイルの場所に設定します（例：C:\profiles\Respondio.apip）。次に、ProfileSettings 接続プロパティを Respondio の接続文字列に設定します（以下を参照）。

    Respondio API プロファイル設定

    Respond.io では API キー認証を使用します。API キーは以下の手順で取得できます。

    1. Respond.io アカウントにログインします。
    2. ワークスペースの「Settings」に移動します。
    3. 「Integrations」セクションで「Developer」を選択します。
    4. ページに表示されている API キーをコピーします。

    API キーを取得したら、以下の接続プロパティを設定します。

    • AuthScheme：APIKey に設定します。

    ProfileSettings 接続プロパティには、以下を設定します。

    • APIKey：Respond.io の API キーに設定します。
    組み込みの接続文字列デザイナーを使用して JDBC URL を生成（Salesforce の例）
  4. "sqlDriverPath" フィールドに CData JDBC Driver JAR ファイルの名前を設定します。例：
    cdata.jdbc.api.jar

JDBC.config ファイルの例


#DBAgent Configuration
API = {"sqlDriver" : "cdata.jdbc.api.APIDriver", "sqlSource" = "jdbc:api:Profile=C:\profiles\Respondio.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key';","sqlDriverPath" = "cdata.jdbc.api.jar" }

JDBC ドライバー JAR ファイル（cdata.jdbc.api.jar）を unified-adapter-[version].jar と同じディレクトリに配置します。

runmyprocess

注意：CData ライセンスファイル（cdata.jdbc.api.lic）も同じディレクトリに配置してください。ライセンスは製品がインストールされているマシンの一意の識別子に基づいて生成されるため、ファイルを別のマシンに配置する場合はオフラインアクティベーションが必要になります。

DigitalSuite EnterpriseConnect Agent の起動

Windows では、Windows サービスから RunMyProcess DigitalSuite EnterpriseConnect Agent を起動します。コマンドラインでアプリケーションを起動する場合は、RunMyProcess ドキュメントの Starting the EnterpriseConnect Agent を参照してください。

JDBC Adapter の起動

runAdapter.bat から JDBC Adapter を起動します。Adapter が起動したら、エージェントアドレス（例：127.0.0.1:8080）を通じてアプリケーションにアクセスできます。以下は Windows でコマンドを実行した例です。


... > java -Djava.util.logging.config.file=./log.properties -cp lib/* org.runmyprocess.sec2.AdapterHandler :
2021-06-09 14:37:58|INFO|correlationId=|Searching for config file...
2021-06-09 14:37:58|INFO|correlationId=|Adapter Handler started with [JDBC] configuration
2021-06-09 14:37:59|INFO|correlationId=|agent address: 127.0.0.1:8080
2021-06-09 14:38:00.251:INFO::ConnectionThread: Logging initialized @1820ms to org.eclipse.jetty.util.log.StdErrLog
2021-06-09 14:38:00|INFO|correlationId=|onConnect() websocket connection between Agent and Adapter established

DigitalSuite EnterpriseConnect Agent と JDBC Adapter が起動したら、ブラウザで http://localhost:(指定したポート番号)/ にアクセスして、以下のページを開きます。

runmyprocess

Postman や cURL などのツールを使用して JDBC Adapter の接続確認を行います。ここでは Postman を使用して HTTP POST リクエストを送信します。

RequestHeader を以下のように設定します：


Content-Type application/json

RequestBody を以下のように設定します：


{
	"protocol":"JDBC",
	"data":{
		"DBType":"API",
		"sqlUsername":"",
		"sqlPassword":"",
		"sqlStatement":"SELECT * FROM Contacts"
	}
}

JDBC.config ファイルに認証情報が含まれている場合、sqlUsername と sqlPassword は空のままにできます。テーブル名が不明な場合は、SELECT * FROM sys_tables リクエストを使用してテーブルの一覧を取得できます。

ステータスが 200 で、ボディに JSON 形式の Respond.io のデータ データが含まれていれば、リクエストは成功です。

runmyprocess

DigitalSuite Studio で DSEC Agent を介して Respond.io に接続

DigitalSuite Studio プロジェクトを作成し、プロジェクト内に Provider を作成します。

  • URL：JDBC Agent にアクセスするための URL（例：http:localhost:8080/）
  • Authentication Scheme：Login/password
  • Login：application.properties ファイルの agent.user の値
  • Password：application.properties ファイルの agent.password の値
  • Secured：チェックを入れる
  • Use DigitalSuite EnterpriseConnect：チェックを入れる
  • With domain：application.properties ファイルの agent.domain の値
runmyprocess

次に、Provider 内に Connector を作成します。

  • Connector URL：空のままにする
  • Architecture：REST/XML-RPC
  • Method：POST
  • Result format：JSON
  • Accept media type：application/json
  • Character set：Automatic
  • Content：JDBC Adapter で使用した Request body と同じ内容
  • Content type: application/json
runmyprocess

JDBC Adapter で Request body として使用した JSON データ：


{
	"protocol":"JDBC",
	"data":{
		"DBType":"API",
		"sqlUsername":"",
		"sqlPassword":"",
		"sqlStatement":"SELECT * FROM Contacts"
	}
}

Launch Test を開いてテストを実行します。右側のペインの Result に Respond.io のデータ データが表示されれば、テストは成功です。

runmyprocess

これで、DSEC を介して RunMyProcess DigitalSuite Studio で Respond.io のデータ を使用できるようになりました。

サポートされる SQL コマンドの詳細については、ヘルプドキュメントの「SQL Compliance」セクションを参照してください。テーブルの詳細については、「Data Model」セクションを参照してください。

はじめる準備はできましたか？

API Driver で Respond.io のライブデータに接続

Respond.io に接続

この記事の内容

関連記事