SavedQuery (view) entity messages and methods

 

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

This entity stores a saved query against the database. This is used for both views and for Microsoft Dynamics 365 for Microsoft Office Outlook with Offline Access filters and templates. The schema name for this entity is SavedQuery. To view the entity metadata for your organization, install the Metadata Browser solution described in Browse the metadata for your organization. You can also view the metadata for an uncustomized organization in the Excel file called EntityMetadata.xlsx included in the top-level folder of the SDK download.

The following table describes the messages for this entity, which you use with the IOrganizationService.Execute method.

Message

Description

AssociateRequest

Creates a link between a record and one or more records that participate in a relationship. You can also use the IOrganizationService.Associate method. For more information, see Actions on entity records. For a list of default relationships for this entity, see the SavedQuery entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.

CreateRequest

Creates a saved query. You can also call the IOrganizationService.Create method.

DeleteRequest

Deletes a saved query. You can also call the IOrganizationService.Delete method.

DisassociateRequest

Removes a link between a record and one or more records that participate in a relationship. You can also use the IOrganizationService.Disassociate method. For more information, see Actions on entity records. For a list of default relationships for this entity, see the SavedQuery entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.

ExecuteByIdSavedQueryRequest

Executes a previously saved query specified by an ID.

InitializeFromRequest

Initializes a new record from an existing record provided that an attribute map is defined for the two entities. For more information, see Customize entity and attribute mappings.

RetrieveDuplicatesRequest

Detects and retrieves duplicate records for the specified record provided that duplicate detection is enabled and there are published duplicate detection rules for the entity. For more information, see Detect duplicate data.

RetrieveLocLabelsRequest

Retrieves localized labels for SavedQuery.Name and SavedQuery.Description attributes.

RetrieveRequest

Retrieves a saved query. You can also call the IOrganizationService.Retrieve method.

RetrieveMultipleRequest

Retrieves a collection of saved queries. You can also call the IOrganizationService.RetrieveMultiple method.

SetLocLabelsRequest

Sets localized labels for SavedQuery.Name and SavedQuery.Description attributes.

SetStateRequest

Sets the state of a saved query (view). The possible states are defined in the SavedQueryState enumeration. For a list of states, see SavedQuery entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.

UpdateRequest

Updates a saved query. You can also call the IOrganizationService.Update method.

ValidateSavedQueryRequest

Validates a saved query.

See Also

Customize entity views
Sample: Work with views
Offline and Outlook filters and templates
Privileges by entity

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright