RunMyProcess からConnect Server 経由でHubDB データと連携

こんにちは！テクニカルディレクターの桑島です。

Akorbi Digital RunMyProcess を使えば、予算申請や契約管理など複雑なビジネスプロセスをノーコードでアプリ化できます。CData Connect Server はHubDB の仮想データベースを作成して、HubDB のOData API（RunMyProcess でネイティブに使用可能）を生成するために使用します。RunMyProcess をCData Connect Server と連携することで、対応するすべてのSaaS、Big Data、およびNoSQL ソースへ接続でき、HubDB データに素早くアクセスできます。

この記事では、二つのステップでHubDB データへの接続方法を説明します。

1. Connect Server からHubDB への接続
2. RunMyProcess からConnect Server に接続してHubDB データを取得

Connect Server を構成してHubDB に接続

RunMyProcess からHubDB に接続するには、Connect Server インスタンス内でHubDB への接続を設定します。

Connect Server ユーザーの追加

RunMyProcess からHubDB に接続するConnect Server のユーザーを作成します。

1. 「Users」->「 Add」の順にクリックします。
2. ユーザーを設定します。
3. 「Save Changes」をクリックして新しいユーザーのAuthtoken をメモします。

Connect Server からHubDB に接続

CData Connect Server は、簡単なポイントアンドクリックインターフェースを使用してAPI を生成します。

1. Connect Server を開き、「Databases」をクリックします。
2. 「Available Data Sources」から「HubDB」を選択します。
3. 必要な認証プロパティを入力し、HubDB に接続します。
   
   

   HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。

   カスタムOAuthアプリを使用する

   すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを確認してください。

   アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。

   1. HubSpotアプリ開発者アカウントにログインします。
      • アプリ開発者アカウントである必要があります。標準のHubSpotアカウントではパブリックアプリを作成できません。
   2. 開発者アカウントのホームページで、アプリタブをクリックします。
   3. アプリを作成をクリックします。
   4. アプリ情報タブで、ユーザーが接続する際に表示される値を入力し、必要に応じて変更します。これらの値には、パブリックアプリケーション名、アプリケーションロゴ、アプリケーションの説明が含まれます。
   5. 認証タブで、「リダイレクトURL」ボックスにコールバックURLを入力します。
      • デスクトップアプリケーションを作成する場合は、http://localhost:33333のようなローカルにアクセス可能なURLに設定します。
      • Webアプリケーションを作成する場合は、ユーザーがアプリケーションを承認した際にリダイレクトされる信頼できるURLに設定します。
   6. アプリを作成をクリックします。HubSpotがアプリケーションとそれに関連する認証情報を生成します。
   7. 認証タブで、クライアントIDとクライアントシークレットを確認します。これらは後でドライバーを設定する際に使用します。

   8. スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。

      テーブルにアクセスするには、最低限以下のスコープが必要です：

      • hubdb
      • oauth
      • crm.objects.owners.read
   9. 変更を保存をクリックします。
   10. 統合に必要な機能にアクセスできる本番ポータルにアプリケーションをインストールします。
       • 「インストールURL（OAuth）」の下で、完全なURLをコピーをクリックして、アプリケーションのインストールURLをコピーします。
       • コピーしたリンクをブラウザで開きます。アプリケーションをインストールする標準アカウントを選択します。
       • アプリを接続をクリックします。結果のタブは閉じて構いません。

   プライベートアプリを使用する

   HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。

   以下の手順に従ってプライベートアプリケーショントークンを生成できます：

   1. HubDBアカウントで、メインナビゲーションバーの設定アイコン（歯車）をクリックします。
   2. 左サイドバーメニューで、統合 > プライベートアプリに移動します。
   3. プライベートアプリを作成をクリックします。
   4. 基本情報タブで、アプリケーションの詳細（名前、ロゴ、説明）を設定します。
   5. スコープタブで、プライベートアプリケーションがアクセスできるようにしたい各スコープに対して読み取りまたは書き込みを選択します。
   6. テーブルにアクセスするには、最低限hubdbとcrm.objects.owners.readが必要です。
   7. アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
   8. アプリケーションのアクセストークンに関する情報を確認し、作成を続行をクリックし、その後トークンを表示をクリックします。
   9. コピーをクリックして、プライベートアプリケーショントークンをコピーします。

   接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。

4. 「 Test Database」をクリックします。
5. 「Permission」->「 Add」の順にクリックし、適切な権限を持つ新しいユーザー（または既存のユーザー）を追加します。

Connect Server にHubDB OData エンドポイントを追加

HubDB に接続したら、使用するテーブルのOData エンドポイントを作成します。

1. 「OData」->「Tables」->「Add Tables」の順にクリックします。
2. HubDB データベースを選択します。
3. 使用するテーブルを選択し、「Next」をクリックします。
4. （オプション）リソースを編集して特定のフィールドなどを選択します。
5. 設定を保存します。

（オプション）Cross-Origin Resource Sharing (CORS) を構成

Ajax などのアプリケーションから複数のドメインにアクセスして接続すると、クロスサイトスクリプティングの制限に違反する恐れがあります。その場合には、［OData］->［Settings］でCORS 設定を構成します。

• Enable cross-origin resource sharing (CORS):ON
• Allow all domains without '*':ON
• Access-Control-Allow-Methods:GET, PUT, POST, OPTIONS
• Access-Control-Allow-Headers:Authorization

設定への変更を保存します。

RunMyProcess DigitalSuite Studio からHubDB データにアクセス

HubDB への接続とOData エンドポイントがあれば、RunMyProcess からHubDB データにアクセスできます。

Provider の作成

1. RunMyProcess にログインして、「DigitalSuite Studio」を開きます。
2. 「Resources」をクリックしてリソースページを表示したら、「CONNECTORS」タブを選択すると次のような画面が表示されます。
3. 「＋」（New Provider）ボタンをクリックすると新規プロバイダー作成用の画面が表示されるので、リソースを使用するプロジェクトを選択して、「Confirm」ボタンをクリックします。
4. プロバイダーの設定画面が表示されるので、次の情報を入力します。
   • URL：CData Connect の「Endpoints」ページにある、次のOData エンドポイントを指定します。https://www.cdatacloud.net/myconnectinstance/api.rsc/
   • Authentication Schema：「Login/Password」を指定します。
   • Login：設定したConnect Server のユーザー名を指定します。
   • Password：上記のユーザー用のAuthtoken に設定します。
5. 「ACCEPTANCE」、「TEST」タブにも同じ情報を入力します。Note：その際、右上の「Copy this configuration」ボタンをクリックすることで設定をコピーでき、コピー先のタブで「Paste previously copied configuration」ボタンをクリックすることで既存の設定を反映できます。
6. 完了したら、「Save」をクリックして保存します。

Connector を作成してHubDB データを取得

1. 次に「CONNECTORS」タブから、作成したプロバイダーの右端のボタンをクリックして、メニューから「Add connector」を選択します。
2. 次のような画面が表示されるので、「Connector URL」にConnect Server で設定したテーブルのOData エンドポイントを指定します。例：odataendpoint/
3. 入力したら右上の「Save」ボタンをクリックしたあと、「Launch」ボタンをクリックしてコネクタのテスト実行用の画面を開き、右上の「Launch test」ボタンをクリックして実行します。次のように、指定したテーブルの情報がJSON で返ってくれば成功です。

詳細と無料トライアル

これで、RunMyProcess からHubDB データに接続できました。HubDB や、その他240以上のデータソースのOData フィードを作成する方法は、Connect Server ページ を参照してください。無料トライアルにサインアップして、RunMyProcess からHubDB データに連携してアプリを作成しましょう。