Amélioration présentation page de configuration des champs obligatoires

v5.3.5-3.7.9

Amélioration présentation page de configuration des champs obligatoires
v5.3.5-3.7.9
Etienne Pallier
1 parent 59d86a3b
Showing 7 changed files with 86 additions and 16 deletions Show diff stats
CHANGELOG
README.md
config/app_labinvent_mandatory_fields.default.yml
doc/LabInvent_Config.pdf
doc/LabInvent_Config_champs_obligatoires.pdf
src/Template/ConfigurationFields/edit.ctp
src/Template/Pages/changes.ctp
@@ -13,11 +13,12 @@ CHANGEMENTS
 -------
-03/11/2021 NEWS#6 (v5.2.22) :
+22/11/2021 NEWS#6 (v5.3.4) :
+
+- Champs obligatoires, modifiables, et readonly, désormais configurables via page web
 - Domaines, Catégories, et Sous-Catégories enfin gérables plus facilement
-(TODO) - Champs obligatoires, modifiables, et readonly, désormais configurables via page web
 -------
@@ -501,6 +502,18 @@ Warning (2): Cannot modify header information - headers already sent by (output 
 TODO :
+- besoin IP2I/LMA :
+=> restreindre l’accès de certains équipements du LMA aux utilisateurs du LMA seulement et qu'ils ne soient pas visibles ou consultables par tous les utilisateurs IP2I
+=> Implémentation possible :
+2 possibilités :
+	- Définir LMA dans la liste des "Sites" => mais ça correspond pas vraiment à la notion de site = lieu géographique
+	- Ajouter une nouvelle notion de "Département" 
+- Associer les matériels sensibles à ce Site (ou Dépt), et cocher la case "materiel sensible"
+- Associer les utilisateurs du LMA à ce Site (ou Dépt)
+=> Régle : les matériels sensibles ne sont vus que par les utilisateurs du même Site (ou Dépt) (ici LMA) :
+	- pour materiels/view(/edit/delete) => le user courant ne peut pas voir un materiel "sensible" qui n'est pas du même Site (Dépt) que lui
+	- pour materiels/index et /find et /export => il faut exclure les matos "sensibles" qui ne sont pas du même site que le user courant
+	- materiels/index : on peut ajouter un filtre "Site" (et Dépt), et un filtre "tous/matos sensible/matos non sensible"
 - add_or_edit() générique
@@ -604,6 +617,10 @@ Ne pas autoriser la commande via url si le bouton order est désactivé dans la 
 ======= CHANGES =======
 -------
+23/11/2021	v5.3.5-3.7.9
+	- (e) Amélioration de la présentation de la page de configuration des champs obligatoires
+
+-------
 22/11/2021	v5.3.4-3.7.9
 	- (b) Bugfix : Bouton "Commander" ne doit pas être affiché si désactivé dans la config
 	- (b) Bugfix : commentaires des sections (fieldsets) pas sauvegardés après une modif de la config champs obligatoires
@@ -53,7 +53,7 @@ Logiciel testé et validé sur les configurations suivantes :
 --------------------------------------------------------------------------------------------
 Date: 22/11/2021	
-Version: v5.3.4-3.7.9
+Version: v5.3.5-3.7.9
 HISTORIQUE DES CHANGEMENTS DE VERSION : voir le fichier CHANGES.txt (ou la page web /pages/changes)
@@ -5,7 +5,7 @@ MANDATORY_AND_READONLY_FIELDS:
         HAS_ORDER_BUTTON: { selected: '1', comment: 'Ajouter un bouton COMMANDE sur la fiche matériel ?' } }
     UNEDITABLE_FIELDS: { 
-        fieldset_comment: Champs non modifiables,
+        fieldset_comment: Champs non modifiables dès le début,
         designation: { selected: '0', comment: Désignation, except_roles: '' }, 
         description: { selected: '0', comment: 'Description, commentaire explicatif', except_roles: '' }, 
         nom_responsable: { selected: '1', comment: 'nom du responsable', except_roles: [Responsable, Administration] }, 
@@ -34,7 +34,7 @@ MANDATORY_AND_READONLY_FIELDS:
     # LOT 1 - Demamnde d'Achat (Commande)
     MANDATORY_FIELDS_FOR_LOT1: {
-        fieldset_comment: Champs obligatoires pour passer la COMMANDE,
+        fieldset_comment: 'Champs obligatoires pour passer la COMMANDE, en plus du LOT 0',
         organisme_id: { selected: '1', comment: Organisme, except_roles: '' }, 
         prix_ht: { selected: '1', comment: 'Prix HT', except_roles: '' }, 
         resp_credit: { selected: '1', comment: 'Responsable du crédit', except_roles: '' }, 
@@ -44,7 +44,7 @@ MANDATORY_AND_READONLY_FIELDS:
         DOC_DEVIS: { selected: '1', comment: Devis, except_roles: '' } }
     UNEDITABLE_FIELDS_AFTER_LOT1: {
-        fieldset_comment: Champs non modifiables après avoir passé la COMMANDE,
+        fieldset_comment: 'Champs non modifiables après avoir passé la COMMANDE, en plus du LOT 0',
         sur_categorie_id: { selected: '1', comment: 'Domaine', except_roles: [Administration] }, categorie_id: { selected: '1', comment: '', except_roles: [Administration] }, 
         resp_credit: { selected: '1', comment: 'Responsable du crédit', except_roles: [Administration] }, 
         gestionnaire_id: { selected: '1', comment: 'Gestionnaire de référence', except_roles: [Administration] }, 
@@ -56,14 +56,14 @@ MANDATORY_AND_READONLY_FIELDS:
         DOC_BC: { selected: '1', comment: 'BC joint', except_roles: [Administration] } }
     RECOMMENDED_FIELDS_AFTER_LOT1: { 
-        fieldset_comment: Champs non obligatoires mais recommandés après avoir passé la COMMANDE,
+        fieldset_comment: 'Champs non obligatoires mais recommandés après avoir passé la COMMANDE, en plus du LOT 0',
         etiquette: { selected: '0', comment: 'd''imprimer l''étiquette associée et de la coller sur le matériel', except_roles: '' }, numero_inventaire_organisme: { selected: '0', comment: 'de renseigner le champ ''N° inventaire comptable/tutelles _Organisme_''', except_roles: '' }, DOC_BC: { selected: '0', comment: 'd''ajouter le Bon de Commande', except_roles: '' }, DOC_BL: { selected: '0', comment: 'd''ajouter le Bon de Livraison', except_roles: '' }, DOC_FACTURE: { selected: '0', comment: 'd''ajouter la Facture', except_roles: '' } }
     # LOT 2 - Validation, Livraison (matériel livré et payé) 
     MANDATORY_FIELDS_FOR_LOT2: {
-        fieldset_comment: Champs obligatoires pour valider la livraison,
+        fieldset_comment: 'Champs obligatoires pour valider la livraison, en plus du LOT 1',
         date_acquisition: { selected: '1', comment: 'Date d''achat', except_roles: '' }, 
         date_reception: { selected: '1', comment: 'Date de livraison', except_roles: '' }, 
         site_id: { selected: '1', comment: Site, except_roles: '' }, 
@@ -73,7 +73,7 @@ MANDATORY_AND_READONLY_FIELDS:
         DOC_DEVIS: { selected: '1', comment: 'Devis joint', except_roles: '' } }
     UNEDITABLE_FIELDS_AFTER_LOT2: {
-        fieldset_comment: Champs non modifiables après validation de la livraison,
+        fieldset_comment: 'Champs non modifiables après validation de la livraison, en plus du LOT 1',
         sur_categorie_id: { selected: '1', comment: 'Domaine', except_roles: '' }, 
         categorie_id: { selected: '1', comment: 'Catégorie', except_roles: '' }, 
         date_acquisition: { selected: '1', comment: 'Date de commande', except_roles: '' }, 
@@ -85,7 +85,7 @@ MANDATORY_AND_READONLY_FIELDS:
         DOC_FACTURE: { selected: '1', comment: 'Facture jointe', except_roles: '' } }
     RECOMMENDED_FIELDS_AFTER_LOT2: { 
-        fieldset_comment: Champs non obligatoires mais recommandés après validation de la livraison,
+        fieldset_comment: 'Champs non obligatoires mais recommandés après validation de la livraison, en plus du LOT 1',
         etiquette: { selected: '1', comment: 'd''imprimer l''étiquette associée et de la coller sur le matériel', except_roles: '' }, 
         numero_inventaire_organisme: { selected: '1', comment: 'de renseigner le champ ''N° inventaire comptable/tutelles _Organisme_''', except_roles: '' },
         numero_serie: { selected: '0', comment: 'de renseigner le numéro de série du matériel', except_roles: '' }, 
@@ -33,6 +33,7 @@ $icon = $READONLY ? &#39;&#39; : &quot;&lt;i class=&#39;icon-edit&#39;&gt;&lt;/i&gt;&quot;;
 //$title = "Configuration des champs obligatoires ou non modifiables de la fiche Matériel $end";
 $title = "Configuration des champs obligatoires ou non modifiables de la fiche Matériel";
 echo "<br><h2>$icon $title</h2><br>";
+
 /*
     Autres icones possibles :
 echo "<br><h2><i class='icon-edit'></i> $title</h2><br><br>";
@@ -41,13 +42,61 @@ echo &quot;&lt;br&gt;&lt;h2&gt;&lt;i class=&#39;icon-plus&#39;&gt;&lt;/i&gt; $title&lt;/h2&gt;&lt;br&gt;&lt;br&gt;&quot;;
 echo "<br><h2><i class='icon-pencil'></i> $title</h2><br><br>";
 echo "<br><h2><i class='icon-trash'></i> $title</h2><br><br>";
 */
-
-if ($READONLY && $CAN_EDIT) {
-    $this->MyHelper->echoEditButton();
-    $this->MyHelper->echoButtonForAction('icon-trash', 'reset-to-default', 'Remettre les valeurs par défaut', 'Remettre les valeurs par défaut', true);
-    echo '<br><br>';
+function echo_buttons($READONLY, $CAN_EDIT, $helper) {
+    if ($READONLY && $CAN_EDIT) {
+        echo "<table><tr>";
+            echo "<td>"; 
+                $helper->echoEditButton(); 
+            echo "</td>"; 
+            echo "<td>"; 
+                $helper->echoButtonForAction('icon-trash', 'reset-to-default', 'Remettre les valeurs par défaut', 'Remettre les valeurs par défaut', true);
+            echo "</td>";
+        echo "</tr></table>";
+    }
 }
+echo_buttons($READONLY, $CAN_EDIT, $this->MyHelper);
+
+?>
+
+<div id="Présentation">
+
+<p>
+Cette page vous permet de configurer les <b>champs obligatoires, recommandés, et/ou readonly de la fiche matériel</b>, ce qui vous permet de customiser le comportement de ce logiciel selon vos besoins.
+</p>
+
+<p>
+Il vous suffit de cocher/décocher les champs qui sont obligatoires (ou recommandés, ou readonly) à chaque étape (aussi appelée LOT) :
+<ul>
+    <li>(LOT-0) pour <b>créer</b> la fiche</li>
+
+	<li>(LOT-1) pour <b>commander</b> un matériel (demande d'achat) : cette étape est optionnelle et désactivable (via cette même page web)</li>
+
+	<li>(LOT-2) pour <b>valider</b> un matériel (le déclarer payé et livré)</li>
+</ul>
+</p>
+
+</p>
+En plus de définir les champs obligatoires, vous pouvez aussi définir :
+<ul>
+	<li>les champs <b>readonly</b>, qui ne sont plus modifiables APRÈS chaque étape</li>
+	<li>les champs qui ne sont pas obligatoires mais <b>recommandés</b> APRÈS chaque étape : si un de ces champs n'est pas rempli après l'étape, un message de rappel est affiché sur la fiche détaillée du matériel pour inciter à remplir ce champ (mais sans obligation, juste un rappel systématique)</li>
+</ul>
+<br>
+
+<p>
+Enfin, si vous avez fait une erreur et voulez <b>revenir à la configuration par défaut</b>, pas de panique, il suffit de cliquer sur le bouton 'Remettre les valeurs par défaut'.
+</p>
+<br>
+<hr>
+<br>
+
+</div>
+
+
+<?php
+
+
 //echo $this->Html->icon('pencil');
 echo $this->Form->create($contact);
@@ -175,5 +224,6 @@ echo $this-&gt;Form-&gt;create($contact);
 echo $this->Form->end();
-if ($READONLY && $CAN_EDIT) $this->MyHelper->echoEditButton();
+echo_buttons($READONLY, $CAN_EDIT, $this->MyHelper);
+//if ($READONLY && $CAN_EDIT) $this->MyHelper->echoEditButton();
@@ -78,9 +78,12 @@ $line = &#39;&#39;; while ($line != SECTION_NEWS) $line = fgets($f);
 // 2) Lecture et affichage section NEWS (les grandes nouveautés)
+echo '<br>';
 echo '<a id="news">';
 echo "<h3>LES GRANDS CHANGEMENTS (NEWS)</h3>";
 echo '</a>';
+echo '<br>';
+
 // On zappe jqa la première section
 $line = ''; while ($line != NEW_BLOCK) $line = fgets($f);
 while(!feof($f)) {