Product entity messages and methods

 

Applies To: Dynamics CRM 2013

A product represents information about products and their pricing information. The schema name for this entity is Product. 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

AddProductToKitRequest

Adds a product to a kit. A kit is a product catalog item that consists of one or more products.

AddSubstituteProductRequest

Deprecated. Use the AssociateRequest class. Establishes an association between a product and a substitute product.

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, refer to the Product entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.

ConvertKitToProductRequest

Converts a kit to a product.

ConvertProductToKitRequest

Converts a product to a kit.

CreateRequest

Creates a product. You can also call the IOrganizationService.Create method.

DeleteRequest

Deletes a product. 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, refer to the Product entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.

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.

RemoveProductFromKitRequest

Removes a product from a kit.

RemoveRelatedRequest

Deprecated. Use the DisassociateRequest or Disassociate class. Removes the relationship between a product and the specified entity (lead or competitor).

RemoveSubstituteProductRequest

Deprecated. Use the DisassociateRequest class. Removes the association of a substitute product from a product.

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.

RetrieveRequest

Retrieves a product. You can also call the IOrganizationService.Retrieve method.

RetrieveMultipleRequest

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

SetRelatedRequest

Deprecated. Use the DisassociateRequest or Disassociate class. Creates a relationship between a product and the specified entity (lead or competitor).

SetStateRequest

Sets the state of a product. If you are using early bound types, use the ProductState enumeration to set the possible states. For a list of the state values, refer to the Product entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.

UpdateRequest

Updates a product. You can also call the IOrganizationService.Update method.

See Also

Product catalog entities
Product entity privileges
ProductPriceLevel (price list item) entity messages and methods