GlideSPSkriptfähig – Umfang
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.
| Name | Typ | Beschreibung |
|---|---|---|
| Now_GR | GlideRecord | Zu prüfender GlideRecord. |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| table | Zeichenfolge | Name der abzurufenden Tabelle |
| sysId | Zeichenfolge | sys_id des abzufragenden Datensatzes. |
| 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 .
| Name | Typ | Beschreibung |
|---|---|---|
| Seiten-ID | Zeichenfolge | Seiten-ID aus der Tabelle „Seiten“ [sp_page]. |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob der derzeit angemeldete Anwender über Berechtigungen zum Anzeigen der angegebenen Seite verfügt. Werte:
|
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.
| Name | Typ | Beschreibung |
|---|---|---|
| sysId | Zeichenfolge | sys_id des Katalogelements (sc_cat_item) oder Bestellleitfadens (sc_cat_item_guide). |
| 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.
| 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. |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| fieldName | Zeichenfolge | Name des Felds |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Now_GR | GlideRecord | Zu prüfender GlideRecord |
| fieldName | Zeichenfolge | Feld, für das Informationen gesucht werden sollen |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Now_GR | GlideRecord | Zu prüfender GlideRecord |
| field Names | Zeichenfolge | Kommagetrennte Liste mit Feldnamen. |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Now_GR | GlideRecord | Zu prüfender GlideRecord |
| field Names | Zeichenfolge | Kommagetrennte Liste mit Feldnamen. |
| 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
| Name | Typ | Beschreibung |
|---|---|---|
| tableName | Zeichenfolge | Name der Tabelle, in der sich das Formular befindet. |
| sysId | Zeichenfolge | SYS_ID des Formulars. |
| 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() .
| Name | Typ | Beschreibung |
|---|---|---|
| sys_id | Zeichenfolge | Sys_id der KB-Artikelkategorie. |
| limit | Zahl | Maximale Anzahl der zurückgegebenen KB-Artikel. |
| Typ | Beschreibung |
|---|---|
| Array | Die Artikel in der Kategorie und ihren Unterkategorien mit:
|
//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.
| 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. |
| Typ | Beschreibung |
|---|---|
| Array | Die Artikel in der Kategorie und ihren Unterkategorien mit:
|
//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.
| Name | Typ | Beschreibung |
|---|---|---|
| sys_id | Zeichenfolge | Sys_id eines Knowledge Base-Datensatzes. |
| Typ | Beschreibung |
|---|---|
| Zahl | Anzahl der Wissensartikel in der definierten Knowledge Base mit:
|
//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.
| Name | Typ | Beschreibung |
|---|---|---|
| tableName | Zeichenfolge | Name der Tabelle |
| view | Zeichenfolge | Ansicht, nach der die Spalten gefiltert werden sollen |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| sysId | Zeichenfolge | sysId der Instanz |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| page | GlideRecord | Seite |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | href-Teil der URL. |
GlideSPScriptable – getParameter(Zeichenfolgenname)
Gibt den Wert des angegebenen Parameters zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Name | Zeichenfolge | Name des Schlüssels aus der Abfragezeichenfolge oder dem Post-Text. |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| 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. |
| 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.
| 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. |
| 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.
| 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. |
| Typ | Beschreibung |
|---|---|
| void |
GlideSPScriptable – getRecordValues(Objektdaten, GlideRecord von, Zeichenfolgennamen)
Kopiert Werte für die angegebenen Feldnamen aus dem GlideRecord in den Datenparameter.
| 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. |
| Typ | Beschreibung |
|---|---|
| void |
GlideSPScriptable – getRecordVariables (GlideRecord Now_GR, Boolean includeNilResponses)
Gibt Zurück Servicekatalog Variablen, die einem Datensatz zugeordnet sind, im Zeichenfolgenformat.
| 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. |
| 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.
| 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. |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| table | Zeichenfolge | Der Tabellenname |
| sysID | Zeichenfolge | Die sys_id des Datensatzes |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Initialen des Benutzers |
GlideSPScriptable – getValue(Zeichenfolgenname)
Gibt den benannten Wert der JSON-Anforderung, -Instanz oder -Portals zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Name | Zeichenfolge | Name der JSON-Anforderung, -Instanz oder des Portals. |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| data | Objekt | Erhält die Parameterwerte. |
| names | Zeichenfolge | Kommagetrennte Zeichenfolge mit Feldnamen. |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| includeNilResponses | Boolean | Optional. Bei „wahr“ enthält die API Variablen ohne anwenderdefinierten Wert. |
| 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.
| 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. |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob die RTL-Kennzeichnung aktiviert ist und die Sitzungssprache des aktuellen Anwenders direktional RTL ist. Mögliche Werte:
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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| message | Objekt | JavaScript-Objekt oder -Zeichenfolge, die die Nachricht darstellt, die als Ausgabe auf einem gesendet werden soll Serviceportal Seite. |
| 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.
id=list und id=form sind nicht anpassbar.| Name | Typ | Beschreibung |
|---|---|---|
| URL | Zeichenfolge | URL der Plattform-UI |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| SearchSourceID | Zeichenfolge | SYS_ID des Suchquelldatensatzes. |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn der aktuelle Benutzer Lesezugriff auf die Suchquelle hat. |