C++Builder でSharePoint Excel Services のデータにデータバインドするコントロールを作成

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
C++Builder で標準コンポーネントとコントロールを使ってSharePoint Excel Services のデータ にデータバインド。

CData ODBC ドライバー for SharePoint Excel Services を使用すると、C++Builder の標準データアクセスコンポーネントを使ってライブのSharePoint Excel Services のデータ への接続を簡単に統合できます。この記事では、C++Builder でシンプルな VCL（Visual Component Library）アプリケーションを作成し、SharePoint Excel Services のデータ に接続してクエリを実行し、グリッドに結果を表示する方法を説明します。さらに、FireDAC コンポーネントを使ってコードからコマンドを実行する方法も紹介します。

SharePoint Excel Services のデータへの接続を作成

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最終ステップです。Microsoft ODBC データソースアドミニストレーターを使って ODBC DSN を作成・設定できます。

ワークブックへの接続

どちらのSharePoint エディションをお使いでも、File を Excel ワークブックに設定してください。このパスは以下のプロパティからの相対パスになります。

  • Library：デフォルトではShared Documents ライブラリが使用されます。このプロパティを使って、組織内の別のドキュメントライブラリを指定してみてください。例えば、OneDrive for Business に接続する場合は、このプロパティを"Documents" に設定します。
  • Folder：このプロパティを使って、ライブラリ内のサブフォルダへのパスを指定できます。パスはLibrary で指定されたライブラリ名に関連します。

テーブルとしてのスプレッドシートデータへの接続

CData 製品では、基底API で利用可能なオブジェクトに基づいて、使用可能なテーブルを検出していきます。

API では異なるAPI オブジェクトを表示します。スプレッドシートの構成とSharePoint のバージョンに基づいてAPI を選択しましょう。

  • OData： OData API を使用すると、Excel で［挿入］->［テーブル］をクリックして作成されたExcel テーブルオブジェクト（範囲やスプレッドシートではありません）から定義されたテーブルにアクセスできます。OData API に接続する際、ワークブックにテーブルオブジェクトが定義されていない場合は、CData 製品がテーブルを返さないことがあります。テーブルとしてスプレッドシートまたは範囲に接続するには、UseRESTAPI をtrue に設定してください。
  • REST： REST API を使用すると、Excel テーブルオブジェクト、範囲、およびスプレッドシートから定義されたテーブルへアクセスできます。これがデフォルトの API です。範囲およびスプレッドシートから多数の行をリクエストすることは REST API によって制限されており、CData 製品では返される行数をデフォルトで 100 に制限しています。また CData 製品では、デフォルトで1行目からカラム名を検出します。これを無効にするには、Header を設定してください。

DefineTables を追加設定すると、Excel の範囲の構文を使用して、範囲に基づいてテーブルを定義できます。大きすぎる範囲は、API によって制限されます。

SharePoint オンプレミスへの接続

URL をサーバー名もしくはIP アドレスに設定しましょう。さらに、SharePointVersion と認証値を設定します。

SharePoint OnPremises を認証するには、AuthScheme を認証タイプに設定し、必要に応じてUser と Password を設定してください。

Note：SharePoint On-Premises 2010 に接続する場合は、 UseRESTAPI をtrue に設定する必要があります。

    Windows（NTLM）

    最も一般的な認証タイプです。CData 製品では NTLM をデフォルトとして使用するよう事前設定されています。Windows のUser と Password を設定して接続してください。

    その他の認証方法については、ヘルプドキュメントの「はじめに」をご覧ください。

    次に、以下の手順に従って Data Explorer を使用し、SharePoint Excel Services への FireDAC 接続を作成します。

    1. 新しい VCL Forms アプリケーションで、Data Explorer の FireDAC ノードを展開します。
    2. Data Explorer の ODBC Data Source ノードを右クリックします。
    3. Add New Connection をクリックします。
    4. 接続の名前を入力します。
    5. 表示される FireDAC Connection Editor で、DataSource プロパティをSharePoint Excel Services の ODBC DSN の名前に設定します。

    SharePoint Excel Services のデータに接続する VCL アプリケーションを作成

    以下の手順に従って、クエリの結果をグリッドに表示するシンプルな VCL アプリケーションからSharePoint Excel Services のデータ のクエリを開始します。

    1. TFDConnection コンポーネントをフォームにドロップし、以下のプロパティを設定します：

      • ConnectionDefName：SharePoint Excel Services への FireDAC 接続を選択します。
      • Connected：メニューから True を選択し、表示されるダイアログで資格情報を入力します。

    2. TFDQuery コンポーネントをフォームにドロップし、以下のプロパティを設定します：

      • Connection：TFDConnection コンポーネントに設定します（まだ指定されていない場合）。

      • SQL：SQL プロパティのボタンをクリックし、クエリを入力します。例：

        SELECT Name, AnnualRevenue FROM Account
      • Active：このプロパティを true に設定します。

    3. TDataSource コンポーネントをフォームにドロップし、以下のプロパティを設定します：

      • DataSet：このプロパティのメニューで、TFDQuery コンポーネントの名前を選択します。

    4. TDBGrid コントロールをフォームにドロップし、以下のプロパティを設定します：

      • DataSource：TDataSource の名前を選択します。
    5. TFDGUIxWaitCursor をフォームにドロップします — これは実行時エラーを回避するために必要です。

    FireDAC コンポーネントを使ってSharePoint Excel Services にコマンドを実行

    TFDConnection および TFQuery コンポーネントを使用して、SharePoint Excel Services のデータ にクエリを実行できます。このセクションでは、TFQuery コンポーネントを使ったクエリ実行のSharePoint Excel Services 固有の例を紹介します。

    SharePoint Excel Services のデータに接続

    データソースに接続するには、TFDConnection コンポーネントの Connected プロパティを true に設定します。コードから同じプロパティを設定することもできます：

    FDConnection1->ConnectionDefName = "CData SharePoint Excel Services ODBC Source";
FDConnection1->Connected = true;

    TFDQuery コンポーネントをSharePoint Excel Services のデータ に接続するには、コンポーネントの Connection プロパティを設定します。設計時に TFDQuery コンポーネントを追加すると、上記のアプリケーションのように、その Connection プロパティはフォーム上の TFDConnection を指すように自動的に設定されます。

    パラメータ化クエリの作成

    パラメータ化クエリを作成するには、以下の構文を使用します： 

    FDQuery1->SQL->Text = "select * from Account where industry = :Industry";
FDQuery1->ParamByName("industry")->AsString = "Floppy Disks";
FDQuery1->Open();

    上記の例では、文字列型の入力パラメータを名前でバインドし、結果のデータセットを開いています。

    ステートメントの準備

    ステートメントの準備は、システムリソースと時間の両方でコストがかかります。ステートメントの準備中は、接続がアクティブで開いている必要があります。デフォルトでは、FireDAC は同じクエリを何度もコンパイルすることを避けるためにクエリを準備します。ステートメントの準備を無効にするには、ResourceOptions.DirectExecute を True に設定します。例えば、クエリを一度だけ実行する必要がある場合などです。

    クエリの実行

    SELECT クエリなど、結果セットを返すクエリを実行するには、Open メソッドを使用します。Open メソッドはクエリを実行し、結果セットを返して開きます。クエリが結果セットを生成しない場合、Open メソッドはエラーを返します。

    FDQuery1->SQL->Text = "select * from Account where industry = :Industry";
FDQuery1->ParamByName("industry")->AsString = "Floppy Disks";
FDQuery1->Open();

    関連記事

    以下に、RAD Studio、Delphi、C++ Builder で CData ODBC ドライバーを使用するための他の記事を紹介します。

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

SharePoint Excel Services ODBC Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

SharePoint Excel Services Icon SharePoint Excel Services ODBC Driver お問い合わせ

Excel Services ODBC ドライバーは、ODBC 接続をサポートする任意のアプリケーションからリアルタイムなExcel Services データに接続できるパワフルなツールです。標準のODBC ドライバーインターフェースを使用して、データベースのようにSharePoint サーバーでホストされているExcel スプレッドシートデータにアクセスし、データ連携を実行できます。

この記事の内容

関連記事