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


---

# GlideAjax -- Client

# GlideAjax -- Client {#ariaid-title1}

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

Die GlideAjax Mit der Klasse kann ein Client-Skript serverseitigen Code in einer Skripteinbindung aufrufen.

Zu verwenden GlideAjax Führen Sie in einem Client-Skript die folgenden allgemeinen Schritte aus.

1. Erstellen Sie ein GlideAjax Instanz durch Aufrufen von GlideAjax Konstruktor. Geben Sie als Argument für den Konstruktor den Namen der Skripteinbindungsklasse an, die die Methode enthält, die Sie aufrufen möchten.
2. Rufen Sie an AddParam Methode mit sysparm_nameParameter und der Name der Skript-Include-Methode, die Sie aufrufen möchten.
3. Optional. Rufen Sie an AddParam Methode einmal oder mehrmals, um den Skripteinbindungscode mit anderen erforderlichen Parametern bereitzustellen.
4. Führen Sie den serverseitigen Code durch Aufrufen aus GetXML() .  
   Hinweis:  
   GetXML() Ist die bevorzugte Methode für die Ausführung des Codes, da er asynchron ist und die Ausführung anderer Clientcodes nicht aufhält. Eine andere Methode, GetXMLWait() , Ist auch verfügbar, wird jedoch nicht empfohlen. Wird Verwendet GetXMLWait() Stellt die Reihenfolge der Ausführung sicher, kann jedoch dazu führen, dass die Anwendung nicht reagiert, was die Anwender-Experience aller Anwendungen, die sie verwenden, erheblich beeinträchtigt. GetXMLWait() Ist für bereichsbezogene Anwendungen nicht verfügbar.

    var ga = new GlideAjax('HelloWorld'); // HelloWorld is the script include class 
    ga.addParam('sysparm_name','helloWorld'); // helloWorld is the script include method 
    ga.addParam('sysparm_user_name',"Bob"); // Set parameter sysparm_user_name to 'Bob' 
    ga.getXML(HelloWorldParse);  /* Call HelloWorld.helloWorld() with the parameter sysparm_user_name set to 'Bob' 
          and use the callback function HelloWorldParse() to return the result when ready */

    // the callback function for returning the result from the server-side code
    function HelloWorldParse(response) {  
       var answer = response.responseXML.documentElement.getAttribute("answer"); 
        alert(answer);
    }

## GlideAjax -- GlideAjax(Zeichenfolge class_Name) {#ariaid-title2}

Konstruktor für GlideAjax .
{#r_GLAX-GlideAjax_S__table_gpw_cns_b5__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| class_name | Zeichenfolge | Der Name der serverseitigen Klasse, die die Methode enthält, die Sie ausführen möchten. |
[Tabelle : 1. Parameter]

{#r_GLAX-GlideAjax_S__table_gpw_cns_b5}  
In diesem Beispiel legt ein Client-Skript den Anwender auf Fred Luddy fest und ruft dann eine Skripteinbindung auf, um seinen Manager zu erhalten.

    // client script -- contains onLoad function and a callback function

    function onLoad() {
       var ga = new GlideAjax('GetUserInfo'); // GetUserInfo is the script include name 
       ga.addParam('sysparm_name','managerName'); // managerName is the function in the script include that we're calling 
       ga.addParam('sysparm_user_name','fred.luddy'); // set user to Fred Luddy 

       /* Call GetUserInfo.managerName() with user set to Fred Luddy and use the callback function ManagerParse() to return the result when ready */
       ga.getXMLAnswer(ManagerParse);  		
    }

    // callback function for returning the result from the script include
    function ManagerParse(response) {  
       alert(response);
    }


    // GetUserInfo script include 

    var GetUserInfo = Class.create();
    GetUserInfo.prototype = Object.extendsObject(global.AbstractAjaxProcessor, {

        managerName: function() {
            var userName = this.getParameter("sysparm_user_name");
            var grUser = new GlideRecord('sys_user');
            grUser.get("user_name", userName);

            // Build the payload. You can return additional data if needed. 
            var result = {    
               "manager": grUser.getDisplayValue('manager')
            }; 
            return JSON.stringify(result);
        },
        type: 'GetUserInfo'
    });

## GlideAjax -- addParam(Zeichenfolge parm_Name, Zeichenfolge parm_value) {#ariaid-title3}

Gibt einen Parameternamen und einen Wert an, die an die serverseitige Funktion übergeben werden sollen, die diesem zugeordnet ist GlideAjax Objekt.
Sie können ausführen AddParam Mehrmals mit verschiedenen Parametern und Werten.  
Hinweis:  
Der erste Anruf an AddParam Muss mit dem Parameter sein sysparm_name Und der Name der serverseitigen Methode, die Sie aufrufen möchten. Der serverseitige Code wird erst ausgeführt, wenn das Client-Skript aufruft GetXML() Oder GetXMLAnswer() .
{#r_GLAX-addParam_S_S__table_epw_cns_b5__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Parameter_Name | Zeichenfolge | Der Name des zu übergebenden Parameters. (Der Name muss mit beginnen `Sysparm_ `.) |
| Parameter_Wert | Zeichenfolge | Der Wert, dem zugewiesen werden soll parm_name. |
[Tabelle : 2. Parameter]

{#r_GLAX-addParam_S_S__table_epw_cns_b5} {#r_GLAX-addParam_S_S__table_fpw_cns_b5__entry__2}

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

{#r_GLAX-addParam_S_S__table_fpw_cns_b5}  
In diesem Beispiel legt ein Client-Skript den Anwender auf Fred Luddy fest und ruft dann eine Skripteinbindung auf, um seinen Manager zu erhalten.

    // client script -- contains onLoad function and a callback function

    function onLoad() {
       var ga = new GlideAjax('GetUserInfo'); // GetUserInfo is the script include name 
       ga.addParam('sysparm_name','managerName'); // managerName is the function in the script include that we're calling 
       ga.addParam('sysparm_user_name','fred.luddy'); // set user to Fred Luddy 

       /* Call GetUserInfo.managerName() with user set to Fred Luddy and use the callback function ManagerParse() to return the result when ready */
       ga.getXMLAnswer(ManagerParse);  		
    }

    // callback function for returning the result from the script include
    function ManagerParse(response) {  
       alert(response);
    }


    // GetUserInfo script include 

    var GetUserInfo = Class.create();
    GetUserInfo.prototype = Object.extendsObject(global.AbstractAjaxProcessor, {

        managerName: function() {
            var userName = this.getParameter("sysparm_user_name");
            var grUser = new GlideRecord('sys_user');
            grUser.get("user_name", userName);

            // Build the payload. You can return additional data if needed. 
            var result = {    
               "manager": grUser.getDisplayValue('manager')
            }; 
            return JSON.stringify(result);
        },
        type: 'GetUserInfo'
    });

## GlideAjax -- getAnswer() {#ariaid-title4}

Ruft die Ergebnisse von einer serverseitigen Methode ab, die vom Client über aufgerufen wird GetXMLWait() .
{#r_GLAX-getAnswer__table_mpw_cns_b5__entry__3}

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

{#r_GLAX-getAnswer__table_mpw_cns_b5} {#r_GLAX-getAnswer__table_npw_cns_b5__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig | Das Ergebnis, das von der serverseitigen Methode zurückgegeben wurde, die zuvor mit aufgerufen wurde GetXMLWait() . |
[Tabelle : 5. Rückgaben]

{#r_GLAX-getAnswer__table_npw_cns_b5}

## GlideAjax -- getXMLAnswer(Funktionsrückruf, Object additionalParam, Object responseParam) {#ariaid-title5}

Ruft den Prozessor asynchron auf und ruft das Antwortelement der Antwort im XML-Format ab.
{#r_GLAX-getXMLAnswer_F__table_hc2_nsz_dw__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Rückruf | Funktion | Rückruffunktion. Die Funktion empfängt das Antwortelement der Antwort im XML-Format als Argument. |
| AdditionalParameter | Objekt | Optional. Name-Wert-Paar zusätzlicher Parameter. |
| ResponseParam | Objekt | Optional. Zweites Argument für die Rückruffunktion. |
[Tabelle : 6. Parameter]

{#r_GLAX-getXMLAnswer_F__table_hc2_nsz_dw} {#r_GLAX-getXMLAnswer_F__table_ic2_nsz_dw__entry__2}

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

{#r_GLAX-getXMLAnswer_F__table_ic2_nsz_dw}  
Gibt die Anzahl der Anhänge zurück

    function updateAttachmentCount(sysid) {
      var ga = new GlideAjax('AttachmentAjax');
      ga.addParam('sysparm_type', 'attachmentCount');
      ga.addParam('sysparm_value', sysid);
      ga.getXMLAnswer(numberOfAttachments, null, sysid); // callback: numberOfAttachments with args (answer, sysid)
    }

    function numberOfAttachments(answer, sysid) {
      // we want to know there are 5 attachments, not 5.0 attachments
      var number = parseInt(answer);
      var buttons = $$('.attachmentNumber_' + sysid);
      if (buttons[0] == undefined)
        $('header_attachment_list_label').down().innerHTML = number;
      else {
        for (var i = 0; i < buttons.length; i++) {
          buttons[i].innerHTML = number;
        }
      }
    }

## GlideAjax -- getXML (Funktionsrückruf ) {#ariaid-title6}

Sendet dem Server eine Anforderung zur Ausführung der Methode und der Parameter, die diesem zugeordnet sind GlideAjax Objekt.
Der Server verarbeitet die Anforderung asynchron und gibt -- wenn bereit -- die Ergebnisse über die als angegebene Funktion zurück callback_function.
{#r_GLAX-getXML_S__table_ipw_cns_b5__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Rückruf | Funktion | Der Name der Rückruffunktion zur Verarbeitung der vom Server zurückgegebenen Ergebnisse. |
[Tabelle : 8. Parameter]

{#r_GLAX-getXML_S__table_ipw_cns_b5} {#r_GLAX-getXML_S__table_jpw_cns_b5__entry__2}

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

{#r_GLAX-getXML_S__table_jpw_cns_b5}  

    var comments = gel("dialog_comments").value;
    var ga = new GlideAjax('validateComments'); //Call script include to escape text
    ga.addParam('sysparm_name', 'validateComments');
    ga.addParam('sysparm_comments', comments);
    ga.getXML(callback);
     
    return false;
     
    function callback(response) {
      var comments = response.responseXML.documentElement.getAttribute("answer");
      comments = trim(comments);
      if (comments == "") {
         //If comments are empty, alert the user and stop submission
         alert("Please enter your comments before submitting.");
      } else {
        //If there are comments, close the dialog window and submit them
        GlideDialogWindow.get().destroy(); //Close the dialog window
        g_form.setValue("comments", comments); //Set the "Comments" field with comments in the dialog
      }

## GlideAjax -- getXMLWait() {#ariaid-title7}

Sendet dem Server eine Anforderung zur Ausführung der Methode und der Parameter, die diesem zugeordnet sind GlideAjax Objekt.
Der Server verarbeitet die Anforderung synchron und verarbeitet keine weiteren Anforderungen vom Client, bis er abgeschlossen ist. Zum Abrufen der Ergebnisse muss der Client anrufen GetAnswer() . Wird Verwendet GetXMLWait() Stellt die Reihenfolge der Ausführung sicher, kann jedoch dazu führen, dass die Anwendung nicht reagiert, was die Anwender-Experience aller Anwendungen, die sie verwenden, erheblich beeinträchtigt. Wir empfehlen die Verwendung GetXML() Stattdessen.  
Hinweis:  
GetXMLWait() Ist für bereichsbezogene Anwendungen nicht verfügbar.
{#r_GLAX-getXMLWait__table_kpw_cns_b5__entry__3}

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

{#r_GLAX-getXMLWait__table_kpw_cns_b5} {#r_GLAX-getXMLWait__table_lpw_cns_b5__entry__2}

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

{#r_GLAX-getXMLWait__table_lpw_cns_b5}  

    var ga = new GlideAjax('HelloWorld');
          ga.addParam('sysparm_name','helloWorld');
          ga.addParam('sysparm_user_name',"Bob");
          ga.getXMLWait();
          alert(ga.getAnswer());


