Changeset Naming Convention & Commit Standards in Dynamics 365 Finance & Operations
Question 30 — Traceable, audit-ready changeset names across ADO work items, designs and deployment phases.
Interview Question
Model Answer (Short)
A changeset naming convention gives every check-in a consistent, traceable name that links the code
back to its ADO work item, its functional design (FDS), the
deployment phase and a timestamp. This enables audit compliance
and alignment across multi-country teams. A typical standard is:
. Each check-in must
include a valid ADOID and FDSID, use the correct type
(REL for initial release, then BUG/CR/ENH), the right phase, and underscores only as delimiters.
Parameter Definitions
| Parameter | Meaning | Example values |
|---|---|---|
| Region | Geographic / rollout region | GLB, CHN, THT |
| Type | Nature of the change | REL, BUG, CR, ENH |
| ADOID | Azure DevOps work item ID | 12345 |
| FDSID | Functional design (design ID) | FIN, SCM_O2C |
| Phase | Deployment / test phase | DEV, UT, SIT, UAT, FUT |
| Timestamp | Date & time of the change | YYYYMMDD_HHMM |
Example changeset names
GLB_REL_12345_FIN_01_SIT_20260622_1400CHN_BUG_45678_SCM_FUL_02_SIT_20260622_1415THT_CR_78901_SCM_O2C_07_UAT_20260622_1430CHN_ENH_34567_SCM_PLN_01_DEV_20260622_1445
Usage guidelines
- Use REL for initial releases only.
- Use BUG / CR / ENH post-baseline.
- Use DEV for the development phase.
- Always include a valid ADOID and FDSID.
- Use the underscore (_) only as the delimiter.
Example — Breaking down a changeset name
# Changeset name
GLB_REL_12345_FIN_01_SIT_20260622_1400
# Decoded
Region = GLB # Global
Type = REL # Initial release
ADOID = 12345 # Azure DevOps work item
FDSID = FIN_01 # Finance design ID
Phase = SIT # System Integration Testing
Timestamp = 20260622_1400 # 22-Jun-2026, 14:00
Example — A post-baseline change request
# A change request (CR) in UAT for an Order-to-Cash design
THT_CR_78901_SCM_O2C_07_UAT_20260622_1430
# Region=THT Type=CR ADOID=78901 FDSID=SCM_O2C_07 Phase=UAT
Points the interviewer wants to hear
- The name links code to its ADO work item, FDS, phase and time.
- Format:
Region_Type_ADOID_FDSID_Phase_YYYYMMDD_HHMM. - REL for first release; BUG/CR/ENH afterwards.
- Always include a valid ADOID and FDSID; underscore is the only delimiter.
- Purpose: traceability, audit readiness and multi-country alignment.
Likely Follow-up Questions
- Why is linking a changeset to an ADOID and FDSID important for audits?
- When do you use REL versus CR/ENH?
- What do the phase codes (DEV, UT, SIT, UAT, FUT) represent?
- Why enforce a strict delimiter in the naming convention?
Key Takeaway
A standard changeset name —
Region_Type_ADOID_FDSID_Phase_YYYYMMDD_HHMM — makes every check-in
traceable and audit-ready, tying code to its work item, design and deployment phase across
distributed teams. Always include a valid ADOID and FDSID.