set iso field1 01

ISO8583 Field Setter

Version: 17.07

Supported Since: 17.07

What is an ISO8583 Field Setter Processor?

ISO8583 Field Setter Processor is a processing element which can be used to set/update fields of ISO8583 messages.

In order to use this processing element, you must first select the ISO8583 Processors dependency from the connector list when you are creating an empty Ultra project. If you have already created a project, you can add the ISO8583 Processors dependency via Component Registry. From Tools menu, select Ultra Studio → Component Registry and from the Connectors list, select the ISO8583 Processors dependency.

iso8583 field setter ports

Out Ports


The message will be sent to this out port if setting the field is successful.

On Exception

The message will be sent to this out port if the processing element failed to set the ISO8583 field


Extraction Type *


Extraction source to extract the value from, or NO_EXTRACTION to add a value manually

Value *


Value for the variable if the extraction type is NO_EXTRACTION. Else, property name or header name for PROPERTY or HEADER extraction types

Data field index *


Index of the data field in ISO8583 message

ISO Type *


Type of the field to be set. Type can be,





  • DATE10

  • DATE4


  • TIME







  • DATE12

Length of the value *


Length of the value to be set.

Sample Use Case

iso8583 flow
Figure 1. Complete flow of the use case

In this case, the flow is accepting an ISO8583 message from a client and extracts out a field out of that message before sending it to the intended destination. When it receives the response from the ISO8583 server, flow will attach a new field to the outgoing message and send it as the response for the original client.

iso8583 flow ingress config
Figure 2. Configuring ISO8583 ingress connector to accept messages over port 9000

Here Local Bind Address is kept blank, so the connector will bind to all interfaces in the system.

Use binary bitmap has been checked and Use binary message has been unchecked. Therefore the connector will consider the header as binary when parsing the message inorder to convert it to a platform specific message format.

iso8583 flow extract config
Figure 3. Configuring ISO8583 Field Extractor to extract field 7.

ISO8583 Field extractor has been configured to extract field 7 from the incoming message and persist that value as a context variable with the key DATE.

iso8583 flow log config
Figure 4. Configuring Logger to log extracted field to the console.

Logger processing element has been configured to log the extracted field as an INFO log to the console.

iso8583 flow egress config
Figure 5. Configuring ISO8583 egress connector to send message to a remote server

ISO8583 Egress Connector has been configured to forward original message to port 8500 of Other configurations behave similar to the ingress connector and they are applied to both outgoing and incoming response messages through the egress connector.

As an example, when converting a platform specific message format to a ISO8583 TCP message, only the bitmap will be kept as binary while other parts will be encoded to String. When a message is received as the response, it expects the bitmap to be binary and rest to be encoded as a String.

iso8583 flow setter config
Figure 6. Configuring ISO8583 field setter to set a custom value to outgoing message

As the final step of the flow, a custom field is attached to the outgoing message using ISO8583 Field Setter processing element.

In this topic
In this topic
Contact Us