CommonService: Unterschied zwischen den Versionen

Aus DRV STRING
Wechseln zu: Navigation, Suche
(Overview)
(Overview)
Zeile 5: Zeile 5:
  
 
[[Datei:CommonServiceRequestType.png|mini|links|Request Type]]
 
[[Datei:CommonServiceRequestType.png|mini|links|Request Type]]
[[Datei:CommonServiceResponseType.png|mini|rechts|Response Type]]
+
[[Datei:CommonServiceResponseType.PNG|mini|rechts]]
  
 
=== Basic Attributes ===
 
=== Basic Attributes ===

Version vom 27. Juni 2018, 12:59 Uhr

Overview

The Common Service is a superstructure defining the mostly shared elements of any service. Specific services like the AccommodationService only extend this structure to add specific information for their case. This basic structure is separated into a Request version and a Response version. Each of them only contain the Attributes and Elements suitable for the specified direction. As, for example, it is essential to send the state for a service in the response of a BookingResponse, it is not supposed (or even harmful) to use it in the BookingRequest.

The concept of separate attributes for Request Services and Response Services is inherited by all other service implementations.

Request Type
CommonServiceResponseType.PNG

Basic Attributes

The minimal set of Information needed to describe a service is its Code, the StartDate and its EndDate. These fields are mandatory for every request containing a service. The response adds another manydatory field, which is: State.

Optional Attributes

To extend the information capable to be transported by the protocol, each service contains a set of optional Elements and Attributes. Please note, that these fields might be expected by the communication partner, even if specified as optional by STRING Protocol.

Attribute Values / Explanation
@Identifier This is a unique identifier within one message, which can be used to reference on a concrete room
@Type Specific ServiceType
AssignedTraveller A List of traveller Ids to describe who is assigned to this service
Quantity The quantity of equal services described by this service element.
Attributes A List of Attributes describing the Service. Each attribute is defined by a code and its source plus optional descriptive Texts.
PackageReference In case the Service belongs to a package, the identifier can be set here
CustomerRequests (Request only) A List of texts holding customer specific request information
AdditionalInfos (Response only) Element to send additional information separated into:
GeneralInformation,
CancellationPolicies ans
ModificationPolicies