Version 1.0 February 2016 702P03897
Xerox App Gallery User Guide
©2016 Xerox Corporation. All rights reserved. Xerox®, Xerox and Design®, ConnectKey®, Xerox Extensible Interface Platform®, CentreWare®, and WorkCentre® are trademarks of Xerox Corporation in the United States and/or other countries. Microsoft®, Windows®, and Internet Explorer® are registered trademarks of Microsoft Corporation in the United States and/or other countries. Apple®, and QuickTime® are trademarks or registered trademarks of Apple Computer, Inc., registered in the U.S. and other countries. Adobe® and Flash® are registered trademarks of Adobe Systems, Inc. Google® and Chrome™ are trademarks or registered trademarks of Google, Inc. in the United States and/or other countries. JavaScript™ is a trademark of Oracle Corporation in the United States and/or other countries. BR17871
Table of Contents 1 Xerox App Gallery Overview..................................................................1-1 Xerox® ConnectKey®............................................................................................................1-1 Supported Multifunction Printers (MFPs)...................................................................1-2 Accessing Xerox App Gallery...........................................................................................1-3 App Gallery Support............................................................................................................1-3 System / Device Requirements.......................................................................................1-4 Supported Internet Browsers.............................................................................1-4 Supported Languages...........................................................................................1-4 Device Requirements for Apps..........................................................................1-5 Xerox App Gallery Web Portal Basic Features...........................................................1-6 Xerox App Gallery App.......................................................................................................1-7 Xerox App Gallery Process Strategy..............................................................................1-8
2 Required Setup...........................................................................................2-1 Internet Browser Security Settings...............................................................................2-1 Modifying the Internet Explorer Browser Security Settings..................2-1 Modifying the Chrome Browser Security Settings....................................2-2 Verifying / Enabling Extensible Interface Platform................................................2-2
3 Account Management............................................................................3-1 Creating an App Gallery Account from Xerox App Gallery Web Portal...............................................................................................................................3-1 Logging in to your Account with Xerox App Gallery Web Portal.......................3-3 Retrieving your App Gallery Account User ID..........................................................3-3 Resetting your App Gallery Account Password........................................................3-4 Editing your User Profile...................................................................................................3-6
4 Device Management...............................................................................4-1 Devices Tab.............................................................................................................................4-1 Adding a Device to an App Gallery Account.............................................................4-3 Adding a Device with the Manually Add Device Option........................4-4 Adding a Device with the Option “Import a List of Devices Using a CSV File”.......................................................................................................4-5 Adding a Device with the Discover Device Automatically Option...............................................................................................................4-5 Adding a Login Group to an App Gallery Account.................................................4-7
Xerox App Gallery User Guide
i
Table of Contents
Editing / Updating a Device in an App Gallery Account......................................4-7 Deleting a Device from an App Gallery Account.....................................................4-8
5 All Tabs...........................................................................................................5-1 All Apps Tab............................................................................................................................5-1 Adding Apps to My Apps Catalog.................................................................................5-2
6 My Apps........................................................................................................6-1 My Apps Tab..........................................................................................................................6-1 Installing / Updating / Reinstalling Apps...................................................................6-3 Install Types..............................................................................................................6-3 Installing a Free App from My Apps Catalog..............................................6-3 Installing a Free App Simultaneously on All Devices...............................6-4 Installing an App with a Trial License from My Apps Catalog.............6-4 Installing an App with a Full License from My Apps Catalog...............6-5 Reinstalling an App from My Apps Catalog.................................................6-6 Updating an App in My Apps Catalog...........................................................6-6 Other My Apps Procedures...............................................................................................6-7 Uninstalling an App / Releasing an App License........................................6-7 Removing an App from My Apps Catalog....................................................6-8 Reverting an App to a Previous Version.........................................................6-8 Reviewing the App Software Disclosure or Details...................................6-9 Releasing a License for an App that was Deleted from a Device...............................................................................................................6-9 Setting an App as the Default Walk-up Screen for a Device..............6-10
7 Licenses.........................................................................................................7-1 License Classifications.......................................................................................................7-1 License Requirement Information................................................................................7-2 Licenses Tab...........................................................................................................................7-3 Activating Xerox Paid-Licenses.......................................................................................7-3 Process for Activating and Installing Xerox Paid-License Apps.........................7-4 Process for Installing and Activating Third-Party Paid-License Apps..............7-5
8 Xerox App Gallery App Procedures.....................................................8-1 Xerox App Gallery App Overview...................................................................................8-1 Creating an App Gallery Account from Xerox App Gallery App........................8-2 Logging in to your Account from Xerox App Gallery App....................................8-3 Information about Automatically Adding a Device (Xerox App Gallery App).................................................................................................................................8-4
ii
Xerox App Gallery User Guide
Table of Contents
Automatically Adding a Device to your App Gallery Account from App Gallery App............................................................................................8-4 Adding the Device Credentials to your App Gallery Account...............8-5 Installing an App from Xerox App Gallery App........................................................8-5 Updating an App from Xerox App Gallery App........................................................8-6 Device Administrator Procedures (Xerox App Gallery App)................................8-7 Saving App Gallery Account Credentials (Xerox App Gallery App)...................................................................................................................8-7 Changing App Gallery Account Credentials (Xerox App Gallery App)...................................................................................................................8-8 Deleting (Clearing) App Gallery Account Credentials (Xerox App Gallery App)....................................................................................................8-9
9 Troubleshooting.........................................................................................9-1 Xerox App Gallery Account Issues.................................................................................9-1 User Cannot Activate / Create an App Gallery Account.........................9-1 User Cannot Log into an App Gallery Account (Forgotten Password or User ID).......................................................................................................9-2 User Cannot Connect to Xerox App Gallery Web Portal.........................9-2 User Cannot Connect to Xerox App Gallery App.......................................9-3 Device Issues (Xerox App Gallery Web Portal).........................................................9-4 Internet Browser Plug-in (Add-on / Extension)...........................................9-4 User Cannot Add a Device to an App Gallery Account (Xerox App Gallery Web Portal)......................................................................................9-4 Devices are not Displayed on the Devices Tab (Xerox App Gallery Web Portal).....................................................................................................9-5 Automatic Device Discovery Does not Return a List of Devices..............................................................................................................9-5 App Issues (Xerox App Gallery Web Portal)...............................................................9-6 Cannot Install Apps from Xerox App Gallery Web Portal.......................9-6 Cannot Uninstall an App / Release an App License from Xerox App Gallery Web Portal.......................................................................................9-6 App Removed from Device.................................................................................9-7 Device Start-up Screen Does not Display the App....................................9-7 App Licensing Issues...........................................................................................................9-7 App Licenses are Unavailable for Installation............................................9-7 Unable to Release App License.........................................................................9-7 Unable to License App from Device Control Panel...................................9-8 Unable to Apply a Xerox Paid-License to an App......................................9-8 Unable to Run Free Trials for an App from Device....................................9-8
Xerox App Gallery User Guide
iii
Table of Contents
Xerox Device Connector Plugin - Internet Browser Add-on / Extension.......................................................................................................................9-8 Verifying / Enabling Xerox Device Connector Add-on for Internet Explorer.............................................................................................................9-9 Verifying / Enabling the Chrome Extension for Xerox App Gallery............................................................................................................9-10 Setting up the Proxy Server for the Device from Xerox® CentreWare® Internet Services.....................................................................................................9-10
iv
Xerox App Gallery User Guide
1 Xerox App Gallery Overview Use the Xerox App Gallery to find Apps that provide new features or capabilities for your devices / multifunction printers (MFPs). The Gallery offers Xerox® Apps that are designed by Xerox and Xerox third-party partners. An App Gallery account provides direct access to apps for devices / multifunction printers (MFPs) that can improve your productivity, simplify workflows, convey pertinent business information, and enhance the overall user experience. With an App Gallery account you can view and acquire Apps, install Apps onto MFPs, and manage your Apps, licenses and devices (MFPs). Note Throughout this guide the word “device” is used synonymously and interchangeably with “Multifunction Printer (MFP).” Some Gallery Apps are free (do not require a license). Other Apps require the purchase of a license; these are referred to as Paid-License Apps.
Xerox® ConnectKey® Note All the Apps in Xerox App Gallery (including Third-Party Partner Apps) are ConnectKey Apps. Xerox® ConnectKey® is technology and software that connects devices / Multifunction Printers (MFPs) to the way work gets done. ConnectKey-enabled devices / MFPs offer fully integrated mobile, scanning, and cloud-based solutions. Tip In order to use Xerox App Gallery Apps on a device / MFP, the device must be loaded with the Software for 2016 ConnectKey Technology-enabled MFPs.
Xerox App Gallery User Guide
1-1
Xerox App Gallery Overview
Xerox ConnectKey Apps add, extend, and customize the functionality of Xerox® MFPs. ConnectKey Apps include the following categories: • • • •
Printing, Scanning, and Faxing Apps Cloud Apps Device (MFP) Management Apps Third-party Partner Apps
App Categories There are two categories of Apps in Xerox App Gallery: • Free: These Apps are free and do not require the purchase of a license. • Paid License: These Apps require the purchase of a license; these are referred to as Paid-License Apps.
Supported Multifunction Printers (MFPs) The following is a list of MFPs that support the use of Apps from Xerox App Gallery: • Xerox® WorkCentre® 3655 This device is loaded with the software for 2016 ConnectKey Technology enabled MFPs / WorkCentre® 3655i. • Xerox® WorkCentre® 5845/5855 This device is loaded with the software for 2016 ConnectKey Technology enabled MFPs. • Xerox® WorkCentre® 5865/5875/5890 This device is loaded with the software for 2016 ConnectKey Technology enabled MFPs / WorkCentre® 5865i/5875i/5890i. • Xerox® WorkCentre® 5945/5955 This device is loaded with the software for 2016 ConnectKey Technology enabled MFPs / WorkCentre® 5945i/5955i. • Xerox® WorkCentre® 6655 This device is loaded with the software for 2016 ConnectKey Technology enabled MFPs / WorkCentre® 6655i. • Xerox® WorkCentre® 7220/7225
1-2
Xerox App Gallery User Guide
Xerox App Gallery Overview
This device is loaded with the software for 2016 ConnectKey Technology enabled MFPs / WorkCentre® 7220i/7225i. • Xerox® WorkCentre® 7830/7835/7845/7855 This device is loaded with the software for 2016 ConnectKey Technology enabled MFPs / WorkCentre® 7830i/7835i/7845i/7855i. • Xerox® WorkCentre® 7970 This device is loaded with the software for 2016 ConnectKey Technology enabled MFPs / WorkCentre® 7970i.
Accessing Xerox App Gallery Access Xerox App Gallery in the following ways: • By going to the Xerox App Gallery Web Portal at https://appgallery.external.xerox.com/xerox_app_gallery/login and entering a valid User ID and Password. • By going to the device / MFP and the selecting Xerox App Gallery App. Tip In order to use Xerox App Gallery Apps on a device / MFP, the device must be loaded with the Software for 2016 ConnectKey Technology-enabled MFPs.
App Gallery Support Select the Help link to get information and links for App Gallery help. • Select Online Support to search for information by keyword. • Select Customer Support Forum to view customers’ questions and responses. • Select Feedback to send an email note containing a question, problem, or comment. All users are encouraged to first visit the online support resources.
Xerox App Gallery User Guide
1-3
Xerox App Gallery Overview
System / Device Requirements Supported Internet Browsers The Xerox App Gallery supports the following internet browsers: • Internet Explorer® version 10 and 11 on Windows® 7; Internet Explorer version 11 on Windows 8.1 • Google® Chrome™ 43 on Windows 7 and Windows 8.1
Supported Languages Xerox App Gallery supports the following languages: • • • • • • • • • • • • • • • • • • •
1-4
English Brazilian Portuguese Catalan Czech Danish Dutch Finnish French German Greek Hungarian Italian Norwegian Polish Romanian Russian Spanish Swedish Turkish
Xerox App Gallery User Guide
Xerox App Gallery Overview
Device Requirements for Apps Note Throughout this guide the word “device” is used synonymously and interchangeably with “Multifunction Printer (MFP).” All Devices / MFPs require the following: • For App installation, Xerox MFPs must support Xerox Extensible Interface Platform® (EIP) version 2.5 or higher. This is applicable for most apps. Note In order to run / use the Xerox App Gallery App on the MFP, it must have EIP version 3.5 or higher installed on it. • EIP must be enabled to allow for installation of Apps on a MFP; refer to Enabling / Verifying Extensible Interface Platform. • If logging into and / or using the Xerox App Gallery App, review and perform the following as necessary: -
Ensure the device / MFP is able to communicate with internet. Note Some Apps require the device / MFP to communicate with the internet. For installations that require a proxy to connect to the internet, refer to Setting up the Proxy Server for the Device from CentreWare® Internet Services.
-
If Verification of SSL is enabled on the device / MFP, ensure the security Certificates are loaded on the MFP. When Verify Server Certificates is enabled on the MFP, it applies to all EIP Applications on the MFP. Tip By default, the Xerox Solutions Certificates are preloaded on all 2016 Xerox ConnectKey Technology-enabled i-series MFPs. Note SSL Certificates provide secure communication of private and sensitive information over network connections. If SSL certificate validation is disabled, the secure communication of private or sensitive information is vulnerable. Typically, it is recommended that Verify server certificates is enabled on your MFP, though this may cause issues with other application. For further information refer to the Xerox App Gallery Online Support at http://www.support.xerox.com/support/xerox-app-gallery.
Xerox App Gallery User Guide
1-5
Xerox App Gallery Overview
Xerox App Gallery Web Portal Basic Features All Apps displays after logging into an App Gallery account. From this page, the following features are available to the account user. All Apps Tab This is the default tab / page that displays when first logging into an account. The All Apps tab displays a catalog of available Apps as well as other features and functions, including Adding Apps to My Apps catalog and Updating Apps. For more information, refer to All Apps Tab. My Apps Tab The My Apps tab displays a catalog of Apps that were added from All Apps. If a new version of an App is available, a New Version link displays. From My Apps, you can do the following functions: • Install Apps • Uninstall Apps / Release the App license • Remove from My Apps catalog • Revert an App in My Apps catalog to a previous version • Review information about an App's Software Disclosure or the Details of the App • Set an App as the default walk-up screen on a selected device / MFP For more information, refer to My Apps Tab. Devices Tab The Devices tab displays a listing of multifunction printers (MFPs) that a user has added to their account. Devices (MFPs) may be added, edited, and deleted from an App Gallery Account. For more information, refer to Devices Tab. Licenses Tab The Licenses tab displays a list of purchased Xerox licenses for their respective Apps. From this tab, a user may activate licenses for these Apps as required. For more information, refer to Licenses Tab.
1-6
Xerox App Gallery User Guide
Xerox App Gallery Overview
Xerox App Gallery App Note By default, many Apps from Xerox App Gallery, including the Xerox App Gallery App, are preinstalled and available on all 2016 Xerox ConnectKey Technology-enabled i-series MFPs. Devices that do not have the software for 2016 Xerox ConnectKey Technology-enabled i-series may require the user to manually install the Xerox App Gallery App. The Xerox App Gallery App may be installed on devices which do not already have it installed. If the Xerox App Gallery App is not installed already on a device, it is available from Xerox App Gallery Web Portal. By selecting the Xerox App Gallery App from the device control panel a user may request a new Xerox App Gallery account or log in to an existing account. Once logged in, the user can perform various App Gallery functions, such as browse available Apps and install / update Apps. Tip In order to use the Xerox App Gallery App, the following device requirements must be met: • MFPs require a network connection. • The MFP must be loaded with the software for 2016 ConnectKey Technology-enabled MFPs. • MFPs must have Xerox Extensible Interface Platform® (EIP) version 3. 5 or higher installed. Related Topics: Verifying / Enabling Extensible Interface Platform
Xerox App Gallery User Guide
1-7
Xerox App Gallery Overview
Xerox App Gallery Process Strategy It is recommended that you use Xerox App Gallery according to the following sequential process steps: 1. 2. 3. 4.
Create an App Gallery Account. Browse and add desired Apps to your My Apps catalog. Add multifunction printers (MFPs) / devices to the Devices catalog. If the App requires a license, a. b.
5.
1-8
Obtain any required licenses, and Activate the licenses.
Install Apps.
Xerox App Gallery User Guide
2 Required Setup Internet Browser Security Settings Modifying the Internet Explorer Browser Security Settings Note The steps in the procedure are based on Internet Explorer 11. The steps may vary slightly for Internet Explorer 10. 1. Open Internet Explorer on your computer. 2. To access Internet Options, choose one of the following: • From the Menu bar, select Tools > Internet Options, or • From the Gear icon (Tools), select Internet Options. 3. From Internet Options, select the Security tab. If the Internet Explorer security level is High, you cannot log in to Xerox App Gallery. Either change the security level to Medium-High, or customize the security settings so that login is permitted to the site. 4. Select the Custom level button. The Security Settings - Internet Zone window opens. 5. Scroll to ActiveX controls and plugins. a) Locate Run ActiveX controls and plugins. b) Select Enable. 6. Scroll to Scripting. a) Locate Active scripting. b) Select Enable. 7. Select OK to save the settings and close the Security Settings - Internet Zone window. 8. From the Security tab, select Trusted Sites.
Xerox App Gallery User Guide
2-1
Required Setup
a) Select Sites. A secondary Trusted Sites window opens. b) Select inside the “Add this website to the zone” field. c) Enter the following to URL address: https://appgallery.external.xerox.com/xerox_app_gallery/login d) Select Add. The URL address is added to the Websites field. e) Select Close. 9. Select OK to save the settings and close the Internet Options window.
Modifying the Chrome Browser Security Settings 1. Open the Chrome browser. 2. Select the Customize and control Google Chrome menu (the icon with the multiple horizontal lines) in the upper right corner of the Chrome browser. 3. Select Settings. A new tab opens and displays Settings. 4. Scroll to the bottom of the Settings page, and select the Show advanced settings link. 5. Scroll down the page and locate Privacy. 6. Under Privacy select Content settings. The Content settings window opens. 7. From Content settings, perform the following steps: a) Scroll and locate JavaScript. b) Select Allow all sites to run JavaScript (recommended). c) Scroll and locate Plugins. d) Select Detect and run important plugin content (recommended). e) Select Done to save the settings and close the Content settings window. 8. Close the Chrome browser window.
Verifying / Enabling Extensible Interface Platform Before Apps can be installed, the Extensible Interface Platform (EIP) Services must be enabled on the multifunction printer (MFP) / device. This ensures that both the Xerox App Gallery Web Portal and the Xerox App Gallery App can install Apps on the device. Important By default Extensible Interface Platform (EIP) Services is enabled on the device, and remains enabled unless manually disabled by a device Administrator.
2-2
Xerox App Gallery User Guide
Required Setup
Note Perform the following steps only if you are the Administrator of the multifunction printer / device; otherwise, contact the device Administrator. 1. Open an internet browser on your computer. The internet browser may be either Internet Explorer or Chrome. 2. From an internet browser, enter the IP address of the multifunction printer (MFP) / device. The Xerox® CentreWare® Internet Services page for that device opens. 3. Select Properties. 4. Login as the Administrator. 5. Under General Setup, select Extensible Service Setup. The Extensible Service Setup page displays. 6. On the Extensible Service Setup page perform the following steps: a) Under Setup (Required) select the Edit button for Extensible Service Registration. A secondary Extensible Service Setup page displays. b) On the secondary Extensible Service Setup page select the check boxes for the following configuration settings: • • • • • • •
Extensible Service Registration Device Configuration Scan Template Management Scan Extension Job Management Extension Authentication & Accounting Configuration Session Data
c) Select Save at the bottom of the page to save the changes to the page. The main Extensible Service Setup page displays. d) Under Browser Settings, select the check box to Enable the Extensible Services Browser. 7. Under Proxy Server, configure the Proxy Server settings, as required, by performing the following substeps. The Proxy Server option is located on the Extensible Service Setup main page. Note Proxy is required for app installations that require a proxy to connect to the internet. a) Under Proxy Server, select Proxy from the drop-down list. b) Choose one of the following: • To use the same proxy server for HTTPS, select Use settings for all protocols. Continue to Step 8. • To use a separate proxy server for Xerox Extensible Interface Platform® applications that use HTTPS, select the Edit button.
Xerox App Gallery User Guide
2-3
Required Setup
The Edit button is located to the right of Enabled under HTTP, HTTPS option. The Proxy Server page displays. Continue to the next substep. c) Select Enabled. d) Select the address type. Options include: • IPv4 Address • IPv6 Address • Host Name e) In the Proxy Server Address field, enter the address name or host name. f) Select Save at the bottom of the page to save the changes to the page. The main Extensible Service Setup page displays. g) In the Bypass Proxy Rules field, enter the required values; separate them with commas. 8. Select Apply at the bottom of the page. A pop-up message displays; select OK to dismiss the pop-up message box. 9. Logout of Administrator mode. 10. Exit and close the browser window.
2-4
Xerox App Gallery User Guide
3 Account Management Creating an App Gallery Account from Xerox App Gallery Web Portal An App Gallery account may be created in one of the following ways: • From the Xerox App Gallery Web Portal or • From the Xerox App Gallery App Important Only one account needs to be created. This procedure provides instructions for creating an account from the Xerox App Gallery Web Portal. Note Also refer to Creating an App Gallery Account from Xerox App Gallery App. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Select the Create an Account button. The Terms and Conditions window displays. 3. Review and accept the Terms of Use in two places by checking the box under each segment of the document. 4. Select the Agree button to continue creating an account. The Creating an Account window displays. 5. Create a User ID. • Account User IDs should contain alphanumeric characters only. • User ID must be a minimum of 6 characters. • User ID supports a maximum of 30 characters.
Xerox App Gallery User Guide
3-1
Account Management
6. Create a new Password. Account passwords must be at least 8 characters, and must contain three of the following categories: • • • •
Upper-case letters, for example, A, B, C, D Lower-case letters, for example, a, b, c, d Numeric characters, for example, 1, 2, 3 Non-alphanumeric punctuation marks, for example: ! @ # $ % & * + ?
7. Enter your first name. The First Name field supports a maximum 50 characters. 8. Enter your last name. The Last Name field supports a maximum 50 characters. 9. Enter a valid email address. 10. Enter the company name. The Company name field supports a maximum 400 characters. 11. Enter an Address. • • • •
The Street Address field supports a maximum 255 characters. The City field supports a maximum 50 characters. The State/Province field supports a maximum 50 characters. The Postal Code field supports a maximum 50 characters.
12. Select a Country from the drop-down list. 13. Select OK after entering information in all the required fields. A Creating account message displays. 14. After the account is created, the following message is displayed: Please Activate Your Account Account activation instructions have been sent to [email address provided]. If you do not receive an email within the next few minutes, please check your junk mail folder. To ensure you receive future emails, specify the message as 'Not junk'. OK
15. Select OK on the “Please Activate Your Account” window. 16. Open the activation account email and select the provided link to activate the account. The link opens the Xerox App Gallery login page. 17. Enter your User ID and Password.
3-2
Xerox App Gallery User Guide
Account Management
18. Select Login to complete the activation. The first time the account opens, a message displays stating the following: Welcome to Xerox App Gallery Your account has been created and activated. View the App Gallery
19. Select the View the App Gallery button to continue to the App Gallery.
Logging in to your Account with Xerox App Gallery Web Portal 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Enter your User ID. This is the User ID you provided to Xerox App Gallery when you created your account. 3. Enter your Password. This is the Password you provided to Xerox App Gallery when you created your account. 4. Select the Log In button. The Xerox App Gallery displays.
Retrieving your App Gallery Account User ID Use the following procedure to get your App Gallery Account User ID. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. The App Gallery Login screen appears. 2. Select the Forgot User ID? link. The Forgot User ID window displays.
Xerox App Gallery User Guide
3-3
Account Management
3. Enter the email address that is associated with your App Gallery account, and select Submit. A message displays stating the following: An email has been sent to this address [account email address] Please check your email. It contains all Xerox App Gallery User IDs associated with this email address. OK
Note If multiple User IDs are associated with an email address, an email will be sent that includes all of the User IDs associated with that particular email address. 4. Select OK to dismiss the message dialog box. 5. Go to your email and Open the message titled Xerox App Gallery: Forgot User IDs Details. If you do not see the email regarding the User ID, check your Junk / Spam email folder. 6. Return to https://appgallery.external.xerox.com/xerox_app_gallery/login, and enter the User ID from your email to log into your App Gallery account.
Resetting your App Gallery Account Password Use the following procedure to reset your App Gallery Account Password. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. The App Gallery Login screen appears. 2. Select the Forgot Password? link. The Request link to reset password screen appears.
3-4
Xerox App Gallery User Guide
Account Management
3. Enter your User ID, and select Reset Password. A message displays stating the following: Your Request Has Been Sent Password reset instructions have been sent. If you do not receive an email within a few minutes, please check your junk email. To ensure you receive future emails specify the message as 'Not junk'. OK
4. Select OK to dismiss the message dialog box. 5. Go to your email and Open the message titled Xerox App Gallery: Account Password Reset. If you do not see the email regarding the Password reset, check your Junk / Spam email folder. 6. Select the link in the email, or copy the link to your internet browser and press Enter. The browser page opens and displays the following message box: Reset Password Pick a new password for 'UserID' Password [Password Entry Field] Confirm Password [Password Entry Field] Cancel Reset
Note If no action is taken to reset the password, it is not changed and will remain the same. 7. Enter your new password in the Password field. 8. Reenter the password again in the Confirm Password field. 9. Select the Reset button. Your password is reset. 10. To test the new password, log in to the Xerox App Gallery Web Portal again using the new password.
Xerox App Gallery User Guide
3-5
Account Management
Editing your User Profile Use this procedure to edit (change or update) your App Gallery Account Profile information. Profile information which can be edited (changed or updated) includes the following fields: • • • • • • • •
First Name Last Name Password Confirm Password Email Company Address Country
1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Log in to your Xerox® App Gallery account. 3. Select the Profile link at the top of the page. The Edit Profile window displays. 4. Edit the desired profile fields. For example, to change your Password, perform the following steps: a) In the Password field, enter a new password Account passwords must be at least 8 characters, and must contain three of the following categories: • • • •
Upper-case letters, for example, A, B, C, D Lower-case letters, for example, a, b, c, d Numeric characters, for example, 1, 2, 3 Non-alphanumeric punctuation marks, for example: ! @ # $ % & * + ?
b) In the Confirm Password field, reenter the same password. Note If the Password and Confirm Password fields are blank (no new information in them), the account password does not change. 5. After you make the necessary updates, select OK.
3-6
Xerox App Gallery User Guide
4 Device Management Devices Tab The Devices tab displays a listing of multifunction printers (MFPs) / devices that a user has added to their App Gallery account. The Devices tab also allows you to add, edit, and delete devices from your App Gallery Account. The following information briefly describes the features and functions available on the Devices tab.
Add Selecting this button opens an Add Device window where the user selects an option for adding a device and enters its required information. There are three options available for adding a device to your App Gallery Account from the App Gallery Web Portal: • Manually add device: Use this option to manually add a device by entering information in the required fields, including Device IP Address or Hostname, Device Username, and Device Password (or select a Login Group). • Import a list of devices using a CSV file: Use this option to add multiple devices simultaneously by uploading a .csv file which contains the network addresses or host names of multiple devices. • Discover devices automatically: Use this option to add multiple devices simultaneously by searching for devices within a specified range of IP addresses.
Xerox App Gallery User Guide
4-1
Device Management
Note This option is available only when using Internet Explorer. Note A device may also be added to your App Gallery Account, Devices catalog from the App Gallery App. Refer to Information about Automatically Adding a Device (App Gallery App).
Login Groups Select this button to create, edit, or delete a login group for devices / MFPs which share the same administrator login and password. A Login Group uses a shared Device Username and Device Password which allows you to select a group instead having to manually enter this information for every device added to your account. All devices which use a Login Group must have the same Device Username and Device Password. • If no Login Groups are created, then this drop-down menu simply displays None. • If Login Groups are available, one may be selected and it automatically enters the device administrator information in the Device Username and Device Password fields. Once a login group is created, the user can edit or delete that group by selecting the Login Groups button. • Edit: Select this option edit the information about a specific Login Group. • Trash Can icon: Select this option to delete a specific Login Group.
Device List The Device list displays below the Add Device and Login Groups buttons. This list displays all the MFPs added to a user's App Gallery account. The list includes the following details: • Device Column: This displays the device model, for example Xerox WorkCentre 3655X v1 Multifunction Printer. The device IP Address is displayed under the device model. • Contact Column: If provided, this displays the contact person for that MFP. • Location Column: If provided, this displays the location of that MFP. • Login Group Column: When a device is added, a Login Group may be selected from the drop-down list. This field is optional. • Edit Button: Select this button for a desired device to edit the MFP information. From the Edit Device dialog, select Submit to save changes or Cancel to exit without saving any changes. • Trash Can Icon: Select this icon for a desired device to delete / remove the MFP from your App Gallery Account.
4-2
Xerox App Gallery User Guide
Device Management
Adding a Device to an App Gallery Account 1. 2. 3. 4.
Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. Log in to your Xerox® App Gallery account. Select the Devices tab. Select Add. Note When attempting to add a device for the first time with Xerox App Gallery Web Portal, the browser (Internet Explorer / Chrome) displays a pop-up message appears which requires permission to install the Xerox Device Connector Add-on (Internet Explorer) / Extension (Chrome). The Xerox Device Connector is a plugin (add-on / extension) that must be installed and enabled on your internet browser to enable communication between Xerox App Gallery Web Portal and the device. For more information, refer to Xerox Device Connector Plugin - Internet Browser Add-on / Extension.
5. If the pop-up message displays, permit the installation of the Xerox Device Connector Add-on / Extension. Depending on your internet browser, the pop-up message states the following: • Internet Explorer: “An Active X pop-up window should now appear. Please permit the installation of the Xerox Device Connector from Xerox in order to enable communication between Xerox® App Gallery and your Multifunction Device (MFD).” • Google Chrome: “You will need to install an extension for Chrome in order to enable Xerox® App Gallery to communicate with devices on your network.” For more information, refer to Xerox Device Connector Plugin - Internet Browser Add-on / Extension. 6. Choose one of the following Add options: • Manually add device; go to Adding a Device with the Manually Add Device Option • Import a list of devices using a CSV file; go to Adding a Device with the Option “Import a List of Devices Using a CSV File” • Discover Device Automatically; go to Adding a Device with the Discover Device Automatically Option
Xerox App Gallery User Guide
4-3
Device Management
Note This option is available only when using Internet Explorer.
Adding a Device with the Manually Add Device Option Use this procedure after selecting the option Manually add device. Important Items with an asterisk (*) next to them indicate required fields where information must be entered. 1. Enter the Device IP Address or Hostname*. Note The hostname, if used, must be the fully qualified host name. 2. Choose one of the following: • Select a Login Group from the drop-down list, or • Enter the Device Username* and Device Password*. A Login Group uses a shared Device Username and Device Password which allows you to select a group instead having to manually enter this information for every device added to your account. All devices which use a Login Group must have the same Device Username and Device Password. 3. Select Next. 4. On the second Add Device window, enter information for any of the following optional items: a) Location of the device b) Contact Name for the device c) Contact Email Address for the device d) SNMP Community String The default setting is Public. If unsure what to include here, use the default setting. e) Ensure that the Enable EIP Services is checked (enabled). Note EIP Services is enabled by default on all devices. If EIP Services is manually disabled, this setting enables EIP services. The setting is only supported on Internet Explorer. 5. Select Add. The device / MFP is added to your Devices list.
4-4
Xerox App Gallery User Guide
Device Management
Adding a Device with the Option “Import a List of Devices Using a CSV File” Use this procedure after selecting the option Import a list of devices using a CSV file. Important Items with an asterisk (*) next to them indicate required fields where information must be entered. 1. Select the Browse button to locate and add the desired CSV file. The CSV file name displays in the Upload CSV field. 2. Choose one of the following: • Select a Login Group from the drop-down list, or • Enter the Device Username* and Device Password*. A Login Group uses a shared Device Username and Device Password which allows you to select a group instead having to manually enter this information for every device added to your account. All devices which use a Login Group must have the same Device Username and Device Password. 3. Enter information for any of the following optional items: a) Location of the device b) Contact Name for the device c) Contact Email Address for the device d) SNMP Community String The default setting is private. If unsure what to include here, use the default setting. 4. Select Add. The device / MFP is added to your Devices list. 5. Select Close on the modal that displays and states the devices were successfully added / failed.
Adding a Device with the Discover Device Automatically Option Use this procedure after selecting the option Discover Device Automatically. This option simultaneously adds multiple devices to the Devices list. Note This option is available only when using Internet Explorer.
Xerox App Gallery User Guide
4-5
Device Management
Important Items with an asterisk (*) next to them indicate required fields where information must be entered. 1. Enter a Start Address* for the beginning of the device search. Only IPV4 address formats are supported, for example, 13.176.108.0. 2. Enter an End Address* for the end of the device search. For example: 13.176.108.255. 3. Enter the SNMP Community (for discovery) information. The default setting is private. If unsure what to include here, use the default setting. 4. Select Discover. A list of devices is displayed when the search has completed. Note If possible, all discovered devices will be added to your Devices list. 5. Choose one of the following: • Select a Login Group from the drop-down list, or • Enter the Device Username* and Device Password*. A Login Group uses a shared Device Username and Device Password which allows you to select a group instead having to manually enter this information for every device added to your account. All devices which use a Login Group must have the same Device Username and Device Password. 6. Enter the following information: a) Location of the device b) Contact Name for the device c) Contact Email Address for the device d) SNMP Community String The default setting is Public. If unsure what to include here, use the default setting. 7. Select Add. Note If possible, all discovered devices will be added to the Devices The devices / MFPs are added to your Devices list.
4-6
Xerox App Gallery User Guide
Device Management
Adding a Login Group to an App Gallery Account A login group can be created for devices which share the same administrator login and password. Note A Login Group automatically enters the device (administrator) credentials in the Device Username and Device Password fields. A Login Group may be used with any of the Add Device options. 1. 2. 3. 4. 5. 6.
Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. Log in to your Xerox® App Gallery account. Select the Devices tab. Select Login Groups. Select Add Login Group. Enter the following required information: • Group Name: This is whatever name you choose for the group. Use only alphanumeric characters. • Device Username • Device Password
7. Select OK. The newly added Login Group appears on the Login Group list.
Editing / Updating a Device in an App Gallery Account 1. 2. 3. 4.
Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. Log in to your Xerox® App Gallery account. Select the Devices tab. Locate the device to be edited and select Edit. The Edit Device dialog displays. 5. Edit any fields as necessary. 6. Select Submit.
Xerox App Gallery User Guide
4-7
Device Management
Deleting a Device from an App Gallery Account Note Before deleting a device from a Xerox® App Gallery account, uninstall (delete) all App Gallery Apps from the device. Refer to Uninstalling an App / Releasing an App License. 1. 2. 3. 4.
Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. Log in to your Xerox® App Gallery account. Select the Devices tab. Locate the device to be deleted and select the Trash Can icon to delete the device. The Delete Device screen appears. 5. Select Delete.
4-8
Xerox App Gallery User Guide
5 All Tabs All Apps Tab This is the default tab / page that displays when first logging into an account. The All Apps tab displays a catalog of available Apps as well as other features and functions, including Adding Apps to My Apps catalog and Updating Apps. When browsing the Apps, a user can select a specific category, which then displays only the Apps for that category. Use the Filter buttons to select a desired App category. App categories include: • • • • • • •
Show All Scan Print Fax Cloud Device Management Partner This category contains third-party partner apps. For more information about creating partner apps, please refer to the Xerox Developer Program at https://www.xerox-solutions.net/Developers/.
Add to My Apps Button Selecting this button adds the App to My Apps catalog. It does not install the App. Once the App is added to My Apps catalog, the Add to My Apps button disables / can no longer be selected, and it changes to In My Apps.
Xerox App Gallery User Guide
5-1
All Tabs
Note If an App is removed / deleted from My Apps catalog, the button reverts to Add to My Apps and becomes a functioning button.
Update My Apps Button For Apps that currently reside in My Apps catalog and which have a newer version, the Update My Apps button displays. Selecting this button updates the current App version (in My Apps catalog) with a newer version of the App. Note A message displays if the new version requires a new license.
Adding Apps to My Apps Catalog This procedure provides steps for adding Apps to your account directly from Xerox App Gallery Web Portal. Note Adding an App to My Apps catalog does not install the App. Installation of an App is a separate function. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Log in to your Xerox® App Gallery account. 3. Browse the Apps in All Apps. • Search for an App by selecting a desired category at the top of the page, such Scan. • If you know the name of the App, search for it by selecting the Show All category and entering the App name in the Search field. 4. To find out more about a particular App, select the App icon to open a new page displaying more information about the App. 5. Select Add to My Apps to add the desired App to My Apps catalog. Selecting this button adds the App to My Apps catalog. It does not install the App. Once the App is added to My Apps catalog, the Add to My Apps button disables / can no longer be selected, and it changes to In My Apps. 6. Select the My Apps tab to review the apps added to your account. 7. Continue to browse and add more apps to your My Apps list as required. 8. Log out of your App Gallery account when finished.
5-2
Xerox App Gallery User Guide
6 My Apps My Apps Tab The My Apps tab displays a catalog of Apps that were added from All Apps. This tab also allows you to perform a variety of functions; for details, refer to Action Column. My Apps is organized in a four-column layout:
App Column This column displays the App (saved from All Apps).
License Column This column displays the license type / category, including information about whether the App is free or requires a license. Refer to License Requirement Information for more details.
Version Column This column shows the software version level for each App. If a new version of the App is available, a New Version link displays underneath the version number. • If the new version requires a different type of license, a message displays and asks the user if they want to update their My Apps catalog with the newer version. • Select either Update or Cancel. Tip Update / New Version only updates the App version in My Apps catalog; it does not update the installed App on the device.
Xerox App Gallery User Guide
6-1
My Apps
Action Column This column provides a drop-down menu containing the following selections: Install Select this option to install the App on one or more devices. Note The device / MFP must be added to the Devices tab prior to installing an App. This option also allows you to Reinstall and Update Apps on one or more devices. Uninstall Select this option to uninstall an App from one or more devices. If it is a Paid-license App, then uninstalling the App also releases its license. The released license is then available for use on another device. Remove from My Apps This option deletes / removes the App from My Apps catalog. Removing an App does not uninstall it nor does it release the App license. Revert This option returns the App software to the previous version. • It only reverts the App to the last previous version. • An App cannot be continually reverted to multiple previous versions. • When using Revert, a previous version of the App may not be available. Note Revert affects only the App version in My Apps catalog. It does not return the App that is installed on the device / MFP to a previous version. Software Disclosure Note Not all Apps will have software disclosure information. The information provided in the Software Disclosure statement is to inform the App user about any third-party software notices and third-party license terms and conditions. It applies to any App that contains third-party programming code in it (Xerox or Third-Party). Details This option displays a new page with a detailed description of the App, possibly videos or screen shots of the App, any applicable license requirements. Tip If the App requires a paid-license, the Details page provides information on how to purchase a license for the App. Set as Default This option sets the App as the default walk-up screen on a selected device / MFP.
6-2
Xerox App Gallery User Guide
My Apps
Installing / Updating / Reinstalling Apps Refer to the following procedures: • • • • • •
Installing a Free App from My Apps Catalog Installing a Free App Simultaneously on Multiple Devices Installing an App with a Trial License from My Apps Catalog Installing an App with a Full License from My Apps Catalog Reinstalling an App from My Apps Catalog Updating an App in My Apps Catalog
Install Types The Install Type is selected when installing, updating, or reinstalling an App from Xerox App Gallery Web Portal. The following is a list of Install Types for Free and Paid-License Apps: • • • •
Free (No license required) Full (Xerox Paid-License or Third-Party Paid-License) Trial (Xerox Paid-License) Reinstall: -
Free Trial Reinstall (Xerox Paid-License) Full Reinstall (Xerox Paid-License or Third-Party Paid-License)
• Update: -
Free Full (Xerox Paid-License or Third-Party Paid-License)
Installing a Free App from My Apps Catalog This procedure provides steps for installing a free App. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Log in to your Xerox® App Gallery account. 3. Select My Apps. 4. Locate the desired App in the list, and select Install from the Action drop-down menu. The End User License Agreement displays.
Xerox App Gallery User Guide
6-3
My Apps
5. To confirm that you accept the End User License Agreement, select Agree. A list of devices / multifunction printers (MFPs) displays. 6. For the desired device, select the appropriate Install Type; the device is where the App will be installed. Select Free. Note For the purposes of this procedure, this procedure documents the installation of an App to one device only and not all devices. If the App was previously installed and a new version is available, the button displays as Update. 7. Select Install to begin the App installation process. Upon completion, a message displays indicating that you should check the device to ensure that the App was installed on it. If your App does not install, refer to the Troubleshooting chapter.
Installing a Free App Simultaneously on All Devices This procedure provides steps for simultaneously installing a free App on all devices (My Apps catalog). 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Log in to your Xerox® App Gallery account. 3. Select My Apps. 4. Locate the desired App in the list, and select Install from the Action drop-down menu. The End User License Agreement displays. 5. To confirm that you accept the End User License Agreement, select Agree. A list of devices / multifunction printers (MFPs) displays. 6. Select All Devices to install the App on all the devices listed in your Devices catalog. This automatically selects the Install Type based on the App being installed. For example, if it is a free App, then Free is selected for the Install Type. If it is a Paid-License App, then Full is selected for the Install Type. 7. Select Install to begin the App installation process. Upon completion, a message displays indicating that you should check the device to ensure that the App was installed on it. If your App does not install, refer to the Troubleshooting chapter.
Installing an App with a Trial License from My Apps Catalog This procedure provides steps for installing an App with a Trial License. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Log in to your Xerox® App Gallery account. 3. Select My Apps. 4. Locate the desired App in the list, and select Install from the Action drop-down menu.
6-4
Xerox App Gallery User Guide
My Apps
The End User License Agreement displays. 5. To confirm that you accept the End User License Agreement, select Agree. A list of devices / multifunction printers (MFPs) displays. Note For the purposes of this procedure, this procedure documents the installation of an App to one device only and not all devices. 6. For the desired device, select the appropriate Install Type; the device is where the App will be installed. Select Trial. Note The Trial option does not display for Third-Party Paid-License Apps; contact the third-party entity for information about Trial options for the App. 7. Select Install to begin the App installation process. Upon completion, a message displays indicating that you should check the device to ensure that the App was installed on it. If your App does not install, refer to the Troubleshooting chapter.
Installing an App with a Full License from My Apps Catalog This procedure provides steps for installing an App with a Full License. Before installing an App which requires a Xerox Paid License, ensure that the license is purchased and activated. Refer to Process for Installing and Activating Xerox Paid-License Apps and Activating Xerox Paid-Licenses (Xerox App Gallery Web Portal). Note Third-Party Paid-Licenses are not managed and cannot be activated from Xerox App Gallery Web Portal. Refer to Process for Installing and Activating Third-Party Paid-License Apps. 1. 2. 3. 4.
Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. Log in to your Xerox® App Gallery account. Select My Apps. Locate the desired App in the list, and select Install from the Action drop-down menu. The End User License Agreement displays.
5. To confirm that you accept the End User License Agreement, select Agree. A list of devices / multifunction printers (MFPs) displays. Note For the purposes of this procedure, this procedure documents the installation of an App to one device only and not all devices. 6. For the desired device, select the appropriate Install Type; the device is where the App will be installed. Select Full. This procedure documents the installation of an App for the first time.
Xerox App Gallery User Guide
6-5
My Apps
7. Select Install to begin the App installation process. Upon completion, a message displays indicating that you should check the device to ensure that the App was installed on it. If your App does not install, refer to the Troubleshooting chapter.
Reinstalling an App from My Apps Catalog This procedure provides steps for reinstalling an App. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Log in to your Xerox® App Gallery account. 3. Select My Apps. 4. Locate the desired App in the list, and select Install from the Action drop-down menu. The End User License Agreement displays. 5. To confirm that you accept the End User License Agreement, select Agree. A list of devices / multifunction printers (MFPs) displays. Note For the purposes of this procedure, this procedure documents the installation of an App to one device only and not all devices. 6. For the desired device, select the appropriate Install Type; the device is where the App will be installed. Select Reinstall. 7. Select Install to begin the App installation process. Upon completion, a message displays indicating that you should check the device to ensure that the App was installed on it. If your App does not install, refer to the Troubleshooting chapter.
Updating an App in My Apps Catalog This procedure provides steps for updating an App in My Apps catalog. Tip Update / New Version only updates the App version in My Apps catalog; it does not update the installed App on the device. If a new version of an App is available, a New Version link displays in the Version column of My Apps catalog. A New Version link displays when there is a new version of the App available. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Log in to your Xerox® App Gallery account. 3. Select My Apps. 4. Locate the App with the new version / update link, and select the New Version link.
6-6
Xerox App Gallery User Guide
My Apps
A message displays only If the new version requires a different type of license; the message asks the user if they want to update their My Apps catalog with the newer version. 5. Select Update. The App is updated in My Apps catalog with the new version. Note If desired, the App may be reverted to the previous version; refer to Reverting an App to a Previous Version.
Other My Apps Procedures The remainder of this chapter provides the following procedures: • • • • • •
Uninstalling an App / Releasing an App License Removing an App from My Apps Catalog Reverting an App to a Previous Software Version Reviewing the App's Software Disclosure or Details Releasing a License for an App that was Deleted from a Device Setting an App as the Default Walk-up Screen for a MFP
Uninstalling an App / Releasing an App License Use this procedure to uninstall either Free or Paid-License Apps from a device. Tip If uninstalling a Paid-License App from a device, the license for that App is also released. Note A network connection is required in order to uninstall the Free / Paid-License App from the device. 1. 2. 3. 4.
Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. Log in to your Xerox® App Gallery account. Select My Apps. Locate the desired App in the list, and select Uninstall from the Action drop-down menu. A device list displays.
5. Select the device where the app is currently installed. If the App is installed on a device that is not in your Devices list, install the device, then return to this procedure to uninstall the App / release the App license. Refer to Adding a Device to an App Gallery Account.
Xerox App Gallery User Guide
6-7
My Apps
6. Select Uninstall. An app that is designated as the default, walk-up screen on a device cannot be uninstalled without first removing it as the default, walk-up screen; to do this, you must change the device default screen. Contact the device administrator, and / or refer to the System Administration Guide for that device. Note The released license now is available when installing the App on another device.
Removing an App from My Apps Catalog Important Removing an App from My Apps catalog does not uninstall it from the device, nor does it release any applicable App license (for Paid-License Apps). 1. 2. 3. 4.
Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. Log in to your Xerox® App Gallery account. Select My Apps. Locate the desired App in the list, and select Remove from My Apps from the Action drop-down menu. A message displays asking “Are you sure you want to remove the app “[App Name]”?”
5. Choose one of the following: • Select Remove to remove the App from your My Apps catalog. • Select Cancel to keep the App in your My Apps catalog.
Reverting an App to a Previous Version This procedure provides steps for reverting (downgrading) an App in My Apps catalog to a previous software version. Revert may not be available for some of the Apps in My Apps catalog; if it is unavailable for selection (grayed out), this means that there is no previous version of the software for the App. Note Revert affects only the App version in My Apps catalog. It does not return the App that is installed on the device / MFP to a previous version. 1. 2. 3. 4.
Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. Log in to your Xerox® App Gallery account. Select My Apps. Locate the desired App in the list, and select Revert from the Action drop-down menu. A Revert to previous version message displays. 5. Select Revert to return the App to the previous software version.
6-8
Xerox App Gallery User Guide
My Apps
Reviewing the App Software Disclosure or Details This procedure provides steps for reviewing / reading either the Software Disclosure or Details for an App in My Apps catalog. • Software Disclosure: The information provided in the Software Disclosure statement is to inform the App user about any third-party software notices and third-party license terms and conditions. It applies to any App that contains third-party programming code in it (Xerox or Third-Party). • Details: This option displays a new page with a detailed description of the App, possibly videos or screen shots of the App, any applicable license requirements. Paid-License Apps: Instructions are provided here on how and where to purchase a license key. 1. 2. 3. 4.
Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. Log in to your Xerox® App Gallery account. Select My Apps. To review / read the software disclosure of an App in My Apps catalog, perform the following substeps. a) Locate the desired App in the list, and select Software Disclosure from the Action drop-down menu. A Software Disclosure message displays. b) Read / review the disclosure information. c) Select Close.
5. To review / read the details of an App in My Apps catalog, perform the following substeps. a) Locate the desired App in the list, and select Details from the Action drop-down menu. A new page displays with detailed information about that App. b) Read / review the App details. c) Select My Apps to return to your catalog of Apps.
Releasing a License for an App that was Deleted from a Device A Paid-Licensed App was deleted from a device without releasing the license. Therefore, the App License still is assigned to that device. Use this procedure to release the App License from the device. Note In order to release the App License (which is still assigned to a device), the App must be installed again on the device; this reapplies the same license to the App. The App then must be uninstalled; this also releases the license for the App.
Xerox App Gallery User Guide
6-9
My Apps
A network connection to the device is required to correctly release the license from the device. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Log in to your Xerox® App Gallery account. 3. Select My Apps. 4. From the list, locate the App which was deleted from the device, and select Install from the Action drop-down menu. A list of devices / multifunction printers (MFPs) displays. 5. For the desired device, select the appropriate Install Type; the device is where the App will be installed. This is the same device which still has the App License assigned to it. Select Full Reinstall for the Install Type. 6. Select Install to begin the App installation process. Note The license is reapplied to the App at the time of installation. 7. Return My Apps Catalog, and locate the App in the list. This is the same App that was just installed on the device. 8. Select Uninstall from the Action drop-down menu. A device list displays. 9. Select the device where the app is installed. 10. Select Uninstall. The App is uninstalled and the license is released.
Setting an App as the Default Walk-up Screen for a Device A device / multifunction printer (MFP) may have a specific App assigned as its default walk-up screen. This is the main screen on the device that is shown after the device is switched on, after it exits energy saver mode, and when the device returns to its defaults settings after the Home button is pressed. Note An App only can be set as the default walk-up screen if it is installed on that device. 1. 2. 3. 4.
Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. Log in to your Xerox® App Gallery account. Select My Apps. Locate the desired App in the list, and select Set as Default from the Action drop-down menu. A list of devices / multifunction printers (MFPs) displays. 5. Choose one of the following: • Select one desired device.
6-10
Xerox App Gallery User Guide
My Apps
• Select multiple devices. • Select All Devices 6. Select Set Default.
Xerox App Gallery User Guide
6-11
My Apps
6-12
Xerox App Gallery User Guide
7 Licenses License Classifications The following license classifications are supported: • Free: These are Free Apps and do not require the purchase of a license in order to use them. Free Apps can be installed and used without a license. • Third-Party: These Apps are provided by Third-Party entities. The Apps may be free or may require the purchase of a license. • Xerox Paid-License: These Apps require the purchase of a license.
Information about Xerox Paid-License Apps Paid-License Apps require the purchase of a license in order to use them. • Paid-License Apps are provided by Xerox. • These Apps do not expire, and therefore, will be unlimited. You can continue to use the App with the existing license. • Instructions are provided on how and where to purchase a license key on the App information page (All Apps tab).This information also is provided from the Details option (My Apps tab / Action column, drop-down menu). • Paid-License Apps with Free Trials: Xerox Paid-License Apps allow a limited number of free trials. -
The maximum number of free trials allowed vary depending on the App. Some Apps with free trials provide a maximum of 10 free trials. Each free trial allows you to use the App for a period of time without the purchase of a license. When all the free trials are used, a license must be purchased in order to continue using the App.
Xerox App Gallery User Guide
7-1
Licenses
-
Once the license is purchased, it must be activated from your Xerox App Gallery Account (Web Portal). Upon activation of the license, the App may be used.
Information about Third-Party Paid-License Apps Tip Licenses for these Apps must be purchased from a third-party entity; the licenses cannot be purchased from Xerox. For information about specific third-party license types, contact the third-party entity. Instructions are provided on how and where to purchase a license key on the App information page (All Apps tab).This information also is provided from the Details option (My Apps tab / Action column, drop-down menu). Note Third-Party Paid-Licenses are not managed and cannot be activated from Xerox App Gallery Web Portal.
License Requirement Information License requirement information for an App is located in the following ways: • From the All Apps tab by selecting an App; this opens a page displaying information about the App, including the license requirement for the App. • From My Apps tab, by selecting Details from the Action column drop-down list; • From My Apps tab, by reviewing the License column which displays the license requirement for each App. There are two license requirement categories: • None: This is a free App; no license is required. • Required: This is an App which requires a paid license, either a Xerox Paid-License or a Third-Party Paid-License.
7-2
Xerox App Gallery User Guide
Licenses
Licenses Tab The Licenses tab displays a list of purchased Xerox licenses for their respective Apps. From this tab, a user may activate licenses for these Apps as required. Note Third-Party Paid-Licenses are not managed and cannot be activated from Xerox App Gallery Web Portal. From the Licenses tab, a user may add and activate licenses. Once a license is added and activated, it cannot be deleted. Besides showing a list of purchased licenses, this tab also shows the following information. • License Column: Displays the license name and license key. • Bundle Column: Displays the number of licenses purchased. • Remainder Column: Displays the number of licenses available for use. For example, if 10 licenses were purchased and the Remainder column displays 9, this means that 1 license is in use and 9 licenses are available for use. • Expires Column: This column displays any applicable expiration information. For example, if the App has a license that never expires, the column displays Never.
Activating Xerox Paid-Licenses Note Third-Party Paid-Licenses are not managed and cannot be activated from Xerox App Gallery Web Portal. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Log in to your Xerox® App Gallery account. 3. Select the Licenses tab. The list of purchased licenses displays, if applicable. This list may be blank if there are no purchased licenses associated with the App Gallery Account. 4. Select Activate Licenses. 5. Copy the license key or keys into the Activate Licenses dialog area. 6. Select Activate. The license is added to the App Gallery account and is displayed on the Licenses tab, including the Bundle Count, Remainder Count, and Expiration.
Xerox App Gallery User Guide
7-3
Licenses
The Bundle Count represents the total number of paid licenses available for the App. The Remainder Count represents the number of unallocated paid licenses. Note For Expiring Licenses: The clock starts counting down time when the license is activated for the entire bundle.
Process for Activating and Installing Xerox Paid-License Apps The process for installing and activating Xerox Paid-License Apps is as follows: 1. 2.
Add the desired Xerox Paid-License App to My Apps catalog; refer to Adding Apps to My Apps Catalog. Purchase the license the for the App. Instructions are provided on how and where to purchase a license key on the App information page (All Apps tab).This information also is provided from the Details option (My Apps tab / Action column, drop-down menu).
3. 4.
Activate the license; refer to Activating Xerox Paid-Licenses. Install the App; refer to Installing an App with a Full License from My Apps Catalog or Installing an App from Xerox App Gallery App.
Note Third-Party Paid-Licenses are not managed and cannot be activated from Xerox App Gallery Web Portal.
7-4
Xerox App Gallery User Guide
Licenses
Process for Installing and Activating Third-Party Paid-License Apps The process for installing and activating Third-Party Paid-License Apps is as follows: 1. 2.
Add the desired Third-Party Paid-License App to My Apps catalog; refer to Adding Apps to My Apps Catalog. Install the App. • Installing the App: refer to Installing an App with a Full License from My Apps Catalog or Installing an App from Xerox App Gallery App. • License purchasing information: Instructions are provided on how and where to purchase a license key on the App information page (All Apps tab).This information also is provided from the Details option (My Apps tab / Action column, drop-down menu).
3.
Contact the third-party entity for instructions on activating the license for the App.
Xerox App Gallery User Guide
7-5
Licenses
7-6
Xerox App Gallery User Guide
8 Xerox App Gallery App Procedures Xerox App Gallery App Overview Note By default, many Apps from Xerox App Gallery, including the Xerox App Gallery App, are preinstalled and available on all 2016 Xerox ConnectKey Technology-enabled i-series MFPs. Devices that do not have the software for 2016 Xerox ConnectKey Technology-enabled i-series may require the user to manually install the Xerox App Gallery App. The Xerox App Gallery App may be installed on devices which do not already have it installed. If the Xerox App Gallery App is not installed already on a device, it is available from Xerox App Gallery Web Portal. By selecting the Xerox App Gallery App from the device control panel a user may request a new Xerox App Gallery account or log in to an existing account. Once logged in, the user can perform various App Gallery functions, such as browse available Apps and install / update Apps.
Xerox App Gallery User Guide
8-1
Xerox App Gallery App Procedures
Tip In order to use the Xerox App Gallery App, the following device requirements must be met: • MFPs require a network connection. • The MFP must be loaded with the software for 2016 ConnectKey Technology-enabled MFPs. • MFPs must have Xerox Extensible Interface Platform® (EIP) version 3. 5 or higher installed. Note SSL Certificates provide secure communication of private and sensitive information over network connections. If SSL certificate validation is disabled, the secure communication of private or sensitive information is vulnerable. Typically, it is recommended that Verify server certificates is enabled on your MFP, though this may cause issues with other application. For further information refer to the Xerox App Gallery Online Support at http://www.support.xerox.com/support/xerox-app-gallery.
Creating an App Gallery Account from Xerox App Gallery App An App Gallery account may be created in one of the following ways: • From the Xerox App Gallery Web Portal or • From the Xerox App Gallery App Important Only one account needs to be created. This procedure provides instructions for creating an account from Xerox App Gallery App. Note Also refer to Creating an App Gallery Account from Xerox App Gallery Web Portal. 1. From the MFP home screen, select the Xerox App Gallery App icon. 2. Select “Request an Account” from the App Gallery login / request account window. The Request An Account window displays. 3. Select inside the “Enter your email address” field. The on-screen keyboard displays. 4. Enter a valid email address and from the on-screen keyboard select Enter. 5. Select OK.
8-2
Xerox App Gallery User Guide
Xerox App Gallery App Procedures
6. 7. 8.
9. 10. 11.
An Account Message displays stating “Instructions for creating an account have been sent to the email address provided.” Select Close to return to the App Gallery login / request account window. Access your email account for the email address you provided to Xerox App Gallery. Open the “Xerox App Gallery Account Request” email, and Select the URL link for creating an account. The Xerox App Gallery Web Portal opens the URL https://appgallery.external.xerox.com/xerox_app_gallery/login and displays the App Gallery Terms and Conditions. Review and accept the “Terms of Use.” Select the Agree button to continue creating an account. Enter information in the required fields: • • • • • • •
User ID Password Confirm Password First and Last Name Company Name Address (Street, City, State / Province, Postal) Country
12. Select OK. After the account is created, a message displays stating “Your account has been activated. You can now login.” 13. Return to the MFP to log on to your App Gallery Account, and continue to Logging in to your Account from Xerox App Gallery App.
Logging in to your Account from Xerox App Gallery App 1. From MFP home screen select the Xerox App Gallery App icon. The App Gallery login / request account window displays. 2. Enter your account User Name by using the on-screen keyboard. 3. Enter your account Password by using the on-screen keyboard. 4. Select Enter from the on-screen keyboard. 5. Select Log In. The App Gallery displays. Note Refer to Troubleshooting if a message displays stating “The App gallery server could not be found or is unavailable.”
Xerox App Gallery User Guide
8-3
Xerox App Gallery App Procedures
Information about Automatically Adding a Device (Xerox App Gallery App) Use Xerox App Gallery Web Portal to add devices your App Gallery Account, Devices catalog; however, a device also may be added automatically from the App Gallery App. The following conditions must be met in order to automatically add a device from App Gallery App to your App Gallery Account, Devices catalog: • The device cannot reside currently in your Devices catalog. • The device that you want to add must have the App Gallery App installed on it. • You must log onto the App Gallery App with your Xerox App Gallery account; you cannot use a previously saved set of credentials (Saving the Administrator Credentials to the Xerox App Gallery App). • If App Gallery App is accessed by using administrator saved credentials, you must contact the device administrator. You will not be able to login to App Gallery App with your App Gallery Account credentials while the administrator-saved credentials are active. Tip A device can be added to your account by using Xerox App Gallery Web Portal; refer to Adding a Device to an App Gallery Account (App Gallery Web Portal). Once this set of criteria is met, the device may be added automatically to your App Gallery Account by performing the procedure entitled Automatically Adding a Device to your App Gallery Account from App Gallery App. Note When the device is added automatically to your App Gallery Account, it only adds the device model name and the device IP Address. You must edit the device by accessing your account with App Gallery Web Portal and enter the Device Username and Device Password. This ensures that there is successful communication between App Gallery Web Portal and the device.
Automatically Adding a Device to your App Gallery Account from App Gallery App 1. From MFP home screen select the Xerox App Gallery App icon. The App Gallery login / request account window displays. 2. Log in to App Gallery App by entering your Xerox App Gallery account credentials (User name / ID and Password). The App Gallery displays.
8-4
Xerox App Gallery User Guide
Xerox App Gallery App Procedures
Note The device is added automatically to your Xerox App Gallery Account; when you log into your account with App Gallery Web Portal, the Devices catalog / tab displays the device in the list. Perform Adding the Device Credentials to your App Gallery Account in order to ensure communication between Xerox App Gallery Web Portal and the device.
Adding the Device Credentials to your App Gallery Account When the device is added automatically to your App Gallery Account, it only adds the device model name and the device IP Address. You must edit the device by accessing your account with App Gallery Web Portal and enter the Device Username and Device Password. This ensures that there is successful communication between App Gallery Web Portal and the device. 1. Go to https://appgallery.external.xerox.com/xerox_app_gallery/login. 2. Log in to your Xerox® App Gallery account. 3. Select the Devices tab. 4. Locate the device which was added automatically with Xerox App Gallery App and select Edit. The Edit Device dialog displays. 5. Choose one of the following: • Select a Login Group from the drop-down list: A Login Group automatically enters the device (administrator) credentials in the Device Username and Device Password fields. • Enter the Device Username and Device Password in their respective fields. 6. Select Submit. The device credentials are now added to the device.
Installing an App from Xerox App Gallery App 1. From MFP home screen select the Xerox App Gallery App icon. One of the following windows display: • The App Gallery login / request account window displays. • If an device administrator previously saved their Xerox App Gallery Account credentials, then the App Gallery displays. The saved Admin credentials allow all MFP users to access Xerox App Gallery App without having to login with individual account credentials.
Xerox App Gallery User Guide
8-5
Xerox App Gallery App Procedures
2. If necessary, login in with your App Gallery account credentials (User Name and Password). 3. Browse the Apps by using the Left / Right Page buttons at the bottom of the App Gallery screen. 4. For the desired App, select the Install button. The License Agreement dialogue displays. If the App was previously installed and a new version is available, the button displays as Update. 5. Select Agree. The installation process begins. Note If the App does not successfully install, the Install button redisplays; select Install to attempt the installation process again. 6. Select the Exit button to exit and close the Xerox App Gallery App. Note The newly installed App automatically gets added to the user's account in My Apps catalog (Xerox App Gallery Web Portal). Related Topics: Logging in to your Account from Xerox App Gallery App
Updating an App from Xerox App Gallery App Use Xerox App Gallery App to update an App on the device. Tip Updating the App overwrites the existing App version with the new version. 1. From MFP home screen select the Xerox App Gallery App icon. One of the following windows display: • The App Gallery login / request account window displays. • If an device administrator previously saved their Xerox App Gallery Account credentials, then the App Gallery displays. The saved Admin credentials allow all MFP users to access Xerox App Gallery App without having to login with individual account credentials. 2. If necessary, login in with your App Gallery account credentials (User Name and Password). 3. Locate an App with an update button, and select Update.
8-6
Xerox App Gallery User Guide
Xerox App Gallery App Procedures
The License Agreement dialogue displays. 4. Select Agree. When the update is complete, the Update button disables / can no longer be selected, and it changes to Installed. 5. Select the Exit button to exit and close the Xerox App Gallery App. Note The App is updated automatically to the user's account in My Apps catalog (Xerox App Gallery Web Portal). Related Topics: Logging in to your Account from Xerox App Gallery App
Device Administrator Procedures (Xerox App Gallery App) Important The following procedures are performed only by a person who has multifunction printer (MFP) Administrator privileges and is logged onto the MFP as Administrator. A MFP may have more than one Administrator. Non-Administrator users must contact an Administrator in order to have one or more of these procedures completed.
Saving App Gallery Account Credentials (Xerox App Gallery App) This procedure provides instructions for saving an App Gallery Account credentials (User ID and Password) to Xerox App Gallery App. By saving these account credentials, all multifunction printer (MFP) users automatically have access to Xerox App Gallery App without having to login with individual account credentials. Note Only a person who has multifunction printer (MFP) Administrator privileges and is logged onto the MFP as Administrator may perform this procedure. A MFP may have more than one Administrator. If you are not an Administrator of the MFP, contact a MFP Administrator for assistance. 1. From the MFP home screen, login in as Administrator. 2. Select the Xerox App Gallery App icon on the MFP home screen. The App Gallery login window displays. 3. Using the on-screen keyboard, enter your User ID in the “Enter User ID” field.
Xerox App Gallery User Guide
8-7
Xerox App Gallery App Procedures
4. Using the on-screen keyboard, enter your Password in the “Enter Password” field. 5. Select Enter on the on-screen keyboard. 6. Select Log In. A pop-up window displays a message asking “Do you want these login credentials to be used for others to access App Gallery?” 7. Select Use Credentials. The credentials are saved and the App Gallery displays. All MFP users are automatically logged in and have access to App Gallery after selecting Xerox App Gallery App.
Changing App Gallery Account Credentials (Xerox App Gallery App) Use this procedure to change the saved App Gallery Account credentials (User ID and Password). Note Only a person who has multifunction printer (MFP) Administrator privileges and is logged onto the MFP as Administrator may perform this procedure. A MFP may have more than one Administrator. If you are not an Administrator of the MFP, contact a MFP Administrator for assistance. This procedure assumes that a multifunction printer (MFP) Administrator created an App Gallery Account, and the account credentials (User ID and Password) were saved. A valid App Gallery Account is required to change the saved credentials. 1. From the MFP home screen, login in as Administrator. 2. From the MFP home screen, select the Xerox App Gallery App icon. 3. Select the Settings button from the App Gallery screen. The Settings button is the Gear icon located next to the Exit button at the top of the screen. The Settings window displays. 4. Using the on-screen keyboard, enter a new User ID. The old User ID is deleted and is replaced with the new User ID. 5. Using the on-screen keyboard, enter the Password for the new App Gallery Account. The old Password is deleted and is replaced with the new Password. 6. Select OK at the top of the screen. A pop-up window displays a message asking “Do you want these login credentials to be used for others to access App Gallery?” 7. Select OK a second time at the top of the screen. 8. Select Use Credentials. The credentials are saved and the App Gallery displays. If No is selected and the credentials are not saved, the App Gallery App login credentials retain the previously saved credentials.
8-8
Xerox App Gallery User Guide
Xerox App Gallery App Procedures
Deleting (Clearing) App Gallery Account Credentials (Xerox App Gallery App) Use this procedure to delete (clear) the saved App Gallery Account credentials (User ID and Password). When the credentials are deleted, multifunction printer (MFP) users no longer have access to the App Gallery. Users must login to Xerox App Gallery App with a valid App Gallery Account. Note Only a person who has multifunction printer (MFP) Administrator privileges and is logged onto the MFP as Administrator may perform this procedure. A MFP may have more than one Administrator. If you are not an Administrator of the MFP, contact a MFP Administrator for assistance. 1. From the MFP home screen, login in as Administrator. 2. Select the Xerox App Gallery App icon on the MFP home screen. The App Gallery login window displays. 3. Select the Settings button from the App Gallery screen. The Settings button is the Gear icon located next to the Exit button at the top of the screen. The Settings window displays. 4. Select the Clear Credentials button. A pop-up window displays a message asking “Do you want clear the existing credentials used to allow others to access App Gallery?” 5. Select the Clear Credentials button a second time. The saved App Gallery Account credentials are deleted, and the App Gallery login / request account window displays. Note All users must now enter a valid App Gallery Account User ID and Password in order to access the App Gallery.
Xerox App Gallery User Guide
8-9
Xerox App Gallery App Procedures
8-10
Xerox App Gallery User Guide
9 Troubleshooting Refer to this chapter to help find and resolve Xerox App Gallery problems and issues.
Xerox App Gallery Account Issues User Cannot Activate / Create an App Gallery Account An App Gallery account is created from either Xerox App Gallery Web Portal or from Xerox App Gallery App. Important Only one account needs to be created. Account creation may fail for various reasons, including: • SMTP server failure: The Account Activation / Creation Email failed to send due to SMTP Error. • The Account Activation / Creation Email was not received to the email address provided when requesting a new account; the email was sent but the email addressee did not receive it. Check / perform the following: 1. Check your junk email folder for the email message from Xerox® App Gallery. • If the account activation / creation email is there, select the link to complete the activation / creation of the new account. Note To ensure you receive future Xerox® App Gallery emails, specify the message as “Not Junk.”
Xerox App Gallery User Guide
9-1
Troubleshooting
2. No email was received to either your Inbox or the Junk Folder; a temporary SMTP server failure may have occurred. Try at a later time to activate / create a new Xerox App Gallery account. 3. Go to Xerox App Gallery Web Portal: https://appgallery.external.xerox.com/xerox_app_gallery/login. a) Select the Help link. b) Select the Feedback link. c) Send an email to inform Xerox App Gallery Support of the problem. Note When sending an email to Xerox App Gallery Support, ensure that the email address you provide to them is the same one you used when attempting to activate / create a new account. Xerox App Gallery Support will contact you and help resolve the problem. Related Topics: Creating an App Gallery Account from Xerox App Gallery Web Portal Creating an App Gallery Account from Xerox App Gallery App
User Cannot Log into an App Gallery Account (Forgotten Password or User ID) When a user cannot log into their App Gallery account, it is usually for one of the following reasons: • Forgotten Password • Forgotten User ID To log into your App Gallery account, refer to one of the following procedures, and follow the steps to either reset your Password or retrieve your User ID. • Retrieving your App Gallery Account User ID (Xerox App Gallery Web Portal) • Resetting your App Gallery Account Password (Xerox App Gallery Web Portal)
User Cannot Connect to Xerox App Gallery Web Portal 1. Ensure that the computer has internet access. 2. Check the browser security settings. • Modifying the Internet Explorer Browser Security Settings • Modifying the Chrome Browser Security Settings
9-2
Xerox App Gallery User Guide
Troubleshooting
User Cannot Connect to Xerox App Gallery App Message displays stating “The App Gallery Server could not be found or is unavailable.” If the user cannot connect to Xerox App Gallery App (on the device), ensure that the Proxy Server is enabled for Extensible Service Setup. Note Proxy is required for app installations that require a proxy to connect to the internet. 1. Open an internet browser on your computer. The internet browser may be either Internet Explorer or Chrome. 2. From an internet browser, enter the IP address of the multifunction printer (MFP) / device. The Xerox® CentreWare® Internet Services page for that device opens. 3. Select Properties. 4. Login as the Administrator. 5. Under General Setup, select Extensible Service Setup. The Extensible Service Setup page displays. 6. Scroll down to the Proxy Server section and ensure that Proxy Server is enabled. a) Select Proxy from the drop-down list. b) Under the HTTP, HTTPS subsection, verify that the proxy is Enabled and the proxy information is displayed. 7. Proxy Server is / is not enabled. • Yes it is enabled: If the proxy is Enabled and the proxy information is displayed, exit the browser by closing it. • No it is not enabled: Perform the following substeps. a) If proxy server is not enabled, select the Edit button. The Proxy Server page displays. b) On the Proxy Server page, under HTTP Proxy Server, select the Enabled checkbox. c) Select Apply at the bottom of the page. d) Select OK to dismiss the pop-up message box. 8. On the Extensible Service Setup page, select Apply at the bottom of the page. 9. Select OK to dismiss the pop-up message box. 10. Exit the browser by closing it.
Xerox App Gallery User Guide
9-3
Troubleshooting
Device Issues (Xerox App Gallery Web Portal) Internet Browser Plug-in (Add-on / Extension) The Xerox Device Connector is a plugin (add-on / extension) that must be installed and enabled on your internet browser to enable communication between Xerox App Gallery Web Portal and the device. 1. Verify that the internet browser is configured to allow third-party plugins (add-ons / extensions). • Internet Explorer: Verifying / Enabling Xerox Device Connector Add-on for Internet Explorer • Google Chrome: Verifying / Enabling the Chrome Extension for Xerox App Gallery 2. Verify the browser Security Settings for the correct modifications. • Internet Explorer: Modifying the Internet Explorer Browser Security Settings • Google Chrome: Modifying the Chrome Browser Security Settings
User Cannot Add a Device to an App Gallery Account (Xerox App Gallery Web Portal) When attempting to add a device for the first time with Xerox App Gallery Web Portal, the browser (Internet Explorer / Chrome) displays a pop-up message appears which requires permission to install the Xerox Device Connector Add-on (Internet Explorer) / Extension (Chrome). If installation is allowed, the Xerox Device Connector is installed and enabled. This enables the communication between Xerox App Gallery Web Portal and the device. Verify the following: 1. When attempting to add a device, the internet browser displays message that the plugin connector (add-on / extension) may be installed but disabled. Verify that the connector is installed and enabled for the internet browser. • Internet Explorer: Verifying / Enabling Xerox Device Connector Add-on for Internet Explorer • Google Chrome: Verifying / Enabling the Chrome Extension for Xerox App Gallery 2. Ensure the device is operational and is connected to the network. • Internet Explorer: Modifying the Internet Explorer Browser Security Settings
9-4
Xerox App Gallery User Guide
Troubleshooting
• Google Chrome: Modifying the Chrome Browser Security Settings 3. Ensure the device input address is correct. 4. Ensure the device to be added is supported by the Xerox Extensible Interface Platform®, version 2.5 or higher.
Devices are not Displayed on the Devices Tab (Xerox App Gallery Web Portal) Devices are added to an App Gallery account in one of three ways: • Manually by entering the device IP address and other related information, • Importing a .csv file, or • Selecting Discover devices automatically Refer to Adding a Device to an App Gallery Account (App Gallery Web Portal). Tip Verify that the following is enabled: ActiveX Controls for Internet Explorer or the third-party plugins for Chrome. This ensures that App Gallery can communicate with the devices / Multifunction Printers (MFPs). Refer to one of the following procedures: • Internet Explorer: Verifying / Enabling Xerox Device Connector Add-on for Internet Explorer • Google Chrome: Verifying / Enabling the Chrome Extension for Xerox App Gallery
Automatic Device Discovery Does not Return a List of Devices Note Device Discovery is not supported by the Chrome browser. For automatic device discovery Xerox App Gallery must have a network connection available to the supported Xerox devices. Search for multiple devices / multifunction printers (MFPs) by searching a range of IP addresses. When searching a range of IP addresses, verify the following: • Starting IP address • Ending IP address Device Discovery returns a list of devices which support the Xerox Extensible Interface Platform®, versions 2.5 and higher. Note If you choose to add the discovered devices, all of the devices in the discovered list are added. There is no ability to select individual devices from the discovered devices list.
Xerox App Gallery User Guide
9-5
Troubleshooting
Related Topics: Adding a Device to an App Gallery Account Adding a Device with the Discover Device Automatically Option
App Issues (Xerox App Gallery Web Portal) Cannot Install Apps from Xerox App Gallery Web Portal 1. Depending on your internet browser, ensure that the Xerox Device Connector plugin (add-on / extension) is installed and enabled. • Internet Explorer: Verifying / Enabling Xerox Device Connector Add-on for Internet Explorer • Google Chrome: Verifying / Enabling the Chrome Extension for Xerox App Gallery 2. Ensure that the desired devices are added to the App Gallery Account (Xerox App Gallery Web Portal); refer to Adding a Device to an App Gallery Account (App Gallery Web Portal). 3. Ensure that the devices in the Devices tab (Xerox App Gallery Web Portal) are configured with the correct device administrator credentials (Device Username and Device Password). 4. Ensure that the device IP address has not changed, and if it has, update the device credentials in the Devices tab (Xerox App Gallery Web Portal); refer to Editing / Updating a Device in an App Gallery Account. 5. Return to your account (Xerox App Gallery Web Portal) to install the App; refer to Installing / Updating / Reinstalling Apps from My Apps Catalog.
Cannot Uninstall an App / Release an App License from Xerox App Gallery Web Portal 1. Ensure that the device credentials are correct, including Device Username and Device Password. This is the device where the App is currently installed, and from which it will be uninstalled. Refer to Editing a Device in an App Gallery Account (Xerox App Gallery Web Portal). 2. Check the device and ensure that the App was installed on it. 3. Ensure that the App, which is being uninstalled, is not set as the device default, walk-up screen.
9-6
Xerox App Gallery User Guide
Troubleshooting
App Removed from Device If an App was unintentionally removed / uninstalled from a device, it can be reinstalled from Xerox App Gallery Web Portal; refer to Reinstalling an App from My Apps Catalog.
Device Start-up Screen Does not Display the App The device Start-up screen is not displaying the designated / assigned App; refer to Setting an App as the Default Walk-up Screen for a Device.
App Licensing Issues App Licenses are Unavailable for Installation Paid-License Apps require the purchase of a license in order to use them. These Apps are shown as Required (both Xerox and Third-Party Apps).
Xerox Paid-License Apps For Xerox Paid-License Apps, the license keys must be activated from the App Gallery Account (Xerox App Gallery Web Portal), in the Licenses Tab. Refer to Activating Xerox Paid-Licenses.
Third-Party Paid-License Apps Third-Party Paid-Licenses are not managed and cannot be activated from Xerox App Gallery Web Portal. Contact the third-party entity for instructions on activating the license for the App.
Unable to Release App License Review the following information: • If the app is deleted manually from the device without releasing the license from Xerox App Gallery Web Portal, the status of the license in App Gallery is not updated. The license for the App must be released by performing this procedure: Releasing a License for an App that was Deleted from a Device. • For the license to be available for reuse, it must be released from Xerox App Gallery Web Portal by performing the following procedure: Uninstalling an App / Releasing an App License.
Xerox App Gallery User Guide
9-7
Troubleshooting
• The proxy server may not be configured correctly; refer to Setting up the Proxy Server for the Device from CentreWare® Internet Services.
Unable to License App from Device Control Panel To ensure that a Xerox App License is applied correctly, always activate the license from Xerox App Gallery Web Portal. Refer to Activating Xerox Paid-Licenses (Xerox App Gallery Web Portal). Contact the third-party entity for instructions on activating the license for the App.
Unable to Apply a Xerox Paid-License to an App Note Third-Party Paid-Licenses are not managed and cannot be activated from Xerox App Gallery Web Portal. Potential issues which may prevent the activation a Paid-License App: • Ensure that the device is connected to the network, and then activate the license from Xerox App Gallery Web Portal, Licenses tab (Activate Licenses); refer to Activating Xerox Paid-Licenses (Xerox App Gallery Web Portal). • A license was not purchased for the App: 1. 2.
Purchase a license Activate the license from Xerox App Gallery Web Portal; refer to Activating Xerox Paid-Licenses (Xerox App Gallery Web Portal).
Unable to Run Free Trials for an App from Device The issue may be that the maximum number of free trials for an app were used. After all free trials are used, you must apply a license for that app. Purchase a license for the App and then activate the license; refer to Activating Xerox Paid-Licenses (Xerox App Gallery Web Portal).
Xerox Device Connector Plugin - Internet Browser Add-on / Extension The Xerox Device Connector is a plugin (add-on / extension) that must be installed and enabled on your internet browser to enable communication between Xerox App Gallery Web Portal and the device.
9-8
Xerox App Gallery User Guide
Troubleshooting
When attempting to add a device for the first time with Xerox App Gallery Web Portal, the browser (Internet Explorer / Chrome) displays a pop-up message appears which requires permission to install the Xerox Device Connector Add-on (Internet Explorer) / Extension (Chrome). Depending on your internet browser, the pop-up message states the following: • Internet Explorer: “An Active X pop-up window should now appear. Please permit the installation of the Xerox Device Connector from Xerox in order to enable communication between Xerox® App Gallery and your Multifunction Device (MFD).” • Google Chrome: “You will need to install an extension for Chrome in order to enable Xerox® App Gallery to communicate with devices on your network.” Important By default, the Xerox Device Connector add-on / extension is installed and enabled. It remains enabled unless it is manually disabled. To verify / enable Xerox Device Connector plugin (add-on), refer to one of the following procedures: • Internet Explorer: Verifying / Enabling Xerox Device Connector Add-on for Internet Explorer • Google Chrome: Verifying / Enabling the Chrome Extension for Xerox App Gallery
Verifying / Enabling Xerox Device Connector Add-on for Internet Explorer Note The Xerox Device Connector Add-on must be installed and enabled on Internet Explorer in order to add devices from Xerox App Gallery Web Portal. Important Once the Xerox Device Connector add-on is installed, it only needs to be enabled one time, and it remains enabled unless it is manually disabled. To verify that it is installed and enabled, perform one of the following steps: 1. Open Internet Explorer on your computer. 2. To access Manage Add-ons, choose one of the following: • From the Menu bar, select Tools > Manage Add-ons, or • From the Gear icon (Tools), select Manage Add-ons. 3. From the Manage Add-ons window perform the following steps: a) Under Add-on Types, ensure Toolbars and Extensions is selected. b) Ensure the Xerox Device Connector is Enabled by scrolling through the list and locating the Xerox Device Connector. c) If it is Disabled, select Xerox Device Connector.
Xerox App Gallery User Guide
9-9
Troubleshooting
d) Select Enable at the bottom of the Manage Add-ons window. It is now enabled. e) Select Close to save the settings and exit Manage Add-ons.
Verifying / Enabling the Chrome Extension for Xerox App Gallery When attempting to add devices for the first time from Xerox App Gallery Web Portal, the following warning appears: “You will need to install an extension for Chrome in order to enable Xerox® App Gallery to communicate with devices on your network.” The Xerox App Gallery Device Connector plugin must be installed in order for Xerox App Gallery Web Portal to add devices to your account. To verify that it is installed and enabled, perform the following steps: 1. Open the Chrome browser. 2. Select the Customize and control Google Chrome menu (the icon with the multiple horizontal lines) in the upper right corner of the Chrome browser. 3. Select Settings. A new tab opens and displays Settings. 4. Select Extensions (on left side of the Settings page). 5. Locate Xerox App Gallery Device Connector in the list, and ensure that it is Enabled. 6. If it is Disabled, select the checkbox to Enable it. It is now enabled. 7. Close the Chrome browser window.
Setting up the Proxy Server for the Device from Xerox® CentreWare® Internet Services A proxy server acts as a go-between for clients seeking services and servers that provide them. The proxy server filters client requests and if the requests meet the proxy server filtering rules, it grants the request and allows the connection. A proxy server has two main purposes: • To keep any devices (Multifunction Printers) behind it anonymous for security purposes. • To cache content from resources, such as Web pages from a Web server, to increase resource access time.
9-10
Xerox App Gallery User Guide
Troubleshooting
Note If the device is behind a firewall, ensure proper activation of the app by configuring the proxy server information at the device prior to running the app. 1. Open an internet browser on your computer. 2. Enter the IP address of the multifunction printer (MFP) / device. The CentreWare Internet Services page for the MFP opens. 3. Select Properties. 4. Login as Administrator. 5. Under Connectivity, select Setup. 6. Under the Protocol section, for the Proxy Server option, select Edit. a) Under the HTTP Proxy Server section, select Enabled. b) Select the Proxy Server address type. The following options are available: • IPv4 Address • IPv6 Address • Host Name c) Enter in the appropriately formatted address and port number. d) Select Save. Proxy server settings must be Enabled for Extensible Server Setup. The Connectivity page displays. 7. Under General Setup, select Extensible Service Setup. The Extensible Service Setup page displays. a) Under Proxy Server, select Proxy from the drop-down list. b) Under the HTTP, HTTPS section, verify that the proxy is enabled and the proxy information is displayed. c) Select Apply. Proxy server settings apply to features that use HTTP or HTTPS. d) Select Apply at the bottom of the page. Proxy server settings apply to features that use HTTP or HTTPS. e) Select Apply at the bottom of the page. f) Select OK to dismiss the pop-up message box. 8. Exit the browser by closing it.
Xerox App Gallery User Guide
9-11
Troubleshooting
9-12
Xerox App Gallery User Guide
