Try OpenEdge Now
skip to main content
BP Server Developer's Guide
Messaging workstep : Message subscriber workstep : Message correlation : Named correlations
 
Named correlations
A named correlation defines a set of message properties that are used to correlate the received message with the target workstep instances.

Message definition

The message definition is extended to include one or more named correlations as described below:
<MessageDescriptor name=" {name to identify the message}">
    <Header/>
    <Payload>
    <Property name=" {prop-name}">
    <XPath></XPath>
    </Property>
    </Payload>
    <Correlations>
    <Correlation name=" {name to identify the correlation}">
    <Property name=" {prop-name}"/>
    </Correlation>
    </Correlations>
</ MessageDescriptor>

Correlation definition

The above product example is extended below to define a named correlation using productId.
<MessageDescriptor name="NewProduct">
    <Header/>
    <Payload>
    <Property name="prodId">
    <XPath>/Product/Id/text()</XPath>
    </Property>
    <Property name="prodName">
    <XPath>/Product/Name/text()</XPath>
    </Property>
    </Payload>
    <Correlations>
    <Correlation name="ProductPK">
    <Property name="prodId"/>
    </Correlation>
    </Correlations>
</ MessageDescriptor>