Saved View (UserQuery) table/entity reference (Microsoft Dataverse)

2025-08-28

Saved database query that is owned by a user.

Messages

The following table lists the messages for the Saved View (UserQuery) table. Messages represent operations that can be performed on the table. They may also be events.

Name Is Event?	Web API Operation	SDK for .NET
`Assign` Event: True	`PATCH` /userqueries(userqueryid) Update the `ownerid` property.	AssignRequest
`Associate` Event: True	Associate records	Associate records
`Create` Event: True	`POST` /userqueries See Create	Create records
`Delete` Event: True	`DELETE` /userqueries(userqueryid) See Delete	Delete records
`Disassociate` Event: True	Disassociate records	Disassociate records
`ExecuteByIdSavedQuery` Event: True		ExecuteByIdSavedQueryRequest
`ExecuteByIdUserQuery` Event: True		ExecuteByIdUserQueryRequest
`GrantAccess` Event: True	GrantAccess	GrantAccessRequest
`ModifyAccess` Event: True	ModifyAccess	ModifyAccessRequest
`Retrieve` Event: True	`GET` /userqueries(userqueryid) See Retrieve	Retrieve records
`RetrieveMultiple` Event: True	`GET` /userqueries See Query data	Query data
`RetrievePrincipalAccess` Event: True	RetrievePrincipalAccess	RetrievePrincipalAccessRequest
`RetrieveSharedPrincipalsAndAccess` Event: True	RetrieveSharedPrincipalsAndAccess	RetrieveSharedPrincipalsAndAccessRequest
`RevokeAccess` Event: True	RevokeAccess	RevokeAccessRequest
`SetState` Event: True	`PATCH` /userqueries(userqueryid) Update the `statecode` and `statuscode` properties.	SetStateRequest
`Update` Event: True	`PATCH` /userqueries(userqueryid) See Update	Update records
`Upsert` Event: False	`PATCH` /userqueries(userqueryid) See Upsert a table row	UpsertRequest

Properties

The following table lists selected properties for the Saved View (UserQuery) table.

Property	Value
DisplayName	Saved View
DisplayCollectionName	Saved Views
SchemaName	`UserQuery`
CollectionSchemaName	`UserQueries`
EntitySetName	`userqueries`
LogicalName	`userquery`
LogicalCollectionName	`userqueries`
PrimaryIdAttribute	`userqueryid`
PrimaryNameAttribute	`name`
TableType	`Standard`
OwnershipType	`UserOwned`

Writable columns/attributes

These columns/attributes return true for either IsValidForCreate or IsValidForUpdate (usually both). Listed by SchemaName.

AdvancedGroupBy
ColumnSetXml
ConditionalFormatting
Description
EnableCrossPartition
FetchXml
LayoutJson
LayoutXml
Name
OfflineSqlQuery
OwnerId
OwnerIdType
ParentQueryId
QueryType
ReturnedTypeCode
StateCode
StatusCode
UserQueryId

AdvancedGroupBy

Property	Value
Description	Type the column name that will be used to group the results from the data collected across multiple records from a user view.
DisplayName	Advanced Group By
IsValidForForm	False
IsValidForRead	True
LogicalName	`advancedgroupby`
RequiredLevel	None
Type	String
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	20

ColumnSetXml

Property	Value
Description	Shows the columns and sorting criteria for the saved view, stored in XML format.
DisplayName	Column Set XML
IsValidForForm	False
IsValidForRead	True
LogicalName	`columnsetxml`
RequiredLevel	None
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

ConditionalFormatting

Property	Value
Description	Type information about how the items in the user view are formatted.
DisplayName	User Group By
IsValidForForm	False
IsValidForRead	True
LogicalName	`conditionalformatting`
RequiredLevel	None
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

Description

Property	Value
Description	Type additional information to describe the saved view, such as the filter criteria or intended results set.
DisplayName	Description
IsValidForForm	True
IsValidForRead	True
LogicalName	`description`
RequiredLevel	None
Type	Memo
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	2000

EnableCrossPartition

Property	Value
Description	Tells whether the view can retrieve data from all cluster partitions.
DisplayName	Default
IsValidForForm	False
IsValidForRead	True
LogicalName	`enablecrosspartition`
RequiredLevel	SystemRequired
Type	Boolean
GlobalChoiceName	`userquery_enablecrosspartition`
DefaultValue	False
True Label	Yes
False Label	No

FetchXml

Property	Value
Description	Contains the Fetch XML query that defines the entities and attributes included in the saved view.
DisplayName	Fetch XML
IsValidForForm	False
IsValidForRead	True
LogicalName	`fetchxml`
RequiredLevel	SystemRequired
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

LayoutJson

Property	Value
Description	Layout data in JSON format.
DisplayName	Layout data in JSON format.
IsValidForForm	False
IsValidForRead	True
LogicalName	`layoutjson`
RequiredLevel	None
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

LayoutXml

Property	Value
Description	For internal use only.
DisplayName	Layout XML
IsValidForForm	False
IsValidForRead	True
LogicalName	`layoutxml`
RequiredLevel	None
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

Name

Property	Value
Description	Type a descriptive name for the saved view.
DisplayName	Name
IsValidForForm	True
IsValidForRead	True
LogicalName	`name`
RequiredLevel	SystemRequired
Type	String
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	200

OfflineSqlQuery

Property	Value
Description	String specifying the corresponding sql query for the fetch xml specified for offline use.
DisplayName	Offline SQL Query
IsValidForForm	False
IsValidForRead	True
LogicalName	`offlinesqlquery`
RequiredLevel	None
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

OwnerId

Property	Value
Description	Enter the user or team who is assigned to manage the record. This field is updated every time the record is assigned to a different user.
DisplayName	Owner
IsValidForForm	True
IsValidForRead	True
LogicalName	`ownerid`
RequiredLevel	SystemRequired
Type	Owner
Targets	systemuser, team

OwnerIdType

Property	Value
Description	Type of the owner of the saved view, such as user, team, or business unit.
DisplayName
IsValidForForm	False
IsValidForRead	True
LogicalName	`owneridtype`
RequiredLevel	SystemRequired
Type	EntityName

ParentQueryId

Property	Value
Description	Choose the ID of the saved query that the record was created from.
DisplayName	Parent Query
IsValidForForm	True
IsValidForRead	True
LogicalName	`parentqueryid`
RequiredLevel	None
Type	Lookup
Targets

QueryType

Property	Value
Description	Shows the code for the query type to indicate whether the saved view is an address book filter, advanced search, or other view.
DisplayName	Query Type
IsValidForForm	False
IsValidForRead	True
LogicalName	`querytype`
RequiredLevel	SystemRequired
Type	Integer
MaxValue	1000000000
MinValue	0

ReturnedTypeCode

Property	Value
Description	Type of entity that the saved view displays.
DisplayName	Returned Type
IsValidForForm	False
IsValidForRead	True
LogicalName	`returnedtypecode`
RequiredLevel	SystemRequired
Type	EntityName

StateCode

Property	Value
Description	Shows whether the saved view is active or inactive.
DisplayName	Status
IsValidForForm	True
IsValidForRead	True
LogicalName	`statecode`
RequiredLevel	SystemRequired
Type	State
DefaultFormValue	0
GlobalChoiceName	`userquery_statecode`

StateCode Choices/Options

Value	Details
0	Label: Active DefaultStatus: 1 InvariantName: `Active`
1	Label: Inactive DefaultStatus: 2 InvariantName: `Inactive`

StatusCode

Property	Value
Description	Select the item's status.
DisplayName	Status Reason
IsValidForForm	True
IsValidForRead	True
LogicalName	`statuscode`
RequiredLevel	None
Type	Status
DefaultFormValue	-1
GlobalChoiceName	`userquery_statuscode`

StatusCode Choices/Options

Value	Details
1	Label: Active State:0 TransitionData: None
2	Label: Inactive State:1 TransitionData: None
3	Label: All State:0 TransitionData: None

UserQueryId

Property	Value
Description	Unique identifier of the saved view.
DisplayName	User Query
IsValidForForm	False
IsValidForRead	True
LogicalName	`userqueryid`
RequiredLevel	SystemRequired
Type	Uniqueidentifier

Read-only columns/attributes

These columns/attributes return false for both IsValidForCreate and IsValidForUpdate. Listed by SchemaName.

CreatedBy
CreatedOn
CreatedOnBehalfBy
ModifiedBy
ModifiedOn
ModifiedOnBehalfBy
OwnerIdName
OwnerIdYomiName
OwningBusinessUnit
OwningTeam
OwningUser
VersionNumber

CreatedBy

Property	Value
Description	Shows who created the record.
DisplayName	Created By
IsValidForForm	False
IsValidForRead	True
LogicalName	`createdby`
RequiredLevel	SystemRequired
Type	Lookup
Targets	systemuser

CreatedOn

Property	Value
Description	Shows the date and time when the record was created. The date and time are displayed in the time zone selected in Microsoft Dynamics 365 options.
DisplayName	Created On
IsValidForForm	False
IsValidForRead	True
LogicalName	`createdon`
RequiredLevel	SystemRequired
Type	DateTime
CanChangeDateTimeBehavior	False
DateTimeBehavior	UserLocal
Format	DateAndTime
ImeMode	Inactive
SourceTypeMask	0

CreatedOnBehalfBy

Property	Value
Description	Shows who created the record on behalf of another user.
DisplayName	Created By (Delegate)
IsValidForForm	False
IsValidForRead	True
LogicalName	`createdonbehalfby`
RequiredLevel	None
Type	Lookup
Targets	systemuser

ModifiedBy

Property	Value
Description	Shows who last updated the record.
DisplayName	Modified By
IsValidForForm	True
IsValidForRead	True
LogicalName	`modifiedby`
RequiredLevel	SystemRequired
Type	Lookup
Targets	systemuser

ModifiedOn

Property	Value
Description	Shows the date and time when the record was last updated. The date and time are displayed in the time zone selected in Microsoft Dynamics 365 options.
DisplayName	Last Modified
IsValidForForm	True
IsValidForRead	True
LogicalName	`modifiedon`
RequiredLevel	SystemRequired
Type	DateTime
CanChangeDateTimeBehavior	False
DateTimeBehavior	UserLocal
Format	DateAndTime
ImeMode	Inactive
SourceTypeMask	0

ModifiedOnBehalfBy

Property	Value
Description	Shows who last updated the record on behalf of another user.
DisplayName	Modified By (Delegate)
IsValidForForm	False
IsValidForRead	True
LogicalName	`modifiedonbehalfby`
RequiredLevel	None
Type	Lookup
Targets	systemuser

OwnerIdName

Property	Value
Description	Name of the owner of the saved view.
DisplayName
IsValidForForm	False
IsValidForRead	True
LogicalName	`owneridname`
RequiredLevel	SystemRequired
Type	String
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	100

OwnerIdYomiName

Property	Value
Description
DisplayName
IsValidForForm	False
IsValidForRead	True
LogicalName	`owneridyominame`
RequiredLevel	SystemRequired
Type	String
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	100

OwningBusinessUnit

Property	Value
Description	Shows the business unit that the record owner belongs to.
DisplayName	Owning Business Unit
IsValidForForm	True
IsValidForRead	True
LogicalName	`owningbusinessunit`
RequiredLevel	None
Type	Lookup
Targets	businessunit

OwningTeam

Property	Value
Description	Unique identifier of the team who owns this saved view.
DisplayName	Owning Team
IsValidForForm	False
IsValidForRead	True
LogicalName	`owningteam`
RequiredLevel	None
Type	Lookup
Targets	team

OwningUser

Property	Value
Description	Unique identifier of the user who owns this saved view.
DisplayName	Owning User
IsValidForForm	False
IsValidForRead	True
LogicalName	`owninguser`
RequiredLevel	None
Type	Lookup
Targets	systemuser

VersionNumber

Property	Value
Description	Version number of the saved view.
DisplayName	Version Number
IsValidForForm	False
IsValidForRead	True
LogicalName	`versionnumber`
RequiredLevel	None
Type	BigInt
MaxValue	9223372036854775807
MinValue	-9223372036854775808

Many-to-One relationships

These relationships are many-to-one. Listed by SchemaName.

business_unit_userquery
lk_userquery_createdby
lk_userquery_createdonbehalfby
lk_userquery_modifiedby
lk_userquery_modifiedonbehalfby
owner_userquerys
team_userquery
user_userquery

business_unit_userquery

One-To-Many Relationship: businessunit business_unit_userquery

Property	Value
ReferencedEntity	`businessunit`
ReferencedAttribute	`businessunitid`
ReferencingAttribute	`owningbusinessunit`
ReferencingEntityNavigationPropertyName	`owningbusinessunit`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

lk_userquery_createdby

One-To-Many Relationship: systemuser lk_userquery_createdby

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`createdby`
ReferencingEntityNavigationPropertyName	`createdby`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

lk_userquery_createdonbehalfby

One-To-Many Relationship: systemuser lk_userquery_createdonbehalfby

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`createdonbehalfby`
ReferencingEntityNavigationPropertyName	`createdonbehalfby`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

lk_userquery_modifiedby

One-To-Many Relationship: systemuser lk_userquery_modifiedby

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`modifiedby`
ReferencingEntityNavigationPropertyName	`modifiedby`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

lk_userquery_modifiedonbehalfby

One-To-Many Relationship: systemuser lk_userquery_modifiedonbehalfby

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`modifiedonbehalfby`
ReferencingEntityNavigationPropertyName	`modifiedonbehalfby`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

owner_userquerys

One-To-Many Relationship: owner owner_userquerys

Property	Value
ReferencedEntity	`owner`
ReferencedAttribute	`ownerid`
ReferencingAttribute	`ownerid`
ReferencingEntityNavigationPropertyName	`ownerid`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

team_userquery

One-To-Many Relationship: team team_userquery

Property	Value
ReferencedEntity	`team`
ReferencedAttribute	`teamid`
ReferencingAttribute	`owningteam`
ReferencingEntityNavigationPropertyName	`owningteam`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

user_userquery

One-To-Many Relationship: systemuser user_userquery

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`owninguser`
ReferencingEntityNavigationPropertyName	`owninguser`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

One-to-Many relationships

These relationships are one-to-many. Listed by SchemaName.

UserQuery_AsyncOperations
UserQuery_BulkDeleteFailures
UserQuery_SyncErrors

UserQuery_AsyncOperations

Many-To-One Relationship: asyncoperation UserQuery_AsyncOperations

Property	Value
ReferencingEntity	`asyncoperation`
ReferencingAttribute	`regardingobjectid`
ReferencedEntityNavigationPropertyName	`UserQuery_AsyncOperations`
IsCustomizable	`False`
AssociatedMenuConfiguration	AvailableOffline: True Behavior: `DoNotDisplay` Group: `Details` Label: MenuId: null Order: QueryApi: null ViewId: `00000000-0000-0000-0000-000000000000`

UserQuery_BulkDeleteFailures

Many-To-One Relationship: bulkdeletefailure UserQuery_BulkDeleteFailures

Property	Value
ReferencingEntity	`bulkdeletefailure`
ReferencingAttribute	`regardingobjectid`
ReferencedEntityNavigationPropertyName	`UserQuery_BulkDeleteFailures`
IsCustomizable	`False`
AssociatedMenuConfiguration	AvailableOffline: True Behavior: `DoNotDisplay` Group: `Details` Label: MenuId: null Order: QueryApi: null ViewId: `00000000-0000-0000-0000-000000000000`

UserQuery_SyncErrors

Many-To-One Relationship: syncerror UserQuery_SyncErrors

Property	Value
ReferencingEntity	`syncerror`
ReferencingAttribute	`regardingobjectid`
ReferencedEntityNavigationPropertyName	`UserQuery_SyncErrors`
IsCustomizable	`True`
AssociatedMenuConfiguration	AvailableOffline: True Behavior: `DoNotDisplay` Group: `Details` Label: MenuId: null Order: QueryApi: null ViewId: `00000000-0000-0000-0000-000000000000`

Feedback

Was this page helpful?