Enabling Streaming
- Akash Kumar Jaiswal (Unlicensed)
Streaming is useful while working with large files or documents. Streaming processes files by streaming the part of a file rather than loading the whole file into memory. You need to enable streaming to process large size file while mapping Source and Destination elements but before enabling you must follow streaming guidelines.
You need to enable streaming to process large size file while mapping Source and Destination elements.
Prerequisites
Ensure you have the License that supports Streaming in Adeptia Connect.
Changing Saxonica jar name
To enable the streaming, customers will have to change the jar name manually. Following are the steps to change the jar name.
- Go to …<ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\etc.
- Open launcher.properties file and search for JAR:SAXON.
- Rename old saxon9pe.jar (old jar name) to saxon9ee.jar (new jar name)
- Restart kernel and web runner.
Handling Saxonica in v2.8
With upgrade to Adeptia Connect v2.9, existing customers using Adeptia Connect v2.9 will be automatically rolled back to the older version (i.e. saxon9pe.jar) of Saxonica. If you want to use Streaming feature follow the steps mentioned above for changing the jar name.
After you have upgraded Saxonica to ee version in latest version, you must run regression testing to ensure that all your existing mappings are working fine.
Enabling streaming
By default, ‘Streaming Mode’ is disabled in the mapping. To enable streaming follow these steps:
Go to Open > Preferences.
On the Preferences screen, click XSL on the left pane.
- Select Version 3.0 as XSL Version.
- Select Saxon as XSL Transformer.
- Select Streaming Mode check box to enable streaming.
On clicking 'Streaming mode' an alert message will be displayed with a link to documentation, follow the link to check if your mapping follows the mapping rules. If yes then click 'OK' to continue with Enable Streaming mode. - Click Done to save the XSL settings.