Difference between revisions of "ChangeOwnerShipInfo"
From AgileApps Support Wiki
imported>Aeric |
imported>Aeric |
||
| (5 intermediate revisions by the same user not shown) | |||
| Line 6: | Line 6: | ||
:* Own the record, | :* Own the record, | ||
:* Be a [[System Administrator]], or | :* Be a [[System Administrator]], or | ||
:* Have [[Change Ownership of my Team’s Records]] | :* Have [[Change Ownership of my Team’s Records permission]] and be working on a record that is owned by someone on your [[Team]]. | ||
{{Note|When adding a record with the [[addRecord]] method, it is only necessary to specify the owner in the requestParams:<br> <tt>requestParams.add("owner_id", "new user id");</tt>}} | {{Note|When adding a record with the [[addRecord]] method, it is only necessary to specify the owner in the requestParams:<br> <tt>requestParams.add("owner_id", "new user id");</tt>}} | ||
| Line 13: | Line 13: | ||
:<syntaxhighlight lang="java" enclose="div"> | :<syntaxhighlight lang="java" enclose="div"> | ||
Result result; | Result result; | ||
result = Functions.changeOwnerShipInfo(String | result = Functions.changeOwnerShipInfo(String objectName, String recordId, | ||
String ownerId [, | String ownerId [, Boolean notifyEmail] ); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
;Parameters: | ;Parameters: | ||
:''' | :'''objectName -''' The object name or identifier | ||
:'''recordId -''' The record identifier | :'''recordId -''' The record identifier | ||
:'''ownerId -''' User ID of the new owner. | :'''ownerId -''' User ID of the new owner. | ||
:''' | :'''notifyEmail-''' An optional parameter. Set to true to send the new owner an email notification. | ||
;Returns: | ;Returns: | ||
:[[Result Class|<tt>Result</tt>]] object<br/> | :[[Result Class|<tt>Result</tt>]] object<br/> | ||
;Throws: | ;Throws: | ||
Latest revision as of 00:34, 18 November 2014
Change the owner of a record.
- Requirements
To perform this operation, you must either:
- Own the record,
- Be a System Administrator, or
- Have Change Ownership of my Team’s Records permission and be working on a record that is owned by someone on your Team.
Note: When adding a record with the addRecord method, it is only necessary to specify the owner in the requestParams:
requestParams.add("owner_id", "new user id");
- Syntax
- <syntaxhighlight lang="java" enclose="div">
Result result; result = Functions.changeOwnerShipInfo(String objectName, String recordId,
String ownerId [, Boolean notifyEmail] );
</syntaxhighlight>
- Parameters
- objectName - The object name or identifier
- recordId - The record identifier
- ownerId - User ID of the new owner.
- notifyEmail- An optional parameter. Set to true to send the new owner an email notification.
- Returns
- Result object
- Throws
- Exception