LoopOptions

Vous pouvez passer en revue les détails concernant la balise JSP loopOptions.

Descriptif

La balise JSP loopOptions génère les options associées à la balise HTML select.

Attributs

binding - Obligatoire. Chaîne de liaison qui pointe vers l'élément de répétition de la sortie de l'API. L'élément de répétition doit être préfixé par un arobase ("@").

name -Facultatif. Nom d'attribut contenu dans l'élément de liaison utilisé pour la description affichée dans la balise option. S'il n'est pas transmis, la valeur par défaut est name, ce qui signifie que la recherche d'un attribut appelé nom est effectuée.

value -Facultatif. Nom d'attribut contenu dans l'élément de liaison utilisé pour l'attribut de valeur de la balise option. Si ce paramètre n'est pas transmis, la valeur par défaut value est utilisée ; cela signifie que l'application recherche un attribut appelé "value".

selected - facultatif. Chaîne de liaison qui doit être évaluée et définie comme valeur sélectionnée par défaut. Ce paramètre est associé à l'attribut de valeur et non pas à l'attribut de description. Sa valeur par défaut est un blanc (" ").

isLocalized - Facultatif. Si ce paramètre est transmis avec la valeur Y, il récupère la description localisée en fonction des paramètres régionaux de l'utilisateur à partir de la table YFS_LOCALIZED_STRINGS.

targetBinding - Facultatif. Si la liaison cible de la balise select est différente de la liaison source, vous devez indiquer la liaison cible comme entrée lorsque vous utilisez la fonction loopOptions. Cela garantit que les données entrées par l'utilisateur final ne seront pas perdues si l'API génère une exception.

Corps

Néant.

Exemples

L'exemple suivant montre comment les types de requête ("est", "commence par" et "contient") sont affichés dans une balise select à partir de la sortie d'une API.

<td nowrap="true" class="searchcriteriacell" >
   <select name="xml:/Item/@ItemIDQryType" class="combobox" >
      <yfc:loopOptions 
binding="xml:/QueryTypeList/StringQueryTypes/@QueryType" 
name="QueryTypeDesc" value="QueryType" selected="xml:/Item/@ItemIDQryType"/>
   </select>
   <input type="text" class="unprotectedinput" 
<%=getTextOptions("xml:/Item/@ItemID") %> />
</td>

Dans cet exemple, des zones de liste déroulante sont utilisées dans une liste modifiable :

Un caractère de soulignement ("_") et un compteur doivent être ajoutés à l'attribut de nom de l'élément select.
Le nom du compteur correspond à la valeur de l'attribut ID indiqué dans la balise loopXML. L'attribut ID doit toujours être défini sur la valeur du nom du noeud enfant sur lequel souhaitez effectuer la boucle.

<select name="xml:/Order/Instructions/Instruction_
<%=InstructionCounter%>/@InstructionType" class="combobox"> 
   <yfc:loopOptions binding="xml:InstructionTypeList:/CommonCodeList/
@CommonCode" name="CodeShortDescription" value="CodeValue"
selected="xml:/Instruction/@InstructionType"/> 
</select>