Skip to content

Service Interface queries

A Service Interface <query> invokes an external operation to resolve a domain question.

<query name="available_room">
  <parameters><parameter predicate="room_date"/></parameters>
  <target><http endpoint="https://service.example/find-rooms"/></target>
</query>

The query name must match the ontology predicate of the question sent to the service (for this example, declare an available_room predicate in the ontology). TDM uses that question predicate to find the Service Interface query and sends it as the HTTP operation name. A domain service_query mapping can select a different question, but does not define an independent operation-name alias. parameters and target children are required. Queries require an HTTP target; frontend targets are not supported. The corresponding domain plan item is invoke_service_query.

See Parameters and Targets.