Qualtrics Platform
Customer Journey Optimizer
XM Discover
Qualtrics Social Connect

SuccessFactors からの従業員データ抽出タスク

SuccessFactors からの社員データ抽出について

SuccessFactors からの社員データ抽出タスク
により、SuccessFactors からの社員データのエクスポートが自動化されます。設定した定期的なスケジュールで、コア社員データ (名前、電子メール、一意の ID)、社員のメタデータ (性別、役割、部署など)、および組織階層データ (マネージャー、事業所) をインポートすることができます。Qualtricsにインポートしたデータは、データローダータスク（通常はユーザを EXディレクトリにロードするタスク）を使用して保存する必要があります。

SuccessFactors からの従業員データ抽出タスクの設定

ヒント：このタスクでは、SuccessFactors からブール型フィールドと文字列型フィールドのみをインポートできます。

ETL ワークフローを作成します。
データソース (ETL 抽出機能) を選択します。
Extract employee data from SuccessFactors を選択します。
使用する SuccessFactors アカウントを選択します。
使用する新しい SuccessFactors アカウントを追加する場合は、[Add new user account] をクリックします。
ヒント：［新しいユーザーアカウントを追加］をクリックすると、SuccessFactorsアカウント情報を入力するよう指示されます。必要なフィールドを見つけるには、SuccessFactors アカウント情報の検索を参照してください。
[次へ] をクリックします。
4 つのフィールドが自動的にマッピングされます。これらのフィールドはコア社員データフィールドに対応しており、通常 Qualtrics にインポートされます。これらのフィールドは、従業員の名、姓、メールアドレス、および一意の ID です。必要に応じて、マッピングからこれらの項目を削除することができます。
インポートするフィールドを追加するには、[フィールドの追加] をクリックします。
ヒント：クアルトリクスプラットフォームでは、SuccessFactorsからの個々の参加者に対する複数の雇用はサポートされません。フィールドに複数の値がある場合、抽出器は最も最近更新された値を取り出します。現在、その他の値の選択はサポートされていません。また、SuccessFactors で同じ社員に対して複数のレコードがある場合は、Basic Transform タスクを使用して、主要な雇用ではない値を除外する必要があります。
フィールドボックスをクリックし、一覧から選択して、SuccessFactors フィールドを選択します。フィールド名を入力して、より迅速に検索することもできます。フィールド名 (利用可能な場合、「性別」など) または SuccessFactors 内のフィールドパス (personal_information/birth_name など) で検索することができます。
ヒント：カスタムフィールドは、適切な SuccessFactors フィールド名（personal_information/custom_fieldname など）を入力してインポートできます。入力するとカスタムフィールドは検索結果に表示されません。カスタムフィールドには、インポートする “lastModifiedDateTime” サブフィールドが必要です。
項目を削除するには、項目の右側にあるマイナス符号 ( – ) をクリックします。
[次へ] をクリックします。
プレビューが表示され、選択した各フィールドのインポート内容の例が示されます。
プレビューが [OK] と表示される場合は、[保存] をクリックします。フィールドを変更する必要がある場合は、代わりに [戻る] ボタンをクリックします。

SuccessFactors のタスクを設定
した後、データローダタスクとともにデータを保存する場所を Qualtrics に指示する必要があります。通常、これは EX ディレクトリへのユーザーのロードタスクです。

ヒント：データをデータローダータスクに送信する前に、基本的なトランスフォームタスクで実行することをお勧めします。これにより、ローダタスクで簡単にマッピングできるように、フィールドの書式が適切であることを確認できます。

ヒント：ライブのEXディレクトリに影響を与えずにワークフローをテストする場合は、代わりにデータプロジェクトタスクへのロードを使用できます。これにより、EXディレクトリに社員を追加する前に、ワークフローをテストして、すべてのフィールドが正しくインポートされていることを確認できます。

SuccessFactors アカウント情報の検索

警告: 以前のワークフローでは、認証に API キーまたは X.509 証明書が必要ありませんでした。2022 年 5 月までに、SuccessFactors からデータを抽出するすべてのワークフローで API キーおよび X.509 証明書が認証に使用されていることを確認する必要があります。この認証の設定方法については、ここを参照してください。この変更に先立って、お客様に連絡いたします。

[Add new user account]
をクリックすると、SuccessFactors からの OAuth 認証情報を入力するための画面が表示されます。設定に必要な前提条件情報については、「Configuring SuccessFactors Tasks with OAuth Credentials」ページを参照してください。

名前：これは、アカウントに付けるラベルです。このフィールドは、認証には使用されません。
ユーザ名: SAP ユーザ ID。
警告: ユーザ名と SAP ユーザ ID が異なる可能性があります。ユーザ ID では大文字と小文字が区別されます。
API キー、X.509 証明書秘密鍵: X.509 証明書認証により、データ保護の追加レイヤがデータに追加されます。この証明書を使用して OAuth クライアントを登録すると、API キーも生成されます。
ヒント：証明書と秘密鍵を生成するには、2つのオプションがあります。独自の証明書および秘密鍵を生成するか、または SAP には SuccessFactors からダウンロードできる OAuth2 クライアントアプリケーションの登録時に生成するオプションがあります。プライベートキーを生成する場合は、PKCS8 形式にする必要があります。詳細については、SAP の文書を参照してください。

このプロセスの詳細については、以下の SAP 文書を参照してください。

- OAuth2 クライアントアプリケーションの登録
- SAP SuccessFactors での X.509 証明書の作成
- SAML アサーションの生成
- アクセストークンの要求
- アクセストークンの有効期間の表示
  ヒント：このリストの最後の 3 つのドキュメントは、SuccessFactors 管理ユーザー、または OAuth インテグレーションを作成する権限を持つその他のユーザーを対象としています。証明書認証に関する追加のヘルプについては、SuccessFactors サポートに連絡してください。
データセンターのドメイン：SuccessFactors ドメイン。
ヒント：URLにhttp:// を含めないでください。
会社 ID: SuccessFactors 会社 ID。

SuccessFactors のログインページに、次のフィールドの一部が表示されます。

[ユーザー名] が [ユーザー名] フィールドに入力されます。
警告: ユーザ名と SAP ユーザ ID が異なる可能性があります。ユーザ ID では大文字と小文字が区別されます。
ログインフィールドの上に会社 ID が表示されます。
例: 会社 ID の例は BenefitsSB です。
SuccessFactors にログインすると、URL にデータセンタードメインが表示されます。
ヒント：URLにhttp:// を含めないでください。

例: データセンタードメインの例は apisalesdemo4.successfactors.com です。

SuccessFactors 情報へのアクセスについてサポート
が必要な場合は、OAuth 認証情報を使用した SuccessFactors タスクの設定ページを参照するか、SuccessFactors サポートに連絡してください。

SuccessFactors タスクのトラブルシューティング

ワークフローのトラブルシューティング
を行うには、ワークフローレポートに移動し、ワークフローの出力を表示します。ワークフローが失敗した場合、失敗した理由に関する情報が含まれます。

不正なアカウント認証情報

OAuth 認証情報を使用した SuccessFactors タスクの設定を参照してください。

インポートされた項目が空白です

SuccessFactors から社員データを抽出するタスクでは、SuccessFactors アカウントに関連付けられているすべての非カスタムフィールドが表示されますが、タスクで選択されたフィールドに SuccessFactors のそれに関連する情報が含まれていない可能性があります。選択したフィールドのパスが SuccessFactors の入力済みフィールドと一致していることを確認します。一部のフィールド名は、SuccessFactors 内の複数の場所に関連付けられている場合があります。たとえば、”/personal_information/created_by” と “address_information/created_by” は異なるフィールドです。

共通項目エラー

次の表に、一般的なエラーとその解決方法を示します。これらのエラーは、SuccessFactors からの社員データ抽出タスクでインポートされたデータをプレビューすると表示されます。

エラーメッセージ	解像度
プレビューレコードリクエストは正常に実行されましたが、受信した結果は0件でした。	ゼロレコードが返される理由については、SuccessFactors サポートにお問い合わせください。
応答からフィールドパス {{Field Path Here}} を解析できません。フィールドパスはブール型または文字列型にしてください。	これは、プレビューレコードでフィールドパスがブール型または文字列型ではなかったことを示す警告メッセージです。 SuccessFactors の ODATA 辞書でフィールドタイプを確認します。
SuccessFactors から OAuth トークンを取得中にエラーが発生しました: {{SuccessFactors からのエラー}}。	OAuth トークンの要求時に認証情報エラーが発生しました。具体的な理由は、SuccessFactors からのメッセージに記載されています。既知の理由: 不適切なドメイン無効な API キー秘密鍵と API キーの不一致ユーザー名が無効ですこのエラーを解決するには、認証情報が正しくなるように更新します。詳細については、OAuth 認証情報を使用した SuccessFactors タスクの設定を参照してください。
プレビューレコードの取得中に SuccessFactors からエラーが発生しました: {{SuccessFactors からのエラー}}。	SuccessFactors からの OData API 呼出でエラーが発生しました。具体的な理由は、SuccessFactors からのメッセージに記載されています。このエラーは、プロパティが見つからないために発生します。このエラーを解決する方法の詳細については、下の「プロパティが見つかりません」サブセクションを参照してください。
SuccessFactorsからプレビューレコードを取得する際に、予期しない内部エラーが発生しました。	クアルトリクス側の内部エラー。クアルトリクスサポートにお問い合わせください。

プロパティが見つかりません

カスタム SuccessFactors フィールドをインポートする場合、フィールドドロップダウンで形式を検証することはできません。インポートのプレビュー時にで予期しないエラー (“無効なプロパティ名” など) が発生した場合は、SuccessFactors でフィールドパスが正しいことを確認してください。

フィールドを検索するには、SuccessFactors の管理センターに移動し、OData API データ辞書に移動します。

ここから Entity タブに移動し、追加する項目を検索します。フィールドが存在し、Qualtrics Extract Employee Data from SuccessFactors タスクで追加したものとフィールドパスが一致していることを確認します。一般的に、”PerPerson” は正しいフィールドパスを見つけるために開始するベースエンティティです。フィールドパスが正しく、それでもエラーが発生する場合は、SuccessFactors サポートに連絡してサポートを依頼してください。