ReleaseNotes FormsDataPoller

ReleaseNotes FormsDataPoller Autor: Letzte Änderung: Letzter Änderer: System Administrator 12.11.2015 17:07 Thomas Strauß

ReleaseNotes FormsDataPoller Seite 2 von 17 Inhalt 1 What's New 4 1.1 Version 2.1.0 4 1.1.1 Story 4 1.1.2 Bugs fixed 4 1.1.3 Known issues in this release 4 1.2 Version 2.0.0 4 1.3 Version 1.7.3 5 1.3.1 Bugs fixed 5 1.3.2 Story 5 1.4 Version 1.7.2 5 1.4.1 Improvements 5 1.4.2 Story 5 1.5 Version 1.7.1 5 1.6 Version 1.7.0 5 1.7 Version 1.6.6 5 1.8 Version 1.6.5 6 1.9 Version 1.6.4 6 1.10 Version 1.6.3 6 1.11 Version 1.6.2 7 1.12 Version 1.6.1 7 1.12.1 Bugs fixed in this release 8 1.12.2 Migration 8 1.13 Version 1.5.1 8 1.14 Version 1.5 8 2 System Requirements 9 3 Downloading 10 4 Installing 11 4.1 Parallel installation 11 5 Uninstalling 12 6 Forms Data Poller Event Handler 13 7 Known Issues 14 8 Troubleshooting 15 9 FAQ 16 10 Other Resources and Links 17

ReleaseNotes FormsDataPoller Seite 3 von 17 Forms Data Poller Release Notes What's New Version 2.1.0 Story Bugs fixed Known issues in this release Version 2.0.0 Version 1.7.3 Bugs fixed Story Version 1.7.2 Improvements Story Version 1.7.1 Version 1.7.0 Version 1.6.6 Version 1.6.5 Version 1.6.4 Version 1.6.3 Version 1.6.2 Version 1.6.1 Bugs fixed in this release Migration Version 1.5.1 Version 1.5 System Requirements Downloading Installing Parallel installation Uninstalling Forms Data Poller Event Handler Known Issues Troubleshooting FAQ Other Resources and Links

ReleaseNotes FormsDataPoller Seite 4 von 17 1 What's New 1.1 Version 2.1.0 This is a maintenance and feature release 1.1.1 Story Provide Metadata file to onreservationchanged handler: This adds the fully qualified path to the downloaded metadata file in the config folder. If the metadata download is disabled, the parameter will not be set. Provide a possibility to download metadata with formsmap refreshes: This adds a new checkbox in the GUI, when set, the formsmap refresh (also from the gui) will download the metadata from the server as well. Allow onafterjob handler to retry itself by issueing a returncode <> 0: This adds a new checkbox in the GUI, when set, the returncode of the handler is used to set the job to RETRY. This is the same as if the download of the PDF has failed or similar. The retry counter will be raised, so a possibility to eventually fail the job is given. The default setting is off, since this is the current behavior. Experimental feature: The application.exe.config file can now carry a new attribute "ApplicationMode" to be "True" or "False". If set to "True", the configuration is taken from the CurrentUser registry hive, no longer to the LocalMachine hive. This feature is experimental and has not been extensively tested. Use is discouraged in production installations. 1.1.2 Bugs fixed The endpoint dialog will no longer point to svc.srs-pen.de as "SaaS" but will point to srs. paperdynamix.de and demo.paperdynamix.de for Test. The SSL is no longer optional and the box has been removed. When simply closing the window, there will be a check, if the configuration is dirty and/or has errors. The user has the possibility to abort the window close. 1.1.3 Known issues in this release If the result code is non zero, and the return code is relevant, the retry will not reach the failed state. This will be fixed in 2.1.1. 1.2 Version 2.0.0 This version contains CI and code signatures for TechniData Biz Solutions. The installer is now signed and will present no longer the "Unknown Publisher" dialog on installation.

ReleaseNotes FormsDataPoller Seite 5 von 17 1.3 Version 1.7.3 This version allows unattended autodeployment of forms, because it will update the formslist automatically by default. 1.3.1 Bugs fixed [ FDP-6] - Verschieben des Datenverzeichnises [ FDP-79] - Datum für neue Formid [ FDP-81] - Forms Data Poller legt 1K PDF an, wenn das PDF auf dem Server nicht vorliegt 1.3.2 Story [ FDP-96] - As a user, I want the formslist to automatically update itself 1.4 Version 1.7.2 1.4.1 Improvements [ FDP-92] - If the configuration has changed, I want to know which entries are different. 1.4.2 Story [ FDP-91] - As user, I want to receive updates differential. 1.5 Version 1.7.1 This is a bugfix release. The XML file for VP requests has never been closed, so the file could remain empty until the OS flushed the buffers. 1.6 Version 1.7.0 This is a minor release with feature enhancements. FormsDataPoller can now download Virtual Pen Requests if the backend is PDiX 3.0 FormsDataPoller can now connect to PDiX 3.0 1.7 Version 1.6.6 This is a minor release with some enhancements and bugfixes. Since one bug could lead to incomplete transmission, we advise to update immediately.

ReleaseNotes FormsDataPoller Seite 6 von 17 fixed issue: In case of an exception on the current list, if there was a retry list on the same reservation, the instance was dropped and not downloaded. This resulted in incomplete transmission on the Forms Data Poller side, forms data is still on PD server, though. enhancement: Instances that do not exist on the server will be retried only 4 times, regardless of the settings for number of retries. enhancement: Retrylist Editor in Add Instance to RetryList accepts now enter key in textfield and will not immediately close the dialog. Typo in menuitem removed enhancement: Synchronize Fetchlists will set last update for new reservations to current global last update 1.8 Version 1.6.5 This is a minor release, with small enhancements. If you are running on a low bandwith line, you should update immediately. enhancement: nothing will be downloaded if pdf of an instance is not current, instance will go into the retry list enhancement: changed logging, replaced Exception.Stacktrace entries with the exception object 1.9 Version 1.6.4 This is a bugfix release. fixed issue 869: removed unused code that provoked an exception in unclear, yet very rare (one out of all installations) circumstances. If you want to upgrade an earlier installation, it will be enough to replace FormsDataPollerLib.dll 1.10 Version 1.6.3 This is a Minor Release with new features and bugfixes. added timeout value for webservice calls, defaults to 10 Minutes (Issue 809) fixed some configuration handling issues (non critical), like "current"-checking on handler timeout set maximum retries to 9999 as opposed to 100 in earlier version (Issue 833) fixed Issue 751 remove pdffile parameter (set empty) if download pdf is disabled fixed Issue 772 defaults for polling interval und retries fixed Issue 773 unlimited retries are now possible fixed Issue 807 Set Global Last Update is not applied to completely new reservations fixed Issue 830 remove instances from registry fixed Issue 850/856 check timeouts for reasonable values and check registry settings on before start of service fixed Issue 851 LICS uses proxy

ReleaseNotes FormsDataPoller Seite 7 von 17 added more possibilities to manage the database in registry: reset global last update without resetting all reservations (to set the default for new reservations) reset the last update for selected reservations only clear the cache on registry for selected reservations add instances to the retry list of selected reservations simple retry- and current- list editor synchronize the registry with the formsmap If you want to upgrade an earlier installation, it will be enough to replace FormsDataPollerLib.dll and FormsDataPollerServiceConfigGUI.exe 1.11 Version 1.6.2 This is a Minor Release with one new feature added possibility to change the Servicename using a dotnet application configuration file. set the key "ServiceId.suffix" in the InstallUtil.config file (must be in the folder where the installutil is installed) see the sample file in the installation folder. create a file named FormsDataPollerService.exe.config and set the same key there. The file must be in the same folder as the original exe file create a file named FormsDataPollerServiceConfigGUI.exe.config and set the same key there. The file must be in the same folder as the original exe file 1.12 Version 1.6.1 This is a Minor Release with new features and bugfixes. Added event handlers to Forms Data Poller (see here) prefix can only be set with password (opcode) default opcode is "polleradm" (w/o quotes) prefix and opcode are encrypted in the registry DataPath cannot contain a trailing "\", will be filtered, even when manually put into registry. proxy "disabled" setting Testbutton will not try to reach svc.srs-pen.de but the configured endpoint removed localhost and komm1 settings from endpoint added HTTPS selection, requires installation of SRS ca certificate, can be downbloaded from portal. srs-pen.de. To install follow click-through at KBImportSRSCACertificateAsTrusted fixed exit code: Unhandled Error Handler is only executed on exception, exit is now soft: Request a controlled stop from the scanner wait for up to 10 Minutes for the scanner to exit, then abort the scanner. Added a (Registry-only) parameter "PollingIntervalGap" (Default 10Sec) that will overlap polling intervals to catch uploads happening during the polling interval (Gap is not checked for double polls).

ReleaseNotes FormsDataPoller Seite 8 von 17 1.12.1 Bugs fixed in this release ID State Description 432 FIXED Service cannot be uninstalled if still running 484 FIXED Instance ID could contain invalid characters for filenames 486 FIXED Poller had issues with application locked instances 503 FIXED Server and Client in differnent timezones 684 FIXED Dialogwindows with wrong application name 685 FIXED Registry with wrong Application name in path 686 FIXED Exception on Stop Service 701 FIXED prefix need protection with password 732 FIXED Test Endpoint always tests with svc.srs-pen.de, not the setup endpoint 733 FIXED Enpointdialog requires cleanup 738 FIXED waiting cursor during forms map download 1.12.2 Migration In Version 1.6 the registry path used is different from 1.5. To migrate the setup, you need to rename the registry key HKLM/Software/SRS/SimplePoller to HKLM/Software/SRS/FormsDataPoller before the software is started for the first time. If you do not migrate the registry settings, the application will choose default values and you need to use the configuration GUI to setup everything as required. You can use the same data-folder as before, the syntax of the formsmap did not change. 1.13 Version 1.5.1 Reduced registry access while service is running Changed internal time strategy for polling instances Minor Bugfixes 1.14 Version 1.5 Improved Proxy support: Will now support MS ISA Proxy and autoconfig proxy scripts Minor Bugfixes

ReleaseNotes FormsDataPoller Seite 9 von 17 2 System Requirements Windows XP, 2000, Vista.NET 2.0 on the target endpoint PenInfoDeskService 1.4.18 or higher Write access to the registry HKLM/Software/SRS/FormsDataPoller*

ReleaseNotes FormsDataPoller Seite 10 von 17 3 Downloading The FormsDataPoller can be downloaded from the partner area on the SRS homepage http://www.srsmanagement.de.

ReleaseNotes FormsDataPoller Seite 11 von 17 4 Installing Run the Setup.exe from the downloaded zip-file. Change the service runtime user in the services configuration applet in Windows. The runtime user requires full access to the registry path HKLM/Software/SRS /FormsDataPoller*. Use the registry editor (=regedit.exe=) to change the access rights. The runtime user requires full access to the datapath set in the poller GUI and write access to the configured log-path (usually the installation folder). 4.1 Parallel installation To install multiple services on one machine, please consult the documentation for integration tools.

ReleaseNotes FormsDataPoller Seite 12 von 17 5 Uninstalling Uninstall the service from the Windows/Software window. The uninstaller will stop the service and remove all components.

ReleaseNotes FormsDataPoller Seite 13 von 17 6 Forms Data Poller Event Handler The Poller 1.6.1 introduces event handlers that are called through the execution of the polling cycle. The following handlers are supported: Handler command line parameters description AfterJobWrit e "DataPath" "DataFile" "PdfFile" "OkFile" "status" "instanceid" "formid" called after each write UnhandledErr or "DataPath" "Exception Message" "Exception Source" called after Service Start function returns with error (Exception), service is then stopped BeforeJobWri te (reserved, not implemented yet) ReservationS witched "DataPath" "new reservation key" "old reservation key" called when the next reservation is processed Fetch List imported "DataPath" "reservationkey" called after all instances to be draw are collected. Note:* In a later version, this will possibly receive the list of instances to be polled as STDIN list,\ so do not use STDIN/STDOUT for anything The status parameter will be one of OK, RETRY, FAIL, TIMEOUT. The commandline parameters are given with quotes regardless of spaces in the parameter. Proper parameter parsing is required. The Installation will provide a set of sample-handlers that are installed in the application folder. You can use them as a starting point for your own implementations. Please check the website for sample handlers that we created during projects and that we can provide to the public.

ReleaseNotes FormsDataPoller Seite 14 von 17 7 Known Issues Depending on your local security settings, the service might not work under the local system user. In that case, create a service user that has the appropriate rights and run the service as this user. To setup a mapped folder as data folder, it is required to enter the UNC-path of the folder, not a mapped device letter. The user running the poller service must have access rights to the UNC location and must not require any login prior using the remote path. If the server reports an error 400 on a request, the server is missing the lics/ping.do application. There is an issue with some Windows HTTP implementations, that after an error 404, the next request to the server fails.

ReleaseNotes FormsDataPoller Seite 15 von 17 8 Troubleshooting In order to work properly, the following servers must be reachable: https://svc.srs-pen.de If the service will not start, check the event log for errors. You should check the user rights settings on the registry (HKLM/Software/SRS/FormsDataPoller) and on the filesystem. If the service cannot reach the PaperDynamix server, check the logs and check the proxy settings. It is important to notice, that the service runtime user must have proper access rights on the proxy server as well, if you are running an identity manager. Check, if the service runtime user has an expired or changed password. You should create a service runtime user with a password, that never expires and that the user cannot change.

ReleaseNotes FormsDataPoller Seite 16 von 17 9 FAQ

ReleaseNotes FormsDataPoller Seite 17 von 17 10 Other Resources and Links