Settings of Service Apps in Service Manager

Last modified on 2022/10/20 16:30

From: Service Manager 2022 - Build 2022.1.109.0.03

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

  • The configuration screen displayed will depend on the logged-in user's profile. Open url.png See Access rights
  • 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.

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 based on the logged-in user's profile

  • Users without a tenant
    • Users cannot perform any configuration action on Service Apps administration.
  • Users with a tenant
    • Users can only see information on the Service Manager user account and team management rules.
    • They can modify the Service Manager user account defined as the Service Apps platform administrator.
    • They can define Service Apps team creation rules.
  • Service Manager administrators with a tenant
    • They can perform all configuration actions on Service Apps administration.
    • They can modify the Service Manager user account defined as the Service Apps platform administrator.
    • They can define Service Apps team creation rules.
    • They can modify the logo in the login window and App Gallery in Service Apps. Open url.png See the procedure
    • They can manage the options for accessing the forgotten password procedure. Open url.png See the procedure
    • They can manage aliases in the dedicated tab.

Menu access

Administration > Service Apps > Parameter Settings

Description of tabs

          Parameters Settings Service Apps.png

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. Open url.png See the procedure

  • The logo will also be modified in the App Gallery.
  • Only standard Web image formats are accepted, e.g. PNG, JPEG.

Caution

  • You must not modify the name of the image.
  • You must clear the cache, or log out and log in again to apply the changes.

Best Practice icon.png  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.
       

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.

          Access to Service Apps Admin panel.png

Tags:
Powered by XWiki © EasyVista 2022