AgileApps Support Wiki Pre Release

addRecord

From AgileApps Support Wiki
Revision as of 23:40, 29 June 2011 by imported>Aeric

Add a new record to an object.

Syntax

Result result = Functions.addRecord(String objectID, Parameters params);

Parameters

objectID
The Object to add the record to.
params
  • The field-value pairs for the object you are adding.
Return
Result object

Notepad.png

Note: The Result object contains the record ID for the new record. Use Result.getID to retrieve it.

Example #1: Add a Record to the Account Class

This example creates an instance of Parameters and adds name-value pairs to it. The code then calls addRecord, assigning the returned value to an instance of Result and calling Result.getCode to assign the error code to a variable which is then conditionally checked to determine the code to execute. If the call was not successful, the code calls throwError to display an error dialog. A

Parameters params = Functions.getParametersInstance();
params.add("name", "Acme Solutions");
params.add("number", "GRG2323339");
Result result = Functions.addRecord("ACCOUNT", params);
int resultCode = result.getCode();
if(resultCode < 0)
{
    // Some error happened. 
    String msg = "Account could not be added";
    Functions.debug(msg + ":\n" + result.getMessage());  // Log details
    Functions.throwError(msg + ".");                     // Error dialog
}
else 
{
    // Take other actions on successful addition
    // of the account
}


Example #2: Add a Record with a Multi Object Lookup field

This example add a record to an object that contains a Multi Object Lookup, where:

  • Books is an object that contains a MultiObject Lookup field
  • libraryBook is a Multi Object Lookup field that points to a particular library and the book it came from
  • e5fadf228160483b81ea8d84c71259c9 is the ID of the Library object that contained the book
  • 767645492 is the record ID of the book in that library
Parameters params = Functions.getParametersInstance();
params.add("title", "A Good Book"); 
params.add("libraryBook", "e5fadf228160483b81ea8d84c71259c9:767645492"); 
                                    //  {library_object_id}:{record_id}
Result result = Functions.addRecord("Books", params); 
int resultCode = result.getCode();
if(resultCode < 0)
{
    // Some error happened. 
    String msg = "Book record could not be added";
    Functions.debug(msg + ":\n" + result.getMessage());  // Log details
    Functions.throwError(msg + ".");                     // Error dialog
}
else
{
    // Successful add. Take other actions, as needed.
}