Service Apps - The App Gallery

Last modified on 2023/04/27 11:44

The Service Apps App Gallery is specific to each customer. It displays all customer-specific apps for their activities and businesses, e.g. dashboards, portal, etc.

          Apps - Gallery overview.png

Notes

  • Access to the App Gallery is secured globally for the entire platform (access via a login and password), and individually for each app (using access rights specific to each user or team).
  • Its presentation may vary depending on:
    • The profiles of the logged-in user.
    • The screen definition/dimension for optimal use. If the resolution is less than 1012 pixels, certain elements, such as the app toolbar, will not be displayed.
  • You can define the storage duration for application history logs via the Administration screen of the platform in Service Manager.
    • Note: Only for on-premises customers with a Service Manager platform administrator profile with a tenant. SaaS customers must submit a request to the CloudOps team via the customer portal.
    • By default, logs are stored for 12 months.
  • Import/Export:
    • You can import apps in the App Gallery. You can export them in the App Gallery or in the graphic editor.
    • You can import themes in the App Gallery. You can export them in the theme editor.
    • You can import custom widgets in the App Gallery. You can export them in the graphic editor.

     Open url.png Also see remarks on:

Caution

  • When you delete an app, the action is final.

Best Practice

  • To create an app using an existing app, you can duplicate it provided you have the appropriate access rights. You can then work on the duplicate.
  • To create a new version of an app, duplicate the previous version and work on the duplicate.
  • When you import an app, you can duplicate it and work on the duplicate so that you can keep the original as a template.
  • If you need to deploy an app for several users, e.g. via a portal:
    • You should send authorized users a shortcut to the app instead of the app URL. Users can then add the shortcut to their favorites and run the latest production version of the app at any time, without having to make any modifications. Open url.png See shortcut management.
    • You should define access rights using the shortcut instead of the app.

Description of the App Gallery

The App Gallery is made up of the following zones:

  • (1) Toolbar
  • (2) A search field, used to search app titles and descriptions. It can also be used to filter search results in apps and shortcuts. Note: If there are no shortcuts, this zone will not appear.
  • (3) The list of apps/shortcuts, each with a contextual toolbar and an image showing a preview of its contents.
  • (4) A tag cloud formed dynamically based on the most frequently used keywords in app titles and descriptions.
    • The font size of a keyword depends on its frequency of use. More popular keywords are displayed in a larger font than less popular ones.
    • Click one of the keywords to display the relevant apps associated with it.
    • Click (X) at the top left to cancel this filter.
              Apps - Gallery.png

Toolbar

Note: The name of the icon may be displayed, depending on the device's screen size. When you move the cursor over certain icons, an infotip is displayed.

          Apps - Toolbar gallery.png

Logo icon.png: Open the About dialog box to see the minimum version required, the installed version of the Service Manager API and version information on Service Manager connectors.

  • Error messages are displayed in red.
            Apps - About information.png

Apps - Gallery - Admin panel icon.png Admin Panel (Note: Only for platform administrators): Used to open the Admin Panel.

Apps - Gallery - Create Application icon.png Create App: Used to open the graphic editor in create mode. 

  • The template library will appear.
  • You can create a new app using one of the templates, or you can create a new app with no content. Open url.png See the procedure.
            Template Library.png
     

Apps - Gallery - Create Shortcut icon.png Create Shortcut (Note: Only for platform administrators): Used to create a shortcut to an app. Open url.png See Screen description.
 

Apps - Gallery - Theme design icon.png Theme Design (Note: Only for users with access rights to create themes): Used to open the theme editor.

Apps - Gallery - Import icon.png Import: Used to import an app, a theme or a custom widget from a compressed file (.tar.gz format).

  • If the object you want to import already exists, you will be asked if you want to overwrite the existing one.
  • If a connector used by the imported app does not exist in the App Gallery, you must select it among the existing ones.
     

Apps - Gallery - Connectors icon.png Connector: This gives access to the connectors of the platform used to configure the connection parameters to data sources. 

  • The connectors defined via the gallery are available for all apps.
  • You can also define connectors in an app using the graphic editor. They will then be available only for this app.

AuthenticationZone

Apps - Authentication zone.png: User information zone. 

  • Apps - Logout icon.png: Used to close the platform.
  • Click the photo or name: Used to open the user information zone.

EVApps - Gallery - User Profile.png

  • Name, Email: Name and email address of the logged-in user. To associate a photo, click Apps - Upload icon.png.
  • Language: Language used to display error and system messages.

Note: The properties below are inherited from the logged-in user's platform (in Windows, this is specified in the Control Panel > Regional and Language Options). You can, however, overwrite them.

  • Date format: Format applied to dates.
  • Time format: Format applied to time.
  • Thousands separator: Character used to group thousands.
  • Decimals separator: Character used to indicate the decimal symbol.

Manage my External Accounts: Used to logged-in users to manage their personal accounts for accessing services with OAuth 2.0 authentication.

Notes:

  • Only if users can access services with OAuth 2.0 authentication using their own accounts.
  • You can define the services configured for connectors using the account defined in the connector.
    example   Connection to Tweeter:
    • Corporate tweets ==> users automatically have access to corporate timelines using the account defined in the connector. This account does not appear in the list.
    • Personal tweets ==> users must enter their own login information. The account appears in the list.

EVApps - Gallery - User Profile - Manage external resources.png

  • Service: Name of the service (or third-party application).
  • Visibility: Used to indicate if authentication is only for the logged-in user (Private) or for all users with access to the service via an Service Apps app (Public).
  • Account: Account associated with the service.
  • Apps - Delete icon.png: Used to delete the login information for the selected service.
    • Click Remove All to delete the login information for all services.
    • If the deleted information is used in an app, users of the app must once again log in manually.
EndAuthenticationZone

List of apps/shortcuts

         Apps - Gallery - List applications shortcuts.png

Description

  • Apps and shortcuts are displayed from most recently modified to least recently modified.
  • Apps - Shortcut icon.png Used to identify a shortcut.
  • Each app or shortcut contains several items of information:
    • (1) Title
    • (2) Description
    • (3) Image showing a preview of its contents
    • (4) Time elapsed since the last modification of the app (in hours, days, weeks and months), refreshed each time the App Gallery is displayed
    • (5) Toolbar that varies depending on the access rights of the logged-in user

Best Practice

  • When you delete an app, the action is final. You should export the app first if you want to keep a copy of it.
  • Before deleting the shortcut, you should ensure that the link is no longer used.
  • To find the shortcut you want quickly, use the search field at the top of the App Gallery and filter results using the Shortcuts option.

Execute mode

You can run an app or shortcut in the App Gallery. 

Run an app in the App Gallery What users see
  • You can click the name of the app or Apps - Shortcut icon.png for a shortcut.
  • You can also click the image. The cursor will change to Apps - Gallery - Run application.png.

Gallery - Execute application.png

  • The app will appear in a new web browser tab.

Gallery - Execute application - list.png


EVApps - Execution - List Applications icon.png: Used to show or hide the list of apps that users can access. Note: You configure it in the graphic editor.
  • Click the name of the app to run it.
  • If users are authorized to access only one app, then this app will run directly without first displaying the App Gallery.
ev sas - Help icon.png: Used to display the help page associated with the app. Note: You configure it in the general properties of the app.

App/Shortcut toolbar

Note: The toolbar varies depending on the profiles of the logged-in user.

Application Shortcut   Apps - Shortcut icon.png
Apps - Gallery - Toolbar Application.png Apps - Gallery - Toolbar Shortcut.png

.. hours/minutes: Time elapsed since the last modification of the app (in hours, days, weeks and months), refreshed each time the App Gallery is displayed.

Apps - Application properties icon.png: In apps, this opens the graphic editor in edit mode. In shortcuts, this displays the properties.

Apps - Gallery - Edit properties icon.png: Used to display the main app properties.

  • To display all properties, click Apps - Application properties icon.png to open the graphic editor and click Apps - Application properties icon.png in the editor toolbar.


Apps - Rights - Administer icon.png  (Note: Only for administrators of the app/shortcut or platform administrators): Used to define access rights to the app/shortcut.

Apps - Access rights for app.png

  • Name: List of users Apps - Access rights for app - User icon.png or teams Apps - Access rights for app - Team icon.png authorized to access the platform.
    • Select the ones who should have access rights to the app/shortcut.
    • Specify the rights.
  • Rights to the app:
UserApplicationsRights
  • Apps - Rights - Administer icon.png Admin: Users are authorized to administer the app but cannot modify or run it.
  • Apps - Rights - Edit icon.png Edit: Users are authorized to access the graphic editor to edit the app.
  • Apps - Rights - Execute icon.png Execute: Users are authorized to run the app but cannot modify it.

Notes:

  • Teams are always displayed at the top of the list.
  • Check the box in the table header to select or unselect all of the users/teams.
  • Users authorized to create an app will automatically have all rights to it.
  • Platform administrators (App Center Manager profile) do not appear in the table because they have all of the rights for all of the apps.
  • The access rights to an app assigned to users are taken into account if, at the very least, they have been assigned the Registered User profile.

Apps - Duplicate icon.png  (Note: Only for users whose profile is App Creator): Used to duplicate the app.

  • It will have the same name followed by the word, (Copy).
     

Apps - Gallery - Export icon.png: Used to export the app in a compressed file (.tar.gz format).

  • Click the icon to create and save the file in the folder you want.
  • Exported apps can be re-imported to another platform using the Apps - Gallery - Import icon.png Import function.
  • You can also click EVApps - GUI - Share icon.png to export it in the graphic editor.
     

Apps - Delete icon.png: Used to permanently delete the app/shortcut.

Procedures

How to define an employee password policy

     Open url.png See Management password in Service Manager.

EmployeePasswordPolicy_SMandApps_Procedure

   The password management has security against brute force attacks.

  • The policy applies to all Service Manager and Service Apps users.

Notes:

  • Only for users not managed in an LDAP directory or SSO tool.
  • Password definition rules apply only to passwords stored in the AM_EMPLOYEE table, for both Service Manager and Service Apps users.
  • Passwords must satisfy at least the following requirements: eight characters minimum (you can set this value), with at least one upper-case letter, one lower-case letter, one number and one special character.

Step 1: Run the dedicated wizard.

1. Select Administration > Access Management > Employees in the Service Manager menu.

2. Run the Definition of Password Policies wizard.

Caution: The configuration defined in the wizard applies automatically to all users, even if you only make a partial selection of users in the list of employees.

          Password policy wizard.png

Step 2: Define the password expiration rules.

1. Select the Enable the password expiration box.

The required fields for managing password expiration will appear.

2. Define the password expiration rules to be applied to your company.

  • If you want users to change their password on a regular basis, specify the frequency for doing so.
  • If you want users to change their password when they next log in to Service Manager/Service Apps, select the Expire all passwords now box.
     

Step 3: Define the password definition rules.

1. You can only modify the minimum number of characters for passwords.

You can not modify the other rules: at least one upper-case letter, one lower-case letter, one number and one special character.

Note: The default value of the minimum number of characters for passwords is defined in Other Parameters > {ADMIN} User passwords: minimum number of characters.

Step 4: Enable the Employee password policy.

1. Click Finish.

  • The password definition rules will take effect when users next log in to Service Manager/Service Apps.
  • When passwords are due to expire:
    • The last update date of the password will reset to blank in the AM_EMPLOYEE table (PASSWD_LAST_UPDATE_UT field).
    • An email will be sent to each user with a new temporary password.

Step 5: Users are required to change their password that is due to expire.

1. When passwords are due to expire, the Service Manager/Service Apps login window will display a message asking users to enter a new password.

2. Users must change their password.

  • Users must enter the temporary password sent by email in the Previous password field.
  • Users must enter and confirm their new password in plain text in the relevant fields and click OK.
             Password - New.png
  • The last update date for the password will be refreshed in the AM_EMPLOYEE table.
  • The new password will be encrypted and stored in the AM_EMPLOYEE table.

How to access the platform

1. Click the link to access the Service Apps platform.

2. Enter your login and password.

  • The Password field is case-sensitive.

3. Click EVApps - Gallery - Login icon.png.
        EVApps - Gallery - Login.png

Forgotten password

Note: The procedure varies depending on the configuration defined by the administrator.

  • Click Forgot your Password in the login page.
  • Enter your email address.
  • Click OK.
            EVApps - Gallery - Forgot Password.png

A temporary password will be sent to your inbox.

  • Log in to Service Apps using the temporary password.
    Note: If you use this password once the validity period has been exceeded, the login page will invite you to enter and replace it immediately.
PlatformAccessRights_Procedure

How to manage access rights to the Service Apps platform

Step 1: Access the Admin Panel

1. Log in to the platform using the App Center Manager profile.

2. Click Apps - Gallery - Admin panel icon.png Admin Panel in the toolbar.

Step 2: Assign user profiles

1. Click Apps - Admin panel - Users management icon.png Users Management.
The list of users authorized to access the platform will appear.

2. Select the profiles for each user.

Note: If you only want to assign the Registered User profile, return to the list of users. Unselect the App Center Manager, App Creator and Theme Designer profiles. Select the Registered User profile.

  • App Center Manager: Users are authorized to administer the platform. Note: If you select this profile, the user will also have the App Creator and Theme Designer profiles.
  • App Creator: Users are authorized to create apps.
  • Theme Designer: Users are authorized to create themes.
     

Step 3: Assign access rights to apps on the platform

1. Click the relevant user in the table of users.
The list of all apps on the platform will appear.

2. Select the apps the user needs to access.

3. Assign the access rights to these apps.

UserApplicationsRights
  • Apps - Rights - Administer icon.png Admin: Users are authorized to administer the app but cannot modify or run it.
  • Apps - Rights - Edit icon.png Edit: Users are authorized to access the graphic editor to edit the app.
  • Apps - Rights - Execute icon.png Execute: Users are authorized to run the app but cannot modify it.

Best Practice icon.png  You can assign access rights to apps in a batch.

  • Select the box in the app table header to select all apps.
  • You can then narrow down your selection by unselecting the apps you want to exclude.
  • Select the access rights to the selected apps.
    The selected apps will all have the same access rights.

4. Click OK.
 

Step 3: Return to the App Gallery

1. Click Apps - Admin panel - Back to store icon.png Back to Store.

How to customize the logo in the login window and App Gallery

CustomizeLogoProcedure

Note:  You must be authorized to access the Administration > Service Apps > Parameter Settings menu in Service Manager via your profile.

1. Go to the /var/www/argo/dist/resources/theme/logo folder on your server.

2. Replace the image file with your logo file.

  • 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 image dimension and size when downloading, the image will automatically be cropped or modified to fill the available space.

Login window App Gallery
Logo updating - Login page.png Logo updating - Gallery.png
EndCustomizeLogoProcedure

How to customize the password reset procedure in the login window

Note: You must be administrator ot the Service Manager platform.

Step 1: In Service Manager, define access to the password reset procedure

1. Log in to Service Manager.

2. Select Administration > Service Apps > Parameter Settings in the menu.

3. Select the method you want to use for the password reset procedure in the Forgot your password field.

  • To enable users to access the password reset procedure using the standard link, Forgot your Password?, select the Enable option.
  • To delete the link, select the Disable option.
  • To replace the link with another URL, select the Overwrite option.

4. Click Save.
 

Step 2: In Service Apps, check that the tenant is correctly configured

1. Log in to Service Apps using any account.

2. Check that the login window provides access to the correct password reset procedure based on your configuration.

Tags:
Powered by XWiki © EasyVista 2022