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

スイート

Employee Experience

製品

Qualtrics

このページの内容

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

SuccessFactorsからの従業員データの抽出タスクは、SuccessFactorsからの従業員データのエクスポートを自動化します。従業員のコアデータ（名前、Eメール、一意の識別子）、従業員メタデータ（性別、役割、部署など）、組織階層データ（マネージャー、所在地）を、設定した定期的なスケジュールでインポートできます。データをクアルトリクスにインポートした後、データローダタスク（通常はload users into EX directoryタスク）を使って保存する必要があります。

Qtip:ETLワークフローに適用される一般的な制限については、ワークフローの制限を参照してください。タスク固有の制限については、このページの情報を参照のこと。

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

Qtip:このタスクはSuccessFactorsからBooleanフィールドとStringフィールドのみをインポートできます。

ETLワークフローを作成する。

データソース（ETL抽出器）を選択します。

SuccessFactorsから従業員データを抽出する］を選択します。

使用するSuccessFactorsアカウントを選択します。

使用する新しいSuccessFactorsアカウントを追加する場合は、Add new user accountをクリックします。

Qtip:Add new user accountをクリックすると、SuccessFactorsのアカウント情報を入力する画面が表示されます。必須フィールドの見つけ方については、SuccessFactorsアカウント情報の見つけ方を参照してください。

［次へ］をクリックします。

4つのフィールドが自動的にマッピングされます。これらの現場フィールドは、中核となる従業員データフィールドに対応し、クアルトリクスに一般的にインポートされます。これらのフィールド名は、従業員の姓、名、電子メールアドレス、および一意の識別子です。必要であれば、マッピングからこれらのフィールドを削除することができます。

インポートするフィールドを追加するには、Add Fieldをクリックします。

Qtip: クアトリクスのプラットフォームは、SuccessFactorsからの参加者個人の複数雇用をサポートしていません。フィールドに複数の値がある場合、抽出器は最も最近更新された値を取り出します。現在のところ、それ以外の値の選択はサポートしていない。さらに、SuccessFactorsに同じ従業員の複数のレコードがある場合、Basic Transformタスクを使用して、主雇用でない値をフィルターする必要があります。

フィールドボックスをクリックしてリストから選択し、SuccessFactorsフィールドを選択します。また、フィールド名を入力することで、より素早く見つけることができます。フィールド名（利用可能な場合、例：「Gender」）またはSuccessFactors内のフィールドパス（例：personal_information/birth_name）で検索できます。

Qtip:カスタムフィールドは、適切なSuccessFactorsフィールド名（personal_information/custom_fieldnameなど）を入力することでインポートできます。カスタムフィールドは検索結果に表示されません。カスタムフィールドをインポートするには、”lastModifiedDateTime “サブフィールドが必要です。

フィールドを削除するには、フィールドの右にあるマイナス記号（–）をクリックします。

［次へ］をクリックします。

プレビューが表示され、選択した各フィールドのインポート例が表示されます。

プレビューに問題がなければ、「保存」をクリックします。フィールドの変更が必要な場合は、［戻る］ボタンをクリックしてください。

SuccessFactorsタスクの設定後、データローダータスクでクアルトリクスにデータの保存先を伝える必要があります。通常、これはEXディレクトリにユーザーをロードするタスクである。

Qtip:データローダータスクにデータを送る前に、基本的な変換タスクにデータを通すことをお勧めします。これにより、ローダータスクで簡単にマッピングできるように、フィールドが正しいフォーマットになっていることを確認できます。

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

SuccessFactorsアカウント情報の検索

警告: 以前のワークフローでは、認証にAPIキーまたはX.509証明書を必要としませんでした。2022年5月までに、SuccessFactorsからデータを抽出するすべてのワークフローが、認証にAPIキーとX.509証明書を使用していることを確認する必要があります。この認証機能の設定方法については、こちらをご覧ください。この変更については、事前にお客様にコミュニケーションをお送りします。

Add new user accountをクリックすると、SuccessFactorsのOAuth認証情報を入力する画面が表示されます。セットアップに必要な前提条件については、OAuth資格情報を使用したSuccessFactorsタスクの設定ページを参照してください。

名前：アカウントに付けるラベルです。このフィールドは認証には使用されない。
ユーザー名: SAPユーザーID。
警告: ユーザー名と SAP ユーザー ID が異なる場合があります。ユーザーIDは大文字と小文字を区別します。
APIキー、X.509証明書の秘密鍵： X.509証明書認証機能により、データの保護レイヤーが追加されます。この証明書を使用してOauthクライアントを登録すると、APIキーも生成されます。
Qtip: 証明書と秘密鍵の生成には2つのオプションがあります。自分で証明書と秘密鍵を生成することもできますが、SAPにはOAuth2クライアントアプリケーションを登録する際に生成するオプションがあります。秘密鍵を生成する場合は、PKCS8形式でなければならない。詳しくはSAPのドキュメントをご覧ください。

このプロセスの詳細については、以下のSAPドキュメントを参照してください：

- OAuth2クライアントアプリケーションの登録
- SAP SuccessFactors での X.509 証明書の作成
- SAML アサーションの生成
- アクセシビリティトークンのリクエスト
- アクセストークンの検証
  Qtip:このリストの最後の3つのドキュメントは、SuccessFactorsの管理者ユーザー、またはOAuth統合を作成する権限を持つその他のユーザーを対象としています。証明書認証に関するその他のヘルプについては、SuccessFactors サポートに連絡してください。
データセンタードメイン：お客様のSuccessFactorsドメイン。
Qtip:URLにhttp:// を含めないでください。
企業ID：サクセスファクターズの企業ID。

これらのフィールドのいくつかは、SuccessFactorsのログインページにあります：

ユーザー名フィールドにユーザー名を入力します。

警告: ユーザー名と SAP ユーザー ID が異なる場合があります。ユーザーIDは大文字と小文字を区別します。

あなたの会社IDはログインフィールドの上に表示されます。

例: 企業 ID の例はBenefitsSB です。

データセンターのドメインは、SuccessFactorsにログインすると、URLで確認できます。

Qtip:URLにhttp:// を含めないでください。

例: データセンター・ドメインの例は、apisalesdemo4.successfactors.comである。

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

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

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

不正なアカウント情報

OAuth資格情報を使用したSuccessFactorsタスクの構成」を参照してください。

インポートされたフィールドが空白

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

よくあるフィールドエラー

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

エラーメッセージ	解像度
プレビューレコードリクエストは正常に実行されましたが、受信した結果は0件でした。	ゼロレコードが返される理由については、SuccessFactorsサポートに連絡先があります。
応答からフィールド・パス {{Field Path Here}} を解析できません。フィールドパスはbooleanまたはstringタイプでなければならない。	これは、プレビュー・レコードのフィールド・パスが Boolean または String ではないことを示す警告メッセージです。 SuccessFactorsのODATA Dictionaryでフィールドタイプを確認します。
SuccessFactors から OAuth トークンを取得中にエラーが発生しました：{SuccessFactorsからのエラー}}。	OAuth トークンのリクエスト時にクレデンシャルエラーが発生しました。具体的な理由は、サクセスファクターズからのメッセージに記載されています。理由はわかっている：ドメイン違い無効なAPIキープライベートキーとAPIキーの不一致無効なユーザー名このエラーを解決するには、認証情報を正しく更新してください。詳細については、「OAuth資格情報を使用したSuccessFactorsタスクの構成」を参照してください。
プレビューレコードの取得中にSuccessFactorsからエラーが発生しました：{SuccessFactorsからのエラー}}。	SuccessFactors からの OData API 呼び出しでエラーが発生しました。具体的な理由は、サクセスファクターズからのメッセージに記載されています。このエラーは、 Property が見つからないために起こります。このエラーの解決に関する詳細については、以下の「Property not found」サブセクションを参照してください。
SuccessFactorsからプレビューレコードを取得する際に、予期しない内部エラーが発生しました。	クアルトリクス側の内部エラーです。クアルトリクスサポートまでご連絡ください。

物件が見つからない

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

フィールドを検索するには、SuccessFactors の Admin Center に移動し、OData API Data Dictionary に移動します。

ここからEntityタブに行き、追加したいフィールドを探す。フィールドが存在し、フィールドパスがクアトリクスの「Extract Employee Data from SuccessFactors」タスクで追加したものと一致していることを確認します。一般的に、”PerPerson “は、正しいフィールドパスを見つけるためのベースとなるエンティティである。フィールドパスが正しくてもエラーが発生する場合は、サクセスファクターズのサポートにお問い合わせください。

FAQs

ワークフローのテンプレートで利用できるすべての拡張機能にアクセスできますか？

アクセスは、お客様のライセンスと権限に依存します。ブランド管理者に連絡し、あなたのライセンスがその拡張機能にアクセスできるかどうかを尋ねてください。

すべてのワークフローのイベントトリガー、コントロールフロー、およびタスクへのリンクはありますか？

Qualtricsのワークフローの基本はこちらのサポートページをご覧ください。すべてのイベントやタスクは、このページからリンクされています。

ワークフローテンプレートとは何ですか？

ワークフローテンプレートは、ユーザーがワークフローを一から構築する必要がないように、自動化されたワークフローをあらかじめ組み立てたコレクションです。これらのテンプレートはQualtricsのサブジェクトマターエキスパートによって作成されています。

ワークフローとは何ですか？/ アクションはどこですか？

アクションはワークフローに名称変更され、製品体験をよりよく表現し、ユーザーの製品への関わり方を反映するようになりました。

今回のアップデートでは、ワークフロー機能に変更はありません。

ファーストパーティ製とサードパーティ製のエクステンションの見分け方は？どちらの種類でも、どこに行けばサポートしてもらえるのか？

詳細な説明は、Support for Third Party Extensions をご覧ください。

How is the extraction criteria defined for this task?

The first time your workflow runs, Qualtrics will extract all records using the field paths you defined in your workflow. We save the field configuration and date and time that this data was extracted. The next time your workflow runs, Qualtrics will check if your field configuration has changed:

If your field configuration has not changed, Qualtrics uses the date and time of the previous extraction to filter the next OData query. Most entities in SuccessFactors contain a “lastModifiedDateTime” field and Qualtrics checks if this entity has been modified since the last extraction.
If your field configuration did change, Qualtrics provides an option to perform a full extraction on the next run. To enable this, click the Reload the data link that appears in the chained loader task in the same workflow.

当サポートサイトの日本語のコンテンツは英語原文より機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は十分な注意を払っていますが、もし、英語・日本語翻訳が異なる場合は英語版が正となります。英語原文と機械翻訳の間に矛盾があっても、法的拘束力はありません。

この記事は役に立ちましたか

いただいたフィードバックはこのページの改善の目的のみに利用します。

素晴らしい！フィードバックありがとうございます！

フィードバックありがとうございます！