Aktion: Umfang, Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Die Aktion Die API stellt Methoden zur Verarbeitung von Daten für URLs in einem UI-Aktionsskript bereit.

    Verwenden Sie diese API, um UI-Aktionen zu konfigurieren, mit denen Anwender interagieren können. Verwenden Sie diese Skripts in der Tabelle „UI-Aktion“ [sys_ui_action]. Informationen finden Sie unter UI-Aktionen .

    Auf Methoden für diese API wird in einem serverseitigen JavaScript mit dem Variablennamen „action“ verwiesen. Weitere Informationen finden Sie unter Interaktionen mit UI-Aktionen werden erstellt .

    Aktion – getGlideURI()

    Ruft ein GlideURI-Objekt ab, um die Anwenderansicht zu bestimmen.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Objekt GlideURI-Objekt, das den URI-Parameter der Anwenderansicht darstellt.
    Hinweis:
    Jeder andere zurückgegebene Wert gilt als Fehler, einschließlich null.

    Das folgende Beispiel zeigt, wie die Anwenderansicht abgerufen und die Umleitungs-URL zur Servicekatalog-Homepage festgelegt wird.

    var uri = action.getGlideURI();
var path = 'catalog_home.do';

uri.set('sysparm_view', 'catalog_default');
action.setRedirectURL(uri.toString(path));

    Aktion – getReturnURL()

    Ruft die URL der angezeigten Rückgabeseite ab, nachdem eine UI-Aktion abgeschlossen wurde.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Zeichenfolge URL der Rückgabeseite, die nach Abschluss einer UI-Aktion angezeigt wird. 
    action.getReturnURL();

    Aktion – getURLParameter(String parameterName)

    Ruft den Wert eines URL-Parameters ab.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    parameterName Zeichenfolge Name des URL-Parameternamens, der für den URL-Parameterwert abgefragt werden soll.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Zeichenfolge URL-Parameterwert. 
    action.getURLParameter('sysparm_query');

    Aktion – openGlideRecord(Object gr)

    Öffnet eine Seite mit einem GlideRecord in der Anwenderansicht.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    gr GlideRecord GlideRecord der Seite, die in der Anwenderansicht geöffnet werden soll.
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    void  

    Das folgende Beispiel zeigt, wie der Anrufername und die Incident-Beschreibung eingefügt werden, die aus einem Interaktionsdatensatz erstellt wurden. Weitere Einzelheiten finden Sie unter Customizing Configurable Workspace with declarative actions.

    if(current.update()){
  var inc = new GlideRecord("incident");
  inc.newRecord();
  inc.caller_id = current.opened_for;
  inc.short_description = current.short_description;
  action.openGlideRecord(inc);
}

    Aktion – setNoPop(boolescher noPop)

    Gibt an, ob Popup-Fenster auf der Seite in der aktuellen Ansicht aktiviert oder deaktiviert werden sollen.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    NoPop Boolean Kennzeichnung, die angibt, ob Popup-Fenster auf der Seite aktiviert oder deaktiviert werden sollen:
    • Wahr: Deaktiviert Popup-Fenster.
    • false: Standard. Aktiviert Popup-Fenster.
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Popup-Fenster für eine UI-Aktion deaktiviert werden.

    
action.setNoPop(true);

    Aktion – setRedirectURL(Objekt-URL)

    Legt den Umleitungs-URI für diese Transaktion fest, der die nächste Seite bestimmt, die der Anwender sieht.

    Für Anwendungsfälle:
    Tabelle : 11. Parameter
    Name Typ Beschreibung
    URL Objekt URL, die als Umleitung festgelegt werden soll. Sie können die URL als Zeichenfolge oder angeben GlideRecord . Wenn Sie die URL als GlideRecord übergeben, wird dieser Wert auf das Formular dieses Datensatzes fokussiert.
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    void

    Das folgende Beispiel zeigt, wie Sie einen Anwender von einer UI-Aktion mit zu einer URL umleiten Aktuell Variable.

    var fixchg = new GlideRecord("change_request");
fixchg.short_description= current.short_description;
fixchg.comments= current.comments.getHTMLValue();
// fixchg.parent = current.sys_id;
fixchg.insert();
FixChange();
 
gs.addInfoMessage("Change "+ fixchg.number+" created");
action.setRedirectURL(current);
action.setReturnURL(fixchg);
 
function FixChange(){
var m2m = new GlideRecord('task_rel_task');
m2m.initialize();
m2m.child= current.sys_id;
m2m.parent= fixchg.sys_id;
m2m.type.setDisplayValue("Fixes::Fixed by");
m2m.insert();}
    Das folgende Beispiel zeigt, wie ein neuer Incident-Datensatz erstellt und nach Abschluss einer UI-Aktion zum neuen Incident umgeleitet wird.
    var reqItem = current.u_item;
var requestedFor = current.u_requested_for;
var location = current.location;

if(current.u_incident_request == 'Incident'){
  //Create a new incident record and redirect to the new incident
  var rec = new GlideRecord('incident');
  rec.initialize();
  rec.caller_id = requestedFor;
  rec.location = location;
  rec.insert();
  action.setRedirectURL(rec);
}

if(current.u_incident_request == 'Request'){
  //Build the url and route the user to the request item
  var url = '';
  if(current.u_item.sys_class_name == 'sc_cat_item_guide'){
    url = 'com.glideapp.servicecatalog_cat_item_guide_view.do?sysparm_initial=true&sysparm_guide=' + 
      reqItem + '&sysparm_user=' + requestedFor + '&sysparm_location=' + location;
  }
  else{
    url = 'com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=' + reqItem + '&sysparm_user=' +  
      requestedFor + '&sysparm_location=' + location;
  }
  action.setRedirectURL(url);
}

    Aktion – setReturnURL(Objekt-URL)

    Legt den Rückgabe-URI für diese Transaktion fest, nachdem eine UI-Aktion abgeschlossen ist. Sie können diese Methode verwenden, um zu bestimmen, welche Seite der Anwender bei der Rückkehr aus dem Absenden anzeigt.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    URL Objekt URI, der als Rückgabeort festgelegt werden soll, nachdem eine UI-Aktion abgeschlossen ist. Sie können die URL als Zeichenfolge oder angeben GlideRecord .
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    void

    Im folgenden Beispiel kann der Anwender die UI-Aktion auswählen, um einen Change-Datensatz mithilfe von Informationen aus dem Problemdatensatz und der Change-Vorlage zu erstellen. Nach der Änderung kehrt der Anwender zu zurück Aktuell Anzeigen. Weitere Informationen finden Sie unter Geskriptete Vorlagen . Weitere Anwendungsfälle finden Sie unter Task relationships with UI actions.

    var change = new GlideRecord("change_request");
change.initialize();
change.short_description = current.short_description;
change.description = current.u_details;
change.cmdb_ci = current.u_service;
change.priority = current.priority;
change.requested_by = current.caller_id;
change.assignment_group.setDisplayValue('Change & Release');
change.u_status = 'New';
change.parent = current.number;
change.applyTemplate("standard_rfc");
current.rfc = change.insert();
current.comments = 'Change ' + change.number + ' created.';

var mySysID = current.update();

gs.addInfoMessage("Change " + change.number + " created");
action.setRedirectURL(change);
action.setReturnURL(current);

    Aktion – setURLParameter(ZeichenfolgenparameterName, ZeichenfolgenparameterValue)

    Legt einen URL-Parameternamen und -Wert fest.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    parameterName Zeichenfolge Name des URL-Parameters.
    ParameterWert Zeichenfolge Wert des Parameters.
    Tabelle : 16. Rückgaben
    Typ Beschreibung
    void 
    action.setURLParameter('sysparm_query', 'priority=2^active=true');