Appsmith で SharePoint 連携アプリケーションを作成
Appsmith は、チームがビジネスオペレーションを改善するためのUI を素早く簡単に構築できる、オープンソースの内部ツールビルダーです。CData Connect AI と組み合わせることで、ビジネスアプリケーションから SharePoint のデータ に即座にアクセスできるようになります。この記事では、Connect AI を使用して SharePoint に接続し、Appsmith で SharePoint のデータ から基本的なアプリケーションを作成するプロセスを説明します。
CData Connect AI は、SharePoint への純粋なSQL Server のクラウドtoクラウドインターフェースを提供し、Appsmith 内からライブ SharePoint のデータ を直接使用してビジネスアプリケーションを作成できます。ネイティブデータベースへのデータレプリケーションは必要ありません。アプリケーションを構築する際、Appsmith はデータを収集するためのSQL クエリを生成します。CData Connect AI は、最適化されたデータ処理機能により、フィルタやJOIN を含むすべてのサポートされるSQL オペレーションを SharePoint に直接送信します。これにより、サーバーサイドの処理を活用して、リクエストされた SharePoint のデータ を迅速に取得できます。
SharePoint データ連携について
CData を使用すれば、SharePoint のライブデータへのアクセスと統合がこれまでになく簡単になります。お客様は CData の接続機能を以下の目的で利用しています:
- Windows SharePoint Services 3.0、Microsoft Office SharePoint Server 2007 以降、SharePoint Online を含む、幅広い SharePoint バージョンのデータにアクセスできます。
- 非表示カラムとルックアップカラムのサポートにより、SharePoint のすべてにアクセスできます。
- フォルダを再帰的にスキャンして、すべての SharePoint データのリレーショナルモデルを作成できます。
- SQL ストアドプロシージャを使用して、ドキュメントや添付ファイルをアップロード・ダウンロードできます。
多くのお客様は、SharePoint データをデータベースやデータウェアハウスに統合するために CData ソリューションを活用していますが、Power BI、Tableau、Excel などのお気に入りのデータツールと SharePoint データを統合しているお客様もいます。
お客様が CData の SharePoint ソリューションで問題を解決している方法については、ブログをご覧ください:Drivers in Focus: Collaboration Tools
はじめに
Appsmith 用に SharePoint への接続を構成
Appsmith から SharePoint への接続は、CData Connect AI を介して行います。Appsmith から SharePoint のデータ を操作するには、まず SharePoint 接続を作成して構成します。
- Connect AI にログインし、Sources をクリックして、 Add Connection をクリックします
- Add Connection パネルから「SharePoint」を選択します
-
SharePoint に接続するために必要な認証プロパティを入力します。
Microsoft SharePoint への接続
URL の設定:
Microsoft SharePoint では、2つの範囲でデータを操作できます。グローバルなMicrosoft SharePoint サイト全体を対象にするか、個々のサイトのみを対象にするかを選択できます。
グローバルなMicrosoft SharePoint サイトですべてのリストおよびドキュメントを操作したい場合は、URL 接続プロパティをサイトコレクションURL に設定しましょう。以下のような形式です。
https://teams.contoso.com
個々のサイトのリストおよびドキュメントのみを扱いたい場合は、URL 接続プロパティを個々のサイトURL に設定してください。以下のような形式です。
https://teams.contoso.com/TeamA
続いて、お使いの環境に適した認証プロパティを設定していきましょう。詳細な設定手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」をご参照ください。
Microsoft SharePoint Online
SharePointEdition を"SharePoint Online" に設定し、User およびPassword にはSharePoint へのログオンで使用するクレデンシャル(例:Microsoft Online Services アカウントのクレデンシャル)を設定します。
Microsoft SharePoint Online は様々なクラウドベースアーキテクチャをサポートしており、それぞれ異なる認証スキームが利用できます。
- Microsoft Entra ID(Azure AD)
- ADFS、Okta、OneLogin、またはPingFederate SSO ID プロバイダーを介したシングルサインオン(SSO)
- Azure MSI
- Azure パスワード
- OAuthJWT
- SharePointOAuth
Microsoft SharePoint オンプレミス
Microsoft SharePoint オンプレミスでは、多くのオンプレミス環境に対応した認証方式をサポートしています。
- Windows(NTLM)
- Kerberos
- ADFS
- 匿名アクセス
まずSharePointEdition を"SharePoint On-Premises" に設定しましょう。
Windows(NTLM)認証
これは最も一般的な認証方式です。そのため、CData 製品ではNTLM をデフォルトとして使用するよう事前設定されています。Windows のUser およびPassword を設定するだけで接続できます。
- Save & Test をクリックします
-
Add SharePoint Connection ページのPermissions タブに移動し、User-based permissions を更新します。
パーソナルアクセストークンの追加
REST API、OData API、またはVirtual SQL Server を介してConnect AI に接続する場合、パーソナルアクセストークン(PAT)を使用してConnect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして、設定ページを開きます。
- 設定ページで、Access Tokens セクションに移動し、 Create PAT をクリックします。
-
PAT に名前を付けて、Create をクリックします。
- パーソナルアクセストークンは作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。
接続が構成され、PAT が生成されたので、Appsmith から SharePoint のデータ に接続する準備が整いました。
ライブ SharePoint のデータ からAppsmith アプリケーションを作成
Appsmith からCData Connect AI Virtual SQL Server への接続を確立するには、以下の手順に従います。
Appsmith で SharePoint に接続
- Appsmith インスタンスにログインし、新しいアプリケーションを作成します。
-
新しいアプリケーションで、Data ページを開き、Bring your data を選択します。
-
このページで、Microsoft SQL Server を検索し、データソースとして選択します。
-
新しいデータソースの名前を入力し、以下の接続設定を入力します。
- Host address: tds.cdata.com
- Port: 14333
- Database name: 接続するCData Connect AI データソースの接続名を入力します(例:SharePoint1)。
- Username: CData Connect AI のユーザー名を入力します。これはCData Connect AI インターフェースの右上に表示されます。例:test@cdata.com。
- Password: 先ほど生成したPAT を入力します。
- Test configuration をクリックして接続が成功したことを確認し、Save をクリックしてデータソースを保存します。
新しいクエリを作成
データソースへの接続を構成したら、SQL クエリを追加してデータソースから実際にデータを取得します。
-
新しいデータソースの画面で、New Query をクリックします。
-
クエリエディタが開き、データを選択するSQL クエリを入力できます。SQL クエリの指定については、CData Connect AI のExplorer を使用して、SQL クエリと取得するデータをプレビューできます。
-
SQL クエリを作成したら、Appsmith のクエリエディタに戻り、SQL クエリを入力してRun をクリックします。
- クエリが正常に実行されたら、あとは取得したデータを表示するためのページをセットアップするだけです。
SharePoint のデータ を表示
-
UI タブを開き、New UI element をクリックします。
-
新しいUI 要素を選択し、ページ上にドラッグアンドドロップします。
-
新しいUI 要素でConnect data をクリックし、先ほど作成したクエリを選択します。
-
データが接続されると、UI 要素にデータが表示されます。
アプリケーションをデプロイ
SharePoint のデータ がアプリケーションのUI 要素に接続されたら、アプリケーションをデプロイできます。Appsmith の右上にあるDeploy をクリックすると、SharePoint のデータ を表示するアプリケーションが別ウィンドウで開きます。
CData Connect AI の入手
クラウドアプリケーションから300以上のSaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、CData Connect AI をお試しください。