Extend the schema for catalogs

To configure Sitecore Content Hub for use with Sitecore Connect for Microsoft D365 Commerce - Content Hub, you extend the product catalog entity definition (M.PCM.Catalog) and add new members.

Note

You must be a superuser to set up and configure the Microsoft Dynamics 365 Commerce Connector in Content Hub. These steps use the default connector configuration and mappings. To use a custom domain model or if you have already extended the PCM entity, see Extend the schema for products.

The Dynamics 365 Commerce Connector synchronizes catalog data with the following fields on the M.PCM.Catalog entity:

  • CatalogName

  • CatalogLabel

  • CatalogDescription

  • AvailableFrom

  • AvailableUntil

You must create the following additional fields for the M.PCM.Catalog entity:

  • D365CatalogNumber

  • DVCProductToCatalogRelation

  • D365EntityId

  • D365EntityTranslations

Note

These fields are tied closely to the default functionality of the connector. Manual updates to data stored in these fields are discouraged.

To update the M.PCM.Catalog entity:

  1. In Content Hub, on the menu bar, click Manage .

  2. On the Manage page, click Schema.

  3. On the Schema page, in the search box, type M.PCM.Catalog and then select it.

  4. On the M.PCM.Catalog entity definition page, click New Group.

  5. In the New member group dialog box, on the General information tab, define the following:

    • Name - D365Commerce

    • Label (English) - D365 Commerce

  6. Click Save.

  7. Optionally, move the D365 Commerce group to the bottom of the member group list.

To add the D365CatalogNumber member to the D365 Commerce group:

  1. In the left pane, select the D365 Commerce group.

  2. To add a new member, click New member.

  3. In the New member dialog box, next to PROPERTY, click Select.

  4. From the data type list, select String and click Next.

  5. In the New member dialog, on the General Information tab, do the following:

    • In the Name field, enter D365CatalogNumber.

    • In the Label (English) field, enter D365 Catalog Number.

    • Ensure the Multilanguage switch is inactive (Off).

    • Ensure the Unique switch is inactive (Off)

    • Click the Include in content switch to make it active (On)

    • Ensure the Include in autocomplete switch is inactive (Off)

    • Click the Allow Updates switch to make it active (On)

    • Ensure the Boost switch is inactive (Off)

    • Ensure the Secured switch is inactive (Off) [!NOTE] While it is not necessary for the connector to operate, this field is sensitive to sync operations. As a result, consider securing it once the connector security group is created.

    • From the Content type list, select Single line.

  6. Click Save

  7. Repeat steps 2-6 to add the following members, click Apply Changes, and then click Publish to confirm your changes.

Type

Name

Label

Settings

Property - String

DVCProductToCatalogRelation

DVC Product To Catalog Relation

Multilanguage - OffUnique - OffInclude in content - OffInclude in autocomplete - OffAllow Updates - OnBoost - OffSecured - OffContent type - Single line

Property - String

D365EntityId

D365 Entity Id

Multilanguage - OffUnique - OffInclude in content - OffInclude in autocomplete - OffAllow Updates - OnBoost - OffSecured - OffContent type - Single line

Property - String

D365EntityTranslations

D365 Entity Translations

Multilanguage - OffUnique - OffInclude in content - OffInclude in autocomplete - OffAllow Updates - OnBoost - OffSecured - OffContent type - Single line

The three members are now part of the D365 Commerce Group as shown in the following example:

Do you have some feedback for us?

If you have suggestions for improving this article,