Nortel AS 5300 Application Programming Interface page 20

20 Using 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 Application Server 5300 Application Programming Interfaces Reference
Copyright © 2008 Nortel Networks
.
Nortel AS 5300
NN42040-110 01.01 Standard
11 June 2008