GlideSPSkriptfähig – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 15 Minuten Lesedauer
  • Die GlideSPSkriptfähig Die API bietet Methoden zum Interagieren mit Daten und zum Ausführen von Datensatzvorgängen in Serviceportal Widgets.

    Sie greifen auf zu GlideSPSkriptfähig Methoden mithilfe der globalen $sp Objekt.

    GlideSPScriptable – canReadRecord(GlideRecord Now_GR)

    Gibt „true“ zurück, wenn der Benutzer den angegebenen GlideRecord lesen kann.

    Wenn der Datensatztyp kb_knowledge, sc_cat_item oder sc_category ist, prüft die Methode, ob der Benutzer das Element anzeigen kann.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Now_GR GlideRecord Zu prüfender GlideRecord.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der Datensatz gültig und lesbar ist.

    Serverskript

    //Server script
    data.items = [];
    data.userName = gs.getUserDisplayName();
    var now_GR = new GlideRecord("sc_cat_item");
    now_GR.query();
    while(now_GR.next() && data.items.length < 10) {
        if ($sp.canReadRecord(now_GR)) {
        data.items.push(now_GR.getDisplayValue("name"));
        }
    }
    
    //HTML template
    <div class="panel panel-default">
        <div class="panel-heading">Hi, {{c.data.userName}}!</div>
        <div class="panel-body">
            Here are some things you can order:
            <ul><li ng-repeat="item in c.data.items">{{item}}</li></ul>
        </div>
    </div>

    GlideSPScriptable – canReadRecord(Zeichenfolgentabelle, SYS-ID der Zeichenfolge)

    Gibt „true“ zurück, wenn der Benutzer den angegebenen GlideRecord lesen kann.

    Wenn der Datensatztyp kb_knowledge, sc_cat_item oder sc_category ist, prüft die Methode, ob der Benutzer das Element anzeigen kann.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    table Zeichenfolge Name der abzurufenden Tabelle
    sysId Zeichenfolge sys_id des abzufragenden Datensatzes.
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der Datensatz gültig und lesbar ist.

    GlideSPScriptable – canSeePage(String PageID)

    Gibt „wahr“ zurück, wenn der derzeit angemeldete Anwender die Berechtigung zum Anzeigen der angegebenen Seite hat.

    Das System bestimmt die Berechtigung anhand von Rollen und Anwenderkriterien. Weitere Informationen finden Sie unter Konfigurieren Sie die Seitensicherheit nach Rolle Und Anwenderkriterien für Serviceportal .

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Seiten-ID Zeichenfolge Seiten-ID aus der Tabelle „Seiten“ [sp_page].
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der derzeit angemeldete Anwender über Berechtigungen zum Anzeigen der angegebenen Seite verfügt. Werte:
    • Wahr: Der Anwender kann die Seite anzeigen.
    • Falsch: Entweder kann der Anwender die Seite nicht anzeigen, die angegebene PageID ist ungültig, oder der Anwender ist nicht angemeldet.

    Dieses Beispiel fügt dem Menüelement Wissen im SP-Header-Menü eine Bedingung hinzu, um das Menüelement nur Anwendern anzuzeigen, die über die Berechtigung zum Anzeigen der Seite kb_view2 verfügen.

    GlideSPScriptable.canSeePage("kb_view2")

    GlideSPScriptable – getCatalogItem(String sysId)

    Gibt ein Modell und ein Ansichtsmodell für sc_cat_item oder sc_cat_item_guide zurück.

    Diese Methode ist veraltet. Verwenden Sie stattdessen die getCatalogItem(String sysId, Boolean isOrdering)-Methode. Diese Methode ruft auf GetCatalogItem(SYS-ID der Zeichenfolge, boolesches isOrdering) Methode mit isOrderingParameter auf „falsch“ festgelegt, was bedeutet, dass die Sicherheitsprüfung für Schreibrollen durchgeführt wird.

    Diese Methode ist eine schnelle Methode, um die für das Rendern und Bestellen eines Katalogelements mit <sp-model /> erforderlichen Daten abzurufen. Wenn Sie nur ein Katalogelement abrufen möchten, um das Bild oder den Namen anzuzeigen, verwenden Sie GlideRecord, um die sc_cat_item-Tabelle abzufragen.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    sysId Zeichenfolge sys_id des Katalogelements (sc_cat_item) oder Bestellleitfadens (sc_cat_item_guide).
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Objekt Ein Objekt, das das Katalogelementvariablenmodell, die Ansicht, die Abschnitte, die Preisgestaltung und die Client-Skripts enthält.
    // Server script
    (function() {
        var sys_id = $sp.getParameter("sys_id")
        data.catItem = $sp.getCatalogItem(sys_id);
    })();
    
    // Client script
    function($http, spUtil) {
        var c = this;
        var submitting = false;
        c.getIt = function() {
            if (submitting) return;
            $http.post(spUtil.getURL('sc_cat_item'), c.data.catItem).success(function(response) {
                if (response.answer) {
                    c.req = response.answer;
                    c.req.page = c.req.table == 'sc_request' ? 'sc_request' : 'ticket';
                }
            });
        }
    }
    
    //SCSS
    .img-bg {
        padding: 5px;
        background-color: $brand-primary;
    }
    
    .img-responsive {
        margin: 0 auto;
    }
    
    .cat-icon {
        display: block;
        margin: -40px auto 0;
    }
    
    // HTML template
    <div class="col-sm-4">
      <div class="panel panel-default">
        <div class="img-bg">
          <img ng-src="{{::data.catItem.picture}}" class="img-responsive" />
        </div>
        <span class="cat-icon fa fa-stack fa-lg fa-3x hidden-xs">
          <i class="fa fa-circle fa-stack-2x text-success"></i>
          <i class="fa fa-desktop fa-stack-1x fa-inverse"></i>
        </span>
        <div class="panel-body">
          <p class="lead text-center">{{::data.catItem.name}}</p>
          <ul class="list-unstyled">
            <li class="text-center" ng-if="::data.catItem.price">${Price}: {{::data.catItem.price}}</li>
          </ul>
          <sp-model form-model="::data.catItem" mandatory="mandatory"></sp-model>
          <p ng-if="c.req" class="text-center text-success">
            ${Request created!} <a href="?id={{c.req.page}}&table={{c.req.table}}&sys_id={{c.req.sys_id}}">{{c.req.number}}</a>
          </p>
          <button ng-if="!c.req" class="btn btn-default btn-block" ng-click="c.getIt()">${Get it}</button>
        </div>
      </div>
    </div>

    GlideSPScriptable – getCatalogItem (SYS-ID der Zeichenfolge, boolescher isOrdering)

    Gibt ein Modell und ein Ansichtsmodell für sc_cat_item oder sc_cat_item_guide zurück.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    sysId Zeichenfolge sys_id des Katalogelements (sc_cat_item) oder Bestellleitfadens (sc_cat_item_guide).
    isOrdering Boolean Bei „true“ wird die Sicherheitsprüfung für Erstellrollen verwendet. Bei „false“ wird die Sicherheitsprüfung für Schreibrollen verwendet.

    Wenn Benutzer einen Artikel bestellen oder im Einkaufswagen haben, prüfen Sie anhand der Erstellrollen.

    Wenn Benutzer beispielsweise nicht bestellen, sieht sich jemand einen angeforderter Artikel an, um die diesem Artikel zugeordneten Variablen anzuzeigen, prüfen Sie anhand der Schreibrollen.

    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Objekt Ein Objekt, das das Katalogelementvariablenmodell, die Ansicht, die Abschnitte, die Preisgestaltung und die Client-Skripts enthält.

    GlideSPScriptable – getDisplayValue(String fieldName)

    Gibt den Anzeigewert des angegebenen Felds (sofern vorhanden und mit Wert) von dersp_instance des Widgets oder vom sp_portal-Datensatz zurück.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Anzeigewert von der sp_instance oder vom sp_portal-Datensatz.
    //Server script
    (function() {
        data.title = $sp.getDisplayValue("title");
        data.catalog = $sp.getDisplayValue("sc_catalog");
    })();
    
    //HTML template
    <div>
        <h1>sp_instance.title: {{::data.title}}</h1>
        <h1>sp_portal.sc_catalog: {{::data.catalog}}</h1>
    </div>

    GlideSPScriptable – getField(GlideRecord Now_GR, String fieldName)

    Gibt Informationen zum angegebenen Feld im angegebenen GlideRecord zurück.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Now_GR GlideRecord Zu prüfender GlideRecord
    fieldName Zeichenfolge Feld, für das Informationen gesucht werden sollen
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Objekt Objekt, das die Feldbezeichnung, den Wert, den Anzeigewert und den Typ enthält. Gibt NULL zurück, wenn der GlideRecord des Feldnamens nicht gültig oder wenn das Feld nicht lesbar ist.

    GlideSPScriptable – getFields(GlideRecord Now_GR, Zeichenfolgenfeldnamen)

    Prüft die angegebene Liste der Feldnamen und gibt ein Array gültiger Feldnamen zurück.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Now_GR GlideRecord Zu prüfender GlideRecord
    field Names Zeichenfolge Kommagetrennte Liste mit Feldnamen.
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    Array Array gültiger Felder.

    GlideSPScriptable – getFieldsObject(GlideRecord Now_GR, Zeichenfolgenfeldnamen)

    Prüft die angegebene Liste der Feldnamen und gibt ein Objekt mit gültigen Feldnamen zurück.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Now_GR GlideRecord Zu prüfender GlideRecord
    field Names Zeichenfolge Kommagetrennte Liste mit Feldnamen.
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Objekt Objekt, das gültige Feldnamen enthält.

    GlideSPScriptable – getForm(String tableName, String sysId)

    Geben Sie das Formular zurück, das dem übergebenen Tabellennamen und der Datensatz-sys_ID zugeordnet ist

    Hinweis:
    Die Methode erzwingt bereichsübergreifende Zugriffsberechtigungen für die angegebene Tabelle und den zugehörigen Datensatz.
    Tabelle : 19. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle, in der sich das Formular befindet.
    sysId Zeichenfolge SYS_ID des Formulars.
    Tabelle : 20. Rückgaben
    Typ Beschreibung
    Objekt Angefordertes Formular.
    var sp = new GlideSPScriptable('');
    var res = sp.getForm('sys_user', '6816f79cc0a8016401c5a33be04be441');    // User sys ID information
    gs.info('Name: ' + res._fields.name.value);
    gs.info('E-mail: ' + res._fields.email.value);

    Ausgabe:

    Name: Harry Jones
     E-mail: harryjones@gmail.com

    GlideSPScriptable – getKBCategoryarticles (Zeichenfolge sys_ID, Nummernlimit)

    Gibt KB-Artikel in der angegebenen Kategorie und ihren Unterkategorien zurück.

    Um Leistungsprobleme zu vermeiden, verwenden Sie diese Methode nicht, um Artikel in großen Kategorien oder Artikel mit Inline-Bildern zurückzugeben. Verwenden Sie stattdessen getKBArticleSummaries() .

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    sys_id Zeichenfolge Sys_id der KB-Artikelkategorie.
    limit Zahl Maximale Anzahl der zurückgegebenen KB-Artikel.
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Array Die Artikel in der Kategorie und ihren Unterkategorien mit:
    • workflow_state = published.
    • valid_to-Datum neuer als das aktuelle Datum oder gleich.
    //Server script 
    (function() {
        data.kbs = $sp.getKBCategoryArticles("0ac1bf8bff0221009b20ffffffffffec", 5);
    })();
    
    //HTML template
    <div>
    articles: {{::data.kbs}}
    </div>
    

    GlideSPScriptable – getKBCategoryArticleSummaries (Zeichenfolge sys_ID, Nummernlimit, Anzahl maxChars)

    Gibt Knowledge Base-Artikelzusammenfassungen in der angegebenen Kategorie und ihren Unterkategorien zurück.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    sys_id Zeichenfolge Sys_id der KB-Artikelkategorie.
    limit Zahl Maximale Anzahl der zurückgegebenen KB-Artikel.
    maxChars Zahl Maximale Anzahl von Zeichen, die aus dem Artikeltext zurückgegeben werden sollen. Legen Sie für den vollständigen Artikeltext den Wert auf -1 fest.
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    Array Die Artikel in der Kategorie und ihren Unterkategorien mit:
    • workflow_state = published.
    • valid_to-Datum neuer als das aktuelle Datum oder gleich.
    //Server script 
    (function() {
        data.summary = $sp.getKBCategoryArticleSummaries("0ac1bf8bff0221009b20ffffffffffec", 5, 200);
    })();
    
    //HTML template
    <div>
    articles: {{::data.summary}}
    </div>
    

    GlideSPScriptable – getKBCount(Zeichenfolge sys_ID)

    Gibt die Anzahl der Artikel in der definierten Knowledge Base zurück.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    sys_id Zeichenfolge Sys_id eines Knowledge Base-Datensatzes.
    Tabelle : 26. Ergebnisse
    Typ Beschreibung
    Zahl Anzahl der Wissensartikel in der definierten Knowledge Base mit:
    • workflow_state = published.
    • valid_to-Datum neuer als das aktuelle Datum oder gleich.
    //Server script 
    (function() {
        data.count = $sp.getKBCount("a7e8a78bff0221009b20ffffffffff17");
    })();
    
    //HTML template
    <div>
    articles: {{::data.count}}
    </div>
    

    GlideSPScriptable – getListColumns (Zeichenfolge tableName, Zeichenfolgenansicht)

    Gibt eine Liste der angegebenen Tabellenspalten in der angegebenen Ansicht zurück.

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle
    view Zeichenfolge Ansicht, nach der die Spalten gefiltert werden sollen
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    Objekt Objekt, das die Spaltennamen enthält.

    GlideSPScriptable – getMenuItems(String sysId)

    Gibt ein Array von Menüelementen für die angegebene Instanz zurück.

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    sysId Zeichenfolge sysId der Instanz
    Tabelle : 30. Ergebnisse
    Typ Beschreibung
    Array Menüelemente für die angegebene Instanz

    GlideSPScriptable – getMenuHREF(GlideRecord-Seite)

    Gibt den (?id=)-Teil der URL basierend auf dem sp_menu-Typ zurück.

    Tabelle : 31. Parameter
    Name Typ Beschreibung
    page GlideRecord Seite
    Tabelle : 32. Ergebnisse
    Typ Beschreibung
    Zeichenfolge href-Teil der URL.

    GlideSPScriptable – getParameter(Zeichenfolgenname)

    Gibt den Wert des angegebenen Parameters zurück.

    Tabelle : 33. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Schlüssels aus der Abfragezeichenfolge oder dem Post-Text.
    Tabelle : 34. Ergebnisse
    Typ Beschreibung
    Objekt Gibt den angegebenen Parameter als Objekt zurück. Gibt NULL zurück, wenn keine Anforderung, keine JSON-Anforderung oder kein Widget vorhanden ist.

    GlideSPScriptable – getPortalRecord()

    Gibt den Portaldatensatz aus der Tabelle „Serviceportale“ [sp_Portal] zurück.

    Tabelle : 35. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 36. Ergebnisse
    Typ Beschreibung
    GlideRecord Der Portaldatensatz für das aktuelle Portal aus der Tabelle „Serviceportale“ [sp_Portal].
    //Server script
    (function() {
        var portalGr = $sp.getPortalRecord();
        data.logo = portalGr.getDisplayValue("logo");
        data.homepage = portalGr.getDisplayValue("homepage.id");
    })();
    
    //HTML template
    <div>
        <img ng-src="{{::c.data.logo}}" />
        <a href="?id={{::c.data.homepage}}">Click here to go home</a>
    </div>

    GlideSPScriptable – getRecord(Zeichenfolgentabelle, Zeichenfolge sys_ID)

    Wenn Parameter angegeben werden, gibt den GlideRecord zurück, der durch die angegebene Tabelle und die SYS-ID identifiziert wird. Wenn keine Parameter angegeben werden, gibt den von der aktuellen URL identifizierten Datensatz zurück.

    Tabelle : 37. Parameter
    Name Typ Beschreibung
    table Zeichenfolge Optional. Die Tabelle des zurückzugebenden Datensatzes. Wenn keine Parameter enthalten sind, werden die Tabelle und die SYS-ID zurückgegeben, die durch die aktuelle URL identifiziert werden.
    sys_id Zeichenfolge Optional. Die SYS-ID des zurückzugebenden Datensatzes. Wenn keine Parameter enthalten sind, wird der von der aktuellen URL identifizierte Datensatz zurückgegeben.
    Tabelle : 38. Rückgaben
    Typ Beschreibung
    GlideRecord Wenn Parameter angegeben werden, gibt den Datensatz zurück, der durch die angegebene Tabelle und SYS-ID identifiziert wird.

    Wenn keine Parameter angegeben werden, gibt den von der aktuellen URL identifizierten Datensatz zurück.

    Gibt null zurück, wenn das Widget von einem anderen Widget eingebettet ist oder wenn der Datensatz für die angegebenen Parameter nicht gefunden wurde.

    //Server script 
    (function(){ 
    var now_GR = $sp.getRecord(); 
    data.tableLabel = now_GR.getLabel(); 
    })(); 
    
    //HTML template 
    <div class="panel-heading"> 
    <h4 class="panel-title">${{{data.tableLabel}} details}</h4> 
    </div>

    GlideSPScriptable – getRecordDisplayValues(Objektdaten, GlideRecord von, Zeichenfolgennamen)

    Kopiert Anzeigewerte für die angegebenen Felder in den Datenparameter.

    Tabelle : 39. Parameter
    Name Typ Beschreibung
    data Objekt Die Anzeigewerte für die angegebenen Felder werden in dieses Objekt kopiert.
    from GlideRecord Zu verarbeitender GlideRecord.
    names Zeichenfolge Kommagetrennte Liste mit Feldnamen.
    Tabelle : 40. Ergebnisse
    Typ Beschreibung
    void

    GlideSPScriptable – getRecordElements(Objektdaten, GlideRecord von, Zeichenfolgennamen)

    Kopiert für die angegebenen Felder den Namen, den Anzeigewert und den Wert des Elements in den Datenparameter.

    Tabelle : 41. Parameter
    Name Typ Beschreibung
    data Objekt Der Name, der Anzeigewert und der Wert des Elements für die angegebenen Felder werden in dieses Objekt kopiert.
    from GlideRecord Zu verarbeitender GlideRecord.
    names Zeichenfolge Kommagetrennte Liste mit Feldnamen.
    Tabelle : 42. Ergebnisse
    Typ Beschreibung
    void

    GlideSPScriptable – getRecordValues(Objektdaten, GlideRecord von, Zeichenfolgennamen)

    Kopiert Werte für die angegebenen Feldnamen aus dem GlideRecord in den Datenparameter.

    Tabelle : 43. Parameter
    Name Typ Beschreibung
    data Objekt Der Wert für die angegebenen Felder wird in dieses Objekt kopiert.
    from GlideRecord Zu verarbeitender GlideRecord.
    names Zeichenfolge Kommagetrennte Liste mit Feldnamen.
    Tabelle : 44. Ergebnisse
    Typ Beschreibung
    void

    GlideSPScriptable – getRecordVariables (GlideRecord Now_GR, Boolean includeNilResponses)

    Gibt Zurück Servicekatalog Variablen, die einem Datensatz zugeordnet sind, im Zeichenfolgenformat.

    Tabelle : 45. Parameter
    Name Typ Beschreibung
    Now_GR GlideRecord Datensatz, für den Servicekatalog Variablen abgerufen werden sollen. Muss ein Datensatz mit Servicekatalog definierten Variablen sein, wie ein Datensatz für ein angefordertes Element [sc_req_item] oder ein Incident, der von einem Datensatzersteller übermittelt wurde.
    includeNilResponses Boolean Optional. Bei „wahr“ enthält die API Variablen ohne anwenderdefinierten Wert.
    Tabelle : 46. Rückgaben
    Typ Beschreibung
    Zeichenfolge Servicekatalog Variablen, die dem Datensatz zugeordnet sind.
    //Server script 
    (function() {
    var itemsGR = new GlideRecord("sc_req_item");
    itemsGR.get('585d1bc44f4f13008a959a211310c77d');
    	
    data.scVars = $sp.getRecordVariables(itemsGR);
    
    })();
    
    //HTML template
    <div>
    Requested item variables: {{::data.scVars}}
    </div>

    Ausgabe:

    Requested item variables: [
      {
        "display_value":"MetroPCS",
        "name":"carrier",
        "visible_summary":true,
        "id":"585d1bc44f4f13008a959a211310c77c",
        "label":"Allocated carrier",
        "type":"5",
        "value":"metropcs",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"Unlimited",
        "name":"data_plan",
        "visible_summary":true,
        "id":"d05d1bc44f4f13008a959a211310c77c",
        "label":"Monthly data allowance",
        "type":"5",
        "value":"unlimited",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"12 Months",
        "name":"duration",
        "visible_summary":true,
        "id":"d85d1bc44f4f13008a959a211310c77c",
        "label":"Contract duration",
        "type":"5",
        "value":"twelve_months",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"Slate",
        "name":"color",
        "visible_summary":true,
        "id":"545d1bc44f4f13008a959a211310c77c",
        "label":"Color",
        "type":"5",
        "value":"slate",
        "visible_standalone":true,
        "visible_guide":true
      },
      {"display_value":"64GB",
        "name":"storage",
        "visible_summary":true,
        "id":"d45d1bc44f4f13008a959a211310c77c",
        "label":"Storage",
        "type":"5",
        "value":"sixtyfour",
        "visible_standalone":true,
        "visible_guide":true
      }
    ]

    GlideSPScriptable – getRecordVariablesArray(GlideRecord Now_GR, Boolean includeNilResponses)

    Gibt ein Array von Servicekatalog Variablen zurück, die einem Datensatz zugeordnet sind.

    Tabelle : 47. Parameter
    Name Typ Beschreibung
    Now_GR GlideRecord Datensatz, für den Servicekatalog Variablen abgerufen werden sollen. Muss ein Datensatz mit Servicekatalog definierten Variablen sein, wie ein Datensatz für ein angefordertes Element [sc_req_item] oder ein Incident, der von einem Datensatzersteller übermittelt wurde.
    includeNilResponses Boolean Optional. Bei „wahr“ enthält die API Variablen ohne anwenderdefinierten Wert.
    Tabelle : 48. Rückgaben
    Typ Beschreibung
    Objekt Array aus Servicekatalog Variablen, die dem Datensatz zugeordnet sind.
    //Server script 
    (function() {
    var itemsGR = new GlideRecord("sc_req_item");
    itemsGR.get('585d1bc44f4f13008a959a211310c77d');
    	
    data.scVars = $sp.getRecordVariablesArray(itemsGR);
    
    })();
    
    //HTML template
    <div>
    Requested item variables: {{::data.scVars}}
    </div>

    Ausgabe:

    Requested item variables: [
      {
        "display_value":"MetroPCS",
        "name":"carrier",
        "visible_summary":true,
        "id":"585d1bc44f4f13008a959a211310c77c",
        "label":"Allocated carrier",
        "type":"5",
        "value":"metropcs",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"Unlimited",
        "name":"data_plan",
        "visible_summary":true,
        "id":"d05d1bc44f4f13008a959a211310c77c",
        "label":"Monthly data allowance",
        "type":"5",
        "value":"unlimited",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"12 Months",
        "name":"duration",
        "visible_summary":true,
        "id":"d85d1bc44f4f13008a959a211310c77c",
        "label":"Contract duration",
        "type":"5",
        "value":"twelve_months",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"Slate",
        "name":"color",
        "visible_summary":true,
        "id":"545d1bc44f4f13008a959a211310c77c",
        "label":"Color",
        "type":"5",
        "value":"slate",
        "visible_standalone":true,
        "visible_guide":true
      },
      {"display_value":"64GB",
        "name":"storage",
        "visible_summary":true,
        "id":"d45d1bc44f4f13008a959a211310c77c",
        "label":"Storage",
        "type":"5",
        "value":"sixtyfour",
        "visible_standalone":true,
        "visible_guide":true
      }
    ]

    GlideSPScriptable – getStream(Zeichenfolgentabelle, SYS-ID der Zeichenfolge)

    Ruft den Aktivitäts-Stream für den angegebenen Datensatz ab. Diese Methode funktioniert für Tabellen, die die Aufgabentabelle erweitern.

    Tabelle : 49. Parameter
    Name Typ Beschreibung
    table Zeichenfolge Der Tabellenname
    sysID Zeichenfolge Die sys_id des Datensatzes
    Tabelle : 50. Ergebnisse
    Typ Beschreibung
    Objekt Wenn eine Tabelle angegeben wird, die die Aufgabentabelle erweitert, enthält sie die Eigenschaften „display_value“, „sys_id“, „short_description“, „number“, „entries“, „user_sys_id“, „user_full_name“, „user_login“, „label“, „table“ und „journal_fields“; sie enthält andernfalls die Eigenschaften „table“ und „sys_id“.
    Hinweis:
    Die user_login-Eigenschaft enthält die Benutzer-ID des aktuellen Benutzers. Die Eigenschaften „user_sys_id“ und „user_full_name“ verweisen auf den Ersteller des abgefragten Datensatzes.

    GlideSPScriptable – getUserInitials()

    Gibt die Initialen des Benutzers zurück.

    Tabelle : 51. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 52. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Initialen des Benutzers

    GlideSPScriptable – getValue(Zeichenfolgenname)

    Gibt den benannten Wert der JSON-Anforderung, -Instanz oder -Portals zurück.

    Tabelle : 53. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name der JSON-Anforderung, -Instanz oder des Portals.
    Tabelle : 54. Rückgaben
    Typ Beschreibung
    Objekt Wert des angegebenen Parameters. Null, wenn die angegebene Entität nicht vorhanden ist oder keinen solchen Parameter hat.
    //Server script
    (function() {
        data.title = $sp.getValue("title");
        data.catalog = $sp.getValue("sc_catalog");
    })();
    
    //HTML templage
    <div>
        <h1>sp_instance.title: {{::data.title}}</h1>
        <h1>sp_portal.sc_catalog: {{::data.catalog}}</h1>
    </div>

    GlideSPScriptable – getValues(Objektdaten, Zeichenfolgennamen)

    Kopiert Werte aus der Anforderung oder Instanz in den Datenparameter.

    Tabelle : 55. Parameter
    Name Typ Beschreibung
    data Objekt Erhält die Parameterwerte.
    names Zeichenfolge Kommagetrennte Zeichenfolge mit Feldnamen.
    Tabelle : 56. Ergebnisse
    Typ Beschreibung
    void

    GlideSPScriptable – getVariablesArray(Boolean includeNilResponses)

    Gibt ein Array von zurück Servicekatalog Variablen, die dem Datensatz in der URL zugeordnet sind.

    Beispiel: Wenn die URL die Parameter enthält id=Form&table=sc_req_item&sys_ID=832e9620db4f33008376b984b9619cf , Die API gibt die Variablen zurück, die dem angegebenen Datensatz in der Tabelle „angefordertes Element“ [sc_req_item] zugeordnet sind. Muss ein Datensatz mit Servicekatalog definierten Variablen sein, wie ein Datensatz für ein angefordertes Element [sc_req_item] oder ein Incident, der von einem Datensatzersteller übermittelt wurde.

    Tabelle : 57. Parameter
    Name Typ Beschreibung
    includeNilResponses Boolean Optional. Bei „wahr“ enthält die API Variablen ohne anwenderdefinierten Wert.
    Tabelle : 58. Rückgaben
    Typ Beschreibung
    Objekt Array von Variablen, die der Tabelle zugeordnet sind.
    //Server script 
    (function() {	
    data.scVars = $sp.getVariablesArray();
    })();
    
    //HTML template
    <div Current record variables: {{::data.scVars}} ></div>

    Ausgabe:

    Current record variables: [
      {
        "display_value":"unlimited",
        "name":"data","visible_summary":
        true,"id":"472e5620db4f330083766b984b96198a",
        "label":"Data",
        "type":"6",
        "value":"unlimited",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"Black",
        "name":"color",
        "visible_summary":true,
        "id":"c72e5620db4f330083766b984b96198a",
        "label":"Color",
        "type":"6",
        "value":"Black",
        "visible_standalone":true,
        "visible_guide":true
      }
    ] 

    GlideSPScriptable – getWidget(String sysID, Objektoptionen)

    Ruft ein Widget nach id oder sys_id ab, führt das Serverskript dieses Widget mit den angegebenen Optionen aus und gibt das Widget-Modell zurück.

    Tabelle : 59. Parameter
    Name Typ Beschreibung
    sysID Zeichenfolge sys_id des Widgets oder widget_id
    Optionen Objekt Objekt, das an das Serverskript des Widgets übergeben wird. Verweisen Sie auf dieses Objekt als options in Ihrem Serverskript.
    Hinweis:
    Alle an diese Funktion übergebenen Optionen sind nur im Serverskript des eingebetteten Widgets bei der ersten Ausführung dieses Skripts verfügbar. Alle nachfolgenden Aufrufe des Serverskripts aus dem eingebetteten Widget enthalten nicht die übergebenen Objekteigenschaften.
    Tabelle : 60. Ergebnisse
    Typ Beschreibung
    Objekt Widget-Modell, das mit sp-widget verwendet werden soll.
    //Server script
    data.myWidget = $sp.getWidget('widget_id', {p1: param1, p2: param2});
    
    //HTML
    <sp-widget widget="c.data.myWidget"></sp-widget>

    GlideSPScriptable – isRTLEnabled()

    Überprüft, ob das zugeordnete Portal für die Rechts-nach-links-Sprache (RTL) aktiviert ist und ob die Sprache des aktuellen Anwenders direktional RTL ist.

    Verwenden Sie diese Methode, um zu bestimmen, ob in der Portal-UI ein RTL-spezifisches CSS erforderlich ist.

    Tabelle : 61. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 62. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die RTL-Kennzeichnung aktiviert ist und die Sitzungssprache des aktuellen Anwenders direktional RTL ist.

    Mögliche Werte:

    • Wahr: Die RTL-Kennzeichnung ist aktiviert.
    • Falsch: Die RTL-Kennzeichnung ist nicht aktiviert.

    Datentyp: Boolesch

    Das folgende Codebeispiel zeigt, wie Sie mit dieser Methode den Typ des Symbols bestimmen, das auf der Portalseite angezeigt werden soll.

    // Server script  
    (function() {
      data.isRTLEnabled = $sp.isRTLEnabled();
     })(); 
    
    // HTML template 
    <div> <i ng-class="c.data.isRTLEnabled ? 'fa fa-arrow-right' : 'fa fa-arrow-left'"></i> </div> 

    GlideSPScriptable – isUserCriteriaEnabled()

    Gibt „true“ zurück, wenn Benutzerkriterien aktiviert sind.

    Diese Methode gibt „true“ zurück, wenn die Unterstützung der Service Portal-Benutzerkriterien Plugin (com.glide.service-portal.user-criteria) ist aktiv und die Aktivieren Sie die Verwendung von Benutzerkriteriendatensätzen anstelle von Rollenfeldern für Service Portal-Berechtigungen (glide.service_portal.user_criteria_enabled) Die Systemeigenschaft ist auf „true“ gesetzt.

    Tabelle : 63. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 64. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn Benutzerkriterien aktiviert sind.

    GlideSPScriptable – log(Objektnachricht)

    Protokolliert die Ausgabe in der Tabelle „Serviceportal-Protokolleinträge“ [sp_log]. Der angemeldete Anwender muss über die Rolle sp_admin oder admin verfügen.

    Tabelle : 65. Parameter
    Name Typ Beschreibung
    message Objekt JavaScript-Objekt oder -Zeichenfolge, die die Nachricht darstellt, die als Ausgabe auf einem gesendet werden soll Serviceportal Seite.
    Tabelle : 66. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein vordefinierter Fehler protokolliert wird, wenn er auftritt.

    var demo_data = null;
    var params = null;
    if (gr.getValue("demo_data")) {
       try {
    	demo_data = JSON.parse(gr.getValue("demo_data"));
    	params = (demo_data.options) ? demo_data.options : null;
    	} catch(e) {
    	$sp.log(e);
       }
    }

    GlideSPScriptable – mapUrlToSPUrl(Zeichenfolgen-url)

    Wandelt eine URL, die eine Liste oder ein Formular in der Plattformbenutzeroberfläche anfordert, in die URL der entsprechenden id=list- oder id=form-Service Portal-Seite um.

    Verwenden Sie diese Methode, um Aufgaben durchzuführen, z. B. das Umleiten eines Benutzers nach der Anmeldung zur richtigen Service Portal-Seite, wenn sie ein Plattform-UI-Formular oder eine Listen-URL anfordern. Die Seitenziele id=list und id=form sind nicht anpassbar.
    Hinweis:
    Die Werte für „table“, „sys_id“ und „sysparm_query“ werden von der ursprünglichen URL beibehalten. „sysparm_view“ nicht.
    Tabelle : 67. Parameter
    Name Typ Beschreibung
    URL Zeichenfolge URL der Plattform-UI
    Tabelle : 68. Ergebnisse
    Typ Beschreibung
    Zeichenfolge URL des transformierten Service Portal

    Wenn die übergebene URL keine Liste oder kein Formular in der Plattform-UI anfordert, wird ein NULL-Wert zurückgegeben.

    Listenbeispiel

    GlideSPScriptable().mapUrlToSPUrl("http://demo.service-now.com/task_list.do?sysparm_userpref_module=1523b8d4c611227b00be8216ec331b9a&sysparm_query=assigned_to=javascript:getMyAssignments()&sysparm_clear_stack=true"))

    Ergebnisse

    id=list&table=task&filter=assigned_to=javascript:getMyAssignments()&sys_id=&v=

    Formularbeispiel

    GlideSPScriptable().mapUrlToSPUrl("incident.do?sys_id=12bc12bc12bc12bc12bc12bc12bc12bc")

    Ergebnisse

    id=form&table=incident&filter=&sys_id=12bc12bc12bc12bc12bc12bc12bc12bc&v=

    GlideSPScriptable – userCanSeeSearchSourceByCriteria(Zeichenfolge searchSourceID)

    Gibt „true“ zurück, wenn der aktuelle Benutzer eine durch die searchSourceID angegebene Suchquelle sehen kann.

    Gibt „true“ zurück, wenn der Benutzer nicht durch Benutzerkriterien eingeschränkt ist. Weitere Informationen dazu, wie sich Anwenderkriterien auf Serviceportal-Assets auswirken, finden Sie unter Anwenderkriterien für Serviceportal .
    Hinweis:
    Diese Methode wertet rollenbasierte Berechtigungen der Suchquelle nicht aus und sollte nur verwendet werden, wenn Benutzerkriterien aktiviert sind.
    Tabelle : 69. Parameter
    Name Typ Beschreibung
    SearchSourceID Zeichenfolge SYS_ID des Suchquelldatensatzes.
    Tabelle : 70. Rückgaben
    Typ Beschreibung
    Boolean „True“, wenn der aktuelle Benutzer Lesezugriff auf die Suchquelle hat.