Unterstützte Client-Skripttypen und APIs

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer
  • Einige Client-Skripte werden in Serviceportal nicht unterstützt. Für andere Benutzer muss ein UI-Typ auf Alle oder Mobile / Service Portal festgelegt sein. Bei Verwendung eines Client-Skripts im Serviceportal können nur in einer mobilen Umgebung unterstützte clientseitige APIs verwendet werden.

    Unterstützung für Client-Skripts in Serviceportal

    Client-Skript Beschreibung
    Katalog-Client-Skript

    Serviceportal Erfordert, dass UI-Typ Feld auf festgelegt sein Alle Oder Mobil/Serviceportal . Clientskripts, die als Desktop markiert sind, verlassen sich auf ältere APIs, die in nicht Serviceportal unterstützt werden. Bevor Sie ein Skript als Mobil/Service Portal bzw. „Alle“ kennzeichnen, stellen Sie sicher, dass Sie nur unterstützte clientseitige APIs verwenden.

    Validierungsskripte

    Serviceportal Erfordert, dass UI-Typ Feld auf festgelegt sein Alle Oder Mobil/Serviceportal . Clientskripts, die als Desktop markiert sind, verlassen sich auf ältere APIs, die in nicht Serviceportal unterstützt werden. Bevor Sie ein Skript als Mobil/Service Portal bzw. „Alle“ kennzeichnen, stellen Sie sicher, dass Sie nur unterstützte clientseitige APIs verwenden.

    Überprüfen Sie die Benutzereingabe in einem bestimmten Feldtyp mit einem Validierungsskript. Bei neuen Instanzen umfasst Serviceportal standardmäßig XML-, Skript-, Skript- (Einfach-), E-Mail- und Versionsüberprüfungsskripts. Wenn Sie ein Upgrade von einer früheren Version durchführen, sind die mobile und die Serviceportal-Version nicht standardmäßig aktiv. Sie müssen die mobile und Serviceportal-Version des Validierungsskripts zur Überprüfung der Benutzereingaben in Serviceportal aktivieren.Siehe Aktivieren Sie Validierungsskripts für Serviceportal .

    Hinweis:
    Verwenden Sie das globale Objekt g_ui_scripts, um ein UI-Skript innerhalb eines Validierungsskripts aufzurufen. Weitere Informationen finden Sie unter GlideUIScripts . Vergewissern Sie sich, dass im UI-Skript das Feld Global auf false und der UI-Typ auf Mobile / Serviceportal oder Alle eingestellt sind.
    UI-Skripts

    Serviceportal Erfordert, dass UI-Typ Feld auf festgelegt sein Alle Oder Mobil/Serviceportal . Clientskripts, die als Desktop markiert sind, verlassen sich auf ältere APIs, die in nicht Serviceportal unterstützt werden. Bevor Sie ein Skript als Mobil/Service Portal bzw. „Alle“ kennzeichnen, stellen Sie sicher, dass Sie nur unterstützte clientseitige APIs verwenden.

    UI-Aktionen

    Alle serverseitigen UI-Aktionen werden in Serviceportal unterstützt, obwohl setRedirectURL() Vorgänge ignoriert werden, weil die Weiterleitung in Serviceportal Formularen anders als in der Plattform behandelt wird.

    Das Formular-Widget ignoriert alle als Client markierten UI-Aktionen.

    UI-Richtlinien Wird unterstützt, obwohl Sie nur deklarative UI-Richtlinien verwenden sollten. Vermeiden Sie Skripting, es sei denn, das Ergebnis kann nicht über den Condition Builder erreicht werden.
    UI-Makros Wird nicht unterstützt, weil UI-Makros Jelly verwenden.
    Formatierer Wird nicht unterstützt, weil Formatierer Jelly verwenden.

    Unterstützte clientseitige APIs

    Unterstützte Client-Skripting-APIs für die Verwendung in Client-Skripts onLoad, onChange und onSubmit.

    Detaillierte Informationen zu Klassen und Methoden finden Sie unter Client API reference.

    Klasse Verfügbare Methoden
    g_form
    • addDecoration(fieldName, icon, title)
    • addErrorMessage(message)
    • addInfoMessage(message)
    • addOption(fieldName, value, label, index)
    • clearOptions(fieldName)
    • getActionName()
    • getBooleanValue(fieldName)
    • getDecimalValue(fieldName)
    • getEncodedRecord()
    • getFieldNames()
    • getIntValue(fieldName)
    • getLabel(fieldName)
    • getReference(fieldName, callback)
    • getRelatedListNames()
    • getSectionNames()
    • getSysId()
    • getTableName()
    • getValue(fieldName)
    • hasField(fieldName)
    • hideAllFieldMsgs(type: "info | error")
    • hideErrorBox(fieldName)
    • hideFieldMsg(fieldName, clearAll)
    • hideRelatedList(listTableName)
    • hideRelatedLists()
    • isMandatory(fieldName)
    • isNewRecord()
    • isReadOnly(fieldName)
    • isVisible(fieldName)
    • removeDecoration(fieldName, icon, title)
    • removeOption(fieldName, value)
    • save()
    • serialize(onlyDirtyFields)
    • setFieldPlaceholder(fieldName, placeholder)
    • setLabel(fieldName, label)
    • setMandatory(fieldName, isMandatory)
    • setReadOnly(fieldName, isReadOnly)
    • setSectionDisplay(sectionName, isVisible)
    • setValue(fieldName, value, displayValue)
    • setVisible(fieldName, isVisible)
    • showErrorBox(fieldName, message, scrollForm)
    • showFieldMsg(fieldName, message, type: "info | error", scrollForm)
    • showRelatedList(relatedTableName)
    • showRelatedLists()
    • submit(submitActionName)
    Hinweis:
    Die Verwendung der variables.var_name Notation mit der API g_form wird in Serviceportal nicht unterstützt. g_form als globales Objekt kann nicht in einem Widget-Client-Controller oder in einem UI-Skript verwendet werden.
    g_list
    • get(fieldName)
    • addItem(value, displayValue)
    • removeItem(value)
    • reset()
    • setQuery (queryString)
    • setDefaultOperator(operator)
    • getDefaultOperator()
    g_service_catalog

    isOrderGuide()-

    GlideAjax
    • addParam (name, value)
    • getParam (name)
    • getXML(callback)
    • getXMLAnswer(callback)
    • getJSON(callback)
    • setErrorCallback(errorCallback)
    • getURL()
    • getParams()
    • execute()
    • successCalback(data, status, xhr)
    • errorCallback(xhr)
    • setScope(scope)
    Hinweis:
    • Da die mobile Plattform keine synchronen GlideAjax-Aufrufe zulässt, funktioniert die Methode getXMLWait() in einem GlideAjax-Aufruf in Serviceportal nicht. Verwenden Sie stattdessen einen der asynchronen Aufrufe, z. B. getXML(Function callback) oder getXMLAnswer(Function callback).
    • GlideAjax kann nicht in einem Widget-Client-Controller verwendet werden.
    GlideRecord
    • addQuery(encodedQuery)
    • addQuery(fieldName, operator, value)
    • getEncodedQuery()
    • get(id)
    • getTableName()
    • hasNext()
    • insert(callback)
    • gotoTop()
    • next()
    • loadRow(rowObj)
    • getValue(fieldName)
    • setValue(fieldName, value)
    • isDotWalkField(fieldName)
    • addOrderBy(fieldName)
    • setDisplayFields(fieldNames)
    • query(callback)
    • setRows(rowsArray)
    • setTableName(tableName)
    • setLimit(maxInt)
    • getLimit()
    I18NV3

    GetMessage(Zeichenfolge messageKey, Funktionsrückruf)