AgileApps Support Wiki Pre Release

addRecord

From AgileApps Support Wiki

The addRecord Java API helps in performing the following operations:

  • Adding a new record to an object.
  • Creating a new platform user in AgileApps.

Adding a new record to an object

Syntax

<syntaxhighlight lang="java" enclose="div">

Result result = Functions.addRecord(String objectName, Parameters params); </syntaxhighlight>

Parameters

  • objectName - The Object to add the record to.
  • params:
    • The field-value pairs for the object you are adding.
    • Turn off rules that might otherwise be triggered as a result of this action:
<syntaxhighlight lang="java" enclose="div">

params.add(PLATFORM.PARAMS.RECORD.DO_NOT_EXEC_RULES,"1"); </syntaxhighlight>

  • Pass file parameters in the current request to any subsequent API calls made in a data policy defined on this object:
<syntaxhighlight lang="java" enclose="div">

params.add(PLATFORM.PARAMS.RECORD.ENABLE_MULTIPART,"1"); </syntaxhighlight>

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.

<syntaxhighlight lang="java" enclose="div">

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";
   Logger.info(msg + ":\n" + result.getMessage(), "Account");  // Log details
   Functions.throwError(msg + ".");                            // Error message

} else {

   // Take other actions on successful addition
   // of the account

} </syntaxhighlight>

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 book and the library it came from
  • 9978946545 is the ID the library object that contains the book.
    (Object ID must be specified. Object name will not work.)
  • 767645492 is the record ID of the book in that library
<syntaxhighlight lang="java" enclose="div">

Parameters params = Functions.getParametersInstance(); params.add("title", "A Good Book"); params.add("libraryBook", "9978946545:767645492");

                 //  {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";
   Logger.info(msg + ":\n" + result.getMessage(), "Library");  // Log details
   Functions.throwError(msg + ".");                            // Error message

} else {

   // Successful add. Take other actions, as needed.

}</syntaxhighlight>


Creating a new platform user in AgileApps

You can create a new platform user in AgileApps by using addRecord Java API. Place the following code in the call method and invoke this from the business rule.

Example:

<syntaxhighlight lang="java" enclose="div">

Parameters userParams = Functions.getParametersInstance();

userParams.add("first_name","John");

userParams.add("last_name", "Bob");

userParams.add("email", "xxx@softwareag.com");

userParams.add("username","john.bob");

userParams.add("time_zone", "23"); // Get the value of the select box option from the browser inspector

userParams.add("team_id", "xxx"); // Get the respective id from teams.

userParams.add("access_profile_id", "xxx"); // Get the respective id from access profiles.

userParams.add("user_type", "P"); // Platform user

userParams.add("notify_by_email", "0"); // 1=send message with system-generated password. 0=don't

userParams.add("password", "xxxx"); // Set a fixed initial password when notify_by_email is 0.

userParams.add("application_id", "xxx"); // Get the respective id from applications list.

userParams.add("role_id", "xxxx"); // Get the role id from application roles

Result r = Functions.addRecord("USER", userParams);

if (r.getCode() < 0) {

 String msg = "Error while adding User record:\n"+ r.getMessage();
 // To show the error in the UI.   

Functions.throwError(msg);

} else {

// have code for successful user creation </syntaxhighlight>