Regardez ces vidéos d’introduction pour en savoir plus sur l’utilisation de Jelly dans le Now Platformdomaine .

Balises Jelly

if

• Description : La balise if est exactement ce à quoi elle ressemble, une balise if . C’est comme une instruction if dans n’importe quel langage de programmation, mais gardez à l’esprit qu’il n’y a pas de balise elseif et pas de balise else . Si vous voulez créer ce genre de structure, essayez la syntaxe choose/when/otherwise .
• Paramètres : test : condition à évaluer afin de déterminer si le bloc s’exécutera.
• Exemple :

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

Tandis que

• Description : La balise while fait une boucle while.
• Paramètres : test : condition à évaluer afin de déterminer si l’instruction va boucler. Il doit s’agir d’une expression entourée de ${} ou $[] qui équivaut à true ou false.
• Exemple :

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

définir

• Description : la balise set définit une variable.
• Paramètres :
  • var - La variable à définir. Souvent, le système préfixe ces variables avec jvar_ par souci de cohérence.
  • value - valeur à laquelle définir var . Il s’agit souvent d’une expression entourée de ${} ou $[].
  • defaultValue : si la valeur renvoie null ou vide, cette valeur est placée dans la variable.
• Exemple :

  <j:set var="jvar_incident_number" value="${jvar_now_GR.getValue('number')}"/>

set_if

• Description : la balise set_if définit une variable basée sur un test. Cette balise est similaire à l’opérateur ternaire dans d’autres langages de programmation (var = <test> ? <if_true> : <if_false>).
• Paramètres :
  • var - La variable à définir. Souvent, le système préfixe ces variables avec jvar_ par souci de cohérence.
  • test : condition à évaluer afin de déterminer si l’instruction évaluera la valeur vraie ou la valeur fausse. Il doit s’agir d’une expression entourée de ${} ou $[] qui équivaut à true ou false.
  • vrai : valeur à prendre pour la variable si le test donne la valeur vrai. Comme ce paramètre est facultatif, si le champ est vide et que test est défini sur true, la variable est laissée vide.
  • false : valeur sur laquelle définir la variable si le test évalue sur false. Ce paramètre est facultatif, donc si le champ est vide et si test est évalué sur false, la variable sera laissée vide.

Choisir

• Description : La balise choose démarre un bloc de code choose. Ceci est similaire au type de syntaxe if-elseif-else dans la plupart des langages de programmation. Avec une balise choose , vous pouvez utiliser des balises when et otherwise pour spécifier d’autres blocs de code.
• Paramètres : Aucun
• Exemple :

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

Quand

• Description : la balise when est utilisée dans un bloc choose pour indiquer une condition. Cette balise est similaire à un if ou à un elseif en ce sens qu’elle spécifie une condition, exécute le contenu interne, puis implique une pause à la fin pour quitter la construction if-elseif .
• Paramètres : test : condition à évaluer afin de déterminer si l’instruction va boucler. Il doit s’agir d’une expression entourée de ${} ou $[] qui équivaut à true ou false.
• Exemple :

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

Sinon

• Description : La balise else est utilisée dans un bloc choose/when/otherwise , et est similaire à la casse else ou default .
• Paramètres : Aucun
• Exemple :

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

Balises Glide

Évaluer

• Description : la balise evaluate évalue le code JavaScript (côté serveur) et rend les variables visibles pour le code futur. Contrairement à d’autres balises, la balise evaluate évalue le contenu qui se trouve à l’intérieur de la balise en tant que JavaScript côté serveur.

  Le contexte est le même que celui des script includes dans le système. D’autres script includes, des règles métier globales, des variables GlideRecord, GlideSystem et Jelly (précédées de Jelly si le paramètre jelly="true » est défini) sont disponibles.

• Paramètres :
  • var : nom de la variable qui sera définie sur le résultat du script.
  • objet : si vrai, le résultat de l’expression est traité comme un objet et non comme une variable primitive (valeurs variables de chaîne ou entier).
  • Jelly : si la valeur est définie sur vrai, les variables de contexte Jelly peuvent être référencées dans le script.
  • expression - Il s’agit d’une expression à exécuter pour la valeur à mettre dans var. L’expression peut être à l’un des deux endroits. Tout d’abord, il peut s’agir d’un attribut sur la balise evaluate elle-même. Sinon, le contenu entre la balise de début et la balise de fin correspond à l’expression. La dernière ligne de l’expression est la valeur réelle passée en var.
• Exemple :

  <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

• Description : La balise messages facilite la traduction. Lorsque gs.getMessage() est appelé n’importe où sur une page, il y a deux endroits possibles où la traduction se trouve. Tout d’abord, la page vérifie un cache local de traductions. Deuxièmement, la page effectue un appel AJAX au serveur pour trouver la traduction. Ce que fait g :messages, c’est permettre aux pages de mettre en cache certains messages.
• Paramètres : Aucun
• Exemple :

  <g:messages>
    Yes
    No
    Cancel
  </g:messages>

Breakpoint

• Description : lorsque la balise de point d’arrêt est appelée, elle affiche une liste de toutes les variables de Jelly au moment présent, avec leurs valeurs respectives. Si une variable est spécifiée, elle affiche la variable demandée et sa valeur. La sortie est placée dans le journal système.
• Paramètres : var - (Facultatif) Variable pour laquelle journaliser la valeur. Si var n’est pas spécifié, toutes les variables sont vidées dans le journal.
• Exemple :

  <g:breakpoint />

  <g:breakpoint var="sysparm_view"/>

no_escape

• Description : le système, par défaut, utilise la sortie échappée comme mesure de sécurité. La sortie placée à l’intérieur de no_escape balises n’est pas échappée avant la sortie. Soyez prudent lorsque vous utilisez ces balises, car si l’entrée de l’utilisateur est affichée ici, une faille de sécurité peut apparaître sur la page.
• Paramètres : Aucun
• Exemple (phase 1) – Désactive l’échappement automatique de sortie de toutes les expressions ${} contenues :

  <g:no_escape>
   ${jvar_raw_html_data}
  </g:no_escape>

• Exemple (phase 2) – Utilisez NOESC pour désactiver l’échappement pour la chaîne spécifiée. Cela implique que l’expression doit être évaluée à une chaîne de caractères.

  <g:no_escape>$[NOESC:jvar_expr]</g:no_escape>

  Pour plus d’informations sur les phases 1 et 2 de l’évaluation, reportez-vous aux vidéos d’introduction de Jelly répertoriées au début de cette section.

macro_invoke

• Description : la balise macro_invoke appelle une macro d’interface utilisateur que vous avez spécifiée dans la base de données. Vous pouvez également appeler une macro d’interface utilisateur en le spécifiant dans le nom de la balise. Par exemple, si vous aviez une macro d’interface utilisateur nommée my_macro, vous pouvez l’appeler avec la balise <g :my_macro/>. (pour en savoir plus, consultez Macros d'interface utilisateur) ;
• Paramètres :
  • macro : nom de la macro d’interface utilisateur à exécuter. Si le nom de votre balise est g :macro_invoke, l’attribut macro spécifie le nom de la macro. Si le nom de la balise inclut le nom de la macro, il n’est pas nécessaire d’inclure un attribut de macro.
  • Autres attributs : pour chaque attribut que vous spécifiez, une variable portant ce nom sera disponible dans le contexte de la macro d’interface utilisateur, précédée de jvar_.
• Exemple :

  <!-- 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

• Description : la balise if_polaris vérifie si Next Experience elle est activée pour la page actuelle. Il doit inclure au moins une des balises enfants <g :then /> ou g :else />.
• Paramètres : Aucun
• Exemple :

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

puis

• Description : la balise then est utilisée dans un bloc if_polaris pour définir le contenu de la page lorsqu’elle Next Experience est activée.
• Paramètres : Aucun
• Exemple :

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

sinon

• Description : la balise else est utilisée dans un bloc if_polaris pour définir le contenu de la page lorsqu’elle Next Experience n’est pas activée.
• Paramètres : Aucun
• Exemple :

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