Jelly Tags

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 7 Minuten Lesedauer

    • Verwenden Sie Jelly, um XML in HTML umzuwandeln.

    Sehen Sie sich diese Einführungsvideos an, um mehr über die Verwendung von Jelly im zu erfahren ServiceNow AI Platform.

    Jelly-Tags

    if
    • Beschreibung: Der Wenn Tag ist genau, wie es aussieht, ein Wenn Tag. Dies ist wie ein Wenn Anweisung in einer beliebigen Programmiersprache, aber beachten Sie, dass es keine gibt Elseif Tag und Nein Sonst Tag. Wenn Sie diese Art von Struktur erstellen möchten, versuchen Sie es mit Wählen Sie aus / Wenn / Andernfalls Syntax.
    • Parameter: Testen – Die auszuwertende Bedingung, um zu bestimmen, ob der Block ausgeführt wird.
    • Beispiel:
      <g:evaluate var="jvar_now_GR" object="true">
   var now_GR = new GlideRecord("incident");
   now_GR.addQuery("active", true);
   now_GR.query();
   now_GR;
</g:evaluate>
 
<j:if test="${!jvar_now_GR.hasNext()}">
   We did not find any active incidents.
</j:if>
<j:if test="${jvar_now_GR.next()}">
   We found ${jvar_now_GR.getRowCount()} active incidents.
</j:if>
    while
    • Beschreibung: Der Während Tag führt eine While-Schleife aus.
    • Parameter: Testen – Die auszuwertende Bedingung, um zu bestimmen, ob die Anweisung durchläuft. Dies muss ein Ausdruck sein, der in eingeschlossen ist ${} Oder $[] Die Auswertung ergibt „wahr“ oder „falsch“.
    • Beispiel: 
      <g:evaluate var="jvar_now_GR" object="true">
   var now_GR = new GlideRecord("incident");
   now_GR.addQuery("active", true);
   now_GR.query();
   now_GR;
</g:evaluate>
 
<j:while test="${jvar_now_GR.next()}">
  <a href="incident.do?sys_id=${jvar_now_GR.getValue('sys_id')}">${jvar_now_GR.getValue('number')}</a>
</j:while>
    set
    • Beschreibung: Der Festlegen Tag legt eine Variable fest.
    • Parameter:
      • var: die festzulegende Variable. Häufig stellt das System diesen Variablen ein Präfix vor Jvar_ Für Konsistenz.
      • value: der Wert, der für var festgelegt werden soll. Dies ist oft ein Ausdruck, der in eingeschlossen ist ${} Oder $[] .
      • DEFAULTVALUE – Wenn der Wert null oder leer ist, wird dieser Wert in eingefügt VAR .
    • Beispiel: 
      <j:set var="jvar_incident_number" value="${jvar_now_GR.getValue('number')}"/>
    set_if
    • Beschreibung: Der Set_if Tag legt eine Variable basierend auf einem Test fest. Dieses Tag ähnelt dem Ternär Operator in anderen Programmiersprachen ( VAR = <test>? <if_true>: <if_false> ).
    • Parameter:
      • var: die festzulegende Variable. Häufig stellt das System diesen Variablen ein Präfix vor Jvar_ Für Konsistenz.
      • test: die auszuwertende Bedingung, die entscheidet, ob die Anweisung den Wert „true“ oder den Wert „false“ hat. Dies muss ein Ausdruck sein, der in eingeschlossen ist ${} Oder $[] Die Auswertung ergibt „wahr“ oder „falsch“.
      • true: der Wert, auf den die Variable gesetzt werden soll, wenn test den Wert true ermittelt. Dieser Parameter ist optional. Wenn das Feld also leer ist und der Test als „wahr“ ausgewertet wird, wird die Variable leer gelassen.
      • Falsch – Der Wert, auf den die Variable festgelegt werden soll, wenn Testen Wird als „falsch“ ausgewertet. Dieser Parameter ist optional. Wenn das Feld leer ist und „test“ das Ergebnis „false“ liefert, bleibt die Variable leer.
    choose
    • Beschreibung: Der Wählen Sie aus Tag startet einen ausgewählten Codeblock. Dies ähnelt dem Wenn-elseif-else Art der Syntax in den meisten Programmiersprachen. Mit Wählen Sie aus Tag, das Sie verwenden können Wenn Und Andernfalls Tags zur Angabe anderer Codeblöcke.
    • Parameter: Keine
    • Beispiel: 
      <j:choose>
   <j:when test="${jvar_now_GR.getRowCount() ${AMP}lt; 1}">We found multiple records!</j:when>
   <j:when test="${jvar_now_GR.next()}">We found record ${jvar_now_GR.getValue('number')}</j:when>
   <j:otherwise>Sorry, we could not find the record you specified.</j:otherwise>
</j:choose>
    when
    • Beschreibung: Der Wenn Tag wird in einem Auswahlblock verwendet, um eine Bedingung anzugeben. Dieses Tag ähnelt einem Wenn Oder Elseif In, dass eine Bedingung angegeben, der innere Inhalt ausgeführt und dann eine Pause am Ende zum Verlassen von impliziert wird Wenn-elseif Erstellen.
    • Parameter: Testen – Die auszuwertende Bedingung, um zu bestimmen, ob die Anweisung durchläuft. Dies muss ein Ausdruck sein, der in eingeschlossen ist ${} Oder $[] Die Auswertung ergibt „wahr“ oder „falsch“.
    • Beispiel: 
      <j:choose>
   <j:when test="${jvar_now_GR.getRowCount() ${AMP}lt; 1}">We found multiple records!</j:when>
   <j:when test="${jvar_now_GR.next()}">We found record ${jvar_now_GR.getValue('number')}</j:when>
   <j:otherwise>Sorry, we could not find the record you specified.</j:otherwise>
</j:choose>
    otherwise
    • Beschreibung: Der Andernfalls Tag wird in verwendet Wählen Sie aus / Wenn / Andernfalls Blockieren, und ähneln dem Sonst Oder Standard Fall.
    • Parameter: Keine
    • Beispiel: 
      <j:choose>
   <j:when test="${jvar_now_GR.getRowCount() ${AMP}lt; 1}">We found multiple records!</j:when>
   <j:when test="${jvar_now_GR.next()}">We found record ${jvar_now_GR.getValue('number')}</j:when>
   <j:otherwise>Sorry, we could not find the record you specified.</j:otherwise>
</j:choose>

    Glide-Tags

    evaluate
    • Beschreibung: Der Bewerten Tag wertet JavaScript-Code (serverseitig) aus und macht Variablen für zukünftigen Code sichtbar. Im Gegensatz zu anderen Tags wird die Bewerten Tag wertet den Inhalt innerhalb des Tags als serverseitiges JavaScript aus.

      Der Kontext ist der gleiche wie der von Skripteinbindungen im System. Andere Skripteinbindungen, globale Geschäftsregeln, GlideRecord , GlideSystem , Und Jelly-Variablen (Jelly vorangestellt. Wenn der Parameter ist Jelly="wahr" Ist festgelegt) sind verfügbar.

    • Parameter:
      • var: der Name der Variablen, die als Ergebnis des Skripts gesetzt werden soll.
      • Objekt – Wenn auf festgelegt Wahr , Das Ergebnis des Ausdrucks wird als Objekt anstelle einer primitiven Variable (Zeichenfolgen- oder Ganzzahlvariablen-Werte) behandelt.
      • jelly: Ist der Parameter auf true gesetzt, dürfen im Skript Jelly-Kontextvariablen referenziert werden.
      • expression: ein Ausdruck, der auf den in var angegebenen Wert angewendet werden soll. Der Ausdruck kann an zwei Stellen platziert werden. Zuerst kann es sich um ein Attribut auf der handeln Bewerten Tag selbst. Zum anderen kann der Inhalt zwischen öffnendem und schließendem Tag der Ausdruck sein. Die letzte Zeile des Ausdrucks ist der Wert, der an var übergeben wird.
    • Beispiel: 
      <g:evaluate var="jvar_now_GR" object="true">
  var now_GR = new GlideRecord("incident");
  now_GR.addQuery("active", "true");
  now_GR.query();
  now_GR; // this is the variable put into the variable jvar_now_GR
</g:evaluate>
      <g:evaluate var="jvar_now_GR" object="true" expression="
  var now_GR = new GlideRecord('incident');
  now_GR.addQuery('active', 'true');
  now_GR.query();
  now_GR; // this is the variable put into the variable jvar_now_GR" />
    messages
    • Beschreibung: Der Nachrichten Tag hilft bei der Übersetzung. Wenn gs.getMessage() Wird an beliebiger Stelle auf einer Seite aufgerufen. Es gibt zwei mögliche Orte, an denen die Übersetzung gefunden wird. Zuerst prüft die Seite einen lokalen Cache mit Übersetzungen. Dann sendet die Seite einen AJAX-Aufruf an den Server, um die Übersetzung von dort abzurufen. Was G:Nachrichten Ermöglicht Seiten das Zwischenspeichern bestimmter Nachrichten.
    • Parameter: Keine
    • Beispiel: 
      <g:messages>
  Yes
  No
  Cancel
</g:messages>
    breakpoint
    • Beschreibung: Wenn Haltepunkt Tag wird aufgerufen. Es wird eine Liste aller Variablen in Jelly im aktuellen Moment mit ihren jeweiligen Werten gedruckt. Ist eine bestimmte Variable angegeben, gibt das Tag die angeforderte Variable und deren Wert zurück. Die Ausgabe wird im Systemprotokoll platziert.
    • Parameter: VAR – (Optional) die Variable, für die der Wert protokolliert werden soll. Wenn VAR Ist nicht angegeben, werden alle Variablen im Protokoll abgelegt.
    • Beispiel: 
      <g:breakpoint />
      <g:breakpoint var="sysparm_view"/>
    no_escape
    • Beschreibung: Das System versieht Ausgaben als Sicherheitsmaßnahme standardmäßig mit Escape-Zeichen. Vor Ausgaben innerhalb von Tags des Typs no_escape wird kein Escape-Zeichen gesetzt. Verwenden Sie diese Tags mit Bedacht. Werden hier Benutzereingaben angezeigt, kann das zu einer Schwachstelle auf der Seite führen.
    • Parameter: Keine
    • Beispiel (Phase 1) – deaktiviert das automatische Ausgabe-Escape-Zeichen aller enthaltenen ${}-Ausdrücke: 
      <g:no_escape>
 ${jvar_raw_html_data}
</g:no_escape>
    • Beispiel (Phase 2) – Verwenden NOESC Zum Deaktivieren des Escape-Vorgangs für die angegebene Zeichenfolge. Dies bedeutet, dass der Ausdruck als Zeichenfolge ausgewertet werden muss.
      <g:no_escape>$[NOESC:jvar_expr]</g:no_escape>

      Informationen zur Bewertung der Phasen 1 und 2 finden Sie in den Jelly-Einführungsvideos, die am Anfang dieses Abschnitts aufgeführt sind.

    macro_invoke
    • Beschreibung: Der Macro_invoke Tag ruft ein UI-Makro auf, das Sie in der Datenbank angegeben haben. Sie können UI-Makros auch aufrufen, indem Sie sie im Namen des Tags angeben. Haben Sie beispielsweise ein UI-Makro namens „my_macro“, können Sie dieses Makro mit dem Tag <g:my_macro/> aufrufen. Informationen hierzu finden Sie unter UI-Makros.
    • Parameter:
      • macro: der Name des auszuführenden UI-Makros. Wenn Ihr Tag-Name lautet G:macro_invoke , Dann gibt das Makroattribut den Namen des Makros an. Wenn der Tag-Name den Namen des Makros enthält, muss kein Attribut „macro“ angegeben werden.
      • Andere Attribute: Für jedes von Ihnen angegebene Attribut ist eine Variable mit diesem Namen im Kontext des UI-Makros verfügbar, mit dem Präfix Jvar_ .
    • Beispiel: 
      <!-- Will invoke the contents of the UI macro named "sample_macro", which will have the variable jvar_message available within it-->
<g:macro_invoke macro="sample_macro" message="This is a sample macro variable." />
      <!-- Will invoke the contents of the UI macro named "sample_macro", which will have the variable jvar_message available within it-->
<g:sample_macro message="This is a sample macro variable." />
    If_polaris
    • Beschreibung: Der If_polaris Tag überprüft, ob Next Experience Ist für die aktuelle Seite aktiviert. Sie muss mindestens eines der untergeordneten Tags enthalten <g:then /> Oder G:else /> .
    • Parameter: Keine
    • Beispiel: 
      <g:if_polaris>
    <g:then><g:inline template="polaris_nav"/></g:then>
    <g:else><g:inline template="classic_nav"/></g:else>
</g:if_polaris>

<g:if_polaris>
    <g:then><a href="…">Click here to see what’s new!</a></g:then>
</g:if_polaris>

<g:if_polaris>
    <g:else>Core UI only code here!</g:else>
</g:if_polaris>
    dann
    • Beschreibung: Der Dann Tag wird in verwendet If_polaris Blockieren, um den Seiteninhalt festzulegen, wann Next Experience Ist aktiviert.
    • Parameter: Keine
    • Beispiel: 
      <g:if_polaris>
    <g:then><g:inline template="polaris_nav"/></g:then>
    <g:else><g:inline template="classic_nav"/></g:else>
</g:if_polaris>

<g:if_polaris>
    <g:then><a href="…">Click here to see what’s new!</a></g:then>
</g:if_polaris>

<g:if_polaris>
    <g:else>Core UI only code here!</g:else>
</g:if_polaris>
    sonst
    • Beschreibung: Der Sonst Tag wird in verwendet If_polaris Blockieren, um den Seiteninhalt festzulegen, wann Next Experience Ist nicht aktiviert.
    • Parameter: Keine
    • Beispiel: 
      <g:if_polaris>
    <g:then><g:inline template="polaris_nav"/></g:then>
    <g:else><g:inline template="classic_nav"/></g:else>
</g:if_polaris>

<g:if_polaris>
    <g:then><a href="…">Click here to see what’s new!</a></g:then>
</g:if_polaris>

<g:if_polaris>
    <g:else>Core UI only code here!</g:else>
</g:if_polaris>