Versions Compared

Key

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

SimpleOne provides a number of predefined views for your basic system which you can customize to your business needs. These views specify what fields will be displayed in agent interface and on the Self-Service Portal (SSP).

These tables depict the out-of-the-box SimpleOne views which you can configure:

Form views
ViewInterfaceDescription
DefaultAgent

If no preferences set, a user will use this view in the agent interface. It is the basic view displaying most of the fields. If non-existent view is chosen in Preferences, the Default view will be used. 

PreviewAgentThe view displays read-only information about a record without transferring to the record. Learn more about the Preview view further in this article.
UserAgentThe form view is used in the agent interface for the Employee table. It has the same set of fields like the Default view of User.
SP View OnlyPortalThe form view is used on the SSP on the My Ticketstickets page for displaying information about cards created by the current user.
SPPortalThe form view is used on the SPP in the My Taskstasks page to display information about records: incidents, inquiriesuser queries, requests, change requests and problems. This card contains the Read Only Form widget.
Service CatalogPortalThe form view is used on the SSP for submitting an incident or an inquiry a user query from the Main page  (the Create Ticket card).
portalApprovalPortalThe view is used for displaying approval tickets on the SSP.


List Views
ViewInterfaceDescription
Default 

Agent

If no preferences set, a user will use this view in the agent interface. It is the basic view, displaying most of the columns. 
AnnounceViewPortalThis list view is used by the Announcement list page on the SSP.
SPPortal
Panel

SimpleOne provides a number of predefined views for your basic system which you can customize to your business needs. These views specify what fields will be displayed in agent interface and on the Self-Service Portal (SSP).

These tables depict the out-of-the-box SimpleOne views which you can configure:

Form viewsViewInterfaceDescriptionDefaultAgent

If no preferences set, a user will use this view in the agent interface. It is the basic view displaying most of the fields. If non-existent view is chosen in Preferences, the Default view will be used. 

PreviewAgentThe view displays read-only information about a record without transferring to the record. Learn more about the Preview view further in this article.UserAgentThe form view is used in the agent interface for the Employee table. It has the same set of fields like the Default view of User.SP View OnlyPortalThe form view is used on the SSP on the My Tickets page for displaying information about cards created by the current user.SPPortalThe form view is used on the SPP in the My Tasks page to display information about records: incidents, inquiries, requests, change requests and problems. This card contains the Read Only Form widget.Service CatalogPortalThe form view is used on the SSP for submitting an incident or an inquiry from the Main page (the Create Ticket card).portalApprovalPortalThe view is used for displaying approval tickets on the SSP.
List Views
ViewInterfaceDescription
Default 

Agent

If no preferences set, a user will use this view in the agent interface. It is the basic view displaying most of the columns. 
AnnounceViewPortalThis list view is used by the Announcement list page on the SSP.
SPPortalThis list view is used for lists on the SSP for the My Tasks, My Approvals, My CI, My Tickets pages.
Warning

Do not delete these system views as it may harm the system.

Adding a view Anchorcreate a new form viewcreate a new form view

Sometimes the out-of-the-box views are not displayed (like the Preview) or not added to the table you need.

For example, in case you create a new table for a process which needs approvals. As this table is new, the system does not have information about what fields it should display on the portal, and the ticket looks like this:

Image Removed

See the Configuring approval view section of this article to learn how to customize field set for approval tickets.

To configure the view, complete the steps below:

  1. On the record form, enter the hamburger menu Image Removed and select Configure → Form → Layout.
  2. In the Form view and section area, click Add new next to the View name field.
  3. In the window appeared, enter the desired view name and click Create.
    Image Removed
  4. Configure the fields order by moving them from the Available to Selected layout area.
  5. Click Save to apply changes.
Note

If you leave the configure menu without clicking the Save button, then the pop-up window will appear. Click OK to save changes or click Cancel to discard them.

Configuring preview form view Anchorpreview view sectionpreview view section

The Preview view name is reserved for the record read-only preview form. It provides brief information about the selected record. Call it by clicking on the record name in a reference field or on the information icon Image Removed on the list view. This form looks like this:

Image Removed Image Removed

Tip

Role required: admin.

To configure a preview form view, please complete the steps below:

  1. Open the record of a table you need to add a preview form.
  2. In the hamburger menu Image Removed, select Configure → Form → Layout.
  3. In the Form view and section area, click Add new next to the View name field.
  4. In the window appeared, enter Preview and click Create.
  5. Configure the fields order by moving them from the Available to Selected layout area.
  6. Click Save to apply changes.
Configuring approval view  AnchorportalApproval viewportalApproval view

The portalApproval view is used to display record fields on the portal Approval page. You can configure existing portal forms and rearrange the displayed fields or define a set of fields for a newly created table.

Image Removed

To configure the set of fields, perform the following steps:

  • Open the record of a table for which an approval is created.
  • In the hamburger menu Image Removed, select Configure → Form → Layout.
  • In the Form view and section, select the portalApproval view. 

    Info

    If the table does not have the view but has related approvals, click Add new and name it portalApproval. The system will retrieve this information to display exactly the selected fields.

  • Configure the fields order by moving them from the Available to Selected layout area.
  • Click Save to apply changes.
  • Configuring a portal form view

    Portals pages use form views defined in agent interface. Depending on the table, the portal widgets use different kinds of views: some retrieve layout information from heapselect elements, and some use widgets.

    To configure the set of fields of a form to be displayed on portal, perform the following steps:

    1. Open a record in the table for which you need to configure the portal view.
    2. In the hamburger menu Image Removed, select Configure → Form → Layout.
    3. In the Form view and section, select the view used by the widget instance.
    4. Depending on the widget, there are two ways to configure the layout:
      • move elements for the Service Catalog and Service Portal views. 

      • edit the Read Only Form widget properties for the SP and SP View Only views.
    5. Click Save to apply changes.

    To change the view that a widget instance uses, perform the following steps:

  • Open the widget instance (ListItem) displaying the records form you need to configure.
  • In the Schema Option Values field, enter the view name like this: 

    Code Block
    themeConfluence
    "itemView":"Custom View"

    See the Widgets Displaying article to learn more.

    Image Removed

    For example, the portal uses the SP view to display records from My Tasks page, and the SP View Only view for My Tickets page. To change the set of fields for incident records of My Tasks page, we will perform the following steps:

    1. Navigate to Incident Management → All Incidents and open any record.
    2. In the hamburger menu, select Configure → Form → Layout.
    3. In the Form view and section, select the SP view.
    4. Configure the layout.
    5. Click Save to apply changes.

    /

    Table of Contents
    absoluteUrltrue
    classfixedPosition
    printablefalse

    This list view is used for lists on the SSP for the My Tasks, My Approvals, My CI, My Tickets tasks, My approvals, Assets and equipment, My tickets pages.


    Warning

    Do not delete these system views as it may harm the system.

    Adding a view
    Anchor
    create a new form view
    create a new form view


    Sometimes the out-of-the-box views are not displayed (like the Preview) or not added to the table you need.

    For example, in case you create a new table for a process which needs approvals. As this table is new, the system does not have information about what fields it should display on the portal, and the ticket looks like this:

    See the Configuring approval view section of this article to learn how to customize field set for approval tickets.

    To configure the view, complete the steps below:

    1. On the record form, enter the hamburger menu and select Configure → Form → Layout.
    2. In the Form view and section area, click Add new next to the View name field.
    3. In the window appeared, enter the desired view name and click Create.
    4. Configure the fields order by moving them from the Available to Selected layout area.
    5. Click Save to apply changes.
    Note

    If you leave the configure menu without clicking the Save button, then the pop-up window will appear. Click OK to save changes or click Cancel to discard them.

    Configuring preview form view
    Anchor
    preview view section
    preview view section


    The Preview view name is reserved for the record read-only preview form. It provides brief information about the selected record. Call it by clicking on the record name in a reference field or on the information icon on the list view. This form looks like this:

    Tip

    Role required: admin.

    To configure a preview form view, please complete the steps below:

    1. Open the record of a table you need to add a preview form.
    2. In the hamburger menu , select Configure → Form → Layout.
    3. In the Form view and section area, click Add new next to the View name field.
    4. In the window appeared, enter Preview and click Create.
    5. Configure the fields order by moving them from the Available to Selected layout area.
    6. Click Save to apply changes.

    Configuring approval view 
    Anchor
    portalApproval view
    portalApproval view


    The portalApproval view is used to display record fields on the portal Approval page. You can configure existing portal forms and rearrange the displayed fields or define a set of fields for a newly created table.

    To configure the set of fields, perform the following steps:

    1. Open the record of a table for which an approval is created.
    2. In the hamburger menu , select Configure → Form → Layout.
    3. In the Form view and section, select the portalApproval view. 

      Info

      If the table does not have the view but has related approvals, click Add new and name it portalApproval. The system will retrieve this information to display exactly the selected fields.


    4. Configure the fields order by moving them from the Available to Selected layout area.
    5. Click Save to apply changes.

    Configuring a portal form view


    Portals pages use form views defined in agent interface. Depending on the table, the portal widgets use different kinds of views: some retrieve layout information from heapselect elements, and some use widgets.

    To configure the set of fields of a form to be displayed on portal, perform the following steps:

    1. Open a record in the table for which you need to configure the portal view.
    2. In the hamburger menu , select Configure → Form → Layout.
    3. In the Form view and section, select the view used by the widget instance.
    4. Depending on the widget, there are two ways to configure the layout:
      • move elements for the Service Catalog and Service Portal views. 

      • edit the Read Only Form widget properties for the SP and SP View Only views.
    5. Click Save to apply changes.

    To change the view that a widget instance uses, perform the following steps:

    1. Open the widget instance (ListItem) displaying the records form you need to configure.
    2. In the Schema Option Values field, enter the view name like this: 

      Code Block
      themeConfluence
      "itemView":"Custom View"


    See the Widgets Displaying article to learn more.

    For example, the portal uses the SP view to display records from My Taskstasks page, and the SP View Only view for My Ticketstickets page. To change the set of fields for incident records of My Taskstasks page, we will perform the following steps:

    1. Navigate to Incident Management → All Incidents and open any record.
    2. In the hamburger menu, select Configure → Form → Layout.
    3. In the Form view and section, select the SP view.
    4. Configure the layout.
    5. Click Save to apply changes.

    /


    Table of Contents
    absoluteUrltrue
    classfixedPosition
    printablefalse