Web Services Base Notification 1.3 (WS-Basenotification)

12Web Services Base Notification 1.3 3(WS-BaseNotification)4Public ReviewWorking Draft 01, 07 July02f, 14 5November 20051wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 2Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 1 of 65 3 4 6 7 8Document identifier 9 wsn-ws_base_notification-1.3-spec-pr-01wd-02f 10Location: 11 http://docs.oasis-open.org/wsn/wsn-ws_base_notification-1.3-spec-pr-01wd-02f.pdf 12Editors: 13 Steve Graham, IBM <[email protected]> 14 David Hull, Tibco <[email protected]> 15 Bryan Murray, Hewlett-Packard Company <[email protected]> 16Abstract: 17 The Event-driven, or Notification-based, interaction pattern is a commonly used pattern 18 for inter-object communications. Examples exist in many domains, for example in 19 publish/subscribe systems provided by Message Oriented Middleware vendors, or in 20 system and device management domains. This notification pattern is increasingly being 21 used in a Web services context. 22 WS-Notification is a family of related specifications that define a standard Web services 23 approach to notification using a topic-based publish/subscribe pattern. It includes: 24 standard message exchanges to be implemented by service providers that wish to 25 participate in Notifications, standard message exchanges for a notification broker service 26 provider (allowing publication of messages from entities that are not themselves service 27 providers), operational requirements expected of service providers and requestors that 28 participate in notifications, and an XML model that describes topics. The WS-Notification 29 family of documents includes three normative specifications: [WS-BaseNotification], [WS- 30 BrokeredNotification], and [WS-Topics.]. 31Status: 32 On July 7thSeptember 14 th , 2005, the OASIS WS-Notification Technical Committee 33 approved this document for publication as a Public ReviewWorking Draft. Committee 34 members should send comments on this specification to the [email protected] 35 list. Others may submit comments to the TC via the web form found on the TC's web 36 page at http://www.oasis-open.org/committees/wsn. Click the button for "Send A 37 Comment" at the top of the page. Submitted comments (for this work as well as other 38 works of that TC) are publicly archived and can be viewed at: 39 http://lists.oasis-open.org/archives/wsn-comment/. 40 For information on whether any patents have been disclosed that may be essential to 41 implementing this specification, and any offers of patent licensing terms, please refer to 42 the Intellectual Property Rights section of the WSN TC web page (http://www.oasis- 43 open.org/committees/wsn/).5wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 6Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 2 of 65 7 8 44Table of Contents451 Introduction...... 5 46 1.1 Goals and Requirements...... 5 47 1.1.1 Requirements...... 5 48 1.1.2 Non-Goals...... 6 49 1.2 Terminology...... 6 50 1.3 Namespaces...... 7 51 1.4 Fault Definitions...... 7 522 Terminology and Concepts...... 8 53 2.1 Definitions...... 8 54 2.2 Production vs. Delivery...... 9 553 NotificationConsumer Interface...... 10 56 3.1 Notification Metadata...... 10 57 3.2 Notify...... 11 58 3.2.1 Example SOAP Encoding of the Notify Message...... 11 594 NotificationProducer Interface...... 13 60 4.1 NotificationProducer Resource Properties...... 13 61 4.2 Subscribe...... 14 62 4.2.1 Example SOAP Encoding of the Subscribe Message Exchange...... 20 63 4.3 GetCurrentMessage...... 21 64 4.3.1 Example SOAP Encoding of the GetCurrentMessage Message Exchange...... 22 655 Pull-Style Notification...... 24 66 5.1 PullPoint Interface...... 24 67 5.1.1 Accumulating Notification Messages...... 24 68 5.1.2 GetMessages...... 24 69 5.1.3 Example SOAP Encoding of the GetMessages Message Exchange...... 26 70 5.1.4 Destroy ...... PullPoint 71 26 72 5.1.5 Example SOAP Encoding of the DestroyDestroyPullPoint Message Exchange...... 27 73 5.2 Create PullPoint Interface...... 28 74 5.2.1 Example SOAP Encoding of the CreatePullPoint Message Exchange...... 28 756 SubscriptionManager Interface...... 30 76 6.1 Base Subscription Manager...... 30 77 6.1.1 Renew...... 30 78 6.1.2 Unsubscribe...... 32 79 6.2 Pausable Subscription Manager...... 33 80 6.2.1 PauseSubscription...... 33 81 6.2.2 Example SOAP Encoding of the PauseSubscription Message Exchange...... 34 82 6.3 ResumeSubscription...... 35 83 6.3.1 Example SOAP Encoding of the ResumeSubscription Message Exchange...... 36 84 6.4 Subscriptions as WS-Resources...... 369wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 10Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 3 of 65 11 12 85 6.4.1 Subscription Resource Properties...... 37 867 Security Considerations...... 38 87 7.1 Securing the Message Exchanges...... 38 88 7.2 Securing Subscriptions and Notifications...... 38 898 References...... 40 90 8.1 Normative...... 40 91 8.2 Non-Normative...... 40 92Appendix A. Acknowledgments...... 41 93Appendix B. XML Schema...... 42 94Appendix C. WSDL 1.1...... 53 95Appendix D. Revision History...... 61 96Appendix E. Notices...... 639713wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 14Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 4 of 65 15 16 981 Introduction 99The Event-driven, or Notification-based, interaction pattern is commonly used in inter-object 100communications. Examples exist in many domains, for example in publish/subscribe systems 101provided by Message Oriented Middleware vendors, or in system and device management 102domains. 103The WS-Notification family of specifications defines a standard Web services approach to 104notification. This document is the base specification on which all the other specifications in the 105family depend. It defines the normative Web services interfaces for two of the important roles in 106the notification pattern, namely the NotificationProducer and NotificationConsumer roles. This 107specification includes standard message exchanges to be implemented by service providers that 108wish to act in these roles, along with operational requirements expected of them. 109In the remainder of this section and section 2 we will give a brief introduction to the Notification 110pattern, and the terms we will use in this specification. 111In the Notification pattern a Web service, or other entity, disseminates information to a set of 112other Web services, without having to have prior knowledge of these other Web services. 113This specification defines a role called the NotificationProducer. A NotificationProducer is capable 114of producing a set of Notification messages. A NotificationProducer accepts incoming Subscribe 115requests. Each Subscribe request contains a reference to a NotificationConsumer and identifies 116the subset of the Notifications the NotificationProducer should produce. This subset can be 117described by identifying one or more boolean filters, including filtering by Topic, as discussed in 118[WS-Topics]. The NotificationProducer agrees to produce Notification Messages as requested in 119the Subscribe request, or returns a fault if the subscription cannot be handled. 120The production of Notifications may be realized in a number of ways. One particular configuration, 121in which the NotificationProducer reproduces Notifications produced by other entities, is 122described in the [WS-Brokered Notification] specification. Alternatively, a NotificationProducer 123may produce Notifications itself. An implementer interested only in such direct, point-to-point, 124notification need only refer to this WS-BaseNotification specification. 1251.1 Goals and Requirements 126The goal of WS-BaseNotification is to standardize the terminology, concepts, operations, WSDL 127and XML needed to express the basic roles involved in Web services publish and subscribe for 128notification message exchange.1291.1.1 Requirements 130In meeting these goals, the WS-BaseNotification specification must explicitly address the 131following requirements: 132 Must support resource-constrained devices. The specifications must be factored in a way 133 that allows resource-constrained devices to participate in the Notification pattern. Such 134 devices will be able to send information to, and receive information from Web services, 135 without having to implement all the features of the specifications. 136 Must provide runtime metadata: There must be a mechanism that lets a potential 137 Subscriber discover what elements are provided for subscription by a NotificationProducer, 138 and in what formats the subscription for notification can be made. 139In addition, the WS-BaseNotification must allow for the following requirements to be met:17wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 18Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 5 of 65 19 20 140 WS-BaseNotification must be independent of binding-level details: Transport protocol 141 details must be orthogonal to the subscription and the delivery of the notifications, so that the 142 specification can be used over a variety of different transports. 143 Must allow for Message Oriented Middleware implementations. The design of the WS- 144 BaseNotification must allow a service that is acting as a NotificationProducer to delegate its 145 implementation of WS-BaseNotification semantics to a Message Oriented Middleware 146 provider. 147 Relationship to other WS-* specifications: WS-BaseNotification must be composable with 148 other Web services specifications.1491.1.2 Non-Goals 150The following topics are outside the scope of the WS-BaseNotification specification: 151 Defining the format of notification payloads: The data carried in Notification payloads is 152 application-domain specific, and WS-BaseNotification does not prescribe any particular 153 format for this data. 154 Defining any Notifications. The WS-BaseNotification specification does not define any 155 “standard” or “built-in” notification situations or messages. 156 Defining the mapping between Situations and Notifications. The WS-BaseNotification 157 specification does not define the circumstances under which a potential producer of 158 information should decide if and when it should actually produce notifications. However they 159 do define the form and semantics of the notification once it has decided to do so. 160 Defining the means by which NotificationProducers are discovered by subscribers. It is 161 beyond the scope of this specification to define the mechanisms for runtime discovery of 162 NotificationProducers. 163 Defining message ordering or interleaving policies for delivery is beyond the scope of 164 WS-BaseNotification. 1651661.2 Terminology 167The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", 168"SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be 169interpreted as described in [RFC 2119]. 170When describing abstract data models, this specification uses the notational convention used by 171the [XML Infoset]. Specifically, abstract property names always appear in square brackets (e.g., 172[some property]). 173This specification uses a notational convention, referred to as “Pseudo-schemas” in a fashion 174similar to the WSDL 2.0 Part 1 specification [WSDL 2.0].”. A Pseudo-schema uses a BNF-style 175convention to describe attributes and elements: 176  `?' denotes optionality (i.e. zero or one occurrences), 177  `*' denotes zero or more occurrences, 178  `+' one or more occurrences, 179  `[' and `]' are used to form groups, 180  `|' represents choice. 181  Attributes are conventionally assigned a value which corresponds to their type, as 182 defined in the normative schema.21wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 22Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 6 of 65 23 24 183  184 <element 185 required_attribute_of_type_QName="xs:QName" 186 optional_attribute_of_type_string="xs:string"? > 187 <required_element /> 188 <optional_element /> ? 189 <one_or_more_of_these_elements /> + 190 [ <choice_1 /> | <choice_2 /> ] * 191 </element> 192Where there is disagreement between the separate XML schema and WSDL files describing the 193messages defined by this specification and the normative descriptive text (excluding any pseudo- 194schema) in this document, the normative descriptive text will take precedence over the separate 195files. The separate files take precedence over any pseudo-schema and over any schema and 196WSDL included in the appendices.1971.3 Namespaces 198The following namespaces are used in this document:Prefix Namespace s http://schemas.xmlsoap.org/soap/envelope/ OR http://www.w3.org/2003/05/soap-envelope xsd http://www.w3.org/2001/XMLSchema wsa http://www.w3.org/2005/0308/addressing wsrf-rp http://docs.oasis-open.org/wsrf/rp-12 wsrf-bf http://docs.oasis-open.org/wsrf/bf-12 wsnt http://docs.oasis-open.org/wsn/b-12 wsntw http://docs.oasis-open.org/wsn/bw-12 wstop http://docs.oasis-open.org/wsn/t-11991.4 Fault Definitions 200All faults generated by a NotificationProducer or SubscriptionManager SHOULD be compliant 201with the WS-BaseFaults [WS-BaseFaults] specification. 202All faults defined by this specification MUST use the following URI for the WS-Addressing [action] 203Message Addressing Property: 204 http://docs.oasis-open.org/wsn/fault.25wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 26Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 7 of 65 27 28 2052 Terminology and Concepts2062.1 Definitions 207The following definitions outline the terminology and usage in this specification. 208Situation: 209  A Situation is some occurrence known to a NotificationProducer and of potential interest 210 to third parties. 211  A Situation could be a change of the internal state of a resource or could be 212 environmental, such as a timer event. It could also be an external event, such as a piece 213 of news that has been supplied by a news-feed service. 214  WS-Notification does not specify what a Situation is or is not, nor does it define the 215 relationship between a Situation and the Notification(s) that are used to describe it. 216Notification: 217  A Notification is an artifact of a Situation containing information about that Situation that 218 some entity wishes to communicate to other entities. 219  A Notification is represented as an XML element with a Namespace qualified QName and 220 a type defined using XML Schema. 221  A typical usage pattern is to define a single Notification type (to be precise, its defining 222 XML element) for each kind of Situation, containing information pertinent to that kind of 223 Situation; in this case one can think of a Notification instance as in some sense being (or 224 at least representing) the Situation. 225  A designer could choose to associate several different Notification types with a Situation, 226 for example, describing different aspects of the Situation, destined for different target 227 recipients, etc. Conversely it is possible that several essentially different Situations give 228 rise to Notifications of the same type. 229NotificationProducer: 230  A NotificationProducer is a Web service that implements the message exchanges 231 associated with the NotificationProducer interface. 232  A NotificationProducer is capable of producing Notifications for those 233 NotificationConsumers for which Subscriptions have been registered, based on 234 Situations that occur and on the parameters supplied with the requests from which the 235 Subscriptions were created. 236  A Web Service that implements the message exchanges associated with 237 NotificationProducer may directly produce Notifications itself, or it may be a 238 NotificationBroker, reproducing Notifications that were produced by separate Publisher 239 and/or NotificationProducer entities. 240  It is the factory for Subscription resources. 241NotificationConsumer: 242  A NotificationConsumer is an endpoint, represented by a WS-Addressing endpoint 243 reference, designated to receive Notifications produced by a NotificationProducer as a 244 result of a subscription.29wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 30Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 8 of 65 31 32 245  A NotificationConsumer may accept the generic Notify message, or it may be able to 246 process one or more domain-specific Notification types. 247Subscription: 248  A Subscription represents the relationship between a NotificationConsumer and a 249 NotificationProducer, including any filtering parameters such as Topic and various other 250 optional filter expressions, along with any relevant policies and context information. 251  A Subscription resource is created when a Subscriber sends the SubscribeRequest 252 message to a NotificationProducer. 253  Subscription resources are manipulated by messages sent to the SubscriptionManager 254 Web service associated with the Subscription resource. 255SubscriptionManager 256  A SubscriptionManager is an endpoint, represented by an endpoint reference [WS- 257 Addressing] that implements message exchanges associated with the 258 SubscriptionManager interface. 259  A SubscriptionManager provides operations that allow a service requestor to query and 260 manipulate Subscription resources that it manages 261  A SubscriptionManager is subordinate to the NotificationProducer, and MAY be 262 implemented by the NotificationProducer service provider. However WS-Notification 263 permits it to be implemented by a separate service provider, should an implementer so 264 desire. 265Subscriber: 266  A Subscriber is any entity that sends the SubscribeRequest message to a 267 NotificationProducer. 268  Note that a Subscriber may be a different entity from the NotificationConsumer for which 269 Notifications are actually produced.2702.2 Production vs. Delivery 271Various statements in this document refer to a NotificationProducer producing a Notification. 272Producing a Notification means: supplying a Notification to a delivery mechanism for transmission 273to a NotificationConsumer. Depending on the actual delivery mechanism, this transmission might 274be reliable or might be done on a best-effort basis. A Notification which is never produced will 275definitely never be delivered, but the converse is not necessarily true: a Notification which is 276produced may or may not actually be delivered, depending on the delivery mechanism, the 277validity of the NotificationConsumer address, the state of the network, and so forth.33wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 34Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 9 of 65 35 36 2783 NotificationConsumer Interface 279WS-BaseNotification allows a NotificationConsumer to receive a Notification in one of two forms: 280 1. The NotificationConsumer MAY simply receive the “raw” Notification (i.e. the application- 281 specific content). 282 2. The NotificationConsumer MAY receive the Notification data as a Notify message as 283 described below. 284The second option (the Notify message) provides a well specified mechanism by which the 285NotificationProducer can supply additional information defined by WS-BaseNotification (such as 286the Topic) in addition to the application-specific Notification content. It also allows the 287NotificationConsumer to receive a wide range of Notifications without having to explicitly provide 288support for each one in its WSDL. This form of Notification also allows a batch of several 289Notifications to be combined into a single physical message. 290When a Subscriber sends a Subscribe request message, it indicates which form of Notification is 291required (the raw Notification, or the Notify Message). The NotificationProducer MUST observe 292this component of the Subscription and use the form that has been requested., if it is able. If it 293does not support the form requested, it MUST fault. 294This means that a NotificationConsumer MAY choose to implement the Notify Message, or to 295implement raw Notification(s) explicitly (or both). When requesting creation of a Subscription on 296behalf of a NotificationConsumer, a Subscriber SHOULD ensure that the NotificationConsumer is 297able to handle the form of Notification it has requested for the given Subscription.2983.1 Notification Metadata 299In order to inform the NotificationConsumer about the Situation that produced a Notification and 300to allow the NotificationConsumer to manipulate the underlying subscription, the 301NotificationProducer MAY include any combination of the following metadata elements in the 302Notifications it produces: 303wsnt:SubscriptionReference 304 An EndpointReference to the Subscription WS-Resource [WS-Resource] that is 305 associated with the Notify message.. 306wsnt:Topic 307 A TopicExpression describing exactly one Topic, which MUST be the Topic that is 308 associated with the Notification. This element describes the Topic that matched to a 309 subscription, causing the NotificationProducer to send the Notify message to the 310 NotificationConsumer. 311wsnt:Topic/@Dialect 312 The dialect used in the TopicExpression. This MUST be the same dialect used by the 313 Subscriber when it created the Subscription that yielded this Notify message. 314wsnt:ProducerReference 315 An EndpointReference to the NotificationProducer that produced the Notification artifact. 316 317When using the Notify message format, these elements MUST appear within the 318wsnt:NotificationMessage element as described below. When using the raw message format, 37wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 38Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 10 of 65 39 40 319these elements MAY appear as components of the message (such as SOAP header elements) in 320accordance with any contract with the NotificationConsumer.3213.2 Notify 322A NotificationProducer MAY produce a Notify message containing one or more Notification(s). 323The format of the Notify message is:324 … 325 <wsnt:Notify> 326 <wsnt:NotificationMessage> 327 <wsnt:SubscriptionReference> 328 wsa:EndpointReference 329 </wsnt:SubscriptionReference> ? 330 <wsnt:Topic Dialect="xsd:anyURI"> 331 {any} * 332 </wsnt:Topic>? 333 <wsnt:ProducerReference> 334 wsa:EndpointReference 335 </wsnt:ProducerReference> ? 336 <wsnt:Message> 337 {any} 338 </wsnt:Message> 339 <wsnt:NotificationMessage> + 340 {any} * 341 </wsnt:Notify> 342 … 343The WS-Addressing [action] Message Addressing Property MUST contain the URI 344 http://docs.oasis-open.org/wsn/bw-12/NotificationConsumer/Notify. 345The components of the Notify message are further described as follows: 346/wsnt:Notify 347 Contains a collection of one or more Notifications. 348/wsnt:Notify/wsnt:NotificationMessage 349 Contains a Notification payload along with any metadata components as defined in 350 section 3.1. 351/wsnt:Notify/wsnt:NotificationMessage/wsnt:Message 352 A copy of the actual Notification payload. 353/wsnt:Notify/{any} 354 The Notify message also allows for open content, in order to accommodate elements that 355 may be needed by extensions built on BaseNotification, including those providing 356 additional filtering mechanisms. 357 358No response is expected from the NotificationConsumer upon receipt of this message.3593.2.1 Example SOAP Encoding of the Notify Message 360The following is a non-normative example of a Notify message using SOAP: 361<s:Envelope ... > 362 <s:Header> 363 <wsa:Action> 364 http://docs.oasis-open.org/wsn/bw-12/NotificationConsumer/Notify41wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 42Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 11 of 65 43 44 365 </wsa:Action> 366 ... 367 </s:Header> 368 <s:Body> 369 <wsnt:Notify> 370 <wsnt:NotificationMessage> 371 <wsnt:SubscriptionReference> 372 <wsa:Address> 373 http://www.producerexample.org/SubsMgrEndpointSubscriptionManager 374 </wsa:Address> 375 </wsnt:SubscriptionReference> 376 <wsnt:Topic Dialect= 377 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple"> 378 npex:SomeTopic 379 </wsnt:Topic> 380 <wsnt:ProducerReference> 381 <wsa:Address> 382 http://www.producerexample.org/ProducerEndpointNotificationProducer 383 </wsa:Address> 384 </wsnt:ProducerReference> 385 <wsnt:Message> 386 <npex:NotifyContent>exampleNotifyContent</npex:NotifyContent> 387 </wsnt:Message> 388 <wsnt:NotificationMessage> 389 </wsnt:Notify> 390 </s:Body> 391</s:Envelope>45wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 46Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 12 of 65 47 48 3924 NotificationProducer Interface 393This section describes the message exchanges that a NotificationProducer MUST support. These 394message exchanges allow the NotificationProducer to advertise its support for one or more 395Topics, and allow a Subscriber to create Subscriptions.3964.1 NotificationProducer Resource Properties 397In addition to the message exchanges described in this specification, a NotificationProducer MAY 398also support the required message exchanges defined in the [WS-ResourceProperties ] 399specification and MAY support the optional message exchanges defined in the WS- 400ResourceProperties specification. In such a case, this specification defines several resource 401properties, which MUST conform to the following schema fragment for content:.402 … 403 targetNamespace="http://docs.oasis-open.org/wsn/b-12" 404 … 405 406 <xsd:element name="TopicExpression" type="wsnt:TopicExpressionType"/> 407 408 <xsd:element name="FixedTopicSet" type="xsd:boolean" default=”true”/> 409 410 <xsd:element name="TopicExpressionDialect" type="xsd:anyURI"/> 411 412 <xsd:element name=”wstop:TopicSet” type=”wstop:TopicSetType”/> 413 … 414These properties must also conform to the following schema fragment for cardinality:415 416 <xsd:element ref="wsnt:TopicExpression" 417 minOccurs="0" maxOccurs="unbounded" /> 418 419 <xsd:element ref="wsnt:FixedTopicSet" 420 minOccurs="0" maxOccurs="1" /> 421 422 <xsd:element ref="wsnt:TopicExpressionDialect" 423 minOccurs="0" maxOccurs="unbounded" /> 424 425 <xsd:element ref="wstop:TopicSet" 426 minOccurs="0" maxOccurs="1" /> 427 428 429 430These Resource Property elements are further constrained as follows: 431/wsnt:TopicExpression 432 This resource property contains a collection of topics supported by the NotificationProducer. 433 The set of topics is expressed using one or more wsnt:TopicExpression resource property 434 element(s). Each wsnt:TopicExpression resource property element is a TopicExpression. The 435 dialect of TopicExpression used can be any dialect. It is RECOMMENDED to use one of the 436 TopicExpression dialects described in [WS-Topics]. A NotificationProducer MAY use an 437 expression that refers to multiple topics, if the dialect used has this capability. The same topic49wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 50Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 13 of 65 51 52 438 may be referred to by multiple wsnt:TopicExpression resource property element(s), for 439 example, in different resource property elements each using a different dialect. 440 If a topic is identified by one of the wsnt:TopicExpression resource property elements, a 441 Subscriber can reasonably expect that the NotificationProducer will not return an 442 InvalidTopicExpressionFault for subscription requests for the topic. It is not a guarantee that it 443 will receive any Notifications; the NotificationProducer may not actually produce any 444 Notifications on the particular topic during the time that the Subscriber is registered. 445/wsnt:FixedTopicSet 446 Indicates if the collection of topics contained within the wsnt:TopicExpression resource 447 property may change. This value is “true” if the collection of topics supported by the 448 NotificationProducer does not change and “false” if the NotificationProducer allows the 449 collection to change (for example if it allows additional topics to be supported should 450 publishers or subscribers request them). This property is optional and defaults to “true” if 451 missing. 452/wsnt:TopicExpressionDialect 453 Indicates one or more TopicExpression dialect(s) that are supported by the 454 NotificationProducer. If a URI corresponding to a dialect appears in this resource property, a 455 subscriber is assured that a subscription request containing a valid topic expression using 456 that dialect will be accepted by the NotificationProducer. The TopicExpressionDialect 457 property is a “fixed property”, i.e. its value, for any given NotificationProducer WS-Resource, 458 does not change over time. 459/wstop:TopicSet. 460 This resource property contains the collection of topics supported by the NotificationProducer 461 expressed, as a single XML element as described in [WS-Topics]. 4624634.2 Subscribe 464A NotificationProducer is capable of producing a sequence of zero or more Notifications. A 465Subscriber can register the interest of a NotificationConsumer to receive a subset of this 466sequence. A Subscriber sends a Subscribe message to a NotificationProducer in order to register 467this interest. 468If the processing of a Subscribe message is successful, the NotificationProducer MUST produce 469a response message, as described below, containing an endpoint reference representing a 470Subscription created as a result of processing the Subscribe request. 471Sending two identical Subscribe messages to a NotificationProducer MUST result in the creation 472of two Subscriptions. The NotificationConsumer will be associated with both Subscriptions with 473the result that two copies of any matching Notification will be produced for that consumer. 474A given NotificationConsumer may be the object of more than one Subscription, and separate 475NotificationConsumers may subscribe to the same subset of Notifications. In such situations, WS- 476BaseNotification places no restrictions on the order in which Notifications are produced. 477Notifications for different NotificationConsumers may be produced in different orders, even when 478the associated subscription requests are otherwise identical, and Notifications from separate 479Subscriptions with the same NotificationConsumer may be interleaved in any manner. 480NotificationProducers MAY advertise more constrained behavior through policy assertions or 481other means. 482The format of the Subscribe message is:483 …53wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 54Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 14 of 65 55 56 484 <wsnt:Subscribe> 485 <wsnt:ConsumerReference> 486 wsa:EndpointReference 487 </wsnt:ConsumerReference> 488 <wsnt:Filter> 489 [ <wsnt:TopicExpression Dialect="xsd:anyURI"> 490 {any} ? 491 </wsnt:TopicExpression> | 492 <wsnt:ProducerProperties Dialect="xsd:anyURI"> 493 {any} ? 494 </wsnt:ProducerProperties> | 495 <wsnt:MessageContent Dialect="xsd:anyURI"> 496 {any} 497 </wsnt:MessageContent> | 498 {any} * 499 ] * 500 </wsnt:Filter> ? 501 <wsnt:InitialTerminationTime> 502 [xsd:dateTime | xsd:duration] 503 </wsnt:InitialTerminationTime> ? 504 <wsnt:SubscriptionPolicy> 505 [ <wsnt:UseRaw/> | 506 {any} 507 ] * 508 </wsnt:SubscriptionPolicy> ? 509 {any}* 510 </wsnt:Subscribe> 511 … 512The WS-Addressing [action] Message Addressing Property MUST contain the URI 513 http://docs.oasis-open.org/wsn/bw-12/NotificationProducer/SubscribeRequest. 514The components of the Subscribe message are further described as follows: 515/wsnt:Subscribe/wsnt:ConsumerReference 516 An endpoint reference element, as defined by WS-Addressing [WS-Addressing], used to 517 identify the NotificationConsumer. 518 This component SHOULD provide all the necessary information to specify how the 519 NotificationProducer should send notifications to the NotificationConsumer. However, there 520 may be cases when the ConsumerReference EPR may not include all the details that the 521 NotificationProducer expects. 522 The NotificationProducer should specify via WSDL, policy assertions, meta-data or by some 523 other means, the information it expects to be present in a ConsumerReference. If a 524 ConsumerReference does not contain sufficient information, the NotificationProducer MAY 525 choose to fault or it MAY choose to use out of band mechanisms to obtain the required 526 information. 527 In cases where the optional wsnt:UseRaw policy component is not specified, the Web service 528 identified by the endpoint reference MUST implement the message exchanges defined by 529 NotificationConsumer (i.e., the Notify message). 530/wsnt:Subscribe/wsnt:Filter 531 The Filter component is the means by which a Subscriber expresses the subset of 532 Notifications that the NotificationConsumer should receive. This subset is expressed by the 533 child elements of the Filter. The child elements are a sequence of zero or more expressions 534 evaluating to a Boolean that constrain the set of possible Notifications. Each expression is 535 evaluated in a manner specific to that kind of expression (see below); the order and timing of 57wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 58Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 15 of 65 59 60 536 the evaluation is determined by the NotificationProducer. All filter expressions MUST evaluate 537 to true in order for the notification message to be sent. 538 If no Filter component appears in a Subscribe message, then the Subscriber’s intent is for the 539 NotificationConsumer to receive every message produced by the NotificationProducer. The 540 NotificationProducer MAY reject Subscribe requests that do not contain a Filter component. 541 The NotificationProducer MUST respond with an InvalidFilterFault message if any child 542 expression element is not supported by the NotificationProducer. For example, if the 543 NotificationProducer does not support the concept of Topics, it MUST respond with an 544 InvalidFilterFault message if a Subscribe message contains a Filter component that includes 545 a TopicExpression child. The fault MUST include the filter QNames for the filters it did not 546 understand. 547 This specification defines the filters TopicExpression, ProducerProperties, and 548 MessageContent. A NotificationProducer MAY accept these filters and/or any other filters that 549 may be defined. 550/wsnt:Subscribe/wsnt:Filter/wsnt:TopicExpression 551 A filter limiting notification messages to those that are associated with at least one topic 552 matching the TopicExpression. The TopicExpression identifies one or more topics supported 553 by the NotificationProducer. 554/wsnt:Subscribe/wsnt:Filter /wsnt:TopicExpression/@Dialect 555 A REQUIRED attribute of type URI that identifies the language of the TopicExpression. WS- 556 Topics defines an initial set of standard URIs for TopicExpressions. Designers MAY define 557 and use other domain-specific URIs to identify the dialect of the TopicExpression. 558 The NotificationProducer MAY refuse to process the Subscribe request if the dialect used by 559 the Subscriber in the TopicExpression is not one of the dialects supported by the 560 NotificationProducer. 561 The NotificationProducer MUST respond with a TopicExpressionDialectUnknownFault if it 562 understands the TopicExpression element, but does not understand the specified 563 TopicExpression dialect. Note that a NotificationProducer may understand the meaning of a 564 given dialect URI without actually supporting that dialect. 565 If the TopicExpression is incompatible with or does not comply with the rules of the dialect, 566 the NotificationProducer MUST respond with a InvalidTopicExpressionFault. 567 If the TopicExpression dialect is understood and the expression references a topic which is 568 not supported by the NotificationProducer, the NotificationProducer MAY return a 569 TopicNotSupportedFault. 570/wsnt:Subscribe/wsnt:Filter /wsnt:ProducerProperties 571 This component contains a filter expression evaluated on the ResourceProperties [WS- 572 ResourceProperties] of the NotificationProducer. (if the NotificationProducer is acting as a 573 WS-Resource [WS-Resource]). The expression MUST be a Boolean expression. 574/wsnt:Subscribe/wsnt:Filter /wsnt:ProducerProperties/@Dialect 575 This attribute contains a URI specifying the type of ProducerProperties filter expression 576 contained by the element. Some standard URIs are defined by the WS-ResourceProperties 577 specification. Designers MAY define and use other domain-specific URIs to identify the 578 dialect of the ProducerProperties filter expression. 579 The NotificationProducer MAY refuse to process the Subscribe request if the Dialect used by 580 the Subscriber is not one of the dialects supported by the NotificationProducer.61wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 62Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 16 of 65 63 64 581/wsnt:Subscribe/wsnt:Filter /wsnt:MessageContent 582 A filter limiting notification messages to the set for which the specified expression evaluated 583 over the Notification Message to be produced evaluates to true. A wsnt:MessageContent 584 expression MUST evaluate to a Boolean. The evaluation context is Notification payload. 585/wsnt:Subscribe/wsnt:Filter /wsnt:MessageContent/@Dialect 586 This attribute contains a URI specifying the type of MessageContent filter expression 587 contained by the element. There are two well known dialects identified by thisThis 588 specification, identifies the XPath 1.0 dialect corresponding to two versionsversion 1.0 of the 589 XPath language. [XPATH]: 590 http://www.w3.org/TR/1999/REC-xpath-19991116 591 This URI identifies the XPath 1.0 language. The contents of the MessageContent expression 592 MUST be a string containing a valid XPath 1.0 expression. 593 http://www.w3.org/TR/2005/WD-xpath20-20050404 594 This URI identifies the Xpath 2.0 (working draft) language. The contents 595 of the MessageContent expression MUST be a string containing a valid 596 XPath 2.0 expression. Note: an additional URI will be added to represent 597 the W3C Recommendation form of the XPath 2.0 language. 598 Designers MAY define and use other domain-specific URIs to identify the dialect of the 599 MessageContent filter expression. 600 The NotificationProducer MAY refuse to process the Subscribe request if the dialect used by 601 the Subscriber is not one of the dialects supported by the NotificationProducer. 602/wsnt:Subscribe/wsnt:InitialTerminationTime 603 This component contains the service requestor’s suggestion for the initial termination time of 604 the Subscription being created. There are two forms of this component, absolute time and 605 duration. If the type of this component is xsd:dateTime, the value of the component is to be 606 interpreted as an absolute time. If the type of this component is xsd:duration, the value of the 607 component is to be interpreted as a duration to be added to the current time. All time 608 measurements are determined by the NotificationProducer. 609 The resulting absolute time, whether computed from a duration or given explicitly in the 610 request message, is used to initialize the value of the TerminationTime resource property of 611 the Subscription resource. 612 If the NotificationProducer is unable or unwilling to set the TerminationTime resource property 613 of the Subscription resource to the requested time or a value greater, or if this requested time 614 is not in the future, then the NotificationProducer MUST return an 615 UnacceptableInitialTerminationTimeFault message. 616 The use of the xsi:nil attribute with value “true” indicates there is no scheduled termination 617 time requested for the Subscription, implying that the requested Subscription has infinite 618 duration. 619 If the element does not include the time zone designation, the value of the element MUST be 620 interpreted as universal time (UTC) time. 621 If this component is not included, the initial value of the TerminationTime resource property is 622 dependent on the implementation of the NotificationProducer. 623/wsnt:Subscribe/wsnt:SubscriptionPolicy 624 This optional component is an open component intended to be used in an application specific 625 way to specify policy related requirements/assertions associated with the subscribe requests. 65wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 66Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 17 of 65 67 68 626 This mechanism could be used to govern the message rate (e.g. maximum 3 messages per 627 second), reliability of the Notification delivery, etc. The semantics of how the 628 NotificationProducer MUST or MAY react to the policy requirements and assertions 629 appearing in this component are specific to the actual policy grammar used. 630 If this component is not specified in the Subscribe request message, then the 631 NotificationProducer SHOULD use other means (such as directly contacting the 632 NotificationConsumer) to resolve any policy-related inquiries. 633/wsnt:Subscribe/wsnt:SubscriptionPolicy/wsnt:UseRaw 634 An element whose presence indicates that the NotificationProducer is to produce 635 Notifications without using the wsnt:Notify wrapper. This component is optional, if missing the 636 default behavior is to use the Notify wrapper for all notification messages. This element 637 MUST SHOULD NOT occur more than once in a Subscribe request message., as only its 638 presence or absence is significant. 639 If this element is not present then the NotificationProducer MUST use the wsnt:Notify 640 message in Notifications produced for this subscription. In this case the The presence of this 641 element is interpreted as a request for raw Notification. If raw notification is requested, then: 642  If the NotificationProducer supports this form of notification, then the NotificationProducer 643 MUST produce the raw Notification message in raw formitself. 644  If the NotificationProducer does not support this form of notification, it MUST return a 645 UnsupportedPolicyRequestFault message containing a wsnt:UseRaw QNameelement. 646 The NotificationProducer MUST NOT return an UnrecognizedPolicyRequestFault in 647 response to this element. 648 The absence of this element is interpreted as a request for notification using the wsnt:Notify 649 wrapper. If notification using the Notify wrapper is requested, then the NotificationConsumer 650 referred to in the wsnt:ConsumerReference element SHOULD implement the Notify message 651 and include a Notify operation in its portType definition., and: 652  If the NotificationProducer supports this element is presentform of notification, then the 653 NotificationProducer SHOULDMUST produce the raw Notification itself. messages using 654 the Notify wrapper 655  If the NotificationProducer does not support this form of notification, it MUST return a 656 NotifyMessageNotSupportedFault message. 657The response to the Subscribe request message is a message of the following form:658 … 659 <wsnt:SubscribeResponse> 660 <wsnt:SubscriptionReference> 661 wsa:EndpointReference 662 </wsnt:SubscriptionReference> 663 <wsnt:CurrentTime>xsd:dateTime</wsnt:CurrentTime> ? 664 <wsnt:TerminationTime>xsd:dateTime</wsnt:TerminationTime> ? 665 {any}* 666 </wsnt:SubscribeResponse> 667 … 668The WS-Addressing [action] Message Addressing Property MUST contain the URI 669 http://docs.oasis-open.org/wsn/bw-12/NotificationProducer/SubscribeResponse. 670The contents of the SubscribeResponse message are further described as follows: 671/wsnt:SubscribeResponse/wsnt:SubscriptionReference69wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 70Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 18 of 65 71 72 672 A WS-Resource reference to the Subscription WS-Resource created as a result of the 673 Subscribe message. 674/wsnt:SubscribeResponse/wsnt:CurrentTime 675 This OPTIONAL component SHOULD be returned if the SubscriptionManager uses 676 scheduled termination from WS-ResourceLifetime. The value of this component is the value 677 of the CurrentTime resource property of the Subscription at the time the response message is 678 created. 679/wsnt:SubscribeResponse/wsnt:TerminationTime 680 This OPTIONAL component SHOULD be returned if the SubscriptionManager uses 681 scheduled termination from [WS-ResourceLifetime. ]. The value of this component is the 682 value of the TerminationTime resource property of the Subscription at the time the response 683 message is created. 684If the NotificationProducer does not respond to the Subscribe request message with the 685SubscribeResponse message, then it MUST send a fault. This specification defines the following 686faults associated with failure to process the Subscribe request message: 687 688ResourceUnknownFault 689  The NotificationProducer is a WS-Resource, and the resource identified in the message 690 is not known to the Web service. This fault is specified by the WS-Resource [WS- 691 Resource] specification. 692InvalidFilterFault 693  The Subscribe message contained a filter that was not understood or supported by the 694 NotificationProducer. 695TopicExpressionDialectUnknownFault 696  The Subscribe message contained a TopicExpression filter having a dialect that was not 697 understood or supported by the NotificationProducer. 698InvalidTopicExpressionFault 699  The Subscribe message contained a TopicExpression filter where the contents of the 700 filter did not match the dialect specified. 701TopicNotSupportedFault 702  The Subscribe message contained a TopicExpression filter that referenced a topic that 703 was not supported by the NotificationProducer. 704InvalidProducerPropertiesExpressionFault 705  The Subscribe message contained a ProducerProperties filter that did not represent a 706 valid boolean expression. 707InvalidMessageContentExpressionFault 708  The Subscribe message contained a MessageContent filter that did not represent a valid 709 boolean expression. 710InvalidUseRawValueFault 711UnrecognizedPolicyRequestFault 712  The RawValue element appearedNotificationProducer does not recognize one or more 713 than oncepolicy requests carried in the SubscriptionPolicy. element. This fault 714 SHOULDMAY contain elements representing the offending policy requests. 715UnsupportedPolicyRequestFault 73wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 74Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 19 of 65 75 76 716  The NotificationProducer recognizes, but does not support one or more policy requests 717 carried in the SubscriptionPolicy element. This fault SHOULDMAY contain elements 718 representing the offending policy requests. 719NotifyMessageNotSupportedFault 720  The NotificationProducer does not support the wsnt:Notify wrapper and was not able to 721 determine an alternative. 722UnacceptableInitialTerminationTimeFault 723  The value of InitialTerminationTime specified in the Subscribe message was not 724 acceptable to the NotificationProducer. The NotificationProducer MAY include a hint in 725 the fault message indicating acceptable values for InitialTerminationTime. 726SubscribeCreationFailedFault 727  The NotificationProducer failed to process the Subscribe message. The 728 NotificationProducer SHOULD use a more specific fault message if possible. The 729 NotificationProducer MAY include a hint in the fault message indicating why it failed to 730 process the Subscribe message.7314.2.1 Example SOAP Encoding of the Subscribe Message Exchange 732The following is a non-normative example of a Subscribe request message using SOAP: 733 <s:Envelope ... > 734 <s:Header> 735 <wsa:Action> 736 http://docs.oasis-open.org/wsn/bw- 737 12/NotificationProducer/SubscribeRequest 738 </wsa:Action> 739 ... 740 </s:Header> 741 <s:Body> 742 <wsnt:Subscribe> 743 <wsnt:ConsumerReference> 744 <wsa:Address> 745 http://www.consumerexample.org/ConsumerEndpointNotificationConsumer 746 </wsa:Address> 747 </wsnt:ConsumerReference> 748 <wsnt:Filter> 749 <wsnt:TopicExpression Dialect= 750 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple"> 751 npex:SomeTopic 752 </wsnt:TopicExpression> 753 <wsnt:MessageContent 754 Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116"> 755 boolean(ncex:Producer="15") 756 </wsnt:MessageContent> 757 </wsnt:Filter> 758 <wsnt:InitialTerminationTime> 759 2005-12-25T00:00:00.00000Z 760 </wsnt:InitialTerminationTime> 761 </wsnt:Subscribe> 762 </s:Body> 763 </s:Envelope> 764 765The following is a non-normative example of a Subscribe response message using SOAP:77wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 78Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 20 of 65 79 80 766 <s:Envelope ... > 767 <s:Header> 768 <wsa:Action> 769 http://docs.oasis-open.org/wsn/bw- 770 1/2/NotificationProducer/SubscribeResponse 771 </wsa:Action> 772 ... 773 </s:Header> 774 <s:Body> 775 <wsnt:SubscribeResponse> 776 <wsnt:SubscriptionReference> 777 <wsa:Address> 778 http://www.producerexample.org/SubsMgrEndpointSubscriptionManager 779 </wsa:Address> 780 </wsnt:SubscriptionReference> 781 </wsnt:SubscribeResponse> 782 </s:Body> 783 </s:Envelope>7844.3 GetCurrentMessage 785In response to a GetCurrentMessage message, the NotificationProducer MAY return the last 786Notification published to a given Topic. This is a non-destructive read, allowing a newly- 787subscribed NotificationConsumer to get the last Notification that other NotificationConsumers 788have received. 789In certain circumstances, a NotificationProducer MAY choose to not cache the last Notification to 790one or more Topics it supports. In such cases, the NotificationProducer MUST respond with a 791fault message indicating that no current message is available on that Topic. The 792NotificationProducer MAY choose to communicate its caching policy by some means not 793specified in this document, such as using a policy assertion. 794The format of the GetCurrentMessage request message is:795 … 796 <wsnt:GetCurrentMessage> 797 <wsnt:Topic Dialect="xsd:anyURI"> 798 {any} 799 </wsnt:Topic> 800 {any} * 801 </wsnt:GetCurrentMessage> 802 … 803The WS-Addressing [action] Message Addressing Property MUST contain the URI 804 http://docs.oasis-open.org/wsn/bw-12/NotificationProducer/GetCurrentMessageRequest. 805The components of the GetCurrentMessage request message are further described as follows: 806/wsnt:GetCurrentMessage/wsnt:Topic 807 A TopicExpression that identifies exactly one Topic. 808If the NotificationProducer successfully processes the GetCurrentMessage request, it MUST 809respond with a GetCurrentMessageResponse message. This response has the following form:810 … 811 <wsnt:GetCurrentMessageResponse> 812 {any} * 813 </wsnt:GetCurrentMessageResponse> 814 …81wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 82Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 21 of 65 83 84 815The WS-Addressing [action] Message Addressing Property MUST contain the URI 816 http://docs.oasis-open.org/wsn/bw- 817 12/NotificationProducer/GetCurrentMessageResponse. 818The contents of the GetCurrentMessage response message are further described as follows: 819/wsnt:GetCurrentMessageResponse/{any} 820 Contains the last Notification associated with the Topic identified by the request message. 821If the NotificationProducer does not respond to the GetCurrentMessage request message with 822the GetCurrentMessageResponse message, then it MUST send a fault. This specification defines 823the following faults associated with failure to process the GetCurrentMessage request message: 824ResourceUnknownFault 825  The NotificationProducer is acting as a WS-Resource, and the resource identified in the 826 message (which follows the WS-Resource Access Pattern) is not known to the Web 827 service. This fault is specified by the WS-Resource [WS-Resource] specification. 828TopicExpressionDialectUnknownFault 829  The Topic element of the GetCurrentMessage message had a dialect that was not 830 understood or supported by the NotificationProducer. 831InvalidTopicExpressionFault 832  The Topic element of the GetCurrentMessage message had contents that did not match 833 the dialect specified. 834TopicNotSupportedFault 835  The Topic element of the GetCurrentMessage message referenced a topic that was not 836 supported by the NotificationProducer. 837MultipleTopicsSpecifiedFault 838  The GetCurrentMessage message referenced more than one topic. 839NoCurrentMessageOnTopicFault 840  The topic referenced in the GetCurrentMessage message does not have any pending 841 messages.8424.3.1 Example SOAP Encoding of the GetCurrentMessage Message 843 Exchange 844The following is a non-normative example of a GetCurrentMessage request message using 845SOAP: 846 <s:Envelope ... > 847 <s:Header> 848 <wsa:Action> 849 http://docs.oasis-open.org/wsn/bw- 850 1/2/NotificationProducer/GetCurrentMessageRequest 851 </wsa:Action> 852 ... 853 </s:Header> 854 <s:Body> 855 <wsnt:GetCurrentMessage> 856 <wsnt:Topic Dialect= 857 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple"> 858 npex:SomeTopic 859 </wsnt:Topic> 860 </wsnt:GetCurrentMessage>85wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 86Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 22 of 65 87 88 861 </s:Body> 862 </s:Envelope> 863The following is a non-normative example of a GetCurrentMessage response message using 864SOAP: 865 <s:Envelope ... > 866 <s:Header> 867 <wsa:Action> 868 http://docs.oasis-open.org/wsn/bw- 869 1/2/NotificationProducer/GetCurrentMessageResponse 870 </wsa:Action> 871 ... 872 </s:Header> 873 <s:Body> 874 <wsnt:GetCurrentMessageResponse> 875 <npex:NotifyContent>exampleNotifyContent</npex:NotifyContent> 876 </wsnt:GetCurrentMessageResponse> 877 </s:Body> 878 </s:Envelope>89wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 90Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 23 of 65 91 92 8795 Pull-Style Notification 880There are certain circumstances in which the basic “push-style” of NotificationMessage delivery is 881not appropriate. For example, certain NotificationConsumers are behind a firewall such that the 882NotificationProducer cannot initiate a message exchange to send the Notification. A similar 883circumstance exists for NotificationConsumers that are unable or unwilling to provide an endpoint 884to which the NotificationProducer can send Notification Messages. In other situations, the 885NotificationConsumer prefers to control the timing of receipt of Notification Messages, instead of 886receiving Notification Messages at unpredictable intervals, it may prefer to “pull” “retrieve” the 887Notification Messages at a time of its own choosing. 888For these and other reasons, WS-BaseNotification defines a pair of portTypes: a PullPoint 889interface, defining an endpoint that accumulates Notification Messages and allows a requestor to 890retrieve accumulated Notification Messages and a CreatePullPoint interface that acts as a factory 891for PullPoint resources. The intended pattern of use is that a Subscriber or other party creates a 892PullPoint through the factory interface, and then uses it as the ConsumerReference in one or 893more Subscribe requests. The actual consumer then pulls Notifications from the PullPoint.8945.1 PullPoint Interface 895In support of the “pull-style” of Notification Message delivery, this specification describes a 896PullPoint resource by defining a PullPoint interface. The PullPoint interface provides the means 897by which NotificationProducers can insert Notification Messages into the PullPoint, by which 898requestors can retrieve messages from the PullPoint and the means by which requestors can 899destroy the PullPoint. Note: the 900A PullPoint MAY be a WS-Resource, and if it is, request messages defined in this specification 901MUST follow the WS-Resource Access Pattern defined by [WS-Resource] and the PullPoint WS- 902Resource MUST support the immediate termination interface defined by WS-RF Resource 903Lifetime and it MAY support the scheduled termination interface defined by WS-RF Resource 904Lifetime. If the PullPoint supports the scheduled termination interface, the initial termination time 905is set by the factory that creates it. This termination time may be queried and set via the standard 906WS-ResourceLifetime message exchanges. PullPoints SHOULD NOT be destroyed if 907subscriptions involving them still exist. 9089095.1.1 Accumulating Notification Messages 910The PullPoint interface supports the NotificationConsumer interface (as defined in section 3). This 911interface allows NotificationProducers to send Notification Messages to the PullPoint using either 912a “raw” or a “wrappered” approach. using the Notify message format. Notification Messages 913received by the PullPoint through its NotificationConsumer interface are accumulated by the 914PullPoint on a best effort basis. If the PullPoint is no longer capable of accumulating additional 915Notification Messages, it MAY ignore Notification Messages sent to its NotificationConsumer 916interface, or it MAY dispose of any previously accumulated Notification Messages and continue to 917accumulate incoming Notification Messages. The PullPoint interface does not define additional 918constraints on its use of the NotificationConsumer interface.93wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 94Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 24 of 65 95 96 9195.1.2 GetMessages 920The PullPoint interface provides a message exchange to allow requestors to retrieve (or pull) 921Notification Messages from the PullPoint. 922If a requestor wishes to retrieve Notification Messages accumulated by the PullPoint, it sends a 923GetMessages request to the PullPoint endpoint. The format of the GetMessages request 924message is:925 926 <wsnt:GetMessages> 927 <wsnt:MaximumNumber>xsd:nonNegativeInteger</wsnt:MaximumNumber> ? 928 {any} * 929 </wsnt:GetMessages> 930 931The WS-Addressing [action] Message Addressing Property MUST contain the URI 932 http://docs.oasis-open.org/wsn/bw-12/PullPoint/GetMessagesRequest. 933The components of the GetMessages request message are further described as follows: 934/wsnt:GetMessages 935 This component requests that messages held by the PullPoint be returned. A response is 936 generated without waiting for messages to be accumulated by the PullPoint. 937/wsnt:GetMessages/wsnt:MaximumNumber 938 This optional non-negative integer indicates the maximum number of accumulated 939 Notification Messages to be returned in the response message. If the total number of 940 Notification Messages accumulated by the PullPoint is less than or equal to this number, 941 all of the Notification Messages are returned in the response message. If the total 942 number of accumulated Notification Messages exceeds this value, the PullPoint MUST 943 return exactly this number of accumulated Notification Messages; the implementation of 944 the PullPoint is free to determine which subset of messages are returned in the response 945 message in this case. If the MaximumNumber component is not present in the request 946 message, the requestor is asking to receive all messages held by the PullPoint. 947The response of the GetMessages request message is a message of the following form:948 949 <wsnt:GetMessagesResponse> 950 <wsnt:NotificationMessage /> * 951 {any} * 952 </wsnt:GetMessagesResponse> 953 954The WS-Addressing [action] Message Addressing Property MUST contain the URI 955 http://docs.oasis-open.org/wsn/bw-12/PullPoint/GetMessagesResponse. 956The contents of the GetMessages response message are further described as follows: 957/wsnt:GetMessagesResponse 958 This component contains zero or more accumulated Notification Messages. The number 959 of messages appearing is limited by the wsnt:MaximumNumber component of the 960 GetMessages request message. Each accumulated Notification Message appearing in a 961 GetMessagesResponse is “removed” from the PullPoint and MUST not appear in the 962 response message of subsequent GetMessages requests. 963/wsnt:GetMessagesResponse/wsnt:NotificationMessage97wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 98Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 25 of 65 99 100 964 The content of this component is an accumulated NotificationMessage. The 965 NotificationMessage component is described as part of the Notify message (section 3.2) 966 the GetMessagesResponse message does not define additional constraints on the 967 NotificationMessage component. If the accumulated NotificationMessage was added to 968 the PullPoint through a Notify message, the contents of the NotificationMessage is 969 exactly the contents of the NotificationMessage component of the Notify message. If the 970 accumulated NotificationMessage was added to the PullPoint through a “raw” message, 971 then the contents of the NotificationMessage is formed by inserting the body of the “raw” 972 message into the wsnt:Message component of the 973 /wsnt:GetMessagesResponse/wsnt:NotificationMessage.The content of the 974 NotificationMessage is exactly the content of the NotificationMessage component of the 975 accumulated Notify message. 976If the PullPoint does not respond to the GetMessages request message with the 977GetMessagesResponse message, then it MUST send a fault. This specification defines the 978following faults associated with failure to process the GetMessages request message: 979ResourceUnknownFault 980  The resource identified in the message (which follows the WS-Resource Access Pattern) 981 is not known to the Web service. This fault is specified by the WS-Resource [WS- 982 Resource] specification.9835.1.3 Example SOAP Encoding of the GetMessages Message 984 Exchange 985The following is a non-normative example of a GetMessages request message using SOAP: 986 <s:Envelope ... > 987 <s:Header> 988 <wsa:Action> 989 http://docs.oasis-open.org/wsn/bw-12/PullPoint/GetMessagesRequest 990 </wsa:Action> 991 ... 992 </s:Header> 993 <s:Body> 994 <wsnt:GetMessages> 995 <wsnt:MaximumNumber>10</wsnt:MaximumNumber> 996 </wsnt:GetMessages> 997 </s:Body> 998 </s:Envelope> 999The following is a non-normative example of a GetMessages response message using SOAP: 1000 <s:Envelope ... > 1001 <s:Header> 1002 <wsa:Action> 1003 http://docs.oasis-open.org/wsn/bw-12/PullPoint/GetMessagesResponse 1004 </wsa:Action> 1005 ... 1006 </s:Header> 1007 <s:Body> 1008 <wsnt:GetMessagesResponse> 1009 <wsnt:NotificationMessage> 1010 ... 1011 </wsnt:NotificationMessage> 1012 <wsnt:NotificationMessage> 1013 ... 1014 </wsnt:NotificationMessage>101wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 102Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 26 of 65 103 104 1015 </wsnt:GetMessagesResponse> 1016 </s:Body> 1017 </s:Envelope>10185.1.4 DestroyPullPoint 1019The PullPoint interface provides a destroy operation, providing a means by which a requestor can 1020terminate the PullPoint resource. To terminate a PullPoint resource, a requestor MUST send a 1021DestroyDestroyPullPoint request message to the PullPoint. The DestroyDestroyPullPoint request 1022message has the following form:1023 1024 <wsnt:DestroyPullPoint> 1025 {any} * 1026 </wsnt:DestroyPullPoint> 1027 1028The WS-Addressing [action] Message Addressing Property MUST contain the URI 1029 http://docs.oasis-open.org/wsn/bw- 1030 12/PullPoint/DestroyRequest.DestroyPullPointRequest. 1031Upon receipt of the DestroyDestroyPullPoint request, the PullPoint MUST attempt to destroy 1032itself. If the DestroyDestroyPullPoint request message is successfully processed, the PullPoint 1033MUST respond with the following message:1034 1035 <wsnt:DestroyResponseDestroyPullPointResponse> 1036 {any} * 1037 </wsnt:DestroyResponseDestroyPullPointResponse> 1038 1039The WS-Addressing [action] Message Addressing Property MUST contain the URI 1040 http://docs.oasis-open.org/wsn/bw- 1041 12/PullPoint/DestroyResponse.DestroyPullPointResponse. 1042If the PullPoint does not respond to the DestroyDestroyPullPoint request message with the 1043DestroyResponseDestroyPullPointResponse message, then it MUST send a fault. This 1044specification defines the following faults associated with failure to process the 1045DestroyDestroyPullPoint request message: 1046UnableToDestroyPullPointFault. 1047  The PullPoint was unable to destroy the PullPoint resource for some reason..10485.1.5 Example SOAP Encoding of the DestroyDestroyPullPoint 1049 Message Exchange 1050The following is a non-normative example of a DestroyDestroyPullPoint request message using 1051SOAP: 1052 <s:Envelope ... > 1053 <s:Header> 1054 <wsa:Action> 1055 http://docs.oasis-open.org/wsn/bw- 1056 12/PullPoint/DestroyRequestDestroyPullPointRequest 1057 </wsa:Action> 1058 ... 1059 </s:Header>105wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 106Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 27 of 65 107 108 1060 <s:Body> 1061 <wsnt:DestroyPullPoint/> 1062 </s:Body> 1063 </s:Envelope> 1064The following is a non-normative example of a DestroyDestroyPullPoint response message using 1065SOAP: 1066 <s:Envelope ... > 1067 <s:Header> 1068 <wsa:Action> 1069 http://docs.oasis-open.org/wsn/bw- 1070 12/PullPoint/DestroyResponseDestroyPullPointResponse 1071 </wsa:Action> 1072 ... 1073 </s:Header> 1074 <s:Body> 1075 <wsnt:DestroyResponseDestroyPullPointResponse/> 1076 </s:Body> 1077 </s:Envelope>10785.2 Create PullPoint Interface 1079This specification describes a CreatePullPoint interface standardizing the means by which a 1080PullPoint resource is created. 1081If a requestor wishes to create a new PullPoint resource, it MUST send a CreatePullPoint request 1082to an endpoint supporting the PullPoint interface. The CreatePullPoint request message has the 1083following form:1084 1085 <wsnt:CreatePullPoint> 1086 {any} * 1087 </wsnt:CreatePullPoint> 1088 1089The WS-Addressing [action] Message Addressing Property MUST contain the URI 1090 http://docs.oasis-open.org/wsn/bw-12/CreatePullPoint/CreatePullPointRequest 1091Upon receipt of the CreatePullPoint request, the receiver MUST attempt to create a new PullPoint 1092resource. If the CreatePullPoint request message is successfully processed, the receiver MUST 1093respond with the following message:1094 1095 <wsnt:CreatePullPointResponse> 1096 <wsnt:PullPoint>wsa:EndpointReferenceType</wsnt:PullPoint> 1097 {any} * 1098 </wsnt:CreatePullPointResponse> 1099 1100The WS-Addressing [action] Message Addressing Property MUST contain the URI 1101 http://docs.oasis-open.org/wsn/bw-1/CreatePullPoint/CreatePullPointResponse. 1102 http://docs.oasis-open.org/wsn/bw-2/CreatePullPoint/CreatePullPointResponse. 1103The contents of the CreatePullPoint response message are further described as follows: 1104/wsnt:CreatePullPointResponse/wsnt:PullPoint109wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 110Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 28 of 65 111 112 1105 This component is an EndpointReference, as defined by WS-Addressing, that is a 1106 reference to the PullPoint resource created during the processing of the CreatePullPoint 1107 request message. 1108A PullPoint created by the CreatePullPoint operation MAY choose to ignore Notifications received 1109through the NotificationConsumer interface. A Pull Point MAY accumulate Notifications through 1110other, implementation-defined mechanisms. Pull point factories SHOULD indicate through policy 1111assertions whether pull points they create will ignore Notifications received through the 1112NotificationConsumer interface. 1113 If the receiver does not respond to the CreatePullPoint request message with the 1114CreatePullPointResponse message, then it MUST send a fault. This specification defines the 1115following faults associated with failure to process the DestroyDestroyPullPoint request message: 1116  UnableToCreatePullPointFault. 111711185.2.1 Example SOAP Encoding of the CreatePullPoint Message 1119 Exchange 1120The following is a non-normative example of a CreatePullPoint request message using SOAP: 1121 <s:Envelope ... > 1122 <s:Header> 1123 <wsa:Action> 1124 http://docs.oasis-open.org/wsn/bw-12/PullPoint/CreatePullPointRequest 1125 </wsa:Action> 1126 ... 1127 </s:Header> 1128 <s:Body> 1129 <wsnt:CreatePullPoint/> 1130 </s:Body> 1131 </s:Envelope> 1132The following is a non-normative example of a CreatePullPoint response message using SOAP: 1133 <s:Envelope ... > 1134 <s:Header> 1135 <wsa:Action> 1136 http://docs.oasis-open.org/wsn/bw-12/PullPoint/CreatePullPointResponse 1137 </wsa:Action> 1138 ... 1139 </s:Header> 1140 <s:Body> 1141 <wsnt:CreatePullPointResponse> 1142 <wsnt:PullPoint> 1143 <wsa:Address>...</wsa:Address> 1144 ... 1145 </wsnt:PullPoint> 1146 </wsnt:CreatePullPointResponse> 1147 </s:Body> 1148 </s:Envelope>113wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 114Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 29 of 65 115 116 11496 SubscriptionManager Interface 1150The SubscriptionManager interface defines message exchanges to manipulate Subscription 1151resources. There are two styles of SubscriptionManager interface: base and pausable. All 1152SubscriptionManagers MUST implement the message exchanges described in the Base 1153Subscription Manager section. 1154For those environments that choose to implement a Subscription as a WS-Resource, the 1155SubscriptionManager MUST implement the resource properties and message exchanges defined 1156in Subscriptions as WS-Resources section. Both the Base Subscription Manager and the 1157Pausable Subscription Manager MAY expose Subscriptions as WS-Resources.11586.1 Base Subscription Manager 1159The basic behavior of a SubscriptionManager is to renew the duration of a Subscription resource 1160and terminate a Subscription. 11616.1.1 Renew 1162To modify the current lifetime of a Subscription, a requestor sends a Renew request message to 1163the SubscriptionManager. The Renew request message MUST have the following form:1164 … 1165 <wsnt:Renew> 1166 <wsnt:TerminationTime> 1167 [xsd:dateTime | xsd:duration] 1168 </wsnt:TerminationTime> 1169 {any} 1170 </wsnt:Renew> 1171 … 1172The WS-Addressing [action] Message Addressing Property MUST contain the URI 1173 http://docs.oasis-open.org/wsn/bw-12/SubscriptionManager/RenewRequest. 1174The components of the Renew request message are further described as follows: 1175/wsnt:Renew/wsnt:TerminationTime 1176 This component contains the service requestor’s suggestion for change in expiration, or 1177 termination time of the Subscription resource. There are two forms of this component, 1178 absolute time and duration. If the type of this component is xsd:dateTime, the value of the 1179 component is to be interpreted as an “absolute time”. If the type of this component is 1180 xsd:duration, the value of the component is to be interpreted as a “duration”. 1181 The duration form is used to “compute” the “absolute time” form in the following fashion. The 1182 value of this component in “absolute time” form is computed by adding the xsd:duration value 1183 to the current time value of the SubscriptionManager. 1184 The “absolute time” form (whether computed from a duration, or contained within the request 1185 message) is used to reset the value of the expiration or termination time component of the 1186 Subscription resource. 1187 If the SubscriptionManager is unable or unwilling to reset the termination time component of 1188 the Subscription resource to the given value of the “absolute time” form or a value greater, 117wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 118Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 30 of 65 119 120 1189 then the Renew request MUST fault. If the value is not “in the future” relative to the current 1190 time as known by the SubscriptionManager, the Renew request MUST fault. 1191 The use of the xsi:nil attribute with value “true” indicates there is no scheduled termination 1192 time requested for the Subscription, implying that the Subscription should be renewed to have 1193 an infinite duration. If the element does not include the time zone designation, the value of the 1194 element MUST be interpreted as universal time (UTC) time. 1195If the SubscriptionManager successfully processes the Renew request message, it MUST 1196respond with a RenewResponse message. This response has the following form:1197 … 1198 <wsnt:RenewResponse> 1199 <wsnt:TerminationTime>xsd:dateTime</wsnt:TerminationTime> 1200 <wsnt:CurrentTime>xsd:dateTime</wsnt:CurrentTime>? 1201 {any} 1202 </wsnt:RenewResponse> 1203 … 1204The WS-Addressing [action] Message Addressing Property MUST contain the URI 1205 http://docs.oasis-open.org/wsn/bw-12/SubscriptionManager/RenewResponse. 1206The contents of the RenewResponse message are further described as follows: 1207/wsnt:RenewResponse/wsnt:TerminationTime 1208 The value of this component is the value of the termination time component of the 1209 Subscription at the time the response message is created. 1210/wsnt:RenewResponse/wsnt:CurrentTime 1211 This OPTIONAL component contains the value of the CurrentTime according to the 1212 SubscriptionManager at the time the response message is created. 1213If the SubscriptionManager does not respond to the Renew request message with the 1214RenewResponse message, then it MUST send a fault. This specification defines the following 1215faults associated with failure to process the Renew request message: 1216ResourceUnknownFault 1217  The SubscriptionManager is acting as a WS-Resource, and the resource identified in the 1218 message (which follows the WS-Resource Access Pattern) is not known to the Web 1219 service. This fault is specified by the WS-Resource [WS-Resource] specification. 1220UnacceptableTerminationTimeFault 1221  The value of InitialTerminationTime specified in the Subscribe message was not 1222 acceptable to the NotificationProducer. The NotificationProducer MAY include a hint in 1223 the fault message indicating acceptable values for InitialTerminationTime.1224 6.1.1.1 Example SOAP Encoding of the Renew Message Exchange 1225The following is a non-normative example of a Renew request message using SOAP: 1226 <s:Envelope ... > 1227 <s:Header> 1228 <wsa:Action> 1229 http://docs.oasis-open.org/wsn/bw-1/2/SubscriptionManager/RenewRequest 1230 </wsa:Action> 1231 ... 1232 </s:Header> 1233 <s:Body> 1234 <wsnt:Renew>121wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 122Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 31 of 65 123 124 1235 <wsnt:TerminationTime>P1D</wsnt:TerminationTime> 1236 </wsnt:Renew> 1237 </s:Body> 1238 </s:Envelope> 1239The following is a non-normative example of a Renew response message using SOAP: 1240 <s:Envelope ... > 1241 <s:Header> 1242 <wsa:Action> 1243 http://docs.oasis-open.org/wsn/bw-1/2/SubscriptionManager/RenewResponse 1244 </wsa:Action> 1245 ... 1246 </s:Header> 1247 <s:Body> 1248 <wsnt:RenewResponse> 1249 <wsnt:TerminationTime> 1250 2005-12-26T00:00:00.00000Z 1251 </wsnt:TerminationTime> 1252 </wsnt:RenewResponse> 1253 </s:Body> 1254 </s:Envelope>12556.1.2 Unsubscribe 1256To terminate a Subscription, a requestor sends an Unsubscribe request message to the 1257SubscriptionManager. The Unsubscribe request message MUST have the following form:1258 … 1259 <wsnt:Unsubscribe> 1260 {any} 1261 </wsnt:Unsubscribe> 1262 … 1263The WS-Addressing [action] Message Addressing Property MUST contain the URI 1264 http://docs.oasis-open.org/wsn/bw-12/SubscriptionManager/UnsubscribeRequest. 1265Upon receipt of the Unsubscribe request, the SubscriptionManager MUST attempt to destroy the 1266Subscription resource. If the SubscriptionManager successfully processes the Unsubscribe 1267request message, it MUST respond with the following message:1268 … 1269 <wsnt:UnsubscribeResponse> 1270 {any} 1271 </wsnt:UnsubscribeResponse> 1272 … 1273The WS-Addressing [action] Message Addressing Property MUST contain the URI 1274 http://docs.oasis-open.org/wsn/bw-12/SubscriptionManager/UnsubscribeResponse. 1275If the SubscriptionManager does not respond to the Unsubscribe request message with the 1276UnsubscribeResponse message, then it MUST send a fault. This specification defines the 1277following faults associated with failure to process the Unsubscribe request message: 1278ResourceUnknownFault 1279  The SubscriptionManager is acting as a WS-Resource, and the resource identified in the 1280 message (which follows the WS-Resource Access Pattern) is not known to the Web 1281 service. This fault is specified by the WS-Resource [WS-Resource] specification. 1282UnableToDestroySubscriptionFault 125wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 126Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 32 of 65 127 128 1283  The SubscriptionManager was unable to destroy the Subscription resource for some 1284 reason.1285 6.1.2.1 Example SOAP Encoding of the Unsubscribe Message 1286 Exchange 1287The following is a non-normative example of an Unsubscribe request message using SOAP: 1288 <s:Envelope ... > 1289 <s:Header> 1290 <wsa:Action> 1291 http://docs.oasis-open.org/wsn/bw- 1292 1/2/SubscriptionManager/UnsubscribeRequest 1293 </wsa:Action> 1294 ... 1295 </s:Header> 1296 <s:Body> 1297 <wsnt:Unsubscribe /> 1298 </s:Body> 1299 </s:Envelope> 1300The following is a non-normative example of an Unsubscribe response message using SOAP: 1301 <s:Envelope ... > 1302 <s:Header> 1303 <wsa:Action> 1304 http://docs.oasis-open.org/wsn/bw- 1305 1/2/SubscriptionManager/UnsubscribeResponse 1306 </wsa:Action> 1307 ... 1308 </s:Header> 1309 <s:Body> 1310 <wsnt:UnsubscribeResponse /> 1311 </s:Body> 1312 </s:Envelope>13136.2 Pausable Subscription Manager 1314A Pausable Subscription Manager implements all the message exchanges defined in the Base 1315Subscription Manager and augments this with a set of advanced capabilities to allow third parties 1316to pause and resume subscriptions.13176.2.1 PauseSubscription 1318To temporarily suspend the production of Notifications on the given Subscription, a requestor 1319MAY send a PauseSubscription request message to the SubscriptionManager. The 1320PauseSubscription request message has the following form:1321 … 1322 <wsnt:PauseSubscription>{any}</wsnt:PauseSubscription> 1323 … 1324The WS-Addressing [action] Message Addressing Property MUST contain the URI 1325 http://docs.oasis-open.org/wsn/bw-12/SubscriptionManager/PauseSubscriptionRequest. 1326Upon successful processing of this message the Subscription is in the paused state. Production 1327of Notifications can be resumed by sending the ResumeSubscription request message (see 6.3).129wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 130Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 33 of 65 131 132 1328In an asynchronous implementation, a NotificationProducer may continue producing notifications 1329while the PauseSubscription request is in transit. In general, there is no way of knowing exactly 1330when the pause will take effect. 1331Note: transitioning between the paused state and the resumed state has no effect on the 1332TerminationTime of the Subscription resource. A Subscription’s TerminationTime may elapse 1333while it is in a paused state, initiating the scheduled destruction of the Subscription resource. 1334When a Subscription is resumed after having been paused, the NotificationProducer MAY choose 1335from one of the courses of action listed below, or any other action. NotificationProducers MAY 1336advertise their behavior in this situation via policy assertions. In the absence of a specific policy 1337assertion, Subscribers SHOULD NOT assume any particular behavior on the part of the 1338NotificationProducer. Possible actions include 1339 1. Produce Notifications for all the Situations related to the Subscription that occurred while 1340 the Subscription was paused (as well as for any new Situations that occur after the 1341 Subscription has been resumed). 1342 2. Produce a Notification for the last Situation that occurred while the Subscription was 1343 paused (as well as for any new situations that occur after the topic has been resumed). 1344 3. Produce no Notifications until a Situation occurs after the Subscription has been 1345 resumed. 1346If the SubscriptionManager accepts the PauseSubscription request message, it MUST respond 1347with a message of the following form:1348 … 1349 <wsnt:PauseSubscriptionResponse>{any}</wsnt:PauseSubscriptionResponse> 1350 … 1351The WS-Addressing [action] Message Addressing Property MUST contain the URI 1352 http://docs.oasis-open.org/wsn/bw- 1353 12/SubscriptionManager/PauseSubscriptionResponse. 1354If the SubscriptionManager does not respond to the PauseSubscription request message with the 1355PauseSubscription response message, then it MUST send a fault. This specification defines the 1356following faults associated with failure to process the PauseSubscription request message: 1357ResourceUnknownFault 1358  The resource identified in the message is not known to the Web service. This fault is 1359 specified by the WS-Resource [WS-Resource] specification. 1360PauseFailedFault 1361  The Pause operation could not be performed on the Subscription.13626.2.2 Example SOAP Encoding of the PauseSubscription Message 1363 Exchange 1364The following is a non-normative example of a PauseSubscription request message using SOAP: 1365 <s:Envelope ... > 1366 <s:Header> 1367 <wsa:Action> 1368 http://docs.oasis-open.org/wsn/bw- 1369 1/2/SubscriptionManager/PauseSubscriptionRequest 1370 </wsa:Action> 1371 ... 1372 </s:Header> 1373 <s:Body>133wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 134Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 34 of 65 135 136 1374 <wsnt:PauseSubscription/> 1375 </s:Body> 1376 </s:Envelope> 1377The following is a non-normative example of a PauseSubscription response message using 1378SOAP: 1379 <s:Envelope ... > 1380 <s:Header> 1381 <wsa:Action> 1382 http://docs.oasis-open.org/wsn/bw- 1383 1/2/SubscriptionManager/PauseSubscriptionResponse 1384 </wsa:Action> 1385 ... 1386 </s:Header> 1387 <s:Body> 1388 <wsnt:PauseSubsciptionResponse/> 1389 </s:Body> 1390 </s:Envelope>13916.3 ResumeSubscription 1392If a requestor wishes to resume the production of Notifications on the given Subscription, it must 1393send a ResumeSubscription request message. The ResumeSubscription request message has 1394the following form:1395 … 1396 <wsnt:ResumeSubscription> 1397 {any} 1398 </wsnt:ResumeSubscription> 1399 … 1400The WS-Addressing [action] Message Addressing Property MUST contain the URI 1401 http://docs.oasis-open.org/wsn/bw- 1402 12/SubscriptionManager/ResumeSubscriptionRequest. 1403Upon successful processing of this message the Subscription is no longer in the paused state. 1404If a Subscription is not in the paused state, and it is the subject of a ResumeSubscription request 1405message, no change occurs. 1406If the SubscriptionManager accepts the ResumeSubscription request message, it MUST respond 1407with a message of the following form:1408 … 1409 <wsnt:ResumeSubscriptionResponse> 1410 {any} 1411 </wsnt:ResumeSubscriptionResponse> 1412 … 1413The WS-Addressing [action] Message Addressing Property MUST contain the URI 1414 http://docs.oasis-open.org/wsn/bw- 1415 12/SubscriptionManager/ResumeSubscriptionResponse. 1416If the SubscriptionManager does not respond to the ResumeSubscriptionMessage request 1417message with the ResumeSubscriptionResponse message, then it MUST send a fault. This 1418specification defines the following faults associated with failure to process the 1419ResumeSubscriptionMessage request message: 1420ResourceUnknownFault137wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 138Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 35 of 65 139 140 1421  The resource identified in the message is not known to the Web service. This fault is 1422 specified by the WS-Resource [WS-Resource] specification. 1423ResumeFailedFault 1424  The Resume operation could not be performed on the Subscription.14256.3.1 Example SOAP Encoding of the ResumeSubscription Message 1426 Exchange 1427The following is a non-normative example of a ResumeSubscription request message using 1428SOAP: 1429 <s:Envelope ... > 1430 <s:Header> 1431 <wsa:Action> 1432 http://docs.oasis-open.org/wsn/bw- 1433 1/2/SubscriptionManager/ResumeSubscriptionRequest 1434 </wsa:Action> 1435 ... 1436 </s:Header> 1437 <s:Body> 1438 <wsnt:ResumeSubscription/> 1439 </s:Body> 1440 </s:Envelope> 1441The following is a non-normative example of a ResumeSubscription response message using 1442SOAP: 1443 <s:Envelope ... > 1444 <s:Header> 1445 <wsa:Action> 1446 http://docs.oasis-open.org/wsn/bw- 1447 1/2/SubscriptionManager/ResumeSubscriptionResponse 1448 </wsa:Action> 1449 ... 1450 </s:Header> 1451 <s:Body> 1452 <wsnt:ResumeSubsciptionResponse/> 1453 </s:Body> 1454 </s:Envelope>14556.4 Subscriptions as WS-Resources 1456Either Base Subscription Managers or Pausable Subscription Managers MAY expose 1457subscriptions as WS-Resources. A Subscription Manager that exposes Subscriptions as WS- 1458Resources MUST support the required message exchanges associated with the WS- 1459ResourceProperties specification [WS-ResourceProperties] and MAY support the optional 1460message exchanges defined by WS-ResourceProperties. 1461It is RECOMMENDED that Subscription Managers that expose Subscriptions as WS-Resources 1462support the message exchanges and resource properties defined for both forms of resource 1463lifetime (immediate and scheduled destruction) by WS-ResourceLifetime [WS-ResourceLifetime]. 1464These message exchanges MAY be used to define the means by which Subscription resources 1465can be explicitly destroyed, or destroyed using a scheduled (time-based) mechanism. Such 1466Subscription Managers MAY support other means of destroying subscriptions. 1467Subscription Managers MUST (for example in its WSDL definition) declare to requestors which 1468means of Subscription destruction is supported.141wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 142Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 36 of 65 143 144 14696.4.1 Subscription Resource Properties 1470In cases where subscriptions are exposed as WS-Resources, this specification defines several 1471resource properties, which MUST conform to the following schema fragment for content:.1472 … 1473 targetNamespace="http://docs.oasis-open.org/wsn/b-12" 1474 … 1475 1476 <xsd:element name="ConsumerReference" 1477 type="wsa:EndpointReferenceType" /> 1478 <xsd:element name="Filter" 1479 type="wsnt:FilterType" /> 1480 <xsd:element name="SubscriptionPolicy" 1481 type="wsnt:SubscriptionPolicyType" /> 1482 <xsd:element name="CreationTime" 1483 type="xsd:dateTime" /> 1484These properties must also conform to the following schema fragment for cardinality: 1485 <xsd:element ref="wsnt:ConsumerReference" 1486 minOccurs="1" maxOccurs="1" /> 1487 <xsd:element ref="wsnt:Filter" 1488 minOccurs="0" maxOccurs="1" /> 1489 <xsd:element ref="wsnt:SubscriptionPolicy" 1490 minOccurs="0" maxOccurs="1" /> 1491 <xsd:element ref="wsnt:CreationTime" 1492 minOccurs="0" maxOccurs="1" /> 1493These Resource Property elements are further described as follows: 1494/wsnt:ConsumerReference and /wsnt:Filter and /wsnt:SubscriptionPolicy 1495 These elements are as defined in the description of the Subscribe request message (see 1496 4.2). SubscriptionManagers MAY prohibit any combination of these properties from being set. 1497 If setting a given property is disallowed, the SubscriptionManager MUST fault on receiving a 1498 request to change it. SubscriptionManagers SHOULD describe using metadata techniques 1499 defined by WS-ResourceFramework which properties may be set. 1500 If any of these properties is settable, it is implementation dependent whether production of 1501 notifications will be attempted without interruption when a change is made. The 1502 SubscriptionManager may choose to treat the change in properties as equivalent to a 1503 cancellation followed by the creation of a new subscription. In this case, messages may 1504 potentially be lost in the interim. 1505 A SubscriptionManager MAY choose to provide a stronger guarantee of continuity of 1506 notification production, and if so it SHOULD advertise this capability, for example in a policy 1507 assertion. In the absence of any such policy assertion, a subscriber SHOULD NOT make 1508 any assumption of continuity. 1509/wsnt:CreationTime 1510 Indicates the date and time at which the Subscription was created. This is an optional 1511 component, supporting resource constrained devices which cannot associate a creation time 1512 with subscription resources they create. This property is read-only. SubscriptionManagers 1513 MUST fault on receiving a request to change it. 1514If the SubscriptionManager also accepts the SetResourceProperties request message as defined 1515in WS-ResourceProperties, the following properties MAY be modified by the requestor: 1516 /wsnt:ConsumerReference and /wsnt:Filter and /wsnt:SubscriptionPolicy145wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 146Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 37 of 65 147 148 15177 Security Considerations 1518This section deals with the security aspects of WS-BaseNotification. It deals with (a) securing the 1519message exchanges defined in this specification, and (b) authorization and denial of service 1520considerations specific to the Notification pattern.15217.1 Securing the Message Exchanges 1522In the Notification pattern, Notifications are sent to a NotificationConsumer, Subscribers 1523exchange SubscriptionRequest and SubscriptionResponse messages with NotificationProducers, 1524and any party with access to a SubscriptionManager endpoint may perform operations on the 1525underlying Subscription resources. In cases where this communication must be secured it is 1526RECOMMENDED that this be done using the mechanisms described in WS-Security. 1527Communication between a NotificationProducer and NotificationConsumer will typically comprise 1528a number of Notification messages. In cases where this communication must be secure, it is 1529RECOMMENDED that a security context be established, allowing for potentially more efficient 1530means of authentication. Note that the keys used to secure this channel may differ from any keys 1531used in the Subscribe request/response operation that created the associated Subscription.15327.2 Securing Subscriptions and Notifications 1533As WS-BaseNotification provides mechanisms for subscribing to topics, security policies should 1534be established such that 1535 1. only authorized principals can subscribe to receive Notifications 1536 2. only authorized principals can modify or delete Subscriptions 1537It is recommended that the authorization policies be specified at the granularity of the Topic, if 1538Topics are supported. It should be noted that even though Subscriptions may be done by 1539authorized principals, the Notifications may be produced for NotificationConsumers whose 1540identity may be different from the Subscriber. Message protection policies as outlined in the 1541previous section can be used to ensure that sensitive Notifications are not delivered to malicious 1542endpoints. For example, a key may need to be specified or generated during the process of 1543Subscription, so that the Notifications can be encrypted using the key to ensure confidentiality of 1544the messages. The mechanism by which the key is specified is governed by the Subscription 1545policy. 1546Given that WS-BaseNotification may use WS-ResourceProperties and WS-ResourceLifetime, the 1547security considerations outlined in WS-those specifications need to be taken into account where 1548appropriate. Authorization policies for those Resource Properties should be put in place so that 1549the implications of providing the state information (through GetResourceProperty request 1550messages) or through notification of state change and modification of the resource properties 1551(through SetResourceProperty request messages), are taken into account. 1552This specification provides a mechanism by which Subscribers can specify a subscription policy. 1553Such a policy may contain security policy about protecting the message exchanges resulting from 1554the Subscription. Security policy for Subscription message exchanges needs to take this into 1555consideration so that the Subscription policies are protected. Also, given this policy may be 1556contained in the resource properties of the subscription maintained by the SubscriptionManager, 1557the resource properties must be appropriately secured. 1558In addition to the usual concerns of authorization and message integrity which apply to all web 1559services, notification presents issues all its own due to the third-party nature of subscription. 149wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 150Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 38 of 65 151 152 1560Since the NotificationProducer is agreeing to produce Notifications for a consumer based on the 1561requests of a Subscriber, it must assure itself that there is no harm in producing these 1562Notifications. A malicious Subscriber may request Notifications be sent to a party that is not 1563authorized to receive them. It may also mount DOS attacks by requesting large volumes of 1564Notifications be sent to parties that cannot handle them. 1565 1566The NotificationProducer may address these risks in many different ways, including but not 1567limited to: 1568  Simply trusting all Subscribers, perhaps because all parties are known to be on a closed, 1569 trusted, network, or because the consequences of unauthorized Subscriptions are 1570 otherwise known to be negligible. 1571  Requiring all Subscribers to provide secure credentials proving that they are trusted to 1572 make subscriptions. 1573  Refusing to produce notifications for NotificationConsumers that are not known to be 1574 authorized. 1575  Explicitly confirming with NotificationConsumers whether they wish to receive the 1576 Notifications that the Subscriber has requested. 1577  Some combination of the above, depending on the identity of the Subscriber and 1578 NotificationProducer 1579NotificationProducers SHOULD advertise, whether through policy assertions or other means, 1580what security measures they take.153wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 154Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 39 of 65 155 156 15818 References15828.1 Normative 1583 [RFC2119] S. Bradner, Key words for use in RFCs to Indicate Requirement Levels, 1584 http://www.ietf.org/rfc/rfc2119.txt, IETF RFC 2119, March 1997. 1585 [URI] T. Berners-Lee, R. Fielding, L. Masinter, "Uniform Resource Identifiers 1586 (URI): Generic Syntax," RFC 2396, MIT/LCS, U.C. Irvine, Xerox 1587 Corporation, August 1998. 1588 [WS-Addressing] http://www.w3.org/TR/ws-addr-core 1589 [WS-BrokeredNotification]http://docs.oasis-open.org/wsn/wsn-WS-BrokeredNotification- 1590 1.3-cd-0102.pdf 1591 [WS-Resource] http://docs.oasis-open.org/wsrf/wsrf-ws_resource-1.2-spec-cdpr-021.pdf 1592 [WS-ResourceLifetime] http://docs.oasis-open.org/wsrf/wsrf-ws_resource_lifetime-1.2- 1593 spec-cd-01pr-02.pdf 1594 [WS-ResourceProperties] http://docs.oasis-open.org/wsrf/wsrf-ws_resource_properties-1.2- 1595 spec-cd-01.pdf 1596 [WS-ResourceProperties] http://docs.oasis-open.org/wsrf/wsrf-ws_resource_properties-1.2- 1597 spec-pr-02.pdf 1598 [WS-BaseFaults] http://docs.oasis-open.org/wsrf/wsrf-ws_base_faults-1.2-spec-pr-02.pdf 1599 [WS-Topics] http://docs.oasis-open.org/wsn/wsn-WS-Topics-1.3-cd-01.pdf 1600 [XML-Infoset] http://www.w3.org/TR/xml-infoset/ 1601 [XPATH] http://www.w3.org/TR/xpath16028.2 Non-Normative 1603 [SOAP 1.1] http://www.w3.org/TR/SOAP 1604 [SOAP 1.2] http://www.w3.org/TR/soap12-part1/ 1605 [WS-Security] http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap- 1606 message-security-1.0.pdf157wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 158Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 40 of 65 159 160 1607Appendix A. Acknowledgments1608Special thanks to the Global Grid Forum’s Open Grid Services Infrastructure working group, 1609which defined the OGSI v1.0 [OGSI] specification which was a large inspiration for the ideas 1610expressed in this specification. 1611The following individuals were members of the committee during the development of this 1612specification: 1613 1614Sid Askary, Fred Carter (AmberPoint), Martin Chapman (Oracle), Dave Chappell (Sonic 1615Software), Rick Cobb (KnowNow), Ugo Corda (SeeBeyond Technology Corporation), John Fuller, 1616Stephen Graham (IBM), David Hull (Tibco), Hideharu Kato (Hitachi), Lily Liu (webMethods, Inc.), 1617Tom Maguire (IBM), Susan Malaika (IBM), Samuel Meder (Argonne National Laboratory), Bryan 1618Murray (Hewlett-Packard), Peter Niblett (IBM), Sanjay Patil (SAP), Mark Peel (Novell), Matt 1619Roberts (IBM), Igor Sedukhin (Computer Associates), David Snelling (Fujitsu), Latha Srinivasan 1620(Hewlett-Packard), William Vambenepe (Hewlett-Packard) and Kirk Wilson (Computer 1621Associates). 1622 1623In addition, the following people made contributions to this specification: 1624Tim Banks (IBM), Nick Butler (IBM), Doug Davis (IBM), John Dinger (IBM), Don Ferguson (IBM), 1625Jeff Frey (IBM), Andreas Koeppel (SAP), Heather Kreger (IBM), Amy Lewis (TIBCO Software), 1626Kevin Liu (SAP), Nataraj Nagaratnam (IBM), Martin Nally (IBM), Jeff Nick (IBM), Jay Parikh 1627(Akamai Technologies), Claus von Riegen (SAP), Rick Rineholt (IBM), John Rofrano (IBM), 1628Shivajee Samdarshi (TIBCO Software), Eugène Sindambiwe (SAP), Jay Unger (IBM), Bill Weihl 1629(Akamai Technologies), Mark Weitzel (IBM), and Dan Wolfson (IBM).161wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 162Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 41 of 65 163 164 1630Appendix B. XML Schema1631The XML types and elements used in this specification are defined in the following XML Schema: 1632 <?xml version="1.0" encoding="UTF-8"?> 1633  1679 1680 <xsd:schema 1681 targetNamespace="http://docs.oasis-open.org/wsn/b-1"2" 1682 xmlns:wsnt="http://docs.oasis-open.org/wsn/b-1"2" 1683 xmlns:wsa="http://www.w3.org/2005/0308/addressing" 1684 xmlns:wsrf-bf="http://docs.oasis-open.org/wsrf/bf-1"2"165wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 166Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 42 of 65 167 168 1685 xmlns:wstop="http://docs.oasis-open.org/wsn/t-1" 1686 xmlns:xsd="http://www.w3.org/2001/XMLSchema" 1687 elementFormDefault="qualified" attributeFormDefault="unqualified"> 1688 1689  1690 1691 <xsd:import namespace="http://www.w3.org/2005/0308/addressing" 1692 schemaLocation="http://www.w3.org/2005/0308/addressing/ws- 1693 addr.xsd" 1694 /> 1695 1696 <xsd:import namespace="http://docs.oasis-open.org/wsrf/bf-1"2" 1697 schemaLocation="http://docs.oasis-open.org/wsrf/bf-12.xsd" 1698 /> 1699 <xsd:import namespace="http://docs.oasis-open.org/wsn/t-1" 1700 schemaLocation="http://docs.oasis-open.org/wsn/t-1.xsd" 1701 /> 1702 1703  1704 1705 <xsd:complexType name="QueryExpressionType" mixed="true"> 1706 <xsd:sequence> 1707 <xsd:any minOccurs="0" maxOccurs="1" processContents="lax" /> 1708 </xsd:sequence> 1709 <xsd:attribute name="Dialect" type="xsd:anyURI" use="required"/> 1710 </xsd:complexType> 1711 1712 <xsd:complexType name="TopicExpressionType" mixed="true"> 1713 <xsd:sequence> 1714 <xsd:any minOccurs="0" maxOccurs="1" processContents="lax" /> 1715 </xsd:sequence> 1716 <xsd:attribute name="Dialect" type="xsd:anyURI" use="required" /> 1717 <xsd:anyAttribute/> 1718 </xsd:complexType> 1719 1720 <xsd:complexType name="FilterType"> 1721 <xsd:sequence> 1722 <xsd:any minOccurs="0" maxOccurs="unbounded"/> 1723 </xsd:sequence> 1724 </xsd:complexType> 1725 1726 <xsd:complexType name="SubscriptionPolicyType"> 1727 <xsd:sequence> 1728 <xsd:any minOccurs="0" maxOccurs="unbounded" processContents="lax"/> 1729 </xsd:sequence> 1730 </xsd:complexType> 1731 1732  1733  1734 <xsd:element name="TopicExpression" type="wsnt:TopicExpressionType"/> 1735 <xsd:element name="FixedTopicSet" type="xsd:boolean" default="true"/> 1736 <xsd:element name="TopicExpressionDialect" type="xsd:anyURI"/> 1737 1738 <xsd:element name="NotificationProducerRP"> 1739 <xsd:complexType> 1740 <xsd:sequence> 1741 <xsd:element ref="wsnt:TopicExpression" 1742 minOccurs="0" maxOccurs="unbounded" /> 1743 <xsd:element ref="wsnt:FixedTopicSet" 1744 minOccurs="0" maxOccurs="1" />169wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 170Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 43 of 65 171 172 1745 <xsd:element ref="wsnt:TopicExpressionDialect" 1746 minOccurs="0" maxOccurs="unbounded" /> 1747 <xsd:element ref="wstop:TopicSet" 1748 minOccurs="0" maxOccurs="1unbounded" /> 1749 </xsd:sequence> 1750 </xsd:complexType> 1751 </xsd:element> 1752 1753  1754 <xsd:element name="ConsumerReference" 1755 type="wsa:EndpointReferenceType" /> 1756 <xsd:element name="Filter" type="wsnt:FilterType" /> 1757 <xsd:element name="SubscriptionPolicy">" 1758 type="wsnt:SubscriptionPolicyType" /> 1759 <xs:complexType> 1760 <xs:sequence> 1761 <s:any minOccurs="0" maxOccurs="unbounded" processContents="lax"/> 1762 </xs:sequence> 1763 </xs:complexType> 1764 </xs:element> 1765 1766 1767 <xsd:element name="CreationTime" type="xsd:dateTime" /> 1768 1769 <xsd:element name="SubscriptionManagerRP" > 1770 <xsd:complexType> 1771 <xsd:sequence> 1772 <xsd:element ref="wsnt:ConsumerReference" 1773 minOccurs="1" maxOccurs="1" /> 1774 <xsd:element ref="wsnt:Filter" 1775 minOccurs="0" maxOccurs="1" /> 1776 <xsd:element ref="wsnt:SubscriptionPolicy" 1777 minOccurs="0" maxOccurs="1" /> 1778 <xsd:element ref="wsnt:CreationTime" 1779 minOccurs="0" maxOccurs="1" /> 1780 </xsd:sequence> 1781 </xsd:complexType> 1782 </xsd:element> 1783 1784  1785 <xsd:element name="SubscriptionReference" 1786 type="wsa:EndpointReferenceType" /> 1787 <xsd:element name="Topic" 1788 type="wsnt:TopicExpressionType" /> 1789 <xsd:element name="ProducerReference" 1790 type="wsa:EndpointReferenceType" /> 1791 1792  1793 <xsd:complexType name="NotificationMessageHolderType" > 1794 <xsd:sequence> 1795 <xsd:element ref="wsnt:SubscriptionReference" 1796 minOccurs="0" maxOccurs="1" /> 1797 <xsd:element ref="wsnt:Topic" 1798 minOccurs="0" maxOccurs="1" /> 1799 <xsd:element ref="wsnt:ProducerReference" 1800 minOccurs="0" maxOccurs="1" /> 1801 <xsd:element name="Message"> 1802 <xsd:complexType> 1803 <xsd:sequence> 1804 <xsd:any namespace="##any" processContents="lax"173wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 174Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 44 of 65 175 176 1805 minOccurs="1" maxOccurs="1"/> 1806 </xsd:sequence> 1807 </xsd:complexType> 1808 </xsd:element> 1809 </xsd:sequence> 1810 </xsd:complexType> 1811 <xsd:element name="NotificationMessage" 1812 type="wsnt:NotificationMessageHolderType"/> 1813 1814  1815 <xsd:element name="Notify" > 1816 <xsd:complexType> 1817 <xsd:sequence> 1818 <xsd:element ref="wsnt:NotificationMessage" 1819 minOccurs="1" maxOccurs="unbounded" /> 1820 <xsd:any namespace="##anyother" processContents="lax" 1821 minOccurs="0" maxOccurs="unbounded"/> 1822 </xsd:sequence> 1823 </xsd:complexType> 1824 </xsd:element> 1825 1826  1827 1828 <xsd:simpleType name="AbsoluteOrRelativeTimeType"> 1829 <xsd:union memberTypes="xsd:dateTime xsd:duration" /> 1830 </xsd:simpleType> 1831 1832 <xsd:element name="CurrentTime" type="xsd:dateTime" /> 1833 1834 <xsd:element name="TerminationTime" 1835 nillable="true" type="xsd:dateTime" /> 1836 1837 <xsd:element name="ProducerProperties" 1838 type="wsnt:QueryExpressionType" /> 1839 1840 <xsd:element name="MessageContent" 1841 type="wsnt:QueryExpressionType" /> 1842 1843 <xsd:element name="UseRaw"><xsd:complexType/></xsd:element> 1844 1845 <xsd:element name="Subscribe" > 1846 <xsd:complexType> 1847 <xsd:sequence> 1848 <xsd:element name="ConsumerReference" 1849 type="wsa:EndpointReferenceType" 1850 minOccurs="1" maxOccurs="1" /> 1851 <xsd:element name="Filter" 1852 type="wsnt:FilterType" 1853 minOccurs="0" maxOccurs="1" /> 1854 <xsd:element name="InitialTerminationTime" 1855 type="wsnt:AbsoluteOrRelativeTimeType" 1856 nillable="true" 1857 minOccurs="0" maxOccurs="1" /> 1858 <xsd:element name="SubscriptionPolicy" 1859 minOccurs="0" maxOccurs="1"> 1860 <xsd:complexType> 1861 <xsd:sequence> 1862 <xsd:any namespace="##any" processContents="lax" 1863 minOccurs="0" maxOccurs="unbounded"/> 1864 </xsd:sequence>177wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 178Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 45 of 65 179 180 1865 </xsd:complexType> 1866 </xsd:element> 1867 <xsd:any namespace="##other" processContents="lax" 1868 minOccurs="0" maxOccurs="unbounded"/> 1869 </xsd:sequence> 1870 </xsd:complexType> 1871 </xsd:element> 1872 1873 <xsd:element name="SubscribeResponse"> 1874 <xsd:complexType> 1875 <xsd:sequence> 1876 <xsd:element name="SubscriptionReference" 1877 type="wsa:EndpointReferenceType" 1878 minOccurs="01" maxOccurs="1" /> 1879 <xsd:element ref="wsnt:CurrentTime" 1880 minOccurs="0" maxOccurs="1" /> 1881 <xsd:element ref="wsnt:TerminationTime" 1882 minOccurs="0" maxOccurs="1" /> 1883 <xsd:any namespace="##other" processContents="lax" 1884 minOccurs="0" maxOccurs="unbounded"/> 1885 </xsd:sequence> 1886 </xsd:complexType> 1887 </xsd:element> 1888 1889 <xsd:element name="GetCurrentMessage"> 1890 <xsd:complexType> 1891 <xsd:sequence> 1892 <xsd:element name="Topic" 1893 type="wsnt:TopicExpressionType" /> 1894 <xsd:any namespace="##other" processContents="lax" 1895 minOccurs="0" maxOccurs="unbounded"/> 1896 </xsd:sequence> 1897 </xsd:complexType> 1898 </xsd:element> 1899 1900 <xsd:element name="GetCurrentMessageResponse"> 1901 <xsd:complexType> 1902 <xsd:sequence> 1903 <xsd:any namespace="##other" processContents="lax" 1904 minOccurs="0" maxOccurs="unbounded"/> 1905 </xsd:sequence> 1906 </xsd:complexType> 1907 </xsd:element> 1908 1909 <xsd:complexType name="SubscribeCreationFailedFaultType"> 1910 <xsd:complexContent> 1911 <xsd:extension base="wsrf-bf:BaseFaultType"/> 1912 </xsd:complexContent> 1913 </xsd:complexType> 1914 <xsd:element name="SubscribeCreationFailedFault" 1915 type="wsnt:SubscribeCreationFailedFaultType"/> 1916 1917 <xsd:complexType name="InvalidFilterFaultType"> 1918 <xsd:complexContent> 1919 <xsd:extension base="wsrf-bf:BaseFaultType"> 1920 <xsd:sequence> 1921 <xsd:element name="UnknownFilter" type="xsd:QName" 1922 minOccurs="1" maxOccurs="unbounded"/> 1923 </xsd:sequence> 1924 </xsd:extension>181wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 182Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 46 of 65 183 184 1925 </xsd:complexContent> 1926 </xsd:complexType> 1927 <xsd:element name="InvalidFilterFault" 1928 type="wsnt:InvalidFilterFaultType"/> 1929 1930 <xsd:complexType name="TopicExpressionDialectUnknownFaultType"> 1931 <xsd:complexContent> 1932 <xsd:extension base="wsrf-bf:BaseFaultType"/> 1933 </xsd:complexContent> 1934 </xsd:complexType> 1935 <xsd:element name="TopicExpressionDialectUnknownFault" 1936 type="wsnt:TopicExpressionDialectUnknownFaultType"/> 1937 1938 <xsd:complexType name="InvalidTopicExpressionFaultType"> 1939 <xsd:complexContent> 1940 <xsd:extension base="wsrf-bf:BaseFaultType"/> 1941 </xsd:complexContent> 1942 </xsd:complexType> 1943 <xsd:element name="InvalidTopicExpressionFault" 1944 type="wsnt:InvalidTopicExpressionFaultType"/> 1945 1946 <xsd:complexType name="TopicNotSupportedFaultType"> 1947 <xsd:complexContent> 1948 <xsd:extension base="wsrf-bf:BaseFaultType"/> 1949 </xsd:complexContent> 1950 </xsd:complexType> 1951 <xsd:element name="TopicNotSupportedFault" 1952 type="wsnt:TopicNotSupportedFaultType"/> 1953 1954 <xsd:complexType name="MultipleTopicsSpecifiedFaultType"> 1955 <xsd:complexContent> 1956 <xsd:extension base="wsrf-bf:BaseFaultType"/> 1957 </xsd:complexContent> 1958 </xsd:complexType> 1959 <xsd:element name="MultipleTopicsSpecifiedFault" 1960 type="wsnt:MultipleTopicsSpecifiedFaultType"/> 1961 1962 <xsd:complexType name="InvalidProducerPropertiesExpressionFaultType"> 1963 <xsd:complexContent> 1964 <xsd:extension base="wsrf-bf:BaseFaultType"/> 1965 </xsd:complexContent> 1966 </xsd:complexType> 1967 <xsd:element name="InvalidProducerPropertiesExpressionFault" 1968 type="wsnt:InvalidProducerPropertiesExpressionFaultType"/> 1969 1970 <xsd:complexType name="InvalidMessageContentExpressionFaultType"> 1971 <xsd:complexContent> 1972 <xsd:extension base="wsrf-bf:BaseFaultType"/> 1973 </xsd:complexContent> 1974 </xsd:complexType> 1975 <xsd:element name="InvalidMessageContentExpressionFault" 1976 type="wsnt:InvalidMessageContentExpressionFaultType"/> 1977 1978 <xsd:complexType 1979 name="InvalidUseRawValueFaultTypeUnrecognizedPolicyRequestFaultType"> 1980 <xsd:complexContent> 1981 <xsd:extension base="wsrf-bf:BaseFaultType"/> 1982 <xsd:sequence> 1983 <xsd:element name="UnrecognizedPolicy" type="xsd:QName" 1984 minOccurs="01" maxOccurs="unbounded"/>185wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 186Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 47 of 65 187 188 1985 </xsd:sequence> 1986 </xsd:extension> 1987 </xsd:complexContent> 1988 </xsd:complexType> 1989 <xsd:element 1990 name="InvalidUseRawValueFault"UnrecognizedPolicyRequestFault" 1991 1992 type="wsnt:InvalidUseRawValueFaultType"/>UnrecognizedPolicyRequestFault 1993 Type"/> 1994 1995 <xsd:complexType name="UnsupportedPolicyRequestFaultType"> 1996 <xsd:complexContent> 1997 <xsd:extension base="wsrf-bf:BaseFaultType"> 1998 <xsd:sequence> 1999 <xsd:element name="UnsupportedPolicy" type="xsd:QName" 2000 minOccurs="01" maxOccurs="unbounded"/> 2001 </xsd:sequence> 2002 </xsd:extension> 2003 </xsd:complexContent> 2004 </xsd:complexType> 2005 <xsd:element name="UnsupportedPolicyRequestFault" 2006 type="wsnt:UnsupportedPolicyRequestFaultType"/> 2007 2008 <xsd:complexType name="NotifyMessageNotSupportedFaultType"> 2009 <xsd:complexContent> 2010 <xsd:extension base="wsrf-bf:BaseFaultType"/> 2011 </xsd:complexContent> 2012 </xsd:complexType> 2013 <xsd:element name="NotifyMessageNotSupportedFault" 2014 type="wsnt:NotifyMessageNotSupportedFaultType"/> 2015 2016 <xsd:complexType name="UnacceptableInitialTerminationTimeFaultType"> 2017 <xsd:complexContent> 2018 <xsd:extension base="wsrf-bf:BaseFaultType"> 2019 <xsd:sequence> 2020 <xsd:element name="MinimumTime" type="xsd:dateTime"/> 2021 <xsd:element name="MaximumTime" type="xsd:dateTime" 2022 minOccurs="0"/> 2023 </xsd:sequence> 2024 </xsd:extension> 2025 </xsd:complexContent> 2026 </xsd:complexType> 2027 <xsd:element name="UnacceptableInitialTerminationTimeFault" 2028 type="wsnt:UnacceptableInitialTerminationTimeFaultType"/> 2029 2030 <xsd:complexType name="NoCurrentMessageOnTopicFaultType"> 2031 <xsd:complexContent> 2032 <xsd:extension base="wsrf-bf:BaseFaultType"/> 2033 </xsd:complexContent> 2034 </xsd:complexType> 2035 <xsd:element name="NoCurrentMessageOnTopicFault" 2036 type="wsnt:NoCurrentMessageOnTopicFaultType"/> 2037 2038  2039 <xsd:element name="GetMessages"> 2040 <xsd:complexType> 2041 <xsd:sequence> 2042 <xsd:element name="MaximumNumber" 2043 type="xsd:nonNegativeInteger"/> 2044 <xsd:any namespace="##other" processContents="lax"189wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 190Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 48 of 65 191 192 2045 minOccurs="0" maxOccurs="unbounded"/> 2046 </xsd:sequence> 2047 <xsd:anyAttribute/> 2048 </xsd:complexType> 2049 </xsd:element> 2050 2051 <xsd:element name="GetMessagesResponse"> 2052 <xsd:complexType> 2053 <xsd:sequence> 2054 <xsd:element ref="wsnt:NotificationMessage" 2055 minOccurs="0" maxOccurs="unbounded" /> 2056 <xsd:any namespace="##other" processContents="lax" 2057 minOccurs="0" maxOccurs="unbounded"/> 2058 </xsd:sequence> 2059 <xsd:anyAttribute/> 2060 </xsd:complexType> 2061 </xsd:element> 2062 2063 <xsd:element name="DestroyPullPoint"> 2064 <xsd:complexType> 2065 <xsd:sequence> 2066 <xsd:any namespace="##other" processContents="lax" 2067 minOccurs="0" maxOccurs="unbounded"/> 2068 </xsd:sequence> 2069 <xsd:anyAttribute/> 2070 </xsd:complexType> 2071 </xsd:element> 2072 2073 <xsd:element name="DestroyResponse">DestroyPullPointResponse"> 2074 <xsd:complexType> 2075 <xsd:sequence> 2076 <xsd:any namespace="##other" processContents="lax" 2077 minOccurs="0" maxOccurs="unbounded"/> 2078 </xsd:sequence> 2079 <xsd:anyAttribute/> 2080 </xsd:complexType> 2081 </xsd:element> 2082 2083 <xsd:complexType 2084 name="UnableToDestroyPullPointType">UnableToDestroyPullPointFaultType"> 2085 <xsd:complexContent> 2086 <xsd:extension base="wsrf-bf:BaseFaultType"/> 2087 </xsd:complexContent> 2088 </xsd:complexType> 2089 <xsd:element name="UnableToDestroyPullPoint"Fault" 2090 2091 type="wsnt:UnableToDestroyPullPointType"/>UnableToDestroyPullPointFault 2092 Type"/> 2093 2094 2095  2096 <xsd:element name="CreatePullPoint"> 2097 <xsd:complexType> 2098 <xsd:sequence> 2099 <xsd:any namespace="##other" processContents="lax" 2100 minOccurs="0" maxOccurs="unbounded"/> 2101 </xsd:sequence> 2102 <xsd:anyAttribute/> 2103 </xsd:complexType> 2104 </xsd:element>193wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 194Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 49 of 65 195 196 2105 2106 <xsd:element name="CreatePullPointResponse"> 2107 <xsd:complexType> 2108 <xsd:sequence> 2109 <xsd:element name="PullPoint" 2110 type="wsa:EndpointReferenceType"/> 2111 <xsd:any namespace="##other" processContents="lax" 2112 minOccurs="0" maxOccurs="unbounded"/> 2113 </xsd:sequence> 2114 <xsd:anyAttribute/> 2115 </xsd:complexType> 2116 </xsd:element> 2117 2118 <xsd:complexType 2119 name="UnableToCreatePullPointType">UnableToCreatePullPointFaultType"> 2120 <xsd:complexContent> 2121 <xsd:extension base="wsrf-bf:BaseFaultType"/> 2122 </xsd:complexContent> 2123 </xsd:complexType> 2124 <xsd:element name="UnableToCreatePullPoint"Fault" 2125 2126 type="wsnt:UnableToCreatePullPointType"/>UnableToCreatePullPointFaultTy 2127 pe"/> 2128 2129 2130  2131 <xsd:element name="Renew"> 2132 <xsd:complexType> 2133 <xsd:sequence> 2134 <xsd:element name="TerminationTime" 2135 type="wsnt:AbsoluteOrRelativeTimeType" 2136 nillable="true" 2137 minOccurs="1" maxOccurs="1" /> 2138 <xsd:any namespace="##other" processContents="lax" 2139 minOccurs="0" maxOccurs="unbounded"/> 2140 </xsd:sequence> 2141 </xsd:complexType> 2142 </xsd:element> 2143 2144 <xsd:element name="RenewResponse"> 2145 <xsd:complexType> 2146 <xsd:sequence> 2147 <xsd:element ref="wsnt:TerminationTime" 2148 minOccurs="1" maxOccurs="1" /> 2149 <xsd:element ref="wsnt:CurrentTime" 2150 minOccurs="0" maxOccurs="1" /> 2151 <xsd:any namespace="##other" processContents="lax" 2152 minOccurs="0" maxOccurs="unbounded"/> 2153 </xsd:sequence> 2154 </xsd:complexType> 2155 </xsd:element> 2156 2157 <xsd:complexType name="UnacceptableTerminationTimeFaultType"> 2158 <xsd:complexContent> 2159 <xsd:extension base="wsrf-bf:BaseFaultType"> 2160 <xsd:sequence> 2161 <xsd:element name="MinimumTime" type="xsd:dateTime"/> 2162 <xsd:element name="MaximumTime" type="xsd:dateTime" 2163 minOccurs="0"/> 2164 </xsd:sequence>197wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 198Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 50 of 65 199 200 2165 </xsd:extension> 2166 </xsd:complexContent> 2167 </xsd:complexType> 2168 <xsd:element name="UnacceptableTerminationTimeFault" 2169 type="wsnt:UnacceptableTerminationTimeFaultType"/> 2170 2171 <xsd:element name="Unsubscribe"> 2172 <xsd:complexType> 2173 <xsd:sequence> 2174 <xsd:any namespace="##other" processContents="lax" 2175 minOccurs="0" maxOccurs="unbounded"/> 2176 </xsd:sequence> 2177 </xsd:complexType> 2178 </xsd:element> 2179 2180 <xsd:element name="UnsubscribeResponse"> 2181 <xsd:complexType> 2182 <xsd:sequence> 2183 <xsd:any namespace="##other" processContents="lax" 2184 minOccurs="0" maxOccurs="unbounded"/> 2185 </xsd:sequence> 2186 </xsd:complexType> 2187 </xsd:element> 2188 2189 <xsd:complexType name="UnableToDestroySubscriptionFaultType"> 2190 <xsd:complexContent> 2191 <xsd:extension base="wsrf-bf:BaseFaultType"/> 2192 </xsd:complexContent> 2193 </xsd:complexType> 2194 <xsd:element name="UnableToDestroySubscriptionFault" 2195 type="wsnt:UnableToDestroySubscriptionFaultType"/> 2196 2197  2198 2199 <xsd:element name="PauseSubscription"> 2200 <xsd:complexType> 2201 <xsd:sequence> 2202 <xsd:any namespace="##other" processContents="lax" 2203 minOccurs="0" maxOccurs="unbounded"/> 2204 </xsd:sequence> 2205 </xsd:complexType> 2206 </xsd:element> 2207 2208 <xsd:element name="PauseSubscriptionResponse" > 2209 <xsd:complexType> 2210 <xsd:sequence> 2211 <xsd:any namespace="##other" processContents="lax" 2212 minOccurs="0" maxOccurs="unbounded"/> 2213 </xsd:sequence> 2214 </xsd:complexType> 2215 </xsd:element> 2216 2217 <xsd:element name="ResumeSubscription"> 2218 <xsd:complexType> 2219 <xsd:sequence> 2220 <xsd:any namespace="##other" processContents="lax" 2221 minOccurs="0" maxOccurs="unbounded"/> 2222 </xsd:sequence> 2223 </xsd:complexType> 2224 </xsd:element>201wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 202Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 51 of 65 203 204 2225 2226 <xsd:element name="ResumeSubscriptionResponse"> 2227 <xsd:complexType> 2228 <xsd:sequence> 2229 <xsd:any namespace="##other" processContents="lax" 2230 minOccurs="0" maxOccurs="unbounded"/> 2231 </xsd:sequence> 2232 </xsd:complexType> 2233 </xsd:element> 2234 2235 <xsd:complexType name="PauseFailedFaultType"> 2236 <xsd:complexContent> 2237 <xsd:extension base="wsrf-bf:BaseFaultType"/> 2238 </xsd:complexContent> 2239 </xsd:complexType> 2240 <xsd:element name="PauseFailedFault" 2241 type="wsnt:PauseFailedFaultType"/> 2242 2243 <xsd:complexType name="ResumeFailedFaultType"> 2244 <xsd:complexContent> 2245 <xsd:extension base="wsrf-bf:BaseFaultType"/> 2246 </xsd:complexContent> 2247 </xsd:complexType> 2248 <xsd:element name="ResumeFailedFault" 2249 type="wsnt:ResumeFailedFaultType"/> 2250 2251 </xsd:schema>205wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 206Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 52 of 65 207 208 2252Appendix C. WSDL 1.12253The following illustrates the WSDL 1.1 for the Web service methods described in this 2254specification: 2255 <?xml version="1.0" encoding="utf-8"?> 2256  2302 <wsdl:definitions name="WS-BaseNotification" 2303 targetNamespace="http://docs.oasis-open.org/wsn/bw-1"2" 2304 xmlns:wsntw="http://docs.oasis-open.org/wsn/bw-1"2" 2305 xmlns:wsnt="http://docs.oasis-open.org/wsn/b-1"2" 2306 xmlns:wsa="http://www.w3.org/2005/0308/addressing" 209wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 210Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 53 of 65 211 212 2307 xmlns:wsrf-rw="http://docs.oasis-open.org/wsrf/rw-1"2" 2308 xmlns:xsd="http://www.w3.org/2001/XMLSchema" 2309 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 2310 xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"> 2311 2312  2313 <wsdl:import 2314 namespace="http://docs.oasis-open.org/wsrf/rw-1"2" 2315 location="http://docs.oasis-open.org/wsrf/rw-12.wsdl"/> 2316 2317  2318 <wsdl:types> 2319 <xsd:schema> 2320 <xsd:import 2321 namespace="http://docs.oasis-open.org/wsn/b-1"2" 2322 schemaLocation="http://docs.oasis-open.org/wsn/b-12.xsd"/> 2323 </xsd:schema> 2324 </wsdl:types> 2325 2326  2333 <wsdl:message name="Notify"> 2334 <wsdl:part name="Notify" element="wsnt:Notify"/> 2335 </wsdl:message> 2336 2337  2343 <wsdl:message name="SubscribeRequest" > 2344 <wsdl:part name="SubscribeRequest" 2345 element="wsnt:Subscribe"/> 2346 </wsdl:message> 2347 2348 <wsdl:message name="SubscribeResponse"> 2349 <wsdl:part name="SubscribeResponse" 2350 element="wsnt:SubscribeResponse"/> 2351 </wsdl:message> 2352 2353 <wsdl:message name="SubscribeCreationFailedFault"> 2354 <wsdl:part name="SubscribeCreationFailedFault" 2355 element="wsnt:SubscribeCreationFailedFault" /> 2356 </wsdl:message> 2357 2358 <wsdl:message name="TopicExpressionDialectUnknownFault"> 2359 <wsdl:part name="TopicExpressionDialectUnknownFault" 2360 element="wsnt:TopicExpressionDialectUnknownFault" /> 2361 </wsdl:message> 2362 2363 <wsdl:message name="InvalidFilterFault"> 2364 <wsdl:part name="InvalidFilterFault" 2365 element="wsnt:InvalidFilterFault" /> 2366 </wsdl:message> 213wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 214Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 54 of 65 215 216 2367 2368 <wsdl:message name="InvalidProducerPropertiesExpressionFault"> 2369 <wsdl:part name="InvalidProducerPropertiesExpressionFault" 2370 element="wsnt:InvalidProducerPropertiesExpressionFault" /> 2371 </wsdl:message> 2372 2373 <wsdl:message name="InvalidMessageContentExpressionFault"> 2374 <wsdl:part name="InvalidMessageContentExpressionFault" 2375 element="wsnt:InvalidMessageContentExpressionFault" /> 2376 </wsdl:message> 2377 2378 <wsdl:message 2379 name="InvalidUseRawValueFault">UnrecognizedPolicyRequestFault"> 2380 <wsdl:part 2381 name="InvalidUseRawValueFault"UnrecognizedPolicyRequestFault" 2382 2383 element="wsnt:InvalidUseRawValueFaultUnrecognizedPolicyRequestFault" /> 2384 </wsdl:message> 2385 2386 <wsdl:message name="UnsupportedPolicyRequestFault"> 2387 <wsdl:part name="UnsupportedPolicyRequestFault" 2388 element="wsnt:UnsupportedPolicyRequestFault" /> 2389 </wsdl:message> 2390 2391 <wsdl:message name="NotifyMessageNotSupportedFault"> 2392 <wsdl:part name="NotifyMessageNotSupportedFault" 2393 element="wsnt:NotifyMessageNotSupportedFault" /> 2394 </wsdl:message> 2395 2396 <wsdl:message name="UnacceptableInitialTerminationTimeFault"> 2397 <wsdl:part name="UnacceptableInitialTerminationTimeFault" 2398 element="wsnt:UnacceptableInitialTerminationTimeFault"/> 2399 </wsdl:message> 2400 2401  2405 <wsdl:message name="GetCurrentMessageRequest"> 2406 <wsdl:part name="GetCurrentMessageRequest" 2407 element="wsnt:GetCurrentMessage"/> 2408 </wsdl:message> 2409 2410 <wsdl:message name="GetCurrentMessageResponse"> 2411 <wsdl:part name="GetCurrentMessageResponse" 2412 element="wsnt:GetCurrentMessageResponse"/> 2413 </wsdl:message> 2414 2415 <wsdl:message name="InvalidTopicExpressionFault"> 2416 <wsdl:part name="InvalidTopicExpressionFault" 2417 element="wsnt:InvalidTopicExpressionFault" /> 2418 </wsdl:message> 2419 2420 <wsdl:message name="TopicNotSupportedFault"> 2421 <wsdl:part name="TopicNotSupportedFault" 2422 element="wsnt:TopicNotSupportedFault" /> 2423 </wsdl:message> 2424 2425 <wsdl:message name="MultipleTopicsSpecifiedFault"> 2426 <wsdl:part name="MultipleTopicsSpecifiedFault"217wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 218Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 55 of 65 219 220 2427 element="wsnt:MultipleTopicsSpecifiedFault" /> 2428 </wsdl:message> 2429 2430 <wsdl:message name="NoCurrentMessageOnTopicFault"> 2431 <wsdl:part name="NoCurrentMessageOnTopicFault" 2432 element="wsnt:NoCurrentMessageOnTopicFault" /> 2433 </wsdl:message> 2434 2435  2439 <wsdl:message name="GetMessagesRequest"> 2440 <wsdl:part name="GetMessagesRequest" 2441 element="wsnt:GetMessages"/> 2442 </wsdl:message> 2443 2444 <wsdl:message name="GetMessagesResponse"> 2445 <wsdl:part name="GetMessagesResponse" 2446 element="wsnt:GetMessagesResponse"/> 2447 </wsdl:message> 2448 2449  2453 <wsdl:message name="DestroyRequest">DestroyPullPointRequest"> 2454 <wsdl:part name="DestroyRequest"DestroyPullPointRequest" 2455 element="wsnt:DestroyPullPoint"/> 2456 </wsdl:message> 2457 2458 <wsdl:message name="DestroyResponse">DestroyPullPointResponse"> 2459 <wsdl:part name="DestroyResponse"DestroyPullPointResponse" 2460 element="wsnt:DestroyResponseDestroyPullPointResponse"/> 2461 </wsdl:message> 2462 2463 <wsdl:message name="UnableToDestroyPullPointFault"> 2464 <wsdl:part name="UnableToDestroyPullPoint"Fault" 2465 element="wsnt:UnableToDestroyPullPointFault"/> 2466 </wsdl:message> 2467 2468  2472 <wsdl:message name="CreatePullPointRequest"> 2473 <wsdl:part name="CreatePullPointRequest" 2474 element="wsnt:CreatePullPoint"/> 2475 </wsdl:message> 2476 2477 <wsdl:message name="CreatePullPointResponse"> 2478 <wsdl:part name="CreatePullPointResponse" 2479 element="wsnt:CreatePullPointResponse"/> 2480 </wsdl:message> 2481 2482 <wsdl:message name="UnableToCreatePullPointFault"> 2483 <wsdl:part name="UnableToCreatePullPoint"Fault" 2484 element="wsnt:UnableToCreatePullPointFault"/> 2485 </wsdl:message> 2486221wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 222Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 56 of 65 223 224 2487  2491 <wsdl:message name="RenewRequest"> 2492 <wsdl:part name="RenewRequest" 2493 element="wsnt:Renew"/> 2494 </wsdl:message> 2495 2496 <wsdl:message name="RenewResponse"> 2497 <wsdl:part name="RenewResponse" 2498 element="wsnt:RenewResponse"/> 2499 </wsdl:message> 2500 2501 <wsdl:message name="UnacceptableTerminationTimeFault"> 2502 <wsdl:part name="UnacceptableTerminationTimeFault" 2503 element="wsnt:UnacceptableTerminationTimeFault" /> 2504 </wsdl:message> 2505 2506  2510 <wsdl:message name="UnsubscribeRequest"> 2511 <wsdl:part name="UnsubscribeRequest" 2512 element="wsnt:Unsubscribe"/> 2513 </wsdl:message> 2514 2515 <wsdl:message name="UnsubscribeResponse"> 2516 <wsdl:part name="UnsubscribeResponse" 2517 element="wsnt:UnsubscribeResponse"/> 2518 </wsdl:message> 2519 2520 <wsdl:message name="UnableToDestroySubscriptionFault"> 2521 <wsdl:part name="UnableToDestroySubscriptionFault" 2522 element="wsnt:UnableToDestroySubscriptionFault" /> 2523 </wsdl:message> 2524 2525  2529 <wsdl:message name="PauseSubscriptionRequest"> 2530 <wsdl:part name="PauseSubscriptionRequest" 2531 element="wsnt:PauseSubscription"/> 2532 </wsdl:message> 2533 2534 <wsdl:message name="PauseSubscriptionResponse"> 2535 <wsdl:part name="PauseSubscriptionResponse" 2536 element="wsnt:PauseSubscriptionResponse"/> 2537 </wsdl:message> 2538 2539 <wsdl:message name="PauseFailedFault"> 2540 <wsdl:part name="PauseFailedFault" 2541 element="wsnt:PauseFailedFault" /> 2542 </wsdl:message> 2543 2544  2548 <wsdl:message name="ResumeSubscriptionRequest"> 2549 <wsdl:part name="ResumeSubscriptionRequest" 2550 element="wsnt:ResumeSubscription"/> 2551 </wsdl:message> 2552 2553 <wsdl:message name="ResumeSubscriptionResponse"> 2554 <wsdl:part name="ResumeSubscriptionResponse" 2555 element="wsnt:ResumeSubscriptionResponse"/> 2556 </wsdl:message> 2557 2558 <wsdl:message name="ResumeFailedFault"> 2559 <wsdl:part name="ResumeFailedFault" 2560 element="wsnt:ResumeFailedFault" /> 2561 </wsdl:message> 2562 2563  2564  2565 <wsdl:portType name="NotificationConsumer"> 2566 <wsdl:operation name="Notify"> 2567 <wsdl:input message="wsntw:Notify" /> 2568 </wsdl:operation> 2569 </wsdl:portType> 2570 2571  2572 <wsdl:portType name="NotificationProducer"> 2573 <wsdl:operation name="Subscribe"> 2574 <wsdl:input message="wsntw:SubscribeRequest" /> 2575 <wsdl:output message="wsntw:SubscribeResponse" /> 2576 <wsdl:fault name="ResourceUnknownFault" 2577 message="wsrf-rw:ResourceUnknownFault" /> 2578 <wsdl:fault name="InvalidFilterFault" 2579 message="wsntw:InvalidFilterFault"/> 2580 <wsdl:fault name="TopicExpressionDialectUnknownFault" 2581 message="wsntw:TopicExpressionDialectUnknownFault"/> 2582 <wsdl:fault name="InvalidTopicExpressionFault" 2583 message="wsntw:InvalidTopicExpressionFault" /> 2584 <wsdl:fault name="TopicNotSupportedFault" 2585 message="wsntw:TopicNotSupportedFault" /> 2586 <wsdl:fault name="InvalidProducerPropertiesExpressionFault" 2587 message="wsntw:InvalidProducerPropertiesExpressionFault"/> 2588 <wsdl:fault name="InvalidMessageContentExpressionFault" 2589 message="wsntw:InvalidMessageContentExpressionFault"/> 2590 <wsdl:fault name="InvalidUseRawValueFault" 2591 message="wsntw:InvalidUseRawValueFault"/> 2592 <wsdl:fault name="UnacceptableInitialTerminationTimeFault" 2593 message="wsntw:UnacceptableInitialTerminationTimeFault"/> 2594 <wsdl:fault name="UnrecognizedPolicyRequestFault" 2595 message="wsntw:UnrecognizedPolicyRequestFault"/> 2596 <wsdl:fault name="UnsupportedPolicyRequestFault" 2597 message="wsntw:UnsupportedPolicyRequestFault"/> 2598 <wsdl:fault name="NotifyMessageNotSupportedFault" 2599 message="wsntw:NotifyMessageNotSupportedFault"/> 2600 <wsdl:fault name="SubscribeCreationFailedFault" 2601 message="wsntw:SubscribeCreationFailedFault"/> 2602 </wsdl:operation> 2603 2604 <wsdl:operation name="GetCurrentMessage"> 2605 <wsdl:input message="wsntw:GetCurrentMessageRequest"/> 2606 <wsdl:output message="wsntw:GetCurrentMessageResponse"/>229wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 230Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 58 of 65 231 232 2607 <wsdl:fault name="ResourceUnknownFault" 2608 message="wsrf-rw:ResourceUnknownFault" /> 2609 <wsdl:fault name="TopicExpressionDialectUnknownFault" 2610 message="wsntw:TopicExpressionDialectUnknownFault"/> 2611 <wsdl:fault name="InvalidTopicExpressionFault" 2612 message="wsntw:InvalidTopicExpressionFault" /> 2613 <wsdl:fault name="TopicNotSupportedFault" 2614 message="wsntw:TopicNotSupportedFault" /> 2615 <wsdl:fault name="NoCurrentMessageOnTopicFault" 2616 message="wsntw:NoCurrentMessageOnTopicFault" /> 2617 <wsdl:fault name="MultipleTopicsSpecifiedFault" 2618 message="wsntw:MultipleTopicsSpecifiedFault" /> 2619 </wsdl:operation> 2620 </wsdl:portType> 2621 2622  2623 <wsdl:portType name="PullPoint"> 2624 <wsdl:operation name="GetMessages"> 2625 <wsdl:input name="GetMessagesRequest" 2626 message="wsntw:GetMessagesRequest" /> 2627 <wsdl:output name="GetMessagesResponse" 2628 message="wsntw:GetMessagesResponse" /> 2629 <wsdl:fault name="ResourceUnknownFault" 2630 message="wsrf-rw:ResourceUnknownFault" /> 2631 </wsdl:operation> 2632 2633 <wsdl:operation name="DestroyPullPoint"> 2634 <wsdl:input name="DestroyRequest"DestroyPullPointRequest" 2635 message="wsntw:DestroyRequest" />DestroyPullPointRequest" /> 2636 <wsdl:output name="DestroyResponse"DestroyPullPointResponse" 2637 message="wsntw:DestroyResponse" />DestroyPullPointResponse" /> 2638 <wsdl:fault name="UnableToDestroyPullPoint"Fault" 2639 message="wsntw:UnableToDestroyPullPointFault" /> 2640 </wsdl:operation> 2641 2642 <wsdl:operation name="Notify"> 2643 <wsdl:input message="wsntw:Notify"/> 2644 </wsdl:operation> 2645 </wsdl:portType> 2646 2647  2648 <wsdl:portType name="CreatePullPoint"> 2649 <wsdl:operation name="CreatePullPoint"> 2650 <wsdl:input name="CreatePullPointRequest" 2651 message="wsntw:CreatePullPointRequest" /> 2652 <wsdl:output name="CreatePullPointResponse" 2653 message="wsntw:CreatePullPointResponse" /> 2654 <wsdl:fault name="UnableToCreatePullPoint"Fault" 2655 message="wsntw:UnableToCreatePullPointFault" /> 2656 </wsdl:operation> 2657 </wsdl:portType> 2658 2659  2660 <wsdl:portType name="SubscriptionManager"> 2661 <wsdl:operation name="Renew"> 2662 <wsdl:input name="RenewRequest" 2663 message="wsntw:RenewRequest" /> 2664 <wsdl:output name="RenewResponse" 2665 message="wsntw:RenewResponse" /> 2666 <wsdl:fault name="ResourceUnknownFault" 233wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 234Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 59 of 65 235 236 2667 message="wsrf-rw:ResourceUnknownFault" /> 2668 <wsdl:fault name="UnacceptableTerminationTimeFault" 2669 message= 2670 "wsntw:UnacceptableTerminationTimeFault" /> 2671 </wsdl:operation> 2672 <wsdl:operation name="Unsubscribe"> 2673 <wsdl:input name="UsubscribeRequestUnsubscribeRequest" 2674 message="wsntw:UnsubscribeRequest" /> 2675 <wsdl:output name="UnsubscribeResponse" 2676 message="wsntw:UnsubscribeResponse" /> 2677 <wsdl:fault name="ResourceUnknownFault" 2678 message="wsrf-rw:ResourceUnknownFault" /> 2679 <wsdl:fault name="UnableToDestroySubscriptionFault" 2680 message= 2681 "wsntw:UnableToDestroySubscriptionFault" /> 2682 </wsdl:operation> 2683 </wsdl:portType> 2684 2685  2686 <wsdl:portType name="PausableSubscriptionManager"> 2687  2688 <wsdl:operation name="Renew"> 2689 <wsdl:input name="RenewRequest" 2690 message="wsntw:RenewRequest" /> 2691 <wsdl:output name="RenewResponse" 2692 message="wsntw:RenewResponse" /> 2693 <wsdl:fault name="ResourceUnknownFault" 2694 message="wsrf-rw:ResourceUnknownFault" /> 2695 <wsdl:fault name="UnacceptableTerminationTimeFault" 2696 message= 2697 "wsntw:UnacceptableTerminationTimeFault" /> 2698 </wsdl:operation> 2699 <wsdl:operation name="Unsubscribe"> 2700 <wsdl:input name="UsubscribeRequestUnsubscribeRequest" 2701 message="wsntw:UnsubscribeRequest" /> 2702 <wsdl:output name="UnsubscribeResponse" 2703 message="wsntw:UnsubscribeResponse" /> 2704 <wsdl:fault name="ResourceUnknownFault" 2705 message="wsrf-rw:ResourceUnknownFault" /> 2706 <wsdl:fault name="UnableToDestroySubscriptionFault" 2707 message= 2708 "wsntw:UnableToDestroySubscriptionFault" /> 2709 </wsdl:operation> 2710 2711  2712 <wsdl:operation name="PauseSubscription"> 2713 <wsdl:input message="wsntw:PauseSubscriptionRequest"/> 2714 <wsdl:output message="wsntw:PauseSubscriptionResponse"/> 2715 <wsdl:fault name="ResourceUnknownFault" 2716 message="wsrf-rw:ResourceUnknownFault" /> 2717 <wsdl:fault name="PauseFailedFault" 2718 message="wsntw:PauseFailedFault" /> 2719 </wsdl:operation> 2720 <wsdl:operation name="ResumeSubscription"> 2721 <wsdl:input message="wsntw:ResumeSubscriptionRequest"/> 2722 <wsdl:output message="wsntw:ResumeSubscriptionResponse"/> 2723 <wsdl:fault name="ResourceUnknownFault" 2724 message="wsrf-rw:ResourceUnknownFault" /> 2725 <wsdl:fault name="ResumeFailedFault" 2726 message="wsntw:ResumeFailedFault" /> 237wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 238Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 60 of 65 239 240 2727 </wsdl:operation> 2728 </wsdl:portType> 2729 </wsdl:definitions>241wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 242Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 61 of 65 243 244 2730Appendix D. Revision HistoryRev Date By Whom What wd-01 2004-05-18 Steve Graham Initial version created from submission by contributing companies. Minor modifications made to reflect OASIS formatting and namespace URI choices. wd-02 2004-05-24 Steve Graham Added requirements section draft and updated acknowledgments appendix. wd-03 2004-06-07 Steve Graham Minor modifications on wd-02 as reported by Peter N. and William V. wd-04 2004-06-21 Steve Graham Finalize list of acknowledgments and annotate title page with result of TC vote. wd-03 2004-07-12 Steve Graham “rename” 04 back to 03 to minimize reference rework in WSRF. wd-04 2004-09-20 Steve Graham WSN 2.3, 2.11, 2.17, 2.18, 2.19, 2.21, 2.22, 2.29 1.3, 01a 2004-09-27 Steve Graham Rename to follow agreed upon format, add resolution to WSN 5.2 1.3, 01b 2004-11-17 Steve Graham Post Oct f2f edits 1.3, 01c 2004-12-7 Steve Graham, WSN 1,7, 2.7, 2.13, 2.14, 2.15, 2.24 and David Hull WSN2.17 revisited 1.3, 01d 2004-12-8 Steve Graham Fix Action URIs and other edits per Tom Maguire’s comments 1.3, 01e 2005-02-19 Bryan Murray Editorial text and formatting, WSN2.1, WSN2.37, WSN2.38 1.3,01e 2005-02-25 Steve Graham Mod’s to Bryan’s edits, WSN 2.34, WSN2.35 1.3, 01e 2005-03-02 Steve Graham Minor typos reported by Matt Haynos’ team. 1.3, 01f 2005-05-09 Bryan Murray, WSN1.5, WSN2.1 (InvalidFilterFault), David Hull WSN2.32, WSN2.39, WSN2.43, WSN2.45, WSN2.46 1.3, 01g 2005-05-18 Bryan Murray Per face-to-face agreement on hygiene issues. WSN 2.48 (but see comment to list from dmh)245wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 246Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 62 of 65 247 248 Rev Date By Whom What (Partially?) WSN 2.49 WSN 2.50 WSN 2.53 1.3.01g 2005-05-19 David Hull Integrated definitions from White Paper, including updates for WSN2.39 compliance. NotificationMessage is not Notification throughout. Began integrating security section from whitepaper, along with proposed text for WSN 2.24 Fixed a few more WS 2.39 stragglers1.3.01 h 2005-05-27 David Hull WSN 2.51, WSN 2.52, (also it seems, 2.33, 2.48, 2.1 (pending David raising omnibus issue), 2.23 (partial), 2.25, 2.34, 2.46) 1.3.01.i 2005-06-02 Steve Graham Modifications on 01g and 01h text, completion of schema and WSDL related items and 2.47, 2.55, 2.41, 2.23 1.3.01.j 2005-06-09 Bryan Murray AI 106, AI 109, WSN1.4, section 7.1 cleanup, remove ref to Primer 1.3.01.k 2005-06-29 David Hull Integrated review comments for 2.1, 2.25, 2.33, 2.39, 2.48, 2.50, 2.52. Pseudo-schema descriptions of open content. 1.3.01.l 2005-07-06 David Hull Integrated review from chairs: 2.6, 2.34, 2.52, 2.55, typos, abstract, acknowledgements. 1.3.01.m 2005-07-07 David Hull Amended requirement for composability, per committee vote. Formatting in section 4.2 1.3.02.a 2005-09-13 David Hull Issues 2.57, 2.59. 2.60, 2.61 1.3.02.a 2005-09-14 Bryan Murray Changed namespace and [action] URIs to b-2 and bw-2 Added resolution to 2.58 1.3.02b 2005-10-10 David Hull Issues 2.63, 4.2, AI 132, 134, 136, cleanup of references. 1.3.02c 2005-10-11 David Hull Issues 2.62, 4.2, AI 132, 134, 138, 139, 140 1.3.02d 2005-10-19 David Hull Various errata249wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 250Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 63 of 65 251 252 Rev Date By Whom What 1.3.02f 2005-11-21 David Hull Issue 2.62 and various errata253wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 254Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 64 of 65 255 256 2731Appendix E. Notices2732OASIS takes no position regarding the validity or scope of any intellectual property or other rights 2733that might be claimed to pertain to the implementation or use of the technology described in this 2734document or the extent to which any license under such rights might or might not be available; 2735neither does it represent that it has made any effort to identify any such rights. Information on 2736OASIS's procedures with respect to rights in OASIS specifications can be found at the OASIS 2737website. Copies of claims of rights made available for publication and any assurances of licenses 2738to be made available, or the result of an attempt made to obtain a general license or permission 2739for the use of such proprietary rights by implementors or users of this specification, can be 2740obtained from the OASIS Executive Director. 2741 2742OASIS invites any interested party to bring to its attention any copyrights, patents or patent 2743applications, or other proprietary rights which may cover technology that may be required to 2744implement this specification. Please address the information to the OASIS Executive Director. 2745 2746Copyright (C) OASIS Open (2004-2005). All Rights Reserved. 2747 2748This document and translations of it may be copied and furnished to others, and derivative works 2749that comment on or otherwise explain it or assist in its implementation may be prepared, copied, 2750published and distributed, in whole or in part, without restriction of any kind, provided that the 2751above copyright notice and this paragraph are included on all such copies and derivative works. 2752However, this document itself may not be modified in any way, such as by removing the copyright 2753notice or references to OASIS, except as needed for the purpose of developing OASIS 2754specifications, in which case the procedures for copyrights defined in the OASIS Intellectual 2755Property Rights document must be followed, or as required to translate it into languages other 2756than English. 2757 2758The limited permissions granted above are perpetual and will not be revoked by OASIS or its 2759successors or assigns. 2760 2761This document and the information contained herein is provided on an "AS IS" basis and OASIS 2762DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO 2763ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE 2764ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A 2765PARTICULAR PURPOSE. 2766257wsn-ws_base_notification-1.3-spec-pr-01wd-02f 6/1/18 258Copyright © OASIS Open 2004-2005. All Rights Reserved. Page 65 of 65 259 260

Web Services Base Notification 1.3 (WS-Basenotification)

Details

Download

Copyright

We respect the copyrights and intellectual property rights of all users. All uploaded documents are either original works of the uploader or authorized works of the rightful owners.

Support