SuccessFactors スポーク v3.x.x をセットアップする

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：8分

    • 基本的な認証情報を使用して、 SuccessFactors スポークインスタンスをServiceNowインスタンスとデータ連携します。

    始める前に

    • 統合ハブ サブスクリプションの要求。
    • SuccessFactors スポークを有効にします。
    • システムプロパティを有効にします：
      • glide.pf.rest.response_payload_max_size：最大値は 10240です。
      • com.snc.process_flow.reporting.serialized.val_size_limit：最大値は 16384です。
      • com.glide.transform.json.max-partial-length：最大値は 65536です。
    • 必要なロール：admin。
    注:
    SuccessFactors は 2026 年 11 月までにベーシック認証を廃止するため、誰もが SuccessFactors スポーク v4.5.0 でサポートされている OAuth SAML を使用する必要があります。
    • SuccessFactors スポーク を初めてインストールする場合は、 SuccessFactors スポーク v4.5.0 をインストールしてください。 SuccessFactors スポーク v4.5.0 の設定の詳細については、「SuccessFactors スポーク v4.x.x の設定」を参照してください。
    • 以前のバージョンの SuccessFactors スポーク を使用している場合、 SuccessFactors スポーク v4.5.0 に移行してください。詳細については、「SuccessFactors スポーク v4.5.0 への移行」を参照してください。

    OData API の認証情報レコードを作成

    SuccessFactorsに OData API の認証情報レコードを作成します。 SuccessFactors スポーク接続および資格情報エイリアスでは、これらの認証情報を使用して、OData API を使用したアクションを許可します。

    手順

    1. 次のように移動する。 接続 & 認証情報 > 認証情報.
    2. [New] をクリックします。
      「作成する認証情報のタイプは？」というメッセージが表示されます。
    3. [基本認証情報] を選択します。
      空の基本認証情報フォームが表示されます。
    4. フォームに、これらの値を入力します。
      フィールド 必要な値
      名前 レコードを一意に識別する名前を入力します。たとえば、「SAPSF OData Credentials」と入力します。
      ユーザー名 次のフォーマットで OData API 権限を持つユーザー名を入力します：<username>@<SAP-SuccessFactors-CompanyID>
      パスワード 関連付けられたパスワードです。
      有効 認証情報レコードをアクティブに使用するオプション。
      順番 この認証情報を適用する順番。たとえば、「100」と入力します。
    5. [送信] をクリックします。

    タスクの結果

    OData API を使用してアクションを許可する認証情報レコードが作成されます。

    OData API の認証情報レコードを作成

    SuccessFactorsに OData API の認証情報レコードを作成します。 SuccessFactors スポーク接続および資格情報エイリアスでは、これらの認証情報を使用して、SOAP API を使用したアクションを許可します。

    手順

    1. 次のように移動する。 接続 & 認証情報 > 認証情報.
    2. [New] をクリックします。
      「作成する認証情報のタイプは？」というメッセージが表示されます。
    3. [SuccessFactors SOAP 認証情報] を選択します。
      空の SuccessFactors SOAP 認証情報フォームが表示されます。
    4. フォームに、これらの値を入力します。
      フィールド 必要な値
      名前 レコードを一意に識別する名前を入力します。たとえば、「SAPSF Comp Emp 認証情報」と入力します。
      ユーザー名 SOAP API 権限を持つユーザー名です。
      パスワード 関連付けられたパスワードです。
      有効 認証情報レコードをアクティブに使用するオプション。
      順番 この認証情報を適用する順番。たとえば、「100」と入力します。
    5. [送信] をクリックします。

    タスクの結果

    SOAP API を使用してアクションを許可する認証情報レコードが作成されます。

    OData API の接続レコードの作成

    SuccessFactorsに OData API の接続レコードを作成します。 SuccessFactors スポーク接続および資格情報エイリアスでは、これらの接続を使用してSuccessFactorsでアクションを実行します。

    手順

    1. 次のように移動する。 接続 & 認証情報 > 接続 & 資格情報エイリアス.
    2. SuccessFactors OData API のレコードを開きます (例：SuccessFactors_Odata)。
    3. [接続] タブで、[新規] をクリックします。
      空の HTTP(s) 接続フォームが表示されます。
    4. フォームに、これらの値を入力します。
      表 : 1. HTTP(S) 接続フォーム
      フィールド 説明
      名前 レコードを一意に識別する名前を入力します。たとえば、「SF_REST」です。
      認証情報 OData API 用に作成された認証情報レコードです。たとえば、「SAPSF OData 認証情報」です。
      接続 URL SuccessFactorsサービスルートの URL です。たとえば、「https://apisalesdemo4.successfactors.com/odata/v2」です。
      注:
      SAP Cloud アカウントを使用している場合は、SAP Help Portalの「SAP SuccessFactors API サーバーの一覧」を参照して、API サーバーをターゲットにするために必要な正しいエンドポイントを選択してください。
      [Active (アクティブ)] 接続レコードを積極的に使用にするオプションです。
    5. [送信] をクリックします。

    タスクの結果

    SuccessFactorsの OData API の接続レコードが作成されます。

    SOAP API の接続レコードを作成

    SuccessFactorsに SOAP API の接続レコードを作成します。 SuccessFactors スポーク接続および資格情報エイリアスでは、これらの接続を使用してSuccessFactorsでアクションを実行します。

    手順

    1. 次のように移動する。 接続 & 認証情報 > 接続 & 資格情報エイリアス.
    2. SuccessFactors SOAP API のレコードを開きます (例：SuccessFactors_Comp_Emp)。
    3. [接続] タブで、[新規] をクリックします。
      空の HTTP(s) 接続フォームが表示されます。
    4. フォームに、これらの値を入力します。
      表 : 2. HTTP(S) 接続フォーム
      フィールド 説明
      名前 レコードを一意に識別する名前を入力します。たとえば、「SF_REST」です。
      認証情報 SOAP API 用に作成された認証情報レコードです。たとえば、「SAPSF Comp Emp 認証情報」です。
      接続 URL SuccessFactors接続 URL です。たとえば、「https://salesdemo4.successfactors.com/sfapi/v1/soap」です。
      注:
      SAP Cloud アカウントを使用している場合は、SAP Help Portalの「SAP SuccessFactors API サーバーの一覧」を参照して、API サーバーをターゲットにするために必要な正しいエンドポイントを選択してください。
      [Active (アクティブ)] 接続レコードを積極的に使用にするオプションです。
    5. [属性] タブで、次のフィールドに入力します。
      フィールド 説明
      会社 ID SuccessFactorsインスタンスの不変の会社 ID
      フロータイムアウト (秒) フロー実行中にSuccessFactorsからデータを受信できる最大時間 (秒) です。SuccessFactors からデータを取得するのに要した時間がタイムアウト期間を超えると、フローまたはサブフローはキャンセルされます。デフォルト値は「30」です。
    6. [送信] をクリックします。

    タスクの結果

    SuccessFactorsの SOAP API の接続レコードが作成されます。

    SuccessFactors と ServiceNow 間のデータ同期

    要件に応じてサンプルフローをカスタマイズし、SuccessFactors と ServiceNow のインスタンスの間でデータを同期します。

    To Do エンティティ

    SuccessFactors スポークでは、To Do エンティティのデータを双方向で同期するためのサンプルフローが提供されます。サンプルフローである「SuccessFactors データ連携を実行」フローは、SuccessFactorsからデータを取得するようにカスタマイズできます。一方、「To Do を作成」および「To Do を更新」フローは、ServiceNowでイベントが発生したときにSuccessFactorsの To Do レコードを作成または更新します。サンプルフローをカスタマイズするときは、変換マップを使用して将来の更新を取得して保存するための適切なトリガーを指定していることを確認してください。

    その他のデフォルトエンティティ

    これらのエンティティの場合、サンプルフローである「SuccessFactors データ連携を実行」フローをカスタマイズして、SuccessFactorsからデータを取得できます。
    • 部門
    • ロケーション
    • ジョブプロファイル
    • ワーカープロファイル
    • 有効なワーカープロファイル
    • セカンダリアサインを含むジョブ履歴

    ServiceNowでイベントが発生したときに、これらのエンティティのSuccessFactorsのレコードを作成または更新するには：

    • 選択に従ってフローまたはサブフローを作成するか、サンプルフローとサブフローをカスタマイズします。
    • フローでメタデータ取得アクションとレコード管理アクションを使用します。
    • 変換マップを使用して将来の更新を取得して保存するための適切なトリガーを指定していることを確認してください。

    その他のSuccessFactorsエンティティ

    SuccessFactors 権限と構成、および要件に応じて、その他のエンティティのデータを同期することもできます。