man:man_tpl [SMSI-Demo]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Utilisation de modèles ======
L'utilisation de modèles permet de standardiser l'aspect de pages répétitives (risques, scénarios, mesures, événements, actions, etc) et de factoriser des requêtes ou des blocs de texte pour éviter de devoir modifier chacune de ces pages répétitives lorsqu'une requête évolue.

Deux mécanismes sont utilisés:
  * Des modèles chargés lors de la création de la page, qui est ensuite modifiable et ne garde pas de lien au modèle: extensions AddNewPage et NewPageTemplate
  * Des modèles évalués dynamiquement à chaque fois que la page est rechargée: extensions Templatery et StrataTemplatery

===== Modèles utilisés à la création =====
Les modèles se trouvent dans la catégorie [[scrapbook:start|scrapbook]].

Ils sont invoqués depuis la page où sont listées toutes les pages répétitives d'un type donné, au travers d'une requête telle que:
''%%{{NEWPAGE>smsi:#scrapbook:risque}}%%''

Cette requête aura pour effet de créer un champ de saisie tel que:
{{NEWPAGE>smsi:#scrapbook:risque}}

Une fois le nom de la page saisi, la page est créée et ouverte avec le contenu du modèle.

Il est fréquent qu'un modèle contienne une zone de définition de données Strata. Pour éviter que le modèle lui-même ne soit inclus dans les requêtes portant sur les pages, il contient en première ligne une directive ''%%~~NODATA~~%%'' qui empêche la prise en compte de ses données. Cette ligne doit être supprimée de l'instance nouvellement créée.

===== Modèles évalués dynamiquement =====
Les modèles se trouvent dans la catégorie [[template:start|template]].

Trois mécanismes sont utilisés:
  * L'insertion simple du contenu du modèle
  * La création de modèles portant le nom d'un type de page, comme ''doc''. En ce cas, lorsqu'un bloc de données pour ce type est rencontré, il est présenté conformément au modèle. 
  * La définition de modèles utilisés explicitement dans la présentation des résultats d'une requête Strata.
===== Exemple d'utilisation =====
Lors de la création d'un nouveau risque depuis [[smsi:liste des risques|smsi:liste des risques]], la page est prépeuplée avec le modèle [[scrapbook:risque|scrapbook:risque]].

Elle commence par une requête ''%%{{template>risk_tpl#header}}%%'', ce qui inclut le contenu du modèle header dans la page [[template:risk_tpl|template:risk_tpl]]
<code>
~~NODATA~~
<template header>
<data doc>
TypeDoc: STRUCT
Processus: RISK
</data>
<view ?grav ?vc ?cr ?t>
template {
 risk_tpl#header1
}
[[]] Gravité: ?grav
[[]] Vc: ?vc
[[]] ClasseRisque: ?cr
[[]] Traitement: ?t
</view>
</template>
</code>

Ce modèle mobilise lui-même les deux autres mécanismes.

Comme il existe un modèle associé au type ''doc'', le bloc:
<code>
<data doc>
TypeDoc: STRUCT
Processus: RISK
</data>
</code>
est soumis au modèle [[template:doc|template:doc]]

<code>
<template>
//Ce document de type @@TypeDoc[enum:::param:doc#DocType]@@  s'applique au processus @@Processus[enum:::param:doc#Proc]@@//
</template>
</code>

et présenté comme:

//Ce document de type Procédure s'applique au processus Fonctionnement SMSI//\

Par ailleurs, la requête qui récupère les caractéristiques principales du risque (gravité, vraisemblance, classe de risque et décision de traitement) utilise la directive ''view'' qui référence un modèle explicite, situé dans la même page [[template:risk_tpl]].

<code>
<view ?grav ?vc ?cr ?t>
template {
 risk_tpl#header1
}
[[]] Gravité: ?grav
[[]] Vc: ?vc
[[]] ClasseRisque: ?cr
[[]] Traitement: ?t
</view>
</code>

Ce modèle explicite [[template:risk_tpl#header1]] met en forme les résultats dans un tableau.
<code>
<template header1>
| Gravité       | @@grav[enum:::param:risk#Gravité]@@       |
| Vraisemblance | @@vc[enum:::param:risk#Vraisemblance]@@   |
| Classe        | @@cr@@                                    |
| Traitement    | @@t[enum:::param:risk#Trisk]@@            |
</template>
</code>

Donnant un résultat tel que:
| Gravité       | Critique       |
| Vraisemblance | Probable       |
| Classe        | Prioritaire    |
| Traitement    | Réduire        |