---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Aktion: Umfang, Global

# Aktion: Umfang, Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 UI-Aktionstabelle \[sys_ui_action\]. Informationen finden Sie unter [UI-Aktionen](https://www.servicenow.com/docs/access?context=t_EditingAUIAction&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

Methoden für diese API werden in einem serverseitigen JavaScript mit dem Variablennamen „Aktion" referenziert. Weitere Informationen finden Sie unter [Interaktionen mit UI-Aktionen werden erstellt](https://developer.servicenow.com/blog.do?p=/post/training-ui-action-101/).

## Aktion -- getGlideURI() {#ariaid-title2}

Ruft ein GlideURI-Objekt ab, um die Anwenderansicht zu bestimmen.
{#Action_getGlideURI__table_dxr_lfj_nkb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#Action_getGlideURI__table_dxr_lfj_nkb} {#Action_getGlideURI__table_exr_lfj_nkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | GlideURI-Objekt, das den URI-Parameter der Anwenderansicht darstellt. * [GlideURI -- Umfang](https://servicenow-prod.fluidtopics.net/1~o0RjIKAHBBU3XRHK1q6w#c_GlideURIScopedAPI "Die GlideURI Die API stellt Methoden zur Verarbeitung von URI-Parametern in einer bereichsbezogenen Anwendung bereit.") * [GlideURI: Global](https://servicenow-prod.fluidtopics.net/n1y4nmYnJfb9dbSIIymoFw#GlideURIGlobalAPI "Die GlideURI Die API stellt Methoden zur Verarbeitung von URI-Parametern in einer globalen Anwendung bereit.") {#Action_getGlideURI__ul_f4h_5lj_5mb} Hinweis: Jeder andere zurückgegebene Wert gilt als Fehler, einschließlich Null. |
[Tabelle : 2. Rückgaben]

{#Action_getGlideURI__table_exr_lfj_nkb}  
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() {#ariaid-title3}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 3. Parameter]

{#Action_getReturnURL__table_db4_ffj_nkb} {#Action_getReturnURL__table_eb4_ffj_nkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | URL der Rückgabeseite, die nach Abschluss einer UI-Aktion angezeigt wird. |
[Tabelle : 4. Rückgaben]

{#Action_getReturnURL__table_eb4_ffj_nkb}  

    action.getReturnURL();

## Aktion -- getURLParameter(ZeichenfolgenparameterName) {#ariaid-title4}

Ruft den Wert eines URL-Parameters ab.
{#Action_getURLParameter_S__table_alv_y2j_nkb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Parametername | Zeichenfolge | Name des URL-Parameternamens, der für den URL-Parameterwert abgefragt werden soll. |
[Tabelle : 5. Parameter]

{#Action_getURLParameter_S__table_alv_y2j_nkb} {#Action_getURLParameter_S__table_blv_y2j_nkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | URL-Parameterwert. |
[Tabelle : 6. Rückgaben]

{#Action_getURLParameter_S__table_blv_y2j_nkb}  

    action.getURLParameter('sysparm_query');

## Aktion -- openGlideRecord(Object gr) {#ariaid-title5}

Öffnet eine Seite mit einem GlideRecord in der Anwenderansicht.
{#Action_openGlideRecord_O__table_sy5_bfj_nkb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| gr | [GlideRecord](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#c_GlideRecordScopedAPI "Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet.") | GlideRecord der Seite, die in der Anwenderansicht geöffnet werden soll. |
[Tabelle : 7. Parameter]

{#Action_openGlideRecord_O__table_sy5_bfj_nkb} {#Action_openGlideRecord_O__table_ty5_bfj_nkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 8. Rückgaben]

{#Action_openGlideRecord_O__table_ty5_bfj_nkb}  
Das folgende Beispiel zeigt, wie der Anrufername und die Incident-Beschreibung eingefügt werden, die aus einem Interaktionsdatensatz erstellt wurden. Weitere Informationen finden Sie unter Richten Sie anwenderdefinierte UI-Aktionen im Arbeitsbereich ein .

    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) {#ariaid-title6}

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

| Name | Typ | Beschreibung |
|-|-|-|
| NoPop | Boolean | Kennzeichnung, die angibt, ob Popup-Fenster auf der Seite aktiviert oder deaktiviert werden sollen: * Wahr: Deaktiviert Popup-Fenster. * Falsch: Standard. Aktiviert Popup-Fenster. {#Action_setNoPop_B__ul_qmz_fwj_nkb} |
[Tabelle : 9. Parameter]

{#Action_setNoPop_B__table_mms_gfj_nkb} {#Action_setNoPop_B__table_nms_gfj_nkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 10. Rückgaben]

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


    action.setNoPop(true);

## Aktion -- setRedirectURL (Objekt-URL) {#ariaid-title7}

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

* [Erstellen Sie eine UI-Weiterleitungsaktion](https://www.servicenow.com/docs/access?context=useful-client-side-scripts&version=yokohama&pubname=yokohama-application-development&section=t_CreateAUIRoutingAction&ft:locale=en-US)
* [Erstellen Sie Wissensartikel aus HR-Fällen](https://www.servicenow.com/docs/access?context=ui-action-hrcase-article&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)
* [Task relationships with UI actions](https://www.servicenow.com/docs/access?context=r_UIActions&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)
{#Action_setRedirectURL_O__ul_i1s_2qk_lmb}
{#Action_setRedirectURL_O__table_bdm_2fj_nkb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| URL | Objekt | URL, die als Umleitung festgelegt werden soll. Sie können die URL als Zeichenfolge oder angeben [GlideRecord](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#c_GlideRecordScopedAPI "Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet."). Wenn Sie die URL als GlideRecord übergeben, wird mit diesem Wert das Formular dieses Datensatzes fokussiert. |
[Tabelle : 11. Parameter]

{#Action_setRedirectURL_O__table_bdm_2fj_nkb} {#Action_setRedirectURL_O__table_cdm_2fj_nkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 12. Rückgaben]

{#Action_setRedirectURL_O__table_cdm_2fj_nkb}  
Das folgende Beispiel zeigt, wie ein Anwender von einer UI-Aktion mit zu einer URL umgeleitet wird [Aktuell](https://www.servicenow.com/docs/access?context=c_ScriptableServiceCatalogVariables&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)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) {#ariaid-title8}

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 der Übermittlung angezeigt hat.
{#Action_setReturnURL_O__table_bdm_2fj_nkb__entry__3}

| 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](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#c_GlideRecordScopedAPI "Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet."). |
[Tabelle : 13. Parameter]

{#Action_setReturnURL_O__table_bdm_2fj_nkb} {#Action_setReturnURL_O__table_cdm_2fj_nkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 14. Rückgaben]

{#Action_setReturnURL_O__table_cdm_2fj_nkb}  
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](https://www.servicenow.com/docs/access?context=c_ScriptableServiceCatalogVariables&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)Ansicht. Weitere Informationen finden Sie unter [Geskriptete Vorlagen](https://www.servicenow.com/docs/access?context=r_ScriptedTemplates&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Weitere Anwendungsfälle finden Sie unter [Task relationships with UI actions](https://www.servicenow.com/docs/access?context=r_UIActions&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

    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) {#ariaid-title9}

Legt einen URL-Parameternamen und -Wert fest.
{#Action_setURLParameter_S_S__table_elv_z2j_nkb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Parametername | Zeichenfolge | Name des URL-Parameters. |
| ParameterWert | Zeichenfolge | Wert des Parameters. |
[Tabelle : 15. Parameter]

{#Action_setURLParameter_S_S__table_elv_z2j_nkb} {#Action_setURLParameter_S_S__table_flv_z2j_nkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 16. Rückgaben]

{#Action_setURLParameter_S_S__table_flv_z2j_nkb}  

    action.setURLParameter('sysparm_query', 'priority=2^active=true');


