Saved View (UserQuery) table/entity reference

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
Create Event: True	POST /userqueries See Create	Create records
Delete Event: True	DELETE /userqueries(userqueryid) See Delete	Delete 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
• 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

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

See also

Dataverse table/entity reference
Dataverse Web API Reference
userquery