Nortel Networks AS 5300 manual Comma separated strings, Fully qualified user name

20Using the Bulk Provisioning Tool

Comma separated strings

Provisioning method syntax can include a string of comma-separated variables. For example, the following is the syntax for the addAdmin provisioning method:

addAdmin using ([The Admin user name,Password,Admin First Name,Admin Last Name,Admin Status,Admin Email Address,Office Phone Number,Home Phone Number,Cell Phone Number,Pager Number,Fax Number,Voicemail Number,VPN Number,System defined role,Time Zone,Locale,Provisioning Role,[The list of Domains that he is assigned to, .. ,The list of Domains that he is assigned to]]) file <file name> [optional] into <file name>

Follow the required format when invoking the provisioning method from the BPT command line or using a file. If nothing appears between two commas, the associated field in the database is not updated. For example, the following addAdmin provisioning method contains minimal administrator information, but still requires the commas to denote the blank fields: addAdmin using

([newguy,mysecret,John,Edwards,Active,,,, ,,,,,Default

Admin,,English,Devices only,[yourcompany.com]]).

Fully qualified user name

Some methods require a fully qualified user name—a user name that is complete with the domain name (for example, joe@mydomain.com). This information is available in the Provisioning Client field descriptions.

Success indication on remove methods

Some BPT provisioning methods can remove data, and return an indication of success even if the data did not preexist in the database. This mirrors the functionality of the database. A success indication for a remove provisioning method, indicates that the associated data no longer exists in the database.

When possible, BPT provisioning methods provide additional indication (in the form of an error message) regarding specific data elements (domain and devices) that are not preexisting in the database when the remove method is invoked. These messages appear on the BPT screen.

For example, if the domain nn.com does not exist, an invocation of removeUser using (jimbob@nn.com) returns an error indication of Invalid Data: Domain Not found ’nn.com’, because the domain is not valid.

If the domain is valid and the user is not preexisting, then a success indication is returned, because the user is not configured on the system.

Nortel AS 5300

Nortel Application Server 5300 Application Programming Interfaces Reference

NN42040-110 01.01 Standard

11 June 2008

Copyright © 2008 Nortel Networks