1 2 ebXML Registry Services and Protocols 3 Version 3.0 4 Committee Draft Specification 02, 15 March, 2005 5 Document identifier: 6 regrep-rs-3.0-cd-02 7 Location: 8 http://www.oasis-open.org/committees/regrep/documents/3.0/specs/regrep-rs-3.0-cd-02.pdf 9 Editors: Name Affiliation Sally Fuger Individual Farrukh Najmi Sun Microsystems Nikola Stojanovic RosettaNet 10 11 Contributors: Name Affiliation Diego Ballve Individual Ivan Bedini France Telecom Kathryn Breininger The Boeing Company Joseph Chiusano Booz Allen Hamilton Peter Kacandes Adobe Systems Paul Macias LMI Government Consulting Carl Mattocks CHECKMi Matthew MacKenzie Adobe Systems Monica Martin Sun Microsystems Richard Martell Galdos Systems Inc Duane Nickull Adobe Systems Goran Zugic ebXMLsoft Inc. 12 13 Abstract: 14 This document defines the services and protocols for an ebXML Registry 15 A separate document, ebXML Registry: Information Model [ebRIM], defines the types of metadata 16 and content that can be stored in an ebXML Registry. 17 Status: 18 This document is an OASIS ebXML Registry Technical Committee Approved Draft Specification. 19 Committee members should send comments on this specification to the [email protected] 20 open.org list. Others should subscribe to and send comments to the [email protected] 21 open.org list. To subscribe, send an email message to [email protected] 22 open.org with the word "subscribe" as the body of the message. 23 For information on whether any patents have been disclosed that may be essential to 24 implementing this specification, and any offers of patent licensing terms, please refer to the 25 Intellectual Property Rights section of the OASIS ebXML Registry TC web page (http://www.oasis- 26 open.org/committees/regrep/). regrep-rs-3.0-cd-02 Mar 29, 2005 Copyright © OASIS Open 2005. All Rights Reserved. Page 1 of 127 27 Table of Contents 28 1 Introduction............................................................................................................................................. 11 29 1.1 Audience.......................................................................................................................................... 11 30 1.2 Terminology..................................................................................................................................... 11 31 1.3 Notational Conventions.................................................................................................................... 11 32 1.3.1 UML Diagrams......................................................................................................................... 11 33 1.3.2 Identifier Placeholders.............................................................................................................. 11 34 1.3.3 Constants................................................................................................................................. 11 35 1.3.4 Bold Text.................................................................................................................................. 12 36 1.3.5 Example Values........................................................................................................................ 12 37 1.4 XML Schema Conventions.............................................................................................................. 12 38 1.4.1 Schemas Defined by ebXML Registry...................................................................................... 12 39 1.4.2 Schemas Used By ebXML Registry.......................................................................................... 13 40 1.5 Registry Actors................................................................................................................................ 14 41 1.6 Registry Use Cases......................................................................................................................... 14 42 1.7 Registry Architecture........................................................................................................................ 14 43 1.7.1 Registry Clients........................................................................................................................ 15 44 1.7.1.1 Client API............................................................................................................................................ 15 45 1.7.2 Registry Service Interfaces....................................................................................................... 15 46 1.7.3 Service Interface: Protocol Bindings......................................................................................... 15 47 1.7.4 Authentication and Authorization.............................................................................................. 16 48 1.7.5 Metadata Registry and Content Repository.............................................................................. 16 49 2 Registry Protocols................................................................................................................................... 17 50 2.1 Requests and Responses................................................................................................................ 17 51 2.1.1 RegistryRequestType............................................................................................................... 17 52 2.1.1.1 Syntax:................................................................................................................................................ 17 53 2.1.1.2 Parameters:........................................................................................................................................ 18 54 2.1.1.3 Returns:.............................................................................................................................................. 18 55 2.1.1.4 Exceptions:........................................................................................................................................ 18 56 2.1.2 RegistryRequest....................................................................................................................... 18 57 2.1.3 RegistryResponseType............................................................................................................ 18 58 2.1.3.1 Syntax:................................................................................................................................................ 18 59 2.1.3.2 Parameters:........................................................................................................................................ 19 60 2.1.4 RegistryResponse.................................................................................................................... 19 61 2.1.5 RegistryErrorList....................................................................................................................... 19 62 2.1.5.1 Syntax:................................................................................................................................................ 19 63 2.1.5.2 Parameters:........................................................................................................................................ 20 64 2.1.6 RegistryError............................................................................................................................ 20 65 2.1.6.1 Syntax:................................................................................................................................................ 20 66 2.1.6.2 Parameters:........................................................................................................................................ 20 67 3 SOAP Binding......................................................................................................................................... 22 68 3.1 ebXML Registry Service Interfaces: Abstract Definition................................................................... 22 69 3.2 ebXML Registry Service Interfaces SOAP Binding.......................................................................... 22 70 3.3 ebXML Registry Service Interfaces SOAP Service Template.......................................................... 23 71 3.4 Mapping of Exception to SOAP Fault .............................................................................................. 23 72 4 HTTP Binding.......................................................................................................................................... 25 regrep-rs-3.0-cd-02 Mar 29, 2005 Copyright © OASIS Open 2005. All Rights Reserved. Page 2 of 127 73 4.1 HTTP Interface URL Pattern............................................................................................................ 25 74 4.2 RPC Encoding URL......................................................................................................................... 25 75 4.2.1 Standard URL Parameters....................................................................................................... 25 76 4.2.2 QueryManager Binding............................................................................................................. 26 77 4.2.2.1 Sample getRegistryObject Request....................................................................................................26 78 4.2.2.2 Sample getRegistryObject Response................................................................................................