Appsmith で SAP SuccessFactors 連携アプリケーションを作成

Cameron Leblanc
Cameron Leblanc
Technology Evangelist
Appsmith でCData Connect AI を介して SAP SuccessFactors のデータ に接続し、SAP SuccessFactors のデータ にリアルタイムでアクセスできるカスタムビジネスアプリケーションを作成。

Appsmith は、チームがビジネスオペレーションを改善するためのUI を素早く簡単に構築できる、オープンソースの内部ツールビルダーです。CData Connect AI と組み合わせることで、ビジネスアプリケーションから SAP SuccessFactors のデータ に即座にアクセスできるようになります。この記事では、Connect AI を使用して SAP SuccessFactors に接続し、Appsmith で SAP SuccessFactors のデータ から基本的なアプリケーションを作成するプロセスを説明します。

CData Connect AI は、SAP SuccessFactors への純粋なSQL Server のクラウドtoクラウドインターフェースを提供し、Appsmith 内からライブ SAP SuccessFactors のデータ を直接使用してビジネスアプリケーションを作成できます。ネイティブデータベースへのデータレプリケーションは必要ありません。アプリケーションを構築する際、Appsmith はデータを収集するためのSQL クエリを生成します。CData Connect AI は、最適化されたデータ処理機能により、フィルタやJOIN を含むすべてのサポートされるSQL オペレーションを SAP SuccessFactors に直接送信します。これにより、サーバーサイドの処理を活用して、リクエストされた SAP SuccessFactors のデータ を迅速に取得できます。

Appsmith 用に SAP SuccessFactors への接続を構成

Appsmith から SAP SuccessFactors への接続は、CData Connect AI を介して行います。Appsmith から SAP SuccessFactors のデータ を操作するには、まず SAP SuccessFactors 接続を作成して構成します。

  1. Connect AI にログインし、Sources をクリックして、 Add Connection をクリックします
  2. Add Connection パネルから「SAP SuccessFactors」を選択します
  3. SAP SuccessFactors に接続するために必要な認証プロパティを入力します。

    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 プロセスを完了します。

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

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

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

  4. Save & Test をクリックします
  5. Add SAP SuccessFactors Connection ページのPermissions タブに移動し、User-based permissions を更新します。

パーソナルアクセストークンの追加

REST API、OData API、またはVirtual SQL Server を介してConnect AI に接続する場合、パーソナルアクセストークン（PAT）を使用してConnect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。

  1. Connect AI アプリの右上にある歯車アイコン（）をクリックして、設定ページを開きます。
  2. 設定ページで、Access Tokens セクションに移動し、 Create PAT をクリックします。
  3. PAT に名前を付けて、Create をクリックします。
  4. パーソナルアクセストークンは作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。

接続が構成され、PAT が生成されたので、Appsmith から SAP SuccessFactors のデータ に接続する準備が整いました。

ライブ SAP SuccessFactors のデータ からAppsmith アプリケーションを作成

Appsmith からCData Connect AI Virtual SQL Server への接続を確立するには、以下の手順に従います。

Appsmith で SAP SuccessFactors に接続

  1. Appsmith インスタンスにログインし、新しいアプリケーションを作成します。
  2. 新しいアプリケーションで、Data ページを開き、Bring your data を選択します。
  3. このページで、Microsoft SQL Server を検索し、データソースとして選択します。
  4. 新しいデータソースの名前を入力し、以下の接続設定を入力します。
    • Host address: tds.cdata.com
    • Port: 14333
    • Database name: 接続するCData Connect AI データソースの接続名を入力します（例：SAPSuccessFactors1）。
    • Username: CData Connect AI のユーザー名を入力します。これはCData Connect AI インターフェースの右上に表示されます。例：test@cdata.com。
    • Password: 先ほど生成したPAT を入力します。
  5. Test configuration をクリックして接続が成功したことを確認し、Save をクリックしてデータソースを保存します。

新しいクエリを作成

データソースへの接続を構成したら、SQL クエリを追加してデータソースから実際にデータを取得します。

  1. 新しいデータソースの画面で、New Query をクリックします。
  2. クエリエディタが開き、データを選択するSQL クエリを入力できます。SQL クエリの指定については、CData Connect AI のExplorer を使用して、SQL クエリと取得するデータをプレビューできます。
  3. SQL クエリを作成したら、Appsmith のクエリエディタに戻り、SQL クエリを入力してRun をクリックします。
  4. クエリが正常に実行されたら、あとは取得したデータを表示するためのページをセットアップするだけです。

SAP SuccessFactors のデータ を表示

  1. UI タブを開き、New UI element をクリックします。
  2. 新しいUI 要素を選択し、ページ上にドラッグアンドドロップします。
  3. 新しいUI 要素でConnect data をクリックし、先ほど作成したクエリを選択します。
  4. データが接続されると、UI 要素にデータが表示されます。

アプリケーションをデプロイ

SAP SuccessFactors のデータ がアプリケーションのUI 要素に接続されたら、アプリケーションをデプロイできます。Appsmith の右上にあるDeploy をクリックすると、SAP SuccessFactors のデータ を表示するアプリケーションが別ウィンドウで開きます。

CData Connect AI の入手

クラウドアプリケーションから300以上のSaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、CData Connect AI をお試しください。

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

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル お問い合わせ

この記事の内容

関連記事