Create a UI action

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read

    • 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.
      Field Values
      Name Complete.
      Action name state_model_move_to_complete.
      Hint Progresses change to Complete state.
      Onclick moveToComplete();.
      Condition gs.hasRole('itil') && new ChangeRequestStateHandler(current).isNext("complete")
      Script Update 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);
          }
      .
    6. Click Update.