Cornerstone OnDemandをデータパイプラインのソースとして構成する
Cornerstone OnDemandをデータパイプラインのソースとしてセットアップし、学習、トレーニング、ユーザー、および組織データを宛先に抽出して同期します。
このガイドを使用して、Cornerstone OnDemand APIクライアントを登録し、Cornerstone OnDemandをデータパイプラインのソースとして接続し、パイプラインを構成し、サポートされるオブジェクト、同期モード、スキーマ処理、および制限事項を理解します。
サポート対象の Cornerstone OnDemand 機能
Cornerstone OnDemandをパイプラインソースとして使用する場合、次の機能がサポートされます:
- クラウド接続: HTTPS経由でCornerstone OnDemand Data Exporter APIおよびReporting APIに接続します。オンプレミスエージェントは不要です。
- オブジェクトレベルの選択: パイプラインを構成するときに、同期する予定のオブジェクトを選択します。
- 同期モード: Data Exporterオブジェクトはフル同期と増分同期をサポートします。 Reporting APIオブジェクトはフル同期を使用します。詳細については、同期モードを参照してください。
- 削除トラッキング: 次回のフル同期時に、Cornerstone OnDemandで削除されたレコードを宛先でも削除済みとしてマークします。詳細については、削除追跡を参照してください。
- スキーマドリフトの検出と処理: 新しいフィールドを自動同期でスキーマの変更を自動的に検出して適用するか、新しいフィールドをブロックでスキーマを固定します。
- フィールドレベルのデータ保護:データがデスティネーションに到達する前に、機密フィールドをハッシュ化するか、そのままレプリケートします。
- 構成可能な同期頻度: 時間ベースの間隔またはcron式を使用して同期をスケジュールします。サポートされる最小間隔は15分です。
Cornerstone OnDemand の前提条件
Cornerstone OnDemandをデータパイプラインのソースとして接続するには、次の要件を満たす必要があります:
- Cornerstone OnDemandポータル。
- 同期を予定している各オブジェクトに必要なスコープを持つ、Cornerstone OnDemand OAuth 2.0 APIクライアント。セットアップ手順については、Register a Cornerstone OnDemand API clientを参照してください。
必要な権限
Cornerstone OnDemandでは、同期するすべてのオブジェクトに対して個別のreadスコープが必要です。 APIクライアントに対象オブジェクトのスコープがない場合、そのオブジェクトの同期は認可エラーで失敗します。詳細については、Required scopesを参照してください。
Cornerstone OnDemand APIクライアントを登録する
Workatoでコネクションを作成する前に、Cornerstone OnDemandでOAuth 2.0アプリケーションを登録します。すでに、使用する予定のスコープを持つAPIクライアントがある場合は、このセクションをスキップします。
アプリケーションを登録してクライアントIDとクライアントシークレットをコピーする手順については、Cornerstone開発者ドキュメントのRegister an applicationを参照してください。
必須スコープ
アプリケーションを登録するときに次のスコープを選択し、Connect to Cornerstone OnDemand時にはScopesフィールドで同じオブジェクトスコープを選択します。
| スコープ | 目的 |
|---|---|
obj_metadata:read | コネクションを検証し、Data Exporterオブジェクトを一覧表示し、オブジェクトのメタデータを読み取ります。 |
reportingmetadata:view | Reporting APIオブジェクトのメタデータを読み取ります。 |
obj_<object_name>:read | Data Exporterオブジェクトを読み取ります。例えば、users_coreに対してはobj_users_core:readを指定します。同期を予定している各オブジェクトに対してスコープを追加します。 |
<view_name>:read | Reporting APIオブジェクトを読み取ります。例えば、vw_rpt_transaction_cfに対してはvw_rpt_transaction_cf:readを指定します。同期を予定している各Reporting APIオブジェクトに対してスコープを追加します。 |
スコープの完全な一覧については、Cornerstone開発者ドキュメントのScopes, security, and permissionsを参照してください。
サポートされるコネクションタイプ
Cornerstone OnDemandデータパイプラインは、OAuth 2.0クライアントクレデンシャル認証をサポートします:
- OAuth 2.0クライアントクレデンシャル: APIクライアントに付与されたスコープ内のオブジェクトをWorkatoが読み取れるように認可します。セットアップ手順については、Register a Cornerstone OnDemand API clientを参照してください。
Cornerstone OnDemandに接続する
Cornerstone OnDemandに接続
次の手順を完了してCornerstone OnDemandに接続します。
作成 > コネクションを選択するか、Cを2回押します。
Cornerstone OnDemandを検索し、アプリとして選択します。
コネクション名フィールドに名前を入力します。
ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。
Portalフィールドに、Cornerstone OnDemandドメインのポータルプレフィックスを入力します。例えば、ポータルURLがhttps://acme.csod.comの場合は、acmeを入力します。
Regionドロップダウンメニューを使用して、Cornerstone OnDemandポータルがホストされているリージョンを選択します。選択可能なオプション: U.S.、Canada、Europe、United Kingdom、Japan、Singapore、Australia。
Cornerstone OnDemand OAuthアプリケーションのクライアントIDをClient IDフィールドに入力します。
Cornerstone OnDemand OAuthアプリケーションのクライアントシークレットをClient Secretフィールドに入力します。
Scopesドロップダウンメニューを使用して、同期を予定しているオブジェクトのスコープを選択します。コネクションはreportingmetadata:viewおよびobj_metadata:readスコープをリクエストします。各オブジェクトに必要なスコープについては、Required scopesを参照してください。
Cornerstone OnDemand APIの制限により、18個を超えるスコープを選択した場合、Workatoはすべてのスコープをリクエストします。
接続を選択して、コネクションを検証して保存します。コネクションが確立されると、Workatoに成功メッセージが表示されます。
パイプラインの設定
次の手順を完了して、Cornerstone OnDemandをデータパイプラインのソースとして構成します。
作成 > データパイプラインを選択するか、C+Iを押します。
データパイプライン名フィールドにデータパイプラインの名前を入力します。
データパイプライン設定
ロケーションドロップダウンメニューを使用して、データパイプラインを保存するプロジェクトを選択します。
ビルドを開始をクリックします。
Extract new/updated records from source app トリガーをクリックします。このトリガーでは、パイプラインがCornerstone OnDemandからデータを取得する方法を定義します。
ソースアプリから新規/更新済みレコードを抽出トリガーを設定
Your Connected Source Apps ドロップダウンメニューを使用して、Cornerstone OnDemand を選択します。
このパイプラインで使用するCornerstone OnDemandのコネクションを選択します。または、+ 新規コネクションをクリックして、新しいコネクションを作成します。
オブジェクトを追加をクリックして、新しいオブジェクトを追加パネルを開きます。
利用可能なCornerstone OnDemandオブジェクトのリストを検索または参照し、同期を予定しているオブジェクトを選択して、Addをクリックします。
カーソルのないオブジェクトのフル同期
メタデータに_last_touched_dt_utcフィールドが含まれていないオブジェクトは、フル同期のみをサポートします。これにはすべてのReporting APIオブジェクトが含まれ、ラベルの末尾が(RAPI)であることで判別できます。詳細については、サポートされているオブジェクトを参照してください。
選択した各オブジェクトのスキーマを確認してカスタマイズします。パイプラインは、オブジェクトを選択するとそのオブジェクトのスキーマを自動的に取得します。これにより、デスティネーションがソースと一致します。
オブジェクトを展開して、関連フィールドを表示します。使用可能なすべてのデータを抽出するにはすべてのフィールドを選択したままにし、データ抽出とスキーマレプリケーションから除外するには特定のフィールドの選択を解除します。
任意。オブジェクトを展開し、各フィールドの処理方法を選択して、フィールドレベルのデータ保護を設定します。
- そのまま複製: ソースのデータ値が宛先に同一に複製されます。
- ハッシュ: 宛先に同期する前に、フィールド内の機密データ値をハッシュ化します。
Workatoでは、個人を特定できる情報(PII)やその他の機密フィールドをハッシュ化することを推奨します。 PIIが一般的に含まれるフィールドのリストについては、機密データの処理を参照してください。
オブジェクトを追加を再度クリックして、さらにオブジェクトを追加します。この手順を繰り返して、パイプラインにCornerstone OnDemandのオブジェクトをさらに追加します。
スキーマ変更の処理方法を選択ドロップダウンメニューを使用して、スキーマドリフトの処理オプションを選択します。
- 新しいフィールドを自動同期: ソースに追加された新しいフィールドを自動的に検出して同期します。
- 新しいフィールドをブロック: パイプラインの開始後、スキーマを固定します。新しいフィールドは手動で追加する必要があります。このオプションを使用すると、ソーススキーマが更新された場合に宛先が同期されなくなる可能性があります。
詳細については、スキーマのレプリケーションとスキーマドリフトの管理を参照してください。
Cornerstone OnDemandはポータルごとにData Exporterオブジェクトのスキーマを自動更新するため、WorkatoはAuto-sync new fieldsを有効にすることを推奨します。
任意。同時実行制限フィールドに値を入力して、同時実行操作数の上限を設定します。 Cornerstone OnDemandパイプラインは、ここで入力した値に関係なく、同時実行数は最大10オペレーションで実行されます。
Frequency(頻度)フィールドで、標準の時間ベースのスケジュールを選択するか、カスタムcron式を定義します。これにより、パイプラインがCornerstone OnDemandから送信先にデータを同期する頻度が決まります。
履歴開始日
履歴開始日は、フル同期のみをサポートするオブジェクトを含むすべてのData Exporterオブジェクトに適用され、_last_touched_dt_utcフィールドでレコードをフィルタリングします。 Reporting APIオブジェクトは、利用可能なすべてのレコードを抽出します。
サポートされる Cornerstone OnDemand オブジェクト
Cornerstone OnDemandデータパイプラインは、Cornerstone OnDemand Data Exporter APIおよびReporting APIからデータを同期します。各オブジェクトは、宛先内の個別のテーブルとして同期されます。 Delete tracking列には、該当オブジェクトの増分同期の動作が記載されています。これらのオブジェクトがフル同期でどのように削除をトラッキングするかについては、Delete trackingを参照してください。
Data Exporterオブジェクト
パイプラインには、users_core、transcript_core、training_coreなど、ポータルに対してData Exporter APIが返すすべてのオブジェクトが一覧表示されます。これらのオブジェクトがReporting APIビューにどのようにマッピングされるかについては、Normalized Data Exporter objectsを参照してください。
| オブジェクト | 同期モード | 削除追跡 |
|---|---|---|
メタデータに_last_touched_dt_utcフィールドが含まれるData Exporterオブジェクト | 完全同期、増分 | いいえ |
メタデータに_last_touched_dt_utcフィールドが含まれないData Exporterオブジェクト | Full sync | はい |
Reporting APIオブジェクト
Data Exporter APIで公開されていない、または十分にカバーされていないデータについて、パイプラインは次のReporting APIビューを同期します。これらのオブジェクトには_last_touched_dt_utcフィールドがなく、フル同期のみをサポートします。
| オブジェクト | 同期モード | 削除追跡 |
|---|---|---|
vw_rpt_training_unit_key_code | Full sync | はい |
vw_rpt_training_available_language | Full sync | はい |
vw_rpt_training_ilt_session_instructor | Full sync | はい |
vw_rpt_training_schedule | Full sync | はい |
vw_rpt_transaction_cf | Full sync | はい |
vw_rpt_transaction_billing_account | Full sync | はい |
vw_rpt_transaction_credit_card_type | Full sync | はい |
vw_rpt_transaction_custom_field_option_local | Full sync | はい |
vw_rpt_transcript_part_attendance | Full sync | はい |
同期モード
Cornerstone OnDemandデータパイプラインは、フル同期と増分同期をサポートします。パイプラインにオブジェクトを追加するときに、各オブジェクトの同期モードを構成します。
フル同期
フル同期では、選択したオブジェクトの利用可能なすべてのレコードを読み取り、プライマリキーで宛先を更新し、同期で読み取られなかったレコードを削除済みとしてマークします。フル同期のみをサポートするオブジェクトを含む、任意のData Exporterオブジェクトのフル同期は、履歴開始日以降の_last_touched_dt_utc値を持つレコードを読み取ります。 Reporting APIオブジェクトは、実行のたびに利用可能なすべてのレコードを抽出します。
増分同期
増分同期は、前回の正常終了以降に変更されたData Exporterレコードのみを抽出します。パイプラインは、_last_touched_dt_utcフィールドを増分カーソルとして使用します。このフィールドは、レコードがCornerstone OnDemandレポーティングウェアハウスに追加または更新された時点を記録し、Cornerstone OnDemand UIで変更された時点を記録するものではありません。
増分同期で全レコードを読み取るケースについては、Full extract after a Cornerstone OnDemand data reloadを参照してください。
削除追跡
Cornerstone OnDemandは、Data Exporter APIまたはReporting APIを通じて削除済みレコードを公開しません。削除されたレコードはレポーティングウェアハウスから物理的に削除され、_last_touched_dt_utcは削除を記録しません。そのためWorkatoは、フル同期の結果を比較することで削除を推定します。宛先側で推定される削除トラッキングの詳細については、Delete trackingを参照してください。
削除の追跡は同期モードに依存します。
- フル同期のみのオブジェクト: Workatoは、次回のフル同期時にCornerstone OnDemandに存在しなくなったレコードを宛先で削除済みとしてマークします。
- 増分同期対応オブジェクトの増分同期: 削除は検出されません。増分実行では変更されたレコードのみを読み取るため、Cornerstone OnDemandで削除されたレコードは宛先に残ります。
- 増分同期対応オブジェクトのフル同期: Workatoは、フル同期で読み取られなかったレコードを宛先で削除済みとしてマークします。履歴開始日より前に最終更新されたレコードは同期されません。
Cornerstone OnDemandのGDPRデータ削除機能でデータを削除した後は、増分同期を使用しているオブジェクトに対してフル同期を実行し、宛先に削除を反映させます。
スキーマとデータ型の処理
Cornerstone OnDemandからデータを同期する場合、スキーマおよびデータ型について次の点を考慮します。
正規化されたData Exporterオブジェクト
Data Exporterオブジェクトは、外部キーで相互参照する正規化テーブルであり、各Reporting APIビューはこれら複数のテーブルからデータを結合します。宛先側でData Exporterテーブルを結合し、Reporting APIビューを再構築します。例えば、user_ou_pivoted_coreとou_coreを結合して、vw_rpt_user_ou_infoを再構築します。
各Reporting APIビューを構成するData Exporterオブジェクトについては、CornerstoneのRAPI to Data Exporter mappingを参照してください。
データ型
Workatoは、Cornerstone OnDemandフィールドタイプを次のように宛先の型へマッピングします。
| Cornerstone OnDemandのタイプ | 宛先の型 |
|---|---|
Edm.Boolean | ブーリアン |
Edm.Byte、Edm.SByte、Edm.Int16、Edm.Int32 | 整数 |
Edm.Int64 | Long |
Edm.Single、Edm.Double | Double |
Edm.Decimal | 小数 |
Edm.Date | 日付 |
Edm.TimeOfDay | 時刻 |
Edm.DateTime | タイムゾーンなしタイムスタンプ |
Edm.DateTimeOffset | タイムゾーン付きタイムスタンプ |
Edm.Binary | Binary |
| 列挙型、複合型、およびその他すべてのタイプ | 文字列 |
機密データの処理
Cornerstone OnDemandオブジェクトには、従業員の連絡先情報や属性データなどのPIIが含まれる場合があります。次のオブジェクトには、一般的に機密フィールドが含まれています。
| オブジェクト | 機密フィールド |
|---|---|
users_core | user_name_first、user_name_middle、user_name_last、user_email、user_personal_email、user_phone_home、user_phone_mobile、user_phone_work、user_phone_fax、user_birth_dt、user_gender、user_ethnicity、user_login |
ポータルでオブジェクトにどのようなデータを保存しているかによっては、users_cf_coreやvw_rpt_transaction_cfなどのカスタムフィールドオブジェクトにも、PIIやその他の機密データが含まれる場合があります。
パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用し、PIIが宛先に到達する前に保護します。詳細については、パイプラインを構成手順を参照してください。
Cornerstone OnDemand の制限事項
Cornerstone OnDemandをデータパイプラインのソースとして使用する場合、次の制限事項が適用されます。
Cornerstone OnDemandデータリロード後のフル抽出
Cornerstone OnDemandがMaster Data LoadやHistorical Data Loadなどのレポーティングウェアハウスのフルリロードを実行するときは、すべてのレコードの_last_touched_dt_utcをリセットします。その結果、リロード後最初の増分同期は各Data Exporterオブジェクトのすべてのレコードを読み取り、通常よりも時間がかかる可能性があります。
最小同期頻度
サポートされる最小同期間隔は15分です。
最終更新日: