The Common Catalog Task document is an XML schema that contains default fields for mapping catalog task form values from one system to another. The common catalog task format mirrors what one would see in an ITIL view of a Catalog Task form with related lists expressed in embedded XML form. Common Catalog Task is found available as part of the Common Request update set.
A sample Common Catalog Task looks like this:
<common_catalog_task>
<action />
<active />
<activity_due />
<additional_assignee_list />
<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>
<approval_history />
<approval_set />
<assigned_to_name />
<assigned_to_email />
<assignment_group_name />
<assignment_group />
<attachments>
<attachment>
<data />
<size_bytes />
<file_name />
<sys_id />
<content_type />
</attachment>
</attachments>
<business_duration />
<business_service_name />
<business_stc />
<calendar_duration />
<calendar_stc />
<caller />
<caller_id />
<caller_full_name />
<caller_first_name />
<caller_last_name />
<caller_email />
<category />
<caused_by />
<child_incidents />
<close_code />
<close_notes />
<closed_at />
<closed_by_id />
<closed_by_full_name />
<cmdb_ci_id />
<cmdb_ci_name />
<comments />
<comments_and_work_notes />
<company_id />
<company_name />
<contact_type />
<correlation_display />
<correlation_id />
<delivery_plan_display />
<delivery_task_display />
<description />
<due_date />
<escalation />
<expected_start />
<follow_up />
<group_list />
<group_approvals>
<group_approval>
<approval />
<approval_user />
<short_description />
</group_approval>
<group_approvals>
<impact />
<incident_state />
<knowledge />
<location_id />
<location_name />
<made_sla />
<notify />
<number />
<opened_at />
<opened_by_id />
<opened_by_full_name />
<opened_by_email />
<order />
<parent_id />
<parent_incident_number />
<priority />
<problem_id />
<problem_number />
<provider />
<reassignment_count />
<reopen_count />
<resolved_at />
<resolved_by_id />
<resolved_by_full_name />
<resolved_by_email />
<rfc_id />
<rfc_display />
<severity />
<short_description />
<sla_due />
<state />
<subcategory />
<time_worked />
<urgency />
<variables />
<watch_list />
<work_end />
<work_notes />
<work_start />
</common_catalog_task>
Embedded records
Embedded records are fields in the Common Catalog Task document that cannot be mapped by singular values. Instead, they are entirely different records included inside the Common Catalog Task document to be created on the subscribing system.
The following are examples of the embedded records in Common Catalog Task:
Configuration Item's Affected Embedded Record
The CI affected field in the Common Catalog Task is an embedded record that, when populated, will create a new ci affected on the system receiving the Common Catalog Task.
| 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 |
Group Approval Embedded Record
The group approval field in the Common Catalog Task is an embedded record that, when populated, will create a new ci affected on the system receiving the Common Catalog Task.
| Table Map Source Field | Definition |
|---|---|
| approval | Status of the catalog task's approval |
approval_user | Unique record identifier of the approval user |
| assignment_group | Unique record identifier of the assignment group |
| short_description | Short description of the group approval |
Approver Embedded Record
The approver field in the Common Catalog Task is an embedded record that, when populated, will create a new approver on the system receiving the Common Catalog Task.
| 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 Catalog Task is an embedded record that, when populated, will create a new attachment on the system receiving the Common Catalog Task.
| 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.) |
