L'instruction template permet d'insérer un template interne ou externe, suivant la forme de l'attribut "file". L'instruction est remplacée par la valeur du template, une fois cette valeur à son tour résolue pour éliminer toute balise DIML.
file : désigne le template à insérer. Cet attribut admet deux formes distinctes, suivant que le template est déjà chargé en mémoire ou non. Un template déclaré dans le même fichier que l'appel est en mémoire implictement. Un template écrit dans un autre fichier n'est en mémoire que si une précédente instruction template l'a déjà appelé, ou si ce template a été importé
Un appel à un template local (syntaxe 1) est sensible à la casse.
Un appel à un template externe (syntaxe 2) comporte une description du fichier externe (avant le #). Le chemin est un chemin physique qui peut être absolu, ou relatif (conformément au système d'exploitation local) par rapport à la position du fichier DIML contenant l'instruction.
iterate : L'attribut iterate indique que l'appel est itératif. iteration est un entier positif non nul qui indique le nombre de répétitions du template. Un appel itératif invoque le mécanisme d'indexation automatique du DIML. Si l'attribut iterate est omis, l'appel est scalaire.
On notera les équivalences suivantes lorsque le template TEMPL est local :
<%template file="TEMPL" %> |
<%%TEMPL%%> |
<%template file="TEMPL" iterate=2 %> |
<%%TEMPL[2]%%> |
|