--- sourceDocument: Xanadu-API-Referenz sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-API-Referenz ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Aktion: Bereichsbezogen, global # Aktion: Bereichsbezogen, global {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://www.servicenow.com/docs/access?context=t_EditingAUIAction&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Methoden für diese API werden in serverseitigem JavaScript mit dem Variablennamen „action" bezeichnet. Weitere Informationen finden Sie [unter Interaktionen mit UI-Aktionen erstellen](https://developer.servicenow.com/blog.do?p=/post/training-ui-action-101/). ## Aktion - getGlideURI() {#ariaid-title2} Ruft ein GlideURI-Objekt ab, um die Benutzeransicht 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: Bereichsbezogen](https://www.servicenow.com/docs/zfg4uC34TLehkgUNkRPk1Q#c_GlideURIScopedAPI "Die GlideURI- API bietet Methoden zur Verarbeitung von URI-Parametern in einer bereichsbezogenen Anwendung.") * [GlideURI: Global](https://www.servicenow.com/docs/tBBrEgicFQsOqfmylSr7qQ#GlideURIGlobalAPI "Die GlideURI- API bietet Methoden zur Verarbeitung von URI-Parametern in einer globalen Anwendung.") {#Action_getGlideURI__ul_f4h_5lj_5mb} Hinweis: Jeder andere zurückgegebene Wert wird als Fehler betrachtet, einschließlich NULL. | [Tabelle : 2. Ergebnisse] {#Action_getGlideURI__table_exr_lfj_nkb} 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() {#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. Ergebnisse] {#Action_getReturnURL__table_eb4_ffj_nkb} action.getReturnURL(); ## Aktion -- getURLParameter(ZeichenfolgeparameterName) {#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. Ergebnisse] {#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 Benutzeransicht. {#Action_openGlideRecord_O__table_sy5_bfj_nkb__entry__3} | Name | Typ | Beschreibung | |-|-|-| | gr | [GlideRecord](https://www.servicenow.com/docs/g1N~QBZ9WXF6q3o57iuLTw#c_GlideRecordScopedAPI "Die bereichsbezogene GlideRecord- API wird für Datenbankvorgänge verwendet.") | GlideRecord der Seite, die in der Benutzeransicht 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 | |-|-| | void | | [Tabelle : 8. Ergebnisse] {#Action_openGlideRecord_O__table_ty5_bfj_nkb} 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) {#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. * false: 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. Ergebnisse] {#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: * [UI-Weiterleitungsaktion erstellen](https://www.servicenow.com/docs/access?context=useful-client-side-scripts&version=xanadu&pubname=xanadu-application-development§ion=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=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) * [Task relationships with UI actions](https://www.servicenow.com/docs/access?context=r_UIActions&version=xanadu&pubname=xanadu-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 [GlideRecord angeben](https://www.servicenow.com/docs/g1N~QBZ9WXF6q3o57iuLTw#c_GlideRecordScopedAPI "Die bereichsbezogene GlideRecord- API wird für Datenbankvorgänge verwendet."). Wenn Sie die URL als GlideRecord übergeben, legt dieser Wert den Fokus auf das Formular dieses Datensatzes. | [Tabelle : 11. Parameter] {#Action_setRedirectURL_O__table_bdm_2fj_nkb} {#Action_setRedirectURL_O__table_cdm_2fj_nkb__entry__2} | Typ | Beschreibung | |-|-| | void | | [Tabelle : 12. Ergebnisse] {#Action_setRedirectURL_O__table_cdm_2fj_nkb} Das folgende Beispiel zeigt, wie ein Anwender mithilfe der [current-](https://www.servicenow.com/docs/access?context=c_ScriptableServiceCatalogVariables&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) 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) {#ariaid-title8} 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. {#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 wurde. Sie können die URL als Zeichenfolge oder [GlideRecord angeben](https://www.servicenow.com/docs/g1N~QBZ9WXF6q3o57iuLTw#c_GlideRecordScopedAPI "Die bereichsbezogene 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 | |-|-| | void | | [Tabelle : 14. Ergebnisse] {#Action_setReturnURL_O__table_cdm_2fj_nkb} 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](https://www.servicenow.com/docs/access?context=c_ScriptableServiceCatalogVariables&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) Ansicht zurück. Weitere Informationen finden Sie unter [Skriptbasierte Vorlagen](https://www.servicenow.com/docs/access?context=r_ScriptedTemplates&version=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-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(ZeichenfolgeparameterName, Zeichenfolgenparameterwert) {#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 | |-|-| | void | | [Tabelle : 16. Ergebnisse] {#Action_setURLParameter_S_S__table_flv_z2j_nkb} action.setURLParameter('sysparm_query', 'priority=2^active=true');