Skip to content
{'Tutorial': 'add a new change management state'} › Reference › Change Management › IT Service Management
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a UI action

Create a UI action to display a button on a change request for the Complete state.

Before you begin

Role required: admin

About this task

The UI action must contain a condition that uses the state model script include to decide when the Complete button is displayed on the Change Request form. In this case, the Complete button is displayed only when the change has reached the Implement state.

Procedure

  1. Open the Change Request form.

  2. Open the form context menu and select Configure > UI Actions.

  3. Locate and open the existing Implement UI action.

  4. Open the form context menu and click Insert and Stay to create a duplicate record.

  5. Modify the following fields with new values.

FieldValues
NameComplete.
Action namestate\_model\_move\_to\_complete.
HintProgresses change to Complete state.
Onclick`moveToComplete();`.
Conditiongs.hasRole('itil') && new ChangeRequestStateHandler(current).isNext("complete")
ScriptUpdate function, state name, and state value. 
function moveToComplete(){
                  var ga = new GlideAjax("ChangeRequestStateHandlerAjax");         
                  ga.addParam("sysparm_name", "getStateValue");         
                  ga.addParam("sysparm_state_name", "complete"); 
                  ga.getXMLAnswer(function(stateValue) {              
                      g_form.setValue("state", stateValue);              
                      gsftSubmit(null, g_form.getFormElement(), "state_model_move_to_complete");         
                  });
          } 
          if (typeof window == 'undefined')   
             setRedirect(); 

          function setRedirect() {   
              current.update();   
              action.setRedirectURL(current);
          }
.
  1. Click Update.

Parent Topic:Tutorial: add a new change management state

Previous topic:Update the state model script include

Next topic:Create a process flow record