Roles de seguridad y plantillas

Debe usar RoleTemplateId al intentar buscar o procesar roles de seguridad de Microsoft Dataverse. Estos identificadores de plantilla de rol son únicos y constantes en todos los entornos. Si intenta usar identificadores de rol, puede producirse un error porque los identificadores de rol no son únicos para un rol de seguridad determinado.

Importante

Un rol de seguridad puede existir en la unidad de negocio raíz (BU) y replicarse en diferentes BU y, por tanto, el identificador de rol no es único en todos los entornos.

Más información: Entornos con una base de datos de Dataverse

Plantillas de rol estándar

A continuación se muestra una lista de GUIDs de plantillas de roles estándar que existen en todos los entornos.

public const string SystemAdmin = "{627090FF-40A3-4053-8790-584EDC5BE201}";
public const string Customizer = "{119F245C-3CC8-4b62-B31C-D1A046CED15D}";
public const string Support = "{2D101BB3-5CED-4122-83F1-94D5EFDE4E3B}";
public const string Proxy = "{D892CC0B-28C7-4e88-BD92-72F2C366BAED}";
public const string BasicUser = "{236750CD-45AE-4939-AB12-B24B920CED93}";
public const string BizMgr = "{85937B6B-91A1-46ED-9778-929FC9F61812}";
public const string VPSales = "{29123793-6AE5-4955-9F1A-F10CEB9705F1}";
public const string SalesMgr = "{C0ED2F4F-6F92-4691-92BA-78F2931E8FBA}";
public const string SalesRep = "{A4BE89FF-7C35-4D69-9900-999C3F603E6F}";
public const string CSR = "{ECFD0B44-5720-45E3-AE68-417DDB0FB654}";
public const string CSRMgr = "{1808B939-DD07-4CA7-AA99-DDD2734378F1}";
public const string MarketingProfessional = "{09A25608-D28B-4D47-B57C-79271FE6A525}";
public const string ScheduleMgr = "{DEBEC338-BCA7-4882-AE04-84E6DDDA2984}";
public const string VPMarketing = "{6CABA073-59A8-4D6B-8E7B-4CCB50C5166B}";
public const string MarketingMgr = "{D9D602DB-2761-4170-877F-983494567C08}";
public const string Scheduler = "{DCD60B89-421C-44ae-BFF0-DD6323DF885C}";
public const string KnowledgeMgr = "{B4B40B17-CF37-4EA8-B2C5-B580F2F48654}";

Uso de las plantillas de rol

Echemos un vistazo a algún código que muestra el uso de las plantillas de rol.

Esta solicitud de API web devuelve un rol administrador del sistema mediante la plantilla. Los parámetros en <> quedan para que los complete.

http://<env-name>.api.<region>.dynamics.com/api/data/v9.1/roles(_roletemplateid_value=627090FF-40A3-4053-8790-584EDC5BE201,_businessunitid_value=<bu-ID>,componentstate=0,overwritetime=1900-01-01T00:00:00Z)

Esta solicitud HTTP devuelve un rol para los ID de rol que son constantes como el rol de EnvironmentMaker. Use esta solicitud para roles que no tengan una plantilla de rol.

http://<env-name>.api.<region>.dynamics.com/api/data/v9.1/roles(_parentrootroleid_value=<role-ID>,_businessunitid_value=<bu-ID>,componentstate=0,overwritetime=1900-01-01T00:00:00Z)

Consulte también

Referencia de API web
Plantilla de Roles Tipo de Entidad

Referencia de tabla/entidad
Rol de seguridad (rol)

Conceptos
Configurar la seguridad del usuario a recursos en un entorno