SmartDoc/Blocs : Différence entre versions

De YoWiki
Sauter à la navigation Sauter à la recherche
 
(9 révisions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
<h1 id="les-blocs">Les blocs</h1>
+
<h1 id="les-blocs">Principe d'utilisation et intérêt</h1>
 
<p>Les blocs sont utilisés dans le paramétrage des [[SmartDoc]] et ont pour atout de simplifier considérablement ce processus de paramétrage.</p>
 
<p>Les blocs sont utilisés dans le paramétrage des [[SmartDoc]] et ont pour atout de simplifier considérablement ce processus de paramétrage.</p>
<p><strong>Les blocs permettent d&#39;appliquer le même traitement à un ensemble de cellules, plutôt que d&#39;appliquer le même traitement individuellement à plusieurs cellules.</strong></p>
+
<p><strong>Les blocs permettent d&#39;appliquer le même traitement à un ensemble d'[[Élément_de_contenu|éléments de contenus]], plutôt que d&#39;appliquer le même traitement individuellement à plusieurs [[Élément_de_contenu|éléments de contenu]].</strong></p>
 
<p><strong>Par exemple :</strong></p>
 
<p><strong>Par exemple :</strong></p>
 
<p>
 
<p>
Ligne 7 : Ligne 7 :
 
</p>
 
</p>
 
<blockquote>
 
<blockquote>
<p>Ici, toutes les cellules qui décrivent le fonctionnement du CSSCT n&#39;apparaîtront que si la condition du bloc est remplie, à savoir avoir plus de 300 salariés (le CSSCT est alors obligatoire !) ou accepter de mettre en place un CSSCT.</p>
+
<p>Ici, toutes les cellules qui décrivent le fonctionnement du CSSCT n&#39;apparaîtront que si la condition du bloc est remplie, à savoir avoir plus de 300 salariés (car, en pratique, le CSSCT devient obligatoire) ou accepter de mettre en place un CSSCT.</p>
<p>Rien n&#39;empêche, une fois à l&#39;intérieur d&#39;un bloc, de conditionner encore plus particulièrement certaines cellules. Ou encore de mettre en place un bloc à l&#39;intérieur d&#39;un bloc.</p>
+
<p>Rien n&#39;empêche, une fois à l&#39;intérieur d&#39;un bloc, de conditionner encore plus particulièrement certaines cellules. Ou encore de mettre en place un bloc à l&#39;intérieur d&#39;un bloc (imbrication).</p>
 
</blockquote>
 
</blockquote>
<p>Ce &quot;traitement en bloc&quot; est particulièrement utile pour mettre en place les [[Boucles]] ainsi que les [[Conditions|Visible if]]</p>
+
<p>Ce &quot;traitement en bloc&quot; est particulièrement utile pour mettre en place les [[Boucles]] ainsi que les [[Conditions|Visible if]].</p>
<h2 id="mettre-en-place-des-blocs">Mettre en place des blocs</h2>
+
<p>Les Blocs sont aussi utilisés pour délimiter les parties d'un [[SmartDoc]] à [[Docx-template#Principe_des_injects_dans_un_docx-template|injecter]] dans un [[Docx-template]].</p>
<h3 id="ouvrir-son-bloc">Ouvrir son bloc</h3>
+
<h1 id="mettre-en-place-des-blocs">Mise en place des blocs</h2>
 +
<h2 id="ouvrir-son-bloc">Ouvrir son bloc</h3>
 
<p>Pour identifier le début du bloc, on crée une nouvelle ligne dont le champ &quot;Contenu&quot; doit être rempli comme suit : #NOMDUBLOC
 
<p>Pour identifier le début du bloc, on crée une nouvelle ligne dont le champ &quot;Contenu&quot; doit être rempli comme suit : #NOMDUBLOC
 
[[Fichier:Debut de bloc.png|thumb|none|1200px|Début d'un bloc]]
 
[[Fichier:Debut de bloc.png|thumb|none|1200px|Début d'un bloc]]
 
</p>
 
</p>
<h3 id="configurer-son-bloc">Configurer son bloc</h3>
+
<h2 id="configurer-son-bloc">Configurer son bloc</h3>
<p>Cette première ligne est aussi celle où il faut définir le traitement qui sera appliqué à l&#39;ensemble du bloc.</p>
+
<p>Cette première ligne est aussi celle où il faut éventuellement définir le traitement qui sera appliqué à l&#39;ensemble du bloc.</p>
 
<p><strong>Par exemple, pour un bloc conditionnel :</strong>
 
<p><strong>Par exemple, pour un bloc conditionnel :</strong>
 
[[Fichier:Début bloc cdt.png|thumb|none|1200px|Début d'un bloc conditionnel]]
 
[[Fichier:Début bloc cdt.png|thumb|none|1200px|Début d'un bloc conditionnel]]
 
Le système ne s&#39;intéressera à ce qui se trouve à l&#39;intérieur du bloc que si la variable &quot;NOMBREDESALARIES&quot; est supérieure ou égale à 300, ou bien si on répond &quot;OUI&quot; à la variable &quot;MISEENPLACECSSCT&quot;.</p>
 
Le système ne s&#39;intéressera à ce qui se trouve à l&#39;intérieur du bloc que si la variable &quot;NOMBREDESALARIES&quot; est supérieure ou égale à 300, ou bien si on répond &quot;OUI&quot; à la variable &quot;MISEENPLACECSSCT&quot;.</p>
<p><strong>Par exemple pour un répéteur :</strong>
+
<p><strong>Par exemple, pour un répéteur :</strong>
 
[[Fichier:Ex répéteur.png|frame|none|L'exemple du répéteur]]
 
[[Fichier:Ex répéteur.png|frame|none|L'exemple du répéteur]]
 
Le système répétera ce qui se situe entre les deux blocs autant de fois que nécessaire.</p>
 
Le système répétera ce qui se situe entre les deux blocs autant de fois que nécessaire.</p>
<h3 id="fermer-son-bloc">Fermer son bloc</h3>
+
<h2 id="fermer-son-bloc">Fermer son bloc</h3>
 
<p>Il faut ensuite fermer son bloc en créant une ligne comme suit : #ENDBLOC NOMDUBLOC
 
<p>Il faut ensuite fermer son bloc en créant une ligne comme suit : #ENDBLOC NOMDUBLOC
 
[[Fichier:Fin de bloc.png|frame|none|Fermer un bloc]]
 
[[Fichier:Fin de bloc.png|frame|none|Fermer un bloc]]
 
</p>
 
</p>

Version actuelle datée du 28 août 2020 à 13:20

Principe d'utilisation et intérêt

Les blocs sont utilisés dans le paramétrage des SmartDoc et ont pour atout de simplifier considérablement ce processus de paramétrage.

Les blocs permettent d'appliquer le même traitement à un ensemble d'éléments de contenus, plutôt que d'appliquer le même traitement individuellement à plusieurs éléments de contenu.

Par exemple :

Blocs cssct.png

Ici, toutes les cellules qui décrivent le fonctionnement du CSSCT n'apparaîtront que si la condition du bloc est remplie, à savoir avoir plus de 300 salariés (car, en pratique, le CSSCT devient obligatoire) ou accepter de mettre en place un CSSCT.

Rien n'empêche, une fois à l'intérieur d'un bloc, de conditionner encore plus particulièrement certaines cellules. Ou encore de mettre en place un bloc à l'intérieur d'un bloc (imbrication).

Ce "traitement en bloc" est particulièrement utile pour mettre en place les Boucles ainsi que les Visible if.

Les Blocs sont aussi utilisés pour délimiter les parties d'un SmartDoc à injecter dans un Docx-template.

Mise en place des blocs

Ouvrir son bloc

Pour identifier le début du bloc, on crée une nouvelle ligne dont le champ "Contenu" doit être rempli comme suit : #NOMDUBLOC

Début d'un bloc

Configurer son bloc

Cette première ligne est aussi celle où il faut éventuellement définir le traitement qui sera appliqué à l'ensemble du bloc.

Par exemple, pour un bloc conditionnel :

Début d'un bloc conditionnel

Le système ne s'intéressera à ce qui se trouve à l'intérieur du bloc que si la variable "NOMBREDESALARIES" est supérieure ou égale à 300, ou bien si on répond "OUI" à la variable "MISEENPLACECSSCT".

Par exemple, pour un répéteur :

L'exemple du répéteur

Le système répétera ce qui se situe entre les deux blocs autant de fois que nécessaire.

Fermer son bloc

Il faut ensuite fermer son bloc en créant une ligne comme suit : #ENDBLOC NOMDUBLOC

Fermer un bloc