Nortel Networks NN42020-123 manual Get the Wsdl, Generate stubs

Page 9

Copyright © Nortel Networks Limited 2006

9

Get the WSDL

The WSDL file for MCS is stored on the server hosting the Provisioning Module. You can view and download the WSDL using a web browser.

Note: By definition, all the OPI commands (methods) are listed in the WSDL.

From a workstation

1Open a web browser

2To display the WSDL in the web browser, navigate to the following URL

http://<provclientIP>/prov/services/OPI?WSDL

Where:

<provclientIP> is the IP address used by the Provisioning Client

3Download the WSDL file

Generate stubs

The stub is basically a translator. It takes the “user” object (whatever type of object) from the interface and converts it to a SOAP message and sends it to the Provisioning Module. Likewise, a SOAP message from the Provisioning Module is translated back to the object. HTTP is used as the transport for OPI. The Provisioning Module listens on port 80 for the SOAP over HTTP messages.

Figure 2 Interactions of the stub

Third Party

Application

object

Stub

 

SOAP over HTTP

 

 

 

 

 

Provisioning Module

port 80

Stubs are generated using a supported toolset. Currently, only the Apache AXIS 1.0 (Apache extensible Interaction System http://ws.apache.org/axis) toolset has been tested and approved. AXIS is Java specific and creates a Java stub. The OPI WSDL may work with other toolsets, but thorough testing has not yet been completed. Other

Open Provisioning Interface Reference Guide

Image 9
Contents Multimedia Communication Server Page Finding the latest updates on the Nortel Web site Page Getting help from the Nortel web site Getting help over the phone from a Nortel Solutions CenterGetting help through a Nortel distributor or reseller Open Provisioning Interface introduction Web Services Description Language WsdlLogical view of OPI interactions Third party client developmentGenerate stubs Get the WsdlImplement interface accessing stubs Authentication and authorizationAccess stubs from the third-party application AuthenticationDomain-level authorization Provisioning-Level authorization AuthorizationSuccess indication on remove methods Provisioning InterfaceExample Deprecated methods and method fieldsProvisioning data visibility PROV606 logsDeprecated method elements Sheet 1 Affected method Affected method Deprecated method element Deprecated method elements Sheet 2Page Building OPI Stubs Clients RequirementsDownloading the Axis toolkit Procedure 1 Downloading the Axis toolkit Setting the ClasspathProcedure 2 Setting the Classpath Procedure 3 Downloadin the Wsdl file Compiling the stubs Procedure 4 Compiling the stubsDownloading the Wsdl file \opiclient\com\client\opi\service Writing a client to perform some specific OPI operations Copyright Nortel Networks Limited Two examples Example creating a user route to screen two numbers Page Example creating a route using simultaneous ringing Page Special note on .NET authentication headers Error codes and messages Error Code Error Message Data-Access error messagesDirectoriesImpl error messages Error Code Error Message AddressBookImpl error messages Error Code Error Message Error Code Error Message Error Code Error Message UserServicePkgImpl error messages UserMgrImpl error messages Error Code Error Message RouteMgrImpl error messages DomainMgrImpl error messagesError Code Error Message AddressBookGroupCondMgr error messages GlobalAddrBookCondMgr error messagesPersonalAddrBookCondMgr error messages PhoneNumberCondMgr error messages TimeBlockGroupCondMgr error messagesBannedSubscriberMgrImpl error messages DomainCosMgrImpl error messages TimeZoneMgrImpl error messages DomainProfileMgrImpl error messagesStatusReasonMgrImpl error messages ServiceMgrImpl error messages Error Code Error Message UserPropertiesServlet error messages VoicemailMgrImpl error messages UserDataMgrImpl error messagesDeviceMgrImpl error messages IPCMMgrImpl error messages UserTimeMgrImpl error messages Error Code Error Message Error Code Error Message Page Page Multimedia Communication Server