Product Association (ProductAssociation) table/entity reference (Microsoft Dynamics 365)
Instance of a product added to a bundle or kit.
The following table lists the messages for the Product Association (ProductAssociation) 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 |
---|---|---|
Associate Event: True |
Associate records | Associate records |
Create Event: True |
POST /productassociationsSee Create |
Create records |
CreateMultiple Event: True |
CreateMultiple | CreateMultipleRequest |
Delete Event: True |
DELETE /productassociations(productassociationid)See Delete |
Delete records |
Disassociate Event: True |
Disassociate records | Disassociate records |
Retrieve Event: True |
GET /productassociations(productassociationid)See Retrieve |
Retrieve records |
RetrieveMultiple Event: True |
GET /productassociationsSee Query data |
Query data |
SetState Event: True |
PATCH /productassociations(productassociationid)Update the statecode and statuscode properties. |
SetStateRequest |
Update Event: True |
PATCH /productassociations(productassociationid)See Update |
Update records |
UpdateMultiple Event: True |
UpdateMultiple | UpdateMultipleRequest |
Upsert Event: False |
PATCH /productassociations(productassociationid)See Upsert a table row |
UpsertRequest |
UpsertMultiple Event: False |
UpsertMultiple | UpsertMultipleRequest |
The following table lists selected properties for the Product Association (ProductAssociation) table.
Property | Value |
---|---|
DisplayName | Product Association |
DisplayCollectionName | Product Associations |
SchemaName | ProductAssociation |
CollectionSchemaName | ProductAssociations |
EntitySetName | productassociations |
LogicalName | productassociation |
LogicalCollectionName | productassociations |
PrimaryIdAttribute | productassociationid |
PrimaryNameAttribute | productidname |
TableType | Standard |
OwnershipType | OrganizationOwned |
These columns/attributes return true for either IsValidForCreate or IsValidForUpdate (usually both). Listed by SchemaName.
- AssociatedProduct
- DMTImportState
- ImportSequenceNumber
- OverriddenCreatedOn
- ProductAssociationId
- ProductId
- ProductIsRequired
- PropertyCustomizationStatus
- Quantity
- statecode
- statuscode
- TimeZoneRuleVersionNumber
- TransactionCurrencyId
- UoMId
- UTCConversionTimeZoneCode
Property | Value |
---|---|
Description | Select a product to add to the bundle or kit. |
DisplayName | Associated Product |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | associatedproduct |
RequiredLevel | SystemRequired |
Type | Lookup |
Targets | product |
Property | Value |
---|---|
Description | Internal Use Only |
DisplayName | Internal Use Only |
IsValidForForm | False |
IsValidForRead | False |
LogicalName | dmtimportstate |
RequiredLevel | None |
Type | Integer |
MaxValue | 2147483647 |
MinValue | -2147483648 |
Property | Value |
---|---|
Description | Sequence number of the import that created this record. |
DisplayName | Import Sequence Number |
IsValidForForm | False |
IsValidForRead | True |
LogicalName | importsequencenumber |
RequiredLevel | None |
Type | Integer |
MaxValue | 2147483647 |
MinValue | -2147483648 |
Property | Value |
---|---|
Description | Date and time that the record was migrated. |
DisplayName | Record Created On |
IsValidForForm | False |
IsValidForRead | True |
LogicalName | overriddencreatedon |
RequiredLevel | None |
Type | DateTime |
CanChangeDateTimeBehavior | False |
DateTimeBehavior | UserLocal |
Format | DateOnly |
ImeMode | Inactive |
SourceTypeMask | 0 |
Property | Value |
---|---|
Description | Shows the unique identifier of the product association. |
DisplayName | Product Association ID |
IsValidForForm | False |
IsValidForRead | True |
LogicalName | productassociationid |
RequiredLevel | SystemRequired |
Type | Uniqueidentifier |
Property | Value |
---|---|
Description | Select a bundle or a kit. |
DisplayName | Product |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | productid |
RequiredLevel | SystemRequired |
Type | Lookup |
Targets | product |
Property | Value |
---|---|
Description | Select whether the associated product is required or optional. |
DisplayName | Required/Optional |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | productisrequired |
RequiredLevel | ApplicationRequired |
Type | Picklist |
DefaultFormValue | 1 |
GlobalChoiceName | productassociate_productisrequired |
Value | Label |
---|---|
0 | Optional |
1 | Required |
Property | Value |
---|---|
Description | Shows whether the item has properties that can be customized. |
DisplayName | Property Customization |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | propertycustomizationstatus |
RequiredLevel | SystemRequired |
Type | Picklist |
DefaultFormValue | 0 |
GlobalChoiceName | productassociation_propertiescustomizationstatus |
Value | Label |
---|---|
0 | Not Available |
1 | Available |
Property | Value |
---|---|
Description | Type the quantity of the products added to the bundle or kit. |
DisplayName | Quantity |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | quantity |
RequiredLevel | ApplicationRequired |
Type | Decimal |
ImeMode | Auto |
MaxValue | 100000000000 |
MinValue | 0 |
Precision | 5 |
SourceTypeMask | 0 |
Property | Value |
---|---|
Description | Shows whether the associated product is active or inactive. |
DisplayName | Status |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | statecode |
RequiredLevel | SystemRequired |
Type | State |
DefaultFormValue | 2 |
GlobalChoiceName | productassociate_statecode |
Value | Details |
---|---|
0 | Label: Active DefaultStatus: 1 InvariantName: Active |
1 | Label: Inactive DefaultStatus: 2 InvariantName: Inactive |
2 | Label: Draft DefaultStatus: 0 InvariantName: Draft |
3 | Label: Under Revision DefaultStatus: 3 InvariantName: Under Revision |
Property | Value |
---|---|
Description | Select the associated product's status. |
DisplayName | Status Reason |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | statuscode |
RequiredLevel | None |
Type | Status |
DefaultFormValue | |
GlobalChoiceName | productassociate_statuscode |
Value | Details |
---|---|
0 | Label: Draft State:2 TransitionData: None |
1 | Label: Active State:0 TransitionData: None |
2 | Label: Inactive State:1 TransitionData: None |
3 | Label: DraftActive State:3 TransitionData: None |
Property | Value |
---|---|
Description | For internal use only. |
DisplayName | Time Zone Rule Version Number |
IsValidForForm | False |
IsValidForRead | True |
LogicalName | timezoneruleversionnumber |
RequiredLevel | None |
Type | Integer |
MaxValue | 2147483647 |
MinValue | -1 |
Property | Value |
---|---|
Description | Shows the currency associated with the record. |
DisplayName | Currency |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | transactioncurrencyid |
RequiredLevel | None |
Type | Lookup |
Targets | transactioncurrency |
Property | Value |
---|---|
Description | Shows the unit of the product association. |
DisplayName | Unit |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | uomid |
RequiredLevel | ApplicationRequired |
Type | Lookup |
Targets | uom |
Property | Value |
---|---|
Description | Time zone code that was in use when the record was created. |
DisplayName | UTC Conversion Time Zone Code |
IsValidForForm | False |
IsValidForRead | True |
LogicalName | utcconversiontimezonecode |
RequiredLevel | None |
Type | Integer |
MaxValue | 2147483647 |
MinValue | -1 |
These columns/attributes return false for both IsValidForCreate and IsValidForUpdate. Listed by SchemaName.
- CreatedBy
- CreatedOn
- CreatedOnBehalfBy
- ExchangeRate
- ModifiedBy
- ModifiedOn
- ModifiedOnBehalfBy
- OrganizationId
- VersionNumber
Property | Value |
---|---|
Description | Shows who created the record. |
DisplayName | Created By |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | createdby |
RequiredLevel | None |
Type | Lookup |
Targets | systemuser |
Property | Value |
---|---|
Description | Date and time when the record was created. |
DisplayName | Created On |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | createdon |
RequiredLevel | None |
Type | DateTime |
CanChangeDateTimeBehavior | False |
DateTimeBehavior | UserLocal |
Format | DateAndTime |
ImeMode | Inactive |
SourceTypeMask | 0 |
Property | Value |
---|---|
Description | Shows who created the record on behalf of another user. |
DisplayName | Created By (Delegate) |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | createdonbehalfby |
RequiredLevel | None |
Type | Lookup |
Targets | systemuser |
Property | Value |
---|---|
Description | Shows the conversion rate of the record's currency. The exchange rate is used to convert all money fields in the record from the local currency to the system's default currency. |
DisplayName | Exchange Rate |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | exchangerate |
RequiredLevel | None |
Type | Decimal |
ImeMode | Disabled |
MaxValue | 100000000000 |
MinValue | 1E-12 |
Precision | 12 |
SourceTypeMask | 0 |
Property | Value |
---|---|
Description | Shows who last updated the record. |
DisplayName | Modified By |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | modifiedby |
RequiredLevel | None |
Type | Lookup |
Targets | systemuser |
Property | Value |
---|---|
Description | Date and time when the record was modified. |
DisplayName | Modified On |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | modifiedon |
RequiredLevel | None |
Type | DateTime |
CanChangeDateTimeBehavior | False |
DateTimeBehavior | UserLocal |
Format | DateAndTime |
ImeMode | Inactive |
SourceTypeMask | 0 |
Property | Value |
---|---|
Description | Shows who created the record on behalf of another user. |
DisplayName | Modified By (Delegate) |
IsValidForForm | True |
IsValidForRead | True |
LogicalName | modifiedonbehalfby |
RequiredLevel | None |
Type | Lookup |
Targets | systemuser |
Property | Value |
---|---|
Description | Unique identifier for the organization |
DisplayName | Organization Id |
IsValidForForm | False |
IsValidForRead | True |
LogicalName | organizationid |
RequiredLevel | SystemRequired |
Type | Lookup |
Targets | organization |
Property | Value |
---|---|
Description | Version Number |
DisplayName | Version Number |
IsValidForForm | False |
IsValidForRead | True |
LogicalName | versionnumber |
RequiredLevel | None |
Type | BigInt |
MaxValue | 9223372036854775807 |
MinValue | -9223372036854775808 |
These relationships are many-to-one. Listed by SchemaName.
- lk_ProductAssociate_createdby
- lk_ProductAssociation_createdonbehalfby
- lk_ProductAssociation_modifiedby
- lk_ProductAssociation_modifiedonbehalfby
- organization_ProductAssociation
- Product_ProductAssociation_AssocProd
- Product_ProductAssociation_Prod
- transactioncurrency_ProductAssociation
- unit_of_measurement_productassociation
One-To-Many Relationship: systemuser lk_ProductAssociate_createdby
Property | Value |
---|---|
ReferencedEntity | systemuser |
ReferencedAttribute | systemuserid |
ReferencingAttribute | createdby |
ReferencingEntityNavigationPropertyName | createdby |
IsHierarchical | |
CascadeConfiguration | Archive: NoCascade Assign: NoCascade Delete: NoCascade Merge: NoCascade Reparent: NoCascade RollupView: NoCascade Share: NoCascade Unshare: NoCascade |
One-To-Many Relationship: systemuser lk_ProductAssociation_createdonbehalfby
Property | Value |
---|---|
ReferencedEntity | systemuser |
ReferencedAttribute | systemuserid |
ReferencingAttribute | createdonbehalfby |
ReferencingEntityNavigationPropertyName | createdonbehalfby |
IsHierarchical | |
CascadeConfiguration | Archive: NoCascade Assign: NoCascade Delete: NoCascade Merge: NoCascade Reparent: NoCascade RollupView: NoCascade Share: NoCascade Unshare: NoCascade |
One-To-Many Relationship: systemuser lk_ProductAssociation_modifiedby
Property | Value |
---|---|
ReferencedEntity | systemuser |
ReferencedAttribute | systemuserid |
ReferencingAttribute | modifiedby |
ReferencingEntityNavigationPropertyName | modifiedby |
IsHierarchical | |
CascadeConfiguration | Archive: NoCascade Assign: NoCascade Delete: NoCascade Merge: NoCascade Reparent: NoCascade RollupView: NoCascade Share: NoCascade Unshare: NoCascade |
One-To-Many Relationship: systemuser lk_ProductAssociation_modifiedonbehalfby
Property | Value |
---|---|
ReferencedEntity | systemuser |
ReferencedAttribute | systemuserid |
ReferencingAttribute | modifiedonbehalfby |
ReferencingEntityNavigationPropertyName | modifiedonbehalfby |
IsHierarchical | |
CascadeConfiguration | Archive: NoCascade Assign: NoCascade Delete: NoCascade Merge: NoCascade Reparent: NoCascade RollupView: NoCascade Share: NoCascade Unshare: NoCascade |
One-To-Many Relationship: organization organization_ProductAssociation
Property | Value |
---|---|
ReferencedEntity | organization |
ReferencedAttribute | organizationid |
ReferencingAttribute | organizationid |
ReferencingEntityNavigationPropertyName | organizationid |
IsHierarchical | |
CascadeConfiguration | Archive: NoCascade Assign: NoCascade Delete: NoCascade Merge: NoCascade Reparent: NoCascade RollupView: NoCascade Share: NoCascade Unshare: NoCascade |
One-To-Many Relationship: product Product_ProductAssociation_AssocProd
Property | Value |
---|---|
ReferencedEntity | product |
ReferencedAttribute | productid |
ReferencingAttribute | associatedproduct |
ReferencingEntityNavigationPropertyName | associatedproduct |
IsHierarchical | |
CascadeConfiguration | Archive: NoCascade Assign: NoCascade Delete: Restrict Merge: NoCascade Reparent: NoCascade RollupView: NoCascade Share: NoCascade Unshare: NoCascade |
One-To-Many Relationship: product Product_ProductAssociation_Prod
Property | Value |
---|---|
ReferencedEntity | product |
ReferencedAttribute | productid |
ReferencingAttribute | productid |
ReferencingEntityNavigationPropertyName | productid |
IsHierarchical | |
CascadeConfiguration | Archive: NoCascade Assign: NoCascade Delete: Cascade Merge: NoCascade Reparent: NoCascade RollupView: NoCascade Share: NoCascade Unshare: NoCascade |
One-To-Many Relationship: transactioncurrency transactioncurrency_ProductAssociation
Property | Value |
---|---|
ReferencedEntity | transactioncurrency |
ReferencedAttribute | transactioncurrencyid |
ReferencingAttribute | transactioncurrencyid |
ReferencingEntityNavigationPropertyName | transactioncurrencyid |
IsHierarchical | |
CascadeConfiguration | Archive: NoCascade Assign: NoCascade Delete: Restrict Merge: NoCascade Reparent: NoCascade RollupView: NoCascade Share: NoCascade Unshare: NoCascade |
One-To-Many Relationship: uom unit_of_measurement_productassociation
Property | Value |
---|---|
ReferencedEntity | uom |
ReferencedAttribute | uomid |
ReferencingAttribute | uomid |
ReferencingEntityNavigationPropertyName | uomid |
IsHierarchical | |
CascadeConfiguration | Archive: NoCascade Assign: NoCascade Delete: NoCascade Merge: NoCascade Reparent: NoCascade RollupView: NoCascade Share: NoCascade Unshare: NoCascade |
These relationships are one-to-many. Listed by SchemaName.
- ProductAssociation_AsyncOperations
- productassociation_BulkDeleteFailures
- ProductAssociation_DynamicProperty
- ProductAssociation_DynamicPropertyAssociation
- productAssociation_invoice_details
- productassociation_MailboxTrackingFolders
- productAssociation_opportunity_product
- ProductAssociation_PrincipalObjectAttributeAccess
- ProductAssociation_ProcessSessions
- productAssociation_quote_details
- productAssociation_salesorder_details
- ProductAssociation_SyncErrors
Many-To-One Relationship: asyncoperation ProductAssociation_AsyncOperations
Property | Value |
---|---|
ReferencingEntity | asyncoperation |
ReferencingAttribute | regardingobjectid |
ReferencedEntityNavigationPropertyName | ProductAssociation_AsyncOperations |
IsCustomizable | False |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplay Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: bulkdeletefailure productassociation_BulkDeleteFailures
Property | Value |
---|---|
ReferencingEntity | bulkdeletefailure |
ReferencingAttribute | regardingobjectid |
ReferencedEntityNavigationPropertyName | productassociation_BulkDeleteFailures |
IsCustomizable | True |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplay Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: dynamicproperty ProductAssociation_DynamicProperty
Property | Value |
---|---|
ReferencingEntity | dynamicproperty |
ReferencingAttribute | regardingobjectid |
ReferencedEntityNavigationPropertyName | ProductAssociation_DynamicProperty |
IsCustomizable | True |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplay Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: dynamicpropertyassociation ProductAssociation_DynamicPropertyAssociation
Property | Value |
---|---|
ReferencingEntity | dynamicpropertyassociation |
ReferencingAttribute | regardingobjectid |
ReferencedEntityNavigationPropertyName | ProductAssociation_DynamicPropertyAssociation |
IsCustomizable | True |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplay Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: invoicedetail productAssociation_invoice_details
Property | Value |
---|---|
ReferencingEntity | invoicedetail |
ReferencingAttribute | productassociationid |
ReferencedEntityNavigationPropertyName | productAssociation_invoice_details |
IsCustomizable | True |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplay Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: mailboxtrackingfolder productassociation_MailboxTrackingFolders
Property | Value |
---|---|
ReferencingEntity | mailboxtrackingfolder |
ReferencingAttribute | regardingobjectid |
ReferencedEntityNavigationPropertyName | productassociation_MailboxTrackingFolders |
IsCustomizable | True |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplay Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: opportunityproduct productAssociation_opportunity_product
Property | Value |
---|---|
ReferencingEntity | opportunityproduct |
ReferencingAttribute | productassociationid |
ReferencedEntityNavigationPropertyName | productAssociation_opportunity_product |
IsCustomizable | True |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplay Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: principalobjectattributeaccess ProductAssociation_PrincipalObjectAttributeAccess
Property | Value |
---|---|
ReferencingEntity | principalobjectattributeaccess |
ReferencingAttribute | objectid |
ReferencedEntityNavigationPropertyName | ProductAssociation_PrincipalObjectAttributeAccess |
IsCustomizable | True |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: UseCollectionName Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: processsession ProductAssociation_ProcessSessions
Property | Value |
---|---|
ReferencingEntity | processsession |
ReferencingAttribute | regardingobjectid |
ReferencedEntityNavigationPropertyName | ProductAssociation_ProcessSessions |
IsCustomizable | False |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: UseCollectionName Group: Details Label: MenuId: null Order: 110 QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: quotedetail productAssociation_quote_details
Property | Value |
---|---|
ReferencingEntity | quotedetail |
ReferencingAttribute | productassociationid |
ReferencedEntityNavigationPropertyName | productAssociation_quote_details |
IsCustomizable | True |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplay Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: salesorderdetail productAssociation_salesorder_details
Property | Value |
---|---|
ReferencingEntity | salesorderdetail |
ReferencingAttribute | productassociationid |
ReferencedEntityNavigationPropertyName | productAssociation_salesorder_details |
IsCustomizable | True |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplay Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Many-To-One Relationship: syncerror ProductAssociation_SyncErrors
Property | Value |
---|---|
ReferencingEntity | syncerror |
ReferencingAttribute | regardingobjectid |
ReferencedEntityNavigationPropertyName | ProductAssociation_SyncErrors |
IsCustomizable | True |
AssociatedMenuConfiguration | AvailableOffline: True Behavior: DoNotDisplay Group: Details Label: MenuId: null Order: QueryApi: null ViewId: 00000000-0000-0000-0000-000000000000 |
Dataverse table/entity reference
Dataverse Web API Reference