従業員適格基準に基づくHCMからの従業員更新

Oracle Fusion Field Service 25Aは、Oracle Fusion Field ServiceをOracle HCM Cloudアクセラレータで更新して、次の機能をサポートします:

1. 従業員選択&同期基準の拡張: DFFフィールドなどの任意のフィールドを柔軟に使用して、HCMから従業員をフィルタし、その情報をビジネス・ユニット名とジョブ・コードとは別にOracle Fusion Field Serviceに同期できるようになりました。 Oracle HCMでは、特定の基準に適格な従業員を識別するための従業員適格基準を設定できます。 Acceleratorは、これらの結果を使用して、適格な従業員が特定されたら、Oracle Fusion Field Serviceの従業員を更新します。

2. HCMの複数のフィールドを使用して、Oracle Fusion Field Serviceユーザー・タイプを識別: Acceleratorでは、Oracle Fusion Field Serviceでユーザー・タイプを識別するために複数の基準を構成するオプションが提供されるようになりました。 DFFフィールドなどの任意のフィールドを使用して、Oracle Fusion Field Serviceでユーザー・タイプを識別できるため、柔軟性が向上します。

3. リソース・フィールドを編集可能にするオプション: デフォルトでは、アクセラレータはすべてのリソース・フィールドを更新できます。ただし、必要に応じて、作成後に一部のフィールドを編集できないようにアクセラレータを構成できます。

4. ユーザー・フィールドのユーザー作成&更新を制御するオプション: デフォルトでは、アクセラレータはすべてのリソースのユーザーを作成できます。ただし、アクセラレータの構成に基づいて、ユーザーなしでリソースを作成できるようになりました。同様に、アクセラレータでは標準ユーザー・フィールドの更新はデフォルトで許可されませんが、ユーザーの作成後に更新するユーザー・フィールドを柔軟に定義できるようになりました。 Acceleratorは、定義した条件に基づいて、従業員データの同期中にこれらのフィールドを更新できます。

HCMの複数のフィールドに基づく従業員同期

ビジネス・ユニット名と職務コードに加えて、DFFフィールドを含む複数のフィールドを使用して、Oracle HCMのフィールド・サービスのリソース/ユーザーをフィルタできます。 Acceleratorは、HCM適格プロファイル(https://docs.oracle.com/en/cloud/saas/human-resources/24b/faiwc/eligibility-profiles.html#s20030581)に基づいて、Oracle Fusion Field Serviceに同期する従業員リストを識別します。 HCMの適格プロファイル機能では、個人がプロファイルを関連付けるオブジェクトに適格かどうかを決定する適格基準を定義できます。顧客は、ビジネス・ニーズに応じて適格基準を定義できます。

「HCMアクセラレータでHCM適格プロファイルを使用可能にするための前提条件」
Oracle Fusion Field ServiceでOracle HCM Cloudアクセラレータを使用してHCM適格プロファイル基準を使用するには、いくつかの前提条件があります。

HCM側の構成

加入者適格プロファイルの作成 Oracle Fusion Field Serviceに技術者、マネージャ/ディスパッチャまたは管理者として同期する必要がある従業員の適格基準を定義します。
Rest API https://docs.oracle.com/en/cloud/saas/human-resources/24b/farws/op-eligibilityprofileslov-get.htmlを使用した適格プロファイルIDの取得

「サンプル・リクエスト」
https://fa-eqkh-dev8-saasfademo1.ds-fa.oraclepdemos.com/hcmRestApi/resources/IPAddress/eligibilityProfilesLOV?finder=findByName;Name=<<Eligibility Profile Name>>

「サンプル・リクエスト」
https://fa-eqkh-dev8-saasfademo1.ds-fa.oraclepdemos.com/hcmRestApi/resources/IPAddress/eligibilityObjects

EligyPrflIdを使用して、適格オブジェクトhttps://docs.oracle.com/en/cloud/saas/human-resources/24b/farws/op-eligibilityobjects-post.htmlを作成します。また、ESSジョブおよびOICでEligibilityObjectIdを使用します。

{
"SourceObjectName" : "<<Source Object Name>>",
"SourceObjectKey" : "<<Source Object Key>>",
"SourceObjectValue" : "<<Source object value corresponding to Profile usage selected in the Eligibility profile. e.g: FieldServices>>",
"EligibilityObjectType" : "<<Eligibility object tyep corresponding to Profile usage selected in the Eligibility profile. e.g: FieldServices>>",
"eligibilityObjectProfiles":[
{
"EligibilityProfileId" : <<Eligibility profile id corresponding to the Eligibility profile>>,
"MandatoryFlag" : "Y"
}
]
ESSジョブ「適格の評価」を、顧客の要件に基づいて頻度で実行するようにスケジュールします。前のステップで作成したEligibilityObjectIdを使用して、このジョブをスケジュールします。 ESSジョブ・スケジュールが新規採用統合のスケジュールと一致するようにすることが重要です。新規採用従業員は、適格オブジェクト結果が最新データでリフレッシュされた後、Oracle Fusion Field Serviceにのみ同期されます。

OICサイド構成

OFS_Enable_HCM_Eligibility_Profile_Flag参照変数を使用すると、アクセラレータはHCM適格プロファイルで定義された基準を使用できます。デフォルトでは、標準アクセラレータはOFS_Enable_HCM_Eligibility_Profile_Flag値を空/偽に設定し、適格プロファイル基準をオフにして、以前の機能(HCM_BusinessUnitNamesおよびHCM_JobCodesがフィルタ基準とみなされていた)に戻ります。
OFS_Enable_HCM_Eligibility_Profile_Flagが'true'に設定されている場合、前のステップで生成されたEligibilityObjectIdをHCM_EligibilityObjectId参照変数に移入します。

すべての構成が完了すると、アクセラレータはHCM適格プロファイルで定義された基準を使用して、個人をOracle Fusion Field Serviceに同期できるかどうかを評価します。

ESSジョブ「適格の評価」は、HCMアクセラレータ・スケジュールに沿った間隔で実行されるようにスケジュールすることが重要です。
OFS_Enable_HCM_Eligibility_Profile_Flagがtrueの場合、従業員の一括同期にOracle HCM OFS従業員抽出統合を使用するかわりに、Oracle HCM OFS適格プロファイル一括同期を使用する必要があります。 Oracle HCM OFS適格プロファイル一括同期統合では、前提条件としてHCM抽出を生成する必要はありません。

「HCMの複数のフィールドを使用したOracle Fusion Field Serviceユーザー・タイプの識別」
Oracle Fusion Field Serviceで従業員に対してマップされるユーザー・タイプは、ジョブ・コードに加えて、従業員に関連付けられた様々な個人情報に基づいて識別できます。これにより、Oracle Fusion Field Serviceで、同じジョブ・コードを持つ従業員を異なるユーザー・タイプに構成できます。たとえば、レベル1の&レベル2のモバイル・ワーカーは、Oracle Fusion Field Serviceで様々なユーザー・タイプとしてマップできます。
「構成の設定」

'OFS_Enable_UserType_MultiCriteria_Flag'を使用すると、アクセラレータはDFFフィールドを含む複数の基準を使用してユーザー・タイプを決定できます。デフォルトでは、標準アクセラレータは'OFS_Enable_UserType_MultiCriteria_Flag'を空/偽に設定し、複数基準機能を無効にして、ORCL-BRT-HCM-OFS_EMPLOYEE_RESOURCE_MAPPINGで定義された'JobCode' (HCM_JOB_CODE)のみにユーザー・タイプを決定できるようにします。
OFS_Enable_UserType_MultiCriteria_Flagをtrueとして選択する場合、OFS_SkipUserCreationフラグはfalseにする必要があります
OFS_Enable_UserType_MultiCriteria_Flagがtrueに設定されている場合、ユーザー・タイプの導出に使用されるAPIフィールド名(https://docs.oracle.com/en/cloud/saas/human-resources/24b/farws/op-workers-get.html)は、参照変数OFS_UserType_Identified_Byで定義する必要があります。次に例を示します: workRelationships.assignments.JobCode||workRelationships.assignments.assignmentsDFF.legalAuthority
たとえば、フィールド名は<<parent.child>>の形式にする必要があります: 'workRelationships.assignments.JobCode'. フィールドの構造と名前は、レスポンス構造内の項目を除外して、ワーカーAPIレスポンス内のものと完全に一致する必要があります。参照変数OFS_Delimiterで定義されたデリミタを使用して、複数のフィールド名を区切ることができます。
フィールド・オブジェクト(例: : OFS_UserType_Identified_Byで使用される割当て、assignmentsDFFなどは、OIC拡張グループを使用した統合Oracle HCM Oracle Fusion Field Serviceユーザー・タイプ・ユーティリティのGetWorkerRest呼出しの前に展開(「Rest API」の展開」フィールドを使用)する必要があります。デフォルトでは、標準アクセラレータでは、workRelationships、割当ておよびassignmentsDFFオブジェクトが展開されます。 OFS_UserType_Identified_Byで他のフィールドを使用する必要がある場合は、対応するオブジェクトを展開します。「展開」フィールドに移入するには、Rest APIのドキュメント(https://docs.oracle.com/en/cloud/saas/human-resources/24b/farws/op-workers-get.html#:~:text=effectiveDate%3A%20string-,expand%3A%20string、-When%20this%20parameterを参照してください。
新しいOIC参照表ORCL-BRT-HCM-OFS_USER_TYPE_MULTI_CRITERIA_MAPPINGで、各ユーザー・タイプを識別する実際の値を指定します。 HCM_CRITERIA列には、OFS_UserType_Identified_Byで定義された構成に対応する実際の値が保持されます。たとえば、OFS_Delimiterで定義されたデリミタを使用して複数の値が区切られます: TECHNICIAN001||FEDERAL. OFS_USER_TYPE列には、対応するユーザー・タイプが保持されます。

「リソース・フィールドを編集可能に構成するオプション」
デフォルトでは、アクセラレータでは、Oracle Fusion Field Serviceリソースのすべてのフィールドを更新できます。アクセラレータでサポートされる標準リソース・フィールドは、ステータス、resourceType、名前、電子メール、電話、言語およびtimeZoneです。変更できない標準フィールドを更新する場合は、'OFS_NonUpdatableResourceFields'のエントリをカンマ区切りリストとして作成する必要があります。このバージョンのアクセラレータでは、更新する必要があるOFSの「リソース」フィールドを制御できます。統合には、作成後に更新する必要がある標準OFSリソース・フィールドを顧客が決定できるオプションが用意されています。 OIC統合によって更新されないAPIフィールド(https://docs.oracle.com/en/cloud/saas/field-service/cxfsc/op-rest-ofsccore-v1-resources-resourceid-patch.html)のリストを保持する新しいOIC参照変数'OFS_NonUpdatableResourceFields'が導入されました。

「ユーザー・フィールドのユーザー作成&更新を制御するオプション」
デフォルトでは、アクセラレータはフィールド・サービスにユーザーを作成しますが、ユーザーの作成を制御する場合は、OICで「OFS_SkipUserCreationフラグ」を使用できます。デフォルトでは、標準アクセラレータのOFS_SkipUserCreation値は空/偽に設定されているため、ユーザーを作成できます。顧客がユーザーを作成したくない、またはユーザー同期を別のシステム経由で実行することを希望するシナリオでは、OFS_SkipUserCreationフラグを'true'に設定してユーザー作成を防止できます。
OFS_AllowUserUpdateフラグは、ユーザー更新へのアクセスを提供します。デフォルトでは、標準アクセラレータはOFS_AllowUserUpdate値を空/偽に設定し、ユーザー・オブジェクトを更新できません。顧客がユーザー・オブジェクトを更新するシナリオでは、OFS_AllowUserUpdateフラグを「真」に設定して、統合「Oracle HCM OFS従業員同期ヘルパー」のUpdateUserスコープへのアクセスを許可できます。 UpdateUserInvokeの前にOIC拡張グループを追加して、更新が必要なユーザー・フィールドをマップできます。

ORCL-BRT-HCM-OFS_CONFIG参照の新しい構成エントリ

OFS_NonUpdatableResourceFields
OFS_SkipUserCreation
OFS_AllowUserUpdate
OFS_Enable_UserType_MultiCriteria_Flag
OFS_Delimiter
OFS_UserType_Identified_By
OFS_Enable_HCM_Eligibility_Profile_Flag
HCM_EligibilityObjectId

ライブラリ

Oracle HCM OFSユーティリティ
ORCL-BRT-HCM-OFS_UTILS
Oracle HCM OFS解析ヘルパー
ORCL-BRT-HCM-OFS_PARSE_HLPR

この機能の目的は、Oracle HCM Cloud Acceleratorを使用して既存のOracle Fusion Field Serviceを改善することです:

従業員のフィルタ条件を拡張して、DFFフィールドなどのフィールドをさらに追加し、従業員のフィルタを向上させます。
Oracle Fusion Field Serviceで、様々なリソース・タイプ間で同じ適格プロファイルを持つ従業員の同期を使用可能にします。

有効化のステップ

ビジネス・アクセラレータOracle Fusion HCMのインストール - Oracle Field Service | Oracle Integrationストアからフィールド・サービスに対する従業員および従業員の勤務可能状況の更新。
OIC統合ユーザーおよび設定ユーザーに必要なロールと権限を構成します。
ユーザー・タイプの識別に使用するフィールドのリストを使用して、参照"ORCL-BRT-HCM-OFS_USER_TYPE_MULTI_CRITERIA_MAPPING"を構成します。

表: ORCL-BRT-HCM-OFS_USER_TYPE_MULTI_CRITERIA_MAPPING

列	サンプル値	説明
HCM_CRITERIA	TECHICIAN\|\|LEVEL01\|\|SERVICE	デリミタOFS_Delimiterで区切られた構成OFS_UserType_Identified_Byに基づく基準フィールド値。条件を含むオブジェクトは、OIC拡張グループを使用して、統合"Oracle HCM OFSユーザー・タイプ・ユーティリティ"の"GetWorkerRest"呼出しで展開する必要があります。
OFS_USER_TYPE	TECHNICIAN	Oracle Fusion Field Serviceの対応するユーザー・タイプ

列

サンプル値

説明

HCM_CRITERIA

TECHICIAN||LEVEL01||SERVICE

デリミタOFS_Delimiterで区切られた構成OFS_UserType_Identified_Byに基づく基準フィールド値。

条件を含むオブジェクトは、OIC拡張グループを使用して、統合"Oracle HCM OFSユーザー・タイプ・ユーティリティ"の"GetWorkerRest"呼出しで展開する必要があります。

OFS_USER_TYPE

TECHNICIAN

Oracle Fusion Field Serviceの対応するユーザー・タイプ

4. 参照ORCL-BRT-HCM-OFS_CONFIGを次の値で構成します(該当する場合)。

表: ORCL-BRT-HCM-OFS_CONFIG

フィールド名	サンプル値	説明
OFS_NonUpdatableResourceFields	resourceType,name	オプション。リソースの「更新不可」フィールド。変更できない必要があるRESOURCEオブジェクトのカンマ区切りの標準フィールド。サポートされている標準フィールドresourceType、name、email、phone、timeZone、lanugageおよびstatus。リソースの更新が発生すると、この参照変数に記載されているフィールドはアクセラレータから変更できなくなります。
OFS_SkipUserCreation	true/false	オプション。有効な値はtrue/falseです。 trueの場合、アクセラレータを介したOFSユーザーの作成はスキップされます。
OFS_AllowUserUpdate	true/false	オプション。有効な値はtrue/falseです。 trueの場合、ユーザー・オブジェクトを更新できます。統合「Oracle HCM OFS従業員同期ヘルパー」の"UpdateUserInvoke"の前に拡張グループを使用して更新が必要なユーザー・フィールドをマップします。
OFS_Enable_UserType_MultiCriteria_Flag	true/false	オプション。有効な値はtrue/falseです。 trueの場合、複数の基準を定義してユーザー・タイプを識別できます。 falseまたは未定義の場合、ORCL-BRT-HCM-OFS_EMPLOYEE_RESOURCE_MAPPING参照のジョブ・コードが使用されます
OFS_Delimiter	\|\|	オプション。 OFS_Enable_UserType_MultiCriteria_Flagがtrueの場合にのみ必須です。デリミタは、OFS_UserType_Identified_By参照変数およびORCL-BRT-HCM-OFS_USER_TYPE_MULTI_CRITERIA_MAPPING参照表で使用する必要があります
OFS_UserType_Identified_By	workRelationships.assignments.JobCode\|\|workRelationships.assignments.assignmentsDFF.WorkerCode	オプション。 OFS_Enable_UserType_MultiCriteria_Flagがtrueの場合にのみ必須です。ワーカーAPIのフィールドを保持し、デリミタで区切られたユーザー・タイプを識別します。 OIC拡張グループを使用して、統合"Oracle HCM OFSユーザー・タイプ・ユーティリティ"で"GetWorkerRest"呼出しの前に、この構成で使用される親オブジェクトを展開する必要があります
OFS_Enable_HCM_Eligibility_Profile_Flag	true/false	オプション。有効な値はtrue/falseです。 trueの場合、HCM適格プロファイルを使用して従業員をフィルタする基準を定義する必要があります。 falseまたは指定しない場合、基準はHCM_BusinessUnitNamesおよびHCM_JobCodesで定義する必要があります。
HCM_EligibilityObjectId	300100598294610	オプション。 OFS_Enable_HCM_Eligibility_Profile_Flagがtrueの場合にのみ必須です。値は、"eligibilityObjects" REST APIを使用して適格プロファイルに対して作成された"EligibilityObjectId"です