ReleaseNotes FormsDataPoller
Letzter Änderer: Letzte Änderung:
Autor: System Administrator
12.11.2015 17:07 Thomas Strauß
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
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
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.
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.
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
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).
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
2 System Requirements
Windows XP, 2000, Vista .NET 2.0
on the target endpoint PenInfoDeskService 1.4.18 or higher
3 Downloading
The FormsDataPoller can be downloaded from the partner area on the SRS homepage
http://www.srs-.
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
. Use the registry editor (=regedit.exe=) to change the access rights.
/FormsDataPoller*
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
5 Uninstalling
Uninstall the service from the Windows/Software window. The uninstaller will stop the service and remove all components.
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.
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.
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.
