AGETOR 4 AXT Basic

The Basic package includes the AXT transformation engine and the basic AXT mechanisms.

This package is neccesary for the other AXT packages to work.

[ICO]NameLast modifiedSizeDescription
[DIR]Parent Directory   -
[ ]axt_basic4_3_5.apa 11-May-2012 11:13 7.2M
[TXT]release.txt 11-May-2012 11:13 29K
[ ]axt_basic4_3_4.apa 19-Apr-2012 15:24 7.2M
[ ]axt_basic4_3_3.apa 13-Feb-2012 14:01 7.2M
[ ]axt_basic4_3_2.apa 10-Jun-2011 13:46 7.1M
[ ]axt_basic4_3_1.apa 27-May-2011 12:28 7.1M
[ ]axt_basic4_3_0.apa 13-May-2011 10:02 7.1M
[ ]axt_basic4_2_1.apa 26-Apr-2011 14:13 6.3M
[ ]axt_basic4_2_0.apa 24-Jan-2011 11:36 6.3M
[ ]axt_basic4_1_1.apa 09-Nov-2010 09:55 6.3M
[ ]axt_basic4_1_0.apa 17-Sep-2010 13:19 6.3M
[ ]axt_basic4_0_1.apa 16-Jun-2010 08:11 7.5M
[ ]axt_basic4_0_0.apa 08-Jun-2010 13:48 7.5M
AXT RELEASE NOTES:

This document describes changes and bugfixes to the AXT basic 
product.

These changes may affect version upgrades, so if experiencing
problems after a version upgrade, please consult this document
and the major changes between the old and the new version.

===============================================================
2012-05-11 AXT Basic 4.3.5
===============================================================
+ Bug fix: Date format error in utility class caused display problems in status
  overview pages in the control center

+ Improvement: keys were not resolved in filter input attributes.

+ Bug fix: trace id was not always persisted for trace in face of
  certain transformation errors due to an incomplete error trace event.

===============================================================
2012-04-23 AXT Basic 4.3.4 (DDS 4.3.9 should be installed also)
===============================================================
+ When reloading transformation configuration object cache is automatically cleared. Thus 
  reloading configuration should be used also after changes to text-to-XML mappings.
  
+ Bugfix: The "get keys" function of the server entry page was fixed so it shows all
  transformations.
  
+ execmode value ignored in axt configuration since it was not used but caused 
  problems if set to a wrong value e.g. from the AGETOR workbench editor .

+ Bugfix: resendable AP-based transformations did not convey keys "attempt" and "attempts" 
  to called transform. 

+ Return/output properties supported from transformations and certain media. I.e. you may return
  output properties from called transformation to be used in calling transformation.
  Transformation may also state HTTP return values such as content-type and overall HTTP status 
  (e.g. 404 etc).
  
  	See http://wiki.agetor.com/Wiki.jsp?page=Transformation%20and%20Media%20Output%20Properties

+ Requires ADK 4.3.3 or later.
       
===============================================================
2012-02-13 AXT Basic 4.3.3 
===============================================================
+ Bugfix: Rest-proxy servlet would not relay response codes correctly. Fixed.

+ Improvement: Added "ping" transformation for eased inter-project
  connection testing

+ Improvement: ScriptingFilter now caches compiled scripts for 
  better scripting performance.
  
+ Added JSONErrorHandler for use with transformations related to
  mobile communication.

+ Bugfix: Sometimes the FTPInlet would not shutdown in response
  to a stop or shutdown request from the scmd interface or the
  control center. This was caused by unintended axt core startup
  when using access-points.

+ Groovy text template support; set parameter script-engine="groovyTemplate" 
  when using the ScriptingFilter. Then the transformation instructions may
  actually be a Groovy template with references to variables of the 
  transformation.   
		
+ Transformations for mobility. These services may be used from mobile
  clients to utilize the AGETOR mobility framework 
	- requestMobileAccess
	- getMobileStatus
	- storeProperties
	- reportPositionService 

+ Improved log and trace of user sessions
  	- User sessions (mobile or interactive) can leave a trace in the trace system
  	- Configurable trace levels and properties
	- login/logout checkpoints
	- REST-proxy and REST-transformations checkpoints
	
+ Improvement: Less strict parameter substitution in transformations. A non-string key set during
  transform will be rendered with toString() method.

+ HTTPProxyServlet and TransformRestServlet support for
	- parameter value resolution of AGETOR properties
	- addition of http header fields on incoming requests in web.xml 
	  using the prefix "http" on parameter names:

		<init-param>
			<param-name>httpmailaddress</param-name>
			<param-value>${shared.mail.defaultreceiver}</param-value>
		</init-param>

===============================================================
2011-06-10 AXT Basic 4.3.2 
===============================================================
+ dk.bording.axt.tc.scripting.AssignJSONVar filter makes it
  easy to convert the JSON inputstream to a JSON variable
  that can be used in scripting expression with dot-notation.

===============================================================
2011-05-27 AXT Basic 4.3.1 
===============================================================
+ Bugfix: Mail-inlet invocation of the AXT access point caused
  error:
  
  	"Unexpected parameter 'media'. Not defined for access-point 
  	'com.agetor.dds.media.axt'."

===============================================================
2011-05-13 AXT Basic 4.3.0 
===============================================================
+ RestProxyServlet allowing AGETOR to expose an HTTP service that
  reside e.g. on the internal secure network by mapping URL request
  to another URL.

+ Support for logical projects. I.e. to invoke media residing in
  other projects. This is useful for invoking transformations or
  file deliveries on the secure side of the network from the insecure 
  side and allows for more clean separation between inlets and transformation.  

+ Exposure of AGETOR transformations as REST services. You may now invoke
  a transformation from a browser, mobile app or any other system if only
  these support the HTTP-protocol. Query parameters are mapped to keys in a
  convenient way such that method information becomes available in transform.

===============================================================
2011-04-26 AXT Basic 4.2.1 
===============================================================
+ Bugfix: Using storedata functionality on files which generates a large amount of errors, eg. xml validation could result
  in extremely large snippet files. Thus a maximum has been introduced controlled by the property:
  axt.error.store.maxerrors
  The default is to store max 20 errors+snippets per file. 
  
===============================================================
2011-01-17 AXT Basic 4.2.0 
===============================================================
+ Support for embedded scripting in transformations. This allow
  you to use for example Groovy in transformations for manipulation of
  simple as well as complex variable objects. Even XML as variables
  are supported.

+ Bugfix: Scripting filter now supports UTF-8 files with optional BOM marker
  
+ New branch-router type that executes immediately when encountered.

+ Conditional execution of routers based on Groovy tests on variables

+ Bugfix: __ddskey__ option to local call filter did not work properly.

+ Added property support for the number of lines to extract intro an error snippet for use with L&T error view   

+ Upgraded Apache Commons Net from 2.0 to 2.2

+ Transformation errors are not automatically logged. This requires setting the property
  axt.configuration.logtfxerrors=true
 
===============================================================
2010-11-08 AXT Basic 4.1.1 
===============================================================
+ Bugfix: XQuery filter did not function.

===============================================================
2010-09-17 AXT Basic 4.1.0 
===============================================================
+ Support for new trace sub-system compatible with ADK 4.1.

===============================================================
2010-06-16 AXT Basic 4.0.1 
===============================================================
+ Bugfix: Resendable axt calls using the ddsProxy used an deprecated ACTION=true attribute for invoking the DDS. This
  resulted in an unable to resolve genericCmd for media axt error.
  
+ AXT Schema was missing support for precedence attribute in doc-entries.

===============================================================
2010-06-07 AXT Basic 4.0.0 
===============================================================
+ IMPORTANT: AXT 4.0.0 requires Java 1.6 to support Java Scripting.

+ New ScriptingFilter (dk.bording.axt.tc.scripting.ScriptingFilter) 
  that allows for specifying scripting based transformations. 
  The filter supports Groovy, Java Script, BeanShell and a large set 
  of additional languages that can be plugged in as needed. See online help.

+ Added Doc2Mail Filter which allows document delivery to Eboks/DokumentBoks or 
  remote print. 
  
  dk.bording.axt.tc.doc2mail.Doc2MailFilter
  
  See Doc2Mail Filter Reference Guide for guide to the comprehensive list of parameters and usage.
  
+ Added an execute filter which can be used to execute scripts, native programs etc.
  
	dk.bording.axt.tc.FileExecuteFilter

  It takes the arguments "filename", "filepath" and "fileargument". 
  Where "filename" is the name of the file to execute.
  "filepath" is the path to the file to execute (with or without trailing slash) 
  "fileargument" is an argument which is passed to the file to execute. If a file
  is taking more arguments they should be placed within the fileargument.

===============================================================
2010-15-01 AXT Basic 3.1.4
===============================================================
+ Validation files to use with the workbench was included in the package.

+ AXT transformations schema has been updated

===============================================================
2009-04-28 AXT Basic 3.1.3
===============================================================
+ Added schemas for AXT transformations and txt2xml configurations.

+ Added code snippets to ease creation of new transformations using Agetor Workbench.
 

===============================================================
2009-03-30 AXT Basic 3.1.2
===============================================================
+ Bugfix: XQueryFilter did not always respect the output encoding
  requested. Fixed.

===============================================================
2009-02-18 AXT Basic 3.1.1
===============================================================
+ Bugfix: XMLSplitFiler and GenericSplitFilter would not execute
  correctly if no output attribute was explicitly stated. This
  has been fixed.
  
+ Bugfix: Updated Commons net package with the offical commons-net 2.0 release.
  This should fix the mode="ASCII" problem reported for ftpinlet/docdeliver with the
  release 3.1.0.
  

===============================================================
2008-09-12 AXT Basic 3.1.0
===============================================================

+ Filters in AXT now support a default output setting from the filter code by implementing
  the method getFilterOutputDefault(). This allow
  the implementation to specify that output is equal to input from previous filter
  unless the configuration states otherwise. This avoid explicit generation
  of output from the filter and also allow support for alternative output from the
  filter by setting the output="result" attribute.  

+ Removed jar file: commons-file-upload-1.0-rc1.jar since libraries are now a 
  part of the ADK package.

+ Modified XML Splitfilter to respect the incomming XML input encoding when splitting.

+ Added support for database access through AXT using the HQL Filter allowing retrieval and 
  presentation of data from a relational database in XML format. Please see online documentation 
  and tutorials on how to configure and use this filter.
  
+ Added XML-database (eXist) as an option when storing information permanently or ad-hoc 
  during AGETOR transformations. One may keep long-lived or temporary documents and thus 
  perform more advanced data processing involving a set of documents. eXist comes with 
  its own web-interface and from AGETOR transformations you have programmatic access 
  through the AGETOR DocumentPersistence filter. 

+ Added support for XQuery. XQuery is a W3C-standard for queries on XML-data. Be it single 
  documents or a larger collection of XML documents. The XQuery syntax brings associations 
  to SQL with its FLOWR-statements (For-Let-Order-Where-Return) but also allow complex 
  functions, variables etc as part of the scripting language. XQueries may be executed
  under AGETOR transformations on the current XML document or against the eXist database.
  
+ Added new STX Filter. STX technology (Streaming Transformations for XML) allows large XML files to be processed 
  in AGETOR. STX is an XSL-like language that does not build the complete DOM-representation of the XML in memory
  but sequentially process the structures of the XML. The language may be used where the complete internal tree 
  representation of the XML is not really needed - e.g. for summing on data, extraction of sub-structures etc. 
  
+ The AGETOR XMLSplitFilter has been rewritten to use this more efficient processing mode when splitting an XML document.   

===============================================================
2008-02-21 AXT Basic 3.0.2
===============================================================
+ Default high priority is given to external AXT jobs. This allows
  server entry jobs to execute while there is much traffic from 
  inlets to AXT. 
  
+ Improved AXT Configuration loadtime.

+ Bugfix large configurations are nolonger printed to stdout when loaded.

+ Bugfix: Encoding problem when using the storedata attribute. Encoding is now 
  UTF-8 as default, if another encoding is required, the encoding can be appended 
  to the storedata attribute ie: storedata="onerror;ISO-8859-1" 
  
+ Minor bugfix: Stored AXT documents (metadata, and a set of data files) are now deleted
  even if some referenced datafiles does not exist.

+ Temporary AXT files has to be older than one minute before they are deleted on startup.   

===============================================================
2007-10-30 AXT Basic 3.0.1
===============================================================
+ Server entry sub directories delete/create operation bugfix.

+ Stack traces are now truncated to avoid huge stack traces being stored 
  in the database.

+ AXT Server shuts down when it receives a destroy request from nt-service. 
  
===============================================================
2007-09-03 AXT Basic 3.0.0
===============================================================
+ The Text2XML package has been included with AXT basic and works
  exactly as previously. This makes installation slightly easier
  since the text package need not be installed separately.
  I.e. you no longer need to install the text2XML package.
  
+ AXT now conditionally (by configuration) stores the input to
  filters of transformations. You may specify that data should
  be stored on errors, always or never. Since AXT report such
  stored information in connection with trace generation, stored 
  data will be accessible through the Log & Trace GUI. By default
  no data is stored (as usual).

+ Local calls can be made resendable. This is acheved by adding the
  resendable="true" attribute to the filter. Doing so will invoke
  the DDS service for delivery to AXT. This means that an error
  during the local call will result in the invocation being stored
  as a DDS JOB that may be rerun later (through JOBS GUI).
  
+ AXT Filters now have support for reporting the position in the
  input where errors are encountered. When using this facility
  the reported position is used in the Log & Trace module to
  display the context (part of input) where the error occurred.
  The filters for XSL, CVS and EDI processing support this out-
  of-the box, but user-written filters must be modified as 
  specified in the what's new guide to take advantage of the 
  enhanced filter API.

+ AXTRetryableException may be thrown from a filter in a main
  transformation. This signals that the processing could not
  be completed but a later retry may do the job. The DDS service
  will retry such AXT-jobs when DDS is the source of processing
  (the case for mail and FTP/file inlets).
  
+ AXLProcessFilter will now throw an AXTRetryableException if 
  such an exception occured in the filter process. If no AXTRetryableException
  occurs the list of possible other exceptions is caught and thrown as an
  XSLProcessException as usual.
  
+ Added support for chuncked http streams in StreamPoster class 
  to avoid memory problems when posting huge datafiles. 
  (Only supported in Java 1.5 and above) 
  
+ Improved trace event generation to make traces more readable

+ Added a resendable attribute to the LocalCall filter, which 
  allows LocalCalls to be resend(reinvoked) by the Docdeliver service
  both automatically and manually.

+ An XMLSplitFilter has been added to the suite of standard filters.
  Enabling split of an XML document into several parts. The splitfilter
  also contains all the functionality found in the Local Call filter and
  will produce trace events for each splitted fragment in the Trace system. 
  It also support the resend of failed jobs. See documentation for details.
  
+ The server entry allows large file input. The upper limit may be controlled
  by the property axt.serverentry.maxuploadsize which defaults to 50MB.
  
+ Added description support for DDSProxy filters, (LocalCall and SplitFilter)
  Which passes the description attribute for the filter to the DDS server for 
  redelivery identification of origin.
  
+ Error Message for LocalCall exceptions

+ Bugfix: Server Entry subdirectories did not work properly in Linux
  
===============================================================
2006-08-25 AXT Basic 2.1.1
===============================================================
+ Added support for checkpoint tags in the Log & Trace system. 
  see Log & Trace Concepts and Configuration Guide for details.
  
+ Error router traces merged correctly with main trace and a
  'stacktrace' document is input to the error router

===============================================================
2006-08-10 AXT Basic 2.1.0
===============================================================
+ Distributed Log & Trace support

+ New character conversion filter 
  dk.bording.axt.tc.util.AXTCharacterConversionFilter available to map between 
  text file character sets. E.g. ISO8859-1 to IBM850 (Unix/DOS).

===============================================================
2006-01-18 AXT Basic 2.0.10
===============================================================
+ Support for different encodings in the server-entry.
  Different encodings: UTF-8, ISO-8859-x, windows-xxxx etc may now
  be used with the server-entry to allow input in many encodings.
  Note that browsers may still be confused when receiving data
  in different encoding and not know how to reder it properly.
  It may help to set the auto-detect encoding option for your 
  browser.
    More encoding may be added by setting the property 
    
    	axt.template.encodinglist = <charset>:<description>;<charset>:<description>;..
  
  located in axt.properties which holds the encodings that are 
  presentet in the server-entry. By setting the property to all:

    	axt.template.encodinglist = all
  
  the full set of encodings supported by the platform will be presented.
  Note that your browser may not support all of these equally well. The 
  default value includes UTF-8 and ISO-8859-1.

+ Configurable template directory. Server-entry templates may be stored/
  retrived from a directory specified by the property
 
	  axt.template.path

  located in axt.properties
  
===============================================================
2005-09-26 AXT Basic 2.0.9
===============================================================
+ Added "server entry templates" and "attach file" functionality
  to the AXT server entry. This should easy the working with AXT 
  since submitted data and keys may be stored and reloaded at a
  later time. Attaching a file system file as input takes care
  of large input and specially encoded files that previously
  could only be loaded by means of the FTP-inlet.

+ Corrected configuration read so transformation files in def 
  directories are not read

+ In AXT test server-entry corrected "url" to "function" in
  the copyer transformation example

===============================================================
2005-05-26 AXT Basic 2.0.8
===============================================================
+ Includes the latest version of Apache Commons (1.4.0) which 
  is used for FTP communication by I/O components such as AXT 
  FTPInlet and AXT DocDeliver. This version comes with a number
  of bugfixes.

===============================================================
2004-04-27 AXT Basic 2.0.7
===============================================================
+ Bugfix: Fixed a SAXParsing tag buffer issue. Causing only part
  of the tag value to be read in special cases.
  This affects the Tracking configuration initialization
  among other things. 

+ Bugfix: Parameters in AXT can now also contain ';' characters 
  which is use as a string delimiter between values.
  meaning that you can now also use ';' as a value, where
  it earlier would have been replaced by ''.

===============================================================
2005-02-22 AXT Basic 2.0.6
===============================================================
+ Added the possibility to specify default encoding for the
  AXT configuration files. This allows appropriate national 
  encoding. Use the property (axt.properties)
  
	  axt.configuration.encoding=<encoding>
  
  where <encoding> might be ISO-8859-1, UTF-8 etc. UTF-8 is the
  default.
  
===============================================================
2005-01-12 AXT Basic 2.0.5
===============================================================
+ IMPORTANT: This update depends on ADK 2.0.9 or later (ADK 2.0.9 ships with
  the newest XInclude compliant Xerces parser).

+ AXT transformation configuration is now split into a number of XML-files
  with one or more transformations in each. This should ease the working with and
  delivery of new transformations to production environments. Consult the
  "what's new" documentation that comes with this package for all the features.
  
+ AXT does no longer require the explicit definition of keys before use in 
  transformations. Such keys are automatically defined with weight=1.0 instead.  
  If the original mode is preferred you may overrule the new behaviour with by
  setting the property axt.keys.autodefine=false.
  
+ Minor bug fix in server-entry.html: the sixth key in the input form was
  not submitted correctly.

===============================================================
2004-10-13 AXT Basic 2.0.4
===============================================================
+ IMPORTANT: When installing this version of AXT you should upgrade 
  AXT FTP Inlet to 2.0.5 and AXT DocDeliver to 2.0.6 to avoid problems
  in old installations. The fileparsers used in FTP communication 
  has been updated.
  
+ IMPORTANT: If you are upgrading from a previous version you must delete the
  library file "commons-net-1.0.0.jar" (found in WEB-INF/lib) as it has been
  replaced by a newer version.

+ Added a new fileparser, LinuxFTPFileListParser that suits most FTP servers on
  Linux and also some servers on AIX. Please refer to the user guide for more
  information.

+ Bugfix: Method invocation filters unintentionally re-used objects from earlier
  invocations in calls that should not use them for input but only for output.

+ Output from the method invocation filters now uses the same form of
  introspection that is used for input. Specifically, the filters will also
  include properties that have a public getter method.

===============================================================
2004-01-19 AXT Basic 2.0.3
===============================================================
+ IMPORTANT: When installing this version of AXT you should install 
  the axt_ftpinlet2_0_2 to avoid problems with the FTP inlet.

+ Optimized LocalCall filter for calling local document entries with
  streams of any data type. It is recommended to use the LocalCall filter 
  rather than DocumentFlow filter since it is much more resource efficient.

+ Enhanced error trace information returned from AXT. Useful during development
  when using the new enhanced server entry

+ Parameter passing to XSLProcess filter in AXT configuration

+ Dynamic update and creation of AXT keys from XSL-scripts

+ Now serial filter execution as default to support key manipulation 

+ Filters may use other input than that of previous filter: (i) directly 
  inlined input or (ii) input from an URL

+ You may now specify that the output from a filter should be (i) result of 
  processing (default), (ii) the output from the previous filter or (iii) 
  whatever input the filter used (e.g. previous filter, inlined input or URL result)

+ Inlining of XSL scripts in AXT configuration

+ Inlining of filter input (if output of previous filter should not be
  used)

+ Enhanced axt server-entry for testing your transformations. The new 
  server entry allows you to provide both name and values for keys.

+ The AXTSchemaValidater allows the use of relative filenames in schema 
  include directives.

===============================================================
2003-9-16 AXT Basic 2.0.2
===============================================================
+ Fixed a small bug where keys with big letters wasn't matched
  correct when finding the document entry.

===============================================================
2003-7-14 AXT Basic 2.0.1
===============================================================
+ Support was added for cross filter instance sharing of information.
  Filters may request information objects using a key. When same key
  is used across filters, same object is returned from the core. Filters
  are responsible for the initial creation of the object which must 
  adhere to a simple interface. The information may be used for
  statistical information gathering. Since info objects must be
  able to return the held information in a generic format it may be
  browsed from the AGETOR control center. Consult the AXT Programmers Guide
  for more information.

+ AXT Control Center supports display of filter information if provided
  by filters.

===============================================================
2003-5-30 AXT Basic 2.0.0
===============================================================
+ Has been rebuild and packaged for ADK 2.

+ All references to INSIDE_HOME has changed to AGETOR_HOME.

+ Small bug fix when the AXTConfiguration doesn't exist.

+ The AXT extension to the AGETOR Control Center is now part
  of the installation of the Basic package.

+ The XSLT files used in the AGETOR Control Center has been
  moved to AGETOR_HOME\app\xslt\axt.

+ The AXT Menu item to the AGETOR Control Center has been placed
  in a separate configuration file, in AGETOR_HOME\conf\acc\axt.cfg

===============================================================
2003-3-27 AXT 1.0.2.
===============================================================
+ IMPORTANT: This version of AXT requires ADK 1.3.11 or newer

+ IMPORTANT: The keys used to find a document entry and parameter
  names to the filters have been made case insensitive, so “data”
  is the same as “DATA”.

+ A more efficient internal handling of the incoming requests
  has been implemented resulting in better performance.

+ The configuration will now reload it self when the configuration
  file has been saved. Note that you still have to manually clear the
  Object cache to update eventual new filter configurations.

+ Added the option to set the decimalformat on the class
  dk.bording.axt.tc.invocation.Object2XML.

+ In the XML error message that the client will receive in cause
  of an error now has a <type> tag include that tells the class
  name of the exception that caused the error.

===============================================================
2002-9-20 AXT 1.0.1
===============================================================
+ IMPORTANT: This version of AXT requires ADK 1.3.9 or newer.

+ IMPORTANT: If your are planning to use the AXT Server Entry to
  control AXT remove the "functions" document entry from the AXT
  configuration. In the old version you could get in a situation
  when you have to close the web server to correct an error in the
  configuration file. To prevent this AXT now has an internal document
  entry to handle the AXT Server entry functions, but if you are using
  the AXT extension to the AGETOR Control Center is has no effect.

+ To get AXT to respond more quickly to request from a client the
  main transformation is now fully executed and the result is returned
  to the client before the side transformations are actually executed.
  That means that you can get a result back from AXT before any success
  or error routers are invoked.

+ AXT now supports nested routers. You can have a success or error
  router inside another router. It's the same as the main transformation
  that all the filters in a router are executed before any nested routers
  are invoked.

+ You can set a constraint on a success router, so it only gets invoked
  if the XPath constraint evaluates to true. The constraint can only be
  used with XML content.

===============================================================