Page History

SimpleOne provides several comprised widgets for displaying read-only information on user queries, incidents, problems, requests, and change requests forms. One of them is the Static User Information widgetSA widget.

This widget retrieves information from the record referenced in the Caller field. By default, the following fields are information about the user is displayed:

• First and last name
• Job title
• Phone number
• Email address
• Company
• Business Phone
• Mobile Phone
• Email
• TimezoneLocation

Widget appearance

Image Removed

Widget appearance

1. Username – click on the username to open a relevant record in the Employee table.
2. Job title.
3. Fields with available information.

Image Removed

You can reorder widgets and fields using the Form Layout functionality.

To learn how to change the order of fields within the Static User Information widget, refer to the next section.

Configuring widget set of fields

To change the set of displayed fields, complete the following steps:

In the Server Script field, find the line 

const columnNames = [

Add or delete column names in the lines below. 

Please note that the script requires the system column names in a single quote marks, for example, 'business_phone' for the Business Phone column.  

For example, you want to hide the phone numbers and add the name of the employee's manager. To do that, perform the steps described below. In the Server Script field, make the following edits:

• Delete lines containing column names 'business_phone' and 'mobile_phone'.
• Add a new line containing the system column name 'manager' from the Employee table.

	const columnNames = [
                'business_phone',
                'mobile_phone',
                'email',
                'timezone_id',
                'location',
                'department',
                'unit',
                'work_schedule'
            ];

Image Added

1. User's first and last name.
2. Job title. This field is hidden if the corresponding column in the user's record is empty.
3. Phone number. This field is hidden if the corresponding column in the user's record is empty.
4. Phone number copy button. Click the button to copy the phone number into the clipboard. A corresponding toast message appears.
5. Email address. This field is hidden if the corresponding column in the user's record is empty. Click the email address to send the caller a message using the default email application on your device.
6. Email address copy button. Click the button to copy the email address into the clipboard. A corresponding toast message appears.
7. Fields with available information. You can configure the displayed fields and their layout.
8. User's profile link. Click it to open the user's record in the User (user) table. 

Add the widget to a form

To add the Static User Information SA widget to record forms of a specific table,

	const columnNames = [
                'email',
                'manager'
                'timezone_id',
                'location',
                'department',
                'unit',
                'work_schedule'
            ];

Adding a widget to custom ITSM essence

To add the Static User Information widget to a custom ITSM table, extended from the ITSM Task table, perform the following steps:

1. Open the custom table form.
2. In the hamburger menu, select Configure → Form → Layout.
3. From the Available box, move the Static User Information widget SA widget to the Selected box.
4. Click Save.

Configure the widget fields

Users with the administrator role can manage the location and the content of the fields located The fields displayed in the  Static User Information  widget. Namely, it is possible to place the selected fields in the exact order within the specified line. SA widget are organized into rows and columns. The rows can have different number of columns. Each row, regardless of the number of the columns it has, takes the full width of the widget. If a field has no value, the 'not set' placeholder is displayed in the corresponding column.

To change the displayed fields and their layout, perform the following stepsTo change the widget layout:

1. In the hamburger menu of the form where the widget is located, go to Configure → Form → Layout.
2. In the Selected box, select the widget you want need to configure. А window with the Schema Option Values field appears on the right. Change the order and the content of the fields in each raw of the widget. If a field has no value, it is filled with the 'not set' placeholder.

For example, the following settings refer to setting three fields in the first line and two fields in the second line.

2. Specify the system names of columns you need to include in the widget. Format them as shown in the example below.
   

   Code Block
   theme Eclipse title Schema option values
   [["business_phone","timezone_id","location"],["department","work_schedule"]]

The Static User Information widget may contain the telephone number and email of a user, if one of them or both not set, this filed is not displayed. With the Copy buttons, you can copy the Caller's telephone number and the email address, if provided. When doing so, a toast-message appears stating that the information has been saved to the buffer. Clicking the email address initiates a new email in the email application set by default on the user's computer, where the To field is pre-filled.

Image Removed

1. These settings result in a widget with three columns in the first row and two columns in the second row.

2. Click Save.

/