GrantTokenRequest

(Control Token Manager)

Description:	Grants a control token request.
Returns:	Nothing
Usage:	Script Only.
Function Groups:	(Control Token Manager)
Related to:	CanControl (Control Token Manager) | CanDenyTokenRequest | CanGrantTokenRequest | CanReleaseToken | CanRequestToken | DenyTokenRequest | GetToken (Control Lock Module) | GetTokenLevel | GrantTokenRequest | ReleaseToken | RequestToken |
Format:	ControlTokenManager.GrantTokenRequest(TagID, TokenRequestGUID[, Custom, Timestamp, SessionID, AccountID, MachineID, Device])
Parameters:

TagID

Required string. The UniqueID of the tag for which the token request is to be granted.

TokenRequestGUID

Required string. The GUID of the token request to grant. (Must be obtained via your script code. See: GetToken (Control Lock Module))

Custom

Optional. A structure of custom fields to log

Timestamp

Optional The UTC timestamp of this event. Defaults to current time

SessionID

Optional. The ID of session granting the request. Relevant only if the token ownership is tied to the session.

AccountID

Optional. The Account ID of user granting the request. Defaults to the currently signed-in user.

MachineID

Optional. The MachineID of the workstation where this action originated. Defaults to the current machine.

Device

Optional. Name of client device

Comments:

If someone currently has that same token, granting the request will release the current token and replace it with the one requested. This function is intended for advanced users. The provided widgets should suffice in most instances.