接続の確立
コネクタ内で利用可能なオブジェクトは、"cdata.excelservices" モジュールからアクセスできます。モジュールのオブジェクトを直接使用するには：
- モジュールを以下のようにインポートします。
import cdata.excelservices as mod
- 接続を確立するには、以下のような適切な接続文字列を使用してコネクタオブジェクトからconnect() メソッドを呼び出します。
mod.connect("Url=https://myorg.sharepoint.com;[email protected];Password=password;File=Book1.xlsx;")
このセクションでは、SharePoint Online およびSharePoint On Premises への接続に関する詳細について説明します。
ワークブックへの接続
使用しているSharePoint のエディションに関わらず、File をExcel ワークブックに設定します。このパスは次のプロパティからの相対パスです。
- Library：デフォルトでは、Shared Documents ライブラリが使用されます。このプロパティを使って、組織内の別のドキュメントライブラリを指定できます。例えば、OneDrive for Business に接続する場合は、このプロパティを"Documents" に設定します。
- Folder：このプロパティを使って、ライブラリ内のサブフォルダへのパスを指定できます。パスはLibrary で指定されたライブラリ名と関連があります。
テーブルとしてのスプレッドシートデータへの接続
本製品 は、基底のAPI の使用可能なオブジェクトに基づいて使用可能なテーブルを検出します。
API は異なるAPI オブジェクトを表示します。スプレッドシートの構成とSharePoint のバージョンに基づいてAPI を選択します。
- OData： OData API を使用すると、Excel で［挿入］->［テーブル］をクリックして作成されたExcel テーブルオブジェクト（範囲やスプレッドシートではありません）から定義されたテーブルにアクセスできます。OData API に接続する際、ワークブックにテーブルオブジェクトが定義されていない場合は、本製品 がテーブルを返さないことがあります。テーブルとしてスプレッドシートまたは範囲に接続するには、UseRESTAPI をtrue に設定します。
- REST： REST API を使用すると、Excel テーブルオブジェクト、範囲、およびスプレッドシートから定義されたテーブルへのアクセスを可能にします。これはデフォルトのAPI です。範囲およびスプレッドシートから多数の行をリクエストすることはREST API によって制限されており、本製品 では返される行数をデフォルトで100に制限しています。また本製品 は、デフォルトで1行目からカラム名を検出します。これを無効にするには、Header を設定します。
DefineTables を追加設定すると、Excel の範囲の構文を使用して、範囲に基づいてテーブルを定義できます。大きすぎる範囲は、API によって制限されます。
本製品 がテーブルを検出してそれらをクエリする方法について、詳しくはData Model を参照してください。
SharePoint オンプレミスへの接続
Url をサーバー名もしくはIP アドレスに設定します。さらに、SharePointVersion および認証値を設定します。
SharePoint OnPremise を認証するには、AuthScheme を認証タイプに設定し、必要に応じてUser およびPassword を設定します。
Note：SharePoint On-Premises 2010に接続する場合は、 UseRESTAPI をtrue に設定する必要があります。
-
Windows（NTLM）
これは最も一般的な認証タイプです。そのため、本製品 はNTLM をデフォルトとして使用するように事前設定されています。Windows のUser およびPassword を設定して接続します。
-
Kerberos
Kerberos で認証する方法についての詳細は、Kerberos の使用 を参照してください。
-
Forms
この設定で、Active Directory の代わりにカスタム認証メソッドによる認証が可能になります。この認証タイプを使用するには、AuthScheme をFORMS に設定し、User およびPassword を設定します。
-
ADFS
AuthScheme をADFS に設定します。次の接続プロパティを設定する必要があります。
- User：ADFS ユーザーに設定。
- Password：ユーザーのADFS パスワードに設定。
- SSOLoginURL：ADFS サーバーのWS-Trust エンドポイントに設定。
- RelyingParty：SharePoint のADFS サーバー上の証明書利用者の識別子の値です。
AuthScheme=ADFS;User=ADFSUserName;Password=ADFSPassword;SSOLoginURL=https://<authority>/adfs/services/trust/2005/usernamemixed;SSO Properties ='RelyingParty=urn:sharepoint:sp2016;';
-
Anonymous Access
Set the AuthScheme to NONE along with the URL.