SailPoint Widget Library
Note
Widgetized architecture has been introduced in v4.0 to provide flexibility to configure and customize the behavior of the app. Widgets will be released and you will have the choice to select and customize them as per your business needs.
SailPoint has developed widgets that can be directly utilized in your Service Portal, record producer, or customized request pages to align with your specific business requirements. The widgets are as follows:
Note
- Base system widgets are designed as read-only components to allow you to take advantage of upcoming updates. If you wish to make modifications, you have the option to duplicate these base system widgets. It's important to note that duplicated widgets are classified as custom widgets and will not receive any future updates from the original widgets they were duplicated from.
-
To clone or create widgets, refer to Developing custom widgets in the ServiceNow documentation.
-
To view and configure the instance options for a widget, refer to Configure widget instances in the ServiceNow documentation.
ISC Access Object Details
Release Version: v4.0
This widget displays the details of the linked access profiles and entitlements when Details is selected.
Instance options for this widget: None
ISC Access Object Selection
Release Version: v4.0, Updated version: v4.1
This widget displays the tabbed search results for roles, access profiles, and entitlements. The visibility of tabs is dependent on the setup page settings. With this widget, users can choose the access objects effortlessly.
Instance options for this widget: Multiple
-
Items Per Page
-
Select the number of access objects to be shown in the widget.
-
-
Show Non-Requestable access objects under Add Access
-
A checkbox to show non-requestable objects under the Add Access tab.
-
-
Show Non-Revocable access objects under Remove Access
-
A checkbox to show non-revocable objects under Remove Access tab
-
-
Encoded Query for roles under Add Access
-
This is an optional parameter and must be used with caution. This is used to further filter the roles on top of result set retrieved from Identity Security Cloud.
-
-
Encoded Query for access profiles under Add Access
-
This is an optional parameter and must be used with caution. This is used to further filter the access profiles on top of result set retrieved from Identity Security Cloud. The query should be based on searchable fields. For more information, refer to Searchable Fields - SailPoint Identity Services.
-
-
Encoded Query for entitlements under Add Access
-
This is an optional parameter and must be used with caution. This is used to further filter the entitlements on top of result set retrieved from Identity Security Cloud. The query should be based on searchable fields. For more information, refer to Searchable Fields - SailPoint Identity Services.
Note
Encoded Query will be applied on page load. SailPoint recommends using this option judiciously as it might result in empty record set which would be confusing to end users as no warning is displayed.
Additionally, you must validate the scenario if the Native Search functionality is used. SailPoint recommends using different pages for the native search redirection and restricted user search functionality. -
ISC Access Object Selection 2
Release Version: v4.0, Updated version: v4.1
This widget allows you to select searched results of Roles, Access Profiles, and Entitlements in tabular mode.
Instance options for this widget: Multiple
-
Secondary Columns to be displayed (example: description, type, owner)
-
Ability to select secondary columns to be shown on the table. The Name and Details columns are mandatory and fixed.
-
-
Items Per Page
-
Select the number of access objects to be shown in the widget.
-
-
Show Non-Requestable access objects under Add Access
-
A checkbox to show non-requestable objects under the Add Access tab.
-
-
Show Non-Revocable access objects under Remove Access
-
A checkbox to show non-revocable objects under Remove Access tab
-
-
Encoded Query for roles under Add Access
-
This is an optional parameter and must be used with caution. This is used to further filter the roles on top of result set retrieved from Identity Security Cloud.
-
-
Encoded Query for access profiles under Add Access
-
This is an optional parameter and must be used with caution. This is used to further filter the access profiles on top of result set retrieved from Identity Security Cloud. The query should be based on searchable fields. For more information, refer to Searchable Fields - SailPoint Identity Services.
-
-
Encoded Query for entitlements under Add Access
-
This is an optional parameter and must be used with caution. This is used to further filter the entitlements on top of result set retrieved from Identity Security Cloud. The query should be based on searchable fields. For more information, refer to Searchable Fields - SailPoint Identity Services.
Note
Encoded Query will be applied on page load. SailPoint recommends using this option judiciously as it might result in empty record set which would be confusing to end users as no warning is displayed.
Additionally, you must validate the scenario if the Native Search functionality is used. SailPoint recommends using different pages for the native search redirection and restricted user search functionality.Note
Column names are case sensitive. -
ISC Selected Users
Release Version: v4.0
This widget displays the initials of the selected users. Hover the mouse cursor over the initials to view additional details. To remove the user, select the red x on the initials.
Instance options for this widget: None
ISC Review And Submit
Release Version: v4.0, Updated version: v4.1
This widget displays the line items of selected users and selected objects for adding or removing access. Select Validate/Submit to see related warnings and errors.
Instance options for this widget: Multiple
-
Display Expiration Date
-
When selected, the field is displayed. Deselect this option to hide the expiration date field.
-
-
Expiration Date Default Value
-
If the field is displayed, select the default value of the expiration date . If the field is hidden, the value will be ignored.
-
-
Expiration Date Mandatory
-
When selected, this forces the end users to have a value in the expiration date field.
-
ISC Review And Submit 2
Release Version: v4.0, Updated version: v4.1
This widget displays the line items selected for adding or removing access, with more emphasis on the Sunset Date and Comments.
Instance options for this widget: Multiple
-
Display Expiration Date
-
When selected, the field is displayed. Deselect this option to hide the expiration date field.
-
-
Expiration Date Default Value
-
If the field is displayed, select the default value of the expiration date . If the field is hidden, the value will be ignored.
-
-
Expiration Date Mandatory
-
When selected, this forces the end users to have a value in the expiration date field.
-
ISC Header Text
Release Version: v4.0
This widget displays the static text on every page, which is generally used to give instructions to end users. The HTML value of the text is extracted from the setup page.
Instance options for this widget: None
ISC Progress Bar
Release Version: v4.0
This widget tracks the progress of the requester.
Instance options for this widget: None
ISC Access Comment
Release Version: v4.0
This widget is used to accept the comments.
Instance options for this widget: None
ISC User Search
Release Version: v4.0
This widget is used to search for users.
Instance options for this widget: None
ISC Footer Buttons
Release Version: v4.0
This widget is used to move across the pages via the Previous, Next, and Cancel buttons. The position of the buttons can be aligned in the container, and is dependent on widget options.
Instance options for this widget (ServiceNow Admin user): Align the buttons to the edge or center.
ISC Login
Release Version: v4.0
Instance options for this widget: None
Image: N/A
This widget enables the necessary authentication to establish connections with SailPoint instances. It does not have a display component.
ISC Access Type
Release Version: v4.0
The visibility of this widget is dependent on the configuration of the setup page as well as users selected.
Instance options for this widget: None
ISC Sunset Date
Release Version: v4.0, Updated version: v4.1
This widget functions as a date picker specifically designed for selecting the Sunset date.
Instance options for this widget: Multiple
-
Display Expiration Date
-
When selected, the field is displayed. Deselect this option to hide the expiration date field.
-
-
Expiration Date Default Value
-
If the field is displayed, select the default value of the expiration date . If the field is hidden, the value will be ignored.
-
-
Expiration Date Mandatory
-
When selected, this forces the end users to have a value in the expiration date field.
-
ISC Access Object Search
Release Version: v4.0, Updated version: v4.1
This widget filters the requestable entitlements, access profiles and roles dependent on the criteria provided by the requester.
Instance options for this widget: Multiple
-
Default Filter
-
Choose a filter that will be chosen by default when the page loads. You can select Name, Description, Owner, Source, or Application. Keep -- None -- if you would like no pre-selection.
-
-
Default Operator
-
If the default filter is Name or Description, the default operator is applicable and allows you to select Contains ANY keywords, Contains ALL the keywords, or Is EXACT match. If the default filter --None-- is selected , Contains ANY keywords will be auto-selected for the default operator. If the default filter is Owner, Source or Application the default operator will always be Equals and this option will be ignored.
-
ISC User Selection
Release Version: v4.0, Updated version: v4.1
This widget lists all of the users by default, and gives the option to filter the users based on your selections.
Instance options for this widget (ServiceNow Admin user): Multiple
-
Number of user records to be displayed per page
-
Optional field names to display
-
Specify the ServiceNow user table field names separated with a comma, e.g., email,manager,department
-
-
Encoded Query
-
This is an optional parameter that must be used with caution. It is used to further filter the users on top of the result set retrieved from Identity Security Cloud.
By default, the manager will be able to see their own users along with team members. Admin and OnBehalfOf roles will retrieve all users. The widget option provides the ability to provide additional query parameters.
This encoded query will be applied on page load. We recommend using this option carefully as it might result in an empty record set, which could confuse end users since there is no warning message displayed.
If there are field level ACLs applied on any of the fields used in the encoded query, end users may see error messages logged on their screen. SailPoint recommends extensive testing with all personas before using this widget option. If you're using the Native Search functionality, it is recommended to validate the scenario, as well as use different pages for native search redirection and restricted user search functionality.
-
ISC User Selection 2
Release Version: v4.0, Updated version: v4.1
This widget allows you to select a maximum of 10 users via the dropdown.
Instance options for this widget (ServiceNow Admin user): Multiple
-
Optional field names to display
-
Specify the ServiceNow user table field names separated with a comma, e.g., email,manager,department
-
-
Encoded Query
-
This is an optional parameter that must be used with caution. It is used to further filter the users on top of result set retrieved from Identity Security Cloud.
By default, the manager will be able to see their own users along with team members. Admin and OnBehalfOf roles will retrieve all users. The widget option provides the ability to provide additional query parameters.
This encoded query will be applied on page load. We recommend using this option carefully as it might result in an empty record set, which could confuse end users since there is no warning message displayed.
If there are field level ACLs applied on any of the fields used in the encoded query, end users may see error messages logged on their screen. SailPoint recommends extensive testing with all personas before using this widget option. If you're using the Native Search functionality, it is recommended to validate the scenario, as well as use different pages for native search redirection and restricted user search functionality.
-