Service Portal pages are one of the entities used to structure the content. A page consists of containers and rows, which, in turn, consist of columns. Manage page layouts to reach the best user experience. For more information about portal structure, refer to the Page Structure and Portal Integration articles.
You should first consider the structure of the portal before configuring it, because an incorrectly configured portal may function incorrect. So it is recommended to carefully work out the portal structure in advance.
Portal pages are divided into containers that implement the page layout. Containers are divided into rows. Usually the container contains one row, but you can add more multiple rows. Rows are divided into columns. Specify the number of columns for a row based on your needs.
You can reuse portal pages provided by the vendor, based on them as templates. This workaround speeds up the page development process because you do not need to create it from scratch.
To create a page from scratch, navigate to Portal Structure → Pages and fill in the form as described in the Page Structure article.
Configure a page layout
To implement the responsive page layout, complete the steps below:
- Create a container within a page. Within a page, containers are placed in descending order based on the Created at field value and can be sorted by the Order field in the Container record form.
- Create rows within the container. Rows are container parts available for keeping the content items. They are placed in descending order based on the value of the Order field in the Row record form. The row can be divided into maximum 12 columns.
- Create columns in which you can place your widgets implementing portal logic.
- Define column width based on the Bootstrap grid system. You can specify a number defining how much row volume can this column take.
If the width is not specified, then the column takes up all the row width available (the same behavior as if the max value 12 was specified). If more than one column is used and the width is not specified, then the columns share the row space equally.
Example
You created a row with 2 columns in it. Your desired display conditions are as follows:
| Device class | Display condition |
|---|---|
| Desktop | Columns and content in them should be of equal width |
| Phones | Column 1 should take up 2/3 of the screen, column 2 should take up the rest. |
| Small laptops | Column 1 should take up 1/3 of the screen, column 2 should take up the rest. |
| Tablets | Column 1 should take up 1/3 of the screen, column 2 should take up the rest. |
Implementation
Specify values in the Large Devices, Medium Devices, Small Devices and Extra-Small Devices fields for the Column record forms as shown below:
| Large Devices (lg size) | Medium Devices (md size) | Small Devices (sm size) | Extra-Small Devices (xs size) | |
|---|---|---|---|---|
| Column 1 | 6 | 4 | 4 | 8 |
| Column 2 | 6 | 8 | 8 | 4 |
"12" is the maximum multiplier value for all columns in a row. In other words, column multiplier sum (if there are more than one column in a row) cannot exceed 12. For example, three columns can have multipliers (4,4,4), or (5,5,2), or any other combination which is 12 in sum.
If the multipliers sum exceeds 12, then the column moves to the new line.
Customize a portal header menu
The portal header contains a menu structure consisting of menu groups and items used for quick access to necessary business functionality ((for example, Service Catalog, or "My Tasks" (list of tasks a user is assigned to)). Portal header implements Tree Structures functionality, so it can be easily reconfigured.
In the cases below, we consider that you have a fully configured and functional portal structure. You can use vendor-provided portal pages and other items as a sample. Copy them and build your own portal basing on them, it may speed up the process.
To customize portal headers (that is, to add or delete items) in the most convenient way, please complete the steps below:
- Navigate to Portal Structure → Portals.
- Open the record of your portal.
- Click on the reference in the Header Navigation Menu and navigate into it.
- Create necessary records in the Node related list. Generally, you will need to specify only title, order and (optionally) parent item for your new item.
- To delete redundant records, select them and click Delete on the related list form.
- To move an item back and forth within the header, set the relevant Order value. Items are sorted in ascending order.
Portal header menu form fields
| Field | Mandatory | Description |
|---|---|---|
| Title | Y | Specify an item title to display in the header. |
| Active | Select this checkbox to make this item active or inactive. If the checkbox is not selected, the header item is not displayed. | |
| Tree | Y | In this field, specify a reference to the previously created tree containing node structure of the portal header menu. You can use baseline tree provided by vendor for this purposes. It is called Portal Header Menu and located in the Trees dictionary. |
| Order | Y | Specify an integer number to arrange items in the header. |
| General tab fields | ||
| Access criteria | N | Specify the User Criteria defining user access to this node (card or header element). If no criteria selected, then all users are allowed to use this element and its sub-elements as long as they are not protected by separate criteria. |
| Node type | N | Specify a node type by choosing from the previously created. |
| Nesting level | Y | Node nesting level. This field is populated automatically. This parameter shows on which nesting level this item is located at. |
| Parent | Y | Specify a parent item if you are implementing a structure with some nesting levels, like this: * Parent item 1 ** Child item 1 ** Child item 2 ** Child item 3 * Parent item 2 ** Child item 4 ** Child item 5 |
Extra attributes tab | ||
| URL | Y | Specify an URL for an item. In this field, you can specify either absolute or relative URL (relative to the current portal referring to the tree to which the current node is assigned): Absolute URL: https://instance.example.com/portal/profile Relative URL: /profile |
On the screenshots below, you can see a simple example of creating a catalog item.
Adde a portal header and footer
Portals allow deep control of their behavior. The header main menu helps to implement this control and it is one of the navigation anchors for users.
To configure a portal header menu, please complete the steps below:
- Navigate to Portal Structure → Container and create a container for a header or a footer, respectively.
- Create a row-and-column structure within this container and fill it in with necessary content (widgets, text, images).
- To define a container as a header or a footer, specify it in the Footer Container or Header Container field of the related portal record.
Assign a page as a homepage or a default 404 error page
A page can be opened by default, as a homepage, when a portal is referenced by its URL accompanied with the portal suffix (for example, https://instance.example.com/sp). This page, generally, contains major information for a wide range of users.
The 404 error page should be opened when some broken link has been opened during the navigation session.
You need to create a page first before completing these steps. Also, you can reuse the pages delivered by the vendor.
To set a page as a home page for a portal, please complete the steps below:
- Navigate to Portal Structure → Pages.
- In the list that appeared, find a record for the page you need to configure and navigate into it.
- Select the Use For Home Page checkbox if unselected.
- Click Save or Save and Exit to apply changes.
- Navigate to Portal Structure → Portals.
- In the list that appeared, find a record for the portal for which you need to add a homepage and navigate into it.
- Add the preliminary configured page in the Home Page field.
- Click Save or Save and Exit to apply changes.
To set a page as a default 404 error page, please complete the steps below:
- Navigate to Portal Structure → Portals.
- In the list that appeared, find a record for the portal for which you need to add a homepage and navigate into it.
- Add the preliminary configured page in the 404 Page field.
- Click Save or Save and Exit to apply changes.
