The App Gallery


Apps - Gallery overview.png

Product name - ev sas.png is a platform for apps that are specific to a customer's activities and business, e.g. dashboards, portal, etc. It is made up of an App Gallery that displays all of the apps available, design tools (graphic editor and theme editor) and monitoring tools.

  • Access to the App Gallery is secured (access via a login and password) generally for the entire platform and individually for each app (using access rights specific to each user). Open url.png See Access management.
     

Each app presents numerous items of information from different sources (e.g. Product name - ev itsm.png, CSV files, the Internet or third-party applications) displayed in different ways (e.g. chart, table, text or map).

Example documentation icon EN.png Number of open incidents, distribution of employees by country, percentage of disk space available

  • To help you design apps, Product name - ev sas.png provides standard libraries:
    • Data source library: All means of access to data sources, e.g. databases, files, websites, third-party applications. You connect to the data source using connectors.
    • Widget and custom widget library: All graphic components for displaying data and for defining the visual aspect of the app.
    • Template library: All apps that are ready to use, downloadable and easily customizable. Note: Depending on your access rights, you can also duplicate existing apps and adapt them to your requirements.
  • You can define the style guide of each app using a theme.
  • Apps are designed to run in Responsive mode, where the display will automatically be adapted to the device on which the app is run, e.g. PC, smartphone or tablet.
  • Each app can contain public pages, i.e. pages accessible to all users, and private pages, i.e. pages that contain data requiring user authentication. Open url.png See Public mode.
  • To deploy an app, you send users a link to the app which can be a direct URL or a shortcut (recommended).
  • You can export an app from a test environment in order to import it to the production environment.

Notes

  • The presentation of the App Gallery may vary:
    • Depending on the rights of the logged-in user.
    • Depending on the screen definition/size, to ensure optimal display. If the resolution is less than 1012 pixels, certain elements, such as the app toolbar, will not be displayed.
  • Each user in the App Gallery is assigned a profile and access rights to apps. Open url.png See access management.
    • Only platform administrators can add users and assign profiles.
    • Only platform administrators and app administrators can define access rights to an app.
  • 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 big icon.pngBest practice

  • You can use an existing app as a template and duplicate it.
  • 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 - Gallery - Toolbar Gallery.png

Product name - ev apps builder - big.png: Open the About dialog box to see the minimum version required, the installed version of the Product name - ev itsm.png API and version information on Product name - ev itsm.png connectors. Note: Error messages are displayed in red.

Example documentation icon EN.png  Version installed is earlier than the minimum version required, failed to connect to Product name - ev itsm.png

         EVApps - About Service AppStore.png

Apps - Gallery - Admin panel icon.png Admin Panel (Note: Only for platform administrators): Used to open the Admin Panel with access to different functionalities such as monitoring, platform access management, team management and email templates.

Apps - Gallery - Create Application icon.png Create App: Used to open the graphic editor in create mode. The Properties Window  will automatically appear.
 

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.

  • Each theme defines a style guide applicable to a group of apps.
     

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. These are available for all apps.

  • Note: 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

See the description of properties.

Name, Email: Name and email address of the logged-in user. To associate a photo, click Apps - Upload icon.png.

Customer: User account on the Product name - ev sas.png platform.

Current Password: Current password of the logged-in user. To modify it, enter the new password in the New field and confirm it in the Confirm new Password field.

System Message: Language used to display error and system messages.

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 (Note: Only if users can access services with OAuth 2.0 authentication using their own accounts): This enables logged-in users to manage their personal accounts for accessing services with OAuth 2.0 authentication.

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 Product name - ev sas.png 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.

Note: You can define the services configured for connectors using the account defined in the connector.

Example documentation icon EN.png   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.
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 big icon.pngBest 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 access rights 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

See the description of fields.

  • 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.

Note:

  • 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 access the platform

1. Click the link to access the Product name - ev sas.png 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

  • 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 Product name - ev sas.png 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 platform

Step 1: Log in to the platform.

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

2. Click Apps - Gallery - Admin panel icon.png Admin Panel.

Step 2: Define user access rights to the platform.

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

2. Click the relevant user in the table.
The Properties Window will appear.

3. Assign the appropriate access rights.

  • Select the user profiles.
    ConciseUserProfiles

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

    • App Center Manager: Users are authorized to administer the platform.
    • App Creator: Users are authorized to create apps.
    • Theme Designer: Users are authorized to create themes.
  • Select the apps the user is authorized to access and assign the access rights.
    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.

4. Click OK.
 

Add a user and define user rights

Delete user rights
Note: To temporarily deactivate access to the platform for specific users, you should not delete them. Instead, you should unselect all of their Profile boxes.

  • Check the box next to the relevant users.
  • Select Delete Users from the Action drop-down list.
    Their login information will automatically be deactivated.
     

Step 3: Return to the App Gallery.

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

NewUserAccess_Procedure

How to assign a new user access to the platform

Step 1: Log in to the platform.

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

2. Click Apps - Gallery - Admin panel icon.png Admin Panel.

Step 2: Create a new user.

: Click Apps - Admin panel - Users management icon.png Users Management.

2. Click EVApps - Access Management - Add User icon.png.

3. Specify the user information, i.e. name, email address, profile, password.

4. Define access rights to apps.

  • In the table, select the apps the new user is authorized to access.
  • Assign the rights for each app by selecting the relevant options.
    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.

5. Click OK.
You will return to the list of users.

Step 3: Define access rights to the platform.

1. Select the relevant Profile boxes for the user.
The information will automatically be taken into account.

UserProfiles
  • Apps - Apps center manager Profile.png App Center Manager
     Note: The App Creator and Registered User profiles will automatically be assigned to these users.
    • Users in charge of managing platform access. They have all of the rights for all apps on the platform.
    • Users authorized to create connectors other than easyVista IT Service Manager which are managed by Logo - EasyVista.png. They can also create aliases and execution contexts.
    • Users authorized to create and modify themes in the theme editor.
  • Apps - App creator Profile.png App Creator
    Note:  The Registered User profile will automatically be assigned to these users.
    • Users authorized to create new apps. They are authorized to duplicate the apps viewed even if they are not authorized to edit them.
    • Users authorized to create connectors other than easyVista IT Service Manager which are managed by Logo - EasyVista.png.
    • Users not authorized to modify themes.
  • Apps - Theme designer Profile.png Theme Designer
    • Users authorized to create and modify themes in the theme editor.
    •  Users not authorized to modify connectors, aliases or execution contexts.
  • Apps - Registered user Profile.png Registered User
    • Users authorized to run apps whose rights they have been assigned. They are not authorized to modify, duplicate or create apps.
    • Users not authorized to modify connectors, aliases or execution contexts.
    • Users not authorized to modify themes.
  • Apps - Public user Profile.png Public User
    • Users for whom certain parameters (e.g. language, domain, time zone, date and number formats) have been predefined. This user configuration is applied in the public pages of an app. Open url.png See Public mode.

 

Step 4: Send an invitation email.

1. Select Invite Users from the Action drop-down list.

2. (optional) Modify the text in the email template informing users that they can now access the platform.

3. Click EVApps - Access Management - Insert Tags icon.png to insert predefined tags.

4. Click Send Email.

Step 5: Return to the App Gallery.

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

Tags:
Last modified by Christine Daussac on 2019/04/02 13:53
Created by Administrator XWiki on 2014/08/26 10:23

Shortcuts

Recent Updates

Haven't been here in a while? Here's what changed recently:

-   Product name - ev itsm.png
-   Product name - ev sas.png

Interesting Content

How to Automate Integration
Add a Shortcut to an App
History
Quick Dashboard
Full text search - Stop Words

Powered by XWiki ©, EasyVista 2019