Enabling Streaming

Owned by Ankit Gandhi (Unlicensed)
Last updated: Mar 18, 2019 by Nitin Beri (Unlicensed)Version comment
2 min read

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 Suite.

Streaming is available with the new installer of Adeptia Suite v6.9.2 and onwards. However, existing customer (on version 6.9 and older) would require to upgrade with patch of v6.9.2 to have this feature. After upgrading to or installing the latest version, you should enable the streaming.

Enabling Streaming

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.

  1. Go to ….Adeptia-installation-path\AdeptiaServer\ServerKernel\etc\launcher.properties
  2. In the launcher properties file search for JAR:SAXON.
  3. Rename old saxon9pe.jar (old jar name) to saxon9ee.jar (new jar name)
  4. Restart kernel and web runner.

Handling Saxonica in v6.9.1

With upgrade to Adeptia Suite v6.9.2, existing customers using Adeptia Suite v6.9.2 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 on Adeptia Suite UI

By default, ‘Streaming Mode’ is disabled in the mapping. To enable streaming follow these steps:

  1. In Data Mapper, click Actions menu, and then click XSL Settings to open XSL settings window.



  2. In XSL Setting dialog box, do the following:
    1. Select XSL Version - Version 3.0
    2. Select XSL Transformer - Saxon, and
    3. Select “Streaming mode” checkbox.



  3. 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.
  4. Click 'Save' to save the XSL Settings.