DynamicPropertyInstance (property instance) methods and messages

 

Applies To: Dynamics CRM 2015

A property instance stores the instance of a product property along with its values. The schema name for this entity is DynamicPropertyInstance. 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.

Note

A property instance (dynamic property instance) record gets automatically created for a product or bundle when you add the product or bundle to an opportunity, quote, order, or invoice, and is automatically deleted when the product or bundle is removed from an opportunity, quote, order, or invoice. Therefore, it’s not recommended to manually create or delete property instance (dynamic property instance) records for a product or bundle.

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

Message

Description

CreateRequest

Creates a property instance (dynamic property instance). You can also call the IOrganizationService.Create method.

DeleteRequest

Deletes a property instance (dynamic property instance). You can also call the IOrganizationService.Delete method.

RetrieveRequest

Retrieves a property instance (dynamic property instance). You can also call the IOrganizationService.Retrieve method.

RetrieveMultipleRequest

Retrieves a collection of property instances (dynamic property instances). You can also call the IOrganizationService.RetrieveMultiple method.

RetrieveProductPropertiesRequest

Retrieves all the property instances (dynamic property instances) for a product added to an opportunity, quote, order, or invoice.

UpdateRequest

Updates a property instance (dynamic property instance). You can also call the IOrganizationService.Update method.

UpdateProductPropertiesRequest

Updates the value of property instances (dynamic property instances) for a product added to an opportunity, quote, order, or invoice.

See Also

Define product properties (not supported through SDK)
Product catalog entities
DynamicPropertyInstance entity privileges

© 2016 Microsoft. All rights reserved. Copyright