Skip to main content
Version: 7.2405.x.x LTS

RsEventSource

The RsEventSource provides a RESTful web-service API to the event system. The REST service is published at a configured endpoint and offers several service interfaces for event generation:

  • /data: The data interface consumes XML-based events when invoked with a POST operation.
POST /nevisdp/event/data HTTP/1.0
Content-Type: application/xml

<eventData>
<data>
<name>key1</name>
<value>value1</value>Y
</data>
<data>
<name>key1</name>
<value>value1</value>Y
</data>
</eventData>
  • /query: The query interface uses the URL's query parameter to create an event when invoked with the POST operation.
POST /nevisdp/event/query?key1=value1&key2=value2 HTTP/1.0

Authentication is handled by means of two-way SSL.

If the result of the triggered jobs is of interest, the WS can be invoked in a synchronous mode by including the matrix parameter „sync" in the URL:

POST /nevisdp/event/data;sync=true HTTP/1.0
POST /nevisdp/event/query;sync=true?key1=value1&key2=value2 HTTP/1.0
  • /xml: The xml interface consumes arbitrary XML documents. For every call an event is generated. Data is extracted using X-path expressions.
POST /nevisdp/event/xml HTTP/1.0
Content-Type: application/xml

<user>
<name>Mustermann</name>
<firstName>Hans</firstName>
</user>

Configuration

NameType, usage constraints, defaultsDescription
endpointrequired: paraVal
default: none
type: URL of the endpoint
The URL which is used to create the service.
threadsoptional: paraVal
default: 10
type: integer
The number of threads the HTTP server uses to handle client requests.
sslSettingsoptional: paraMap
default: none
type: string/string
The SSL configuration settings used for this HTTP server. It uses the Java system property names to set up the key and trust stores.
dataoptional: paraMap
default: none
type: string/xpath
Only required when using the XML endpoint. Defines the event's data fields using XPath queries. The current node in the XPath queries is the document root received through the xml endpoint.
xpathNamespacesoptional: paraMap
default: none
type: string/string (uri)
Register namespace prefixes to the specified URIs. Those prefixes are used to parse the XPath expressions. The URIs specified have to match the URIs in the XML document.

Example

Register a RESTful web-service at URLs:

  • http://localhost:1234/nevisdp/rs/data
  • http://localhost:1234/nevisdp/rs/query
<eventSource name="rsEvents" type="RsEventSource">
<dp:paraVal name="endpoint" value="http://localhost:1234/nevisdp/rs" />
</eventSource>