Aktion: Bereichsbezogen, global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Die Aktions- API bietet Methoden zum Verarbeiten von Daten für URLs in einem UI-Aktionsskript.

    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]. Weitere Informationen finden Sie unter UI-Aktionen.

    Methoden für diese API werden in serverseitigem JavaScript mit dem Variablennamen „action“ bezeichnet. Weitere Informationen finden Sie unter Interaktionen mit UI-Aktionen erstellen.

    Aktion - getGlideURI()

    Ruft ein GlideURI-Objekt ab, um die Benutzeransicht 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 wird als Fehler betrachtet, einschließlich NULL.

    Das folgende Beispiel zeigt, wie Sie die Benutzeransicht abrufen und die Umleitungs-URL für die Servicekatalog-Homepage festlegen.

    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(ZeichenfolgeparameterName)

    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 Benutzeransicht.

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

    Das folgende Beispiel zeigt, wie Sie den Anrufernamen und die Incident-Beschreibung einbeziehen, die aus einem Interaktionsdatensatz erstellt wurden. Weitere Informationen finden Sie unter Anwenderdefinierte UI-Aktionen im -Arbeitsbereich einrichten.

    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(Boolean 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 GlideRecordangeben. Wenn Sie die URL als GlideRecord übergeben, legt dieser Wert den Fokus auf das Formular dieses Datensatzes.
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    void

    Das folgende Beispiel zeigt, wie ein Anwender mithilfe der current- Variablen von einer UI Action zu einer URL umgeleitet wird.

    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 Sie einen neuen Incident-Datensatz erstellen und nach Abschluss einer UI-Aktion zum neuen Incident umleiten.
    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(Object URL)

    Legt den Rückgabe-URI für diese Transaktion fest, nachdem eine UI-Aktion abgeschlossen wurde. Sie können diese Methode verwenden, um zu bestimmen, welche Seite der Anwender anzeigt, wenn er von der Übermittlung zurückkehrt.

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

    Im folgenden Beispiel kann der Benutzer die UI-Aktion auswählen, um anhand der Informationen aus dem Problemdatensatz und der Change-Vorlage einen Change-Datensatz zu erstellen. Nach der Änderung kehrt der Benutzer zur aktuellen Ansicht zurück. Weitere Informationen finden Sie unter Skriptbasierte 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(ZeichenfolgeparameterName, Zeichenfolgenparameterwert)

    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');