RunMyProcess からConnect Server 経由でWave Financial のデータと連携

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

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

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

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

Connect Server を構成してWave Financial に接続

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

Connect Server ユーザーの追加

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

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

Connect Server からWave Financial に接続

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

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

   Wave Financial 接続プロパティの取得・設定方法

   Wave Financial は、データに接続する手段として、API トークンを指定する方法とOAuth 認証情報を使用する方法の2つを提供しています。

   API トークン

   Wave Financial API トークンを取得するには：
   1. Wave Financial アカウントにログインします。
   2. 左ペインのManage Applications に移動します。
   3. トークンを作成するアプリケーションを選択します。最初にアプリケーションを作成する必要がある場合があります。
   4. API トークンを生成するには、Create token をクリックします。

   OAuth

   Wave Financial はOAuth 認証のみサポートします。すべてのOAuth フローで、この認証を有効にするにはAuthScheme をOAuth に設定する必要があります。

   ヘルプドキュメントでは、以下の3つの一般的な認証フローでのWave Financial への認証について詳しく説明しています。

   • デスクトップ：ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。組み込みOAuth またはカスタムOAuth で認証されます。
   • Web：共有ウェブサイト経由でデータにアクセスします。カスタムOAuth でのみ認証されます。
   • ヘッドレスサーバー：他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。組み込みOAuth またはカスタムOAuth で認証されます。

   カスタムOAuth アプリケーションの作成についての情報と、組み込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、ヘルプドキュメント の「カスタムOAuth アプリケーションの作成」セクションを参照してください。

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

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

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

1. 「OData」->「Tables」->「Add Tables」の順にクリックします。
2. Wave Financial のデータベースを選択します。
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 からWave Financial のデータにアクセス

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

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 を作成してWave Financial のデータを取得

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

詳細と無料トライアル

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