createLMChildCustomer

Sets up the basic information for a new customer, but does not set up pool, product or license information.

Parameters:

Field
Type
Required Description
sessionid String yes The sessionid returned by loginLMLicensee()
licensee String yes The company code (not the company name) for the Licensee.
customerData CustomerSetupInfo yes A structure defining the top-level information for the new customer.

CustomerSetupInfo

Field
Type
Description
code String The company code for the customer. If this is left blank then a code will be generated for you.
libraryData Array of String A list of library codes to be assigned to the customer initially.
name String The English name of the customer, for display purposes.
parentCustomer String The company code for the customer of which this will become a sub-customer.
responsiblePaties Array of String A list of email addresses for "responsible parties" for the new customer. (optional)
variableData Array of VarValueInfo A list of initial customer-level variable values to set.

VarValueInfo

Field
Type
Description
name String The name of the variable to set.
value String The value to set, if this is a non-list variable.
valueList Array of String The values to set, if this is a list variable.

Return values: A StringData structure:

Field
Type
Description
fault FaultData If an error has occurred on the server, this will contain information about the error. This field will be null if no error occurred.
data String The company code for the new customer. Useful if the company code was generated by the server.

Example:

NitroAdminAccessServiceLocator service = new NitroAdminAccessServiceLocator();
NitroAdminAccess server = service.getNitroAdminAccess();

VarValueInfo val1 = new VarValueInfo();
val1.setName("VAR1");
val1.setValue("Y");

CustomerSetupInfo ci = new CustomerSetupInfo();
ci.setLibraryData(new String[] {"as09gjal23g9fsx.ei2e"});
ci.setName("Customer 1");
ci.setParentCustomer("testcust");
ci.setResponsibleParties(new String[] {"john@smith.com"});
ci.setVariableData(new VarValueInfo[] {val1});

StringData ret = server.createLMChildCustomer(sessionid, "smith", ci);
if (ret.getFault()!=null) {
	System.err.println("Error: " + ret.getFault().getFaultString());
	return;
}
System.out.println("New company's code: " + ret.getData());
Comments