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


---

# SpUtil -- Client

# SpUtil -- Client {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 Minuten Lesedauer

Die SpUtil Die API stellt Dienstprogrammmethoden zur Ausführung allgemeiner Funktionen in bereit ServiceportalWidget-Client-Skript.  
Diese Funktionen umfassen:

* Zeigt eine Benachrichtigungsfehlermeldung an. [SpUtil -- addErrorMessage(Zeichenfolgennachricht)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-addErrorMessage_S "Zeigt eine Benachrichtigungsfehlermeldung an.")
* Zeigt eine Benachrichtigungsinformationsnachricht an. [SpUtil -- addInfoMessage(Zeichenfolgennachricht)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-addInfoMessage_S "Zeigt eine Benachrichtigungsinformationsnachricht an.")
* Zeigt eine geringfügige Benachrichtigungsnachricht an. [SpUtil -- addTrivialMessage(Zeichenfolgennachricht)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-addTrivialMessage_S "Zeigt eine geringfügige Benachrichtigungsnachricht an.")
* Erstellen Sie einen eindeutigen Bezeichner. [SpUtil -- createUid()](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-createUid "Erstellen Sie ein Eindeutiger Bezeichner .")
* Formatieren Sie eine Zeichenfolge mit Variablen. [SpUtil -- Format (Zeichenfolgenvorlage, Objektdaten)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-format_S_O "Formatiert eine Zeichenfolge, die Variablen enthält.")
* Bettet ein Widget-Modell in ein Widget-Client-Skript ein. [SpUtil -- GET(Zeichenfolgen-Widget-ID-Objektdaten)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-get_S "Bettet ein Widget-Modell in ein Widget-Client-Skript ein.")
* Ruft alle Header ab, die für API-Aufrufe verwendet werden sollen. [SpUtil -- getHeaders()](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-getHeaders "Ruft alle Header ab, die für API-Aufrufe verwendet werden sollen.")
* Vollständige Hostdomäne zurückgeben. [SpUtil -- getHost()](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-getHost "Gibt die vollständige Hostdomäne zurück.")
* Führen Sie den Rückruf mit Anwendervoreinstellungsantwort aus, indem Sie den Einstellungsnamen übergeben. [SpUtil -- getPreference(Zeichenfolgeneinstellung, Funktionsrückruf)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-getPreference "Führt den Rückruf mit Anwendervoreinstellungsantwort durch Übergabe des Einstellungsnamens aus.")
* Gibt die aktuellen Serviceportal-URL-Informationen zurück. [SpUtil -- getUrl()](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-getURL "Gibt die aktuellen Serviceportal-URL-Informationen zurück.")
* Überprüfen Sie, ob der aktuelle Client ein Mobilgerät ist. [SpUtil -- isMobile()](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-isMobile "Überprüft, ob der aktuelle Client ein Mobilgerät ist.")
* Analysieren Sie die kommagetrennten Attribute innerhalb einer angegebenen Zeichenfolge. [SpUtil -- parseAttributes(Zeichenfolgenattribute)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-parseAttributes "Analysiert die kommagetrennten Attribute innerhalb einer angegebenen Zeichenfolge.")
* Achten Sie auf Aktualisierungen an einer Tabelle oder einem Filter, und gibt den Wert aus der Rückruffunktion zurück. [SpUtil -- recordWatch(Objekt $scope, Zeichenfolgentabelle, Zeichenfolgenfilter, Funktionsrückruf)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-recordWatch_O_S_S_F "Überwacht auf Aktualisierungen an einer Tabelle oder einem Filter und gibt den Wert aus der Rückruffunktion zurück.")
* Rufen Sie den Server auf und ersetzt den aktuellen Optionen Und Daten Mit der Serverantwort. [SpUtil -- REFRESH(Object $scope)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-refresh_O "Ruft den Server auf und ersetzt den aktuellen Optionen Und Daten Mit der Serverantwort.")
* Scrollen Sie über einen bestimmten Zeitraum mit der angegebenen Auswahl zum Element. [SpUtil -- scrollTo (Zeichenfolgenauswahl, Zahlenzeit)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-scrollTo "Scrollt über einen angegebenen Zeitraum zum Element mit der angegebenen Auswahl.")
* Aktualisieren Sie die Header-Breadcrumbs. [SpUtil -- setBreadCrumb(Objekt $scope, Array-Breadcrumbs)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-setBreadCrumb "Aktualisiert die Header-Breadcrumbs.")
* Legen Sie eine Anwendereinstellung fest. [SpUtil -- setPreference(Zeichenfolgenpräf, Zeichenfolgenwert)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-setPreference "Legt eine Anwendereinstellung fest.")
* Aktualisieren Sie die Suchseite. [SpUtil -- setSearchPage(Zeichenfolge searchPage)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-setSearchPage "Aktualisiert die Suchseite.")
* Aktualisieren Sie das Datenobjekt auf dem Server innerhalb eines bestimmten Bereichs. [SpUtil -- Update(Object $scope)](https://servicenow-prod.fluidtopics.net/qoeVgV8wy_0VPCBYfBMGkg#SPU-update_O "Aktualisiert das Datenobjekt auf dem Server innerhalb eines bestimmten Bereichs.")

Weitere Informationen zu Widgets finden Sie unter [Serviceportal-Widgets](https://www.servicenow.com/docs/access?context=service-portal-widgets&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US).

## SpUtil -- addErrorMessage(Zeichenfolgennachricht) {#ariaid-title2}

Zeigt eine Benachrichtigungsfehlermeldung an.
{#SPU-addErrorMessage_S__table_yjp_zpz_31b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Anzuzeigende Fehlermeldung. |
[Tabelle : 1. Parameter]

{#SPU-addErrorMessage_S__table_yjp_zpz_31b} {#SPU-addErrorMessage_S__table_zjp_zpz_31b__entry__2}

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

{#SPU-addErrorMessage_S__table_zjp_zpz_31b}  

    spUtil.addErrorMessage("There has been an error processing your request")

## SpUtil -- addInfoMessage(Zeichenfolgennachricht) {#ariaid-title3}

Zeigt eine Benachrichtigungsinformationsnachricht an.
{#SPU-addInfoMessage_S__table_b2m_bqz_31b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Anzuzeigende Nachricht. |
[Tabelle : 3. Parameter]

{#SPU-addInfoMessage_S__table_b2m_bqz_31b} {#SPU-addInfoMessage_S__table_c2m_bqz_31b__entry__2}

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

{#SPU-addInfoMessage_S__table_c2m_bqz_31b}  

    spUtil.addInfoMessage("Your order has been placed")

## SpUtil -- addTrivialMessage(Zeichenfolgennachricht) {#ariaid-title4}

Zeigt eine geringfügige Benachrichtigungsnachricht an.
Geringfügige Nachrichten werden nach kurzer Zeit ausgeblendet.
{#SPU-addTrivialMessage_S__table_kcx_dqz_31b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Anzuzeigende Nachricht. |
[Tabelle : 5. Parameter]

{#SPU-addTrivialMessage_S__table_kcx_dqz_31b} {#SPU-addTrivialMessage_S__table_lcx_dqz_31b__entry__2}

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

{#SPU-addTrivialMessage_S__table_lcx_dqz_31b}  

    spUtil.addTrivialMessage("Thanks for your order")

## SpUtil -- createUid() {#ariaid-title5}

Erstellen Sie ein Eindeutiger Bezeichner .
{#SPU-createUid__table_ccv_cbr_t2b__entry__3}

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

{#SPU-createUid__table_ccv_cbr_t2b} {#SPU-createUid__table_dcv_cbr_t2b__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eine eindeutige 32-Zeichen-ID. |
[Tabelle : 8. Rückgaben]

{#SPU-createUid__table_dcv_cbr_t2b}

## SpUtil -- GET(Zeichenfolgen-Widget-ID-Objektdaten) {#ariaid-title6}

Bettet ein Widget-Modell in ein Widget-Client-Skript ein.
Die Rückruffunktion gibt das vollständige Widget-Modell zurück. Weitere Informationen zu Widgets finden Sie unter [Serviceportal-Widgets](https://www.servicenow.com/docs/access?context=service-portal-widgets&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US).
{#SPU-get_S__table_bcy_fqz_31b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| widgetId | Zeichenfolge | Widget-ID oder sys_ID des einzubettenden Widgets. |
| Daten | Objekt | Optional. Name/Wert-Paare von Parametern, die an das Widget-Modell übergeben werden sollen. |
[Tabelle : 9. Parameter]

{#SPU-get_S__table_bcy_fqz_31b} {#SPU-get_S__table_ccy_fqz_31b__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Modell des eingebetteten Widgets. |
[Tabelle : 10. Rückgaben]

{#SPU-get_S__table_ccy_fqz_31b}  
Ohne Daten übergeben.

    spUtil.get("widget-cool-clock").then(function(response) {
      c.coolClock = response;
    });

Mit Daten übergeben.

    spUtil.get('pps-list-modal', {title: c.data.editAllocations, 
      table: 'resource_allocation', 
      queryString: 'GROUPBYuser^resource_plan=' + c.data.sysId, 
      view: 'resource_portal_allocations' }).then(function(response) {
        var formModal = response;
        c.allocationListModal = response;
      });  	

## SpUtil -- getHeaders() {#ariaid-title7}

Ruft alle Header ab, die für API-Aufrufe verwendet werden sollen.
{#SPU-getHeaders__table_dns_ldr_t2b__entry__3}

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

{#SPU-getHeaders__table_dns_ldr_t2b} {#SPU-getHeaders__table_ens_ldr_t2b__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Alle Header, die für API-Aufrufe verwendet werden sollen. |
[Tabelle : 12. Rückgaben]

{#SPU-getHeaders__table_ens_ldr_t2b}

## SpUtil -- getHost() {#ariaid-title8}

Gibt die vollständige Hostdomäne zurück.
{#SPU-getHost__table_olb_vkr_t2b__entry__3}

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

{#SPU-getHost__table_olb_vkr_t2b} {#SPU-getHost__table_plb_vkr_t2b__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Beispielsweise die vollständige Hostdomäne `hi.servicenow.com ` |
[Tabelle : 14. Rückgaben]

{#SPU-getHost__table_plb_vkr_t2b}

## SpUtil -- getPreference(Zeichenfolgeneinstellung, Funktionsrückruf) {#ariaid-title9}

Führt den Rückruf mit Anwendervoreinstellungsantwort durch Übergabe des Einstellungsnamens aus.
{#SPU-getPreference__table_rvb_34r_t2b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Einstellung | Zeichenfolge | Name der Einstellung. |
| Rückruf | Funktion | Definieren Sie die Rückruffunktion. |
[Tabelle : 15. Parameter]

{#SPU-getPreference__table_rvb_34r_t2b} {#SPU-getPreference__table_svb_34r_t2b__entry__2}

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

{#SPU-getPreference__table_svb_34r_t2b}

## SpUtil -- getUrl() {#ariaid-title10}

Gibt die aktuellen Serviceportal-URL-Informationen zurück.
{#SPU-getURL__table_sbh_dls_t2b__entry__3}

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

{#SPU-getURL__table_sbh_dls_t2b} {#SPU-getURL__table_tbh_dls_t2b__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Aktuelle Serviceportal-URL. |
[Tabelle : 18. Rückgaben]

{#SPU-getURL__table_tbh_dls_t2b}

## SpUtil -- Format (Zeichenfolgenvorlage, Objektdaten) {#ariaid-title11}

Formatiert eine Zeichenfolge, die Variablen enthält.
Verwenden Sie diese Methode als Alternative zur Zeichenfolgenverkettung.
{#SPU-format_S_O__table_yrh_hqz_31b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Vorlage | Zeichenfolge | Zeichenfolgenvorlage, die Werte für die Variablenersetzung enthält. |
| Daten | Objekt | Objekt, das die Werte für die in der Vorlagenzeichenfolge definierten Variablen enthält. |
[Tabelle : 19. Parameter]

{#SPU-format_S_O__table_yrh_hqz_31b} {#SPU-format_S_O__table_zrh_hqz_31b__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Zeichenfolge, die die Variablenwerte anstelle der Variablennomenklatur enthält. |
[Tabelle : 20. Rückgaben]

{#SPU-format_S_O__table_zrh_hqz_31b}  

    spUtil.format('An error ocurred: {error} when loading {widget}', {error: '404', widget: 'sp-widget'})

Ausgabe:

    'An error occurred: 404 when loading sp-widget'

## SpUtil -- isMobile() {#ariaid-title12}

Überprüft, ob der aktuelle Client ein Mobilgerät ist.
{#SPU-isMobile__table_gz2_pcd_v2b__entry__3}

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

{#SPU-isMobile__table_gz2_pcd_v2b} {#SPU-isMobile__table_hz2_pcd_v2b__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der aktuelle Client ein Mobilgerät ist. Gültige Werte: * Wahr: Der aktuelle Client ist ein Mobilgerät. * Falsch: Der aktuelle Client ist kein Mobilgerät. {#SPU-isMobile__ul_fpx_gsv_fvb} |
[Tabelle : 22. Rückgaben]

{#SPU-isMobile__table_hz2_pcd_v2b}

## SpUtil -- parseAttributes(Zeichenfolgenattribute) {#ariaid-title13}

Analysiert die kommagetrennten Attribute innerhalb einer angegebenen Zeichenfolge.
{#SPU-parseAttributes__table_jkb_tvm_w2b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| attributes | Zeichenfolge | Zeichenfolge mit kommagetrennten Attributen, z. B. Attribute Feld eines Wörterbuchdatensatzes. |
[Tabelle : 23. Parameter]

{#SPU-parseAttributes__table_jkb_tvm_w2b} {#SPU-parseAttributes__table_kkb_tvm_w2b__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Array von Objekten mit den analysierten Attributen. |
[Tabelle : 24. Rückgaben]

{#SPU-parseAttributes__table_kkb_tvm_w2b}  

    function getRefQualElements() {
      var refQualElements = [];
      if (field && field.attributes && field.attributes.indexOf('ref_qual_elements') > -1) {
        var attributes = spUtil.parseAttributes(field.attributes);
        refQualElements = attributes['ref_qual_elements'].split(';');
      }
      return refQualElements;
    }

## SpUtil -- recordWatch(Objekt $scope, Zeichenfolgentabelle, Zeichenfolgenfilter, Funktionsrückruf) {#ariaid-title14}

Überwacht auf Aktualisierungen an einer Tabelle oder einem Filter und gibt den Wert aus der Rückruffunktion zurück.
Ermöglicht einem Widget-Entwickler, in Echtzeit auf Tabellenaktualisierungen zu reagieren. Beispiel: Durch Record Watch() , Das Widget „einfache Liste" kann auf Änderungen an seiner Datentabelle achten. Wenn Datensätze hinzugefügt, entfernt oder aktualisiert werden, wird das Widget automatisch aktualisiert.  
Hinweis:  
Beim Übergeben von `$Umfang `Argument in Record Watch() Funktion, einfügen `$Umfang `In die Parameter Ihrer Client-Skriptfunktion.
{#SPU-recordWatch_O_S_S_F__table_vys_mqz_31b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| $scope | Objekt | Umfang des Datenobjekts, das von der Rückruffunktion aktualisiert wurde. |
| table | Zeichenfolge | Beobachtete Tabelle. |
| Filter | Zeichenfolge | Nach zu überwachenden Feldern filtern. |
| Rückruf | Funktion | Optional. Parameter zum Definieren der Rückruffunktion. |
[Tabelle : 25. Parameter]

{#SPU-recordWatch_O_S_S_F__table_vys_mqz_31b} {#SPU-recordWatch_O_S_S_F__table_wys_mqz_31b__entry__2}

| Typ | Beschreibung |
|-|-|
| Versprechen | Rückgabewert der Rückruffunktion. |
[Tabelle : 26. Rückgaben]

{#SPU-recordWatch_O_S_S_F__table_wys_mqz_31b}  

    //A simple recordWatch function.
    spUtil.recordWatch($scope, "live_profile", "sys_id=" + liveProfileId);

    //In a widget client script
    function(spUtil, $scope) {
      /* widget controller */
      var c =this;

      // Registers a listener on the incident table with the filter active=true, 
      // meaning that whenever something changes on that table with that filter, 
      // the callback function is executed.    
      // The callback function takes a single parameter 'response', which contains 
      // the property 'data'. The 'data' property contains information about the changed record. 
      spUtil.recordWatch($scope, "incident", "active=true", function(response) {
            
        // Returns the data inserted or updated on the table 
        console.log(response.data);   
        
        });
    }

## SpUtil -- REFRESH(Object $scope) {#ariaid-title15}

Ruft den Server auf und ersetzt den aktuellen Optionen Und Daten Mit der Serverantwort.
Wird Aufgerufen `SpUtil.refresh() `Ähnelt dem Anruf `Server.REFRESH() `. Wenn Sie jedoch anrufen `SpUtil.refresh() `, Sie können das Objekt $scope definieren.
{#SPU-refresh_O__table_p2k_kqz_31b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| $scope | Objekt | Für das Update definierter Bereich. |
[Tabelle : 27. Parameter]

{#SPU-refresh_O__table_p2k_kqz_31b} {#SPU-refresh_O__table_q2k_kqz_31b__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Optionen und Datenobjekte aktualisiert. |
[Tabelle : 28. Rückgaben]

{#SPU-refresh_O__table_q2k_kqz_31b}

## SpUtil -- scrollTo (Zeichenfolgenauswahl, Zahlenzeit) {#ariaid-title16}

Scrollt über einen angegebenen Zeitraum zum Element mit der angegebenen Auswahl.
{#SPU-scrollTo__table_drd_wzp_v2b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Auswahl | Zeichenfolge | Auswahl, zu der gescrollt werden soll. |
| Zeitreihendiagramm | Nummer | Zeit, die benötigt wurde, um zur angegebenen Auswahl zu scrollen. Einheit: Millisekunden |
[Tabelle : 29. Parameter]

{#SPU-scrollTo__table_drd_wzp_v2b} {#SPU-scrollTo__table_erd_wzp_v2b__entry__2}

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

{#SPU-scrollTo__table_erd_wzp_v2b}

## SpUtil -- setBreadCrumb(Objekt $scope, Array-Breadcrumbs) {#ariaid-title17}

Aktualisiert die Header-Breadcrumbs.
{#SPU-setBreadCrumb__table_sqx_jkr_v2b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| $scope | Objekt | Für die Tabelle definierter Bereich. |
| Breadcrumbs | Array | Bedingungen, die zum Erstellen des Breadcrumb-Filters verwendet werden. |
[Tabelle : 31. Parameter]

{#SPU-setBreadCrumb__table_sqx_jkr_v2b} {#SPU-setBreadCrumb__table_tqx_jkr_v2b__entry__2}

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

{#SPU-setBreadCrumb__table_tqx_jkr_v2b}

## SpUtil -- setPreference(Zeichenfolgenpräf, Zeichenfolgenwert) {#ariaid-title18}

Legt eine Anwendereinstellung fest.
{#SPU-setPreference__table_m1m_1hl_w2b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| präf | Zeichenfolge | Einstellungsname |
| Wert | Zeichenfolge | Einstellungswert |
[Tabelle : 33. Parameter]

{#SPU-setPreference__table_m1m_1hl_w2b} {#SPU-setPreference__table_n1m_1hl_w2b__entry__2}

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

{#SPU-setPreference__table_n1m_1hl_w2b}

## SpUtil -- setSearchPage(Zeichenfolge searchPage) {#ariaid-title19}

Aktualisiert die Suchseite.
{#SPU-setSearchPage__table_hm4_v4l_w2b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SearchPage | Zeichenfolge | Name der Suchseite. |
[Tabelle : 35. Parameter]

{#SPU-setSearchPage__table_hm4_v4l_w2b} {#SPU-setSearchPage__table_im4_v4l_w2b__entry__2}

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

{#SPU-setSearchPage__table_im4_v4l_w2b}

## SpUtil -- Update(Object $scope) {#ariaid-title20}

Aktualisiert das Datenobjekt auf dem Server innerhalb eines bestimmten Bereichs.
Diese Methode ist ähnlich wie `Server.Update() `, Enthält aber einen $scope-Parameter, der den zu übergebenden Bereich definiert.
{#SPU-update_O__table_hpd_4qz_31b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| $scope | Objekt | Für das Update definierter Bereich. |
[Tabelle : 37. Parameter]

{#SPU-update_O__table_hpd_4qz_31b} {#SPU-update_O__table_ipd_4qz_31b__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Datenobjekt aktualisiert. |
[Tabelle : 38. Rückgaben]

{#SPU-update_O__table_ipd_4qz_31b}  
Das folgende Beispiel enthält ein P1-Widget, das nach Änderungen am Statusfeld überwacht und einen Filter verwendet, um alle aktiven P1s zu überwachen und die Rückruffunktion bestimmen zu lassen, ob die Daten aktualisiert werden sollen. Die data.changesEigenschaft enthält ein Array aller aktualisierten Felder. Wenn sich der Status eines Felds geändert hat, werden die Daten im Widget aktualisiert.

    var q = "priority=1^active=true^EQ";
    spUtil.recordWatch($scope, "incident", q, function(event, data) {
       if (data.changes.includes("state")) { // only update if state was updated.
          spUtil.update($scope);
       }
    });


