Edit

Share via

Product Association (ProductAssociation) table/entity reference (Microsoft Dynamics 365)

Instance of a product added to a bundle or kit.

Messages

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 /productassociations
See 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 /productassociations
See 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

Properties

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

Writable columns/attributes

These columns/attributes return true for either IsValidForCreate or IsValidForUpdate (usually both). Listed by SchemaName.

AssociatedProduct

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

DMTImportState

Property Value
Description Internal Use Only
DisplayName Internal Use Only
IsValidForForm False
IsValidForRead False
LogicalName dmtimportstate
RequiredLevel None
Type Integer
MaxValue 2147483647
MinValue -2147483648

ImportSequenceNumber

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

OverriddenCreatedOn

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

ProductAssociationId

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

ProductId

Property Value
Description Select a bundle or a kit.
DisplayName Product
IsValidForForm True
IsValidForRead True
LogicalName productid
RequiredLevel SystemRequired
Type Lookup
Targets product

ProductIsRequired

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

ProductIsRequired Choices/Options

Value Label
0 Optional
1 Required

PropertyCustomizationStatus

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

PropertyCustomizationStatus Choices/Options

Value Label
0 Not Available
1 Available

Quantity

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

statecode

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

statecode Choices/Options

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

statuscode

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

statuscode Choices/Options

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

TimeZoneRuleVersionNumber

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

TransactionCurrencyId

Property Value
Description Shows the currency associated with the record.
DisplayName Currency
IsValidForForm True
IsValidForRead True
LogicalName transactioncurrencyid
RequiredLevel None
Type Lookup
Targets transactioncurrency

UoMId

Property Value
Description Shows the unit of the product association.
DisplayName Unit
IsValidForForm True
IsValidForRead True
LogicalName uomid
RequiredLevel ApplicationRequired
Type Lookup
Targets uom

UTCConversionTimeZoneCode

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

Read-only columns/attributes

These columns/attributes return false for both IsValidForCreate and IsValidForUpdate. Listed by SchemaName.

CreatedBy

Property Value
Description Shows who created the record.
DisplayName Created By
IsValidForForm True
IsValidForRead True
LogicalName createdby
RequiredLevel None
Type Lookup
Targets systemuser

CreatedOn

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

CreatedOnBehalfBy

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

ExchangeRate

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

ModifiedBy

Property Value
Description Shows who last updated the record.
DisplayName Modified By
IsValidForForm True
IsValidForRead True
LogicalName modifiedby
RequiredLevel None
Type Lookup
Targets systemuser

ModifiedOn

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

ModifiedOnBehalfBy

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

OrganizationId

Property Value
Description Unique identifier for the organization
DisplayName Organization Id
IsValidForForm False
IsValidForRead True
LogicalName organizationid
RequiredLevel SystemRequired
Type Lookup
Targets organization

VersionNumber

Property Value
Description Version Number
DisplayName Version Number
IsValidForForm False
IsValidForRead True
LogicalName versionnumber
RequiredLevel None
Type BigInt
MaxValue 9223372036854775807
MinValue -9223372036854775808

Many-to-One relationships

These relationships are many-to-one. Listed by SchemaName.

lk_ProductAssociate_createdby

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

lk_ProductAssociation_createdonbehalfby

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

lk_ProductAssociation_modifiedby

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

lk_ProductAssociation_modifiedonbehalfby

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

organization_ProductAssociation

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

Product_ProductAssociation_AssocProd

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

Product_ProductAssociation_Prod

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

transactioncurrency_ProductAssociation

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

unit_of_measurement_productassociation

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

One-to-Many relationships

These relationships are one-to-many. Listed by SchemaName.

ProductAssociation_AsyncOperations

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

productassociation_BulkDeleteFailures

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

ProductAssociation_DynamicProperty

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

ProductAssociation_DynamicPropertyAssociation

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

productAssociation_invoice_details

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

productassociation_MailboxTrackingFolders

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

productAssociation_opportunity_product

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

ProductAssociation_PrincipalObjectAttributeAccess

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

ProductAssociation_ProcessSessions

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

productAssociation_quote_details

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

productAssociation_salesorder_details

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

ProductAssociation_SyncErrors

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

See also

Dataverse table/entity reference
Dataverse Web API Reference

  • Last updated on