DataExchange Library Release Notes
The first public release of the DataExchange library was version 18.104.22.168, release date July 10, 2020.
Data Exchange Roadmap
The DataExchange library is under active development. The following new features are on the roadmap of the DataExchange library:
Adding parquet as a new support data format
Creation of OpenAPI specifications for model-based REST APIs
Automated creation of client code for a given REST API from its OpenAPI specification
Automated creation of application databases based on the
Adding these application databases as an additional data source to the (synchronous) DataExchange read and write methods next to JSON, XML, CSV and Excel files.
Exposing these application databases to external applications via dedicated application database-specific API services. This will also allow for asynchronous reading and writing to such application databases from within an AIMMS model.
New Features and Bug Fixes
- 22.214.171.124 [13-10-2021]
Allow adding additional suffices to tables in datasets through
Allow specifying custom mapping attributes to identifiers contained in tables in datasets through the
Allow adding row filters for writing tables in datasets through the
Added the function
dex::DeleteMapping()to delete previously added mappings. AIMMS would crash when mappings were deleted that contained runtime identifiers from a runtime library that was deleted prior to deleting the mapping.
- 126.96.36.199 [29-09-2021]
The Data Exchange
LibraryInitializationprocedure could crash some models running on the AIMMS Cloud platform
Excel sheets with additional columns without a header in the first row would crash in
- 188.8.131.52 [16-09-2021]
Add support for applying NFC/NFD normalizations to composed Unicode character both contained in the model, or when reading or writing an JSON, XML, CSV or Excel data source.
- 184.108.40.206 [15-09-2021]
When reading CSV files, guess the most likely delimiter
Read/write all values according to the identifier unit/selected convention
dex::ReadMappings()function to allow reading mappings from various locations
- 220.127.116.11 [13-09-2021]
Added new function
- 18.104.22.168 [26-07-2021]
dex::ExportStreamContent()would crash for streams bigger than 8 KB
Allow dex::ColumnName annotation to be set on separate index declarations
- 22.214.171.124 [16-07-2021]
Memory streams with binary content could be truncated prematurely when read.
- 126.96.36.199 [14-07-2021]
dex::client::GetResponseHeaders()and other functions would not support arguments that are identifier slices.
- 188.8.131.52 [30-06-2021]
Allow memory streams to be read twice by
Allow double values in JSON documents to be read into string parameters
- 184.108.40.206 [28-06-2021]
Add support for dex::client request tracing
Allow reading integer and double values from JSON string properties.
Fixed crash in
dex::client::GetInfoItems()when calling for string items with no result.
- 220.127.116.11 [23-06-2021]
- 18.104.22.168 [10-06-2021]
Prevent crash on program exit on Linux
- 22.214.171.124 [28-05-2021]
Updated REST service listener component that used a faulty concurrency setting, potentially leading to connectivity loss
- 126.96.36.199 [26-05-2021]
Added a DLL that was missing in the PROClient IFA on Windows, causing WinUI PRO sessions to fail
- 188.8.131.52 [17-05-2021]
Add a completely asynchronous Curl-based HTTP client to the DataExchange library, supporting all string- and integer-valued options provided by libCurl.
Add a REST API server to the DataExchange library, allowing model procedures to become available through a REST API via simple model annotations.
ColumnMappingnames to be used in row-based formats such as CSV, Excel, and row- and column-oriented JSON mappings next to the mapping type-specific names available before. This allows for easier switching between various mapping types.
Allow string values upto 8 kB during data transfer with string parameters in the model. The default max string size is 1 kB, which can be changed via the
max-string-sizeattribute for particular string-valued nodes mapped onto AIMMS identifiers.
Add support for transferring sliced AIMMS data via
ExternalBindingmappings that bind indices to the value of an element parameter.
Allow nodes with an
included-mappingattribute to dynamically map the value of bound indices in the outer mapping to externally bound indices in the included mapping. This allows for splitting mappings into smaller constituing components.
Allow an index bound via the
binds-toattribute to become available higher up in a JSON/XML tree via the
Allow read filtering by skipping all data that cannot be bound to an existing element via the
- 184.108.40.206 [08-02-2021]
Introduce new RowOrientedObjectNode and ColumnOrientedObjectNode for JSON mappings, that are both faster and more compact.
max-string-sizeattribute to allow string parameters to hold strings of up to 8KB (default 1KB).
When mapping from/to JSON, the memory used for storing the JSON object in memory would not be returned to the system.
- 220.127.116.11 [17-08-2020]
The library could crash when writing to a workbook with a duplicate sheet name.
- 18.104.22.168 [12-08-2020]
The library could crash because of using a different version of the libxl.dll (used to actually read and write to Excel files) than the AimmsXLLibrary.
- 22.214.171.124 [06-10-2020]
Added support for reading from and writing to tables in sheets in Excel workbooks
Added support for automatically generating standard Data Exchange mappings from model annotations
Added new mapping attributes
- 126.96.36.199 [27-07-2020]
Name attributes used at mapping locations where no name is needed for a child elemen are now warned against when reading a mapping
Name-regex attributes used at mapping locations where no name is needed for a child element now result in an error
Boolean values in a JSON file are now correctly mapped onto integer, double and string parameters. During a write the value will be output according to the AIMMS storage type.
- 188.8.131.52 [23-07-2020]
Changed name of
force-denseto indicate that attribute is not only used during write.
- 184.108.40.206 [21-07-2020]
Upgraded internally used library because of performance issue
- 220.127.116.11 [10-07-2020]
Initial public release of the DataExchange library