Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 widget.

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

  • Business Phone
  • Mobile Phone
  • Email
  • Timezone
  • Location
  • Department
  • Unit
  • Work Schedule

Info

The Static User Information widget does not display empty fields. That is, if some fields in the Employee record are not filled, they will be hidden.


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.

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


Tip

Role required: admin.

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

  1. Navigate to Portal Structure → Widgets.
  2. Open the record named Static User Information.
  3. In the Server Script field, find the line 

    Code Block
    languagejs
    themeEclipse
    titleServer Script
    const columnNames = [


  4. Add or delete column names in the lines below. 

    Info

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

    Tooltip
    onlyIcontrue
    appendIconinfo-filled
    iconColorblue
    linkTextHow to get system name

    To get the system name of a column from the Employee table, complete the following steps:

    1. Navigate to Organization → Employees.
    2. In the hamburger menu, select Configure → Table.
    3. In the Related Lists area, open the Columns tab.
    4. Using the search boxes or the Condition Builder, find the column you need.
    5. Copy the system name from the Column Name column.



  5. Click Save or Save and Exit to apply changes.


Tip

You can also change the field order by moving the lines with their system names in the Server Script field.


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.
Section


Column


Code Block
titleServer Script (before)
	const columnNames = [
                'business_phone',
                'mobile_phone',
                'email',
                'timezone_id',
                'location',
                'department',
                'unit',
                'work_schedule'
            ];



Column


Code Block
titleServer Script (after)
	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 to the Selected box.
  4. Click Save.


Configuring the widget fields

Users with the administrator role can manage the location and the content of the fields located in the Static User Information widget. Namely, it is possible to place the selected fields in the exact order within the specified line. 

To 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 to configure.
  3. А 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.

Code Block
[["business_phone","timezone_id","location"],["department","work_schedule"]]


Info

Each line is considered to be a cell that can be divided into numerous columns depending on the number of fields set. Thus, each line, regardless of the number of the columns it has, takes the full width of the widget.


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.

To go to the Caller profile, click the link icon .

Table of Contents
absoluteUrltrue
classfixedPosition
printablefalse