-
Customer Experience -
Employee Experience -
Brand Experience -
Core XM -
Design XM
SuccessFactors からの従業員データ抽出タスク
SuccessFactors からの社員データ抽出について
SuccessFactors からの社員データ抽出タスク
により、SuccessFactors からの社員データのエクスポートが自動化されます。設定した定期的なスケジュールで、コア社員データ (名前、電子メール、一意の ID)、社員のメタデータ (性別、役割、部署など)、および組織階層データ (マネージャー、事業所) をインポートすることができます。Qualtricsにインポートしたデータは、データローダータスク（通常はユーザを EXディレクトリにロードするタスク）を使用して保存する必要があります。
SuccessFactors からの従業員データ抽出タスクの設定
- 左上隅のナビゲーションメニューをクリックします。
![[ワークフロー] ページで、[ワークフローを作成] をクリックし、特定の時刻に開始する](https://www.qualtrics.com/m/assets/support/wp-content/uploads//2023/01/scheduled-workflow-global-1-4.png)
- ワークフローを選択します。
- [ワークフローを作成] をクリックします。
- ワークフローを スケジュール済 と イベントベース のどちらにするかを決定します。これらのオプションの比較については、「 スケジュールされたワークフローとイベントベースのワークフロー 」を参照してください。
ヒント：通常は、社員データが定期的に更新されるように、スケジュールされたワークフローを使用することをお勧めします。
- 必要に応じて、上部にあるワークフロー名をクリックしてワークフロー名を変更します。
- ワークフローを実行するタイミング (スケジュールされたワークフローの場合) またはワークフローをトリガするイベント (イベントベースワークフローの場合) を決定します。
- プラス記号 ( + ) をクリックし、 タスク を選択します。
- Extract employee data from SuccessFactors を選択します。
- 使用する SuccessFactors アカウントを選択します。
![使用するアカウントを選択するか、[ユーザーアカウントの追加] をクリックします。](https://www.qualtrics.com/m/assets/support/wp-content/uploads//2021/03/SuccessFactors_ChooseAccountUIUpdate.png)
- 使用する新しい SuccessFactors アカウントを追加する場合は、[Add new user account] をクリックします。
ヒント：［新しいユーザーアカウントを追加］をクリックすると、SuccessFactorsアカウント情報を入力するよう指示されます。必要なフィールドを見つけるには、SuccessFactors アカウント情報の検索を参照してください。
- [次へ] をクリックします。
- 4 つのフィールドが自動的にマッピングされます。これらのフィールドはコア社員データフィールドに対応しており、通常 Qualtrics にインポートされます。これらのフィールドは、従業員の名、姓、メールアドレス、および一意の ID です。必要に応じて、マッピングからこれらの項目を削除することができます。
- インポートするフィールドを追加するには、[フィールドの追加] をクリックします。
ヒント：クアルトリクスプラットフォームでは、SuccessFactorsからの個々の参加者に対する複数の雇用はサポートされません。フィールドに複数の値がある場合、抽出機能では、SuccessFactors で示される “isPrimary” フラグを使用して値が取得されます。現在、その他の値の選択はサポートされていません。また、SuccessFactors で同じ社員に対して複数のレコードがある場合は、Basic Transform タスクを使用して、主要な雇用ではない値を除外する必要があります。
- フィールドボックスをクリックし、一覧から選択して、SuccessFactors フィールドを選択します。フィールド名を入力して、より迅速に検索することもできます。フィールド名 (利用可能な場合、「性別」など) または SuccessFactors 内のフィールドパス (personal_information/birth_name など) で検索することができます。
ヒント：カスタムフィールドは、適切な SuccessFactors フィールド名（personal_information/custom_fieldname など）を入力してインポートできます。入力するとカスタムフィールドは検索結果に表示されません。
- 項目を削除するには、項目の右側にあるマイナス符号 ( – ) をクリックします。
- [次へ] をクリックします。
- プレビューが表示され、選択した各フィールドのインポート内容の例が示されます。
- プレビューが [OK] と表示される場合は、[保存] をクリックします。フィールドを変更する必要がある場合は、代わりに [戻る] ボタンをクリックします。
SuccessFactors のタスクを設定
した後、データローダタスクとともにデータを保存する場所を Qualtrics に指示する必要があります。通常、これは EX ディレクトリへのユーザーのロードタスクです。
SuccessFactors アカウント情報の検索
[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 からのメッセージに記載されています。
既知の理由:
このエラーを解決するには、認証情報が正しくなるように更新します。詳細については、OAuth 認証情報を使用した SuccessFactors タスクの設定を参照してください。 |
| プレビューレコードの取得中に SuccessFactors からエラーが発生しました: {{SuccessFactors からのエラー}}。 | SuccessFactors からの OData API 呼出でエラーが発生しました。具体的な理由は、SuccessFactors からのメッセージに記載されています。このエラーは、プロパティが見つからないために発生します。
このエラーを解決する方法の詳細については、下の「プロパティが見つかりません」サブセクションを参照してください。 |
| SuccessFactorsからプレビューレコードを取得する際に、予期しない内部エラーが発生しました。 | クアルトリクス側の内部エラー。クアルトリクスサポートにお問い合わせください。 |
プロパティが見つかりません
カスタム SuccessFactors フィールドをインポートする場合、フィールドドロップダウンで形式を検証することはできません。インポートのプレビュー時にで予期しないエラー (“無効なプロパティ名” など) が発生した場合は、SuccessFactors でフィールドパスが正しいことを確認してください。
フィールドを検索するには、SuccessFactors の管理センターに移動し、OData API データ辞書に移動します。
ここから Entity タブに移動し、追加する項目を検索します。フィールドが存在し、Qualtrics Extract Employee Data from SuccessFactors タスクで追加したものとフィールドパスが一致していることを確認します。一般的に、”PerPerson” は正しいフィールドパスを見つけるために開始するベースエンティティです。フィールドパスが正しく、それでもエラーが発生する場合は、SuccessFactors サポートに連絡してサポートを依頼してください。