Referencia de tabla o entidad Security Role (Role)

Nota

¿No está seguro de tabla frente a entidad? Vea Desarrolladores: comprender la terminología en Microsoft Dataverse.

Grouping of security privileges. Users are assigned roles that authorize their access to the Microsoft CRM system.

Mensajes

Mensaje Operación de API web Método o clase de SDK
AddPrivilegesRole AddPrivilegesRole Action AddPrivilegesRoleRequest
Create POST [org URI]/api/data/v9.0/roles
Vea Crear
CreateRequest o
Create
Delete DELETE [org URI]/api/data/v9.0/roles(roleid)
Vea Eliminar
DeleteRequest o
Delete
RemovePrivilegeRole RemovePrivilegeRole Action RemovePrivilegeRoleRequest
ReplacePrivilegesRole ReplacePrivilegesRole Action ReplacePrivilegesRoleRequest
Retrieve GET [org URI]/api/data/v9.0/roles(roleid)
Vea Recuperar
RetrieveRequest o
Retrieve
RetrieveAadUserRoles RetrieveAadUserRoles Function RetrieveAadUserRolesRequest
RetrieveMultiple GET [org URI]/api/data/v9.0/roles
Vea Consultar datos
RetrieveMultipleRequest o
RetrieveMultiple
RetrieveRolePrivilegesRole RetrieveRolePrivilegesRole Function RetrieveRolePrivilegesRoleRequest
Update PATCH [org URI]/api/data/v9.0/roles(roleid)
Vea Actualizar
UpdateRequest o
Update

Propiedades

Propiedad Valor
CollectionSchemaName Roles
DisplayCollectionName Security Roles
DisplayName Security Role
EntitySetName roles
IsBPFEntity False
LogicalCollectionName roles
LogicalName role
OwnershipType BusinessOwned
PrimaryIdAttribute roleid
PrimaryNameAttribute name
SchemaName Role

Columnas/atributos que se pueden escribir

Estas columnas o atributos devuelven true para IsValidForCreate o IsValidForUpdate (generalmente ambos). Listado por SchemaName.

BusinessUnitId

Propiedad Valor
Description Unique identifier of the business unit with which the role is associated.
DisplayName Business Unit
IsValidForForm False
IsValidForRead True
IsValidForUpdate False
LogicalName businessunitid
RequiredLevel SystemRequired
Targets businessunit
Type Lookup

CanBeDeleted

Propiedad Valor
Description Tells whether the role can be deleted.
DisplayName Can Be Deleted
IsValidForForm False
IsValidForRead True
LogicalName canbedeleted
RequiredLevel SystemRequired
Type ManagedProperty

ImportSequenceNumber

Propiedad Valor
Description Unique identifier of the data import or data migration that created this record.
DisplayName Import Sequence Number
Format None
IsValidForForm False
IsValidForRead True
IsValidForUpdate False
LogicalName importsequencenumber
MaxValue 2147483647
MinValue -2147483648
RequiredLevel None
Type Integer

IsCustomizable

Propiedad Valor
Description Information that specifies whether this component can be customized.
DisplayName Customizable
IsValidForForm False
IsValidForRead True
LogicalName iscustomizable
RequiredLevel SystemRequired
Type ManagedProperty

IsInherited

Propiedad Valor
Description Role is inherited by users from team membership, if role associated with team.
DisplayName Is Inherited
IsValidForForm True
IsValidForRead True
LogicalName isinherited
RequiredLevel SystemRequired
Type Picklist

Elecciones/opciones de IsInherited

Valor Etiqueta Descripción
0 Team privileges only
1 Direct User (Basic) access level and Team privileges

Name

Propiedad Valor
Description Name of the role.
DisplayName Name
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName name
MaxLength 100
RequiredLevel SystemRequired
Type String

OverriddenCreatedOn

Propiedad Valor
DateTimeBehavior UserLocal
Description Date and time that the record was migrated.
DisplayName Record Created On
Format DateOnly
IsValidForForm False
IsValidForRead True
IsValidForUpdate False
LogicalName overriddencreatedon
RequiredLevel None
Type DateTime

RoleId

Propiedad Valor
Description Unique identifier of the role.
DisplayName Role
IsValidForForm False
IsValidForRead True
IsValidForUpdate False
LogicalName roleid
RequiredLevel SystemRequired
Type Uniqueidentifier

Columnas/atributos de sólo lectura

Estas columnas o atributos devuelven false tanto para IsValidForCreate como para IsValidForUpdate. Listado por SchemaName.

BusinessUnitIdName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName businessunitidname
MaxLength 100
RequiredLevel SystemRequired
Type String

ComponentState

Propiedad Valor
Description For internal use only.
DisplayName Component State
IsValidForForm False
IsValidForRead True
LogicalName componentstate
RequiredLevel SystemRequired
Type Picklist

Elecciones/opciones de ComponentState

Valor Etiqueta Descripción
0 Published
1 Unpublished
2 Deleted
3 Deleted Unpublished

CreatedBy

Propiedad Valor
Description Unique identifier of the user who created the role.
DisplayName Created By
IsValidForForm False
IsValidForRead True
LogicalName createdby
RequiredLevel None
Targets systemuser
Type Lookup

CreatedByName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName createdbyname
MaxLength 100
RequiredLevel None
Type String

CreatedByYomiName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName createdbyyominame
MaxLength 100
RequiredLevel None
Type String

CreatedOn

Propiedad Valor
DateTimeBehavior UserLocal
Description Date and time when the role was created.
DisplayName Created On
Format DateAndTime
IsValidForForm False
IsValidForRead True
LogicalName createdon
RequiredLevel None
Type DateTime

CreatedOnBehalfBy

Propiedad Valor
Description Unique identifier of the delegate user who created the role.
DisplayName Created By Impersonator
IsValidForForm False
IsValidForRead True
LogicalName createdonbehalfby
RequiredLevel None
Targets systemuser
Type Lookup

CreatedOnBehalfByName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName createdonbehalfbyname
MaxLength 100
RequiredLevel None
Type String

CreatedOnBehalfByYomiName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName createdonbehalfbyyominame
MaxLength 100
RequiredLevel None
Type String

IsManaged

Propiedad Valor
Description Indicates whether the solution component is part of a managed solution.
DisplayName State
IsValidForForm False
IsValidForRead True
LogicalName ismanaged
RequiredLevel SystemRequired
Type Boolean

Elecciones/opciones de IsManaged

Valor Etiqueta Descripción
1 Managed
0 Unmanaged

Valor predeterminado: 0

ModifiedBy

Propiedad Valor
Description Unique identifier of the user who last modified the role.
DisplayName Modified By
IsValidForForm False
IsValidForRead True
LogicalName modifiedby
RequiredLevel None
Targets systemuser
Type Lookup

ModifiedByName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName modifiedbyname
MaxLength 100
RequiredLevel None
Type String

ModifiedByYomiName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName modifiedbyyominame
MaxLength 100
RequiredLevel None
Type String

ModifiedOn

Propiedad Valor
DateTimeBehavior UserLocal
Description Date and time when the role was last modified.
DisplayName Modified On
Format DateAndTime
IsValidForForm False
IsValidForRead True
LogicalName modifiedon
RequiredLevel None
Type DateTime

ModifiedOnBehalfBy

Propiedad Valor
Description Unique identifier of the delegate user who last modified the role.
DisplayName Modified By (Delegate)
IsValidForForm False
IsValidForRead True
LogicalName modifiedonbehalfby
RequiredLevel None
Targets systemuser
Type Lookup

ModifiedOnBehalfByName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName modifiedonbehalfbyname
MaxLength 100
RequiredLevel None
Type String

ModifiedOnBehalfByYomiName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName modifiedonbehalfbyyominame
MaxLength 100
RequiredLevel None
Type String

OrganizationId

Propiedad Valor
Description Unique identifier of the organization associated with the role.
DisplayName Organization
IsValidForForm False
IsValidForRead True
LogicalName organizationid
RequiredLevel SystemRequired
Type Uniqueidentifier

OrganizationIdName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName organizationidname
MaxLength 100
RequiredLevel SystemRequired
Type String

OverwriteTime

Propiedad Valor
DateTimeBehavior UserLocal
Description For internal use only.
DisplayName Record Overwrite Time
Format DateOnly
IsValidForForm False
IsValidForRead True
LogicalName overwritetime
RequiredLevel SystemRequired
Type DateTime

ParentRoleId

Propiedad Valor
Description Unique identifier of the parent role.
DisplayName Parent Role
IsValidForForm False
IsValidForRead True
LogicalName parentroleid
RequiredLevel None
Targets role
Type Lookup

ParentRoleIdName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName parentroleidname
MaxLength 100
RequiredLevel SystemRequired
Type String

ParentRootRoleId

Propiedad Valor
Description Unique identifier of the parent root role.
DisplayName Parent Root Role
IsValidForForm False
IsValidForRead True
LogicalName parentrootroleid
RequiredLevel SystemRequired
Targets role
Type Lookup

ParentRootRoleIdName

Propiedad Valor
Description
DisplayName
FormatName Text
IsLocalizable False
IsValidForForm False
IsValidForRead True
LogicalName parentrootroleidname
MaxLength 100
RequiredLevel SystemRequired
Type String

RoleIdUnique

Propiedad Valor
Description For internal use only.
DisplayName Unique Id
IsValidForForm False
IsValidForRead True
LogicalName roleidunique
RequiredLevel SystemRequired
Type Uniqueidentifier

RoleTemplateId

Propiedad Valor
Description Unique identifier of the role template that is associated with the role.
DisplayName Role Template
IsValidForForm False
IsValidForRead True
LogicalName roletemplateid
RequiredLevel None
Targets roletemplate
Type Lookup

SolutionId

Propiedad Valor
Description Unique identifier of the associated solution.
DisplayName Solution
IsValidForForm False
IsValidForRead True
LogicalName solutionid
RequiredLevel SystemRequired
Type Uniqueidentifier

SupportingSolutionId

Propiedad Valor
Description For internal use only.
DisplayName Solution
IsValidForForm False
IsValidForRead False
LogicalName supportingsolutionid
RequiredLevel None
Type Uniqueidentifier

VersionNumber

Propiedad Valor
Description Version number of the role.
DisplayName Version number
IsValidForForm False
IsValidForRead True
LogicalName versionnumber
MaxValue 9223372036854775807
MinValue -9223372036854775808
RequiredLevel None
Type BigInt

Relaciones de uno a varios

Listado por SchemaName.

role_parent_role

Igual que la relación de varios a uno role_parent_role de la tabla role.

Propiedad Valor
ReferencingEntity role
ReferencingAttribute parentroleid
IsHierarchical False
IsCustomizable False
ReferencedEntityNavigationPropertyName role_parent_role
AssociatedMenuConfiguration Behavior: DoNotDisplay
Group: Details
Label:
Order:
CascadeConfiguration Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
Share: NoCascade
Unshare: NoCascade

Role_AsyncOperations

Igual que la relación de varios a uno Role_AsyncOperations de la tabla asyncoperation.

Propiedad Valor
ReferencingEntity asyncoperation
ReferencingAttribute regardingobjectid
IsHierarchical False
IsCustomizable False
ReferencedEntityNavigationPropertyName Role_AsyncOperations
AssociatedMenuConfiguration Behavior: DoNotDisplay
Group: Details
Label:
Order:
CascadeConfiguration Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
Share: NoCascade
Unshare: NoCascade

role_parent_root_role

Igual que la relación de varios a uno role_parent_root_role de la tabla role.

Propiedad Valor
ReferencingEntity role
ReferencingAttribute parentrootroleid
IsHierarchical False
IsCustomizable False
ReferencedEntityNavigationPropertyName role_parent_root_role
AssociatedMenuConfiguration Behavior: DoNotDisplay
Group: Details
Label:
Order:
CascadeConfiguration Assign: NoCascade
Delete: Cascade
Merge: NoCascade
Reparent: NoCascade
Share: NoCascade
Unshare: NoCascade

Role_BulkDeleteFailures

Igual que la relación de varios a uno Role_BulkDeleteFailures de la tabla bulkdeletefailure.

Propiedad Valor
ReferencingEntity bulkdeletefailure
ReferencingAttribute regardingobjectid
IsHierarchical False
IsCustomizable False
ReferencedEntityNavigationPropertyName Role_BulkDeleteFailures
AssociatedMenuConfiguration Behavior: DoNotDisplay
Group: Details
Label:
Order:
CascadeConfiguration Assign: NoCascade
Delete: Cascade
Merge: NoCascade
Reparent: NoCascade
Share: NoCascade
Unshare: NoCascade

Role_SyncErrors

Igual que la relación de varios a uno Role_SyncErrors de la tabla syncerror.

Propiedad Valor
ReferencingEntity syncerror
ReferencingAttribute regardingobjectid
IsHierarchical False
IsCustomizable True
ReferencedEntityNavigationPropertyName Role_SyncErrors
AssociatedMenuConfiguration Behavior: DoNotDisplay
Group: Details
Label:
Order:
CascadeConfiguration Assign: Cascade
Delete: Cascade
Merge: Cascade
Reparent: Cascade
Share: Cascade
Unshare: Cascade

Relaciones de varios a uno

Cada relación de varios a uno se define mediante una relación de uno a varios correspondiente con la tabla relacionada. Listado por SchemaName.

lk_rolebase_modifiedby

Consulte la relación de uno a varios lk_rolebase_modifiedby de la tabla systemuser.

role_parent_role

Consulte la relación de uno a varios role_parent_role de la tabla role.

organization_roles

Consulte la relación de uno a varios organization_roles de la tabla organization.

business_unit_roles

Consulte la relación de uno a varios business_unit_roles de la tabla businessunit.

lk_role_createdonbehalfby

Consulte la relación de uno a varios lk_role_createdonbehalfby de la tabla systemuser.

lk_role_modifiedonbehalfby

Consulte la relación de uno a varios lk_role_modifiedonbehalfby de la tabla systemuser.

role_parent_root_role

Consulte la relación de uno a varios role_parent_root_role de la tabla role.

lk_rolebase_createdby

Consulte la relación de uno a varios lk_rolebase_createdby de la tabla systemuser.

solution_role

Consulte la relación de uno a varios solution_role de la tabla solution.

Relaciones de varios a varios

Los detalles de la relación proporcionados cuando la tabla Role es la primera tabla de la relación. Listado por SchemaName.

systemuserroles_association

Consulte la relación de varios a varios systemuserroles_association de la tabla systemuser.

roleprivileges_association

Consulte la relación de varios a varios roleprivileges_association de la tabla privilege.

appmoduleroles_association

Consulte la relación de varios a varios appmoduleroles_association de la tabla appmodule.

teamroles_association

Consulte la relación de varios a varios teamroles_association de la tabla team.

applicationuserrole

Consulte la relación de varios a varios applicationuserrole de la tabla applicationuser.

Consultar también

Referencia de tabla o entidad de Dataverse Referencia de la API web role EntityType