ibm.ViewerDetectionPipeAdded by IBM on July 25, 2013 | Version 1 (Original)
|Detects what version of the Viewer is installed on the client's computer and stores this information into the data bucket.
You can use this pipe to determine whether or not a Viewer is installed on the client's computer. You can also use this pipe to validate XFDL versions. For example, if a client tries to open a form that is XFDL version 7.0 and they only have the 2.5 version of the Viewer installed, the form will not open. Using this pipe you can inform the client that they need upgrade to a newer Viewer.
Note: If no Viewer is installed then "none"is the returned result.
Table 1. Table containing expressions and their descriptions for the ibm.ViewDetectionPipe
|storeAs||key||The key to store the Viewer version in the data bucket.|
|pidOutputs.main ||pipe||Triggers the next pipe in the pipeline.|
The following code sample detects the Viewer version, stores it in a key called versionOfViewer, and then executes another pipeline:
ibm.ViewerDetection.sample.storeAs = key:versionOfViewer
ibm.ViewerDetection.sample.pidOutputs.main = ibm.ReturnDataPipe.sample
- This pipe can only be executed from the View branch.
- The ViewerDetectionPipe assumes that the current request originated from a standalone Viewer 3.0 or newer, or from a Web browser with the response being returned to that Web browser. The ViewerDetectionPipe cannot be used when accessing the Forms Services Platform with requests created via the PlatformJavaAccess.createRequest(String pipelineURI) method or when handling a submission from a standalone Viewer older than version 3.0
- If you are using the standalone Java™ Access API, then you cannot use the ViewerDetectionPipe.