Error: Cannot create epic. Value for primaryProgramId is invalid in Jira Align sync- ConnectAll

Products

• ConnectAll SaaS

Issue/Introduction

Introduction When synchronizing Epics from Clarity to Jira Align using ConnectAll, the sync fails with an API error indicating invalid field values for mandatory Jira Align fields.

Symptoms The ConnectAll logs show the following exception: java.lang.Exception: Exception when trying to create record due to the error "Cannot create epic. Value for primaryProgramId is invalid. Value for ownerId is invalid. Value for processStepId is invalid."

Environment

• ConnectAll 4.x

Cause

This error occurs when the data being sent to Jira Align does not meet the platform's mandatory requirements or scope constraints:

Resolution

To resolve this synchronization failure, follow these steps:

1. Verify User Scope: Ensure the user mapped to the ownerId in Jira Align belongs to the correct Program and Portfolio associated with the Epic.
2. Check Field Mappings: Confirm that primaryProgramId, ownerId, and processStepId are correctly mapped in the CloudJA_to_Clarity_Epics_Bi_Sync automation.
3. Validate Value Transformations:
   • Check the Value Mapping tab in ConnectAll.
   • Ensure list-type values from Clarity are correctly translated to the corresponding IDs in Jira Align.
4. Confirm Data Completeness: Verify that the source records in Clarity have these mandatory fields populated before the synchronization runs.