Excel からMicrosoft Query を使ってSAP SuccessFactors に接続する方法

古川えりか
コンテンツスペシャリスト

この記事では、CData ODBC ドライバを使って、Microsoft Query でExcel にデータをインポートします。Microsoft Query でパラメータを使う方法も説明します。

Microsoft Query を使うことで、Excel からデータベースやファイル、外部データソースにアクセスしてデータをインポート、更新できます。CData ODBC Driver for SAPSuccessFactors はMicrosoft Query の連携先を拡張して、270種類以上のCRM、ERP、MA、会計ツールなどのデータソースへのアクセスを実現します。この記事では、Microsoft Query を使ってSAP SuccessFactors のデータをスプレッドシートにインポートする方法をご紹介します。

CData ODBC ドライバとは？

300種類以上の業務システムやDB をお好みのツールとノーコード連携

CData ODBC ドライバは、以下のような特徴を持つデータ連携ツールです。

SAP SuccessFactors をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの300種類以上のSaaS / オンプレデータソースに対応

多様な帳票・BI ツールにSAP SuccessFactors のデータを連携

ノーコードでの手軽な接続設定

標準SQL での柔軟なデータ読み込み・書き込み

ベーシック認証 / OAuth 2.0 / SAML など多様な認証方式に対応

詳細はこちら 30日間の無償トライアルでスタート

このチュートリアルではCData ODBC Drivers を使用してkintone とのデータ連携をノーコードで設定します

CData ODBC ドライバでは、1.データソースとしてSAP SuccessFactors の接続を設定、2.Microsoft Query でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

SAP SuccessFactors への接続を設定

まずは、本記事右側のサイドバーからSAPSuccessFactors ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

ODBC ドライバーのインストール完了時にODBC DSN 設定画面が立ち上がります。または、Microsoft ODBC データソースアドミニストレーターを使ってDSN を作成および設定できます。

SAP SuccessFactorsへの接続

それでは、SAP SuccessFactors に接続していきましょう。CData 製品は、デフォルトで有効になっているOData API を介してSAP SuccessFactors と通信します。追加の権限が必要な場合は、SAP サポートサイトをご確認ください。

認証方法として、Azure AD 認証、SAP IAS 認証、OAuth 認証（推奨）、Basic 認証（非推奨）のいずれかを使用してSAP SuccessFactors に認証できます。

必要な接続プロパティ

選択したAuthScheme に関わらず、SAP SuccessFactors 環境を識別するために以下の接続プロパティを設定しましょう。

URL：SuccessFactors をホストするサーバーのURL
CompanyId：SAP SuccessFactors テナントに割り当てられた一意の識別子。この値はAPI 認証に必要で、組織固有のものです

OAuth 認証

SAP SuccessFactors では、OAuth 認証を2種類のグラント種別でサポートしています。

SAP SuccessFactors LMS インスタンスのクライアントグラント種別
SAML-2 Bearer グラント種別

OAuth 認証を有効にするには、すべてのOAuth フローでカスタムOAuth アプリケーションを作成し、適切なプロパティを設定する必要があります。

デスクトップアプリケーションでカスタムOAuth アプリケーションの資格情報を使用して認証するには、OAuth アクセストークンを取得し、更新する必要があります。これらを設定すると、接続の準備が整います。

OAuth アクセストークンの取得およびリフレッシュ

以下のプロパティを設定してください。

InitiateOAuth：GETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します
OAuthClientId：アプリケーションの登録時に割り当てられたクライアントId
CallbackURL：カスタムOAuth アプリケーションの登録時に定義されたリダイレクトURI
OAuthClientSecret （クライアントグラント種別のみ）：アプリケーションの登録時に割り当てられたクライアントシークレット
PrivateKey （SAML-2 Bearer グラント種別のみ）：カスタムOAuth アプリケーションの作成時にダウンロードした秘密鍵証明書のパス、またはその証明書のbase64 でエンコードされた内容

接続すると、CData 製品がデフォルトブラウザでSAP SuccessFactors のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えてください。

アプリケーションにアクセス許可を与えると、CData 製品がOAuth プロセスを完了します。

CData 製品がSAP SuccessFactors からアクセストークンを取得し、それを使ってデータをリクエストします
OAuth 値はOAuthSettingsLocation で指定されたパスに保存されます。これらの値は接続間で永続化されます

アクセストークンの期限が切れた際は、CData 製品が自動でアクセストークンをリフレッシュします。

カスタムOAuth アプリケーションの作成やその他の認証方法については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」をご確認ください。

Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法の詳細は、ヘルプドキュメントの「はじめに」を参照してください。

Excel で［データ］タブを開き［その他のデータソースから］->［Microsoft Query から］を選びます。

マシンにインストールされているMicrosoft Office のバージョンに合わせて、32 bit CData SAP SuccessFactors Source または64 bit CData SAP SuccessFactors Source x64 DSN を選びます。Query Wizard を使うオプションを選択し、クエリを作成／編集します。

The list of available ODBC DSNs in the Choose Data Source dialog.

Query Wizard で、スプレッドシートにインポートしたいテーブルのノードを展開します。インポートしたいカラムを選択し、矢印をクリックしてクエリに追加します。あるいはテーブル名を選択して、テーブルにあるすべてのカラムを追加します。

Available tables and columns in the Choose Columns step of the Query Wizard. (Salesforce is shown.)

［Filter Data］ページではクライテリアを指定できます。例えば、日付の範囲を設定して結果を絞れます。

The Filter Data step of the Query Wizard. (Salesforce is shown.)

クエリでパラメータを使いたい場合は、Microsoft Query でクエリを編集するオプションを選択します。

クエリにパラメータを設定するには、SQL を直接修正する必要があります。その場合は、［Query Editor］の［SQL］ボタンをクリックします。フィルタクライテリアを事前に設定している場合は、クエリ内にWHERE 句が存在します。

パラメータを使うには、WHERE 句のフィールド値にワイルドカード文字として "?" を使います。例えばExtAddressInfo をインポートしている場合は、"city=?" を設定できます。

SQL ステートメントの編集が終わったら［SQL］ダイアログを閉じます。パラメータ値を入力するように促されますが、次のステップでセルを選択して値を入れることになるので、このダイアログではボックスは空のままにしておきます。

The generated SQL statement. (Salesforce is shown.)

Microsoft Query を閉じます。［Import Data］ダイアログが表示されます。結果をインポートするセルを入力します。 The Import Data dialog.

［Import Data］ダイアログを閉じます。パラメータ値を入力するように促されます。パラメータボックスの隣にあるボタンをクリックしてセルを選択します。値が変更されたらスプレッドシートを自動的にリフレッシュするオプションを選択します。

データはこれでExcel にインポートされました。セルB1の値を変更すると、データは指定した検索クライテリアによってフィルタされます。 The results of the query, with the search criteria applied. (Salesforce is shown.)