UI/UX 特化ローコード開発ツール NEXACRO BEYOND を使ってCvent と連携したアプリを開発する方法

こんにちは！リードエンジニアの杉本です。

NEXACRO BEYOND は UI/UX に特化したローコード開発ツールおよびその実行基盤です。この記事では、CData Connect Server を経由して NEXACRO BEYOND からCvent に連携し、アプリを開発する方法を紹介します。

CData Connect Server は、Cvent のデータの仮想OData インターフェースを提供し、NEXACRO BEYOND からリアルタイムにCvent データへ連携することができます。

Connect Server を構成する

NEXACRO BEYOND でCvent のデータをリアルタイムで操作するには、Connect Server からCvent に接続し、コネクションにユーザーアクセスを提供してCvent のデータのOData エンドポイントを作成する必要があります。

Cvent の仮想OData API エンドポイントを作成

まずCData Connect Server でデータソースへの接続およびOData API エンドポイント作成を行います。

1. CData Connect Server にログインして、「DATA MODEL」をクリックします。
2. 利用できるデータソースアイコンから"Cvent" を選択します。
3. Cvent に接続するために必要なプロパティを入力します。

   Cvent への認証を行う前に、ワークスペースとOAuth アプリケーションを作成する必要があります。

   ワークスペースの作成

   ワークスペースを作成するには：

   1. Cvent にサインインし、App Switcher（ページ右上の青いボタン） -> Admin に移動します。
   2. Admin メニューから、Integrations -> REST API に移動します。
   3. Developer Management の新しいタブが立ち上がります。新しいタブでManage API Access をクリックします。
   4. Workspace を作成し、名前を付けます。開発者にアクセスさせたいスコープを選択します。スコープは、開発者がアクセスできるデータドメインを制御します。
      • All を選択すると、開発者は任意のスコープ、およびREST API にこれから追加されるスコープを選択できます。
      • Custom を選択すると、開発者がOAuth アプリで選択できるスコープを、選択したスコープに制限できます。本製品によって公開されるすべてのテーブルにアクセスするには、次のスコープを設定する必要があります。

        event/attendees:read	event/attendees:write	event/contacts:read
        event/contacts:write	event/custom-fields:read	event/custom-fields:write
        event/events:read	event/events:write	event/sessions:delete
        event/sessions:read	event/sessions:write	event/speakers:delete
        event/speakers:read	event/speakers:write	budget/budget-items:read
        budget/budget-items:write	exhibitor/exhibitors:read	exhibitor/exhibitors:write
        survey/surveys:read	survey/surveys:write

   OAuth アプリケーションの作成

   Workspace を設定して招待すると、開発者はサインアップしてカスタムOAuth アプリを作成できます。手順については、ヘルプドキュメントのカスタムOAuth アプリケーションの作成を参照してください。

   Cvent への接続

   OAuth アプリケーションを作成したら、次の接続プロパティを設定してCvent に接続します。

   • InitiateOAuth：GETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します。
   • OAuthClientId：OAuth アプリケーションに関連付けられたClient ID。これは、Cvent Developer Portal のApplications page ページにあります。
   • OAuthClientSecret：OAuth アプリケーションに関連付けられたClient secret。これは、Cvent Developer Portal のApplications page ページにあります。
   
4. 「Test Connection」をクリックします。
5. 「USERS」 -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。
6. API タブをクリックして OData API エンドポイントが生成されていることを確認します。

コネクションとOData エンドポイントを設定したら、NEXACRO BEYOND からCvent のデータに接続できます。

プロジェクトの作成

Web API の準備が整ったのでNEXACRO BEYOND によるアプリケーション開発を進めていきます。NEXACRO BEYOND のアプリケーションは NEXACRO Studio というツールを用いて開発します。

1. まず、NEXACRO Studio を立ち上げて新しいプロジェクトを作成しましょう。

2. 任意の名称でProject を作成します。

3. 作成するアプリケーションの種類は今回はDesktop としました。

4. Template から「Full」を選択して、「Finish」をクリックします。

Form の作成

プロジェクトを作成したら、一覧画面を表示するためのForm を作成しておきます。

1. 「File」→「New」→「Form(.xfdl)」を選択し

2. 任意の名称でEmpty Form を作成します。

3. 以下のようにフォームが表示できればOKです。

DataObject の作成

続いてWeb API との通信の部分を作り込んでいきます。NEXACRO BEYOND ではDataObject という機能を用いて、JSON フォーマットのWeb API との通信やデータ制御を行うようになっています。

1. まず「DataObject」を画面に配置します。

2. DataObject を配置すると、Invisible Object の一覧に配置したDataObject が表示されるので右クリックから「Edit」を選択します。

3. このJson Content Editor でJSON のオブジェクト構造を確認します。ここで先ほどCData Connect Server で定義したリソースのエンドポイントを指定します。その際にクエリパラメータでの認証も入力しておきましょう。

4. 併せて、今回はアプリケーションを実行したときに通信が行われるように「preload」を「true」に指定しておきました。

Dataset を構成する

今回は最終的に一覧画面を作るわけですが、一覧画面のコンポーネントはJSON のように不定形なオブジェクトだとバインディングすることができません。

そこで、一度DataObject を「Dataset」という画面上で利用できるオブジェクトにマッピングしてあげた上で、UI 上で表示できるようにします。

1. 「Dataset」を先ほどと同じように画面に配置します。

2. 作成したDataset の「binddataobject」で先ほど作成したDataObject を選択し、次に「dataobjectpath」を編集します。

3. 以下のようなData Path Editor という画面で、JSON のオブジェクト構造をどのようにマッピングするかを構成できます。

4. CData Connect Server で作成されたWeb API「$.value」というJSON Path でレコードに分解できます。そのため DataObject Path に「$.value [*]」と入力して、リロードし、各カラムをマッピングさせます。

Grid の作成

最後に一覧表示用のGrid を配置して、取得したデータを表示してみましょう。

1. Grid をキャンパス上に配置します。

2. Grid を配置後、先ほど定義したDataset をGrid 上にドラッグ・アンド・ドロップで持っていくと、以下のよう一覧画面が表示されます。

このように、CData Connect Server を経由することで、API 側の複雑な仕様を意識せずにAPI 連携アプリをNEXACRO BEYOND で開発できます。他にも多くのデータソースに対応するCData Connect Server の詳細をこちらからご覧ください。