---
title: "Common Change"
canonical: "https://docs.perspectium.com/space/gold/1262666/Common%20Change"
format: markdown
---
The  Common Change  document is an XML schema that contains default fields for mapping change request form values from one system to another.  The common change format mirrors what one would see in an ITIL view of the Change Request form with related lists expressed in embedded XML form. A sample  Common Change  looks like this: <common_change>
   <affected_cis>
      <affected_ci>
         <ci_class />
         <ci_name />
         <ci_id />
      </affected_ci>
   </affected_cis>
   <approval />
   <approvers>
      <approver>
         <created />
         <approver_name />
         <assignment_group_name/>
         <approver />
         <state />
         <comments/>
         <approver_email />
         <assignment_group/>
      </approver>
   </approvers>
   <assigned_to />
   <assignment_group />
   <attachments>
      <attachment>
         <data />
         <size_bytes />
         <file_name />
         <sys_id />
         <content_type />
      </attachment>
   </attachments>
   <backout_plan />
   <category />
   <change_tasks>
      <change_task>
         <assignment_group />
         <short_description />
         <correlation_id />
         <number />
         <work_notes />
         <comments />
         <correlation_display />
         <change_task_type />
         <assigned_to />
         <state />
         <description />
         <cmdb_ci />
      </change_task>
   </change_tasks>
   <close_code />
   <close_notes />
   <cmdb_ci />
   <comments />
   <correlation_display />
   <correlation_id />
   <description />
   <end_date />
   <impact />
   <impacted_services>
      <impacted_service>
         <operational_status />
         <type />
         <location_name />
         <id />
         <manually_added />
         <name />
      </impacted_service>
   </impacted_services>
   <implementation_plan />
   <incidents_caused>
      <incident>
         <number />
         <opened_at />
         <category />
         <caller_id_name />
         <assigned_to_name />
         <short_description />
         <priority />
         <id />
         <state />
         <assignment_group_name />
      </incident>
   </incidents_caused>
   <incidents_fixed>
      <incident>
         <number />
         <opened_at />
         <category />
         <caller_id_name />
         <assigned_to_name />
         <short_description />
         <priority />
         <id />
         <state />
         <assignment_group_name />
      </incident>
   </incidents_fixed>
   <justification />
   <number />
   <priority />
   <problems>
      <problem>
         <short_description />
         <assignment_group_name />
         <id />
         <assigned_to_name />
         <state />
         <number />
      </problem>
   </problems>
   <provider />
   <psp_action />
   <requested_by />
   <requested_by_date />
   <risk />
   <short_description />
   <start_date />
   <state />
   <test_plan />
   <type />
   <work_notes />
</common_change> Embedded records Embedded records  are fields in the Common Change document that cannot be mapped by singular values. Instead, they are entirely different records included inside the Common Change document to be created on the subscribing system. The following are examples of the embedded records in Common Change:  Configuration Item's Affected Embedded Record The  CI affected  field in the Common Change is an embedded record that, when populated, will create a new CI affected on the system receiving the Common Change. Table Map Source Field Definition ci_class Class name of the configuration item ci_name Name of the configuration item ci_id Unique record identifier of the configuration item Approver Embedded Record The  approver  field in the Common Change is an embedded record that, when populated, will create a new approver on the system receiving the Common Change. Table Map Source Field Definition created Date the record was created on approver_name Name of the approver assignment_group_name Name of the assignment group approver Unique record identifier of the approver record comments Comments of the approver approver_email Email of the approver assignment_group Unique record identifier of the assignment group record Attachment Embedded Record The  attachment  field in the Common Change is an embedded record that, when populated, will create a new attachment on the system receiving the Common Change. Table Map Source Field Definition data Attachment data in an encoded string format size_bytes Measurement of how much the attachment data contains file_name Name of the attached file  sys_id Unique record identifier of the attachment content_type Attachments content type (i.e jpeg, png, txt, etc.)  Change Task Embedded Record The  change task  field in the Common Change is an embedded record that, when populated, will create a new change task on the system receiving the Common Change. Table Map Source Field Definition assignment_group Unique record identifier of the assignment group record short_description Short description of the change task correlation_id Unique record identifier of the correlating change task number Record number of change task  work_notes Work notes for the change task comments Comments for the change task correlation_display Unique record display of the correlating change task change_task_type Change task category  assigned_to User the change task is assigned to  state State of the change task description Description of the change task cmbd_ci Unique record identifier of the parent record Impacted Service Embedded Record The  impacted service  field in the Common Change is an embedded record that, when populated, will create a new impacted service on the system receiving the Common Change. Table Map Source Field Definition operational_status Status of the impacted service type Class type of the impacted service location_name Location of the impacted service id Unique record identifier of the impacted service manually_added Represents if the impacted service is added manually name Name of the impacted service Similar topics Contact Perspectium Support US:  1 888 620 8880 UK:  44 208 068 5953 support@perspectium.com