Difference between revisions of "DeleteRecord"
From AgileApps Support Wiki
imported>Aeric |
imported>Aeric m (Text replace - '// Error dialog' to '// Error message') |
||
(8 intermediate revisions by the same user not shown) | |||
Line 4: | Line 4: | ||
'''Syntax''' | '''Syntax''' | ||
:<syntaxhighlight lang="java" enclose="div"> | :<syntaxhighlight lang="java" enclose="div"> | ||
Result result = Functions.deleteRecord(String | Result result = Functions.deleteRecord(String objectName, String recordID); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''Parameters''' | '''Parameters''' | ||
:; | :;objectName:The object name or identifier | ||
:;recordID:The identifier of the record to delete. | :;recordID:The identifier of the record to delete. | ||
:;params: | :;params: | ||
::* | ::* Turn off rules that might otherwise be triggered as a result of this action: | ||
: | |||
:::<syntaxhighlight lang="java" enclose="div"> | :::<syntaxhighlight lang="java" enclose="div"> | ||
params.add(PLATFORM.PARAMS.RECORD. | params.add(PLATFORM.PARAMS.RECORD.DO_NOT_EXEC_RULES,"1"); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Line 33: | Line 31: | ||
// Some error happened. | // Some error happened. | ||
String msg = "Account could not be deleted"; | String msg = "Account could not be deleted"; | ||
Logger.info(msg + ":\n" + result.getMessage(), "Delete"); // Log details | |||
Functions.throwError(msg + "."); // Error | Functions.throwError(msg + "."); // Error message | ||
} | } | ||
else | else |
Latest revision as of 22:30, 10 September 2013
Delete a record.
Syntax
- <syntaxhighlight lang="java" enclose="div">
Result result = Functions.deleteRecord(String objectName, String recordID); </syntaxhighlight>
Parameters
- objectName
- The object name or identifier
- recordID
- The identifier of the record to delete.
- params
-
- 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>
- Return
- Result object
- Example
- This example calls deleteRecord, 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">
String accountID = ""; // Some logic to populate accountID variable. Result result = Functions.deleteRecord("ACCOUNT", accountID); int resultCode = result.getCode(); if(resultCode < 0) {
// Some error happened. String msg = "Account could not be deleted"; Logger.info(msg + ":\n" + result.getMessage(), "Delete"); // Log details Functions.throwError(msg + "."); // Error message
} else {
// Take other actions on successful addition // of the account.
} </syntaxhighlight>