GlideSPScriptable: Bereichsbezogen

Die GlideSPScriptable- API bietet Methoden für die Interaktion mit Daten und die Durchführung von Datensatzvorgängen in Serviceportal -Widgets.

Greifen Sie auf die skriptfähigen GlideSP- Methoden zu, indem Sie das globale Objekt $sp verwenden.

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, Zeichenfolgen-sysId)

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 „true“ zurück, falls der aktuell angemeldete Anwender berechtigt ist, die angegebene Seite anzuzeigen.

Das System bestimmt die Berechtigung anhand von Rollen und Benutzerkriterien. Weitere Informationen finden Sie unter Seitensicherheit nach Rolle und Benutzerkriterien für Serviceportalkonfigurieren.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
pageID	Zeichenfolge	Seiten-ID aus der Tabelle „Seiten“ [sp_page].

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der aktuell angemeldete Anwender berechtigt ist, die angegebene Seite anzuzeigen. 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.

In diesem Beispiel wird dem Menüelement „Wissen“ im SP-Headermenü eine Bedingung hinzugefügt, um das Menüelement nur Anwendern anzuzeigen, die zum Anzeigen der Seite „kb_view2“ berechtigt sind.

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 die Methode „getCatalogItem(String sysId, Boolean isOrdering) “ auf, wobei der Parameter isOrdering auf „falsch“ festgelegt ist. Dies 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(String sysId, Boolean 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, Zeichenfolge 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, Zeichenfolge fieldNames)

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, Zeichenfolge fieldNames)

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)

Gibt das Formular zurück.

Tabelle : 19. Parameter

Name	Typ	Beschreibung
tableName	Zeichenfolge	Name der Tabelle
sysId	Zeichenfolge	sys_id des Formulars

Tabelle : 20. Ergebnisse

Typ	Beschreibung
Objekt	Formular

GlideSPScriptable – getKBCategoryArticles(String sys_id, Anzahlbegrenzung)

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(String sys_id, Anzahlbegrenzung, 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(String 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(String tableName, String view)

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(String name)

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(String table, String sys_id)

Wenn Parameter angegeben werden, wird der GlideRecord zurückgegeben, der durch die angegebene Tabelle und Sys-ID identifiziert wird. Wenn keine Parameter angegeben werden, gibt den durch die aktuelle 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 durch die aktuelle URL identifizierte Datensatz zurückgegeben.

Tabelle : 38. Ergebnisse

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 durch die aktuelle URL identifizierten Datensatz zurück. Gibt null zurück, wenn das Widget von einem anderen Widget eingebettet wird 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(Object data, GlideRecord from, 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(Object data, GlideRecord from, 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, Boolesche EinbindungNilResponses)

Gibt Servicekatalog -Variablen zurück, 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. Ergebnisse

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, Boolesche EinbindungNilResponses)

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

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(String table, String sysId)

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(String name)

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

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

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

Wenn die URL beispielsweise die Parameter id=form&table=sc_req_item&sys_id=832e9620db4f330083766b984b9619cf enthält, gibt die API 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. Ergebnisse

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, Object Optionen)

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 RTL (Rechts-zu-Links-Sprache) aktiviert ist und ob die Sprache des aktuellen Anwenders RTL (Richtungs-RTL) ist.

Verwenden Sie diese Methode, um zu bestimmen, ob ein RTL-spezifisches CSS in der Portal-UI 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 gerichtetes RTL ist. Mögliche Werte: wahr: Die RTL-Kennzeichnung ist aktiviert. „false“: Die RTL-Kennzeichnung ist nicht aktiviert. Datentyp: Boolesch

Das folgende Codebeispiel zeigt, wie diese Methode verwendet wird, um den Symboltyp zu bestimmen, der 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 – Protokoll (Objektnachricht)

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

Tabelle : 65. Parameter

Name	Typ	Beschreibung
message	Objekt	JavaScript-Objekt oder -Zeichenfolge, das die Nachricht darstellt, die als Ausgabe auf einer Seite Serviceportal gesendet werden soll.

Tabelle : 66. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie ein vordefinierter Fehler protokolliert wird, falls 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(String 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(String 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 Benutzerkriterien auf Serviceportal-Assets auswirken, finden Sie unter Benutzerkriterien 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. Ergebnisse

Typ	Beschreibung
Boolean	„True“, wenn der aktuelle Benutzer Lesezugriff auf die Suchquelle hat.