Appsmith で Aha! 連携アプリケーションを作成

Cameron Leblanc
Cameron Leblanc
Senior Technology Evangelist
Appsmith でCData Connect AI を介して Aha! のデータ に接続し、Aha! のデータ にリアルタイムでアクセスできるカスタムビジネスアプリケーションを作成。

Appsmith は、チームがビジネスオペレーションを改善するためのUI を素早く簡単に構築できる、オープンソースの内部ツールビルダーです。CData Connect AI と組み合わせることで、ビジネスアプリケーションから Aha! のデータ に即座にアクセスできるようになります。この記事では、Connect AI を使用して Aha! に接続し、Appsmith で Aha! のデータ から基本的なアプリケーションを作成するプロセスを説明します。

CData Connect AI は、Aha! を含む数百のデータソースをSQL Server 互換エンドポイントとして公開するクラウドサービスです。Appsmith からは通常のSQL Server と同じ手順で接続でき、レプリケーション不要でライブのAha! のデータを利用できます。

Appsmith 用に Aha! への接続を構成

Appsmith から Aha! への接続は、CData Connect AI を介して行います。Appsmith から Aha! のデータ を操作するには、まず Aha! 接続を作成して構成します。

  1. Connect AI にログインし、Sources をクリックして、 Add Connection をクリックします
    2. 接続の追加
  2. Add Connection パネルから「Aha!」を選択します
    3. データソースの選択
  3. Aha! に接続するために必要な認証プロパティを入力します。

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

    Aha! API プロファイル設定

    Aha! API はOAuth ベースの認証を使用します。

    まず、Aha! でOAuth アプリを登録する必要があります。これはAha! アカウントの「Settings」>「Personal」>「Developer」>「OAuth Applications」から行えます。また、Aha アカウントのドメイン名をDomain に設定します。例えば、Aha アカウントがacmeinc.aha.io の場合、Domain は「acmeinc」となります。

    以下の項目を接続文字列に設定すると、接続できるようになります。

    • AuthScheme：OAuth に設定します。
    • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、OAuthAccessToken を取得するプロセスを管理できます。
    • OAuthClientId：アプリ設定で指定されたclient_id に設定します。
    • OAuthClientSecret：アプリ設定で指定されたclient_secret に設定します。
    • CallbackURL：アプリ設定で指定したRedirect URI に設定します。
    • Domain：ProfileSettings でAha ドメインに設定します。
    接続の構成（Salesforce を表示）
  4. Save & Test をクリックします
  5. Add Aha! Connection ページのPermissions タブに移動し、User-based permissions を更新します。 権限の更新

パーソナルアクセストークンの追加

REST API、OData API、またはVirtual SQL Server を介してConnect AI に接続する場合、パーソナルアクセストークン（PAT）を使用してConnect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。

  1. Connect AI アプリの右上にある歯車アイコン（）をクリックして、設定ページを開きます。
  2. 設定ページで、Access Tokens セクションに移動し、 Create PAT をクリックします。
  3. PAT に名前を付けて、Create をクリックします。 新しいPAT の作成
  4. パーソナルアクセストークンは作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。

接続が構成され、PAT が生成されたので、Appsmith から Aha! のデータ に接続する準備が整いました。

ライブ Aha! のデータ からAppsmith アプリケーションを作成

Appsmith からCData Connect AI Virtual SQL Server への接続を確立するには、以下の手順に従います。

Appsmith で Aha! に接続

  1. Appsmith インスタンスにログインし、新しいアプリケーションを作成します。
  2. 新しいアプリケーションで、Data ページを開き、Bring your data を選択します。 Data ページを開く
  3. このページで、Microsoft SQL Server を検索し、データソースとして選択します。 Microsoft SQL Server データソースの選択
  4. 新しいデータソースの名前を入力し、以下の接続設定を入力します。
    • Host address: tds.cdata.com
    • Port: 14333
    • Database name: 接続するCData Connect AI データソースの接続名を入力します（例：API1）。
    • Username: CData Connect AI のユーザー名を入力します。これはCData Connect AI インターフェースの右上に表示されます。例：[email protected]。
    • Password: 先ほど生成したPAT を入力します。
      • Connect AI Virtual SQL Server への接続を構成（Salesforce を表示）
  5. Test configuration をクリックして接続が成功したことを確認し、Save をクリックしてデータソースを保存します。

新しいクエリを作成

データソースへの接続を構成したら、SQL クエリを追加してデータソースから実際にデータを取得します。

  1. 新しいデータソースの画面で、New Query をクリックします。 新しいクエリの作成
  2. クエリエディタが開き、データを選択するSQL クエリを入力できます。SQL クエリの指定については、CData Connect AI のExplorer を使用して、SQL クエリと取得するデータをプレビューできます。 Explorer でクエリをプレビュー
  3. SQL クエリを作成したら、Appsmith のクエリエディタに戻り、SQL クエリを入力してRun をクリックします。 SQL クエリの実行
  4. クエリが正常に実行されたら、あとは取得したデータを表示するためのページをセットアップするだけです。

Aha! のデータ を表示

  1. UI タブを開き、New UI element をクリックします。 新しいUI 要素
  2. 新しいUI 要素を選択し、ページ上にドラッグアンドドロップします。 新しいUI 要素
  3. 新しいUI 要素でConnect data をクリックし、先ほど作成したクエリを選択します。 データに接続
  4. データが接続されると、UI 要素にデータが表示されます。 UI 要素に接続完了

アプリケーションをデプロイ

Aha! のデータ がアプリケーションのUI 要素に接続されたら、アプリケーションをデプロイできます。Appsmith の右上にあるDeploy をクリックすると、Aha! のデータ を表示するアプリケーションが別ウィンドウで開きます。

アプリケーションのデプロイ完了

CData Connect AI の入手

クラウドアプリケーションから数百種類のSaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、CData Connect AI をお試しください。

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

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル

この記事の内容

関連記事