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

杉本和也
杉本和也
リードエンジニア
CData Connect AI を使ってConfluence のデータのOData API エンドポイントを作成して、NEXACRO BEYOND からConfluence のデータを使ったアプリを作成する方法。

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

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

Connect AI を構成する

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

（オプション）新しいConnect AI ユーザーの追加

必要であれば、Connect AI 経由でConfluence に接続するユーザーを作成します。

  1. ユーザーページに移動し、 Invite Users をクリックします。
  2. 新しいユーザーのE メールアドレスを入力して、 Send to invite the user をクリックします。 新しいユーザーを招待
  3. ユーザーページからユーザーを確認および編集できます。 Connect AI users

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

MotionBoard への接続には、パスワードの代わりとしてパーソナルアクセストークンを利用します。セキュアなアクセス管理を実現するには、サービスごとに個別のPAT を作成するのがベストプラクティスです。

  1. Connect AI アプリの右上にある歯車アイコンをクリックします。
  2. Settings ページで「Access Tokens」タブに移動し、 Create PAT をクリックします。
  3. PAT の名前を入力して Create をクリックします。 新しいPAT を作成
  4. パーソナルアクセストークンは作成時にしか表示されないため、コピーして安全に保存してください。

Connect AI からConfluence に接続

CData Connect AI では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。

  1. Connect AI にログインし、 Add Connection をクリックします。 Adding a Connection
  2. Add Connection パネルから「Confluence」を選択します。 Selecting a data source
  3. 必要な認証プロパティを入力し、Confluence に接続します。

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

    任意のConfluence Cloud またはConfluence Server インスタンスへの接続を確立できます。接続するにはURL 接続プロパティを設定します。例えば、https://yoursitename.atlassian.net です。

    Confluence への認証

    Confluence は、次の認証メソッドをサポートしています：API トークン、Basic 認証、OAuth 2.0、SSO。

    API トークン - Confluence Cloud アカウント

    トークンの取得

    アカウント認証にはAPI トークンが必要です。API トークンを生成するには、Atlassian アカウントにログインしてAPI トークン -> API トークンの作成を選択します。生成されたトークンが表示されます。

    トークンを使用する認証

    Cloud アカウントへの認証を行うには、以下を入力します。

    • AuthScheme：APIToken に設定。
    • User：Confluence サーバーに認証する際に使用されるユーザー。
    • APIToken：現在認証されているユーザーに紐づくAPI トークン。
    • Url：Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。

    Basic 認証 - Confluence Server インスタンス

    Server インスタンスへの認証を行うには、以下のように指定します。

    • AuthScheme：Basic に設定。
    • User：Confluence インスタンスに認証する際に使用されるユーザー。
    • Password：Confluence サーバーに認証する際に使われるパスワード。
    • Url：Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。
    その他の認証方法と詳細については、ヘルプドキュメントの「はじめに」セクションを参照してください。

    Configuring a connection (Salesforce is shown)
  4. Create & Test をクリックします。
  5. Edit Confluence Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。 権限を更新

Connect AI にConfluence OData エンドポイントを追加する

Confluence に接続したら、目的のテーブルのOData エンドポイントを作成します。

  1. OData ページに移動し、 Add to create new OData endpoints をクリックします。
  2. Confluence コネクション（例：Confluence1）を選択し、Next をクリックします。
  3. 使用するテーブルを選択し、Confirm をクリックします。 テーブルを選択（Salesforce の例）

コネクションとOData エンドポイントが構成されたら、NEXACRO BEYOND からConfluence に接続できるようになります。

プロジェクトの作成

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 AI で定義したリソースのエンドポイントを指定します。その際にクエリパラメータでの認証も入力しておきましょう。
  4. 併せて、今回はアプリケーションを実行したときに通信が行われるように「preload」を「true」に指定しておきました。

Dataset を構成する

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

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

  1. 「Dataset」を先ほどと同じように画面に配置します。
  2. 作成したDataset の「binddataobject」で先ほど作成したDataObject を選択し、次に「dataobjectpath」を編集します。
  3. 以下のようなData Path Editor という画面で、JSON のオブジェクト構造をどのようにマッピングするかを構成できます。
  4. CData Connect AI で作成されたWeb API「$.value」というJSON Path でレコードに分解できます。そのため DataObject Path に「$.value [*]」と入力して、リロードし、各カラムをマッピングさせます。

Grid の作成

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

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

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

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

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

無料トライアル お問い合わせ

この記事の内容

関連記事