Nortel Networks Personal Agent AS 5300 Manuel d'utilisateur

Nortel AS 5300Nortel Application Server 5300Application ProgrammingInterfaces ReferenceRelease: 1.0Document Revision: 01.01www.nortel.comNN42040-110.

10 Application Programming Interface fundamentalsstandard, service providers rapidly develop client-side code with standardtoolsets. A detailed descri

Bulk Provisioning Tool fundamentals 11database with the BPT and compared against active subscribers listedin the Internet Protocol Detail Record (IPDR

12 Application Programming Interface fundamentalsNortel AS 5300Nortel Application Server 5300 Application Programming Interfaces ReferenceNN42040-110

13.Using the Bulk Provisioning ToolThis chapter contains all of the information you need to use the AS 5300Bulk Provisioning Tool (BPT).Navigation•&qu

14 Using the Bulk Provisioning ToolFigure 1BPT main menuAn arrow following a menu item indicates a submenu. Choose thesubmenu by entering the menu ite

BPT main menu 15Entering 0 (zero) returns you to the parent of a submenu.The provisioning method name appears inside the parentheses that followthe pr

16 Using the Bulk Provisioning ToolTable 3BPT main menu commands (cont’d.)CommandDescriptionexecute <file name>Execute all the methods contained

BPT conventions and examples 17Files must use a specific syntax for a BPT provisioning method to beinvoked successfully on the Provisioning Server. Yo

18 Using the Bulk Provisioning ToolOptional syntaxIn BPT provisioning method syntax, the word [optional] indicates that whatfollows is optional and is

BPT conventions and examples 19Square bracketsSquare brackets ([ ]) in the syntax indicate a string of variables, separatedby commas. The square brack

Nortel AS 5300Release: 1.0Publication: NN42040-110Document status: StandardDocument release date: 11 June 2008Copyright © 2008 Nortel NetworksAll Righ

20 Using the Bulk Provisioning ToolComma separated stringsProvisioning method syntax can include a string of comma-separatedvariables. For example, th

BPT conventions and examples 21Unknown error messagesIf an unknown error occurs when invoking a method, the BPT promptsthe administrator to check the

22 Using the Bulk Provisioning ToolAdd the new provisioning roleTo add the new role, enter the following in the BPT command line:addRole using file D:

BPT conventions and examples 23Figure 4getRole method invoked in the BPTThe BPT returns the following information:[AddExample,BPT add example,[[Domain

24 Using the Bulk Provisioning ToolFigure 5removeRole method invoked on the BPTBPT Help optionBPT provisioning methods are identical to OPI provisioni

BPT limitations 25Figure 6Invoking a help command in the BPTAttention: The BPT Help function only contains the syntax of the BPT(OPI) provisioning met

26 Using the Bulk Provisioning ToolIn most cases, variables and properties used by the BPT provisioningmethods map to fields in the Provisioning Clien

BPT limitations 27Provisioning data visibilityProvisioning data added using the BPT is immediately available to otherprovisioning clients connected to

28 Using the Bulk Provisioning ToolNortel AS 5300Nortel Application Server 5300 Application Programming Interfaces ReferenceNN42040-110 01.01 Standard

29.Using the Open Provisioning InterfaceThis chapter contains all of the information you need to use the OpenProvisioning Interface.Navigation•"S

3.ContentsNew in this release 5Other changes 5Introduction 7Audience 7Related documents 7Application Programming Interface fundamentals 9Open Provisio

30 Using the Open Provisioning InterfaceAuthenticationThe Provisioning Server authenticates each request to ensure that therequest is received from a

Security, authentication, and authorization 31Figure 8Sample WS-Security header/SOAP messageA special note for .NET authentication headersThe authenti

32 Using the Open Provisioning InterfaceFigure 9Setting authentication headersAuthorizationAfter the OPI request is authenticated, you must be authori

Third-party client development 33across these categories. Upon creation, the administrator is assignedto a particular role. This enables the service p

34 Using the Open Provisioning InterfaceFigure 10Interactions of the stubYou generate stubs using a supported toolset. Currently, only the1.3 Final ve

35.Starting the Bulk Provisioning ToolThis chapter contains the procedures necessary to start the BulkProvisioning Tool (BPT) on a remote workstation.

36 Starting the Bulk Provisioning ToolNavigation•"Downloading the Bulk Provisioning Tool to a workstation" (page 36)• "Launching the BP

Launching the BPT on a workstation 37The BPT application launches.2Enter your administrator username and password.The Bulk Provisioning Tool main menu

38 Starting the Bulk Provisioning ToolNortel AS 5300Nortel Application Server 5300 Application Programming Interfaces ReferenceNN42040-110 01.01 Stand

39.Creating Open Provisioning InterfaceclientsThis chapter describes the steps necessary to create Open ProvisioningInterface (OPI) clients and provid

4Get the WSDL 33Generate stubs 33Implement interface accessing stubs 34Access stubs from the third-party application 34Starting the Bulk Provisioning

40 Creating Open Provisioning Interface clientsFigure 12Task flow for creating OPI clientsNavigation•"Downloading the Axis toolkit" (page 41

Configuring the class path 41Downloading the Axis toolkitUse this procedure to download the AXIS toolkit version 1.3 Final. TheAxis 1.3 Final toolkit

42 Creating Open Provisioning Interface clientsset CLASSPATH= D:\axis-1_4\webapps\axis\WEB-INF\lib\axis.jar;D:\axis-1_4\webapps\axis\WEB-INF\lib\axis-

Writing a client to perform some specific OPI operations 43This creates the client stubs under D:\opiclient\com\client\opi\serviceThe stubs contain al

44 Creating Open Provisioning Interface clients2Instantiate a URL object that will point to the Provisioning Serverlocation and the OPI web service ru

Writing a client to perform some specific OPI operations 45The client class can be compiled similarly to the compilation of the OPIStubs, and executed

46 Creating Open Provisioning Interface clientsFigure 13Compiling the client classNortel AS 5300Nortel Application Server 5300 Application Programming

47.Accessing the OPI Java docsThis procedure describes how to access the Open Provisioning Interface(OPI) Java docs. These Java docs represent the var

48 Accessing the OPI Java docsFigure 14OPIJavadocs file unzipped2 Click on the subfolder for the OPI web service category you wishto query or use.For

Writing a client to perform some specific OPI operations 49Figure 15Accessing the javadocs for the AdminAuthentication OPI webservice3 Double-click on

5.New in this releaseThis chapter details what’s new in Nortel AS 5300 ApplicationProgramming Interface Reference, NN42040-110 for Nortel ApplicationS

50 Accessing the OPI Java docsNortel AS 5300Nortel Application Server 5300 Application Programming Interfaces ReferenceNN42040-110 01.01 Standard11 Ju

51.Importing a CA Certificate into the BPTUse this procedure to import a Certificate Authority (CA) certificate intothe opitruststore.Procedure StepsSt

52 Importing a CA Certificate into the BPTNortel AS 5300Nortel Application Server 5300 Application Programming Interfaces ReferenceNN42040-110 01.01 S

Nortel AS 5300Nortel Application Server 5300 Application ProgrammingInterfaces ReferenceCopyright © 2008 Nortel NetworksAll Rights Reserved.Release: 1

6 New in this releaseNortel AS 5300Nortel Application Server 5300 Application Programming Interfaces ReferenceNN42040-110 01.01 Standard11 June 2008Co

7.IntroductionThis document discusses the Nortel Application Server (AS) 5300Application Programming Interface (API) available to third party clientsf

8 IntroductionNortel AS 5300Nortel Application Server 5300 Application Programming Interfaces ReferenceNN42040-110 01.01 Standard11 June 2008Copyright

9.Application Programming InterfacefundamentalsThe Application Server (AS) 5300 provides Application ProgrammingInterface (API) support for third-part