Settings of Service Apps in Service Manager
From: Service Manager versions 2022 - Build 2022.1.109.0.03
The configuration screen will differ:
- For on-premises customers as opposed to SaaS-based customers.
- Depending on the logged-in user's profile.
See Access rights
This screen is used to manage the Service Apps tenant and configure Service Apps team management rules.
- The tenant is a secure cage in Service Apps containing all of the customer's Service Apps data and apps.
- A single Service Manager user account is defined as the Service Apps platform administrator.
- Teams are groups of users authorized to access the same Service Apps apps with the same rights.
Notes
- When you modify information on the Service Apps tenant, you do not need to restart the smoServer service.
- Service Apps tenant management can also be performed in Service Apps, with limited options. You do this in the Admin Panel > Tenant Management.
- The Administration > Service Apps > Teams / Users screens are only accessible in read mode, irrespective of the logged-in user profile.
- You can manage team members and access rights to apps for each team in Service Apps by selecting Teams Management in the Admin Panel.
- You can manage users, user profiles and access rights to apps for each user in Service Apps by selecting Teams Management in the Admin Panel.
- The Service Apps tenant is associated with a single Service Manager account. This involves a single Service Apps tenant for the two accounts 50004 (production environment) and 50005 (development environment), and therefore a single URL for the two accounts.
Caution
- For SaaS-based customers, you must submit a request to the EasyVista CMC team in order to modify the logo to be displayed in Service Apps or to modify the method for the password reset procedure.
See Access rights
Best Practice
- If you want to have two tenants, and consequently, use two distinct URLs for the two accounts 50004 and 50005, please contact your EasyVista consultant.
Access rights
- On-premises or SaaS-based customers with a user profile without a tenant
- No configuration action can be performed on Service Apps administration.
- No configuration action can be performed on Service Apps administration.
- On-premises or SaaS-based customers with a user profile with a tenant
- Only information on the Service Manager user account and team management rules will appear.
- The Service Manager user account defined as the Service Apps platform administrator can be modified.
- Service Apps team creation rules can be defined.
- On-premises customers with a Service Manager platform administrator profile with a tenant
- They can perform all configuration actions on Service Apps administration.
- The Service Manager user account defined as the Service Apps platform administrator can be modified.
- Service Apps team creation rules can be defined.
- They can modify the logo in the login window and App Gallery in Service Apps. See the procedure
- They can access the options for managing the password reset procedure. See the procedure
- They can manage aliases in the dedicated tab.
Menu access
Administration > Service Apps > Parameter Settings
Description of tabs
Platform tab
Name: Name of tenant.
FQDN: Fully Qualified Domain Name of the tenant, corresponding to the folder name of the tenant on the drive, in the following format: com.folder_name.
Hostname: Hostname of the tenant, corresponding to the last subdomain.
https://{hostname}.{domain}.com
Log Level: Used to select the types of logs to be received when errors are detected on the Service Apps platform.
- Platform mode (default mode): The parameters used are those defined in the log.ini file.
- Custom: The parameters used are managed via the tenant. They enable you to select the types of logs you want, e.g. actions, information, errors or warnings.
Maintenance: Used to indicate whether the Service Apps platform is currently undergoing maintenance (box is checked) or if the platform is available (box is not checked). If the box is checked, when users log on, the login window will be replaced by a maintenance message.
Private Key / Password: Private key and password required for authenticating and calling contextual Service Apps apps from Service Manager forms.
Logo: Logo displayed in the Service Apps login window. See the procedure
- The logo will also be modified in the App Gallery.
- Only standard Web image formats are accepted, e.g. PNG, JPEG.
Download an image whose width is greater than its height. This is because even though there are no restrictions on the dimension and size of the image when downloading, the image will automatically be cropped or modified to fill the available space.
Forgot your password: Used to select the method you want to use when a password is forgotten.
- Enable: This displays the default link, Forgot your Password? used to run the standard procedure.
- Disable: No link is displayed.
- Overwrite: This replaces the default link with a URL you can customize.
App Center Manager: Service Manager user account defined as the Service Apps platform administrator, i.e. App Center Manager profile.
- The Service Apps platform administrator is the only one who can access user and team management in Service Apps via the Admin Panel.
Teams Creation Settings: Rules for managing teams based on Service Manager data.
- Create User's Groups as Teams:
- New Service Manager groups for the user will be added as Service Apps teams.
- The names of existing teams will be updated in the company language.
- Create User's Profile as Teams:
- New user profiles will be created as Service Apps teams.
- The names of existing profiles will be updated in the company language.
- Create User's Language as Teams:
- New user languages will be created as Service Apps teams.
- The names of existing languages will be updated (language name = LANGUAGE_SYSTEM_ALIAS column).
- Delete Removed Groups and Profiles from Teams:
- Teams associated with groups or profiles that no longer exist in Service Manager will be deleted.
- Teams associated with groups or profiles that no longer exist in Service Manager will be deleted.
Save: Used to save the Service Apps tenant configuration.
Create Teams: Used to create all teams immediately based on the management rules.
Delete Teams: Used to delete all teams immediately based on the management rules.
Alias tab
Alias Name: Name of the alias.
Hostname: Hostname of the alias.
Created on: Creation date of the alias.
Procedure: How to configure the Service Apps tenant
Step 1: In Service Manager, select the Service Apps platform administrator
1. Log in to Service Manager.
2. Select Administration > Service Apps > Parameter Settings in the menu.
3. Select the Service Manager user to be defined as the Service Apps platform administrator by selecting the App Center Manager box.
4. Click Save.
Step 2: In Service Apps, check that the tenant is correctly configured
1. Log in to Service Apps using the Service Apps administrator account.
2. Check that the user has administrator rights and can access the Admin Panel.
