Amdocs Web Service Factory
Amdocs Web Service Factory 2 Contents Executive Summary...1 Architecture...3 Components...5 Service Design...7 Service Implementation...9
Amdocs Web Service Factory 3 Executive Summary The Amdocs Web Service Factory (WSF) provides highquality web services exposing the Amdocs portfolio API s to external systems. WSF web services provide a coherent, precise and well-documented interface based on a common information model - the Amdocs Portfolio Information Model (PIM), which is an implementation of the TMF SID model. WSF focuses on interoperability and integration, providing a thin abstraction layer on top of the Amdocs product API s that mediates between the web service interface and the product-specific interface. WSF enables evolutionary refinement by decoupling the public interfaces from the API implementation and allowing for effective service versioning. The WSF runtime infrastructure is based on leading, industry-standard, open-source components, such as Apache Tomcat, that have a proven, reliable track record and provide a scalable architecture. WSF employs a factory-style release process by which bundles of services are released on a recurring basis with no dependence on the general Amdocs product release cycle. This independence enables the factory to respond to changing customer priorities and market developments. WSF reduces project costs by saving the customer from having to map Java-based product API s to XML-based web services. Customization time is further reduced by the adoption of common data structures and best practices. WSF is designed for consumption by ESB s and BPM tools without additional customization, and it handles all integration aspects (such as security) reducing the need for custom solutions.
Amdocs Web Service Factory 4 Architecture WSF services mediate between the common information model provided by the web service interface and the product-specific model provided by each product s API. web service interfaces with consistent data semantics based on a common information model (sid) PRODUCT API s WITH PRODUCT SPECIFIC INFORMATION MODELS cm replenishment External esb/bpm http(/s)/soap web service gateway ejb/rmi(/ssl) ar srm ordering Interoperability is the highest priority here! tomcat / cxf Performance is the highest priority here! invoicing online charging sales engine MCSS CRM Figure 2.1 Web Service Factory Architecture WSF web services are deployed to a gateway implemented using the Spring framework and Apache CXF, and hosted by Apache Tomcat. The gateway handles all aspects of security using the WS Security standard, supporting stateless username/password credentials, and SAML token.
Amdocs Web Service Factory 5 Components WSF consists of three principal components: A Software Development Kit (SDK) comprising: Development guidelines Data type vocabulary Validation tools Reference source code of provided web services Packaging and configuration tools Eclipse STS (Spring Tool Suite) for development Apache Maven for build A Runtime environment comprising: Monitoring capabilities (Amdocs Monitoring Framework) Tomcat server for service deployment A Web service bundle containing well-designed services according to delivery priorities and broken down to atomic operations required by customers.
Amdocs Web Service Factory 6 Service Design WSF web service design is inspired by the UN/CEFACT CCTS standard. All services operate on a common information model that defines the vocabulary and semantics of the information. Each service operation uses a subset of this model appropriate to the business context of the operation. These business context models are a restriction of the common model according to well-defined rules. Web services are designed by means of a model-first approach. The model is expressed in annotated Java that acts as metadata for the resulting WSDL and XSD. Java is used to leverage the sophisticated tooling provided by Eclipse. Common Model The common model includes all types in the information model, and is unqualified by any business context. These types are copied and restricted to form qualified business context models used by the services. Business Context Model Service Validation XSD WSDL Validation Validation here ensures that the service model is a proper qualification of the common model Validation here ensures that the WSDL complies to WS-I B(S)P 1.x. Figure 4.1 Service Design for Web Service Factory
Amdocs Web Service Factory 7 Service Implementation The WSDL/XSD is imported into Apache CXF, to generate the Service Endpoint Interface (SEI) and the implementation skeleton. Mapping of the contract to the backend API is done manually as a part of this phase. The finished service is built into a WAR for deployment. XSD JAVA war WSDL Figure 5.1 Service Implementation for Web Service Factory
About Amdocs For 30 years, Amdocs has ensured service providers success and embraced their biggest challenges. To win in the connected world, service providers rely on Amdocs to simplify the customer experience, harness the data explosion, stay ahead with new services and improve operational efficiency. The global company uniquely combines a market-leading BSS, OSS and network control product portfolio with value-driven professional services and managed services operations. With revenue of $3.2 billion in fiscal 2012, Amdocs and its 20,000 employees serve customers in more than 60 countries. Amdocs: Embrace Challenge, Experience Success. For more information, visit Amdocs at www.amdocs.com Amdocs has offices, development and support centers worldwide, including sites in: THE AMERICAS: ASIA PACIFIC: EUROPE, MIDDLE EAST & AFRICA: BRAZIL AUSTRALIA Austria ISRAEL SPAIN CANADA CHINA CYPRUS kazakhstan SWEDEN COSTA RICA INDIA CZECH REPUBLIC THE NETHERLANDS UNITED KINGDOM MEXICO JAPAN FRANCE POLAND United Arab Emirates - Dubai UNITED STATES Philippines GERMANY RUSSIA Singapore IRELAND SOUTH AFRICA Taiwan THAILAND VIETNAM For the most up-to-date contact information for all Amdocs offices worldwide, please visit our website at www.amdocs.com/corporate.asp Copyright 2013 Amdocs. All Rights Reserved. Reproduction or distribution other than for intended purposes is prohibited, without the prior written consent of Amdocs. The trademarks and service marks of Amdocs, including the Amdocs mark and logo, Intentional Customer Experience, CES, Clarify, Ensemble, Enabler, Return on Relationship, Intelecable, Collabrent, XACCT, DST Innovis, Stibo Graphic Software, Qpass, Cramer, SigValue, JacobsRimell, ChangingWorlds, jnetx, OpenMarket Inc., MX Telecom Inc., MX Telecom Ltd, Streamezzo, and Bridgewater Systems are the exclusive property of Amdocs, and may not be used without permission. All other marks are the property of their respective owners. Created 01/2013