Audit Log now tracks changes on Business Units

29 June 2023

Composable Commerce

HTTP API

Enhancement

B2BAudit LogProduct catalogQuotesProject configurationGraphQL

We have extended the capabilities of Audit Log to track changes to Business Units. In addition, we introduced new Change Types for Stores, Product Selections, and Quotes.

To help you filter Records, we've added the resourceKey query parameter to the Query Records endpoint. This allows you to filter Records by key for three specific resource types: business-units, products, and stores.

Changes:

[API] Added the following Change Types:
- Business Units: AddAssociateChange, ChangeAssociateChange, ChangeAssociateModeChange, ChangeParentUnitChange, ChangeStatusChange, RemoveAssociateChange, SetAddressCustomFieldChange, SetAddressCustomTypeChange, SetContactEmailChange, SetStoreModeChange.
- Stores: AddProductSelectionChange, ChangeProductSelectionActiveChange, RemoveProductSelectionChange.
- Product Selections: AddProductChange, SetVariantSelectionChange.
- Quotes: RequestQuoteRenegotiationChange.
[API] Added Label BusinessUnitLabel.
[API] Added query parameter resourceKey to the Query Records endpoint.
[API] Added key field to resource property of Record.
[API] Added business-unit to ChangeHistoryResourceType enum.
[GraphQL API] Added the following types to the GraphQL schema: BusinessUnitChangeInput, ResourceIdentifier, BusinessUnitLabel.
[GraphQL API] Changed the ResourceTypes type:
- Added BusinessUnit to the enum ResourceTypes.
[GraphQL API] Changed the Query type:
- Added the businessUnits field to the Query type.
- Added the businessUnit field to the Query type.
- Added the resourceKey property to the products field.
- Added the resourceKey property to the stores field.
[GraphQL API] Changed the ChangeHistory type:
- Added key field to resource property of ChangeHistory.

The following change was introduced in terms of GraphQL SDL:

  enum BusinessUnitChangeInput {
    addAddress
    addAssociate
    addBillingAddressId
    addShippingAddressId
    changeAddress
    changeAssociate
    changeAssociateMode
    changeName
    changeParentUnit
    changeStatus
    removeAddress
    removeAssociate
    removeBillingAddressId
    removeShippingAddressId
    setAddressCustomField
    setAddressCustomType
    setContactEmail
    setCustomField
    setCustomType
    setDefaultBillingAddress
    setDefaultShippingAddress
    setStoreMode
    setStores
  }

  type ResourceIdentifier {
    id: String
    typeId: String!
    key: String
  }

  type BusinessUnitLabel {
    key: String!
    name: String!
  }

  extend enum ResourceTypes {
    BusinessUnit
  }

  extend enum QuoteChangeInput {
    requestQuoteRenegotiation
  }

  extend enum ProductSelectionChangeInput {
    setVariantSelection
  }

  extend enum StoreChangeInput {
    addProductSelection
    changeProductSelectionActive
    removeProductSelection
  }

  extend type Query {
    businessUnits(
      date: DateRange
      limit: Int
      offset: Int
      source: Source
      type: Type
      clientId: String
      userId: String
      customerId: String
      changes: [BusinessUnitChangeInput!]
      expand: Boolean
      stores: [String!]
      resourceKey: String
    ): ChangeHistoryQueryResults!

    businessUnit(
      id: String!
      date: DateRange
      limit: Int
      offset: Int
      source: Source
      type: Type
      clientId: String
      userId: String
      customerId: String
      changes: [BusinessUnitChangeInput!]
      expand: Boolean
      stores: [String!]
    ): ChangeHistoryQueryResults!

    products(
      resourceKey: String
    ): ChangeHistoryQueryResults!

    stores(
      resourceKey: String
    ): ChangeHistoryQueryResults!
  }