afv-library/skills/integration-eventing-cdc-configure/references/deploy-troubleshooting.md

3.5 KiB

CDC Deploy Troubleshooting

Errors observed during real org dry-runs while authoring this skill, with the metadata-side fix.

"Unable to find the specified channel"

The <eventChannel> value doesn't match a channel known to the org.

  • For the default channel, the value must be exactly ChangeEvents. NOT data/ChangeEvents, NOT /data/ChangeEvents, NOT data/ChangeEvent.
  • For a custom channel, the value must match the channel's DeveloperName including the __chn suffix — e.g. PartnerSync__chn.
  • If the custom channel is in the same deploy, ensure it's in the same package directory so MDAPI orders the deploy correctly.

"...invalid event in the 'selectedEntity' field"

<selectedEntity> must be the ChangeEvent entity, not the source object.

Source Wrong Right
Account Account AccountChangeEvent
Lead Lead LeadChangeEvent
Order__c Order__c Order__ChangeEvent
Custom__c Custom__c Custom__ChangeEvent

For custom objects, swap the trailing __c for __ChangeEvent — the double underscore separator is preserved.

"Cannot create a new component with the namespace: