Service Apps - The App Gallery
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.
- It is used to run apps.
- It provides access to:
- Design tools, e.g. graphic editor or theme editor
- Administration tools
- It is used to define the general properties and access rights of apps, and to duplicate, export and import them.
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.
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. See shortcut management.
- You should define access rights using the shortcut instead of the app.
- 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.
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.
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.
: 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.
Admin Panel (Note: Only for platform administrators): Used to open the Admin Panel.
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. See the procedure.
Create Shortcut (Note: Only for platform administrators): Used to create a shortcut to an app. See Screen description.
Theme Design (Note: Only for users with access rights to create themes): Used to open the theme editor.
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.
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
: User information zone.
: Used to close the platform.
- Click the photo or name: Used to open the user information zone.
- Name, Email: Name and email address of the logged-in user. To associate a photo, click
.
- 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.
- 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.
: 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
Description
- Apps and shortcuts are displayed from most recently modified to least recently modified.
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 |
|---|---|
|
 : Used to show or hide the list of apps that users can access. Note: You configure it in the graphic editor.
 : 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 |
|---|---|
 |
 |
.. 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.
: In apps, this opens the graphic editor in edit mode. In shortcuts, this displays the properties.
: Used to display the main app properties.
- To display all properties, click to open the graphic editor and click in the editor toolbar.
(Note: Only for administrators of the app/shortcut or platform administrators): Used to define access rights to the app/shortcut.
- Name: List of users
or teams 
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
- Admin: Users are authorized to administer the app but cannot modify or run it.
Edit: Users are authorized to access the graphic editor to edit the app.
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.
(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).
: 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 Import function.
- You can also click
to export it in the graphic editor.
: Used to permanently delete the app/shortcut.
Procedures
How to define an employee password policy
See Management password in Service Manager.
EmployeePasswordPolicy_SMandApps_Procedure
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.
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.
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.
- 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 
.
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.
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 Admin Panel in the toolbar.
Step 2: Assign user profiles
1. Click 
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
- Admin: Users are authorized to administer the app but cannot modify or run it.
- Edit: Users are authorized to access the graphic editor to edit the app.
- Execute: Users are authorized to run the app but cannot modify it.
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 
Back to Store.
How to customize the logo in the login window and App Gallery
CustomizeLogoProcedure
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.
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 | |
|---|---|---|
 |
 |
EndCustomizeLogoProcedure
How to customize the password reset procedure in the login window
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.