Normally, the inbound endpoint is resolved by matching its name (Endpoint ID) to a username that is used to send a message to ONEiO. In case a master subscription needs to use the same username for messages that should be sent to different inbound endpoints, an additional resolving strategy can be applied.
When a specific strategy is configured for a username, a resolving value extracted from the message itself is used to determine the inbound endpoint. The way this resolving value is extracted is based on the resolver type that is set as the resolving credentials. The extracted resolving value is then used to find the actual inbound endpoint — this value has to be assigned to each master subscription-owned endpoint.
Note
The resolving credentials can be set only via ONEiO support, while the master subscription owner can manipulate the resolving value for each belonging subscription-owned endpoint.
To view the resolving strategy, please go to Service Provider Subscription -> My Endpoint Types -> any existing endpoint type -> Production or QA environment.
The resolving credentials are set for all endpoints, while the resolving value is unique per endpoint.
Click View resolving credentials to view the resolving credentials for this endpoint type; There are several resolver types ONEiO currently supports:
| Resolver Types | Information |
|---|---|
| Default System Resolver | Extracts resolving value from a given HTTP header |
| Http Request Parameter Value Based System Resolver | Extracts the resolving value from a given HTTP request parameter |
| Json Field Value Based System Resolver | Extracts resolving value from a message payload (JSON payload is expected), using the provided JsonPath/DotNotation expression |
| Multi Json Field Value Based System Resolver | Extracts resolving value from a message payload (JSON payload is expected), using the provided JsonPath/DotNotation expressions. The provided expressions are tried one by one, and the order is not guaranteed, so the first matching value will be considered a resolving value |
| Xml Element Value Based System Resolver | Extracts resolving value from a message payload (XML payload is expected), using the provided XPath expression |
| Multi Xml Element Value Based System Resolver | Extracts resolving value from a message payload (XML payload is expected), using a provided set of XPath expressions. The XPaths are tried one by one, and the order is not guaranteed, so the first matching value will be considered a resolving value |
If the resolver type is eg: Multi Xml Element Value Based System Resolver, xPath needs to be specified.
Click Set Resolving Value or the pencil button to edit the resolving value. Set the desired resolving value and click confirm to save.
Note
When using a resolver that supports more than one Resolving Value (Multi Xml Element Value Based System Resolver or Multi Json Field Value Based System Resolver), after the first value, hit enter to add the second value - and the same for the next values.
Comments
Please sign in to leave a comment.