Granting Access

Grant fields allow you to create, modify, and revoke access.

You can use grant fields to grant access to a given record to users and teams without changing the record's ownership.

Note:

You can only grant the rights that are allowed by the object.
If you have selected the Validate Microsoft Dynamics 365 picklist field object in the Adapter Settings dialog box, using the sum of two grant rights picklist values causes an error. For more information about adapter settings, see Additional Adapter Settings.

To Grant Access To An Object

Grant a single access right — Enter the value from the chart below.
Grant multiple access rights — Add the values of the rights you want to grant and enter the sum.

For example, the account object does not support AppendTo or Create. Therefore, to grant all available rights for the account object, use 851975 (1+ 2 + 4 + 65536 + 262144 + 524288).

Virtual Field	Value	Description
vfGrantAction	"Grant"	Adds the given access right to the rights that already exist for the user or team.
	"Modify"	Replaces the rights with the rights specified.
	"Revoke"	Revokes all access rights.
vfGranteeId	—	The ID of the user or team.
vfGranteeType	8	User
vfGranteeType	9	Team
vfGrantRights	852023	Grant all rights.
	1	Grant READ rights. A user must have READ rights to have write, delete, or any other access to an object.
	2	Grant WRITE rights.
	4	Grant APPEND rights.
	16	Grant APPENDTO rights.
	32	Grant CREATE rights.
	65536	Grant DELETE rights.
	262144	Grant SHARE rights.
	524288	Grant ASSIGN rights.

Example

Let's say you want to allow the Northeast sales team to modify a set of accounts that you are loading. When inserting the records, set the grant fields as follows:

vfGrantAction. "Grant"
vfGranteeId. "{xxxxxxxxxxxx}" (the ID of the Northeast team)
vfGranteeType. 9 (for team)
vfGrantRights. 852023 (all rights allowed for accounts)

After inserting the account records, the adapter grants the given rights to the Northeast team on the record that was just inserted.