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

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

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.

See also

Using The Adapter Objects

Additional Adapter Settings

Reference