About this task
The project that contains a user-defined node is a user-defined node project. When you create a user-defined node, you can add it to an existing user-defined node project, or you can create a new project. A user-defined node project can contain more than one user-defined node. Typically, all user-defined nodes for a particular connector provider are contained in the same project. For example, if you create an input, output, and request connector for a connector provider, all three types of connector have a user-defined node in the same project.
Procedure
To create a user-defined node, complete the following steps:
- In the IBM Integration Toolkit,
click . The New User-defined Node wizard
opens.
- Select an existing user-defined node project, or click New to create a new project. The following steps assume that you create a new project.
- In the New User-Defined Node Project wizard, select Create a new category and enter a name for the category. This category is displayed on the message flow node palette.
- Enter a project name. For example, use the same name as the connector provider.
When you enter the project name and move to another field, the other fields in the wizard are filled automatically.
- Click Finish.
- In the New User-Defined Node wizard, specify a schema for this node. Do not use the default schema or any other common schema, such as mqsi, which might cause file name clashes. For example, you might use the same package name that is used for the runtime connector, such as connector.database.
- In Name, specify a name for the node. The name must be one of the following values:
Connector interaction type |
User-defined node name |
Input |
ComIbmEventInput |
Output |
ComIbmOutput |
Request |
ComIbmRequest |
- In Display name, enter a name for the node to include on the message flow node palette. For example, set the display name to My Database Input. This name is used in trace and error logs to represent the user-defined node.
- In Tooltip on palette, enter some appropriate text; for example, "Input node for a database".
- Select Implemented in Java/C.
- Optional: Import an icon to represent your node.
- Click Finish.
Results
A
.msgnode file for the new user-defined node is created and is added to the project in the
Application Development view. A
.properties file of the same name is also created. The
.msgnode file is opened in the
Message Node editor.
What to do next
Configure the user-defined node properties for your connector by following the instructions in
Configuring the user-defined node properties and terminals for your connector.