Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • IT Service Management
Table of Contents
Choose your release version
    Home New York IT Service Management IT Service Management Change Management Configure Change Management Add a new change request type

    Add a new change request type

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    Add a new change request type

    You can add a new change type to your change process. There are several processes involved with adding a change type. These processes include managing script includes and workflows.

    Before you begin

    Role required: admin

    About this task

    In addition to the three types of change available by default, you can add new change types based on your organization requirements. For example, you can create a change type Expedited for changes that you require to be processed immediately.

    Procedure

    1. Complete the following steps to add a new choice to the Type field.
      1. Open an existing change request.
      2. Right-click the Type field and select Show Choice List.
      3. Click New and fill in the following fields.
        Field Name Description
        Table Select the Change Request table.
        Label Enter a label for the new change type. For example, Expedited.
        Value Enter a label for the new change type. For example, expedited.
        Sequence Enter a sequence for the change type. For example, 4.
      4. Submit the form.
        List of active change types
    2. Complete the following steps to add the new change type to the change request interceptor.
      1. Navigate to System Definition > Interceptors.
      2. Open the Change Request interceptor.
      3. Click New in the Answers related list.
      4. Complete the form, as appropriate.
        Field Description
        Question Change Request
        Name Enter a name for the new change type. For example, Direct to Expedited Change.
        User Prompt Enter a description that is displayed to the end user when they click Create New under Change.
        Target URL Set the appropriate target URL. For example, change_request.do?sys_id=-1&sysparm_query=type=expedited.
        Order Set the appropriate order level for the change type. For example, 400.
      5. Submit the form.
        Add a new change type
    3. Complete the following steps to create the script include for the new change type.
      1. Navigate to System Definition > Script Includes.
      2. Search for a change type script include on which to base the workflow for the new change type. For example, to base it on Emergency change type, search for ChangeRequestStateModelSNC_emergency and open the script include.
      3. Copy the script of the ChangeRequestStateModelSNC_emergency script include from the Script field.
      4. Navigate to System Definition > Script Includes and click New.
      5. Name the new script include to match the value of the new type. For example, ChangeRequestStateModelCust_expedited.
      6. Paste the copied script in the Script field of the new script include.
      7. Update any references in the pasted script include from ChangeRequestStateModelSNC_emergency to ChangeRequestStateModelCust_expedited.
      8. Click Submit.
        Note: An existing script include contains the implementation for all the moving and canMove functions. The moving function is used to pre-populate any fields that are required for the new state. The canMove function is used to check for any additional requirements and to validate whether a task can move to the next state.
    4. Complete the following steps to create the script include to define state transitions and control the transitioning between states for the new change type.
      1. Navigate to System Definition > Script Includes.
      2. Search for change type script include on which to base the transitioning controls for the new change type on. For example, to base it on Emergency change type, search for ChangeRequestStateModel_emergency and open the script include.
      3. Update the name of the script include to match the value of the new type. For example, ChangeRequestStateModelCust_expedited.
      4. Update the reference to the base script include for the new change type. Change the extended Object in line 2 to the base script include name. For example, ChangeRequestStateModelCust_expedited, so the reference is similar to the following string.
        ChangeRequestStateModel_expedited.prototype = Object.extendsObject(ChangeRequestStateModelCust_expedited, { // CUSTOM CODE, type:"ChangeRequestStateModelCust_expedited"});
      5. Click Insert and Stay create a copy of the script include ChangeRequestStateModel_emergency with the new name ChangeRequestStateModelCust_expedited.
    5. Complete the following steps to modify the script include that controls the transition between states using one of the defined models for the new change type. The base method is overridden so that the new state model for the new change type can be utilized.
      1. Navigate to System Definition > Script Includes.
      2. Search for and open the ChangeRequestStateHandler script include, which controls the transitioning between states using one of the defined models.
      3. Create a property to reference the new change request type value. For example, EXPEDITED:"expedited".
      4. Override the base method _resetModel to be able to include the new model. For example, if the change request type is expedited, then the new state model ChangeRequestStateModel_expedited is included. Example code with changes highlighted in bold:
        var ChangeRequestStateHandler = Class.create(); 
                // All references to statehandler constants should be through this class ChangeRequestStateHandler
                ChangeRequestStateHandler.DRAFT = ChangeRequestStateHandlerSNC.DRAFT;
                ChangeRequestStateHandler.ASSESS = ChangeRequestStateHandlerSNC.ASSESS;
                ChangeRequestStateHandler.AUTHORIZE = ChangeRequestStateHandlerSNC.AUTHORIZE;
                ChangeRequestStateHandler.SCHEDULED = ChangeRequestStateHandlerSNC.SCHEDULED; 
                ChangeRequestStateHandler.IMPLEMENT = ChangeRequestStateHandlerSNC.IMPLEMENT; 
                ChangeRequestStateHandler.REVIEW = ChangeRequestStateHandlerSNC.REVIEW; 
                ChangeRequestStateHandler.CLOSED = ChangeRequestStateHandlerSNC.CLOSED;
                ChangeRequestStateHandler.CANCELED = ChangeRequestStateHandlerSNC.CANCELED;
         
                ChangeRequestStateHandler.prototype = Object.extendsObject(ChangeRequestStateHandlerSNC, {
                  EXPEDITED:"expedited", 
                  initialize: function(changeRequestGr) {
                     ChangeRequestStateHandlerSNC.prototype.initialize.call(this, changeRequestGr);
                   }, 
                   _resetModel: function() {
                     this._model = null;
                     var type = this._gr.getValue('type') + ""; 
        
                     if (type == this.NORMAL || type == this.STANDARD || type == this.EMERGENCY) 
                        ChangeRequestStateHandlerSNC.prototype._resetModel.call(this); 
                     else if (type == this.EXPEDITED) 
                        this._model = new ChangeRequestStateModel_expedited(this._gr); 
                   }, 
        
                   type:"ChangeRequestStateHandler" 
                 });
      5. Save the script include.
    6. Complete the following steps to create a workflow for the new change request type.
      1. Navigate to Workflow > Workflow Editor.
      2. Open an existing change request workflow. For example, Change Request – Emergency.
      3. Select Copy from the Actions menu to copy the workflow and name the new workflow. For example, Change Request - Expedited.
      4. Select Properties from the Actions menu to update the condition under which the new workflow executes. For example, [Type] [is] [Expedited] in the condition.
      5. Open the matching change tasks workflow that is called by the main workflow. For example, Change Request - Emergency change tasks.
      6. Select Copy from the Actions menu to copy the workflow and name the new workflow. For example, Change Request - Expedited change tasks.
      7. Select Publish from the Actions menu to publish the new change tasks workflow and make it available for use.
      8. Go back to the first workflow you created and update the Workflow activity to reference the new change tasks workflow. For example, Change Request - Expedited change tasks.
      9. Select Publish from the Actions menu to publish the new workflow and make it available for use.
    Related tasks
    • Add a state to the state model
    Related concepts
    • Change types

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Add a new change request type

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      Add a new change request type

      You can add a new change type to your change process. There are several processes involved with adding a change type. These processes include managing script includes and workflows.

      Before you begin

      Role required: admin

      About this task

      In addition to the three types of change available by default, you can add new change types based on your organization requirements. For example, you can create a change type Expedited for changes that you require to be processed immediately.

      Procedure

      1. Complete the following steps to add a new choice to the Type field.
        1. Open an existing change request.
        2. Right-click the Type field and select Show Choice List.
        3. Click New and fill in the following fields.
          Field Name Description
          Table Select the Change Request table.
          Label Enter a label for the new change type. For example, Expedited.
          Value Enter a label for the new change type. For example, expedited.
          Sequence Enter a sequence for the change type. For example, 4.
        4. Submit the form.
          List of active change types
      2. Complete the following steps to add the new change type to the change request interceptor.
        1. Navigate to System Definition > Interceptors.
        2. Open the Change Request interceptor.
        3. Click New in the Answers related list.
        4. Complete the form, as appropriate.
          Field Description
          Question Change Request
          Name Enter a name for the new change type. For example, Direct to Expedited Change.
          User Prompt Enter a description that is displayed to the end user when they click Create New under Change.
          Target URL Set the appropriate target URL. For example, change_request.do?sys_id=-1&sysparm_query=type=expedited.
          Order Set the appropriate order level for the change type. For example, 400.
        5. Submit the form.
          Add a new change type
      3. Complete the following steps to create the script include for the new change type.
        1. Navigate to System Definition > Script Includes.
        2. Search for a change type script include on which to base the workflow for the new change type. For example, to base it on Emergency change type, search for ChangeRequestStateModelSNC_emergency and open the script include.
        3. Copy the script of the ChangeRequestStateModelSNC_emergency script include from the Script field.
        4. Navigate to System Definition > Script Includes and click New.
        5. Name the new script include to match the value of the new type. For example, ChangeRequestStateModelCust_expedited.
        6. Paste the copied script in the Script field of the new script include.
        7. Update any references in the pasted script include from ChangeRequestStateModelSNC_emergency to ChangeRequestStateModelCust_expedited.
        8. Click Submit.
          Note: An existing script include contains the implementation for all the moving and canMove functions. The moving function is used to pre-populate any fields that are required for the new state. The canMove function is used to check for any additional requirements and to validate whether a task can move to the next state.
      4. Complete the following steps to create the script include to define state transitions and control the transitioning between states for the new change type.
        1. Navigate to System Definition > Script Includes.
        2. Search for change type script include on which to base the transitioning controls for the new change type on. For example, to base it on Emergency change type, search for ChangeRequestStateModel_emergency and open the script include.
        3. Update the name of the script include to match the value of the new type. For example, ChangeRequestStateModelCust_expedited.
        4. Update the reference to the base script include for the new change type. Change the extended Object in line 2 to the base script include name. For example, ChangeRequestStateModelCust_expedited, so the reference is similar to the following string.
          ChangeRequestStateModel_expedited.prototype = Object.extendsObject(ChangeRequestStateModelCust_expedited, { // CUSTOM CODE, type:"ChangeRequestStateModelCust_expedited"});
        5. Click Insert and Stay create a copy of the script include ChangeRequestStateModel_emergency with the new name ChangeRequestStateModelCust_expedited.
      5. Complete the following steps to modify the script include that controls the transition between states using one of the defined models for the new change type. The base method is overridden so that the new state model for the new change type can be utilized.
        1. Navigate to System Definition > Script Includes.
        2. Search for and open the ChangeRequestStateHandler script include, which controls the transitioning between states using one of the defined models.
        3. Create a property to reference the new change request type value. For example, EXPEDITED:"expedited".
        4. Override the base method _resetModel to be able to include the new model. For example, if the change request type is expedited, then the new state model ChangeRequestStateModel_expedited is included. Example code with changes highlighted in bold:
          var ChangeRequestStateHandler = Class.create(); 
                  // All references to statehandler constants should be through this class ChangeRequestStateHandler
                  ChangeRequestStateHandler.DRAFT = ChangeRequestStateHandlerSNC.DRAFT;
                  ChangeRequestStateHandler.ASSESS = ChangeRequestStateHandlerSNC.ASSESS;
                  ChangeRequestStateHandler.AUTHORIZE = ChangeRequestStateHandlerSNC.AUTHORIZE;
                  ChangeRequestStateHandler.SCHEDULED = ChangeRequestStateHandlerSNC.SCHEDULED; 
                  ChangeRequestStateHandler.IMPLEMENT = ChangeRequestStateHandlerSNC.IMPLEMENT; 
                  ChangeRequestStateHandler.REVIEW = ChangeRequestStateHandlerSNC.REVIEW; 
                  ChangeRequestStateHandler.CLOSED = ChangeRequestStateHandlerSNC.CLOSED;
                  ChangeRequestStateHandler.CANCELED = ChangeRequestStateHandlerSNC.CANCELED;
           
                  ChangeRequestStateHandler.prototype = Object.extendsObject(ChangeRequestStateHandlerSNC, {
                    EXPEDITED:"expedited", 
                    initialize: function(changeRequestGr) {
                       ChangeRequestStateHandlerSNC.prototype.initialize.call(this, changeRequestGr);
                     }, 
                     _resetModel: function() {
                       this._model = null;
                       var type = this._gr.getValue('type') + ""; 
          
                       if (type == this.NORMAL || type == this.STANDARD || type == this.EMERGENCY) 
                          ChangeRequestStateHandlerSNC.prototype._resetModel.call(this); 
                       else if (type == this.EXPEDITED) 
                          this._model = new ChangeRequestStateModel_expedited(this._gr); 
                     }, 
          
                     type:"ChangeRequestStateHandler" 
                   });
        5. Save the script include.
      6. Complete the following steps to create a workflow for the new change request type.
        1. Navigate to Workflow > Workflow Editor.
        2. Open an existing change request workflow. For example, Change Request – Emergency.
        3. Select Copy from the Actions menu to copy the workflow and name the new workflow. For example, Change Request - Expedited.
        4. Select Properties from the Actions menu to update the condition under which the new workflow executes. For example, [Type] [is] [Expedited] in the condition.
        5. Open the matching change tasks workflow that is called by the main workflow. For example, Change Request - Emergency change tasks.
        6. Select Copy from the Actions menu to copy the workflow and name the new workflow. For example, Change Request - Expedited change tasks.
        7. Select Publish from the Actions menu to publish the new change tasks workflow and make it available for use.
        8. Go back to the first workflow you created and update the Workflow activity to reference the new change tasks workflow. For example, Change Request - Expedited change tasks.
        9. Select Publish from the Actions menu to publish the new workflow and make it available for use.
      Related tasks
      • Add a state to the state model
      Related concepts
      • Change types

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login