Nota
L-aċċess għal din il-paġna jeħtieġ l-awtorizzazzjoni. Tista’ tipprova tidħol jew tibdel id-direttorji.
L-aċċess għal din il-paġna jeħtieġ l-awtorizzazzjoni. Tista’ tipprova tibdel id-direttorji.
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 |
|---|---|---|
AssignEvent: True |
PATCH /userqueries(userqueryid)Update the ownerid property. |
AssignRequest |
AssociateEvent: True |
Associate records | Associate records |
CreateEvent: True |
POST /userqueriesSee Create |
Create records |
DeleteEvent: True |
DELETE /userqueries(userqueryid)See Delete |
Delete records |
DisassociateEvent: True |
Disassociate records | Disassociate records |
ExecuteByIdSavedQueryEvent: True |
ExecuteByIdSavedQueryRequest | |
ExecuteByIdUserQueryEvent: True |
ExecuteByIdUserQueryRequest | |
GrantAccessEvent: True |
GrantAccess | GrantAccessRequest |
ModifyAccessEvent: True |
ModifyAccess | ModifyAccessRequest |
RetrieveEvent: True |
GET /userqueries(userqueryid)See Retrieve |
Retrieve records |
RetrieveMultipleEvent: True |
GET /userqueriesSee Query data |
Query data |
RetrievePrincipalAccessEvent: True |
RetrievePrincipalAccess | RetrievePrincipalAccessRequest |
RetrieveSharedPrincipalsAndAccessEvent: True |
RetrieveSharedPrincipalsAndAccess | RetrieveSharedPrincipalsAndAccessRequest |
RevokeAccessEvent: True |
RevokeAccess | RevokeAccessRequest |
SetStateEvent: True |
PATCH /userqueries(userqueryid)Update the statecode and statuscode properties. |
SetStateRequest |
UpdateEvent: True |
PATCH /userqueries(userqueryid)See Update |
Update records |
UpsertEvent: 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: NoCascadeAssign: NoCascadeDelete: NoCascadeMerge: NoCascadeReparent: NoCascadeRollupView: NoCascadeShare: NoCascadeUnshare: 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: NoCascadeAssign: NoCascadeDelete: NoCascadeMerge: NoCascadeReparent: NoCascadeRollupView: NoCascadeShare: NoCascadeUnshare: 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: NoCascadeAssign: NoCascadeDelete: NoCascadeMerge: NoCascadeReparent: NoCascadeRollupView: NoCascadeShare: NoCascadeUnshare: 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: NoCascadeAssign: NoCascadeDelete: NoCascadeMerge: NoCascadeReparent: NoCascadeRollupView: NoCascadeShare: NoCascadeUnshare: 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: NoCascadeAssign: NoCascadeDelete: NoCascadeMerge: NoCascadeReparent: NoCascadeRollupView: NoCascadeShare: NoCascadeUnshare: NoCascade |
owner_userquerys
One-To-Many Relationship: owner owner_userquerys
| Property | Value |
|---|---|
| ReferencedEntity | owner |
| ReferencedAttribute | ownerid |
| ReferencingAttribute | ownerid |
| ReferencingEntityNavigationPropertyName | ownerid |
| IsHierarchical | |
| CascadeConfiguration | Archive: NoCascadeAssign: NoCascadeDelete: NoCascadeMerge: NoCascadeReparent: NoCascadeRollupView: NoCascadeShare: NoCascadeUnshare: NoCascade |
team_userquery
One-To-Many Relationship: team team_userquery
| Property | Value |
|---|---|
| ReferencedEntity | team |
| ReferencedAttribute | teamid |
| ReferencingAttribute | owningteam |
| ReferencingEntityNavigationPropertyName | owningteam |
| IsHierarchical | |
| CascadeConfiguration | Archive: NoCascadeAssign: NoCascadeDelete: NoCascadeMerge: NoCascadeReparent: NoCascadeRollupView: NoCascadeShare: NoCascadeUnshare: NoCascade |
user_userquery
One-To-Many Relationship: systemuser user_userquery
| Property | Value |
|---|---|
| ReferencedEntity | systemuser |
| ReferencedAttribute | systemuserid |
| ReferencingAttribute | owninguser |
| ReferencingEntityNavigationPropertyName | owninguser |
| IsHierarchical | |
| CascadeConfiguration | Archive: NoCascadeAssign: NoCascadeDelete: NoCascadeMerge: NoCascadeReparent: NoCascadeRollupView: NoCascadeShare: NoCascadeUnshare: NoCascade |
One-to-Many relationships
These relationships are one-to-many. Listed by SchemaName.
UserQuery_AsyncOperations
Many-To-One Relationship: asyncoperation UserQuery_AsyncOperations
| Property | Value |
|---|---|
| ReferencingEntity | asyncoperation |
| ReferencingAttribute | regardingobjectid |
| ReferencedEntityNavigationPropertyName | UserQuery_AsyncOperations |
| IsCustomizable | False |
| AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplayGroup: DetailsLabel: 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: DoNotDisplayGroup: DetailsLabel: 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: DoNotDisplayGroup: DetailsLabel: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
See also
Dataverse table/entity reference
Dataverse Web API Reference
userquery