How to Setup the SDMS Archive and Print-on-Signoff options in Empower - WKB88176

OBJECTIVE or GOAL

Setup of the SDMS Archive and Print-on-Signoff options in Empower

ENVIRONMENT

• NuGenesis 9 SDMS
• NuGenesis 8 SDMS
• Empower 3 client on it's supported Windows / Citrix platforms

PROCEDURE

Empower can be configured to print reports to UNIFY when a user signs off on a result. For this to work, the SDMS Sign Off Settings must be set within the Empower Configuration Manager.

Pre-requisites:　

• The NuGenesis SDMS SDK (Full or Runtime) must be installed on the Empower client
• A NuGenesis UNIFY printer must be installed on the Empower client
• The NuGenesis SDMS Service Release must be installed on the Empower client, after UNIFY and the SDK
• The "NuGenesis SDMS Interface" license, P/N 667002343, must be activated in Empower; if not, then the SDMS Archive and Print-on-Signoff options will be disabled
• NuGenesis 8 only: Copy the NG80ToolkitLoginKey.exe program to the Drive:\Empower\Bin folder on the Empower client. Open a command prompt with admin rights and run:
  • NG80ToolkitLoginKey.exe ON

Configuration procedure:　

1. In the Empower Configuration Manager, click the View menu > SDMS Archive Properties
2. This window controls the Empower policies for two features: Archive-on-Delete and Print-on-signoff. Archive-on-Delete marks a project within Empower as ready for archiving, when a user deletes a project. This feature is not the subject of this article
3. First, select the UNIFY printer that Empower should use to print the reports. This list is a list of all of the Windows printers that are installed on the Empower machine. Make sure that a UNIFY printer of the same name is installed on all of the Empower client PCs or Citrix VMs
4. Enter the URL for Web Vision in the NuGenesis Server URL box. Use the http:// URL, even with NuGenesis 8 SR2 and later versions. Click Connect. The Empower client will Ping the SDMS server, and if successful, then use the NuGenesis SDK to connect to the server and request the server location list. Empower3 does not accept "https" URLs even though SR2 and later use HTTPS exclusively
5. Select the NuGenesis Server Location, Server, Project, and View from each list. There will be a delay after making each selection before the results are visible in Empower
6. Optionally, select a NuGenesis Template that Empower should specify in order to extract metadata from the Signoff report and store in the NuGenesis metadata tables
7. Click OK to the dialog box. You may be requested to enter a Comment and/or your password, depending on the system policies within Empower

Signing off on a result:　

1. Log in as any user other than System, because the System user cannot sign off on any results　
2. Open an Empower project for browsing. Select a suitable result. Right-click on the result and choose Preview/Publisher. In the "Open Report Method" dialog box, select "Use the following Report Method", and select a report method in the list. Make sure that the method is marked as "Allow this method to be used in Sign Off" in the method properties, or the Sign Off function won't be available

Troubleshooting:　

Make sure that the Empower project is not locked.　

Make sure that the NuGenesis SR patch is applied on the Empower machine if the NuGenesis version is 8.0 SR2 or later. If the Empower machine has an earlier version of the SDMS SDK installed, then Empower will not be able to connect to SDMS.　

Install the UNIFY hotfix for 64-bit Windows from the Power of Two media. This fix allows UNIFY to resolve the Printed By name of 32-bit programs when running in a 64-bit Windows system. This fix is necessary for the print-on-signoff to be seamless. UNIFY is coded to allow the seamless login only when the Printed By name is "Empower", and without this patch, the printed by name is "Microsoft Windows Operating System". The user would be presented with a UNIFY logon box and the manual mode dialog boxes, if the printer is set for manual mode.　

Set the "WatersService" to run under a named domain user account. By default, it runs as LocalSystem, which means that the print jobs created during print-on-sign off are owned by "SYSTEM". UNIFY tries to connect to the ng80prox.exe process that is associated with the print job owner. If the job owner is SYSTEM, then it will look for ng80prox running as SYSTEM, and if it's not found, then the print job will fail. The print job will appear in the printer queue but only briefly, for a few seconds, and then it will be deleted. Th following error messages appear in the eventvwr event logs:　

• PROXY.ProcessErrorEx: OpenConnection failed　
• PROXY.OpenConnection: CreateFile failed, rc=2　
• An error occured processing the print job. If the error persists, contact Technical Support. The cause of the error was: PrintJob: PrepareDatabase failed　
• NGMETA.PrepareDatabase: RunEDVO failed　
• PROXY.QueryServerStatus: OpenConnection failed　
• PROXY.RunEDVO: OpenConnection failed　
• NGUI.DrvDocumentEvent: CheckProxyStatus failed　

If the Configuration Manager program crashes, or the Print on Signoff button appears to work but it doesn't send any print jobs to UNIFY, then you may need to reset the user's preferences in Empower. Log in to the Configuration Manager and click the View menu > Copy Preferences. Select "System" as the source user, and select any project as the source project. Select the logged-in user as the Copy To User, and Select all projects for the Copy To Project. Click OK and Empower will copy the preferences. Log off and back on to Empower.

ADDITIONAL INFORMATION