API Server とSmartHR ADO.NET Provider を使用して、Microsoft PowerPivot からSmartHR のデータにアクセス

古川えりか
古川えりか
コンテンツスペシャリスト
API Server を使用して、PowerPivot ビジネスインテリジェンスツールからリアルタイムSmartHR のデータに接続。



この記事では、API Server を使用してMicrosoft Excel のPowerPivot ビジネスインテリジェンスツールでデータを活用する方法について説明します。以下のステップに従って、Power Pivot でSmartHR のデータを取得します。

API Server の設定

以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなSmartHR OData サービスを作成していきましょう。

SmartHR への接続

PowerPivot からSmartHR のデータを操作するには、まずSmartHR への接続を作成・設定します。

  1. API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。 接続を追加
  2. 「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「SmartHR」を選択します。
  3. 事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
    CData コネクタの追加方法はこちら >>
  4. それでは、SmartHR への接続設定を行っていきましょう！ 接続設定

  5. SmartHR に接続するには、SmartHR API トークンとTenantId が必要です。API トークンはSmartHR のアプリケーション統合ページで生成できます。トークンを取得したら、ProfileSettings API Key 接続プロパティに指定してください。TenantId は自身のSmartHR ページのURL「https://1234567890.smarthr.jp/」で確認できます（ここでは「1234567890」）。もしSandbox 環境を使用する場合は、接続プロパティにUseSandbox=true を設定してください。

    次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。

  6. 接続情報の入力が完了したら、「保存およびテスト」をクリックします。

SmartHR に接続するには、SmartHR API トークンとTenantId が必要です。API トークンはSmartHR のアプリケーション統合ページで生成できます。トークンを取得したら、ProfileSettings API Key 接続プロパティに指定してください。TenantId は自身のSmartHR ページのURL「https://1234567890.smarthr.jp/」で確認できます（ここでは「1234567890」）。もしSandbox 環境を使用する場合は、接続プロパティにUseSandbox=true を設定してください。

次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。

API Server のユーザー設定

次に、API Server 経由でSmartHR にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。

  1. 「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
  2. 次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
  3. その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。

SmartHR 用のAPI エンドポイントの作成

ユーザーを作成したら、SmartHR のデータ用のAPI エンドポイントを作成していきます。

  1. まず、「API」ページに移動し、 「 テーブルを追加」をクリックします。
  2. アクセスしたい接続を選択し、次へをクリックします。
  3. 接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。

OData のエンドポイントを取得

以上でSmartHR への接続を設定してユーザーを作成し、API Server でSmartHR データのAPI を追加しました。これで、OData 形式のSmartHR データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。

さらに、「Settings」->「Server」をクリックし、Excel との互換性のために「デフォルトフォーマット」を「XML (Atom)」に設定します。

API Server ユーザーを認証する

作成するOData サービスを決定したら、「Settings」->「Users」とクリックしてユーザーを認証します。API Server は、認証トークンベースの認証を使用して、主要な認証スキームをサポートします。IP アドレスを使用してアクセスを制限することも可能です。デフォルトではローカルマシンへの接続のみが許可されます。SSL を使用すれば、接続の認証だけでなく暗号化も可能です。

Power Pivot でSmartHR テーブルをインポートする

以下のステップに従って、必要に応じて更新もできるテーブルをインポートします。

  1. Excel で「PowerPivot」タブの「PowerPivot Window」アイコンをクリックしてPowerPivot を開きます。
  2. 「Home」->「Get External Data」->「From Data Service」->「From OData Data Feed」とクリックします。

  3. 認証パラメータを追加します。「Advanced」をクリックして「Integrated Security」オプションを「Basic」に設定します。CData API Server にアクセスできるユーザーのユーザーID とパスワードを入力する必要があります。 パスワードをユーザーの認証トークンに設定します。

  4. 「Base URL」ボックスで、CData API Server のOData URL を入力します。例：http://localhost:8032/api.rsc

    The URL of the OData endpoint for the API Server.(Salesforce is shown.)

  5. インポートするテーブルを選択し、「Finish」をクリックします。

    Tables selected in the Table Import Wizard.(Salesforce is shown.)

    6. Power Pivot でSmartHR のデータを操作することが可能になります。

    The Pivot Table that is consuming OData feeds from the API Server.(Salesforce is shown.)

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

詳細はこちら、または無料トライアルにお申し込みください：

CData API Server お問い合わせ

この記事の内容

関連記事