OutSystems でSAP SuccessFactors に接続されたエンタープライズアプリケーションを作成
OutSystems は、企業がオムニチャネルのエンタープライズアプリケーションを開発、展開、管理するためのツールを提供するローコードプラットフォームです。CData Connect AI と組み合わせると、ビジネスアプリケーション用にSAP SuccessFactors のデータにクラウド上でアクセスできます。この記事では、Connect AI にSAP SuccessFactors の仮想データベースを作成し、OutSystems でSAP SuccessFactors のデータから単純なアプリを構築する方法を説明します。
Connect AI からSAP SuccessFactors に接続する
CData Connect AI は直感的なクリック操作ベースのインターフェースを使ってデータソースに接続します。- Connect AI にログインし、 Add Connection をクリックします。
- Add Connection パネルから「SAP SuccessFactors」を選択します。
-
必要な認証情報を入力し、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 プロセスを完了します。
- CData 製品がSAP SuccessFactors からアクセストークンを取得し、それを使ってデータをリクエストします
- OAuth 値はOAuthSettingsLocation で指定されたパスに保存されます。これらの値は接続間で永続化されます
アクセストークンの期限が切れた際は、CData 製品が自動でアクセストークンをリフレッシュします。
カスタムOAuth アプリケーションの作成やその他の認証方法については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」をご確認ください。
- Create & Test をクリックします。
- Add SAP SuccessFactors Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
パーソナルアクセストークンを追加する
OAuth 認証をサポートしないサービス、アプリケーション、プラットフォーム、フレームワークから接続する場合、パーソナルアクセストークン(Personal Access Token, PAT)を認証に使用できます。きめ細かくアクセスを管理するために、サービスごとに個別のPAT を作成するのがベストプラクティスです。
- User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
- PAT の名前を入力して Create をクリックします。
- パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。
コネクションが構成されたら、OutSystems からSAP SuccessFactors に接続できるようになります。
OutSystems からSAP SuccessFactors に接続する
以下のステップでは、OutSystems からCData Connect AI に接続して新しいSAP SuccessFactors のデータベース接続を作成する方法の概要を説明します。
- OutSystems Service Studio を開きます。
- 歯車アイコン をクリックし、Service Center のEnvironment Management を開きます。
- Administration をクリックして「Database Connections」を選択します。
- 「New Database Connection」をクリックします。
- データベース接続を設定します。
- Name:接続の名称(例:CData Connect AI SAP SuccessFactors)
- DBMS:SQL Server またはAzure SQL
- Username:Connect AI ユーザー(例:user@mydomain.com)
- Password:Connect AI ユーザーのPAT
- Server:tds.cdata.com,14333
- Schema:SAP SuccessFactors コネクションの名前(例: SAPSuccessFactors1)
- 「Test Connection」をクリックします。
- 「Create」をクリックします。
SAP SuccessFactors テーブルまたはビューを拡張モジュールのエンティティにマップする
SAP SuccessFactors のデータベース接続を作成したら、テーブルまたはビューをOutSystems のエンティティにマップする拡張機能を作成できます。作成していない場合は、Service Studio でアプリケーションを作成します。
- Service Studio を開き、既存のアプリケーションを開きます。
- 「Add Module」をクリックし、「Module Name」(例:sapsuccessfactors_db_extension)を設定し、「Module Type」を「Extension」に設定して、「Create Module」をクリックします。
- Integration Studio で、環境に接続します。
- 拡張ツリーで「Entities」を右クリックし、「Connect to External Table or View...」を選択します。
- ウィザードのステップに従って、使用するテーブルおよびビューを選択します。
- Integration Studio で「1-Click Publish」をクリックします。
- 「1-Click Publish」ウィザードでプロセスが完了したら、「Configure」をクリックします。
- Service Center で、拡張機能の論理データベース名を、拡張機能が使用するデータベース接続に関連付け、「Apply」をクリックします。
- Service Center で、拡張機能の論理データベース名を、拡張機能が使用するデータベース接続に関連付け、「Apply」をクリックします。
- アプリケーションで「Manage Dependencies...」をクリックします。
- 拡張機能に依存関係を追加し、アプリケーションで使用するエンティティを選択します。
これで、標準のOutSystems エンティティと同じように、SAP SuccessFactors のデータにアクセスして操作できます。
詳細と無償トライアル
Connect AI とOutSystems を使用すると、SAP SuccessFactors に接続されたアプリケーションを簡単に構築できます。今すぐOutSystems のSAP SuccessFactors のデータで作業を開始するには、Connect AI の無償トライアルにサインアップしてください。