SAP SuccessFactors のデータをBoard に連携してビジュアライズを作成
CData ODBC Driver for SAPSuccessFactors は、ODBC 標準に準拠しており、BI ツールからIDE まで幅広いアプリケーションでSAP SuccessFactors への接続を提供します。 この記事では、CPM/BIツールのBoardからSAP SuccessFactors に接続、レポートを作成する方法を説明します。
CData ODBC ドライバとは?
CData ODBC ドライバは、以下のような特徴を持った製品です。
- SAP SuccessFactors をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
- 多様なアプリケーション、ツールにSAP SuccessFactors のデータを連携
- ノーコードでの手軽な接続設定
- 標準SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてSAP SuccessFactors の接続を設定、2.board 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとSAP SuccessFactors への接続設定
まずは、本記事右側のサイドバーからSAPSuccessFactors ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
- インストール後、ODBCデータソースアドミニストレーターにて[システムDSN]タブをクリックし、CData SAP SuccessFactors Source Sys(64bit or 32bit)の接続情報を構成します。(※BoardはシステムDSNのみに対応しています。ユーザー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">ヘルプドキュメントの「はじめに」をご確認ください。
Board DB の作成
最初にBoardの接続情報やキューブ等を格納するDBを作成します。
- Boardを立ち上げて、任意の接続先へ接続します。
- [Database]タブから[New DB]をクリックします。
- 開いたDB作成用ウィンドウにて、任意の[Database name][Language][From Year][To Year]を入力し[OK]をクリックします。
SQL FastTrackを用いたODBCデータソースからのデータロード
次にSQL FastTrackの機能を用いてODBCデータソースから SAP SuccessFactors のデータをBoard上にロードします。
- [Database]タブの[SQL FastTrack]をクリックし、Data souceの[New]ボタンをクリックします。
- 接続先を設定するためのウィンドウが表示されますので、[OLE-DB Wizard]をクリックします。
- 開いたデータリンクプロパティの[プロバイダー]タブから[Microsoft OLE DB Provider for ODBC Drivers]を選択し、[次へ]をクリックします。
- [接続タブ]の[1.データソースを指定します]から事前に設定したODBC DSNを選択し、[3.使用する初期カタログを入力します]に[CData]を入力の上、[OK]をクリックします。
- 任意の[Name]を入力し[Save & Connect]をクリックします。
- SQL FastTrackの画面に戻った後、[Connect]をクリックします。
- Connectをクリック後、Data souce画面左側に SAP SuccessFactors のテーブル一覧が表示されます。分析対象とするテーブルをダブルクリックすると、自動的にSQL クエリが記述されます。記述内容を確認の上、[Execute Query]をクリックします。
- Execute Queryをクリックすると、テーブルに格納された項目一覧が以下の図のように表示されます。分析で使用したい任意の項目を[Code][Desc][Cube]のいずれかにチェックを入れ、Cube/Entityを入力し、Track実行ボタンをクリックします。
- 確認ダイアログが表示されますので、[Yes]をクリックします。
- SQL FastTrackの機能により、ODBC データソースからデータがロードされ、自動的にEntityとCubeが生成されます。
- 以下のダイアログが表示されれば、Boardへのデータロードは完了です。
グラフの作成
ロードしたデータを元に簡単なグラフの作成方法を紹介します。
- 最初に各種Screenを格納するためのCapsuleを作成します。[Home]タブを選択し[Capsule]から[New Capsule]をクリックします。
- 任意の[Capsule Name]を入力し[OK]をクリックします。
- 続いてScreenを作成するための画面が表示されるため任意の[Screen Name]を入力し[OK]をクリックします。
- Screenが作成されると、ChartやDataViewを配置することが可能になります。[Charts]から[Chart]を選択し、Screenにドラッグ・アンド・ドロップでChartを配置します。
- 以下のようにChartを配置後、右クリックメニューで[Layout]をクリックします。
- LayoutでChart上のValueとして扱う値を指定します。[Data]タブから[Double-click here to create a block]の箇所をダブルクリックします。
- [Data Selection]から先程のSQL FastTrackにてCubeの指定をした任意の値を選択し[OK]をクリックします。
- 続いて[Axes]タブをクリックし、先程指定した値の分析軸とするBy Rowに任意の項目を選択し[OK]をクリックします。
- 設定完了後、以下のようにグラフが表示されます。
このようにSAPSuccessFactors 内のデータをAPI を書くことなくBoard上で利用することができるようになります。