This topic provides reference information you need to configure your Self-Service Benefits web pages using the Personalization Framework.
For instruction text, the tables below list--by web page region--the communication short name and the valid communication usages that are required when you define a communication type to display instruction text for a particular program, plan type, plan, or life event.
See: Defining Self-Service Instruction Text
Hidden Fields: This topic also lists--by web page region--all fields the application delivers as hidden which you can display using the Personalization Framework.
For example, by default all person name fields in Self-Service Benefits display names in the format 'First Last Suffix' (without commas between the parts of the name.) You can add the Full Name field to a web page and remove the delivered Name field. In the US, the Full Name field uses the format 'Prefix Last, First Middle Suffix'.
This module can be accessed from the following menus and functions:
| User Menu Name | Function Name |
|---|---|
| Employee Self-Service | Self-Service Benefits Enrollment - Employee |
| Employee Self-Service | Self-Service Benefits Enrollment - Federal |
The following definitions can be configured using the Personalization Framework:
The Family Members and Others page enables a participant to view a record of their family members and other persons enrolled as dependents or beneficiaries of their benefits. Benefits participants can add another person to the Family Members and Others table by choosing the Add Another Person button, which opens the Family Members and Others Details page.
This page only displays when a person has either:
An enrollment opportunity
Eligibility for an unrestricted program
A detected or unprocessed potential life event as of the system date
If one of these conditions does not exist, the application opens the Current Benefits page.
The seeded life event reason of Added During Enrollment prevents a life event from occurring when you create a family member or update a family member's details. If you define a life event reason of the type Personal, that you make Selectable for Self Service, you can trigger a life event when a person enters or deletes a contact on the Self-Service Human Resources Contacts page and selects a relationship start or end reason.
Note: It is recommended that you provide instruction text indicating that eligibility for benefits may be based on family members. However, you cannot use communication usages to restrict the display of instruction text to a compensation object or a life event for the Family Members page.
Hidden Field: Use the BEN_FAMILY_MBRS_TABLE region to add the hidden Full Name field to the page and to remove the Name field if necessary.
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Members Content | Instruction | FML.FAMILY_MBRS_CONTENT | Program, Life Event | |
| Family Members Content | Help Tip |
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Add or Update Family Members | Instruction | FML.FAM_ADD_CONTENT | Program, Life Event | |
| Name and Relationship | Instruction | FML.FAM_ADD_NAME | Program, Life Event | |
| Address | Instruction | FML.FAM_ADD_ADDRESS | Program, Life Event | |
| Miscellaneous Information | Instruction | FML.FAM_ADD_OTHER | Program, Life Event | |
| Second Medical Coverage | Instruction | FML.FAM_ADD_SECOND_MEDICAL | Program, Life Event | |
| Address | Help Tip | |||
| Name and Relationship | Hint (Suffix) | 92638 | __ | __ |
| Address | Hint (Postal Code) | 92639 | __ | __ |
| Miscellaneous Information | Hint (National Identifier) | 92640 | __ | __ |
| Miscellaneous Information | Hint (Date of Birth) | 92637 | __ | __ |
| Message (Required Field Missing) | 92601 | __ | __ | |
| Message (Invalid Birth Date) | 92598 | __ | __ |
| Region | Flex Name | Flex Code |
|---|---|---|
| Add or Update Family Members | Further Person Information | hrpersondevdfflex |
| Miscellaneous Information | Additional Contact Relationship Details | Add Cont Details D Flexfield |
The Benefits Enrollment Overview web page enables a participant to view a record of their current benefits and to enroll into a new set of benefits.
Hidden Fields: You can use the following regions to add the hidden Full Name field to the page and to remove the Name field if necessary.
BEN_OVW_SELECTIONS_TABLE
BEN_OVW_CVRD_DEPS_TABLE
BEN_OVW_BENEF_TABLE
BEN_OVW_PCP_TABLE
You can use the BEN_OVW_SELECTIONS_TABLE region to display a column for the taxable cost of a benefit. This column corresponds to a standard rate with an activity type of Self-Service Display, or--if you are displaying multiple rates for the compensation object--to the rate you have defined with 3 in the Self Service Display Order field. If you are displaying multiple rates, you can also display the Cost 2 (After Tax Cost) and Cost 4 (Miscellaneous) columns to show the rates you have defined with 2 and 4 in the Self Service Display Order field.
You can also use the BEN_OVW_SELECTIONS_TABLE region to display Coverage Start and End Date columns. These columns show the coverage start and end dates for each election.
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Enrollment Overview Content | Instruction | BEO.ENRL_OVERVIEW_CONTENT | Program, Life Event | |
| Flex Credits | Instruction | BEO.FLEX_CREDITS | Program, Life Event | |
| Flex Credit Summary | Instruction | BEO.OVERVIEW_FC_SUMMARY | Program, Life Event | |
| Flex Credit Rollovers | Instruction | BEO.FLEX_CREDIT_ROLLOVERS | Program, Life Event | |
| Benefit Selections | Instruction | BEO.OVERVIEW_SELECTIONS | Program, Life Event | |
| Covered Dependents | Instruction | BEO.OVERVIEW_CVRD_DEPS | Program, Life Event | |
| Beneficiary Enrollment Overview | Instruction | BEO.ENRL_OVERVIEW_BENEF | Program, Life Event | |
| Primary Care Providers Enrollment Overview | Instruction | BEO.ENRL_OVERVIEW_PCP | Program, Life Event | |
| Enrollment Overview Content | Message (No Enrollment Opportunity, Brief Message) | 92570 | -- | -- |
| Enrollment Overview Content | Message (No Enrollment Opportunity, Detail Message) | 92571 | -- | -- |
The Current Benefits Overview web page enables a participant to see a record of their current benefits.
Hidden Fields: You can use the following regions to add the hidden Full Name field to the page and to remove the Name field if necessary.
BEN_OVW_CVRD_DEPS_TABLE
BEN_OVW_BENEF_TABLE
BEN_OVW_PCP_TABLE
You can also use the BEN_OVW_SELECTIONS_TABLE region to display Coverage Start and End Date columns. These columns show the coverage start and end dates for each election.
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Current Benefits Overview Content | Instruction | CBO.CURRENT_OVERVIEW_CONTENT | Program | |
| Flex Credits | Instruction | CBO.FLEX_CREDITS | Program | |
| Flex Credit Summary | Instruction | CBO.OVERVIEW_FC_SUMMARY | Program | |
| Flex Credit Rollovers | Instruction | CBO.FLEX_CREDIT_ROLLOVERS | Program | |
| Benefit Selections | Instruction | CBO.OVERVIEW_SELECTIONS | Program | |
| Covered Dependents | Instruction | CBO.OVERVIEW_CVRD_DEPS | Program | |
| Beneficiary Overview | Instruction | CBO.OVERVIEW_BENEF | Program | |
| Primary Care Providers Overview | Instruction | CBO.OVERVIEW_PCP | Program | |
| Current Benefits Overview Content | Message (No Current Enrollment, Brief Message) | 92572 | __ | __ |
| Current Benefits Overview Content | Message (No Current Enrollment, Detail Message) | 92573 | __ | __ |
The Benefits Selection page enables a participant to select one or more plans in which to enroll.
You can control the user interface display format for plans and options in a program in the Benefits Selection page.
Use the New Enrollment Page field in the Benefit Self Service Display EIT to present the following features of plans and options within a program on the Benefits Selection page:
Columns:
Certifications: A pop-up window appears when the user scrolls the mouse over the certification icon for a compensation object.
Details: Users can click the Details icon to view further information for plans.
Coverage Start Date
Coverage
Expand and collapse view: Instead of the horizontal/vertical display of plans and options, users can expand and collapse compensation objects details.
To enable the New Enrollment page field, complete the following steps:
Assign the Benefit Self Service Display extra information type (EIT) to a responsibility. Use the Information Type Security window to link EITs to a responsibility. See: Setting Up Extra Information Types For a Responsibility.
Enable the user interface format for the required program.
Navigate to the Programs window.
Search for the required program.
Click Extra Information.
Select Benefit Self Service Display.
Click in the Details row. In the Extra Program Info DDF window, select Yes in the New Enrollment Page field.
Save your work.
Note: If you want to use this display format for programs, then you must enable the New Enrollment page field for each of your programs.
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Enrollment Selection Content | Instruction | BNS.ENRT_SELECTION_CONTENT | Program, Life Event | |
| Top Flex Credit Region | Instruction | BNS.ENRT_SELECTION_CR_TOP | Program, Life Event | |
| Bottom Flex Credit Region | Instruction | BNS.ENRT_SELECTION_CR_BOTTOM | Program, Life Event | |
| Selection Area | Instruction | BNS.ENRT_SELECTION_SELECT_AREA | Program, Plan Type, Life Event | |
| Selection Area | Help Tip (Certification Legend) | |||
| Selection Area | Help Tip (Enter Annual Rate Input Box, Long Tip) | |||
| Selection Area | Help Tip (Enter Rate Input Box, Long Tip) | |||
| Selection Area | Help Tip (Enter Benefit Amount Input Box, Long Tip) | |||
| Selection Area | Message (Enter Annual Rate, Long Tip) | BEN_ENRT_ANN_RTVAL_TIP | ||
| Selection Area | Message (Enter Rate, Long Tip) | BEN_ENRT_BNFTAMT_TIP | ||
| Selection Area | Message (Enter Benefit Amount Tip) | BEN_ENRT_RTVAL_TIP | ||
| Selection Area | Message (Tokens for above messages) | BEN_ENRT_SLECT_TIP_ANY_AMOUNT | ||
| Selection Area | Message (Tokens for above messages) | BEN_ENRT_SLECT_TIP_ANY_VALUE |
The Dependents Selection page enables a participant to add their dependents to a plan.
Note: For Advanced Benefits customers: if participant dependents are not displaying in this page, verify that you have linked the appropriate life events to the program or plan enrollment requirements in the Dependent Change of Life Event window.
Hidden Field: Use the BEN_ENRL_DEPEN_SELECTION_TABLE region to add the hidden Full Name field to the page and to remove the Name field if necessary.
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Dependents Selection | Instruction | -- | -- | |
| Dependents Selection | Instruction | DPS.ENRL_DEPENDENTS_CONTENT | Program, Life Event | |
| Dependents Selection | Hint (Dependent Table) | DPS.ENRL_DEPENDENTS_CONTENT_PL | Program, Plan Type, Plan, Life Event | |
| Dependents Selection | Message (Can't Designate) | 92588 | __ | __ |
The Beneficiary Selection page enables a participant to add their beneficiaries to a plan.
Hidden Field: Use the BEN_BENEF_SELECTION_TABLE region to add the hidden Full Name field to the page and to remove the Name field if necessary.
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Beneficiary Selection | Instruction (Page) | BFS.BENEFICIARY_CONTENT | Program, Life Event | |
| Beneficiary Selection | Instruction (Plan Level Table) | BFS.BENEFICIARY_CONTENT_PLAN | Program, Plan Type, Plan, Life Event | |
| Family Members and Others | Instruction | BFS.BENEFICIARY_CONTENT_FAMILY | Program, Plan Type, Plan, Life Event | |
| Organizations | Instruction | BFS.BENEFICIARY_CONTENT_ORGS | Program, Plan Type, Plan, Life Event | |
| Beneficiary Totals Table | Hint | |||
| Beneficiary Selection | Message (Can't Designate) | 92587 | __ | __ |
The Primary Care Provider page enables a participant to select a care provider. If your enterprise partners with a third party supplier of primary care provider information, you can configure this page to allow web-based searches of a database of provider information.
See: Configuring the Primary Care Provider Search Facility
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Primary Care Provider Selection Content | Instruction | Instruction | PCP.PcpSelectContentPageLevel | Program, Life Event |
| Primary Care Provider Selection Content | Instruction | Instruction | PCP.PcpSelectContentPlanLevel | Program, Plan Type, Plan, Life Event |
| Primary Care Provider Selection Content | Hint | __ | __ | |
| Primary Care Provider Selection Content | Message (Can't Designate) | 92567 | __ | __ |
Hidden Fields: You can use the following regions to add the hidden Full Name field to the page and to remove the Name field if necessary.
BEN_PCP_SEARCH_TABLE
BEN_PCP_SELECT_TABLE
On the Primary Care Provider Search page, you can use the BEN_PCP_SEARCH_CRITERIA region to add the hidden fields of Physician Group and Hospital. The hidden fields of Location, School, and Degree are reserved for future use.
For the Physician Group, Hospital, Language, and Specialty fields, you must load the available data as provided by your third party provider into the corresponding Lookup Codes--in the following order--using the Application Utilities Lookups window in the Professional User Interface.
BEN_PCP_MED_GRP
BEN_PCP_HOSPITAL
BEN_PCP_LANGUAGE
BEN_PCP_SPCLTY
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Primary Care Provider Search | Instruction | PCS.PCP_SEARCH | Program, Plan Type, Plan, Life Event | |
| Search | Instruction | PCS.PCP_SEARCH_CRITERIA | Program, Plan Type, Plan, Life Event | |
| PCP Result Table | Instruction | PCS.PCP_SEARCH_RESULT | Program, Plan Type, Plan, Life Event | |
| Ben PCP XML Request Params | Tip | |||
| Ben PCP XML Request Params | Message (No PCPs found) |
The Attachments page enables participants to upload documentation as part of the self-service benefits enrollment process.
Control the Display of the Attachments Page
The BEN: Attachments in Self-Service profile option controls the rendering of the Attachments page in the self-service benefits enrollment train. Set the profile option to Yes to make the Attachments page available to participants during the self-service benefits enrollment process. If the profile option is set to No, then this page is not displayed during the enrollment process.
Add Self-Service Instruction Messages to the Attachments Page and Page Regions
If you are using the Attachments page, then you can configure the self-service instruction messages in the Attachments page and the page regions using the Communication Types window. Navigate to the Communication Types window and use the following details to identify the page and regions to add the instruction messages:
| Region | Tip Type | Message Name | Required Communication Short Name |
|---|---|---|---|
| Attachments Page | Instruction (Page) | - | BPA.ATTACHMENT_CONTENT |
| Person Attachment | Instruction | - | BPA.PERSON_ATTACHMENT_CONTENT |
| Dependents Attachment | Instruction | - | BPA.DEPENDENTS_ATTACHMENT_CONTENT |
| Beneficiary Attachment | Instruction | - | BPA.BENEFICIARY_ATTACHMENT_CONTENT |
See: Defining Self-Service Instruction Text
The Confirmation page enables a participant to see a summary of their choices and a warning of any oversights or miscalculations they may have made.
Note: You can also use the Confirmation page to display a signature region for participants to print from their web browser. Use this region if you require a participant's signature as part of a benefits enrollment. Use the Personalization Framework to display the signature region for this page.
Benefits users can print a summary statement of their enrollment, along with their signature, to keep as a proof of their records or to submit to an HR Representative if required. They can also view, print, or save the summary as a PDF document instead. The statement page displays a summary of the participant's benefits enrollment along with any warning messages, oversights, or miscalculations the participant may have made during the enrollment. Depending on the participant's enrollment data and personalization on the page, the Confirmation Page displays the following:
Flex credits summary
Benefits selection
Covered dependents
Beneficiaries
Primary care providers
Signature region
To print a benefits confirmation statement, click Printable Page. The printable page prints only the relevant information, excluding navigation buttons, tip messages, instruction text, tabs, and other user interface components.
To open or save the statement as a PDF document, click Publish PDF. Choose Open or Save in the File Download dialog box. You can print the document once you open it.
If you want to change the layout of the PDF Confirmation page, you can configure a copy of the default RTF template that XML Publisher uses for this page, which is Benefits Enrollment Confirmation.
Hidden Fields: You can use the following regions to add the hidden Full Name field to the page and to remove the Name field if necessary.
BEN_OVW_BENEF_TABLE
BEN_OVW_CVR_DEPS_TABLE
BEN_OVW_PCP_TABLE
You can use the BEN_OVW_SELECTIONS_TABLE region to display a column for the taxable cost of a benefit. This column corresponds to a standard rate with an activity type of Self-Service Display, or--if you are displaying multiple rates for the compensation object--to the rate you have defined with 3 in the Self Service Display Order field. If you are displaying multiple rates, you can also display the Cost 2 (After Tax Cost) and Cost 4 (Miscellaneous) columns to show the rates you have defined with 2 and 4 in the Self Service Display Order field.
You can also use the BEN_OVW_SELECTIONS_TABLE region to display Coverage Start and End Date columns. These columns show the coverage start and end dates for each election.
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Ben Enrollment Confirmation Content | Instruction | BEC.ENRL_CONF_CONTENT | Program, Life Event | |
| Flex Credits | Instruction | BEC.FLEX_CREDITS | Program, Life Event | |
| Flex Credit Summary | Instruction | BEC.OVERVIEW_FC_SUMMARY | Program, Life Event | |
| Flex Credit Rollovers | Instruction | BEC.FLEX_CREDIT_ROLLOVERS | Program, Life Event | |
| Benefit Selections | Instruction | BEC.OVERVIEW_SELECTIONS | Program, Life Event | |
| Covered Dependents | Instruction | BEC.OVERVIEW_CVRD_DEPS | Program, Life Event | |
| Beneficiaries Enrollment Confirmation | Instruction | BEC.ENRL_CONF_BENEFICIARIES | Program, Life Event | |
| Primary Care Providers Enrollment Confirmation | Instruction | BEC.ENRL_CONF_PCP | Program, Life Event | |
| BEN_ENRL_CONF_WARNINGS | Message (Confirmation Success) | 92605 | __ | __ |
| BEN_ENRL_CONF_WARNINGS | Message (Action Item Warning) | 92606 | __ | __ |
| Region | Flex Name | Flex Code |
|---|---|---|
| Benefit Selections | Additional Ben Prtt Enrt Rslt F Details | N/A |
The Unused Flex Credits page provides a summary of the flex credits left unspent by a participant.
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Unused Flex Credits Content | Instruction | FLX.UNUSED_FLEX_CREDIT_CONTENT | Program, Life Event | |
| Unused Flex Credits Content | Instruction | FLX.UNUSED_FLEX_CREDIT_NONE | Program, Life Event | |
| Unused Flex Credits Content | Message (No Unused Flex Credits) | 92633 | __ | __ |
| Unused Flex Credits Content | Message | 92632 | __ | __ |
The Change Session Date page lets you test future-dated elections. For example, you may want to perform system testing before the start of an open enrollment period. This page should be removed in your production environment so that benefits participants do not alter their enrollment date.
See: Setting the Effective Date of a Scheduled Enrollment in Self-Service Benefits
| Region | Tip Type | Message Name |
|---|---|---|
| Session Date Content | Instruction | 92604 |
| Session Date Content | Tip (Effective Date) | 92637 |
The Temporary ID Card page lets a participant print an ID card which the participant can use to obtain medical, dental, or other benefit treatment before the participant receives the official membership card from the provider.
| Region | Tip Type | Message Name | Required Communication Short Name | Valid Communication Usages |
|---|---|---|---|---|
| Oracle Self-Service Human Resources Identification Card | Instruction | TMP.ENRL_TEMP_ID_PAGE | Program, Life Event | |
| Ben Temporary ID Card Content | Instruction | TMP.ENRL_TEMP_ID_PLAN | Program, Plan Type, Plan, Life Event | |
| Temporary ID Card | Instruction | TMP.ENRL_TEMP_ID_CARD | Program, Plan Type, Plan, Life Event |
You can access Self-Service Benefits What-if from the following menus and functions:
Menu and Function Names
| User Menu Name | Function Name |
|---|---|
| Manager Self-Service | Self-Service Benefits What-if Manager |
| Employee Self-Service | Self-Service Benefits What-if Employee |
You can configure the following definitions using the Personalization Framework.
Configurable Tips and Instructions
| Region | Tip Type | Message Name |
|---|---|---|
| Impact on Benefits Region | Header Text | BEN_93423_SS_WATIF_HDR_LABEL |
| Choose Winning Life Event Region | Message (Error) | BEN_93393_WATIF_CONFLICT_LER |
| Choose Winning Life Event Region | Instruction | BEN_93392_WATIF_CNFLT_LER_INS |
| Effective Date Region | Instruction | BEN_93389_WATIF_EFF_DATE_INS |
| Associated Data Changes Region | Instruction | BEN_93391_WATIF_DATA_CHG_INS |
| Impact on Benefits Region | Instruction | BEN_93394_WATIF_PG_INS_TEXT |
You can personalize the following columns to display them:
Seeded Hidden Columns
| Column Name | Displayed Detail |
|---|---|
| Reference Period | Activity Reference Period |
| Current Electable | Compensation objects currently electable |
| Current Coverage | Coverage information about currently electable compensation objects |
| Current Defined Amount | Defined Amount |
| What-If Electable | Compensation objects based on the what-if modeling |
| What-If Coverage | Coverage information about compensation object based on the what-if modeling |
| What-If Defined Amount | Defined Amount based on what-if modeling |