Configure ability to copy a change request

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 2 minutes to read

    • You can configure the ability to copy a change request record and its details using system properties.

    Before you begin

    Role required: admin

    About this task

    You can configure the following functionality.
    • Disable the ability to copy a change request.
    • Disable the ability to copy attachments.
    • Determine the components of the source change request that are copied.

    Procedure

    1. Navigate to All > Change > Administration > Change Properties.
      Some properties are found by entering sys_properties.list in the application navigator, as noted.
    2. Set the following properties as desired.
      OptionDescription
      Disable the ability to copy a change request Set Enable Copy Change feature (com.snc.change_request.enable_copy) to false.
      Disable the ability to copy an attachment

      Set Copy attachments from originating change (com.snc.change_request.attach.enable_copy) to false.
      Disable the ability to copy the attachments from the change task This system property is located in the [sys_properties] table.

      Set the Enable copying of attachments from the originating change's related change tasks (com.snc.change_request.rl.change_task.attach.enable_copy) system property to false.

      Note:
      If the ability to copy attachments is enabled, the attachment appears on the copy of the change request only after it is saved.
      Configure attributes to be copied Edit the list of values in List of attributes (comma-separated) that will be copied from the originating change (com.snc.change_request.copy.attributes) to remove or add more attributes.

      For example, to prevent the Assigned to attribute from being copied, remove the assigned_to value from the list of attributes in the property text box.
      Configure related lists to be copied This system property is located in the [sys_properties] table. The following related lists are copied by default:
      • Affected CIs
      • Impacted Services/CIs
      • Change Tasks

      Edit the list of values in Related lists (comma-separated) that will be copied from the originating change (com.snc.change_request.copy.related_lists).

      For example, if you do not want to copy the Change Tasks related list, remove the change_task value from the list of related lists in the property text box.

      Note:
      You can configure this property to control the copy functionality of the Affected CIs, Impacted Services/CIs, and Change Tasks related lists. You cannot add any other related list to this property.
      Configure attributes of the default related lists to be copied These system properties are located in the [sys_properties] table. Navigate to the appropriate system property for one of the default related lists to configure the attributes to copy.
      Table 1. System properties for related list attributes
      Related list System property
      Change Tasks com.snc.change_request.copy.rl.change_task.attributes
      Affected CIs com.snc.change_request.copy.rl.task_ci.attributes
      Impacted Services/CIs com.snc.change_request.copy.rl.task_cmdb_ci_service.attributes
    3. Complete the following steps to further customize the ability to copy a change request by modifying a script include.
      1. Navigate to System Definition > Script Includes.
      2. Modify the ChangeUtils script include.
        For example, the ability to copy a change request is not available by default for standard changes. However, you can provide your own implementation of the isCopyRulesValid function in the ChangeUtils script include to override the default.