iBOLT Past Release Notes - Data Integration and...

iBOLT Past Release Notes

T his document includes the release notes of all the iBOLT versions and service packs that precede the current iBOLT release. For information about the current iBOLT release, see the ReleaseNotes.pdf file provided with the iBOLT installation.

iBOLT Version 3 Release Notes Welcome to iBOLT Version 3, which has been designed to deliver an easy-to-use, flexible, and cost-effective business integration solution.

This document highlights the new and enhanced features that have been added to iBOLT Version 3.

General Information

Installing iBOLT You can find information about installing iBOLT in the iBOLT Installation Guide.pdf. The guide also contains information about the prerequisites for using iBOLT flow components.

iBOLT Technical Notes Magic’s International Technical Support produces iBOLT Technical Notes on a range of useful topics. You can find the Technical Notes in the iBOLT Help and on Magic Software Enterprises’ Website.

iBOLT Version 3 Certification For information about the various platforms on which iBOLT Version 3 has been certified for operation by Magic Software Enterprises, refer to the iBOLT V3 Certification document.

Resource Repository The Resource Repository lets you define the external systems that iBOLT needs to access when executing a project. The Resource Repository provides:

• A single location to manage project resources.

• The ability to manage and configure resources without changing the project code.

• The capability to share and reuse resources among several projects.

Service Repository The iBOLT Service Repository lets you define how flows are invoked from an external system. These services are used when you add triggers to a flow. The Service Repository provides:

• A single location for defining and managing project services, outside of the project.

• Simplification of the project's deployment phase.

iBOLT Version 3 Release Notes July 2008 1

ftp://ftp.magicsoftware.com/iboltproduct/Documents/

Version Control You can use iBOLT Version 3 with the Microsoft Visual SourceSafe (VSS) product, allowing you to save, track, and access different versions of your project files. The Version Control feature lets you work in a multi-developer environment.

Component SDK iBOLT Version 3's Component SDK makes it easy for you to develop your own components, based on uniPaaS or Java, for use in the iBOLT Suite. You can quickly generate the new component's initial code, define its methods, or wrap existing Java classes. You can also create new resource types to support your new component.

Data Mapper The Data Mapper enables you to create an association between Sources and Destinations, in different formats. The Data Mapper automatically connects nodes, creating a comprehensive visual association, making it easy to understand and anticipate the results of your mapping. iBOLT Version 3's Data Mapper provides:

• Enhanced execution of database transactions.

• Conditional mapping.

• Offline editing of the Data Mapper, without a live connection to a database.

• XML context forwarding.

• Source node filters that allow you to limit the quantity of information that is processed, thereby delivering excellent mapping performance.

• The ability to update multiple variables during a single iteration of the Data Mapper execution.

• Greatly enhanced error handling capabilities.

• The ability to handle large schemas.


Web Services iBOLT Version 3's Web services are based on Systinet™. This provides a platform-independent, high performance runtime environment for the creation and deployment of Web services. iBOLT's Web services support:

• SOAP 1.1 and 1.2

• WSDL 1.1, SOAP with attachments (DIME and MIME)

• WS-I basic profile

• WS-I attachments profile

In addition, iBOLT's Web services support the latest security standards, including:

• Transport authentication (Basic/Digest)

• SSL

• Kerberos™

• Authentication, encryption, and digital signing of SOAP messages

Floating License Support The floating license mechanism shares licenses between Servers. When a particular project is idle, other projects can utilize its licenses. This enables you to make optimum use of your iBOLT licenses in a multi-project environment.

Environment Variables Environment variables have replaced iBOLT Version 2.5's logical names functionality. Resource and service definitions can use environment variables for additional flexibility.

User Defined Storage (UDS) iBOLT Version 3's User Defined Storage (UDS) feature enables the definition of multi-dimensional storage tables (arrays). These definitions can then be used in your integration flows to store and retrieve multi-instance data types. After defining the UDS models in the dedicated UDS repository, you can define variables based on these models and use them in the Data Mapper and in flows.

Debugger The Debugger lets you test your integration project during development. It runs your project, or attaches to a running project, and enables you to control the way the project is executed. You can control and view execution sequences, flow variables, iBOLT services, and breakpoints. You can debug parallel flows, and you can debug a remote Server that is running on another machine.


Expression Editor iBOLT Version 3's enhanced Expression Editor lets you create expressions with a plain language editor interface. It includes an auto-complete facility and color presentation, for functions and variables, as well as an intuitive toolbar for ease of use.

The following functions have been added to iBOLT Version 3:

Function Description

TranslateNR Translates all environment variables in a string, including nested environment variables, to their actual values.

XMLStr Converts valid XML data into an Alpha string.

XMLVal Converts a string into a valid XML string.

UDSClear Gets the UDS variable name and clears its data.

UDSDeleteRecord Gets the UDS variable name, the index field name, the index field value, and the UDS model as parameters.

UDSGet Gets the UDS variable name and the UDS model name as parameters, and returns a BLOB containing the UDS table data.

UDSGetField Gets the UDS variable name, the index field name, the index field value, the field name, and the UDS model as parameters.

UDSSet Sets the UDS data using the BLOB and the operation.

UDSUpdateField Gets the UDS variable name, the field name, the field data, the index field name, the index field value, and the UDS model as parameters.


Usability Enhancements iBOLT Version 3 contains many features that are designed to enhance usability and to help you to get the most from the iBOLT Suite. These features include:

• Automatic logging information in flow components.

• A unified variables repository.

• An enhanced Scheduler service.

• Improved error management in steps and triggers.

• Unified component interfaces (method and XML).

• Expanding and collapsing branches in the Flow Editor.

• Resizable screens.

Removed Components The following components have been removed from iBOLT Version 3:

• Call COM • FedEx • iBOLT Portal

• Java

• SAPB1 6.5

• SMS • UPS

These components will be converted to work through the NOP service when you migrate iBOLT Version 2.5 projects to iBOLT Version 3. You should convert eDeveloper-based user-defined components individually, and add them to your iBOLT Version 3 project.

Non-Supported Components in iBOLT Version 3

The following components are not supported in iBOLT Version 3:

• SAP R/3 • Salesforce

The iBOLT Version 2.5 eDeveloper trigger is not supported in this version. In iBOLT Version 3, you can define a uniPaaS trigger with the Component SDK, using the existing code.

Removed/Changed Services The Logical Names service has been removed from iBOLT Version 3. You should use the Flow Data service instead.


Migrating from iBOLT Version 2.5 to iBOLT Version 3

Migrating an iBOLT Version 2.5 project to iBOLT Version 3 is fast and easy.

iBOLT provides a wizard to easily migrate your application.

We recommend reading the Migration chapter in the iBOLT V3 Help before migrating your iBOLT Version 2.5 projects.

Additional Changes iBOLT Version 3 contains the following additional changes:

• The Logical data type was changed to Boolean.

• The FTP methods have been removed from the File Management component.

• The LAN to FTP and FTP to FTP methods have been removed from the Directory Scanner component.

Supported Internal Databases iBOLT V3 supports the following internal databases:

• Oracle 9i (OCI 32-bit only)

• Oracle 10g (OCI 32-bit only)

• Microsoft® SQL Server 2000


• ODBC 3 and above

• MySQL 5.x

Known Issues After migrating a project from iBOLT 2.5 to iBOLT V3, if you want to rename your project, you must save the project using the original project name before renaming.

Magic Software Enterprises Ltd provides the information in this document as is and without any warranties, including merchantability and fitness for a particular purpose. In no event will Magic Software Enterprises Ltd be liable for any loss of profit, business, use, or data or for indirect, special, incidental or consequential damages of any kind whether based in contract, negligence, or other tort. Magic Software Enterprises Ltd may make changes to this document and the product information at any time without notice and without obligation to update the materials contained in this document.

Magic and Magic eDeveloper are trademarks of Magic Software Enterprises Ltd.

Copyright © Magic Software Enterprises, July 2008


iBOLT V3 SP1 Release Notes Welcome to iBOLT V3 SP1, which has been designed to deliver an easy-to-use, flexible, and cost-effective business integration solution.

This document highlights the new and enhanced features that have been added to iBOLT V3 SP1. For information about previous iBOLT versions, see the PastReleaseNotes.pdf file provided with this installation.

General Information



iBOLT V3 SP1 Certification For information about the various platforms on which iBOLT V3 SP1 has been certified for operation by Magic Software Enterprises, refer to the iBOLT V3 Certification document.

Migrating from iBOLT V2.5 to iBOLT V3 SP1 iBOLT provides a wizard to easily migrate your project from iBOLT V2.5 to iBOLT V3 SP1. This wizard is available through a shortcut in the iBOLT installation’s Start menu.

Note: We recommend reading the Migration chapter in the iBOLT V3 SP1 Help before migrating your iBOLT V2.5 projects.

Make sure to perform the following actions after the Migration process:

1. Open and review all Data Mapper steps in the mapping screen by clicking the Map button. Verify that all connections and expressions are still valid and click OK to save changes.

2. Open and review all steps where an XML interface was used to verify that all connections and expressions are still valid. Click OK to save changes.

December 2008 1

ftp://ftp.magicsoftware.com/iboltproduct/Documents/

3. Due to changes in schema locations, the following components require reconfiguration (click the Configuration button): SAP Business One, SAP R/3, Salesforce, JD Edwards, Notes DB. Click OK to save changes.

Upgrading from iBOLT V3 to iBOLT V3 SP1 iBOLT will automatically upgrade a project developed in iBOLT V3 to iBOLT V3 SP1. Make sure to manually copy your project directory to the new installation’s Projects directory.







• MySQL 5.x

• DB2 UDB 8

• DB2/400 V4.4 and above

New Features

Salesforce Connector iBOLT V3 SP1 includes the Salesforce connector, which allows you to integrate the Salesforce.com® CRM solution into your existing business applications.

JD Edwards Connector The JD Edwards connector is designed to provide connectivity to the J. D. Edwards ERP System.

Notes DB Connector The new Notes DB connector is designed to provide access to IBM Lotus Notes databases.

SAP R/3 Connector The SAP R/3 connector is designed to provide access to the SAP R/3 system.

iBOLT V3 SP1 Release Notes December 2008 2

.NET Service The .NET Service is designed to allow execution of code developed in the .NET framework. This iBOLT Service provides backward compatibility to the iBOLT V2.5 .NET component.

Import and Export Functionality The Import and Export functionality provides the ability to easily save and load project objects such as steps, flows or a full business process from one project to another.

Web Services Enhancements Locating and publishing Web Services are provided using the UDDI Server Resource.

Monitor Enhancements The following changes were added to the Monitor:

• Ability to switch Activity Logging on and off during runtime.

• Controlling the Activity Log table size by automatically clearing old records.

• Monitor performance was improved.

Unicode Support Starting with iBOLT V3 SP1, the iBOLT Data Mapper supports Unicode data in the following areas:

• Querying and updating database Unicode columns.

• Reading and writing UTF-8 and UTF-16 XML data.

• Reading and writing Unicode flat files.

Please note the following about this version’s Unicode support:

• The SAP R/3 and SAP Business One components fully support Unicode. All other components support only ANSI in Step mode. If you process Unicode data for these components, the outcome is undetermined.

• The Directory Scanner, HTTP, and Web Services components support Unicode in Trigger mode only.

• iBOLT treats all data saved in BLOBs as binary data. Therefore, in order to view Unicode data, use an application that supports Unicode, such as Notepad.

Changes to Web Services, EJB and COM Services The Service definition of Web Services, EJB and COM require hard-coded property values and will not support environment variables.

Debugger Enhancements The Debugger Context View provides information about UDS variables and allows changing UDS values during Debug sessions.


Enhancements to Resources A Validate button was added to the following Resource types: Domino, FTP, Email and System i. The Validate operation checks connectivity to the defined Resource.

Enhancements to Microsoft Word and Microsoft Excel Components The password fields in the Method interface are encoded.

Mapper Enhancements • iBOLT V3 SP1’s Data Mapper can handle cases where the data includes

the field delimiter character.

• The Boolean data format mapping was changed from Numeric to Logical for Boolean nodes in the XML Source and Destination. This change is applicable for new projects only.

• UDS flow variables can be accessed in the Call Flow operation.

Components XML Interface Changes The ResourceName node was removed from the components’ XSD. The components use the Resource defined in the Step properties.

EJB and JCC Changes The wizard interface of these components was changed to a standard method interface.

Note: For more information about the above changes, see the relevant sections in the iBOLT Help.

Installation Changes Server and Monitor installations were optimized to install only required files and update entries in the Magic.ini file.

License Changes The iBOLT V3 license was changed to include separate FEATURE sections. Components and certain options are available in separate features of the license file, and not as embedded tokens. This change is only applicable to production licenses and is not enforced in Debug session or when a non-production license is used.

For more information see the License section of the iBOLT Help or the iBOLT Installation Guide.


Behavior Changes • In order to execute a project in the Server after running it in Debug

mode, you will need to rebuild the project.

• Error Behavior change: When the Server calls an Error flow or Exception flow, error details will not be saved in the C.UserCode, C.UserString and C.UserBlob variables. These details will be available in the standard error variables: C.sys.LastErrorCode, C.sys.LastErrorDescription and C.sys.LastErrorInfo.

• Component metadata files (XSD files and other project related files generated by SAP Business One, SAP R/3, JDE and Notes DB components) are saved under the project directory and not under the installation's ifclib directory.

• The iBOLT V2.5 Salesforce component retrieved the Objects list directly from Salesforce. In iBOLT V3, the Objects list is saved in the resource file. Therefore, it is only possible to build the list from the resource interface and not from the step itself.

• The Salesforce component’s Operation Success property was changed from Numeric in iBOLT V2.5 to Logical in iBOLT V3. Users must select a Logical variable type after migration.

• The Max instances property’s behavior has changed. In previous releases this property was applied to the main flow and all parallel flows called by it. Starting with iBOLT V3 SP1, the Max instances property is only applied to the main flow and linear flows called by it (flows in the same thread).

Known Issues • The MaxNumberofThreads property in the Server settings is not

saved correctly. You should set it manually by adding [MAGIC_ENV]MaxConcurrentRequests = <the Max number of threads> to the Ifs.ini file.

• The reserved thread to stop the Server is not always available.

• When starting the Debugger from the Flow context menu (debugging one flow), the flow will be executed immediately (AutoStart behavior). When the flow execution is completed once, any triggers that are defined will wait for external events.

• The Debugger hangs when you execute Step or Continue on a breakpoint defined in an Error flow.

• The Upgrade option of the Installation utility is currently not operational. You will need to install iBOLT V3 SP1 as a separate installation.

• When upgrading from iBOLT V3 to iBOLT V3 SP1, you need to redefine the Password fields in your resources.

• In the Salesforce connector, when using multiple operations of Add/Update/Delete/Upsert, the operation is limited to 200 records in one chunk. If the source data contains more than 200 records, the data has to be split into chunks of 200 records.


• Unicode data cannot be mapped to XML nodes encoded as base64.

• The Scheduler and the Flow Enablement section are not imported in the current build.

• If you run a project with .NET framework support, and you receive the Error in .NET invocation:IFC1.IFC1 Code:2140930047 Set Property: iBOLTFramework.dll location error, you should unregister and then re-register the Iboltinvoker.dll file by using this command:

‘RegAsm iboltinvoker.dll /tlb:iboltinvoker.tlb’

iBOLT V3 SP1 Fixed Problems 522596 – The migration process created a wrong project file extension.

720427 – An SBO project did not execute under an iBOLT V3 Server only installation.

757942 – The Checker always displayed an Error label in the Additional Information pane.

924603 – There was a problem zooming into an entry in the BAM Messages View.

930685 – The Data Mapper did not retain connections.

934117 – SAP B1 stored procedures caused an error.

935736 – The User and Password fields in an Email component were not migrated correctly in projects developed in iBOLT V2.5

965090 – The "Using iBOLT as a Web Services Consumer – Implementation Stages" Help topic contained incorrect information.

918042 – Insert operation failed when "DBTransactionLevel = Record" in DB2/400 Database

727688 – Web Service Resource definition problem in WSDL property.

773459 – SAPB1 connection problem at run time when using Environment Variables in Resource.

759696 – Domino Read Mail method did not work if mail form was defined as 'Bookmark'.


Magic is a trademark of Magic Software Enterprises Ltd.

Copyright © Magic Software Enterprises, December 2008


March 2009 1

iBOLT V3 SP2 Release Notes Welcome to iBOLT V3 SP2, which has been designed to deliver an easy-to-use, flexible, and cost-effective business integration solution.

This document highlights the new and enhanced features that have been added to iBOLT V3 SP2. For information about previous iBOLT versions, see the PastReleaseNotes.pdf file provided with this installation.

General Information



iBOLT V3 SP2 Certification For information about the various platforms on which iBOLT V3 SP2 has been certified for operation by Magic Software Enterprises, refer to the iBOLT V3 Certification document.

Migrating from iBOLT V2.5 to iBOLT V3 SP2 iBOLT provides a wizard to easily migrate your project from iBOLT V2.5 to iBOLT V3 SP2. This wizard is available through a shortcut in the iBOLT installation’s Start menu.

Note: We recommend reading the Migration chapter in the iBOLT V3 SP2 Help before migrating your iBOLT V2.5 projects.

Make sure to perform the following actions after the Migration process:



ftp://ftp.magicsoftware.com/iboltproduct/Documents/�

iBOLT V3 SP2 Release Notes March 2009 2


Upgrading from iBOLT V3 SP1 to iBOLT V3 SP2

iBOLT will automatically upgrade a project developed in iBOLT V3 SP1 to iBOLT V3 SP2. Make sure to manually copy your project directory to the new installation’s Projects directory.







• MySQL 5.x

• DB2 UDB 8


New Features

HL7 Converter iBOLT V3 SP2 includes the HL7 converter, which allows you to convert HL7 2.x messages to XML and vice versa.

Sample Projects This release includes a set of sample projects that demonstrate iBOLT features. You can install these projects as part of the iBOLT installation process.

Migration Enhancements • Changes were made in the Migration utility to lower to a minimum the

amount of connections that require remapping.

• The migration process now:

o Handles SQL statements with case differences between the statement in iBOLT and the names of the database fields.

o Adds an execution condition to all Data Mapper mapped destinations to avoid the creation of empty elements if the source element is missing.


o Adds a condition (identical to the compound condition) to the update expression condition in the Data Mapper.

IFS Services in uniPaaS Service IFS Services are now supported in a uniPaaS service (see the Change of Behavior section below for additional details).

Mapper Enhancements • The Connect all option is now available for a single occurrence

compound.

• Deleting a compound connection does not automatically delete all child connections, but gives you the option to map an alternative parent compound.

Change of Behavior The following services were removed from the ifs_services of iBOLT V3 (these refer to services that appear when the Load Server Services check box is selected in iBOLT’s uniPaaS Configuration dialog box):

• AbortFlow

• StoreSavePointData

• RetrieveSavePointData

In addition, the following changes were made to the uniPaaS component’s services:

InvokeFlow Added new parameter: pi. BP ID (1 – first parameter) Removed parameters: pio. User String (6), pio. User Blob (7), pio. User Status Code (8) Use SetParam with the required variable name (C.UserString, for example) before calling the InvokeFlow.

InvokeFlowDelay Added new parameters: pi. BP ID (1), pi. Seconds (6)

ScheduleFlow Added new parameter: pi. BP ID (1)

BAM_Service Size changed: pi. user string (from 260 to 1000)

PSSSubscribe Added new parameter: pi. BP ID (3) Renamed parameter: pi. Flow ID (from: pi. Flow)

PSSRemove Added new parameter: pi. BP ID (2)

PSSSubRemove Added new parameter: pi. BP ID (2)

ODSSave Changed parameters: po. User Data – BLOB (from Binary to ANSI) po. User Data – String (from A32000 to U1000) po. User Data – Logical (from numeric 1 to logical)


ODSSaveStr Changed: pi. User Data – String (from A32000 to U1000)

ODSSaveNum Changed: pi. User Data – Number (from 11.4 to 12.4)

ODSSaveLog Changed: pi. User Data – Logical (from numeric 1 to logical)

ODSSaveBLB Changed: pi. User Data – Blob (from binary to ANSI)

ODSGet Changed parameters: po. User Data – Logical (from numeric 1 to logical) po. User Data – String (from A32000 to U1000)

ODSGetStr Changed: po. User Data – String (from A32000 to U1000)

ODSGetLog Changed: po. User Data – Logical (from numeric 1 to logical)

Known Issues • The Upgrade option of the Installation utility is currently not operational.

You need to install iBOLT V3 SP2 as a separate installation.

• When upgrading from iBOLT V3 to iBOLT V3 SP2, you need to redefine the Password fields in your resources.

• The Scheduler and the Flow Enablement section are not imported in the current build.

• The MaxNumberofThreads property in the Server settings is not saved correctly. You should set it manually by adding [MAGIC_ENV]MaxConcurrentRequests = <the Max number of threads> to the Ifs.ini file.

• The reserved thread to stop the Server is not always available.

• When starting the Debugger from the Flow context menu (debugging one flow), the flow will be executed immediately (AutoStart behavior). When the flow execution is completed once, any triggers that are defined will wait for external events.

• The Debugger hangs when you execute Step or Continue on a breakpoint defined in an Error flow.

• In the Salesforce connector, when using multiple operations of Add/Update/Delete/Upsert, the operation is limited to 200 records in one chunk. If the source data contains more than 200 records, the data has to be split into chunks of 200 records.


• If you run a project with .NET framework support, and you receive the Error in .NET invocation:IFC1.IFC1 Code:2140930047 Set Property: iBOLTFramework.dll location error, you should unregister and then re-register the Iboltinvoker.dll file by using this command:



iBOLT V3 SP2 Fixed Problems 918279 – After migrating and then clicking on the Mapper, the connections to DateTime fields were lost and the following error was displayed: "path not exist/attribute was changed".

785111 – When migrating from iBOLT 2.5 SP10 to iBOLT V3, spaces were added to the element name from the Data Mapper source.

730995 – There were problems importing a flow when the flow name was in Hebrew.

780440 – When migrating a Salesforce component to iBOLT V3 SP1, an object could not be selected, unless a new resource was created.



Copyright © Magic Software Enterprises, March 2009

May 2009 1

iBOLT V3.1 Release Notes Welcome to iBOLT V3.1, which has been designed to deliver an easy-to-use, flexible, and cost-effective business integration solution.

This document highlights the new and enhanced features that have been added to iBOLT V3.1. For information about previous iBOLT versions, see the Past Release Notes.pdf file provided with this installation.

General Information



iBOLT V3.1 Certification For information about the various platforms on which iBOLT V3.1 has been certified for operation by Magic Software Enterprises, refer to the iBOLT V3 Certification document.

Migrating from iBOLT V2.5 to iBOLT V3.1 iBOLT provides a wizard to easily migrate your project from iBOLT V2.5 to iBOLT V3.1. This wizard is available through a shortcut in the iBOLT installation’s Start menu. The Migration utility supports projects that were developed in iBOLT Version 2.5 SP8b or later. If you developed your project in a prior version, you need to upgrade your project's current iBOLT version before you attempt to migrate the project.

Note: We recommend reading the Migration chapter in the iBOLT Help before migrating your iBOLT V2.5 projects.

Make sure to perform the following actions after the migration process:




iBOLT V3.1 Release Notes May 2009 2



Upgrading from iBOLT V3 SP2 to iBOLT V3.1

iBOLT will automatically upgrade a project developed in iBOLT V3 SP2 to iBOLT V3.1. Make sure to manually copy your <Project> sub-directory to the new installation’s projects directory.

Supported Internal Databases iBOLT V3.1 supports the following internal databases:





• MySQL 5.x

• DB2 UDB 8


New Features

Project Packager The new iBOLT Project Packager lets you conveniently and easily bundle all relevant iBOLT project files and additional files used by the project in a .zip compressed file for subsequent extraction to a deployment environment.

LDAP Component The new iBOLT LDAP (Lightweight Directory Access Protocol) connector lets you connect to an LDAP server to store and access attribute-based data in a hierarchical data structure.

Google Calendar Component The Google® Calendar component provides connectivity (using the Method interface) between iBOLT and Google Calendar.


Dynamic Logging for Components Control of the Logging option can now be performed dynamically using an environment variable or expression and also remotely from the iBOLT Monitor.

Resource/Service Repository Enhancements • All mandatory properties are now displayed in bold type.

• A Resource button is now available in the Service Repository. Clicking this button brings you directly to the Resource Repository.

File Management Component Enhancements A new method to create and manipulate folders in the LAN has been added.

Directory Scanner Component Enhancements • The mask field has been expanded to 260 characters.

• Folder selection now supports expressions.

• The Return Filename To parameter was added to several methods.

FTP Component Enhancements • FTP over SSL (FTPS) is now supported.

Salesforce Component Enhancements • Attachments are now supported in replication methods.

• Object fields can now be set with Null values.

Email Component Enhancements • SSL is now supported, enhancing the security of Gmail and similar

POP3/SMTP services.

• Sending HTML MIME type email is now supported.

• Expressions in trigger filters are now supported.

SAPB1 Component • User Defined Tables (UDT) can now be added and updated.

• The SAPB1 trigger table status can now be updated.

SAP A1 Component The new SAP A1 connector supports the SAP All-in-One partner solution with the same interface as the existing SAP R/3 connector.

Notes DB Component Enhancements The Notes DB component now supports the following:

• Attachments


• Querying and updating arrays of Alpha values

• Server APIs

Domino Component Enhancements Server APIs are now supported.

Checker and Mapper Code Generation Optimization The Checker and generate processes have been improved.

Data Mapper Enhancements Null content in XML is now supported.

Model XML Validation The ability to validate against an XML Mapper-built schema when an IFC Model is in the destination is now supported.

iBOLT Internal Database – Stronger Password iBOLT is now installed with a stronger password for the user of its internal database.

File Splitter Component Enhancement The component can now provide a comma-delimited list of the split files.

Change of Behavior

Next Step Evaluation Order Next Step evaluation was changed from Step ID to left-to-right sibling visual order.

Flow Completion Behavior An iBOLT flow now completes only after all parallel branches are finished.

Salesforce Error Handling The iBOLT Salesforce component returns the errors in the Return section of the result XML and not as an iBOLT error, correcting previously inconsistent behavior.

SDK: uniPaaS Component In order to regenerate the uniPaaS component, the user must now explicitly click the Generate button. Clicking the OK button only saves the new definitions in the iBOLT metadata.

Known Issues • When upgrading directly from iBOLT V3.0 to iBOLT V3.1, you need to

redefine the password fields in your resources.


• The MaxNumberofThreads property in the Server settings is not saved correctly. You should set it manually by adding to the ifs.ini file: [MAGIC_ENV] MaxConcurrentRequests = <the Max number of threads>

• The reserved thread to stop the server is not always available.

• When starting the Debugger from the Flow context menu (debugging one flow), the flow will be executed immediately (AutoStart behavior). When the flow execution is completed once, any defined triggers will wait for external events.


• If you run a project with .NET framework support, and you receive the Error in .NET invocation:IFC1.IFC1 Code:2140930047 Set Property: iBOLTFramework.dll location error, you should unregister and then re-register the Iboltinvoker.dll file by using the following command:


• When the checker finds an error in the GoTo condition, the MoveTo operation will jump to the GoTo destination step condition instead of the GoTo condition.

iBOLT V3.1 Fixed Problems 928811 – Update of Data Mapper XML elements with negative numeric values was not possible (they were changed to positive values).

722750 – Using the File2BLB function to read a file to a BLOB worked, but when using the File Management component, the file did not load.

752754 – The installation included an erroneous requester version in the Magic.ini file.

776196 – When using the Data Mapper with a database destination, sending table names in upper case was problematic if the database was case sensitive.

778476 – The iBOLT Monitor kept opening connections to the database and did not close them.

782925 –Defined Compound Level Computations in the Data Mapper service were deleted while creating and deleting a new destination in the Source Destination Management dialog box.

783531 – There was an incorrect XSD for SAP R/3 when trying to work with the ARTMAS05 IDOC.

799487 – The FTP component could not put files in a virtual folder in IIS FTP when the FTP Server (under IIS) had a virtual folder set.

800164 – iBOLT did not set the code page dynamically for sent WebSphere MQ messages.

909177 – Using the IFC Model Destination Append check box in the Data Mapper service resulted in a corrupted XML. When appending data to an existing XML, the new part was created but all the original XML was corrupted.


910388 – During installation, database logical names were not created when selecting to install the database later.

911608 – For the System i Connector, calling the MAGIC400/ADDMULDEC program returned the error Error 713: CPF0006 Errors occurred in command.

911971 – When migrating, the mapping condition was not copied to the update expression in the Compound Level Computation section.

917175 –When an eDeveloper component having an ifs_services Invoke Flow program was migrated, variables such as UserString, UserBlob and UserCode were lost, resulting in the component's logical failure.

918064 – Incorrect error flow behavior occurred when a multi-add operation in SBO generated an error.

919183 – When the connection to the network was lost, the Server / Studio was disconnected from the broker.

919595 – Data mapping of Unicode data from a database source to a flat file destination did not work.

934271 – The Data Mapper wizard failed to add single quotes around flow variables of Alpha type that were used in WHERE clauses.

939979 – While creating a new Version Control project in iBOLT, the following erroneous message was displayed: Project already exists on the server. Try different project name., even though the project did not exist on the server.

941112 – iBOLT used the default numeric 12.4 picture format when mapping, requiring a manual change of the picture setting for each column.

959192 – When trying to create a directory with a Japanese name (Double byte) the customer got question marks for the named directory.

964517 –The List to XML and XML execute methods in the Microsoft Word component did not work.

983502 – In data mapping, the Single Instance filter always returned the first item.

984979 – When the child node had the same name as the parent node, it was not visible on the Mapper screen.

986899 – Select SQL statements having a WHERE clause with more than two AND operators failed to open the Mapper screen.

991371 – The UDSGetField function did not work in the Invoke Flow service.

995331 – When creating an Update on ProductTree, if no data was entered in the TreeCode node of the QueryParam, an error code was generated, but SAP B1 removed all lines from the document except the first.

997173 –The Data Mapper destination template crashed and failed to create the proper result file.

997201 – The Salesforce trigger was not able to retrieve records if multiple records had to be retrieved. The Salesforce trigger generated the error: EXCEEDED_ID_LIMIT: retrieve id limit reached.

June 2009 1

iBOLT V3.1a Release Notes Welcome to iBOLT V3.1a, which has been designed to deliver an easy-to-use, flexible, and cost-effective business integration solution.

This document highlights the new and enhanced features that have been added to iBOLT V3.1a. For information about previous iBOLT versions, see the Past Release Notes.pdf file provided with this installation.

General Information



iBOLT V3.1a Certification For information about the various platforms on which iBOLT V3.1 has been certified for operation by Magic Software Enterprises, refer to the iBOLT V3 Certification document.

Migrating from iBOLT V2.5 to iBOLT V3.1a iBOLT provides a wizard to easily migrate your project from iBOLT V2.5 to iBOLT V3.1a. This wizard is available through a shortcut in the iBOLT installation’s Start menu. The Migration utility supports projects that were developed in iBOLT Version 2.5 SP8b or later. If you developed your project in a prior version, you need to upgrade your project's current iBOLT version before you attempt to migrate the project.






iBOLT V3.1a Release Notes June 2009 2



Upgrading from iBOLT V3.1 to iBOLT V3.1a iBOLT will automatically upgrade a project developed in iBOLT V3.1 to iBOLT V3.1a. Make sure to manually copy your <Project> sub-directory to the new installation’s projects directory.

Supported Internal Databases iBOLT V3.1a supports the following internal databases:





• MySQL 5.x

• DB2 UDB 8


Known Issues • In iBOLT V3, the length of a variable name is 30 characters. However,

since iBOLT adds a prefix to each variable name, such as F_ , C_ or G_, the maximum size of a variable is 28 characters.

• In the migration process from V2.5 to V3, iBOLT trims the length of the project variables to 28 and reports it in the log.

• When upgrading directly from iBOLT V3.0 to iBOLT V3.1a, you need to redefine the password fields in your resources.





• If you run a project with .NET framework support, and you receive the Error in .NET invocation:IFC1.IFC1 Code:2140930047 Set

iBOLT V3.1a Release Notes June 2009 3

Property: iBOLTFramework.dll location error, you should unregister and then re-register the Iboltinvoker.dll file by using the following command:


• When the Checker finds an error in the GoTo condition, the MoveTo operation will jump to the GoTo destination step condition instead of the GoTo condition.

iBOLT V3.1a Fixed Problems 977943 – An UPDATE query with a WHERE clause having a numeric type of flow variable, gave a runtime error and failed to update the table records. The Monitor log showed the "Incorrect syntax near '12.4'" error.

934946 – When an expression to an unmapped node was cleared, it failed to generate the executable file.

714692 – When a project was upgraded to iBOLT V3.1, the "Duplicate index, data source: MConversionConnections" error was given.

973110 – For SAP B1 triggers, if the polling interval was less than 1 minute at runtime, the "SAPB1 Trigger error: 1006 Internal error - No Polling Interval Is Defined" error was given.

989092 – Connection to the Notes server failed when the Domino and Notes DB components were used in the same project to connect to a common server.



Copyright © Magic Software Enterprises, June 2009

August 2009 1

iBOLT V3.1b Release Notes Welcome to iBOLT V3.1b, which has been designed to deliver an easy-to-use, flexible, and cost-effective business integration solution.

This document highlights the new and enhanced features that have been added to iBOLT V3.1b. For information about previous iBOLT versions, see the Past Release Notes.pdf file provided with this installation.

General Information



iBOLT V3.1b Certification For information about the various platforms on which iBOLT V3.1 has been certified for operation by Magic Software Enterprises, refer to the iBOLT V3 Certification document.

Migrating from iBOLT V2.5 to iBOLT V3.1b iBOLT provides a wizard to easily migrate your project from iBOLT V2.5 to iBOLT V3.1b. This wizard is available through a shortcut in the iBOLT installation’s Start menu. The Migration utility supports projects that were developed in iBOLT Version 2.5 SP8b or later. If you developed your project in a prior version, you need to upgrade your project's current iBOLT version before you attempt to migrate the project.






iBOLT V3.1b Release Notes August 2009 2


3. Due to changes in schema locations, the following components require reconfiguration (click the Configuration button): SAP Business One, SAP R/3, Salesforce, JD Edwards, and Notes DB. Click OK to save changes.

Upgrading from iBOLT V3.1a to iBOLT V3.1b

iBOLT will automatically upgrade a project developed in iBOLT V3.1a to iBOLT V3.1b. Make sure to manually copy your <Project> sub-directory to the new installation’s projects directory.

Supported Internal Databases iBOLT V3.1b supports the following internal databases:





• MySQL 5.x

• DB2 UDB 8


New Features and Changes

.NET Service enhancements • The .NET Service has a new option to run the Configuration method

of the .NET class.

• It is now possible to define custom error codes for the .NET Service in the iBOLT Errors repository. These error codes can be set in the .NET class and handled in iBOLT.

• .NET SDK components from iBOLT V2.5 will be automatically migrated to a .NET Service.

• The .NET Service can run and configure existing iBOLT .NET code. For more information, see the iBOLT Help.

Salesforce enhancements The QueryAll operation was added to the Operations list. This new operation also returns the deleted objects in the query result.


HL7 License The HL7 feature is only available with a special license.

Known Issues • Working with the SAP Business One component together with the

Domino component on a local server, may cause problems. It is recommended to work on a network to avoid these problems.

• In iBOLT V3, the length of a variable name is 30 characters. However, since iBOLT adds a prefix to each variable name, such as F., C. or G., the maximum size of a variable is 28 characters.

• When upgrading directly from iBOLT V3.1a to iBOLT V3.1b, you need to redefine the password fields in your resources.

• The MaxNumberofThreads property in the Server settings is not saved correctly. You should set it manually by adding the following to the ifs.ini file: [MAGIC_ENV] MaxConcurrentRequests = <the Max number of threads>






• When the Checker finds an error in the GoTo condition, the MoveTo operation will jump to the GoTo destination step condition instead of the GoTo condition.


iBOLT V3.1b Fixed Problems 978068 – There was an incorrect result when using multiple repeat sections in the Data Mapper template destination.

929075 – The iBOLT Data Mapper wizard did not recognize the Sybase database when connecting with ODBC.

762977 – The SAPB1 2007 component was unable to work with MSSQL 2008.



Copyright © Magic Software Enterprises, August 2009

September 2009 1

iBOLT V3.1 SP1 Release Notes

Welcome to iBOLT V3.1 SP1, which has been designed to deliver an easy-to-use, flexible, and cost-effective business integration solution.

This document highlights the new and enhanced features that have been added to iBOLT V3.1 SP1. For information about previous iBOLT versions, see the Past Release Notes.pdf file provided with this installation.

General Information



iBOLT V3.1 SP1 Compatibility For information about the various platforms with which iBOLT V3.1 SP1 is compatible, refer to the iBOLT V3 Compatibility Guide.

This document replaces the previous version’s Certification document.

Migrating from iBOLT V2.5 to iBOLT V3.1 SP1

iBOLT provides a wizard to easily migrate your project from iBOLT V2.5 to iBOLT V3.1 SP1. This wizard is available through a shortcut in the iBOLT installation’s Start menu. The Migration utility supports projects that were developed in iBOLT Version 2.5 SP8b or later. If you developed your project in a prior version, you need to upgrade your project's current iBOLT version before you attempt to migrate the project.



iBOLT V3.1 SP1 Release Notes September 2009 2





Upgrading from iBOLT V3.1b to iBOLT V3.1 SP1

iBOLT will automatically upgrade a project developed in iBOLT V3.1b to iBOLT V3.1 SP1. Make sure to manually copy your <Project> sub-directory to the new installation’s projects directory.

In V3 SP1, the System i, COM, Java Class, EJB, JMS, W4 and SAP components appeared in the Lite Version, even though they were not supported. Beginning with iBOLT V3.1, these components were no longer displayed. In iBOLT V3.1 SP1, if you upgrade a Lite Version project that contains one of these components, the components will be replaced with an NOP service.

Supported Internal Databases iBOLT V3.1 SP1 supports the following internal databases:



• Oracle 11 (OCI 32-bit only)



• MySQL 5.x

• DB2 UDB 8



since iBOLT adds a prefix to each variable name, such as F., C. or G., the maximum size of a variable is 28 characters.



• When upgrading directly from iBOLT V3.1b to iBOLT V3.1 SP1, you need to redefine the password fields in your resources.







New Features

Google Docs Component iBOLT V3.1 SP1 includes the Google Docs™ component, which provides connectivity between iBOLT and Google Docs.

XML Handling Component iBOLT V3.1 SP1 includes the XML Handling component, which allows you to work with either an XML file or the XML data that is contained within a Blob variable, and to apply different XML functions to these files or data.

Debugger Enhancements The Debugger interface was redesigned. Contexts are now represented in a hierarchal structure and there is a visual indication of the context currently in Debug mode. Icons were added to indicate the invocation reason and to distinguish between parallel and linear contexts.

Mapper: Create Empty Nodes The XML and IFC Model destination now have a new check box named Always Create Nodes. Until now, the behavior was to always create the Destination node unless the node condition evaluated to False. In iBOLT V3.1 SP1, you can decide not to create a destination node if the Alpha expression is evaluated to an empty string or Null.

SDK: Trigger Component iBOLT now lets you set a non-polling Trigger component in the SDK.


Allow the Dynamic Creation of a Gateway Log The new iBOLT function, Logging (Start/Stop, ‘Filter’), lets you dynamically start and stop filtering options.

Search Options in iBOLT Studio iBOLT now lets you search for business processes, flows, steps in a flow, variables, and nodes in the Data Mapper (for both source and destination)

A Separate Server Error for Each Project The GeneralErrorLog entry was moved from the magic.ini file to the ifs.ini file and each project’s ifs.ini file holds the name of the project in the log.

Creating a Variable in Trigger Configuration You can now open the Variable repository while in trigger configuration.

Packager Enhancements An Extract button was added to Project Packager, which lets you extract the package into the iBOLT installation folder.

iBOLT Monitor Enhancements In the Monitor, you can now easily filter the messages that you want to display. You can decide to display all of the messages or only the error messages or component logging messages.

In addition, the Range from the FSID filter was replaced with a single FSID field.

SDK: Java Component Error Handling For Java errors, you can now map errors thrown from the Java class to errors defined for the Java component in the iBOLT SDK dialog box’s Java Exception Message column.

Build/Debugger Enhancement A View Errors button was added to the error messages that appear when the Checker finds errors when starting the Debugger or building a project. You can click the View Errors button to open the Checker Results dialog box.

Domino Component Enhancement • The Read Mail method has the new IncludeBody parameter, which

will specify whether the body of the mail will be included in the output.

• The Read Calendar Entries method now includes the List Type parameter, where you can decide if the list will be of Entries, Notices, or both, and the Notice Type parameter.

• The new Update Notice method will be used to accept conference/meeting invitations and send an acceptance mail to the chairperson or originator of the conference.


Email Component: Additional Attributes Email messages read by iBOLT will now return additional metadata attributes in the result XML. For each attachment, iBOLT now has the date/time, content language, content type and attachment size.

iBOLT on Oracle 11 iBOLT now supports Oracle 11 as an internal database and as a resource.

Microsoft Dynamics CRM The new iBOLT Dynamics CRM connector lets you work with the Microsoft® Dynamics™ CRM application.

Google Calendar Component: All Day Event Support The Google Calendar component now lets you determine if you want a calendar event to last all day.

Studio Usability Enhancements The Build icon was added to the Studio toolbar.

SAP B1 8.8 The iBOLT SAP B1 2007 component now works with SAP B1 8.8.

WebSphere MQ 7.0 iBOLT now supports the IBM WebSphere® MQ 7.0 client/server.

Salesforce Connector: Reference Using External ID The new iBOLT Salesforce connector function, setRefbyExternalId, lets you reference an object by its external ID instead of by the object ID itself.

WMQ Trigger Enhancement • The returned XML from the trigger now also provides additional

information, including the message ID, correlation ID, and sequence number.

• In the trigger configurations, you can now set the CorrelationID or Group ID for the Get filter.

New Context Variable iBOLT V3.1 SP1 includes the new C.sys.InvokingBPName context variable, which is the business process where the last error occurred or the Invoke Flow was called.

Change in Behavior In the Direct Access Method dialog box, when you open the Variable list for an Out parameter, you can no longer select system variables, such as C.sys.ErrorCode. This change was made, because the system variables


are updated by the iBOLT Server and not by the user. In the Flow Data service, you can still update these variables.

For Directory Scanner steps, you have to manually change the expression to check if it is NULL instead of an empty string. This is due to a change in behavior. Up until V3.1 SP1, when there was no file to process, the step returned an empty string. In V3.1 SP1, the step returns NULL.

iBOLT V3.1 SP1 Fixed Problems 709691 – Debugger: Setting a numeric value according to a picture resulted in an Illegal Variable error message.

724340 – Studio: When creating several applications in the Topology without clicking OK in between, only the last selected icon was shown.

730786 – Studio: When copying a step (with a condition), to a new flow, the condition was not completely deleted. As a result, the step failed at runtime.

735697 – Data Mapper: When executing a Database source, the Data Mapper returned the error: “Error 9805: No value given for one or more required parameters." and failed to create the required file.

779516 – Directory Scanner Trigger: For any trigger action, the "Returned source file name" was always empty when no variable was set in the "Return destination file name to:" property.

783064 – Migration: User-defined components were not migrated. No methods or parameters were shown when the configuration screen was opened.

783188 – The Server started even when the %currentproject% logical name pointed to a file other than the ibp file.

910759 – The XMLs that iBOLT generated for the Salesforce connector were not valid.

930457 – The iBOLT Editor crashed while building projects, in a specific scenario.

935019 – Scroll bars were not working in flows. It kept jumping to the beginning of the flow.

978068 – Data Mapper: An incorrect result was received when mapping to a template containing multiple repeats.

980608 – When using a WSDL with more than 99 operations, the operation’s number appeared as **, in the Web Services Client Resource’s Security tab.

991617 – When migrating V2.5 projects to V3.1, only one out of two eDeveloper components were migrated.

994222 – Data Mapper: When selecting the HL7 component as an IFC Model and clicking the Map button, the following was displayed: 'f:\iBOLT3sp2\ifclib\hl7\xsd\hl7ifc.xsd'

995534 – When using an Upsert function in a Salesforce component, NULL values were not processed.


997326 – The Mapper screen failed to open and the “Information cannot be retrieved....." DB error appeared, when a flow variable was used in a WHERE clause.

999072 – SDK: A "Run-time error'0'" error occurred when a user tried to drag the method inside the component and the component group was “User Components”.



Copyright © Magic Software Enterprises, September 2009

October 2009 1

iBOLT V3.1 SP1a Release Notes

Welcome to iBOLT V3.1 SP1a, which has been designed to deliver an easy-to-use, flexible, and cost-effective business integration solution.

This document highlights the new and enhanced features that have been added to iBOLT V3.1 SP1a. For information about previous iBOLT versions, see the Past Release Notes.pdf file provided with this installation.

General Information



iBOLT V3.1 SP1a Compatibility For information about the various platforms with which iBOLT V3.1 SP1a is compatible, refer to the iBOLT V3 Compatibility Guide.


Migrating from iBOLT V2.5 to iBOLT V3.1 SP1a

iBOLT provides a wizard to easily migrate your project from iBOLT V2.5 to iBOLT V3.1 SP1a. This wizard is available through a shortcut in the iBOLT installation’s Start menu. The Migration utility supports projects that were developed in iBOLT Version 2.5 SP8b or later. If you developed your project in a prior version, you need to upgrade your project's current iBOLT version before you attempt to migrate the project.



iBOLT V3.1 SP1a Release Notes October 2009 2





Upgrading from iBOLT V3.1 SP1 to iBOLT V3.1 SP1a

iBOLT will automatically upgrade a project developed in iBOLT V3.1 SP1 to iBOLT V3.1 SP1a. Make sure to manually copy your <Project> sub-directory to the new installation’s projects directory.

In V3 SP1, the System i, COM, Java Class, EJB, JMS, W4 and SAP components appeared in the Lite Version, even though they were not supported. Beginning with iBOLT V3.1, these components were no longer displayed. In iBOLT V3.1 SP1, if you upgrade a Lite Version project that contains one of these components, the components will be replaced with an NOP service.

Supported Internal Databases iBOLT V3.1 SP1a supports the following internal databases:






• MySQL 5.x

• DB2 UDB 8



since iBOLT adds a prefix to each variable name, such as F., C. or G., the maximum size of a variable is 28 characters.


iBOLT V3.1 SP1a Release Notes October 2009 3

• When upgrading directly from iBOLT V3.1 SP1 to iBOLT V3.1 SP1a, you need to redefine the password fields in your resources.







iBOLT V3.1 SP1a Fixed Problems 245710 – When migrating to iBOLT 3.1SP1, if a called flow had an Abort Flow step in it, and in the calling flow there was as 23-abort flow error, the calling flow was not aborted.

315804 – iBOLT generated schemas from SAP A1 with forward slash (/) characters, which are invalid.

590768 – When trying to upsert more than 200 records in a Salesforce connector, an error was returned.

724187 – iBOLT 3.1 SP1 crashed after running for a while, in a certain scenario.

732901 – The ibolt_trigger table’s handle status became 1 instead of 0.

912436 – In the Directory Scanner step’s LAN to LAN method, the 'Return File To' parameter did not return the file contents into variables.

987321 – When the database source had a Numeric column with a picture greater than 18, the Checker gave a “Picture len >18 " error, irrespective of the destination picture /type.



Copyright © Magic Software Enterprises, October 2009

January 2010 1

iBOLT V3.2 Release Notes

Welcome to iBOLT V3.2, which has been designed to deliver an easy-to-use, flexible, and cost-effective business integration solution.

This document highlights the new and enhanced features that have been added to iBOLT V3.2. For information about previous iBOLT versions, see the Past Release Notes.pdf file provided with this installation.

General Information



iBOLT V3.2 Compatibility For information about the various platforms with which iBOLT V3.2 is compatible, refer to the TTTiBOLT V3 Compatibility Guide.


Migrating from iBOLT V2.5 to iBOLT V3.2 iBOLT provides a wizard to easily migrate your project from iBOLT V2.5 to iBOLT V3.2. This wizard is available through a shortcut in the iBOLT installation’s Start menu. The Migration utility supports projects that were developed in iBOLT Version 2.5 SP8b or later. If you developed your project in a prior version, you need to upgrade your project's current iBOLT version before you attempt to migrate the project.

Note: We recommend reading the Migration chapter in the iBOLT Help before migrating your iBOLT V2.5 projects. We have updated the Preparing Your Project for Migration topic with additional and important information.


iBOLT V3.2 Release Notes January 2010 2





Upgrading from iBOLT V3.1 SP1a to iBOLT V3.2

iBOLT will automatically upgrade a project developed in iBOLT V3.1 SP1a to iBOLT V3.2. Make sure to manually copy your <Project> sub-directory to the new installation’s projects directory.

Supported Internal Databases iBOLT V3.2 supports the following internal databases:







• MySQL 5.x

• DB2 UDB 8


Known Issues • In some iBOLT installations on Windows 2008, the iBOLT services do not

stop properly.




• When upgrading directly from iBOLT V3.1 SP1a to iBOLT V3.2, you need to redefine the password fields in your resources.




• If you run a project with .NET framework support, and you receive the Error in .NET invocation:IFC1.IFC1 Code:2140930047 Set Property: iBOLTFramework.dll location error, you should unregister and then re-register the Iboltinvoker.dll file by using the following command: ‘RegAsm iboltinvoker.dll /tlb:iboltinvoker.tlb’

• The Dynamics CRM connector does not permit switching between users, even if there are two resources with identical parameters except for the user name. The first authenticated user is the one used for the entire server run.

New Features

Exchange 2007 Connector iBOLT V3.2 contains the Exchange 2007 connector, which enables an iBOLT project to interact with the Microsoft® Exchange Server's Contacts and Mail.

TCP Listener Component iBOLT V3.2 includes the TCP Listener component, which enables iBOLT to listen continuously for requests made by a TCP client on a TCP port.

System i Trigger iBOLT V3.2 lets you use the System i connector as a Trigger.

Salesforce Connector Enhancements The Salesforce connector now includes a new Get Timestamp method. Also, additional parameters were added to the Replicate Last Deletes and Replicate Last Updates methods.

Directory Scanner Enhancements The Directory Scanner component now allows you to export log files to formats such as CSV and XML, to enable easier auditing.

The Directory Scanner now supports environment variables for the Mask, Filter, Exclude, File Size, and Polling Interval parameters.


In addition, the Directory Scanner component now lets you work with the TimeStamp filter in the Trigger and method configurations.

WebSphere MQ Enhancements New methods were added to the WebSphere MQ component to support RFH2 header functionality.

Large messages can now be saved directly to a specified file in the Trigger and method configurations, and can now be sent from a source file.

SDK: Component Refresh If you make changes to a component that you created in the Component SDK, you can now refresh and update all steps, simultaneously, that use that particular component.

Data Mapper Enhancements iBOLT now supports XS:Any in the Data Mapper’s destination.

The Data Mapper’s mapping screen now allows you to add a colored background to a specific node, and displays information about the node in a dedicated pane.

The Data Mapper can now work with dynamic SQL statements when you select Database as a destination. These statements are then used “as is”.

In addition, you can now instruct the database to commit each SQL statement automatically (Auto Commit). This can improve performance if you want to connect to a remote database and perform a record level transaction.

Invoke Flow by Expression New fields were added to the Invoke Flow Service that allow you to call a flow by expressions that are evaluated at runtime. The GetBPID and GetFlowID functions were added to iBOLT’s Functions List. These new functions enable you to retrieve a flow or business process ID by name.

Single Database Server Definition The iBOLT installation now has a single database host field for local and remote servers.

Domino Enhancements The Domino component’s XSD has a new node named Form. This gives additional functionality to the Read Mail method, such as permitting the retrieval of emails returned due to errors.

Installation Enhancements You can now control the installation of Systinet when installing iBOLT.


Google Docs Component Method Removed The Remove User Access method has been removed from the Google Docs component. The same functionality can be achieved by using the Set Item Access Control method.

Web Monitor Availability The Web Monitor no longer requires a license.

Studio Enhancements An IFS Settings screen has been added to the iBOLT Studio. This enables you to configure selected ifs.ini (Server) flags directly through the iBOLT Studio and the iBOLT Monitor.

A Print button now appears on the Cross Reference, Checker, and Text Search results screens.

Additional icons have been added to the flow navigation tree, to the Data Mapper, and to the flow indication pane.

A new field, called Project data encoding, has been added to the New Project dialog box.

Resource/Service Import Functionality You can now import individual resources and services that you previously created and saved.

SAP R/3 Additional Node Documentation Additional documentation for the SAP R/3 RFC simple and compound nodes can be seen in the Node Properties dialog box's Additional XML Properties tab.

Schema Connection Error Log Enhancements The Schema Connection Error Log now displays more in depth information about Data Mapper connections that are about to be deleted.

iBOLT V3.2 Fixed Problems 513349 – Changing the editor using the Tools > Class Types menu did not take effect. When trying to change the .NET editor from devenv.exe to vcsexpress.exe, iBOLT tried to load the original editor (devenv.exe).

702399 – When using the Excel component’s Cell method, and setting the Action parameter with the Get Value, Get Formula, or Get Active Row Column options, a duplicate Cell method using the same parameters was created.

706263 – The System i connector’s Help page showed incorrect information for the Run Query method’s Query Name and Query File parameters.


719647 – If the SAPB1 Trigger’s polling interval was less than 1 minute (expressed in seconds) at runtime, the SAPB1 Trigger error 1006 Internal error - No Polling Interval Is Defined was generated.

725572 – The Data Mapper did not support the BLOB LOGGED NOT COMPACT database type.

726618 – In the HTTP Trigger’s configuration screen, the Validation expression parameter gave an Illegal variable error when flow or context variables were used in the Expression Editor.

727825 – When using the Microsoft Visual SourceSafe (VSS) version control, deleting a flow also deleted the main flow, and the flow’s sequence order was not correct.

728661 – The Data Mapper’s XML Source’s Single Instance Filter worked only when a legal parent (compound/complex) node was connected with the Destination’s compound node.

728713 – It was not possible to define a Web service as a consumer when the response returned a header.

728775 – When using the Data Mapper, an error occurred when trying to insert data into a table whose name contained a @ character.

776581 – The Data Mapper did not support SQL statements where one of the field/column names or a table name was a reserved word such as 'Order'.

779954 – When working with SAP R/3, selecting an IDoc extension in the Trigger caused an error if the Trigger was configured to receive a WBBDLD IDoc with an extension.

781709 – The Directory Scanner Trigger returned an error message if iBOLT tried to select a locked file.

783738 – When using the Microsoft Visual SourceSafe (VSS) version control, Data Mapper Source nodes were not available at the Destination after selecting the Print Preview or Project Latest Version options.

785662 – During migration, if a Data Mapper was configured with a positional flat file as a Source, the Format value trimmed the data contained within it. This did not happen in iBOLT V2.

787197 – After migration to iBOLT V3, the iBOLT Studio crashed when trying to open the Data Mapper with the Map button.

794520 – When running certain projects, iBOLT did not create values in the XML Destination when usingthe Data Mapper’s XML Position Forwarding property.

913377 – When defining a Web service as a consumer, while accessing WSDL, a ERROR >> javax.xml.rpc.soap.SOAPFaultException: Server was unable to process request error was given.

913638 – Connected Data Mapper nodes did not appear in the Expression Editor.

915776 – When using the Migration utility’s Upper/Lowercase conversion action, iBOLT converted the entire SQL statement, including variables, to upper case characters.


916188 – The WebSphere MQ component was unable to pass a message of 90M to WebSphere MQ.

929912 – Projects crashed when a Data Mapper contained a Source and an UPDATE Destination in the same Data Mapper on an Oracle database.

931168 – The DB operations’s Update option in the Data Mapper did not work. This occurred only when none of the updated fields were mapped.

931813 –When using the FTP component’s Directory Listing method, the Output XML field's value should be set to No (default) after migration.

934113 – Third level complex references could not be loaded.

934387 – When using the Microsoft Visual SourceSafe (VSS) version control, a Source node at a Destination was not available when the respective flows and business processes were checked out.

934521 – When using the Data Mapper, Expression Editor text was overwritten.

938596 – When using the Microsoft Visual SourceSafe (VSS) version control, the flow sequence was mixed up when a new flow was inserted.

939233 – When using the Data Mapper with a MySQL database, the SQL_WLONGVARCHAR data type was not supported.

940646 – During the migration process, an Email component that was configured with the Quick Receive method, or was configured with the XML interface, lost the mapping connections from some nodes.

971178 – Systinet Web Services framework (SSJ) was not installed during the iBOLT installation if the JAVA_HOME environment variable pointed to any non-Java path.

973488 – When using the SAPB1 connector, if NodesAsProperties was selected as the XML export type, the query result file that was generated was incomplete.

982025 – iBOLT did not abort the flow if there was a SAPB1 error.

982789 – When using the SAPB1 dynamic resource, iBOLT used the first connection defined in the Resource Repository when keeping the connection open.

986401 – The resulting XML in the Data Mapper’s XML Destination contained an illegal extra namespace definition: 'xmlns:=""'.

996960 – After migration, when executing a project containing an Excel component configured with a Cell method set to the GetLastRowColumn, Get Value, or GetActiveRowColumn parameters, a blank value was returned.

998499 – The resulting XML in the Data Mapper’s XML Destination Mapper was invalid because it contained an additional namespace tag.

999610 – When using the Microsoft Visual SourceSafe (VSS) version control, an Index out of bound error occurred when a new business process was inserted.

801443 – The SAPB1 connector failed to update non-English data.

916642 – When using the Data Mapper, the Source node path could not be seen in the connected Destination node’s calculated value expression.

April 2010 1

iBOLT V3.2 SP1 Release Notes

Welcome to iBOLT V3.2 SP1, which has been designed to deliver an easy-to-use, flexible, and cost-effective business integration solution.

This document highlights the new and enhanced features that have been added to iBOLT V3.2 SP1. For information about previous iBOLT versions, see the Past Release Notes.pdf file provided with this installation.

General Information

Installing iBOLT You can find information about installing iBOLT in the iBOLT

. The guide also contains information about the prerequisites for using iBOLT flow components.

Installation Guide.pdf


iBOLT V3.2 SP1 Compatibility For information about the various platforms with which iBOLT V3.2 SP1 is compatible, refer to the iBOLT . V3 Compatibility Guide


Migrating from iBOLT V2.5 to iBOLT V3.2 SP1

iBOLT provides a wizard to easily migrate your project from iBOLT V2.5 to iBOLT V3.2 SP1. This wizard is available through a shortcut in the iBOLT installation’s Start menu. The Migration utility supports projects that were developed in iBOLT Version 2.5 SP8b or later. If you developed your project in a prior version, you need to upgrade your project's current iBOLT version before you attempt to migrate the project.

Note: We recommend reading the Migration chapter in the iBOLT Help before migrating your iBOLT V2.5 projects. We have updated the Preparing Your Project for Migration topic with additional and important information.


iBOLT V3.2 SP1 Release Notes April 2010 2

As a general guideline, we recommend that you examine the Migration log and fix any issues that arise in your iBOLT V2.5 project. You should then run the Migration utility again until all issues are resolved.

Due to changes in schema locations, the following components require reconfiguration (click the Configuration button): SAP Business One, SAP R/3, Salesforce, JD Edwards, and Notes DB. Click OK to save changes.

Upgrading from iBOLT V3.2 to iBOLT V3.2 SP1

iBOLT will automatically upgrade a project developed in iBOLT V3.2 to iBOLT V3.2 SP1. Make sure to manually copy your <Project> sub-directory to the new installation’s projects directory.

Supported Internal Databases iBOLT V3.2 SP1 supports the following internal databases:







• MySQL 5.x

• DB2 UDB 8

• DB2/400 OS/400 V5R4 and V6R1

Behavior Change • The Max no. of threads field has been removed from the iBOLT

Server Settings dialog box’s Miscellaneous section. You should either set the required threads value in the Assigned License Threads property (under Project > IFS Settings), or directly in the project’s ifs.ini file using:

[MAGIC_ENV]MaxConcurrentRequests = <the Max number of threads>

• The Migration utility performs the mapping operations automatically for all Data Mapper steps and XML interface components.


Known Issues • In some iBOLT installations on Windows 2008, the iBOLT services do not

stop properly.



• When upgrading directly from iBOLT V3.1 SP1a, you need to redefine the password fields in your resources.





• The Dynamics CRM connector does not permit switching between users, even if there are two resources with identical parameters except for the user name. The first authenticated user is the one used for the entire server run.

• The SharePoint component supports primitive data types only.

New Features

SharePoint Component iBOLT V3.2 SP1 contains the SharePoint component, which enables an iBOLT project to interact with the Microsoft® SharePoint® application. The component allows the following operations to be performed on lists: Query, Create, Update and Delete. The ability to execute queries for the latest changes to lists is also supported.

Salesforce Connector

Bulk API Support iBOLT’s Salesforce connector now supports Salesforce.com’s Bulk API. New operations (Bulk Create, Bulk Update, and Bulk Upsert) have been added to the connector’s XML interface. New methods (Bulk Abort Job, Bulk Check Job State, and Bulk Retrieve Job Results) have been added to the connector’s method interface.


Metadata API Support The Salesforce connector also supports Salesforce.com’s Metadata API. New methods (Metadata CRUD, Metadata Check State, Metadata Deploy, and Metadata Retrieve) have been added to the connector’s method interface.

Endpoint Property in Resource Definitions The Salesforce API endpoint can now be set in the Salesforce resource definitions.

Synchronous Trigger Option The Salesforce connector trigger’s new Synchronous check box lets you synchronize the retrieval of trigger lines and determine their invocation order.

Dynamic Query Filter Using SOQL A new field has been added to object XSDs that are generated by the Salesforce connector. This field allows you to perform advanced queries using WHERE SOQL statements.

Significant Performance Improvements As a result of changes to the WS stack used, the Salesforce connector shows significant performance improvements.

Salesforce API version upgrade The Salesforce connector now supports API 18 and above.

Query Results Split To facilitate the handling of very large query results, it is now possible to split the result into several XML files so they can be processed individually.

HL7 Component Communication Enhancements iBOLT’s HL7 component now contains an additional communication layer. The component can now be used as a trigger, and the new Send HL7 Message method allows you to send HL7 messages to an HL7 server.

SAPB1 Component Enhancements The locking limitation that prevented more than one SAPB1 step running at any given time has now been removed.

Data Mapper Enhancements A Header Line check box was added to the Flat File Destination properties dialog box. This allows you to create a flat file whose header is constructed from your selected delimiter field names.

When using the Data Mapper’s IFC Model Destination, the Always Create Nodes check box is now unchecked by default.


WMQ Component Additional Parameters The Disconnect On Close parameter was added to the WMQ component’s Advanced Quick Get and Advanced Quick Send methods.

System i Trigger Enhancements A new parameter, Key length, has been added to the System i Trigger Configuration dialog box.

JD Edwards Connector Enhancements It is now possible to use a keyword [IBSPACE] to pass a space value to a function when working with the JD Edwards connector.

JMS Component Error Reporting Enhancements The full error (stack trace) is now available in the logs/java/stderr.log.

Migration Enhancements The Migration utility was enhanced to perform mapping operations automatically during the migration process. Any issues resulting from these operations are now available in the migration log.

The Checker now reports an error for all Data Mapper steps or components with an XML interface that require attention after the migration.

iBOLT V3.2 SP1 Fixed Problems 919374 – Special characters were not supported in migrated database resource names.

772447 – Alpha, Time, and Date variables were not surrounded by single quotes in the Data Mapper.

972356 – The schema path of the calling flow's Data Mapper step was not visible when using XML position forwarding.

798816 – It was not possible to concatenate data in the Data Mapper to variables if you wrote <user variable> & <source node>. However, it was possible if you wrote <source node> & <user variable>.

917534 – A calculated value on a relocated node in the Data Mapper could not be changed.

996170 – When using the Data Mapper, iBOLT hung when a nested IF function was used with a complex expression on a node level computation.

719325 – The Directory Scanner’s Return Destination file name contained trailing spaces.

708424 – When the Server Certification Validation field was set to No, the FTP component always tried to validate the server certificate. It gave the following error: Connection to requested FTP server could not be established.

588929 – When using the TCP Listener component, data was processed after the carriage return and not after the data transfer was finished.


916831 – The MSSQL 2008 option was not available in the installation wizard.

929229 – When using the Email component, the wrong default port was used for IMAP.

993605 – In the Component SDK, changing the order of arguments was not handled properly.

995862 - When using the Microsoft Excel component’s Cell method with the Get Value, Get Formula, or GetActiveRowColumn options selected in the Action parameter, and you tried to create a new Cell method with the same parameter, iBOLT copied the previous method with the Value parameter’s direction as In instead of Out.

753710 – The Monitor’s Days to log property was misnamed. It only governed the display and not the actual logging.

785469 – When working with the ODBC MySQL database and the Data Mapper, data was rounded for the FLOAT and DOUBLE data types.

984057 – When the Email trigger was used with an IMAP server, the status of mail that had already been read was changed to Unread.

728599 – When installing iBOLT on a 64-bit machine, the correct 64-bit requester was not installed.



Copyright © Magic Software Enterprises, April 2010

iBOLT Past Release Notes - Data Integration and...

Documents

Transcript of iBOLT Past Release Notes - Data Integration and...