SuccessFactors スポーク

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：20分

    • SuccessFactors スポークは、Bristlecone, Inc. によってビルドされています。ServiceNow インスタンスから SuccessFactors のデータとエンティティを管理します。

    ストアでアプリを要求

    ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。 2022 年 3 月 1 日以降、すべての SAP スポークはストアでのみ入手可能になります。

    統合ハブサブスクリプション

    このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。

    スポークバージョン

    SuccessFactors スポーク v4.2.2 が最新バージョンです。

    スポークの依存関係

    アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。

    • 複合オブジェクト (com.glide.cobject)
    • ServiceNow 統合ハブランタイム (com.glide.hub.integration.runtime)
    • ServiceNow フローデザイナー - 動的入力 (com.glide.hub.dynamic_inputs)
    • ServiceNow 統合ハブアクションステップ - REST (com.glide.hub.action_step.rest)
    • ServiceNow 統合ハブアクションステップ - SOAP (com.glide.hub.action_step.soap)
    • ServiceNow 統合ハブアクションテンプレート - データストリーム (com.glide.hub.action_type.datastream)
    • ServiceNow 統合ハブアクションステップ - XML パーサー (com.glide.hub.action_step.xmlparser)
    • ServiceNow フローデザイナー - 動的出力 (com.glide.hub.dynamic_outputs)
    • リモートテーブル (com.glide.script.vtable)
    注:
    これらのプラグインの一部はライセンス可能な機能であり、スポーク実装以外で使用する場合は適切なライセンスが必要です。ライセンスの詳細については、アカウントマネージャーにお問い合わせください。

    スポークのフロー

    SuccessFactors スポークでは、SuccessFactors タスクの自動化をデモするドラフト状況のサンプルフローが提供されます。サンプルフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。利用可能なサンプルフローは次のとおりです。
    フロー 説明
    To Do を作成 SuccessFactors に To Do レコードを作成します。
    To Do を更新 SuccessFactors で指定された To Do レコードの詳細を更新します。
    SuccessFactors データ連携フローを実行します。 選択したエンティティについて、SuccessFactors から ServiceNow インスタンスに、データ全体または前回の更新後に行われた更新のみを取得します。デフォルトでは、SuccessFactors で次のエンティティからデータを取得できます。
    • 部門
    • ロケーション
    • ジョブプロファイル
    • ワーカープロファイル
    • 有効なワーカープロファイル
    • セカンダリアサインを含むジョブ履歴
    • To Do
    注:
    「To Do を作成」フローと「To Do を更新」フローは、ServiceNow でイベントが発生したときの To Do レコード管理を示すものです。要件に応じてこれらのフローをカスタマイズし、ServiceNow インスタンスから他のエンティティのレコードを管理できます。

    スポークのサブフロー

    SuccessFactors スポークでは、SuccessFactors タスクの自動化をデモするドラフト状況のサンプルサブフローが提供されます。サンプルサブフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。利用可能なサンプルフローは次のとおりです。
    サブフロー 説明
    部門を取得 SuccessFactors から部門データを取得し、SuccessFactors 部門ステージングテーブルに保存します。
    有効なワーカープロファイルを取得 SuccessFactors から有効なワーカープロファイルデータを取得し、SuccessFactors ワーカープロファイルステージングテーブルに保存します。
    セカンダリアサインを含む完全なジョブ履歴を取得

    SuccessFactors からすべてのプライマリおよびセカンダリジョブ履歴データを取得します。
    ジョブプロファイルを取得 SuccessFactors からジョブプロファイルデータを取得し、SuccessFactors ジョブプロファイルステージングテーブルに保存します。
    場所を取得 SuccessFactors から場所データを取得し、SuccessFactors 場所ステージングテーブルに保存します。
    To Do を取得 SuccessFactors から To Do データを取得し、SuccessFactors 受信 To Do ステージングテーブルに保存します。
    ワーカープロファイルを取得 SuccessFactors からワーカープロファイルデータを取得し、SuccessFactors ワーカープロファイルステージングテーブルに保存します。
    SuccessFactors サービスを実行 選択したエンティティについて、データ全体または最後に成功したランタイムからの更新のみを取得します。
    SuccessFactors Webhook を処理 SAP SuccessFactors Webhook イベントを処理します。Webhook の設定の詳細については、「SuccessFactors スポークの Webhook を設定」を参照してください。

    スポークのアクション

    SuccessFactorsスポークでは、ServiceNowでイベントが発生したときにSuccessFactorsタスクを自動化するアクションが提供されます。使用可能なアクションは次のとおりです。
    注:
    • 権限のないユーザーが機密データにアクセスできないようにするために、SuccessFactors スポークの機密アクションに hasRole 機能が実装されました。その結果、システムアドミニストレーターロールを持たないユーザーは、SuccessFactors スポークアドミンロールを持っていない場合にアクションを正常に実行でなくなります。これは、スポークの SuccessFactors スポーク v3.1.5 と v4.0.3 からそれぞれ適用されます。詳細については、NOW Support のナレッジベース記事「SuccessFactors Spoke hasRole fix details (SuccessFactors スポーク hasRole 修正の詳細)」を参照してください。
    • 権限のないユーザーが SuccessFactors スポークテーブルのレポートを生成できないようにするために、report_view ACL がスポークの管理者ロールに組み込まれています。これにより、レポートを生成するには、ユーザーは SuccessFactors スポークの管理者ロールを持っている必要があります。
    カテゴリ アクション 説明
    従業員管理 従業員住所情報 指定された従業員の住所情報を取得します。
    従業員年俸 指定された従業員の年俸の詳細を取得します。
    従業員報酬の詳細 指定された従業員の報酬の詳細を取得します。
    従業員ドキュメント 指定された従業員の表示可能なすべてのドキュメントを取得します。
    従業員の支払い方法の詳細 指定された従業員の支払い方法の詳細を取得します。
    従業員の休暇 指定された従業員によって取得された休暇を取得します。
    従業員の休暇残日数 指定された従業員の休暇残日数の詳細を取得します。
    自分のタイムカードの詳細 指定された従業員のタイムシートの詳細を取得します。
    ユーザーロールを変更 指定された権限グループにユーザーを追加します。
    従業員のすべての支払い方法の詳細 指定された従業員のすべての支払い方法の詳細を取得します。
    繰り返し発生する従業員の報酬 指定された従業員の報酬の繰り返しコンポーネントを管理します。
    従業員の福利厚生登録を取得 指定された従業員の特定の期間中の福利厚生登録の詳細を取得します。
    従業員の退職を処理 指定された従業員の退職プロセスをトリガーします。
    組織変更 指定された従業員の組織関連情報を変更します。
    無断欠勤をレポート 指定された従業員の無断欠勤をレポートします。
    レポート構造 指定された従業員のレポート構造を取得します。
    休みを申請 指定された従業員の休暇申請を適用します。
    従業員の住所を更新 指定された従業員の住所を更新します。
    従業員の個人情報を更新 指定された従業員の個人情報を更新します。
    従業員の個人情報を更新 - グローバル 指定された従業員のグローバル情報を更新します。
    従業員の開始日を更新 指定された従業員の雇用開始日を更新します。
    人事基盤データ SuccessFactors にログイン SuccessFactors にログインし、セッション ID を取得します。
    現在の雇用情報を取得 SuccessFactors から現在の雇用情報を取得します。
    部門を取得 SuccessFactors から部門データを取得します。
    セカンダリアサインを含む完全なジョブ履歴を取得

    SuccessFactors からセカンダリアサインを含む完全なジョブ履歴データを取得します。
    有効なワーカー ID を取得 SuccessFactors から有効なワーカープロファイル ID を取得します。
    個人 ID で個人を取得 個人 ID で SuccessFactors からワーカープロファイルデータを取得します。
    有効なワーカープロファイルを取得 SuccessFactorsから有効なワーカープロファイルデータを取得します。
    セカンダリアサインを含むジョブ履歴を取得 (廃止)

    SuccessFactors からセカンダリアサインを含むジョブ履歴データを取得します。
    ジョブプロファイルを取得 SuccessFactors からジョブプロファイルデータを取得します。
    場所を取得 SuccessFactors から場所データを取得します。
    ワーカープロファイルを取得 SuccessFactors からワーカープロファイルデータを取得します。
    祝日カレンダーを取得 国の祝日カレンダーを取得します。
    メタデータの取得
    注:
    作成可能、削除可能、更新可能、メタデータのリスト表示の各アクションを実行するには、グローバルスコープに com.glide.attachment.max_get_size という名前のシステムプロパティを作成し、その値を 20000000 に設定します。
    		 動的出力フィールドを取得 指定されたエンティティの応答でフィールドをマッピングするための動的出力構造を作成します。
    エンティティを取得 - 作成可能 作成操作がサポートされているエンティティを取得します。
    エンティティを取得 - 削除可能 削除操作がサポートされているエンティティを取得します。
    エンティティを取得 - 更新可能 更新操作がサポートされているエンティティを取得します。
    エンティティリストを取得 すべてのエンティティのリストを取得します。
    フィールドを取得 - 作成可能 エンティティの作成可能な非ナビゲーションプロパティをすべて取得します。
    フィールドを取得 - 更新可能 エンティティのすべての更新可能な非ナビゲーションフィールドを取得します。
    キーフィールドを取得 指定されたエンティティのすべてのキーフィールドを取得します。
    必須フィールドを取得 - 作成可能 指定されたエンティティの挿入可能なすべての必須フィールドを取得します。
    更新可能な To Do フィールドを取得 送信 To Do ステージングテーブルの更新可能なフィールドのリストを取得します。
    利用可能なポジションを取得 指定された会社および場所コードで利用可能なすべてのポジションを取得します。
    事業部門の取得 SuccessFactorsで利用可能なすべての事業部門を取得します。
    会社を取得 SuccessFactorsでアクティブなすべての会社を取得します。
    国を取得 SuccessFactorsでアクティブなすべての国を取得します。
    国コードを取得 国の国コードを取得します。
    動的権限グループを取得 利用可能なすべての動的権限グループを取得します。
    イベント ID でイベント理由を取得 指定されたイベント ID のすべてのイベント理由を取得します。
    エンティティでグローバル情報を取得 グローバル情報をフェッチするために指定されたエンティティのメタデータを取得します。
    グローバルな個人情報をサポートしている国を取得 個人のグローバル情報の作成と変更をサポートする国の詳細を取得します。
    会社コードで場所を取得 SuccessFactors から、指定された会社コードのすべてのアクティブな場所を取得します。
    グループ ID でユーザープールを取得 指定されたグループのユーザー名カテゴリのみを持つすべてのユーザープールを取得します。
    選択リストオプションを取得 指定された選択リスト ID で利用可能なすべての選択リストオプションを取得します。
    国別の選択リストオプションを取得 指定された国の選択リストオプションを取得します。
    従業員向けに定義された繰り返し発生する支払いコンポーネントを取得 指定された従業員の繰り返し発生する支払いコンポーネントと関連情報を取得します。
    必須フィールドを取得 - 作成可能 指定されたエンティティの挿入可能なすべての必須フィールドを取得します。
    ユーザー ID で時刻タイプを取得 SAP SuccessFactors の指定された従業員の利用可能なすべての時刻タイプを取得します。
    更新可能な To Do フィールドを取得 SuccessFactors 送信 To Do ステージングテーブルの更新可能なフィールドのリストを取得します。
    レコード管理 レコードを作成 SuccessFactors にレコードを作成します。
    レコードを削除 SuccessFactors で指定されたレコードを削除します。
    URL でエンティティを実行 ナビゲーション URL を入力として使用し、そのナビゲーション URL の応答を提供します。
    レコードを取得 選択されたエンティティと指定されたキーフィールドのレコードを取得します。
    レコードを更新 指定されたレコードの詳細を更新します。
    To Do To Do を作成 SuccessFactorsに To Do レコードを作成します。
    ID で To Do を取得 SuccessFactorsから To Do の詳細を取得します。
    To Do を取得 カテゴリ ID が 57 の To Do を除き、SuccessFactorsから To Do データを取得します。
    To Do を更新 指定された To Do レコードの詳細を更新します。
    ユーザー管理 ユーザーアクティビティを検索 SAP SuccessFactorsユーザーの前回のアクティビティ時間を取得します。
    ユーザーアクティビティ SFTP を検索 SSH ファイル転送プロトコル (SFTP) の場所で公開されたレポートをフェッチして、SAP SuccessFactorsユーザーの前回のアクティビティ時間を取得します。
    ユーザーを検索 SAP SuccessFactorsユーザーのリストを取得します。
    ユーザーを一時停止 ユーザーアカウントを一時停止します。
    ユーティリティカテゴリ SuccessFactors サブフローを呼び出し 指定されたSuccessFactorsスポークサブフローを同期的に実行します。
    SuccessFactors サービスの実行サブフローを呼び出し SuccessFactors サービスの実行サブフローを非同期に実行します。
    フローステータスを確認 フローのコンテキストが現在実行されているかどうかを確認します。
    最終実行日を取得 フローの前回の実行日時を取得します。
    送信 To Do ステージングテーブルのレコードを更新 SuccessFactors 送信 To Do ステージングテーブルで指定された To Do レコードの詳細を更新します。
    注:
    このアクションを実行できるのは、アドミンユーザーのみです。
    ゴール管理 ユーザー ID で目標を検索 指定されたユーザー ID の目標情報を SuccessFactors から取得します。
    注:
    このアクションを実行できるのは、アドミンユーザーのみです。
    ジョブ管理 ID で添付ファイルを検索 添付ファイルのコンテンツを取得し、指定された添付ファイル ID の SuccessFactors 添付ファイルデータソースに保存します。

    添付ファイルにアクセスするには、次の場所に移動します すべて > システムインポートセット > 管理 > データソース をクリックし、レコード [SuccessFactors Attachments] を開きます。必要なファイルはデータソースレコードに添付されています。

    注:
    このアクションを実行できるのは、アドミンユーザーのみです。
    ID で候補を検索 候補情報を、指定された候補 ID の SuccessFactors から取得します。
    注:
    このアクションを実行できるのは、アドミンユーザーのみです。
    求職申し込みストリームを検索 SuccessFactors から求職申し込み情報を取得します。
    注:
    このアクションを実行できるのは、アドミンユーザーのみです。
    ジョブコードストリームを検索 SuccessFactors からジョブレベル、雇用タイプ、ジョブタイプ情報を取得します。
    注:
    このアクションを実行できるのは、アドミンユーザーのみです。
    ID でジョブ要求事項を検索 指定された要求事項 ID のジョブ要求事項の詳細を取得します。
    注:
    • ジョブレベル ID と雇用タイプ ID の API 属性が customString3 と customString4 以外のカスタム属性で構成されている場合は、[ID でジョブ要求事項を検索 (Look up Job Requisition by ID)] アクションのコピーを作成し、予想される API 属性パスで後処理スクリプトを変更します。
    • このアクションを実行できるのは、アドミンユーザーのみです。
    ジョブ要求事項求人情報ストリームを検索 SuccessFactors から求人情報を取得します。
    注:
    このアクションを実行できるのは、アドミンユーザーのみです。
    従業員ジョブストリームを検索 SuccessFactors からすべての従業員ジョブ情報を取得します。
    ジョブプロファイルストリームを検索 SuccessFactors からジョブプロファイル情報を取得します。
    注:
    スポークアクションで入力として日付または時刻が必要な場合は、必ず GMT タイムゾーンでのみ値を指定してください。

    スポークモジュール

    SuccessFactorsスポークは SuccessFactors アプリケーションをServiceNowインスタンスに追加します。SuccessFactors アプリケーションには次のモジュールがあります。
    モジュール 説明
    部門ステージングテーブル SuccessFactorsから取得された部門データを表示します。
    場所のステージングテーブル SuccessFactorsから取得された場所データを表示します。
    ジョブプロファイルステージングテーブル SuccessFactorsから取得されたジョブプロファイルデータを表示します。
    ワーカープロファイルステージングテーブル SuccessFactorsから取得されたワーカープロファイルデータを表示します。
    受信 To Do ステージングテーブル SuccessFactorsから取得されたた To Do レコードを表示します。
    送信 To Do ステージングテーブル ServiceNowで作成された To Do レコードを表示します。

    ServiceNowで To Do レコードが作成または更新されると、「To Do を作成」または「To Do を更新」フローがトリガーされ、SuccessFactorsでも同じレコードが作成または更新されます。関連するすべてのレコードの詳細は、SuccessFactorsから取得され、このステージングテーブルに保存されます。フローがSuccessFactorsでのレコードの作成または更新に失敗した場合、ServiceNowの関連するレコードや更新も削除されます。
    従業員のジョブ情報と履歴 すべてのユーザーのジョブ情報とジョブ履歴を表示します。
    自分の休暇残日数を表示 ログインしているユーザーの休暇残日数を表示します。
    自分の休暇詳細を表示 ログインしているユーザーの休暇申請の詳細を表示します。
    Webhook レジストリ Webhook レジストリのリストを表示します。アドミンはここで Webhook レジストリを作成する必要があります。詳細については、「SuccessFactors スポークの Webhook を設定」を参照してください。
    過去 1 か月のタイムカードの詳細を表示 ログインしているユーザーの過去 1 か月のタイムカードの詳細を表示します。
    自分のワーカープロファイルを表示 ログインしているユーザーのワーカープロファイルの詳細を表示します。
    自分の祝日カレンダーを表示 ログインしているユーザーに適用される祝日カレンダーを表示します。
    自分のレポート構造を表示 ログインしているユーザーのレポート構造の詳細を表示します。
    自分の口座振込情報を表示 ログインしているユーザーの口座振込の詳細を表示します。
    自分の合計報酬を表示 ログインしているユーザーの合計報酬を表示します。

    データを取得するには、SuccessFactors データ連携フローを実行します。ステージングテーブルのデータは 7 日間利用可能です。この期間中は、変換マップを使用して、要件に応じて必要なターゲットServiceNowテーブルにこのデータを保存する必要があります。

    スポーク変換マップ

    SuccessFactors スポークでは、ServiceNowテーブルにSuccessFactorsデータを保存するための変換マップの使用をデモするために、非アクティブ状態のサンプル変換マップと関連するサンプルターゲットテーブルが提供されます。これらのサンプル変換マップとターゲットテーブルを参照して、要件に従って変換マップを作成できます。

    詳細については、「変換マップ」を参照してください。

    スポークユーザーロール

    次のユーザーロールは、スポークと一緒に利用可能です。
    • SuccessFactors 管理者 (sn_successfactors.SuccessFactors Admin)：このロールを持つユーザーは、すべてのスポークモジュールとテーブルにアクセスできます。
    • SuccessFactors プライベートデータ (sn_successfactors.SuccessFactors Private Data)：このロールを持つユーザーは、次のスポークモジュールのデータにアクセスできます。
      • 自分の口座振込情報を表示
      • 自分の合計報酬を表示
    • SuccessFactors パブリックデータ (sn_successfactors.SuccessFactors Public Data)：このロールを持つユーザーは、次のスポークモジュールのデータにアクセスできます。
      • 自分の休暇残日数を表示
      • 自分の休暇詳細を表示
      • 過去 1 か月のタイムカードの詳細を表示
      • 自分のワーカープロファイルを表示
      • 自分の祝日カレンダーを表示
      • 自分のレポート構造を表示

    接続および資格情報エイリアスの要件

    統合ハブ は、エイリアスを使用して、接続および認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。詳細については、「Connections and Credentials」を参照してください。

    2 つの接続および資格情報エイリアスを SuccessFactors スポーク で使用できます。1 つは SOAP API 用で、もう 1 つは OData API 用です。

    スポークの設定については、「 SuccessFactors スポーク v4.x.x の設定。