Tab widget mapping form
Summarize
Summary of Tab widget mapping form
The Tab widget mapping form allows ServiceNow customers to configure and control the display of widgets on specific tabs within the Employee Profile page. It enables setting widget visibility, order, accessibility, and user control over visibility settings to tailor the profile experience for various user roles and groups.
Show less
Key Features
- Name: Defines the widget-mapping record name and is used as the widget title in the interface.
- Application: Selects the application context (e.g., Employee Center Pro) for the tab widget.
- Active: Option to activate or deactivate the widget on the tab.
- Order: Sets the display order of widgets on the tab.
- Tab: Associates the widget with a unique tab name.
- Accessible by: Controls which user roles (e.g., Employee only, Manager only, Everyone) can view the widget.
- User criteria: Refines widget visibility based on specific users, groups, or roles using 'Available For' and 'Not Available For' user groups, with exclusion groups taking precedence.
- Allow employee to control visibility: When enabled (for applicable roles), employees can edit widget visibility on their profile via the embedded Public Profile Visibility widget. This setting overrides admin-defined accessibility settings.
- Widget: Selects the widget to display on the tab. Widget visibility on the UI should be indicated by setting
data.isVisible = truein the server script. - Widget parameters: Allows passing specific parameters for widgets, such as enabling email or SMS features or setting calendar views.
Practical Considerations
- Limit the number of widgets per tab to a maximum of seven to maintain optimal load times (approximately 250 ms).
- Use caution with user criteria as complex criteria can increase profile page load time.
- Embedding the Public Profile Visibility widget enables employees to manage the visibility of their profile information directly, improving user autonomy.
- Settings in "Allow employee to control visibility" take precedence over admin settings defined in "Accessible by."
Usage and Integration
To enable employee control over widget visibility, embed the Public Profile Visibility widget using the sp-widget directive with appropriate options. This integration allows employees to update their profile widget visibility preferences, which are stored in the user preference table for persistence.
Related Concepts and Tasks
- Managing profile tabs and visibility in Employee Profile.
- Configuring mail and SMS sending options within widgets like Employee Schedule.
- Understanding user criteria and their impact on widget visibility.
- Embedding and customizing widgets using widget parameters for tailored functionality.
You can use the tab widget mapping form to display widgets on a tab and control their visibility.
| Field | Description |
|---|---|
| Name | Name of the widget-mapping record that is available in the widgetTitle variable of the widget options object. Use this variable value as the widget title. |
| Application | Application of the tab. For example, you can select one of the applications such as Employee Center Pro or Employee Center Pro Kiosk. |
| Active | Option to activate the widget in the tab. |
| Order | Order number in which you want the widget to appear on the tab. |
| Tab | Unique name of the tab that you want to associate with. |
| Accessible by | Users who can view the widgets.
|
| Allow employee to control visibility | This field appears only when you select one of the Employee only, Employee and manager, or Everyone options. Note: When you select the value as true, employees can see the edit option used to modify the visibility settings. The modified visibility setting
(employee_profile.widget_visibility) is stored in the user preference table. To view and change the visibility setting, embed the Public Profile Visibility widget
inside the configured widget. Note: Settings configured in the Allow employee to control visibility field take precedence over the
settings configured in the Accessible by field to display the information. Employees can change the admin configuration and determine how much of the profile information is visible to the
public. Here’s a sample code for invoking the Public Profile Visibility widget.
This field value is available in the isUserSelectionEnabled variable of the widget options object. |
| Widget | Widget to display on the tab. Note: Only when you map a widget to the tab, the information displays inside the tab on the employee profile page. When the widget is visible on the UI, set the isVisible variable value to true in the server script data object to indicate the widget visibility. For example, data.isVisible = true. For optimal tab load time, use a max of seven associated widgets, which can take 250 ms or equivalent. Note: If the widget type is Employee Profile Overview, you can select the set of sections to be displayed under this widget. |
| Widget parameters | Comma-separated list of widget parameters auto-populated with default values. For the Employee Schedule widget, to send Email or SMS, specify the widget parameters For default calendar view, specify |