4.1 Overview

Applications Portal leverages the capabilities of a unified endpoint management solution to provide an enhanced user experience. The features include:

    • A brand new user interface that serves as a single place for all Endpoint Management user functionality on Windows.

    • An integrated search to help you find the app of your choice. The search includes full and split pattern matching by name, description, and contact information.

    • You can pin and unpin bundles to the Desktop, Taskbar, and Start menu tiles.

This document includes the following:

4.1.1 Launching Applications Portal

You can launch Applications Portal by using any of the following options:

  • Click the Agent Tray Icon from the system tray.

  • Press the Windows logo key, and then type Applications Portal.

4.1.2 Launching help

You can launch Applications Portal help by using any of the following options:

  • Select the Hamburger menu and click Help.

  • On the system tray, right-click the Agent Tray Icon and click Help.

4.1.3 About Endpoint Management

You can view Endpoint Management details such as build version, agent version, configuration location, device name, and user name:

  • Select the Hamburger menu and click About.

4.1.4 Launching Applications Portal using the Command Line Switches

Open the command prompt and execute the zapp-launcher command. By default, ZAPP-Launcher is started from the Run registry keys.

For example: To disable the Close option for Applications Portal, append the /s option to the following registry keys: For 32-bit Operating Systems:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run]

ZAPP=C:\Program Files\OpenText\Endpoint Agent\bin\zapp-launcher.exe /runonce /s

Registry key Type: REG_EXPAND_SZ

For 64-bit Operating Systems:

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run]

ZAPP=C:\Program Files\OpenText\Endpoint Agent\bin\zapp-launcher.exe /runonce /s

Registry key Type: REG_EXPAND_SZ

IMPORTANT:

  • If Applications Portal is already running and you want to launch it again with other command line parameters, kill all instances of Applications Portal and then execute zapp-launcher with the new parameters.

  • Command line parameters set before an agent update is retained after agent is updated.

The following command line switches can be used when starting the Applications Portal Window using zapp-launcher:

Switch

Description

/?

Example: zapp-launcher /?

Displays Help. If Applications Portal is launched with invalid parameters, help is displayed.

/max

Example: zapp-launcher /max

Displays the Applications Portal window maximized when first loaded, overriding the window state (size and position) that was saved when exiting the previous Applications Portal window session.

/min

Example: zapp-launcher /min

Displays the Applications Portal window minimized when first loaded, overriding the window state (size and position) that was saved when exiting the previous Applications Portal window session.

/norm

Example: zapp-launcher /norm

Displays the Applications Portal window in its original state when first loaded, and maintains the window state (size and position) that was saved when exiting the previous Applications Portal window session.

/runonce

This command is used for internal purposes and it is located at HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Run. Ensure that you do not delete it.

/s

Example: zapp-launcher /s

Enables the Applications Portal window to behave like the Windows shell. For example, on the Hamburger menu, the standard Windows Power Options are displayed. The Close option is not available.This is not a true replacement for the Windows shell. If users minimize the Applications Portal window, they have access to the normal desktop.

/d

Example: zapp-launcher /d

Displays the Applications Portal window without the Help option on the Hamburger menu and System Tray. So, you cannot view the help.

4.1.5 Launching Technician Portal

To launch Technician Portal: Right-click the Agent Tray Icon and click Technician Portal

4.1.6 Refreshing the Agent

You can refresh the agent by using any of the following options:

  • Select the Hamburger menu and click Refresh.

  • Click the Refresh icon in the status bar.

  • Right-click the Agent Tray icon and click Refresh.

4.1.7 Searching bundles and folders

The Search option enables you to search the required bundles and folders with name, description, and contact information. Even if a particular folder is selected the search is performed across the application.

4.1.8 Viewing bundles and folders using the icons

The following views are available:

  • : Icon View displays icons of bundles and folders.

  • : Detailed View displays folders and bundle information such as name, version, and status. You can sort the bundle as required.

  • : Toggle Tree View displays and hides the left pane folder view.

4.1.9 Viewing the bundle progress status

To view the bundle progress status:

  1. Select the Hamburger menu and click View Progress.

    In the Progress Status you can retry on bundle failure, pause and resume while downloading bundle content.

You can also clear the bundle progress by right-clicking the progress status and click Clear.

4.1.10 Viewing and using the bundle actions

To view and use the bundle actions:

  1. Select a bundle and right-click.

    • Open: Performs install and launch actions. If any install action set is specified in a bundle, then it installs else it executes launch action set, if specified.

    • Repair: Re-runs the install action set. This option is enabled only if a bundle has the install action. This is same as Verify in NAL.

    • Uninstall: If this option is enabled for a bundle it will undo the install actions. This option is enabled only if administrator has configured the uninstall action.

    • Send to Desktop: Creates a shortcut of bundle on the Desktop.

    • Set as Favorite: Marks a bundle as a Favorite.

    • Remove as Favorite: Removes the Favorite tag from a bundle.

    • Pin to Start: Pins the bundle to the Start.

    • Pin to Taskbar: Pins the bundle to the Taskbar.

    • Remove from Desktop: Removes the bundle from the Desktop.

    • Unpin from Start: Unpins the bundle from the Start.

    • Unpin from Taskbar: Unpins the bundle from the Taskbar.

    • Properties: Displays bundle details such as name, status, description, contacts, and failure messages in case of system requirements failure.

    IMPORTANT:The Pin and Unpin options are not displayed for a location if the bundle is already assigned to the same location by the administrator. Start and taskbar options are not displayed if the administrator sets the Allow the end user to pin bundles option as No or Unconfigured in the Application Explorer Configuration Policy or if there are no Application Explorer Configuration Policies.

4.1.11 Cleaning up the Bundle Shortcuts

To clean up the bundle shortcuts that are created by an Endpoint Management user:

  1. Select the Hamburger menu and click Cleanup user settings.

  2. In the Warning window, select Yes.

4.1.12 Accessing options through shortcuts

You can use the following shortcuts:

  • Tab: To navigate between panes (Toggle Tree View, Icon View, and Detailed View), folders, and bundles. After an element is highlighted, press Enter to perform the related operation.

  • Shift + Tab: To navigate through the Hamburger menu, Toggle Tree View, Icon View, Detailed View, Properties, Progress status, and Status bar.

    NOTE:The Tab and Shift + Tab keys enable you to navigate forward and back respectively.

  • Arrow Keys: To navigate through folders and bundles.

  • Ctrl + Shift: Use the following keys for different views:

    • Ctrl + shift + 1 Toggle Tree View

    • Ctrl + shift + 2 Icon View

    • Ctrl + shift + 3 Detailed View

  • Ctrl + F: Go to the Search window.

4.1.13 Creating Applications Portal as Shell

To create Applications Portal as Shell:

  1. Open the Registry Editor.

  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\Shell

  3. Change Shell to Program Files\OpenText\Endpoint Agent\bin\zapp-launcher.exe

  4. Log off and log into Windows.

In the Shell mode, the following additional Windows Power options are displayed:

  • Logout

  • Restart

  • Shutdown

NOTE:When Applications Portal is launched as Shell it will have both the minimize and maximize buttons. When you click the minimize button, the Applications Portal screen is resized and centered on the desktop screen.

4.1.14 Managing Favorites

You can set a bundle as a favorite to enable easy access to these bundles. You can set bundles as favorites from the desktop, from the file explorer, or from the Applications Portal window. To add a bundle as a favorite, right-click the bundle icon and select Set as Favorite. A badge icon is appended to the bundle icon that is marked as a favorite. All bundles that are marked as favorites can be viewed in the Favorites folder displayed in the left pane of the Applications Portal window and the Application Explorer window. You can also view the bundle as a favorite in the Start menu of your device (only if the bundle is pinned to the Start menu). Also, the bundles that are marked as favorites will be displayed as favorite bundles on other devices on which the user has logged in, if these bundles are available on those devices.

To remove the favorite tag from an bundle, right-click the bundle icon and select Remove as Favorite.

NOTE:The administrator can disable this feature in the Application Explorer Configuration Policy.