UserQuery (saved view) entity

Applies To: Dynamics CRM 2013

Saved queries are business entities that define the parameters and criteria of a Microsoft Dynamics CRM database search. Saved queries support cross-entity searches. In Microsoft Dynamics CRM there are two entities available for queries against the Microsoft Dynamics CRM database.

A user query, called a saved view in the application, is owned by an individual user, can be assigned and shared with other users, and can be viewed by other users depending on the query's access privileges. This is appropriate for frequently used queries that span entity types and queries that perform aggregation. A saved query, called a view in the application, is owned by an organization making it visible to all users in the organization. Saved queries (views) are used for both views defined for an entity and for filters and templates for Microsoft Dynamics CRM for Microsoft Office Outlook. For more information about saved views, see Customize entity views and Offline and Outlook filters and templates.

A query in the form of a FetchXML statement is constructed and then assigned to the UserQuery.FetchXml attribute. This query can be executed by using the ExecuteByIdUserQueryRequest message.

You can see the user query (saved view) in the Advanced Find section of the Microsoft Dynamics CRM application and also in the View drop-down list for an entity. These queries can be imported and exported using the Import/Export capability in Microsoft Dynamics CRM.

See Also

Model your business data
UserQuery (saved view) entity messages and methods
Build queries with QueryExpression
FetchXML schema