See information about the latest product version
How do I program message flows?
New users: Use the links in this topic to get information about the concepts and tasks associated with programming message flows.
How do I use message mappings?
- How do I create a message map file? Follow this link for instructions on how to create a message map in the Broker Application Development perspective. You can also create a message map from the Mapping node .
- What does the Graphical Data Mapping editor look like? You create and modify message mappings in the Graphical Data Mapping editor. Use this link to discover information about the Graphical Data Mapping editor.
- How do I configure a message map? When you configure message mappings, you can drag content from a source to a target. The source can be a message, a database, or both, and the target can be messages, database tables, or both. If your target is a database, you can select the database operation (insert, update, or delete) that you want to perform on the table. You can set the value for your target to be a constant, or you can use a function or expression to produce the value. Additionally, you can configure conditional mappings to set different values for targets based on the content of the sources, and to handle repeating elements in sources and targets. Follow this link to discover more about message mappings.
- Message mapping syntax
When you use an expression
to set the value of a target in a message map, the expression must
be in XPath format.
- What syntax is used in mapping nodes? Use this link to discover more about the XPath syntax used in message maps.
- Which functions can I use in my message maps? Use this link to discover more about the type of functions that you can use in your message maps.
- How can I find out more about XPath query syntax? To discover more about XPath, follow this link to the W3C recommended XPath 1.0 query syntax reference document. This link works only if you have an active internet connection.
How do I use ESQL?
Extended Structured Query Language (ESQL) is a programming language based on Structured Query Language (SQL), which is commonly used with relational databases such as DB2®. ESQL extends the constructs of the SQL language to provide support for you to work with both message and database content. ESQL can be used with the Compute, Database, and Filter nodes.
Many of the WebSphere® Message Broker Samples show how to use ESQL in message flows.
You can view information about samples only when you use the information center that is integrated with the WebSphere Message Broker Toolkit or the online information center. You can run samples only when you use the information center that is integrated with the WebSphere Message Broker Toolkit.
- How do I create an ESQL file? The ESQL code for each of your nodes is contained within a module in an ESQL file. Use this topic to discover how to create an empty ESQL file in your Message Broker project. Alternatively, you can select Open ESQL to create an ESQL file when you configure the first node in a message flow that uses ESQL. This action creates an ESQL file with skeleton ESQL code for a module associated with the selected node. You can also select an ESQL module for a node from a different Message Broker project by creating a project reference; see Adding and removing library references.
- What is the ESQL editor? You can create and modify your ESQL code in the ESQL editor. You can change the way that code is displayed in the ESQL editor, and modify the way in which the ESQL editor validates code, by changing your ESQL preferences.
- How do I create ESQL for a node? Follow this link to get an overview of how to create ESQL for your node, including more information about the differences between the skeleton ESQL code generated for the modules associated with the Compute, Database, and Filter nodes.
- How do I modify ESQL for a node? Follow this link to discover how to modify the skeleton ESQL module code.
- How do I save an ESQL file? Discover how to save your ESQL file.
- How do I write ESQL code? Follow this link to get introductory information about writing ESQL code for your message flows. Discover how to manipulate the message tree, transform data, access databases, and work with messages from different message domains using ESQL.
- ESQL language
Use the following the links to get concept and reference information about the ESQL language:
How do I use Java?
You can create a Java™ class file for a JavaCompute node and code Java functions to tailor the behavior of the node. You can add any valid Java code to your JavaCompute nodes and use the Java user-defined node API to process messages. You manage Java files through the Java perspective.
- JavaCompute Node
You can view information about samples only when you use the information center that is integrated with the WebSphere Message Broker Toolkit or the online information center. You can run samples only when you use the information center that is integrated with the WebSphere Message Broker Toolkit.
- How do I use a JavaCompute node? You can use the JavaCompute node to examine the content of an input message, transform a message, and build new messages. Follow this link to discover how to use and configure the JavaCompute node in your message flows.
- How do I create Java code for a JavaCompute node? Discover how to create a Java class file using the JavaCompute node wizard. The JavaCompute node wizard creates a Java class with skeleton Java code that is based on the options that you select in the wizard. You can then modify the skeleton code to perform your own processing.
- How do I open an existing Java file? You can modify existing Java code that you have created in a Java Project.
- How do I save a Java file? Discover how to save your Java file.
- How do I write Java for message flows? Get introductory information about writing Java code for your message flows, including how to manipulate the message tree, access databases, handle errors, and access broker properties.
- What views and editors
do I use when programming Java?
Get a list of concept, task, and reference topics that relate to editors and views for working with Java.
- Where can I get assistance
when programming Java?
You can use code assist to provide a list of available command completions that you can select to insert into the editor. You can also use command assist to access Javadoc information about code in the Java editor.
- How do I add Java code dependencies? Discover how to include references to other Java projects and JAR files in your JavaCompute node code.
- Where can I find the Java user-defined node API? Follow this link to the Java API for the WebSphere Message Broker classes for creating a Java user-defined node, which you can also use to code your JavaCompute node.
How do I use XML transformations?
- By using the content of the XML data within the message itself, which transforms the message according to a style sheet that the message itself defines.
- By setting a value within the LocalEnvironment folder.
- By using node properties, which ensures that the transformation that is defined by this single style sheet is applied to every message that is processed by this node.
- Where
can I find a sample that shows XML transformations?
If
you have installed the WebSphere Message Broker Toolkit,
you can use this link to display the XSL Transform sample. The XSL
Transform sample is a message flow sample that shows how to use a
message flow to transform an XML message to another form of XML message
according to the rules provided by an XSL stylesheet.
You can view information about samples only when you use the information center that is integrated with the WebSphere Message Broker Toolkit or the online information center. You can run samples only when you use the information center that is integrated with the WebSphere Message Broker Toolkit.
- How do I use the XSLTransform node? Follow this link to discover how to use and configure the XSLTransform node to transform an XML message into another form of XML.
- Where can I find out more about XSL Transformations? To discover more about XML Transformations, follow this link to the W3C specification of the syntax and semantics of the XSL Transformations language for transforming XML documents into other XML documents.
How do I use PHP?
- Where can I get an overview of PHP? Follow this link for an overview of PHP, and links to further information about how you can use this scripting language.
- Where can I find a sample
that shows how to use PHP?
If you have installed the WebSphere Message Broker Toolkit, you can use this link to
display the PHP sample. The PHP sample is a message flow sample that
shows how to use PHP code to transform an XML message.
You can view information about samples only when you use the information center that is integrated with the WebSphere Message Broker Toolkit or the online information center. You can run samples only when you use the information center that is integrated with the WebSphere Message Broker Toolkit.
- How do I use a PHPCompute node? Follow this link to discover how to use and configure the PHPCompute node in your message flows.
- How do I create PHP code for a PHPCompute node? Discover how to create a PHP script file for the PHPCompute node in your message flows.
How do I use .NET?
On Windows platforms, use .NET assemblies to create, modify, and route messages. You can call .NET assemblies from a .NETCompute node. Using ESQL, you can also call assemblies from a Compute node.
How do I use XPath?
- Where can I get an overview of XPath? Follow this link for an overview of XPath, and how you can use XPath with nodes.
- How do I use the XPath Expression Builder? You can use the XPath Expression Builder to add XPath expressions to your node properties. Follow this link for information about how to use the XPath Expression Builder.