- Welcome to the EasyVista Wiki
- Self Help - Overview
- Self Help - The evSH Skin
Self Help - The evSH Skin
The evSH skin is used to configure the Self Help customer portal. This includes the structure and layout of the Home page and procedures, the visual appearance using fonts, colors, or button shapes, the choice of images in the logo or banner, the names of titles, headings and browser buttons, the icons accessible in the portal toolbar, etc.
- It is automatically shipped with the setup of the Self Help application.
- Depending on the configuration of the procedure, the page may contain a toolbar.
See the description.
- Contextualization rules are used to filter the content of portal procedures based on the groups to which the user belongs.
See the example.
Notes
- The evSH skin is based on CSS stylesheets and HTML files managed by EasyVista.
- It is available in three languages, i.e. en_US, fr_FR and es_ES.
- To add another language, please contact your EasyVista consultant.
- By default, users belonging to a group are authorized to access all Self Help projects on the customer portal designed using the evSH skin.
- The toolbar displayed can be customized for each procedure in edit mode in the Desktop Studio. Only the knowledge manager and the domain administrator can perform this configuration.
See the procedure.
Caution
- To configure the evSH skin, users must be very familiar with HTML and CSS. This is why any modification desired should be made by your EasyVista consultant based on your requirements.
Best Practice
- Configure the toolbar based on user requirements for each of the procedures.
example
- Display the Pause
icon only when several user journeys can be managed simultaneously.
- Display the Comment
icon for specific user groups or only during the testing phase to prevent too many messages being sent to writers.
Applying the evSH skin to the customer portal
Home page
Self Help procedure
Toolbar in Self Help procedure pages
See Detailed description of the customer portal.
Icon | Description | Display management | |
---|---|---|---|
![]() |
Used to pause the current procedure and resume it at a later time. | Enabled or disabled for all portal procedures. By default, the icon is not displayed.
|
|
![]() |
Used to display the history of pages consulted. | Disabled only via the evSH skin. By default, the icon is displayed.
|
|
![]() |
Used to display the flow chart of the entire procedure. | Enabled or disabled based on user groups.
|
|
![]() |
Used to generate the execution report of the current procedure. | Enabled or disabled based on user groups.
|
|
![]() |
Used to display a message in the execution report of the procedure. Depending on the configuration, the message can also be sent by email to the writer of the procedure. | Enabled or disabled based on user groups.
|
|
![]() |
Used to run an escalation procedure, e.g. open a ticket, send a message, etc. | Enabled or disabled for all portal users using the specific oncall alias.
|
|
![]() |
Used to generate a link to the current procedure. The URL can then be copied to the clipboard or sent by email. | Disabled only via the evSH skin. By default, the icon is displayed.
|
Procedures
How to customize the toolbar in portal procedures
See Description of the toolbar.
Display the Pause icon
Note: The configuration of the icon applies to the entire portal. It is enabled or disabled for all procedures.
1. Enter the URL for accessing the customer portal in the URL bar of your Web browser.
2. Add the instruction ?allowpause=true at the end of the URL.
example
https://<your server>.com/custom/evSH/?allowpause=true#<project_versionNumber>
Disable customizable icons via the evSH skin
Note: To disable the History , Share
icons, the CSS stylesheets for the evSH skin must be modified. Please contact your EasyVista consultant to perform these modifications.
Caution: The EasyVista Support team will not resolve any issues related to the customization of the evSH skin done by customers themselves and its impact on customer platforms.
Enable customizable icons based on groups
The Overview , Report
, Comment
icons may be enabled / disabled independently from each other.
1. Open the Desktop Studio in publish mode.
2. Open the User groups section in the tree structure of the Explorer pane.
The list of authorized groups for the domain will appear.
3. Click the group for which you want to add the icons.
The list of published Self Help projects will appear.
4. Enable the icons by selecting the relevant box.
- To enable the Overview
icon, check the Map box.
- To enable the Report
icon, check the Report box.
- To enable the Comment
icon, check the Feedback access box.
Check the Comment box if you want to send the message by email to the writer.
5. Repeat these actions for each group with access to the icons.
Your modifications will automatically be saved.
Display the Escalation icon
Note:
- The escalation procedure must first be created.
- Only one escalation procedure can be associated with a given Self Help domain.
Create the escalation procedure in the Self Help project associated with the portal project.
1. Publish the Self Help project associated with the customer portal in edit mode.
2. Switch to publish mode.
3. Open the Reserved aliases section in the tree structure of the Explorer pane.
4. Associate the escalation procedure with the oncall alias.
- Right-click the oncall alias.
- Select Associate a procedure from the contextual menu.
The list of Self Help project procedures will appear. - Select the procedure to be run when the Escalation
icon is enabled.
- Click Save.
example Escalation procedure containing two steps:
- Page step: Contains a form where users can type their message.
- Action step: Used to send the form by email to the Support team.
Result on the customer portal
- The user clicks the
icon.
- The form is open.
- The message is sent by email to the Support team.
How to filter portal content by group
FilterProceduresViaGroups
See the example.
Step 1: Add a specific item of metadata to the Self Help project associated with the customer portal.
1. Select the Self Help project in the tree structure of the Explorer pane.
2. Select the Properties view.
The Self Help project properties will appear.
3. Select the Metadata Definition tab.
4. Click in the toolbar to create the new item of metadata.
5. Complete the information for the new item of metadata, authorizedGroups.
Step 2: Add the authorized user groups to each procedure.
1. Click to expand the tree structure of the Self Help project.
2. Select the procedure to be filtered by group in the Explorer pane.
3. Select the Properties view.
The properties of the procedure will appear. The new item of metadata, authorizedGroups, will appear at the bottom of the list.
4. Specify the groups authorized to access the procedure in the authorizedGroups property.
Note:
- Separate each group using the comma, semicolon, vertical bar or slash , ; | /.
- You can use the attribute management function.
5. Repeat these actions for each procedure to be filtered by group.
Step 3: Check that information is correctly filtered by group.
See the example: Filter procedures on the customer portal
1. Go to the customer portal.
2. Select one of the groups you are authorized to access.
3. Check that only the procedures associated with this group are available.