Salesforce Connect で外部Workday オブジェクトを作成・編集する方法
CData Connect AI を使えば、Salesforce のようなクラウドベースのアプリケーションや、Salesforce Mobile App のようなモバイルアプリケーションからWorkday のデータにアクセスできます。この記事では、CData Connect AI とSalesforce Connect を使用して標準のSalesforce オブジェクトとともに外部のWorkday オブジェクトにアクセスします。
Connect AI を構成する
Salesforce Connect でWorkday のデータをリアルタイムで操作するには、Connect AI からWorkday に接続し、コネクションにユーザーアクセスを提供してWorkday のデータのOData エンドポイントを作成する必要があります。
(オプション)新しいConnect AI ユーザーの追加
必要であれば、Connect AI 経由でWorkday に接続するユーザーを作成します。
- ユーザーページに移動し、 Invite Users をクリックします。
- 新しいユーザーのE メールアドレスを入力して、 Send to invite the user をクリックします。
- ユーザーページからユーザーを確認および編集できます。
パーソナルアクセストークンの追加
OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン(PAT)を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。
- Connect AI アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
- User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
- PAT の名前を入力して Create をクリックします。
- パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。
Connect AI からWorkday に接続
CData Connect AI では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。
- Connect AI にログインし、 Add Connection をクリックします。
- Add Connection パネルから「Workday」を選択します。
-
必要な認証プロパティを入力し、Workday に接続します。
Workday 接続プロパティの取得・設定方法
ここでは、4つのWorkday API の接続パラメータを設定する方法、およびTenant とBaseURL を取得する方法について説明します。必要なAPI のパラメータが設定され、カスタムOAuth および / またはAzure AD API クライアントを作成したら、接続の準備は完了です。
接続の前提条件
API / 前提条件 / 接続パラメータ
WQL / WQL サービスを有効化(下記参照) / ConnectionType: WQL
Reports as a Service / カタログレポートの設定(ヘルプドキュメントの「データアクセスのファインチューニング」参照) / ConnectionType: Reports
REST / 自動で有効化 / ConnectionType: REST
SOAP / 自動で有効化 / ヘルプドキュメントのWorkday SOAP API への認証を参照BaseURL およびTenant の取得
BaseURL およびTenant プロパティを取得するため、Workday にログインしてView API Clients を検索します。 この画面では、Workday はBaseURL とTenant の両方を含むURL であるWorkday REST API Endpoint を表示します。
REST API Endpoint のフォーマットは、 https://domain.com/
/mycompany です。ここで、
- https://domain.com(URL のサブディレクトリと会社名の前の部分)はBaseURL です。
- mycompany(URL の最後のスラッシュの後の部分)はTenant です。
例えば、REST API エンドポイントがhttps://wd3-impl-services1.workday.com/ccx/api/v1/mycompany の場合、 BaseURL はhttps://wd3-impl-services1.workday.com であり、Tenant はmycompany です。
WQL サービスを有効化
Workday WQL API を介して接続するには、はじめにWQL Service を有効にする必要があります。- Workday を開きます。
- 検索バーにView Domain と入力します。
- プロンプトにWorkday Query Language と入力します。
- Allowed Security Group Types のいずれかに、接続するユーザーが含まれていることを確認します。
Workday への認証
Basic 認証以外のほとんどのWorkday 接続では、認証のためにOAuth ベースのカスタムAPI クライアントアプリケーションを作成する必要があります。これには、ユーザーがAzure AD 資格情報を介して接続するエンタープライズインストールも含まれます。 Workday への認証につての詳細は、ヘルプドキュメントの「Workday への認証」セクションを参照してください。
- Create & Test をクリックします。
- Edit Workday Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
Connect AI にWorkday OData エンドポイントを追加する
Workday に接続したら、目的のテーブルのOData エンドポイントを作成します。
- OData ページに移動し、 Add to create new OData endpoints をクリックします。
- Workday 接続(例:Workday1)を選択し、Next をクリックします。
- 使用するテーブルを選択し、Confirm をクリックします。
コネクションとOData エンドポイントを設定したら、Salesforce Connect からWorkday のデータに接続できます。
外部データソースとしてWorkday のデータに接続する
以下のステップに従って、Connect AI に生成されたフィードに接続します。
- Salesforce にログインし、「Setup」->「Integrations」->「External Data Sources」とクリックします。
- 「New External Data Source」をクリックします。
- 以下のプロパティに値を入力します。
- External Data Sources:リストビューおよびレポートで使用するラベルを入力します。
- Name:個別の識別子を入力します。
- Type:「Salesforce Connect: OData 4.0」オプションを選択します。
- URL:Connect AI OData エンドポイントのURL(https://cloud.cdata.com/api/odata/service) を入力します。
- 「Writable External Objects」オプションを選択します。
- 「Format」メニューから「JSON」を選択します。
- 「Authentication」セクションでは、以下のプロパティを設定します。
- Identity Type:組織のすべてのメンバーが同じ認証情報を使用してConnect AI にアクセスする場合は、「Named Principal」を選択します。 各自の認証情報で接続する場合は、「Per User」を選択します。
- Authentication Protocol:基本認証を使用するには、「Password Authentication」を選択します。
- Certificate:Salesforce からサーバーへの通信を暗号化および認証するために使用する証明書を入力または参照します。
- Username:Connect AI のユーザー名を入力します。(例:user@mydomain.com)
- Password:ユーザーのPAT を入力します。
Workday オブジェクトを同期する
外部データソースを作成したら、以下のステップに従って、データソースへの変更を反映するWorkday 外部オブジェクトを作成します。Workday 外部オブジェクトの定義をWorkday テーブルの定義と同期します。
- 作成した外部データソースのリンクをクリックします。
- 「Validate and Scan」をクリックします。
- 外部オブジェクトとして使用するWorkday テーブルを選択します。
Workday のデータにSalesforce オブジェクトとしてアクセスする
Workday のデータを外部データソースとして追加し、Workday テーブルを外部オブジェクトとして同期すると、標準のSalesforce オブジェクトと同じように外部Workday オブジェクトを使用できるようになります。
-
フィルタリストビューを使用して新しいタブを作成します。
-
外部オブジェクトのレポートを作成します。
-
Salesforce ダッシュボードから、Workday オブジェクトを作成、アップデート、および削除します。
クラウドアプリケーションからWorkday のデータへのアクセスを簡単に
これで、Salesforce からWorkday のデータへリアルタイムでクラウドベースの接続が可能です。Salesforce のようなクラウドアプリケーションから簡単に100を超えるSaaS、ビッグデータ、NoSQL ソースのデータにアクセスする方法の詳細については、Connect AI ページを参照してください。