Developpement

Version 389 (Etienne Pallier, 06/29/2017 02:43 pm)

1 150 Etienne Pallier
h1. Labinvent 2 (cakephp3) - Développement
2 1 Etienne Pallier
3 148 Etienne Pallier
Cette page décrit le processus de développement du logiciel, ainsi que les outils utilisés.
4 148 Etienne Pallier
5 148 Etienne Pallier
[ [[Labinvent_nouvelle_version|Retour au sommmaire]] ]
6 148 Etienne Pallier
7 1 Etienne Pallier
8 1 Etienne Pallier
{{toc}}
9 1 Etienne Pallier
10 1 Etienne Pallier
---
11 1 Etienne Pallier
12 4 Etienne Pallier
h2. LIENS UTILES
13 94 Etienne Pallier
14 254 Etienne Pallier
* *DEMANDES (TODO LIST) : https://projects.irap.omp.eu/projects/inventirap/issues?query_id=222*
15 250 Etienne Pallier
16 251 Etienne Pallier
* *ROADMAP (VERSIONS) : https://projects.irap.omp.eu/projects/inventirap/roadmap?utf8=%E2%9C%93&tracker_ids%5B%5D=1&tracker_ids%5B%5D=2&tracker_ids%5B%5D=4&tracker_ids%5B%5D=5&tracker_ids%5B%5D=6&tracker_ids%5B%5D=7&tracker_ids%5B%5D=8&tracker_ids%5B%5D=9&with_subprojects=0&with_subprojects=1#version_2.5.x*
17 250 Etienne Pallier
18 252 Etienne Pallier
* Version numbering : http://semver.org
19 252 Etienne Pallier
20 97 Etienne Pallier
* HOWTO Format Redmine Wiki : http://www.redmine.org/projects/redmine/wiki/FrRedmineWikiFormatting
21 94 Etienne Pallier
22 96 Etienne Pallier
* [[Installation|Page wiki pour l'installation]]
23 1 Etienne Pallier
24 93 Etienne Pallier
* Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
25 93 Etienne Pallier
26 92 Etienne Pallier
* Liste complète des évolutions: https://gitlab.irap.omp.eu/epallier/labinvent/commits/master
27 1 Etienne Pallier
28 92 Etienne Pallier
* Browse files (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
29 1 Etienne Pallier
30 92 Etienne Pallier
* Inventirap 1.3 (prod): https://inventirap.irap.omp.eu
31 1 Etienne Pallier
32 92 Etienne Pallier
* Inventirap 1.3 (test): https://inventirap-test.irap.omp.eu/
33 92 Etienne Pallier
34 309 Etienne Pallier
* *CakePhp*:
35 1 Etienne Pallier
36 92 Etienne Pallier
 * ROADMAP: https://github.com/cakephp/cakephp/wiki
37 380 Etienne Pallier
 * *Migrations* plugin: http://book.cakephp.org/3.0/fr/migrations.html
38 310 Etienne Pallier
 * *CONVENTIONS*: https://book.cakephp.org/3.0/fr/intro/conventions.html
39 382 Etienne Pallier
 * Déploiement : https://book.cakephp.org/3.0/fr/deployment.html
40 93 Etienne Pallier
 * Forum cakephp: http://discourse.cakephp.org
41 381 Etienne Pallier
 * Debug Kit : https://book.cakephp.org/3.0/fr/debug-kit.html
42 93 Etienne Pallier
 * Quickstart tutorial: http://book.cakephp.org/3.0/en/quickstart.html
43 1 Etienne Pallier
 * Bookmarker tutorial: https://github.com/cakephp/bookmarker-tutorial
44 93 Etienne Pallier
 * Cakephp CRUD: https://github.com/FriendsOfCake/crud
45 380 Etienne Pallier
 * Plugin Chronos pour gérer les dates plus facilement : https://book.cakephp.org/3.0/fr/chronos.html
46 1 Etienne Pallier
47 1 Etienne Pallier
---
48 1 Etienne Pallier
49 363 Etienne Pallier
h2. CONVENTIONS CAKEPHP
50 1 Etienne Pallier
51 363 Etienne Pallier
https://book.cakephp.org/3.0/fr/intro/conventions.html
52 1 Etienne Pallier
53 363 Etienne Pallier
54 374 Etienne Pallier
* *+SYNTHÈSE GÉNÉRALE+*
55 1 Etienne Pallier
56 374 Etienne Pallier
En utilisant les conventions CakePHP dans le nommage des différentes parties de votre application, vous gagnerez des fonctionnalités sans les tracas et les affres de la configuration. Voici un exemple récapitulant les conventions abordées :
57 374 Etienne Pallier
58 374 Etienne Pallier
<pre>
59 374 Etienne Pallier
    Nom de la table de la base de données: “articles”
60 374 Etienne Pallier
    Classe Table: ArticlesTable se trouvant dans src/Model/Table/ArticlesTable.php
61 374 Etienne Pallier
    Classe Entity: Article se trouvant dans src/Model/Entity/Article.php
62 374 Etienne Pallier
    Classe Controller: ArticlesController se trouvant dans src/Controller/ArticlesController.php
63 374 Etienne Pallier
    Template de View se trouvant dans src/Template/Articles/index.ctp
64 374 Etienne Pallier
</pre>
65 374 Etienne Pallier
66 374 Etienne Pallier
En utilisant ces conventions, CakePHP sait qu’une requête de type http://exemple.com/articles/ sera liée à un appel à la fonction index() du Controller ArticlesController, dans lequel le model Articles est automatiquement disponible (et automatiquement lié à la table ‘articles’ dans la base) et rendue dans un fichier. Aucune de ces relations n’a été configurée par rien d’autre que la création des classes et des fichiers dont vous aviez besoin de toute façon.
67 374 Etienne Pallier
68 374 Etienne Pallier
69 373 Etienne Pallier
* *+Controleurs+*
70 365 Etienne Pallier
71 365 Etienne Pallier
noms des classes de controller sont au pluriel, en CamelCase et se terminent par Controller. UsersController et ArticleCategoriesController sont des exemples respectant cette convention
72 365 Etienne Pallier
73 365 Etienne Pallier
les méthodes publiques des controllers sont souvent exposées comme des ‘actions’ accessibles via un navigateur web. Par exemple /users/view correspond à la méthode view() de UsersController sans rien modifier. Les méthodes privées ou protégées ne sont pas accessibles avec le routing
74 365 Etienne Pallier
75 365 Etienne Pallier
UsersController (qui serait défini dans le nom de fichier UsersController.php) est accessible à l’adresse http://exemple.com/users.
76 365 Etienne Pallier
77 365 Etienne Pallier
/article-categories/view-all est la bonne forme pour accéder à l’action ArticleCategoriesController::viewAll()
78 365 Etienne Pallier
79 365 Etienne Pallier
Quand vous créez des liens en utilisant this->Html->link(), vous pouvez utiliser les conventions suivantes pour le tableau d’url:
80 365 Etienne Pallier
81 366 Etienne Pallier
<pre>
82 365 Etienne Pallier
$this->Html->link('link-title', [
83 365 Etienne Pallier
    'prefix' => 'MyPrefix' // CamelCased
84 365 Etienne Pallier
    'plugin' => 'MyPlugin', // CamelCased
85 365 Etienne Pallier
    'controller' => 'ControllerName', // CamelCased
86 365 Etienne Pallier
    'action' => 'actionName' // camelBacked
87 365 Etienne Pallier
]
88 366 Etienne Pallier
</pre>
89 363 Etienne Pallier
90 363 Etienne Pallier
91 373 Etienne Pallier
* *+Fichiers et noms de Classe+*
92 368 Etienne Pallier
93 368 Etienne Pallier
En général, les noms de fichiers correspondent aux noms des classes et suivent les standards PSR-0 et PSR-4 pour l’autoloading (chargement automatique). 
94 368 Etienne Pallier
Voici quelques exemples de noms de classes et de fichiers:
95 368 Etienne Pallier
96 372 Etienne Pallier
<pre>
97 368 Etienne Pallier
    La classe controller LatestArticlesController devra se trouver dans un fichier nommé LatestArticlesController.php.
98 368 Etienne Pallier
    La classe Component (Composant) MyHandyComponent devra se trouver dans un fichier nommé MyHandyComponent.php.
99 368 Etienne Pallier
    La classe Table OptionValuesTable devra se trouver dans un fichier nommé OptionValuesTable.php.
100 368 Etienne Pallier
    La classe Entity OptionValue devra se trouver dans un fichier nommé OptionValue.php.
101 368 Etienne Pallier
    La classe Behavior (Comportement) EspeciallyFunkableBehavior devra se trouver dans un fichier nommé EspeciallyFunkableBehavior.php.
102 368 Etienne Pallier
    La classe View (Vue) SuperSimpleView devra se trouver dans un fichier nommé SuperSimpleView.ctp.
103 368 Etienne Pallier
    La classe Helper (Assistant) BestEverHelper devra se trouver dans un fichier nommé BestEverHelper.php.
104 372 Etienne Pallier
</pre>
105 368 Etienne Pallier
106 368 Etienne Pallier
Chaque fichier sera situé dans le répertoire/namespace approprié dans le dossier de votre application.
107 368 Etienne Pallier
108 368 Etienne Pallier
109 375 Etienne Pallier
* *+Modèles et Bases de Données+*
110 368 Etienne Pallier
111 368 Etienne Pallier
Les noms de classe de *model* sont au *pluriel, en CamelCase et finissent par Table*. *UsersTable, ArticleCategoriesTable et UserFavoritePagesTable* en sont des exemples.
112 368 Etienne Pallier
113 368 Etienne Pallier
Les noms de *tables* correspondant aux models CakePHP sont au *pluriel et utilisent le caractère souligné* (underscore). Les tables correspondantes aux models mentionnés ci-dessus seront donc respectivement : *users, article_categories et user_favorite_pages*.
114 368 Etienne Pallier
115 370 Etienne Pallier
La convention est d’utiliser des *mots anglais pour les noms de colonne et de table*. Si vous utilisez des mots dans une autre langue, CakePHP ne va pas pouvoir convertir correctement les bonnes inflections (du singulier vers le pluriel et vice-versa). Dans certains cas, *si vous souhaitez ajouter vos propres règles pour des mots d’une autre langue, vous pouvez utiliser la classe utilitaire Cake\Utility\Inflector*.
116 368 Etienne Pallier
117 371 Etienne Pallier
Les *noms des champs avec deux mots ou plus* doivent être avec des *underscores* comme ici : *first_name*.
118 373 Etienne Pallier
119 371 Etienne Pallier
Les *clés étrangères des relations hasMany, belongsTo ou hasOne* sont *reconnues par défaut grâce au nom (singulier) de la table associée, suivi de _id*. Donc, si *Users hasMany Articles, la table articles se référera à la table users via une clé étrangère user_id*. Pour une table avec un nom de plusieurs mots comme *article_categories, la clé étrangère sera article_category_id*.
120 371 Etienne Pallier
121 371 Etienne Pallier
Les *tables de jointure utilisées dans les relations BelongsToMany* entre models doivent être *nommées d’après le nom des tables qu’elles unissent, dans l’ordre alphabétique (articles_tags plutôt que tags_articles)*.
122 372 Etienne Pallier
123 371 Etienne Pallier
124 375 Etienne Pallier
* *+Vues+*
125 371 Etienne Pallier
126 371 Etienne Pallier
Les fichiers de *template de view* sont nommés d’après les fonctions du controller qu’elles affichent, sous une forme avec underscores. La fonction *viewAll() de la classe ArticlesController cherchera un gabarit de view dans src/Template/Articles/view_all.ctp*.
127 371 Etienne Pallier
128 372 Etienne Pallier
Le schéma classique est *src/Template/Controller/nom_de_fonction_avec_underscore.ctp*.
129 371 Etienne Pallier
130 371 Etienne Pallier
131 363 Etienne Pallier
132 189 Etienne Pallier
133 188 Etienne Pallier
---
134 187 Etienne Pallier
135 185 Etienne Pallier
h2. TODOLIST (OLD)
136 185 Etienne Pallier
137 364 Etienne Pallier
*La liste des demandes à jour se trouve ici* : https://projects.irap.omp.eu/projects/inventirap/issues?query_id=222_
138 364 Etienne Pallier
139 185 Etienne Pallier
*_NB: Cette liste est OBSOLÈTE (ici à titre indicatif, pour se souvenir des retours de réunion)_*
140 185 Etienne Pallier
141 185 Etienne Pallier
*Demandes des utilisateurs (transmises par D. Rambaud le 19/12/16) :*
142 204 Etienne Pallier
143 204 Etienne Pallier
* Ca serait bien que le proprio de la fiche reçoive un email quand l'étiquette est imprimée, ou encore quand la fiche est validée => dans le but qu'il vérifie et complète cette fiche
144 204 Etienne Pallier
* Ca serait bien aussi que le proprio puisse modifier sa fiche, une fois créée, mais aussi même après qu'elle ait été validée. Attention, la modification post-validation ne peut porter que sur les renseignements techniques complémentaires.
145 204 Etienne Pallier
146 204 Etienne Pallier
147 204 Etienne Pallier
*Suite à réunion du 27/10/16 avec le LATMOS, constat des modifs nécessaires:*
148 204 Etienne Pallier
149 185 Etienne Pallier
* L'étiqueteuse semble ne plus fonctionner alors qu'elle fonctionnait avant...
150 185 Etienne Pallier
* Ajouter un champ "Titre du mail" dans la liste des emails envoyés, pour qu'on puisse configurer le titre du mail envoyé (ex: [LABINVENT])
151 185 Etienne Pallier
* Check Date achat <= Date Livraison !!!
152 185 Etienne Pallier
* Ajouter un statut : ajouter un statut « désinventorié «  ou «amorti ? » (à réfléchir)
153 185 Etienne Pallier
* Ajouter colonne statut « hors service » dans la vue "liste des matériels"
154 192 Etienne Pallier
* N° série : à remettre dans la section informations (pour que tout le monde le voie)
155 1 Etienne Pallier
* Empêcher duplication d'une fiche matériel si même numéro de série
156 121 Alexandre Cases
* Importation depuis Excel
157 120 Alexandre Cases
* Le champ "Local de stockage" a-t-il disparu ??? => à remettre
158 120 Alexandre Cases
* Site : champ optionnel
159 120 Alexandre Cases
* Champs optionnels: de manière générale, il faudrait pouvoir configurer quelques champs comme optionnels (certains champs doivent bien sûr absolument rester obligatoires)
160 120 Alexandre Cases
* (temporairement, on peut se contenter de CACHER certains champs, comme par exemple le champ "Site")
161 120 Alexandre Cases
* Suivis par fournisseur: ajouter la colonne "fournisseur" dans Suivi pour pouvoir trier la vue par fournisseur
162 1 Etienne Pallier
* Suivis relance : trouver un moyen de relancer automatiquement les suivis périodiques (ou bien avec une date programmée)
163 120 Alexandre Cases
* Emprunt dates: afficher les dates d'emprunt et de retour (date emprunt doit être obligatoire)
164 120 Alexandre Cases
* Matériel gestionnaire: obliger la personne qui crée une fiche matériel à choisir un gestionnaire (via une liste) (et avertir automatiquement ce gestionnaire par mail)
165 192 Etienne Pallier
* supprimer profil AdminPlus, inutile
166 120 Alexandre Cases
167 120 Alexandre Cases
168 120 Alexandre Cases
169 120 Alexandre Cases
*Suite à l'installation à l'IRAP du 21/01/2016*:
170 120 Alexandre Cases
171 120 Alexandre Cases
- Si elle existe, supprimer table "fichiers"
172 120 Alexandre Cases
- Sauvegarder les utilisateurs
173 120 Alexandre Cases
- Transformer table "utilisateurs" en "users"
174 120 Alexandre Cases
- Ajout table "configuration"
175 120 Alexandre Cases
- Ajout clé étrangère emprunts (site_id)/suivis (type_suivi_id)
176 120 Alexandre Cases
- Transformation des données correspondantes
177 120 Alexandre Cases
- Suppression ancien champ emprunt (e_lieu_stockage), suivis (type_intervention)
178 1 Etienne Pallier
179 1 Etienne Pallier
180 101 Etienne Pallier
*Suite à l'installation à l'IAS du 09/03/2015*
181 9 Etienne Pallier
182 9 Etienne Pallier
- Ajout table "organismes", "type_suivis", "sites"
183 180 Etienne Pallier
- Ajout clé correspondante dans table "matériels"
184 9 Etienne Pallier
- Transformation des données correspondantes
185 174 Etienne Pallier
- Suppression anciens champs
186 174 Etienne Pallier
- Ajout table "documents"
187 174 Etienne Pallier
- Sauvegarder les utilisateurs
188 174 Etienne Pallier
- Transformer table "utilisateurs" en "users"
189 174 Etienne Pallier
- Ajout table "configuration"
190 174 Etienne Pallier
- Ajout clé étrangère emprunts (site_id)/suivis (type_suivi_id)
191 209 Thibaud Ajas
- Transformation des données correspondantes
192 210 Thibaud Ajas
- Suppression ancien champ emprunt (e_lieu_stockage), suivis (type_intervention)
193 1 Etienne Pallier
---
194 210 Thibaud Ajas
195 386 Etienne Pallier
h2. Modèle de données (Data model)
196 1 Etienne Pallier
197 356 Etienne Pallier
198 386 Etienne Pallier
h3. Schéma de la base de données (v2.6)
199 1 Etienne Pallier
200 386 Etienne Pallier
{{thumbnail(BDD_schema.png, size=2000, title=Labinvent data model 2.6)}}
201 356 Etienne Pallier
202 389 Etienne Pallier
h3. Schéma de la base de données (v2.0)
203 388 Etienne Pallier
204 388 Etienne Pallier
205 388 Etienne Pallier
{{thumbnail(BDD_IRAP.png, size=2000, title=Labinvent data model 2.0)}}
206 388 Etienne Pallier
207 388 Etienne Pallier
208 388 Etienne Pallier
209 388 Etienne Pallier
210 388 Etienne Pallier
211 388 Etienne Pallier
212 388 Etienne Pallier
---
213 388 Etienne Pallier
214 174 Etienne Pallier
h2. Utilisation du serveur web de dev de CakePHP (à la place de apache)
215 176 Etienne Pallier
216 182 Etienne Pallier
/!\ Votre serveur MySQL doit être lancé !!!
217 182 Etienne Pallier
218 176 Etienne Pallier
* Se placer à la racine du projet.
219 176 Etienne Pallier
220 179 Etienne Pallier
* Lancer la commande suivante :
221 176 Etienne Pallier
222 182 Etienne Pallier
 <pre> bin/cake server </pre>
223 182 Etienne Pallier
224 176 Etienne Pallier
* Rendez-vous sur http://localhost:8765/
225 176 Etienne Pallier
226 176 Etienne Pallier
---
227 178 Etienne Pallier
228 174 Etienne Pallier
h2. Cycle de vie du Matériel
229 174 Etienne Pallier
230 174 Etienne Pallier
231 9 Etienne Pallier
---
232 9 Etienne Pallier
233 181 Etienne Pallier
h3. Diagramme d'états-transitions
234 181 Etienne Pallier
235 184 Etienne Pallier
{{thumbnail(equipment_status_state_diagram.png, size=2000, title=Cycle de vie du matériel)}}
236 183 Etienne Pallier
237 183 Etienne Pallier
238 181 Etienne Pallier
---
239 181 Etienne Pallier
240 181 Etienne Pallier
h3. Diagramme de séquences
241 12 Etienne Pallier
242 12 Etienne Pallier
{{thumbnail(equipment_interactions_sequence_diagram.png, size=1500, title=Cycle de vie du matériel)}}
243 76 Etienne Pallier
244 15 Etienne Pallier
245 1 Etienne Pallier
246 12 Etienne Pallier
---
247 17 Etienne Pallier
248 17 Etienne Pallier
h2. ACL - Gestion des droits selon le profil
249 66 Etienne Pallier
250 278 Etienne Pallier
Document Google doc (à jour) : https://docs.google.com/document/d/1-OhEeoi96j6ueUl5NQCQ9ZsTfbJTFw3ZVaWU2iYly_o/edit?usp=sharing 
251 277 Etienne Pallier
252 279 Etienne Pallier
Ancien document (n'est plus à jour et est incomplet) : {{thumbnail(ACLs Droits selon les Roles.pdf, size=1500, title=Cycle de vie du matériel)}}
253 84 Etienne Pallier
254 86 Etienne Pallier
255 84 Etienne Pallier
256 86 Etienne Pallier
---
257 154 Alexandre Cases
258 154 Alexandre Cases
h2. ROADMAP - Plan de développement
259 107 Alexandre Cases
260 274 Etienne Pallier
*Stage de Thibault :* il se déroule du 10 avril au 30 juin 2017, soit sur 12 semaines (S1 à S12)
261 154 Alexandre Cases
_*(Ne pas oublier de rédiger le rapport de stage au fur et à mesure)*_
262 154 Alexandre Cases
263 138 Etienne Pallier
264 154 Alexandre Cases
Voir le détail de la roadmap: https://projects.irap.omp.eu/projects/inventirap/roadmap
265 1 Etienne Pallier
266 275 Etienne Pallier
* S01-SO2 : "version 2.5.x - Amélioraiton installation, pagination":https://projects.irap.omp.eu/versions/160
267 275 Etienne Pallier
* S03-SO5 : "version 2.6.x - Emails, Etiquettes, bugfix...":https://projects.irap.omp.eu/versions/161
268 275 Etienne Pallier
* S06-SO7 : "version 2.7.x - Synchronization avec LATMOS, ACLs ok partout":https://projects.irap.omp.eu/versions/162
269 275 Etienne Pallier
* S08-S10 : "version 2.8.x - ACLs configurables via BDD, ...":https://projects.irap.omp.eu/versions/163
270 275 Etienne Pallier
* S11-S12 : "version 2.9.x - upgrade Cakephp3, passage à Php7":https://projects.irap.omp.eu/versions/164
271 271 Etienne Pallier
272 271 Etienne Pallier
273 276 Etienne Pallier
*Stage de Alexandre Cases (avril à juin 2016) :*
274 271 Etienne Pallier
275 271 Etienne Pallier
276 160 Alexandre Cases
|                    |   |_.Prévu |_.Réalisé |
277 90 Etienne Pallier
|/2=.S01 (11/4-15/4) |.1|/5=<."version 2.00 - Cakephp3 + Php5 (version de base from bake)":https://projects.irap.omp.eu/versions/105|/6=<.version 2.00|
278 161 Etienne Pallier
                     |.2|
279 90 Etienne Pallier
|/2=.S02 (18/4-22/4) |.1|
280 161 Etienne Pallier
                     |.2|
281 90 Etienne Pallier
|/2=.S03 (25/4-29/4) |.1|
282 154 Alexandre Cases
                     |.2|/4=<."version 2.01 - Implémentation complète du CRUD":https://projects.irap.omp.eu/versions/101|
283 154 Alexandre Cases
|/2=.S04 (02/5-06/5) |.1|/4=<.version 2.01|
284 154 Alexandre Cases
                     |.2|
285 154 Alexandre Cases
|/2=.S05 (09/5-13/5) |.1|
286 99 Etienne Pallier
                     |.2|/3=<."version 2.02 - Implémentation de toutes les autres actions":https://projects.irap.omp.eu/versions/106|
287 1 Etienne Pallier
|/2=.S06 (16/5-20/5) |.1|/2=<.version 2.02|
288 1 Etienne Pallier
                     |.2|
289 151 Etienne Pallier
|/2=.S07 (23/5-27/5) |.1|/2=<."version 2.03 - Implémentation du LDAP (vrai et fake)":https://projects.irap.omp.eu/versions/108|/2=<.version 2.03|
290 102 Etienne Pallier
                     |.2|
291 100 Etienne Pallier
|/2=.S08 (30/5-03/6) |.1|/2=<."version 2.04 - Implémentation des ACL (droits)":https://projects.irap.omp.eu/versions/107|_/10=<.version 2.04 (en cours)|
292 98 Etienne Pallier
                     |.2|
293 100 Etienne Pallier
|/2=.S09 (06/6-10/6) |.1|/2=<."version 2.05 - Documents attaches aux materiels (+ photos)":https://projects.irap.omp.eu/versions/99|
294 98 Etienne Pallier
                     |.2|
295 100 Etienne Pallier
|_/2=.S10 (13/6-17/6) |.1|/2=<."version 2.06 - Evolutions prévues dans 1.3 et 1.4":https://projects.irap.omp.eu/versions/110|
296 98 Etienne Pallier
                     |.2|
297 98 Etienne Pallier
|/2=.S11 (20/6-24/6) |.1|/1=<."version 2.07 - Corrections/Evolutions demandées par l'IAS":https://projects.irap.omp.eu/versions/124|
298 98 Etienne Pallier
                     |.2|/2=<."version 2.08 - Cakephp3 + Php7 (compatible Php5)":https://projects.irap.omp.eu/versions/98|
299 98 Etienne Pallier
|/2=.S12 (27/6-30/6) |.1|
300 98 Etienne Pallier
                     |.2|/1=<."version 2.10 - Autres ajouts (+ fin rédaction rapport de stage)":https://projects.irap.omp.eu/versions/100|
301 98 Etienne Pallier
302 98 Etienne Pallier
---
303 98 Etienne Pallier
304 281 Etienne Pallier
h2. COMMIT : Procédure à suivre à chaque commit
305 98 Etienne Pallier
306 268 Etienne Pallier
NB: _cette procédure est détaillée davantage dans la section HOWTO de cette page (partie "CYCLE DE DEVELOPPEMENT A SUIVRE")_
307 267 Etienne Pallier
308 98 Etienne Pallier
Voici les différentes étapes à respecter au moment de chaque commit:
309 1 Etienne Pallier
310 283 Etienne Pallier
*1) S'assurer que tous les tests passent toujours !*
311 1 Etienne Pallier
312 286 Etienne Pallier
Cela permet de se prémunir contre toute régression (ce qui fonctionnait avant doit continuer de fonctionner)
313 285 Etienne Pallier
314 301 Etienne Pallier
*2) Optionnel : Incrementer la version et la date du projet*
315 282 Etienne Pallier
316 280 Etienne Pallier
A la fin du fichier src/Template/Layout/default.ctp
317 1 Etienne Pallier
318 265 Etienne Pallier
*3) Mettre à jour le fichier README-LABINVENT (ceci est un exemple, un template)*
319 265 Etienne Pallier
320 151 Etienne Pallier
Date: 11/05/2016
321 1 Etienne Pallier
Version: 2.1.9
322 151 Etienne Pallier
Mise à jour doc install
323 151 Etienne Pallier
(Attention, changement structure BDD)
324 260 Etienne Pallier
Demande(s) réalisée(s) : https://projects.irap.omp.eu/issues/3542
325 151 Etienne Pallier
Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
326 151 Etienne Pallier
327 100 Etienne Pallier
Remarques:
328 100 Etienne Pallier
=> Version: 2.1.9 = 9ème commit sur la version 2.1
329 100 Etienne Pallier
=> préciser "(bugfix)" si c'est le cas
330 1 Etienne Pallier
=> ajouter "(Attention, changement structure BDD)" s'il y a eu une modif de la BDD
331 100 Etienne Pallier
=> "Demande (terminée)" ou "Demande (en cours)", ou pas de demande du tout (exceptionnellement)
332 151 Etienne Pallier
=> ces infos permettront de savoir quelle version (et date) exacte du projet on a actuellement sur son disque
333 1 Etienne Pallier
334 1 Etienne Pallier
335 303 Etienne Pallier
*4) S'il y a eu un changement de structure de la BD*
336 98 Etienne Pallier
337 1 Etienne Pallier
* Copier la requête sql de modif dans un script db-update-AAAA-MM-JJ.sh du dossier database/update/
338 291 Etienne Pallier
* Mettre à jour le script sql complet de création de la BD database/labinvent_2.1_12-05-16.sql (et les autres scripts sql associés si besoin, insert_users...)
339 291 Etienne Pallier
* Mettre à jour le schéma (image png) de la BD (avec Mysql Workbench) dans le projet et sur le wiki (page "Documentation technique")
340 1 Etienne Pallier
* Avertir dans le README (Attention, changement de structure de la BDD, il faut exécuter le script de mise à jour database/update/xxx ...)
341 151 Etienne Pallier
342 1 Etienne Pallier
343 303 Etienne Pallier
*5) Si c'est la fin d'une version majeure (2.0, 2.1, 2.2, ...)*
344 1 Etienne Pallier
345 304 Etienne Pallier
346 304 Etienne Pallier
* On doit normalement avoir écrit quelques nouveaux tests pour cette version, n'est-ce pas ??? (sinon, c'est po bien) !!!
347 98 Etienne Pallier
* Ajouter cette version en tête de la section "MAIN CHANGES (MILESTONES)" dans le fichier README
348 1 Etienne Pallier
* Mettre à jour la doc install/INSTALLATION à partir du wiki (si nécessaire)
349 261 Etienne Pallier
* (On peut aussi tester une installation du logiciel from scratch)
350 98 Etienne Pallier
351 151 Etienne Pallier
352 284 Etienne Pallier
*6) PULL*
353 100 Etienne Pallier
354 100 Etienne Pallier
(au cas où quelqu'un d'autre aurait fait un push)
355 98 Etienne Pallier
356 104 Etienne Pallier
357 284 Etienne Pallier
*7) COMMIT*
358 104 Etienne Pallier
359 7 Etienne Pallier
Dans le message de commit, faire un simple copier/coller des infos du fichier README (sauf date):
360 1 Etienne Pallier
361 1 Etienne Pallier
Version: 2.1.9
362 1 Etienne Pallier
Mise à jour doc install (bugfix)
363 302 Etienne Pallier
(Attention, changement structure BDD)
364 1 Etienne Pallier
Demande (terminée): https://projects.irap.omp.eu/issues/3542
365 1 Etienne Pallier
Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
366 1 Etienne Pallier
367 304 Etienne Pallier
*5) Si c'est la fin d'une version majeure (2.0, 2.1, 2.2, ...)*
368 1 Etienne Pallier
369 304 Etienne Pallier
* On doit normalement avoir écrit quelques nouveaux tests pour cette version, n'est-ce pas ??? (sinon, c'est po bien) !!!
370 304 Etienne Pallier
* Ajouter cette version en tête de la section "MAIN CHANGES (MILESTONES)" dans le fichier README
371 304 Etienne Pallier
* Mettre à jour la doc install/INSTALLATION à partir du wiki (si nécessaire)
372 304 Etienne Pallier
* (On peut aussi tester une installation du logiciel from scratch)
373 304 Etienne Pallier
* Voir aussi étape 9
374 304 Etienne Pallier
375 304 Etienne Pallier
376 302 Etienne Pallier
*8) Optionnel : PUSH*
377 1 Etienne Pallier
378 1 Etienne Pallier
(seulement si le commit est important/urgent, ou suite à un ensemble de commits sur un même thème)
379 304 Etienne Pallier
380 304 Etienne Pallier
381 304 Etienne Pallier
*9) Si c'est la fin d'une version majeure (2.0, 2.1, 2.2, ...), TAGUER la version*
382 304 Etienne Pallier
383 304 Etienne Pallier
Exemple:
384 304 Etienne Pallier
<pre>
385 304 Etienne Pallier
git tag 2.8 1b2e1d63ff
386 304 Etienne Pallier
</pre>
387 304 Etienne Pallier
388 304 Etienne Pallier
The 1b2e1d63ff stands for the first 10 characters of the commit id you want to reference with your tag. 
389 304 Etienne Pallier
You can get the commit id by looking at the log :
390 304 Etienne Pallier
391 304 Etienne Pallier
<pre>
392 304 Etienne Pallier
git log
393 304 Etienne Pallier
</pre>
394 304 Etienne Pallier
395 304 Etienne Pallier
396 304 Etienne Pallier
397 1 Etienne Pallier
398 1 Etienne Pallier
399 1 Etienne Pallier
---
400 203 Thibaud Ajas
401 288 Etienne Pallier
h2. Procédure à suivre pour MERGER le code entre 2 labos
402 288 Etienne Pallier
403 290 Etienne Pallier
*0) Etat initial :*
404 288 Etienne Pallier
- dev-LATMOS : état ok (tests passés & push fait)
405 288 Etienne Pallier
- dev-IRAP : état ok (tests passés & push fait)
406 288 Etienne Pallier
407 290 Etienne Pallier
*A faire à l'IRAP :*
408 288 Etienne Pallier
409 290 Etienne Pallier
*1) Merger dev-IRAP => dev*
410 289 Etienne Pallier
git checkout dev-IRAP
411 289 Etienne Pallier
(dev-IRAP) Incrémenter date + version + commit/push
412 288 Etienne Pallier
git checkout dev
413 313 Etienne Pallier
*git merge --no-ff dev-IRAP*
414 289 Etienne Pallier
Tests ok
415 305 Etienne Pallier
git push [origin dev]
416 288 Etienne Pallier
417 290 Etienne Pallier
*2) Merger dev-LATMOS => dev*
418 289 Etienne Pallier
git checkout dev-LATMOS
419 289 Etienne Pallier
(dev-LATMOS) Tests ok
420 289 Etienne Pallier
git checkout dev
421 313 Etienne Pallier
*git merge --no-ff dev-LATMOS*
422 307 Etienne Pallier
Si besoin, résoudre les conflits + add/commit/push
423 289 Etienne Pallier
Si besoin, exécuter le(s) script(s) db-update.sh
424 308 Etienne Pallier
si besoin, adapter le(s) script(s) db-update.sh
425 1 Etienne Pallier
Tests ok
426 311 Etienne Pallier
Faire un seul script db-update fusionnant toutes les modifs IRAP
427 308 Etienne Pallier
Update le script de création général de la BD (en fonction du contenu de db-update.sh) + add/commit/push
428 307 Etienne Pallier
Incrémenter date + version + add/commit/push
429 288 Etienne Pallier
430 312 Etienne Pallier
*3) Merger dev => dev-IRAP et dev-LATMOS*
431 312 Etienne Pallier
git checkout dev-IRAP
432 313 Etienne Pallier
*git merge --no-ff dev*
433 312 Etienne Pallier
Tests ok
434 312 Etienne Pallier
git push
435 1 Etienne Pallier
436 312 Etienne Pallier
git checkout dev-LATMOS
437 313 Etienne Pallier
*git merge --no-ff dev*
438 312 Etienne Pallier
Tests ok
439 306 Etienne Pallier
git push
440 289 Etienne Pallier
441 312 Etienne Pallier
Si besoin : Prévenir LATMOS que db-update à faire (venant de dev-IRAP) ?
442 288 Etienne Pallier
443 1 Etienne Pallier
h2. Installation from scratch (Sous UBuntu)
444 1 Etienne Pallier
445 1 Etienne Pallier
h3. Création projet avec Composer
446 1 Etienne Pallier
447 1 Etienne Pallier
* Télécharger composer.phar : 
448 1 Etienne Pallier
"curl -s https://getcomposer.org/installer | php"
449 1 Etienne Pallier
450 1 Etienne Pallier
* Avec le Composer créer un nouveau projet : 
451 1 Etienne Pallier
"php composer.phar create-project --prefer-dist cakephp/app labinvent_2.0"
452 1 Etienne Pallier
453 1 Etienne Pallier
> Voir structure projet : http://book.cakephp.org/3.0/fr/intro/cakephp-folder-structure.html
454 22 Alexandre Cases
455 22 Alexandre Cases
* On rempli la base de données avec le fichier sql
456 1 Etienne Pallier
457 1 Etienne Pallier
* On indique la BD utiliser à CakePHP dans le fichier config/app.php, propriété "Datasources".
458 1 Etienne Pallier
459 22 Alexandre Cases
* On se place à la racine du projet
460 22 Alexandre Cases
461 22 Alexandre Cases
* On génère le code Scaffold : 
462 1 Etienne Pallier
"bin/cake bake all nom_table" --> ça génére les modeles, les vues, et les controlleurs.
463 153 Etienne Pallier
464 1 Etienne Pallier
> Commande (en une fois) :
465 21 Alexandre Cases
> > bin/cake bake all categories && bin/cake bake all emprunts && bin/cake bake all groupes_metiers && bin/cake bake all groupes_thematiques && bin/cake bake all organismes && bin/cake bake all sites && bin/cake bake all sous_categories && bin/cake bake all suivis && bin/cake bake all sur_categories && bin/cake bake all type_suivis && bin/cake bake all documents && bin/cake bake all users && bin/cake bake all materiels
466 1 Etienne Pallier
467 1 Etienne Pallier
h3. Modification de la base de données 
468 1 Etienne Pallier
> Une version du sql corrigée au fur et à mesure est disponible dans le git :
469 1 Etienne Pallier
470 131 Alexandre Cases
> > Dans database/, le fichier labinvent_2.1_09-05-16 correspond à la création de la base.
471 1 Etienne Pallier
> > Dans database/, le fichier labinvent_2.0_insert-irap_19-04-16 correspond aux insertions propre à l'IRAP, fichier insertion uniquement pour les dévellopeurs.
472 1 Etienne Pallier
473 1 Etienne Pallier
* Création table "config"
474 21 Alexandre Cases
475 1 Etienne Pallier
> > Mise à jour dans le fichier de création de base
476 21 Alexandre Cases
> > Mise à jour à part : db-update-2016-05-09.sql
477 21 Alexandre Cases
478 21 Alexandre Cases
h3. Autres remarques lors du développement
479 21 Alexandre Cases
480 21 Alexandre Cases
* Suivre les conventions de CakePHP est le top pour ne pas avoir à refaire de la config (bidouiller), il faudrait vérifier réguliérement que c'est le cas (outil "cakephp-codesniffer")...
481 21 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/contributing/cakephp-coding-conventions.html
482 21 Alexandre Cases
483 21 Alexandre Cases
* La solution pour insérer un utilisateur directement dans la base et pouvoir se connecter avec dans l'application est de l'insérer avec un mot de passe haché de la méme façon.
484 20 Alexandre Cases
Le mot de passe "login" = "$2y$10$LZzpws3oDidBcqO/Fy1RTedLLk3ENTmplny5J7bZ6R1PqFoGOw3Ma".
485 24 Alexandre Cases
Le mot de passe vide "" = "$2y$10$nBQMNstgN.sgad1ZANznY.pbJI.ZG/.Q5qX4gC8SXCFQnDIZC8rcW".
486 25 Alexandre Cases
487 91 Alexandre Cases
* Vérifier que la migration vers la prochaine version de cakephp3 (3.3 ?) sera facile... (décrire la procédure à suivre)
488 130 Alexandre Cases
--> Une migration vers une version mineur 3.2 => 3.3, se réalise avec la mise à jour de CakePHP à l'aide de Composer
489 91 Alexandre Cases
--> Puis il faut regarder les changements dans la page migration correspondant à la version voulu et adapter les changements au code.
490 91 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/appendices/3-2-migration-guide.html
491 31 Alexandre Cases
492 106 Alexandre Cases
* Outil (plugin) "DebugKit" de CakePHP3 : 
493 106 Alexandre Cases
--> DebugKit est un plugin qui fournit une toolbar pour aider à debugger les applications CakePHP plus facilement.
494 106 Alexandre Cases
--> Par défaut il est installé avec le squelette de l'application, pour l'activer, il faut se placer à la racine.
495 1 Etienne Pallier
--> Puis il faut éxécuter la ligne suivante : bin/cake plugin load DebugKit .
496 129 Alexandre Cases
--> La commande va aller modifier le fichier config bootstrap.php.
497 122 Alexandre Cases
--> Le fichier bootstrap.php actuel de l'application sur le git, est configuré pour charger le plugin lorsque l'application est en mode debug de CakePHP, je ne pense pas que exécuter la commande précédente soit utile vu la configuration de ce fichier dans notre application.
498 129 Alexandre Cases
--> Le plugin nécessite l'extension php5-sqlite par défaut (il supporte l'équivalent avec de la config).
499 128 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/debug-kit.html
500 128 Alexandre Cases
501 157 Alexandre Cases
502 157 Alexandre Cases
* Mode debug personnaliser : 
503 157 Alexandre Cases
> Faire $this->myDebug($var) dans un controlleur pour afficher le contenu de la variable si mode debug personnalisé actif, à condition que le mode debug soit activé.
504 125 Alexandre Cases
505 125 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/development/testing.html
506 156 Etienne Pallier
507 156 Etienne Pallier
* Pour charger une librairie (ex : phpqrcode, ...)
508 156 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/core-libraries/app.html#charger-les-fichiers-de-vendor
509 156 Etienne Pallier
510 156 Etienne Pallier
* Pour créer les fichiers pdf d'entrée et de sortie, on utilise fpdf 1.8.1, on pourrait utiliser le plugin développer pour CakePHP3.
511 156 Etienne Pallier
> Voir : https://github.com/FriendsOfCake/CakePdf
512 156 Etienne Pallier
513 156 Etienne Pallier
* Pour le JavaScript, le JS Helper a été retiré 
514 156 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/appendices/3-0-migration-guide.html#jshelper
515 156 Etienne Pallier
516 156 Etienne Pallier
* Pour pouvoir éxécuter les tests depuis eclipse : 
517 156 Etienne Pallier
> Voir : http://blog.loftdigital.com/running-phpunit-tests-in-eclipse-pdt
518 156 Etienne Pallier
519 156 Etienne Pallier
* Avant de déployer l'application sur le serveur de production, optimiser les performances
520 156 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/deployment.html#ameliorer-les-performances-de-votre-application
521 156 Etienne Pallier
522 156 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}Installation sur Mac (retour des pb)%
523 156 Etienne Pallier
524 156 Etienne Pallier
1) install.sh
525 156 Etienne Pallier
=> 
526 156 Etienne Pallier
chmod: Unable to change file mode on ./webroot/img//gqbee0pkerrl8h2rbekaa3t8j1.png: Operation not permitted
527 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/models/myapp_cake_model_default_configurations: Operation not permitted
528 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/models/myapp_cake_model_default_documents: Operation not permitted
529 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_cake_fr__f_r: Operation not permitted
530 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_debug_kit_fr__f_r: Operation not permitted
531 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_default_fr__f_r: Operation not permitted
532 156 Etienne Pallier
533 156 Etienne Pallier
534 156 Etienne Pallier
=> sudo chmod -R 777 ../webroot/img
535 163 Alexandre Cases
=> sudo chmod -R 777 ../tmp/
536 156 Etienne Pallier
(=> sudo chmod -R 777 ../vendor)
537 163 Alexandre Cases
538 156 Etienne Pallier
539 165 Etienne Pallier
2) connexion au site
540 1 Etienne Pallier
=> mauvais affichage pourri
541 164 Alexandre Cases
=> il faut configurer la BD dans app.php
542 164 Alexandre Cases
            'username' => 'labinvent2user',
543 164 Alexandre Cases
            'password' => 'labinvent2user',
544 164 Alexandre Cases
            'database' => 'labinvent2',
545 164 Alexandre Cases
546 164 Alexandre Cases
3) login
547 164 Alexandre Cases
=> epallier/login
548 164 Alexandre Cases
549 164 Alexandre Cases
550 164 Alexandre Cases
---
551 172 Alexandre Cases
552 172 Alexandre Cases
h2. Pour mettre à jour CakePHP
553 156 Etienne Pallier
554 156 Etienne Pallier
* Utiliser le composer : "php composer.phar update" à la racine de l'application
555 156 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/installation.html#rester-a-jour-avec-les-derniers-changements-de-cakephp
556 222 Thibaud Ajas
557 1 Etienne Pallier
* Puis il faut modifier le fichier : ./vendor/cakephp/cakephp/src/View/Helper/PaginatorHelper.php
558 222 Thibaud Ajas
  Ce fichier contient le template de l'helper "paginator" et il faut modifier le tableau "$_defaultConfig" et remplacer les balise "li" par des balises "span".
559 222 Thibaud Ajas
  Enfin dans le même tableau, il faut remplacer la ligne suivante : 
560 222 Thibaud Ajas
> 'current' => '<span class="active"><a href="">{{text}}</a></span>',
561 222 Thibaud Ajas
562 222 Thibaud Ajas
           Par : 
563 222 Thibaud Ajas
564 222 Thibaud Ajas
> 'current' => '<span class="current">{{text}}</span>',
565 222 Thibaud Ajas
566 222 Thibaud Ajas
* Puis il faut vider le cache de l'application (et du navigateur) pour que debug_kit fonctionne.
567 222 Thibaud Ajas
568 222 Thibaud Ajas
569 222 Thibaud Ajas
---
570 222 Thibaud Ajas
571 385 Thibaud Ajas
h2. Pour utiliser php5.6 ET php7.0 sur le même OS (Fonctionne avec Ubuntu 14.04.5 - le 02/05/2017)
572 222 Thibaud Ajas
573 385 Thibaud Ajas
*Installation de php 5.6 et de php 7.0 :*
574 222 Thibaud Ajas
575 222 Thibaud Ajas
<pre>
576 222 Thibaud Ajas
sudo add-apt-repository ppa:ondrej/php
577 222 Thibaud Ajas
sudo apt-get update
578 385 Thibaud Ajas
sudo apt-get install php7.0 php5.6 php5.6-mysql php-gettext php5.6-mbstring php-mbstring php7.0-mbstring php-xdebug libapache2-mod-php5.6 libapache2-mod-php7.0
579 222 Thibaud Ajas
</pre>
580 222 Thibaud Ajas
581 221 Thibaud Ajas
*Comment changer de version :*
582 221 Thibaud Ajas
583 385 Thibaud Ajas
_*Depuis php5.6 vers php7.0 :*_
584 167 Alexandre Cases
585 167 Alexandre Cases
<pre>
586 385 Thibaud Ajas
sudo a2dismod php5.6 ; sudo a2enmod php7.0 ; sudo service apache2 restart
587 385 Thibaud Ajas
sudo update-alternatives --set php /usr/bin/php7.0
588 169 Alexandre Cases
</pre>
589 169 Alexandre Cases
590 385 Thibaud Ajas
_*Depuis php7.0 vers php5.6 :*_
591 169 Alexandre Cases
592 169 Alexandre Cases
<pre>
593 385 Thibaud Ajas
sudo a2dismod php7.0 ; sudo a2enmod php5.6 ; sudo service apache2 restart
594 1 Etienne Pallier
sudo update-alternatives --set php /usr/bin/php5.6
595 173 Alexandre Cases
</pre>
596 173 Alexandre Cases
597 173 Alexandre Cases
---
598 173 Alexandre Cases
599 1 Etienne Pallier
h2. Rappel d'intervention par mail
600 170 Alexandre Cases
601 170 Alexandre Cases
* Il faut définir un attribut *"rappel" de type "int"* dans la table suivis.
602 170 Alexandre Cases
Cet attribut peut avoir *4 valeurs* : 
603 167 Alexandre Cases
<pre>
604 167 Alexandre Cases
0 ==> Pas d'envoi de rappel programmé
605 167 Alexandre Cases
1 ==> Rappel programmé 1 mois avant
606 201 Thibaud Ajas
2 ==> Rappel programmé 15 jours avant
607 1 Etienne Pallier
3 ==> Rappel programmé 2 jours avant
608 211 Thibaud Ajas
</pre>
609 1 Etienne Pallier
610 211 Thibaud Ajas
* Dans *l'AppController*, il faut définir une fonction "rappelIntervention()" qui :
611 211 Thibaud Ajas
- Parcourt tous les suivis et garde ceux qui ont une date inferieur à 1 mois de la date du jour et qui ont un attribut "rappel" à "0".
612 211 Thibaud Ajas
- Met cette attribut à 1
613 211 Thibaud Ajas
- 
614 211 Thibaud Ajas
615 211 Thibaud Ajas
...........................
616 211 Thibaud Ajas
617 211 Thibaud Ajas
* Dans *l'UsersController*, il faut executer la fonction précédente une fois que l'utilisateur est connecté (dans fonction login()).
618 211 Thibaud Ajas
619 211 Thibaud Ajas
---
620 211 Thibaud Ajas
621 263 Etienne Pallier
---
622 263 Etienne Pallier
623 328 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}AMELIORATIONS A VENIR (TODO)%
624 1 Etienne Pallier
625 336 Etienne Pallier
h3. *1) POUR LE CODE SOURCE*
626 1 Etienne Pallier
627 341 Etienne Pallier
Bien maîtriser les 4 étapes qui s'enchainent lors de l'appel d'une action :
628 1 Etienne Pallier
629 1 Etienne Pallier
630 343 Etienne Pallier
*a) Avant l'appel d'une action d'un controleur*
631 1 Etienne Pallier
632 331 Etienne Pallier
Ex: src/MaterielsController/isAuthorized()
633 331 Etienne Pallier
634 376 Etienne Pallier
(NB: Au plus haut niveau, c'est vendor/cakephp/src/Controller/Component/AuthComponent.php::isAuthorized())
635 376 Etienne Pallier
636 328 Etienne Pallier
Définir qui a droit à quoi dans src/<Model>Controller/isAuthorized(),
637 329 Etienne Pallier
action par action, et à l'intérieur d'une action, role par role
638 328 Etienne Pallier
639 330 Etienne Pallier
Respecter cette structure de code :
640 330 Etienne Pallier
<pre>
641 330 Etienne Pallier
switch ($action) {
642 329 Etienne Pallier
643 330 Etienne Pallier
   case 'action1':
644 330 Etienne Pallier
      switch ($role) :
645 330 Etienne Pallier
         case USER:
646 330 Etienne Pallier
         case RESP:
647 330 Etienne Pallier
         case ADMIN:
648 330 Etienne Pallier
         ...
649 330 Etienne Pallier
650 330 Etienne Pallier
   case 'action2':
651 330 Etienne Pallier
      switch ($role) :
652 330 Etienne Pallier
653 1 Etienne Pallier
   ...
654 1 Etienne Pallier
</pre>
655 1 Etienne Pallier
656 330 Etienne Pallier
657 343 Etienne Pallier
*b) Dans le traitement de l'action, avant la vue*
658 336 Etienne Pallier
659 331 Etienne Pallier
Ex: src/MaterielsController/add()
660 331 Etienne Pallier
661 1 Etienne Pallier
Définir TOUTES les données dont la vue aura besoin, dans src/<Model>Controller/<action()>
662 1 Etienne Pallier
La vue ne doit faire AUCUN traitement, elle doit se contenter d'afficher les données qu'on lui passe.
663 331 Etienne Pallier
664 333 Etienne Pallier
En particulier, selon le role (profil) actif, positionner ces tableaux (listes de champs pour dire à quels champs ce role à accès et dans quelles conditions (lecture seule, obligatoire, ...) :
665 1 Etienne Pallier
666 333 Etienne Pallier
 * $hiddenFields = [ fields list ]
667 333 Etienne Pallier
 * $readonlyFields = [ fields list ]
668 327 Etienne Pallier
 * $mandatoryFields = [ fields list ]
669 1 Etienne Pallier
 * $defaultValueForFields = [ field1 => value1, field2 => value2, ..., fieldN => valueN ]
670 1 Etienne Pallier
671 333 Etienne Pallier
Passer ensuite ces listes à la vue avec set()
672 1 Etienne Pallier
673 343 Etienne Pallier
*c) Dans la vue correspondant à l'action*
674 1 Etienne Pallier
675 331 Etienne Pallier
Ex: dans src/Template/Materiels/add.ctp
676 331 Etienne Pallier
677 328 Etienne Pallier
Dans src/Template/<Model>/<action.ctp>
678 1 Etienne Pallier
679 1 Etienne Pallier
Afficher les données passées par le controleur pour cette action
680 1 Etienne Pallier
681 1 Etienne Pallier
(faire le moins de traitements possibles, seulement de l'affichage)
682 1 Etienne Pallier
683 337 Etienne Pallier
En particulier, la vue affichera les champs (fields) un par un, en utilisant une fonction displayField() qui tiendra compte automatiquement des listes définies à l'étape précédente :
684 337 Etienne Pallier
$hiddenFields, $readonlyFields, $mandatoryFields, et $defaultValueForField
685 335 Etienne Pallier
686 340 Etienne Pallier
687 343 Etienne Pallier
*d) (TODO) 4ème étape à envisager : ce qui se passe APRES que l'action a été exécutée*
688 340 Etienne Pallier
689 341 Etienne Pallier
* La sauvegarde dans la BD (voir aussi beforeSave())
690 340 Etienne Pallier
* Quelle redirection vers quelle vue ?
691 340 Etienne Pallier
692 336 Etienne Pallier
h3. *2) POUR LES TESTS*
693 336 Etienne Pallier
694 379 Etienne Pallier
(https://book.cakephp.org/3.0/en/development/testing.html)
695 379 Etienne Pallier
696 338 Etienne Pallier
Les tests sont dans tests/TestCase/
697 338 Etienne Pallier
698 338 Etienne Pallier
Ils sont organisés par type :
699 338 Etienne Pallier
700 338 Etienne Pallier
* Controller/
701 338 Etienne Pallier
* Model/
702 338 Etienne Pallier
* View/
703 338 Etienne Pallier
704 339 Etienne Pallier
La plupart des tests sont dans Controller, mais il faudra aussi faire quelques tests de Model et de View...
705 338 Etienne Pallier
706 338 Etienne Pallier
Concernant les tests liés aux controleurs (dans Controller/), ils sont organisés par controleur :
707 338 Etienne Pallier
708 338 Etienne Pallier
* EmpruntsControllerTest.php
709 338 Etienne Pallier
* MaterielsControllerTest.php
710 338 Etienne Pallier
* PagesControllerTest.php
711 338 Etienne Pallier
* SuivisControllerTest.php
712 338 Etienne Pallier
* UsersControllerTest.php
713 338 Etienne Pallier
714 359 Etienne Pallier
(on prendra plutôt l'exemple des tests du controleur de Materiels, MaterielsControllerTest.php)
715 339 Etienne Pallier
716 359 Etienne Pallier
Il y a 2 manières de procéder :
717 1 Etienne Pallier
718 360 Etienne Pallier
*La manière intuitive, moins exhaustive, mais PLUS LISIBLE car plus naturelle, et de plus haut niveau sémantique :*
719 1 Etienne Pallier
720 359 Etienne Pallier
On organise les tests à la façon BDD (Behaviour Driven Dev) avec le GIVEN WHEN THEN :
721 359 Etienne Pallier
722 359 Etienne Pallier
"GIVEN a context, As a ADMIN, WHEN I do an ACTION, THEN I get this result"
723 359 Etienne Pallier
724 359 Etienne Pallier
Les tests sont organisés non pas par controleur, ni par action, mais par ROLE ("AS a ADMIN"), puis à l'intérieur de ce rôle, par ACTION
725 359 Etienne Pallier
726 359 Etienne Pallier
ex: 
727 359 Etienne Pallier
728 360 Etienne Pallier
test_as_Unauthenticated_i_can_goto_APROPOS_page_and_HOME_page_and_LOGIN()
729 1 Etienne Pallier
730 360 Etienne Pallier
test_as_Authenticated_i_can_LOGOUT_and_LOGIN_again()
731 360 Etienne Pallier
732 1 Etienne Pallier
test_as_USER_i_can_ADD_a_MATERIEL_then_DELETE_it()
733 1 Etienne Pallier
734 360 Etienne Pallier
test_as_USER_i_can_ADD_a_MATERIEL_then_EDIT_it()
735 1 Etienne Pallier
736 360 Etienne Pallier
test_as_USER_i_cannot_EDIT_a_MATERIEL_that_is_not_mine()
737 1 Etienne Pallier
738 360 Etienne Pallier
test_as_USER_i_can_EDIT_a_MATERIEL_that_is_mine_even_if_VALIDATED()
739 360 Etienne Pallier
740 360 Etienne Pallier
test_as_ADMIN_i_can_VALIDATE_a_MATERIEL_that_is_CREATED()
741 360 Etienne Pallier
742 361 Etienne Pallier
On peut aussi avoir des tests qui permettent de vérifier les Règles de Gestion :
743 361 Etienne Pallier
744 361 Etienne Pallier
test_MATERIEL_date_reception_superieure_ou_egale_a_date_commande
745 361 Etienne Pallier
746 361 Etienne Pallier
test_MATERIEL_ne_doit_pas_etre_ni_technique_ni_inventoriable
747 360 Etienne Pallier
748 360 Etienne Pallier
749 360 Etienne Pallier
750 360 Etienne Pallier
*La manière systématique, exhaustive, pour ne rien oublier, mais PEU LISIBLE (donc on préfèrera la manière précédente) :*
751 360 Etienne Pallier
752 359 Etienne Pallier
On organise les tests pour un controleur donné (ex: MaterielsController) +par ACTION+, et +pour chaque action tester les droits des différents ROLES+.
753 359 Etienne Pallier
754 359 Etienne Pallier
CHAQUE TEST devrait dans l'idéal comporter 3 ou 4 parties correspondant aux 4 étapes présentées au point "1) POUR LE CODE SOURCE" ci-dessus :
755 359 Etienne Pallier
756 345 Etienne Pallier
*a) Avant l'appel d'une action d'un controleur :* 
757 1 Etienne Pallier
758 346 Etienne Pallier
Tester qui a le droit de faire quoi
759 1 Etienne Pallier
760 345 Etienne Pallier
*b+c) Dans la vue correspondant à l'action :*
761 344 Etienne Pallier
762 346 Etienne Pallier
Tester que la vue a bien été générée comme il faut pour cette action, et que les listes $readonlyFields, $mandatoryFields, ... sont bien remplies comme il faut
763 1 Etienne Pallier
764 1 Etienne Pallier
*d) Après la réalisation de l'action :*
765 1 Etienne Pallier
766 346 Etienne Pallier
Tester que l'action attendue a bien été réalisée et qu'on est bien sur la vue de redirection prévue
767 346 Etienne Pallier
768 346 Etienne Pallier
Exemples :
769 346 Etienne Pallier
770 346 Etienne Pallier
771 346 Etienne Pallier
testUnauthenticatedUserCanLogin() : tester qu'un user non logué peut appeler l'action "login", et se trouve bien ensuite sur la page accueil
772 346 Etienne Pallier
773 346 Etienne Pallier
testUnauthenticatedUserCanViewAboutPage() : tester qu'un user non logué peut voir la page "about"
774 346 Etienne Pallier
775 346 Etienne Pallier
testUnauthenticatedUserCannotDoAnythingElse() : tester qu'un user non logué ne peut voir que les pages "accueil" et "about", et rien d'autre
776 346 Etienne Pallier
777 346 Etienne Pallier
testAuthenticatedUserCanLogout() : tester qu'un user logué peut se déloguer et atteint bien la page de login
778 346 Etienne Pallier
779 346 Etienne Pallier
780 348 Etienne Pallier
*Tests spécifiques pour le controleur Materiels (les tests doivent être organisés PAR ACTION) :*
781 348 Etienne Pallier
782 346 Etienne Pallier
testOnMaterielsActionViewCanBeDoneByAll() : tester que tout le monde peut voir un matériel
783 1 Etienne Pallier
784 348 Etienne Pallier
testOnMaterielsActionAddCanBeDoneByAll() : tester que tout le monde peut créer un matériel, sans toutefois voir les mêmes champs (et pas dans les mêmes conditions), et vérifier que l'ajout d'un matériel a bien été fait et qu'on arrive sur la vue détaillée du matériel (oui, tout ça doit être testé, les 4 étapes citées plus haut, et cela pour tous les profils)
785 1 Etienne Pallier
786 349 Etienne Pallier
testOnMaterielsActionEditCanBeDoneByXXXWithConditions() : tester que selon les profils, on ne peut pas éditer les mêmes matériels (USER doit être owner, RESP doit appartenir au même groupe thématique ou métier, ...)
787 349 Etienne Pallier
788 349 Etienne Pallier
Pour chaque test, on peut imaginer des SOUS-TESTS de ce type (on prend ici l'exemple du test précédent) :
789 1 Etienne Pallier
790 1 Etienne Pallier
* testOnMaterielsInViewEditXXXCanSeeOnlyTheseFields (fields list) : test des hidden fields
791 349 Etienne Pallier
* testOnMaterielsInViewEditXXXCannotChangeTheseFields (fields list) : test des readonly fields
792 359 Etienne Pallier
* testOnMaterielsInViewEditXXXMustFillTheseFields (fields list) : test des mandatory fields
793 359 Etienne Pallier
* testOnMaterielsInViewEditXXXTheseFieldsHaveDefaultValues (fields list with default values) : test des default value fields
794 349 Etienne Pallier
795 350 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}HOWTO (nouvelle version avec CakePhp3)%
796 348 Etienne Pallier
797 354 Etienne Pallier
* *Auth : Chemin parcouru lors d'une connexion au site web*
798 378 Etienne Pallier
799 378 Etienne Pallier
(https://book.cakephp.org/3.0/en/controllers/components/authentication.html)
800 378 Etienne Pallier
801 351 Etienne Pallier
Ce chemin est parcouru dans l'ordre :
802 351 Etienne Pallier
<pre>
803 351 Etienne Pallier
webroot/index.php 
804 355 Etienne Pallier
805 350 Etienne Pallier
config/bootstrap.php => lit config/app.php
806 355 Etienne Pallier
807 350 Etienne Pallier
src/Controller/PagesController/display()
808 355 Etienne Pallier
809 350 Etienne Pallier
src/Controller/UsersController/login() sans POST
810 355 Etienne Pallier
811 350 Etienne Pallier
src/Template/Users/login.ctp => formulaire de login => POST
812 355 Etienne Pallier
813 350 Etienne Pallier
src/Controller/UsersController/login() avec POST
814 1 Etienne Pallier
815 351 Etienne Pallier
   user = $this->LdapAuth->connection();
816 351 Etienne Pallier
817 351 Etienne Pallier
     src/Controller/Component/LdapAuthComponent/connection()
818 351 Etienne Pallier
    
819 352 Etienne Pallier
        $resp = TableRegistry::get('LdapConnections')->ldapAuthentication($login, $password);
820 352 Etienne Pallier
821 352 Etienne Pallier
        src/Model/Table/LdapConnectionsTable.php::ldapAuthentication()
822 352 Etienne Pallier
823 352 Etienne Pallier
		if ($this->USE_LDAP) {
824 352 Etienne Pallier
			$ldapConnection = ldap_connect($this->host, $this->port);
825 352 Etienne Pallier
       		        if (@ldap_bind($ldapConnection, $this->authenticationType . '=' . $login . ',' . $this->baseDn, $password)) {
826 352 Etienne Pallier
		            return $this->getUserAttributes($login)[0];
827 352 Etienne Pallier
		}
828 352 Etienne Pallier
		else {
829 352 Etienne Pallier
		        $user = $this->getFakeLdapUser($login);
830 352 Etienne Pallier
			if ($user != false && (new DefaultPasswordHasher)->check($password, $user['userpassword'][0]))
831 352 Etienne Pallier
			    return $user;
832 352 Etienne Pallier
                }
833 352 Etienne Pallier
                return FALSE
834 351 Etienne Pallier
			
835 351 Etienne Pallier
   if ($user != FALSE) {
836 351 Etienne Pallier
      $this->LdapAuth->setUser($user);
837 351 Etienne Pallier
      return $this->redirect($this->LdapAuth->redirectUrl());
838 327 Etienne Pallier
</pre>
839 353 Etienne Pallier
Pour info, si ça bogue (par exemple, à une époque on retournait "YOLO" au lieu de FALSE en cas d'échec de connection ldap), c'est *src/Template/Error/error400.ctp* qui prend le relais...
840 350 Etienne Pallier
841 314 Etienne Pallier
842 319 Etienne Pallier
* *Champ facultatif/obligatoire : Comment rendre facultatif ou obligatoire un champ, et définir les vérifications à faire sur ce champ ?*
843 1 Etienne Pallier
=> src/Model/Table/<Model>Table.php
844 1 Etienne Pallier
ex : src/Model/Table/MaterielsTable.php pour définir les règles sur les champs de la table "materiels"
845 317 Etienne Pallier
846 325 Etienne Pallier
* *Où définir les éléments passés à une vue (c'est à dire à une action) ?*
847 323 Etienne Pallier
=> src/Controller/<Model>Controller/nom_de_la_vue_ou_action()
848 323 Etienne Pallier
ex : src/Controller/MaterielsController/edit() pour définir (avec set()) les éléments passés à la vue "edit" des materiels
849 321 Etienne Pallier
850 318 Etienne Pallier
* *ACL* : 
851 320 Etienne Pallier
852 325 Etienne Pallier
 * *ACL1 : Comment définir qui a droit de faire quelles actions (c'est à dire qui a le droit d'accéder à quelles vues) ?*
853 1 Etienne Pallier
=> Régles générales par défaut pour tous les controleurs : src/Controller/AppController.php/isAuthorized()
854 377 Etienne Pallier
(héritage de Cake\Controller\Component\AuthComponent::isAuthorized(), c'est à dire vendor/cakephp/src/Controller/Component/AuthComponent.php::isAuthorized())
855 377 Etienne Pallier
856 326 Etienne Pallier
(cf https://book.cakephp.org/3.0/fr/controllers/components/authentication.html et https://book.cakephp.org/3.0/fr/tutorials-and-examples/blog-auth-example/auth.html)
857 1 Etienne Pallier
_Voir aussi beforeFilter()_
858 317 Etienne Pallier
=> Régles pour un controleur donné : src/Controller/<Model>Controller.php/isAuthorized()
859 317 Etienne Pallier
860 318 Etienne Pallier
 * *ACL2 : Une fois qu'on est dans une vue, comment définir qui a droit de voir quels éléments de la vue ?*
861 317 Etienne Pallier
=> src/Template/<Model>/nom_de_la_vue.ctp
862 317 Etienne Pallier
ex : src/Template/Materiels/edit.ctp pour les règles concernant la vue "edit" des materiels
863 314 Etienne Pallier
864 315 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}HOWTO (ancienne version LabInvent 1.3 avec CakePhp2)%
865 263 Etienne Pallier
866 263 Etienne Pallier
*_Attention, ce howto est sans doute obsolète car il concerne l'ancienne version LabInvent 1.3 avec CakePhp2, mais il contient sûrement des conseils encore bien utiles_*
867 263 Etienne Pallier
868 264 Etienne Pallier
Ce document est un HOWTO, c'est à dire un guide pour savoir "comment faire quoi".
869 264 Etienne Pallier
Il donne des solutions à différents types de besoins ou problèmes, et explique aussi "où trouver quoi".
870 263 Etienne Pallier
871 263 Etienne Pallier
872 264 Etienne Pallier
* *VERSION DE CAKEPHP*
873 263 Etienne Pallier
874 263 Etienne Pallier
Version de cakephp ?
875 263 Etienne Pallier
Configure::version(); // 2.1.3
876 263 Etienne Pallier
Et aussi : fichier cakephp/lib/Cake/VERSION.txt
877 263 Etienne Pallier
878 263 Etienne Pallier
879 264 Etienne Pallier
* *CYCLE DE DEVELOPPEMENT A SUIVRE (11 commandements)*
880 263 Etienne Pallier
881 263 Etienne Pallier
Je veux apporter un changement (correction ou evolution) au projet, comment dois-je faire ?
882 263 Etienne Pallier
883 263 Etienne Pallier
1) Incrementer la version du projet, a la fin du fichier cakephp/app/View/Layouts/default.ctp, et mettre à jour la date
884 263 Etienne Pallier
885 263 Etienne Pallier
2) Selectionner le changement a apporter (une demande) dans le Redmine du projet (https://projects.irap.omp.eu/projects/inventirap) :
886 263 Etienne Pallier
- soit depuis la liste des demandes : onglet Demandes
887 263 Etienne Pallier
- soit depuis la roadmap : onglet Roadmap, cocher la case "Anomalie", cliquer sur Appliquer, puis "version 1.3" (la version en cours depuis fin 2012)
888 263 Etienne Pallier
Commencer de préférence par les "anomalies" parmi celles qui ont la plus haute priorité (et faire les "évolutions" dans un 2ème temps).
889 263 Etienne Pallier
Choisir une demande et cliquer dessus pour aller sur sa fiche detaillee et voir le travail a faire.
890 263 Etienne Pallier
Cliquer sur "mettre a jour", selectionner le statut "En cours", modifier eventuellement d'autres champs..., puis cliquer sur "Soumettre".
891 263 Etienne Pallier
Noter l'URL de cette fiche (par exemple : https://projects.irap.omp.eu/issues/1050)
892 263 Etienne Pallier
NB : Si la demande n'existe pas encore, la creer :
893 263 Etienne Pallier
- cliquer sur l'onglet "Nouvelle demande"
894 263 Etienne Pallier
- Selectionner "Anomalie" ou "Evolution"
895 263 Etienne Pallier
- Positionner le statut a "En cours" si on veut travailler aussitot dessus (sinon, laisser a "Nouveau")
896 263 Etienne Pallier
- Completer le reste de la fiche de demande (mettre "Assigne a" a "<<moi>>", choisir la version cible "version 1.3" ou "version 1.4", ...)
897 263 Etienne Pallier
- cliquer sur le bouton "Creer"
898 263 Etienne Pallier
899 263 Etienne Pallier
3) Verifier que cette nouvelle demande apparait bien dans la roadmap (cliquer sur onglet "Roadmap", ..., puis version 1.3)
900 263 Etienne Pallier
901 263 Etienne Pallier
ÉTAPE OPTIONNELLE MAIS FORTEMENT CONSEILLÉE :
902 263 Etienne Pallier
4) Ecrire un test qui vérifie que cette fonctionnalité ne marche pas encore (bug) ou bien n'est pas encore implémentée
903 263 Etienne Pallier
On utilise ici l'approche TDD (Test Driven Development)
904 263 Etienne Pallier
Ce test ne devrait pas passer (il est au rouge) ; il passera plus tard, quand on aura écrit le code nécessaire.
905 263 Etienne Pallier
Bien sur, c'est dans la mesure du possible, car on ne peut pas TOUT tester.
906 263 Etienne Pallier
Dans tous les cas, il faut ecrire un test qui s'approche le plus possible de la réalité à tester.
907 263 Etienne Pallier
Voir pour cela la section "TESTS" (à la fin de ce document)
908 263 Etienne Pallier
909 263 Etienne Pallier
5) Faire les changements necessaires dans le code Php
910 263 Etienne Pallier
Si ce changement implique aussi un changement dans la base de donnees,
911 263 Etienne Pallier
copier le script SQL correspondant à ce changement dans un fichier database/update/db-update-YYYY-MM-DD.sql
912 263 Etienne Pallier
portant la date du jour (voir des exemples dans database/update/old/).
913 263 Etienne Pallier
Plus tard, il faudra penser à intégrer ce changement dans le script general de creation de la BDD database/BDD_IRAP.sql
914 263 Etienne Pallier
(et/ou éventuellement les fichiers Insert_TablesFunct.sql, Insert_Users.sql, et Upd_TableConstraints.sql)
915 263 Etienne Pallier
et donc deplacer le script de modification database/update/db-update-YYYY-MM-DD.sql dans database/update/old/db-update-YYYY-MM-DD.sql
916 263 Etienne Pallier
917 263 Etienne Pallier
6) Tester manuellement ce changement jusqu'a ce qu'il soit totalement OK
918 263 Etienne Pallier
a) faire quelques tests manuels
919 263 Etienne Pallier
b) Le test écrit à l'étape (4) doit maintenant passer (il est au vert).
920 263 Etienne Pallier
Il doit être inclus dans l'ensemble des tests accessibles par le lien "AllTests".
921 263 Etienne Pallier
c) Test de non régression : afin de s'assurer que cette modification du code n'entraîne aucune régression sur le reste du code, 
922 263 Etienne Pallier
tous les autres tests écrits avant doivent aussi passer (vert) : pour cela, exécuter l'url /test.php?case=AllTests
923 263 Etienne Pallier
924 263 Etienne Pallier
7) Compléter le fichier /README.txt, section HISTORIQUE DES VERSIONS (fichier situé à la racine du projet)
925 263 Etienne Pallier
Y mettre le même commentaire que ce que tu mettras lors du commit
926 263 Etienne Pallier
927 263 Etienne Pallier
8) Mettre a jour TON code (en mode console, "svn update" depuis la racine du projet, ou bien depuis Eclipse, clic droit sur le projet, "Team/Update") 
928 1 Etienne Pallier
C'est important, au cas ou quelqu'un d'autre aurait fait des modifs (avant ou en meme temps que toi), et pour etre bien sur d'avoir la derniere version
929 1 Etienne Pallier
930 263 Etienne Pallier
9) Faire un "commit" du code, en collant dans le commentaire l'URL de la demande realisee (exemple : https://projects.irap.omp.eu/issues/1050)
931 263 Etienne Pallier
932 263 Etienne Pallier
10) Fermer la demande sur redmine
933 263 Etienne Pallier
Sur la fiche detaillee, cliquer sur "Mettre a jour", changer le statut a "ferme", changer "% realise" a 100%, (copier l'URL de la fiche), cliquer sur Soumettre
934 263 Etienne Pallier
935 263 Etienne Pallier
11) Si c'est un changement important, le répercuter sur le site officiel 
936 263 Etienne Pallier
Le changement est important si c'est une anomalie ou bien si c'est une évolution attendue.
937 263 Etienne Pallier
Demander alors au service informatique de le répercuter sur l'installation officielle (faire un "svn update", mail à loic.jahan@irap.omp.eu).  
938 263 Etienne Pallier
Si ce changement implique aussi la base de données, donner la directive que le fichier database/update/db-update-YYYY-MM-DD.sql doit être exécuté sur leur BDD.
939 263 Etienne Pallier
Si ce changement impliquer une modification du fichier de configuration labinvent.php, donner la procédure à suivre dans le mail.
940 263 Etienne Pallier
941 263 Etienne Pallier
942 263 Etienne Pallier
943 1 Etienne Pallier
944 264 Etienne Pallier
* *CORRIGER UNE ERREUR, RESOUDER UN PROBLEME, COMMENT DEBOGUER (DEBUG)*
945 264 Etienne Pallier
946 263 Etienne Pallier
Cakephp vous affiche une erreur, mais vous ne savez pas d'ou vient le probleme.
947 263 Etienne Pallier
Don't panic.
948 263 Etienne Pallier
En general, un bon moyen de le savoir est de lire le fichier de log des erreurs
949 263 Etienne Pallier
dans cakephp/app/tmp/logs/error.log
950 263 Etienne Pallier
951 263 Etienne Pallier
Dans le dossier logs, vous trouverez d'autres logs utiles :
952 263 Etienne Pallier
- labinvent.log
953 263 Etienne Pallier
- debug.log (pas sur que ce fichier soit encore utilisé...)
954 263 Etienne Pallier
955 263 Etienne Pallier
Remarque :
956 263 Etienne Pallier
$this->log('Something broke');
957 263 Etienne Pallier
==> écrit dans cakephp/app/tmp/logs/ :
958 263 Etienne Pallier
- error.log
959 263 Etienne Pallier
- inventirap.log
960 263 Etienne Pallier
961 263 Etienne Pallier
962 263 Etienne Pallier
963 264 Etienne Pallier
* *OU EST QUOI (WHERE IS WHAT) ?*
964 263 Etienne Pallier
965 263 Etienne Pallier
- OU mettre a jour la VERSION du soft (AVANT CHAQUE COMMIT) ?
966 263 Etienne Pallier
En attendant mieux, on fait cela a la fin du fichier cakephp/app/View/Layouts/default.ctp
967 263 Etienne Pallier
968 263 Etienne Pallier
- OU EST LA PAGE GENERALE (qui contient tous les elements) ? : cakephp/app/View/Layouts/default.ctp
969 263 Etienne Pallier
970 263 Etienne Pallier
- OU EST LA PAGE D'ACCUEIL ? : app/View/Pages/home.ctp
971 263 Etienne Pallier
972 263 Etienne Pallier
- OU SONT LES MENUS ? : app/View/Elements/
973 263 Etienne Pallier
	- menu general + Recherche generale : menu.ctp
974 263 Etienne Pallier
	- sous le menu general, et sous le champ "Recherche", titre du modele a ajouter : menu_index.ctp
975 263 Etienne Pallier
976 263 Etienne Pallier
- OU EST LA FEUILLE DE STYLE CSS ? : cakephp/app/webroot/css/inventirap.css
977 263 Etienne Pallier
978 263 Etienne Pallier
- OU EST DEFINIE LA PAGINATION ?
979 263 Etienne Pallier
Dans le Controleur
980 263 Etienne Pallier
Ex : la pagination des materiels est definie dans app/Controller/MaterielsController.php 
981 263 Etienne Pallier
	public $paginate = array(
982 263 Etienne Pallier
		'limit' => 50,
983 263 Etienne Pallier
		'order' => array('Materiel.id' => 'desc'));
984 263 Etienne Pallier
985 263 Etienne Pallier
- OU SONT LES INFOS CONCERNANT UNE ENTITE quelconque (Materiel, Emprunt, Suivi, Utilisateur) ?
986 263 Etienne Pallier
par exemple, ou trouver les infos sur l'entite "Materiel" ? : Aller dans cakephp/app/
987 263 Etienne Pallier
- le Modele : Model/Materiel.php
988 263 Etienne Pallier
- le Controleur : Controller/MaterielsController.php
989 1 Etienne Pallier
- les Vues (templates) : View/Materiels
990 1 Etienne Pallier
	- Vue de consultation : scaffold.view.ctp
991 263 Etienne Pallier
	- Vue d'ajout (add) et edition (edit) : scaffold.form.ctp
992 263 Etienne Pallier
	- vue de liste : index.ctp
993 263 Etienne Pallier
994 263 Etienne Pallier
- OU SONT DEFINIS LES ROLES (ACL) ?
995 263 Etienne Pallier
Dans app/Model/Utilisateur.php :
996 263 Etienne Pallier
	private $acceptedRoles = array ('Utilisateur', 'Responsable', 'Administration', 'Super Administrateur');
997 263 Etienne Pallier
	public function getAuthenticationLevelFromRole($role) {
998 263 Etienne Pallier
		if ($role == 'Utilisateur')
999 263 Etienne Pallier
			return 1;
1000 263 Etienne Pallier
		elseif ($role == 'Responsable')
1001 263 Etienne Pallier
			return 2;
1002 263 Etienne Pallier
		elseif ($role == 'Administration')
1003 263 Etienne Pallier
			return 3;
1004 263 Etienne Pallier
		elseif ($role == 'Super Administrateur')
1005 263 Etienne Pallier
			return 4;
1006 263 Etienne Pallier
		return 0;
1007 263 Etienne Pallier
	}
1008 263 Etienne Pallier
1009 263 Etienne Pallier
1010 263 Etienne Pallier
1011 264 Etienne Pallier
* *WORKFLOW des materiels*
1012 264 Etienne Pallier
1013 263 Etienne Pallier
Le statut d'un materiel change selon le workflow suivant :
1014 263 Etienne Pallier
1) Un utilisateur lambda le cree (n'importe qui du labo) --> CREATED
1015 263 Etienne Pallier
2) L'Administration le valide (apres avoir eventuellement complete la fiche) --> VALIDATED
1016 263 Etienne Pallier
3) Un utilisateur lambda demande a l'archiver --> TOBEARCHIVED
1017 263 Etienne Pallier
4) L'Administration le sort de l'inventaire --> ARCHIVED
1018 263 Etienne Pallier
1019 263 Etienne Pallier
Notes : 
1020 263 Etienne Pallier
- Dans l'ideal, le materiel est premierement cree par l'utilisateur concerne,
1021 263 Etienne Pallier
puis mis a jour par l'administration au moment de la commande (puis validé)
1022 263 Etienne Pallier
- L'administration peut toujours retrograder le statut d'un materiel (ce qui revient a annuler un changement de statut) 
1023 263 Etienne Pallier
1024 263 Etienne Pallier
1025 263 Etienne Pallier
1026 264 Etienne Pallier
* *STRUCTURE GENERALE D'UNE PAGE WEB (TEMPLATE) = default.ctp*
1027 264 Etienne Pallier
1028 263 Etienne Pallier
app/View/Layouts/default.ctp contient la structure suivante :
1029 263 Etienne Pallier
1030 1 Etienne Pallier
	<div id="container">
1031 1 Etienne Pallier
		<div id="header">
1032 263 Etienne Pallier
			LE HEADER AVEC SON LOGO
1033 263 Etienne Pallier
			<div class="user">
1034 263 Etienne Pallier
				BIENVENUE $userName (ou invité)
1035 263 Etienne Pallier
			</div>
1036 263 Etienne Pallier
		</div>
1037 263 Etienne Pallier
		<div id="content">
1038 263 Etienne Pallier
			<?php echo $this->Session->flash(); ?>
1039 1 Etienne Pallier
			<?php echo $this->fetch('content'); ?>
1040 1 Etienne Pallier
		</div>
1041 263 Etienne Pallier
		<div id="footer">
1042 263 Etienne Pallier
			LE FOOTER
1043 263 Etienne Pallier
		</div>
1044 263 Etienne Pallier
	</div>
1045 263 Etienne Pallier
1046 263 Etienne Pallier
La DIV "content" insère 2 contenus :
1047 263 Etienne Pallier
	- le message flash éventuel (qui dit si une opération demandée s'est bien passée ou pas...)
1048 1 Etienne Pallier
	- la section "content", qui n'est autre que le coeur de la page
1049 1 Etienne Pallier
	
1050 263 Etienne Pallier
La page d'ACCUEIL n'est qu'un "content" parmi d'autres.
1051 263 Etienne Pallier
Elle se trouve dans app/View/Pages/home.ctp
1052 263 Etienne Pallier
(elle est affichée par le controleur de pages nommé PagesController)
1053 263 Etienne Pallier
1054 263 Etienne Pallier
1055 263 Etienne Pallier
1056 264 Etienne Pallier
* *COMMENT VOIR LES REQUETES SQL FAITES PAR CAKEPHP ?*
1057 264 Etienne Pallier
1058 263 Etienne Pallier
Dans le layout general (cakephp/app/View/Layouts/default.php), ajouter cette ligne :
1059 263 Etienne Pallier
	<?php echo $this->element('SQL_DUMP'); ?>
1060 263 Etienne Pallier
Vous devez aussi vous assurer que vous etes bien en mode DEBUG=2 (et non pas 0 ou 1)
1061 263 Etienne Pallier
dans le fichier de configuration Config/labinvent.php (ou bien dans le fichier Config/core.php)
1062 263 Etienne Pallier
1063 263 Etienne Pallier
1064 263 Etienne Pallier
1065 264 Etienne Pallier
* *OU EST FAIT LE CHARGEMENT DU FICHIER CONFIG database.php ?*
1066 264 Etienne Pallier
1067 263 Etienne Pallier
lib/Cake/Model/ConnectionManager.php (fonction _init())
1068 263 Etienne Pallier
Ce fichier fait partie de la librairie standard de CakePhp. Il ne faut donc pas y toucher.
1069 263 Etienne Pallier
A l'origine, j'avais (EP) changé ici le nom du fichier config "database.php" en "config.php",
1070 263 Etienne Pallier
ce qui marchait très très bien...
1071 263 Etienne Pallier
MAIS il ne vaut mieux pas modifier le comportement par défaut de cakephp,
1072 263 Etienne Pallier
car si un jour on change de version de cakephp, ça ne marchera plus.
1073 263 Etienne Pallier
1074 263 Etienne Pallier
1075 263 Etienne Pallier
1076 264 Etienne Pallier
* *CREATION ET GESTION DU NOUVEAU FICHIER DE CONFIG labinvent.php*
1077 264 Etienne Pallier
1078 263 Etienne Pallier
(cf http://book.cakephp.org/2.0/fr/development/configuration.html#loading-configuration-files)
1079 263 Etienne Pallier
1080 263 Etienne Pallier
1) J'ai créé le nouveau fichier de config dans app/Config/ (par exemple labinvent.php)
1081 263 Etienne Pallier
Ce fichier doit au minimum contenir un tableau nommé $config :
1082 263 Etienne Pallier
	$config = array(
1083 263 Etienne Pallier
			'labName' => 'IRAP',
1084 263 Etienne Pallier
			...
1085 263 Etienne Pallier
	);
1086 263 Etienne Pallier
 
1087 263 Etienne Pallier
2) Charger ce nouveau fichier de config au démarrage
1088 263 Etienne Pallier
Pour cela, ajouter cette ligne dans app/Config/bootstrap.php :
1089 263 Etienne Pallier
	Configure::load('labinvent');
1090 263 Etienne Pallier
1091 263 Etienne Pallier
3) Lire (ou même modifier) les paramètres de ce fichier de config, depuis N'IMPORTE OU (controleur, modèle, vue) :
1092 263 Etienne Pallier
		debug(Configure::version()); // pour afficher la version de Cakephp
1093 1 Etienne Pallier
		debug(Configure::read()); // tout lire
1094 1 Etienne Pallier
		debug(Configure::read('localisation')); // le tableau $localisation
1095 263 Etienne Pallier
		$labName = strtoupper(Configure::read('localisation.labNameShort'));
1096 263 Etienne Pallier
		debug(Configure::read('localisation.labName'));
1097 263 Etienne Pallier
		if (Configure::read('USE_LDAP')) ...
1098 263 Etienne Pallier
		if (Configure::read('debug') > 0 ) ...
1099 263 Etienne Pallier
On peut même modifier la valeur d'un paramètre dynamiquement comme ceci :
1100 263 Etienne Pallier
		Configure::write('debug',2)
1101 263 Etienne Pallier
C'est d'ailleurs ce qui est fait dans app/Config/core.php
1102 263 Etienne Pallier
1103 263 Etienne Pallier
1104 263 Etienne Pallier
4) Penser à modifier le script d'installation install/installation.sh pour qu'il prenne en compte ce nouveau fichier
1105 1 Etienne Pallier
1106 263 Etienne Pallier
1107 263 Etienne Pallier
1108 263 Etienne Pallier
1109 264 Etienne Pallier
* *LOCALISATION (adapatation du logiciel à l'entité locale)*
1110 263 Etienne Pallier
1111 263 Etienne Pallier
Vues (Pages) impactées :
1112 263 Etienne Pallier
- app/View/Layouts/default.ctp (template)
1113 263 Etienne Pallier
- app/View/Pages/home.ctp (Accueil)
1114 263 Etienne Pallier
- app/View/Pages/about.ctp (A propos)
1115 263 Etienne Pallier
1116 263 Etienne Pallier
Controleurs impactés :
1117 263 Etienne Pallier
- MaterielsController.php (fonction getLabNumber())
1118 1 Etienne Pallier
1119 1 Etienne Pallier
Documents impactés :
1120 263 Etienne Pallier
- Etiquette
1121 263 Etienne Pallier
- app/View/Documents/admission.ctp (Document d'admission)
1122 263 Etienne Pallier
- app/View/Documents/admission_cnrs.ctp (Document d'admission CNRS)
1123 263 Etienne Pallier
- app/View/Documents/admission_ups.ctp (Document d'admission UPS)
1124 1 Etienne Pallier
1125 263 Etienne Pallier
1126 263 Etienne Pallier
1127 264 Etienne Pallier
* *AJOUTER UNE NOUVELLE PAGE WEB*
1128 264 Etienne Pallier
1129 263 Etienne Pallier
Par exemple, voici ce que j'ai fait pour ajouter la page "about", qui est accessible via l'url https://inventirap.irap.omp.eu/pages/about
1130 263 Etienne Pallier
1) Aller dans app/View/Pages/
1131 263 Etienne Pallier
1) Faire un copier/coller d'une page existante, par exemple infos.ctp, et l'appeler about.ctp
1132 263 Etienne Pallier
2) Remplir cette page avec le contenu souhaité
1133 263 Etienne Pallier
3) Tester que cette page est bien accessible via l'url http://.../pages/about
1134 263 Etienne Pallier
4) Ajouter un lien vers cette page, soit dans le menu outils (app/View/Pages/tools.ctp), soit dans le menu général (app/View/Elements/menu.ctp)
1135 263 Etienne Pallier
5) Si cette page ne doit pas être accessible a tout le monde, définir le profil minimum exigé dans app/Controller/PagesController.php, en ajoutant une ligne dans le tableau $minProfileAllowedForPage
1136 263 Etienne Pallier
1137 263 Etienne Pallier
1138 263 Etienne Pallier
1139 264 Etienne Pallier
* *LOGIN workflow*
1140 263 Etienne Pallier
1141 263 Etienne Pallier
Controller/UtilisateursController/login() : 
1142 263 Etienne Pallier
; cherche l'utilisateur dans la table utilisateurs pour voir si c'est un user SPECIAL ou bien un user quelconque
1143 263 Etienne Pallier
; appelle Controller/Component/LdapAuthComponent/connection() et getUserName($ldapAuthentication)
1144 263 Etienne Pallier
1145 263 Etienne Pallier
Controller/Component/LdapAuthComponent : contient les 2 méthodes 
1146 263 Etienne Pallier
	- connection() : appelle Model/LdapConnection/ldapAuthentication($login, $password)
1147 263 Etienne Pallier
	- getUserName() : appelle Model/LdapConnection/getUserAttributes($ldapAuthentication)
1148 263 Etienne Pallier
1149 263 Etienne Pallier
Page d'accueil = View/Pages/home.ctp
1150 263 Etienne Pallier
(Controleur des pages simples = Controller/PagesController.php)
1151 263 Etienne Pallier
1152 263 Etienne Pallier
1153 263 Etienne Pallier
1154 264 Etienne Pallier
* *LOG*
1155 264 Etienne Pallier
1156 263 Etienne Pallier
$this->log('Something broke');
1157 263 Etienne Pallier
==> écrit dans cakephp/app/tmp/logs/ :
1158 263 Etienne Pallier
- error.log
1159 263 Etienne Pallier
- inventirap.log
1160 263 Etienne Pallier
1161 263 Etienne Pallier
1162 263 Etienne Pallier
1163 264 Etienne Pallier
* *GOOGLE ANALYTICS INTEGRATION*
1164 263 Etienne Pallier
1165 263 Etienne Pallier
adapté de http://blog.janjonas.net/2010-01-31/cakephp-google-analytics-integration
1166 1 Etienne Pallier
1167 263 Etienne Pallier
1) Copier ce code dans app/View/Elements/google-analytics.ctp :
1168 263 Etienne Pallier
<?php
1169 263 Etienne Pallier
$gaCode = Configure::read('google-analytics.tracker-code');
1170 263 Etienne Pallier
if ($gaCode) {
1171 263 Etienne Pallier
$googleAnalytics = <<<EOD
1172 263 Etienne Pallier
<script type="text/javascript">
1173 263 Etienne Pallier
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
1174 263 Etienne Pallier
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
1175 263 Etienne Pallier
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
1176 263 Etienne Pallier
  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
1177 263 Etienne Pallier
1178 263 Etienne Pallier
  ga('create', 'UA-45668893-3', 'omp.eu');
1179 263 Etienne Pallier
  ga('send', 'pageview');
1180 263 Etienne Pallier
1181 263 Etienne Pallier
</script>
1182 263 Etienne Pallier
EOD;
1183 263 Etienne Pallier
echo $googleAnalytics;
1184 263 Etienne Pallier
}
1185 263 Etienne Pallier
?>
1186 263 Etienne Pallier
1187 263 Etienne Pallier
/* ANCIEN CODE JAVASCRIPT :
1188 263 Etienne Pallier
<script type="text/javascript">
1189 263 Etienne Pallier
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
1190 263 Etienne Pallier
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
1191 263 Etienne Pallier
</script>
1192 263 Etienne Pallier
<script type="text/javascript">
1193 263 Etienne Pallier
try {
1194 1 Etienne Pallier
var pageTracker = _gat._getTracker("$gaCode");
1195 1 Etienne Pallier
pageTracker._trackPageview();
1196 263 Etienne Pallier
} catch(err) {}</script>
1197 263 Etienne Pallier
*/
1198 263 Etienne Pallier
1199 263 Etienne Pallier
1200 263 Etienne Pallier
1201 263 Etienne Pallier
2) Inclure le view element dans app/View/Layouts/default.ctp (juste avant </body>):
1202 263 Etienne Pallier
<?php echo $this->element('google-analytics'); ?>
1203 1 Etienne Pallier
1204 1 Etienne Pallier
3) Définir le tracker code dans la configuration (/app/Config/core.php):
1205 263 Etienne Pallier
Configure::write('google-analytics.tracker-code', false); // disables Google Analytics
1206 263 Etienne Pallier
Configure::write('google-analytics.tracker-code', 'YOUR-TRACKING-CODE'); // enables Google Analytics
1207 263 Etienne Pallier
1208 263 Etienne Pallier
1209 264 Etienne Pallier
* *GENERALITES*
1210 263 Etienne Pallier
1211 263 Etienne Pallier
- URL : http://localhost/inventirapsvn/cakephp/
1212 263 Etienne Pallier
1213 263 Etienne Pallier
- BD admin : http://localhost/phpmyadmin
1214 263 Etienne Pallier
1215 263 Etienne Pallier
- LOG : cakephp/app/tmp/logs/inventirap.log
1216 263 Etienne Pallier
1217 263 Etienne Pallier
- (UPDATE : cd Inventirap/ ; chmod -R 777 ./cakephp/app/tmp/)
1218 263 Etienne Pallier
1219 263 Etienne Pallier
- (SORTIE INVENTAIRE a faire : pc portable DELL (ex Nicolas Andre) - sept 2012 CNES 4017 (carte mere hs))
1220 263 Etienne Pallier
1221 263 Etienne Pallier
- Eclipse config :
1222 263 Etienne Pallier
Setup syntax highlighting for .ctp files:
1223 263 Etienne Pallier
Window > Preferences > General > Appearance > content Types > Text > PHP Content type > Add.. , then put in *.ctp.
1224 263 Etienne Pallier
1225 263 Etienne Pallier
- Cakephp config : cakephp/app/Config/
1226 263 Etienne Pallier
Mode debug ON (pour voir les erreurs et pour vider le cache en cas de changement sur la BD) 
1227 263 Etienne Pallier
core.php : 	Configure::write('debug', 1);
1228 263 Etienne Pallier
1229 263 Etienne Pallier
- Fichier de demarrage :
1230 263 Etienne Pallier
cakephp/index.php (qui pointe sur cakephp/app/webroot/index.php)
1231 263 Etienne Pallier
(Attention, il y a aussi un fichier cakephp/app/index.php qui pointe sur webroot/index.php)
1232 263 Etienne Pallier
(ROOT doit pointer sur le dossier cakephp/)
1233 263 Etienne Pallier
Le fichier execute ensuite est cakephp/lib/Cake/bootstrap.php qui lance ./Core/App.php
1234 263 Etienne Pallier
and so on...
1235 263 Etienne Pallier
1236 263 Etienne Pallier
1237 263 Etienne Pallier
1238 263 Etienne Pallier
1239 264 Etienne Pallier
* *RECHERCHE de materiels*
1240 264 Etienne Pallier
1241 263 Etienne Pallier
3 methodes :
1242 263 Etienne Pallier
- recherche generale (sous le menu general) : cakephp/app/View/Elements/menu.ctp
1243 1 Etienne Pallier
- VUE de recherche : cakephp/app/View/Materiels/find.ctp
1244 1 Etienne Pallier
- ACTION de recherche : cakephp/app/Controller/MaterielsController (methode find())
1245 263 Etienne Pallier
1246 263 Etienne Pallier
1247 263 Etienne Pallier
1248 264 Etienne Pallier
* *ACL (Controle d'acces aux ressources)*
1249 264 Etienne Pallier
1250 263 Etienne Pallier
NB: Cette section n'est sans doute plus très à jour ; sur ce sujet, il est préférable de lire le document docs/userguide/ACL.doc (ou .pdf)
1251 263 Etienne Pallier
1252 263 Etienne Pallier
Synthese sur les droits selon le profil
1253 263 Etienne Pallier
1254 1 Etienne Pallier
Profils (roles), dans le sens du pouvoir croissant :
1255 1 Etienne Pallier
Qq = Utilisateur Quelconque (lambda)
1256 263 Etienne Pallier
Rp = Responsable
1257 263 Etienne Pallier
Ad = Administration
1258 263 Etienne Pallier
Sa = Superadmin
1259 263 Etienne Pallier
1260 263 Etienne Pallier
Actions :
1261 263 Etienne Pallier
C = Create
1262 263 Etienne Pallier
R = Read (voir, consulter)
1263 263 Etienne Pallier
U = Update (mettre a jour)
1264 263 Etienne Pallier
D = Delete (supprimer)
1265 263 Etienne Pallier
V = Valider un materiel CREATED --> passe alors en statut VALIDATED
1266 263 Etienne Pallier
A = Demander l'Archivage d'un materiel VALIDATED --> passe alors en statut TOBEARCHIVED 
1267 263 Etienne Pallier
S = Sortir de l'inventaire (Valider une demande d'archivage d'un materiel TOBEARCHIVED) --> passe alors en statut ARCHIVED 
1268 263 Etienne Pallier
E = Exporter
1269 263 Etienne Pallier
1270 263 Etienne Pallier
Par defaut, le superadmin a acces a TOUT 
1271 263 Etienne Pallier
1272 263 Etienne Pallier
Materiels :
1273 263 Etienne Pallier
- Qq a les droits C, R (sauf champs admin), U (si createur et sauf champs admin), A, D (si CREATED et owner)
1274 263 Etienne Pallier
- Rp a les droits C, R (sauf champs admin), U (sauf champs admin), D (si CREATED), V, A, E
1275 263 Etienne Pallier
- Ad a les droits C, R, U (ssi NOT ARCHIVED), D (si CREATED), V, (A mais inutile car fait directement S sans passer par A), S, E
1276 263 Etienne Pallier
1277 263 Etienne Pallier
Suivis et Emprunts :
1278 263 Etienne Pallier
- Dans tous les cas, on ne doit pas pouvoir emprunter ou suivre un materiel non valide (CREATED)
1279 263 Etienne Pallier
- Qq a les droits C, R, U (si createur), D (si createur)
1280 263 Etienne Pallier
- Rp a les droits C, R, U, D
1281 263 Etienne Pallier
- Ad a les memes droits que Rp
1282 263 Etienne Pallier
1283 263 Etienne Pallier
VUES specifiques :
1284 263 Etienne Pallier
- Acces aux Outils : reserve a Rp et Ad (vue contenant des liens vers differentes ressources telles que utilisateurs, materiels, categories...)
1285 263 Etienne Pallier
- L'administration a une vue resumee sur la page d'accueil (liens directs vers actions a faire)
1286 263 Etienne Pallier
- L'administration a une vue enrichie de la liste des materiels :
1287 263 Etienne Pallier
	- filtres (y-compris sur ARCHIVED)
1288 263 Etienne Pallier
	- export en CSV (pour tableur Excel)
1289 263 Etienne Pallier
	- upgrade du statut (validation et sortie)
1290 263 Etienne Pallier
1291 263 Etienne Pallier
Autres regles (de gestion) importantes :
1292 264 Etienne Pallier
- un materiel non valide (CREATED) peut etre supprime uniquement par le createur de la fiche, le responsable (Roger), et l'administration
1293 264 Etienne Pallier
Idem pour la mise a jour de cette fiche
1294 263 Etienne Pallier
- un materiel valide (VALIDATED) n'est pas supprimable
1295 263 Etienne Pallier
- les champs ADMINISTRATIFS d'un materiel ne sont visibles et modifiables que par l'administration
1296 263 Etienne Pallier
- par defaut, la liste des materiels affiche tous les materiels SAUF ceux qui sont sortis de l'inventaire (ARCHIVED) qui sont donc masques.
1297 263 Etienne Pallier
Il est de toutes facons toujours possible (pour l'administration seulement) de les voir, grace au nouveau filtre "Archives" present sur la liste des materiels
1298 263 Etienne Pallier
- la recherche doit s'effectuer dans TOUS les materiels (y-compris ARCHIVED)
1299 263 Etienne Pallier
1300 263 Etienne Pallier
1301 263 Etienne Pallier
1302 263 Etienne Pallier
1303 264 Etienne Pallier
* *COMMENT CONTOURNER LE LDAP officiel*
1304 264 Etienne Pallier
1305 263 Etienne Pallier
(ATTENTION: CONTENU OBSOLETE A METTRE A JOUR (EP))
1306 263 Etienne Pallier
1307 263 Etienne Pallier
(cf Controller/UtilisateursController.php :	methode login())
1308 263 Etienne Pallier
1309 263 Etienne Pallier
1) Si on veut tester le LDAP, on peut utiliser le LDAP de la Virtual Machine Upsilon (CentOS 6)
1310 263 Etienne Pallier
Dans ce cas, il faut ajouter dans la BD les utilisateurs specifiques suivants :
1311 263 Etienne Pallier
# Ajout d'utilisateurs de TEST (LDAP upsilon)
1312 263 Etienne Pallier
INSERT INTO utilisateurs (nom, login, email, role, groupes_metier_id) VALUES
1313 263 Etienne Pallier
 	('Hillembrand Cedric', 'Cedric', 'Cedric.Hillembrand@irap.omp.eu', 'Super Administrateur', 1),
1314 263 Etienne Pallier
 	('Turner Daniel', 'Daniel', 'Daniel.Turner@irap.omp.eu', 'Administration', 1),
1315 263 Etienne Pallier
 	('Sky Gin', 'Gin', 'Gin.Sky@irap.omp.eu', 'Responsable', 1),
1316 263 Etienne Pallier
 	('Robert Henri', 'Henri', 'Henri.Robert', 'Utilisateur', 1);
1317 263 Etienne Pallier
1318 263 Etienne Pallier
2) Sinon, le plus simple est d'utiliser un FAUX (fake) LDAP interne a l'application
1319 263 Etienne Pallier
Dans ce cas, il faut decommenter la variable $fakeLDAP dans le fichier config.php et ajouter dans la BD les utilisateurs specifiques suivants :
1320 263 Etienne Pallier
# Ajout d'utilisateurs de TEST (hors LDAP)
1321 263 Etienne Pallier
INSERT INTO utilisateurs (nom, login, email, role, groupes_metier_id) VALUES
1322 263 Etienne Pallier
 	('Hubert SuperAdmin', 'superadmin', 'hubert.superadmin@irap.omp.eu', 'Super Administrateur', 1),
1323 263 Etienne Pallier
 	('Pierre Responsable', 'responsable', 'pierre.resp@irap.omp.eu', 'Responsable', 2),
1324 263 Etienne Pallier
 	('Jean Administration', 'admin', 'Jean.Administration@irap.omp.eu', 'Administration', 5),
1325 263 Etienne Pallier
 	('Jacques Utilisateur', 'user', 'Jacques.Utilisateur@irap.omp.eu', 'Utilisateur', 7);
1326 263 Etienne Pallier
1327 263 Etienne Pallier
Informations sur le LDAP :
1328 263 Etienne Pallier
1329 263 Etienne Pallier
Classe LdapAuthComponent (extends AuthComponent), definie dans : app/Controller/Component/LdapAuthComponent.php 
1330 263 Etienne Pallier
1331 263 Etienne Pallier
Definition des roles (ACL) : app/Model/Utilisateur.php :
1332 263 Etienne Pallier
	private $acceptedRoles = array ('Utilisateur', 'Responsable', 'Administration', 'Super Administrateur');
1333 263 Etienne Pallier
	public function getAuthenticationLevelFromRole($role) {
1334 263 Etienne Pallier
		if ($role == 'Utilisateur')
1335 263 Etienne Pallier
			return 1;
1336 263 Etienne Pallier
		elseif ($role == 'Responsable')
1337 263 Etienne Pallier
			return 2;
1338 263 Etienne Pallier
		elseif ($role == 'Administration')
1339 263 Etienne Pallier
			return 3;
1340 263 Etienne Pallier
		elseif ($role == 'Super Administrateur')
1341 263 Etienne Pallier
			return 4;
1342 263 Etienne Pallier
		return 0;
1343 263 Etienne Pallier
	}
1344 263 Etienne Pallier
1345 263 Etienne Pallier
Lecture du fichier de config : app/Model/LdapConnection.php :
1346 263 Etienne Pallier
		private function checkConfiguration()
1347 263 Etienne Pallier
1348 263 Etienne Pallier
Workflow du LDAP :
1349 263 Etienne Pallier
1) Page d'accueil : j'entre mon login et pwd
1350 263 Etienne Pallier
2) clic sur bouton "Se Connecter" --> execute l'action Utilisateurs/login (dans app/Controller/UtilisateursController.php)
1351 263 Etienne Pallier
1352 263 Etienne Pallier
1353 263 Etienne Pallier
1354 263 Etienne Pallier
1355 263 Etienne Pallier
1356 264 Etienne Pallier
* *COMMENT AJOUTER UNE NOUVELLE TABLE DANS LA BD*
1357 263 Etienne Pallier
1358 263 Etienne Pallier
On explique ici ce qu'il faut faire quand on veut ajouter une nouvelle table dans la base de données, 
1359 263 Etienne Pallier
table qui doit être prise en compte dans l'application.
1360 263 Etienne Pallier
Cette explication est donnée avec 2 exemples.
1361 263 Etienne Pallier
1362 263 Etienne Pallier
1) Premier exemple : ajout de la table sur-categorie (EP)
1363 263 Etienne Pallier
1364 263 Etienne Pallier
Avant cet ajout, il n'y avait que la table categorie et la table sous-categorie.
1365 263 Etienne Pallier
Vous trouverez plus de détails sur ce sujet dans la section suivante nommée "COMMENT J'AI FAIT POUR AJOUTER UN 3eme niveau de categorie appele sur_categorie (ou domaine)"
1366 263 Etienne Pallier
1367 263 Etienne Pallier
a) impact sur la BD
1368 263 Etienne Pallier
- ajout d'une nouvelle table sur_categories(id,nom) :
1369 263 Etienne Pallier
CREATE TABLE IF NOT EXISTS sur_categories (
1370 263 Etienne Pallier
  id int(11) NOT NULL AUTO_INCREMENT,
1371 263 Etienne Pallier
  nom varchar(45) DEFAULT NULL,
1372 263 Etienne Pallier
  PRIMARY KEY (id),
1373 263 Etienne Pallier
  UNIQUE KEY nom_UNIQUE (nom)
1374 263 Etienne Pallier
) ENGINE=InnoDB  DEFAULT CHARSET=latin1;
1375 263 Etienne Pallier
1376 263 Etienne Pallier
- ajout dans la table categories d'une cle etrangere sur_categorie_id :
1377 263 Etienne Pallier
ALTER TABLE categories 
1378 263 Etienne Pallier
	ADD sur_categorie_id INT( 11 ) NULL DEFAULT NULL,
1379 263 Etienne Pallier
  	ADD CONSTRAINT fk_sur_categorie_id FOREIGN KEY (sur_categorie_id) REFERENCES sur_categories (id) ON DELETE NO ACTION ON UPDATE NO ACTION;
1380 263 Etienne Pallier
1381 263 Etienne Pallier
- ajout dans la table materiels d'une cle etrangere sur_categorie_id :
1382 263 Etienne Pallier
ALTER TABLE materiels 
1383 263 Etienne Pallier
	ADD sur_categorie_id INT( 11 ) NOT NULL after designation,
1384 263 Etienne Pallier
	ADD CONSTRAINT fk_materiels_sur_categorie_id FOREIGN KEY (sur_categorie_id) REFERENCES sur_categories (id) ON DELETE NO ACTION ON UPDATE NO ACTION;
1385 263 Etienne Pallier
1386 263 Etienne Pallier
(attention, il faut d'abord vider les lignes des tables suivis, emprunts, et materiels)
1387 263 Etienne Pallier
delete from suivis;
1388 263 Etienne Pallier
delete from emprunts;
1389 263 Etienne Pallier
delete from materiels;
1390 1 Etienne Pallier
1391 263 Etienne Pallier
Il faut aussi ajouter des sur-categories :
1392 263 Etienne Pallier
# Ajout de quelques sur-categories
1393 263 Etienne Pallier
insert into sur_categories (id,nom) values 
1394 263 Etienne Pallier
(1,'Electronique'), 
1395 263 Etienne Pallier
(2,'Informatique'), 
1396 263 Etienne Pallier
(3,'Instrumentation')
1397 263 Etienne Pallier
(4, 'Logistique'),
1398 263 Etienne Pallier
(5, 'Mecanique'),
1399 263 Etienne Pallier
(6, 'Optique')
1400 263 Etienne Pallier
;
1401 263 Etienne Pallier
1402 263 Etienne Pallier
# Relier toutes les categories a une sur-categorie (la 1)
1403 263 Etienne Pallier
update categories set sur_categorie_id=1 where id<10; 
1404 263 Etienne Pallier
update categories set sur_categorie_id=2 where id>=10 and id<20; 
1405 263 Etienne Pallier
update categories set sur_categorie_id=3 where id>=20;
1406 263 Etienne Pallier
1407 263 Etienne Pallier
1408 263 Etienne Pallier
b) impact sur les modeles (cakephp/app/Model)
1409 263 Etienne Pallier
- Ajout du nouveau modèle SurCategorie.php : copie de Categorie.php avec "hasMany categorie"
1410 263 Etienne Pallier
- Modif du modèle Categorie.php : + belongsTo="SurCategorie"
1411 263 Etienne Pallier
1412 263 Etienne Pallier
c) impact sur les controleurs (cakephp/app/Controller)
1413 263 Etienne Pallier
- Ajout du nouveau controleur SurCategoriesController.php : minimaliste (comme CategoriesController)
1414 1 Etienne Pallier
- Modif du controleur CategoriesController.php : +getBySurCategorie()
1415 263 Etienne Pallier
1416 263 Etienne Pallier
d) impact sur les vues (cakephp/app/View)
1417 263 Etienne Pallier
- SurCategorie : no view (scaffold ?)
1418 263 Etienne Pallier
- Categorie : actuellement no view (scaffold ?) 
1419 263 Etienne Pallier
--> creer une vue (comme SousCategorie) 
1420 263 Etienne Pallier
+ get_by_surcategorie.ctp
1421 263 Etienne Pallier
+ scaffold.form.ctp
1422 263 Etienne Pallier
1423 263 Etienne Pallier
e) View/Pages/tools.ctp : ajouter une entree au menu pour les Sur-Categories
1424 263 Etienne Pallier
1425 263 Etienne Pallier
f) impact sur TOUTES les vues de Materiel
1426 263 Etienne Pallier
add/edit/view/index
1427 263 Etienne Pallier
dans la vue index, remplacer la categorie par la sur-categorie
1428 263 Etienne Pallier
GROS BOULOT sur la vue ADD/EDIT (+ javascript)
1429 263 Etienne Pallier
1430 263 Etienne Pallier
1431 263 Etienne Pallier
2) Deuxième exemple : ajout de la table type_suivis (VM)
1432 263 Etienne Pallier
1433 263 Etienne Pallier
Un peu plus haut est expliqué comment créer une table, je vais ici expliquer comment créer et remplir tout ce qui est basiquement 
1434 263 Etienne Pallier
nécessaire pour l'utiliser, en prenant pour exemple la table type_suivis.
1435 263 Etienne Pallier
1436 263 Etienne Pallier
Après avoir créé la table, on lui crée :
1437 263 Etienne Pallier
- Un controller : Héritant de AppController, avec une variable $scaffold sui se chargera de presque tout et une variable $name avec son nom.
1438 263 Etienne Pallier
- Un model : Avec la même variable $name et une variable $displayField qui correspond a la designation dans la BDD (ex: "nom");
1439 263 Etienne Pallier
	Il doit contenir la fonction typeSuiviNameIsUnik($name) {} (qu'on retrouve dans sites ou organisme) ainsi que le $validate comprenant les validations necessaires. 
1440 263 Etienne Pallier
- Une vue, selon l'utilité, n'est pas forcément nécessaire grâce au scaffold.
1441 263 Etienne Pallier
Par la suite, pour lister son contenu via un lien dans "outils" par exemple, il suffit de créer le chemin dans view/pages/tools.ctp.
1442 263 Etienne Pallier
1443 263 Etienne Pallier
1444 263 Etienne Pallier
1445 264 Etienne Pallier
* *CREER UN CHAMP DATE (VM)*
1446 263 Etienne Pallier
1447 263 Etienne Pallier
Pour expliquer comment créer un champ date fonctionnel, je vais prendre l'exemple de la Date de reception.
1448 263 Etienne Pallier
Une fois vôtre colonne créé dans la table marteriel, vous devrez faire des modifications dans : 
1449 263 Etienne Pallier
1450 263 Etienne Pallier
MaterielController : //Passer la date au format français	
1451 263 Etienne Pallier
1452 263 Etienne Pallier
		if(isset($this->request->data['Materiel']['date_reception'])){
1453 263 Etienne Pallier
		$this->request->data['Materiel']['date_reception'] = date("d-m-Y", strtotime($this->request->data['Materiel']['date_reception'])); }
1454 263 Etienne Pallier
1455 263 Etienne Pallier
le Model Materiel : Créer un champ de validation adapté à la date, avec un regex. Et surtout remplir le formatage de date à l'américaine :
1456 263 Etienne Pallier
1457 263 Etienne Pallier
		if (isset($this->data['Materiel']['date_reception'])) {
1458 263 Etienne Pallier
			$originalDate = $this->data['Materiel']['date_reception'];
1459 263 Etienne Pallier
			$this->data['Materiel']['date_reception'] = date("Y-m-d", strtotime($originalDate));
1460 263 Etienne Pallier
		}
1461 263 Etienne Pallier
1462 263 Etienne Pallier
La vue Materiel : - Scaffold.view : Repasser la date en français et l'afficher.
1463 263 Etienne Pallier
				  - Scaffold.form : Créer le champ date du formulaire
1464 263 Etienne Pallier
1465 263 Etienne Pallier
Puis il faut adapter le champ date reception presque partout ou il y a le champ date acquisition.
1466 263 Etienne Pallier
1467 263 Etienne Pallier
1468 263 Etienne Pallier
1469 263 Etienne Pallier
1470 263 Etienne Pallier
1471 264 Etienne Pallier
* *COMMENT J'AI FAIT POUR AJOUTER UN 3eme niveau de categorie appele sur_categorie (ou domaine) (EP) ?*
1472 263 Etienne Pallier
1473 263 Etienne Pallier
je me rends compte d'une incoherence de stockage dans la table Materiels.
1474 263 Etienne Pallier
En effet, quand on saisit un materiel, on doit choisir une categorie ET une sous-categorie.
1475 263 Etienne Pallier
Du coup, les 2 id (categorie + sous-categorie) sont stockes dans la table Materiels...
1476 263 Etienne Pallier
Or, c'est inutile car la sous-categorie suffit a determiner la categorie...
1477 263 Etienne Pallier
Cette redondance pourrait meme amener des incoherences dans la table Materiels si par exemple on fait des modifications 
1478 263 Etienne Pallier
dans les tables categories et sous_categories sans les repercuter dans la table materiels !!
1479 263 Etienne Pallier
Je suppose que c'est un choix de facilite qui a ete fait par upsilon.
1480 263 Etienne Pallier
1481 263 Etienne Pallier
Donc, si vous etes ok, et a moins que Upsilon me dise qu'il y avait une bonne raison de faire ce choix (j'en doute),
1482 263 Etienne Pallier
je propose de modifier le code pour que seule la sous-categorie soit stockee (on ne stocke plus la categorie).
1483 263 Etienne Pallier
1484 263 Etienne Pallier
En plus, cela simplifiera l'ajout du 3eme niveau "sur-categorie" puisque lui-meme n'aura pas besoin d'etre stocke etant donne qu'il est automatiquement determine par la categorie.
1485 263 Etienne Pallier
On aura alors :
1486 263 Etienne Pallier
sous_categorie_id -> categorie_id -> sur_categorie_id
1487 263 Etienne Pallier
Avec seulement la sous_categorie, on pourra determiner la categorie, et donc la sur_categorie. 
1488 263 Etienne Pallier
1489 263 Etienne Pallier
Du coup, si je fais cette modif, on pourrait meme se permettre de demarrer officiellement INVENTIRAP rapidement.
1490 263 Etienne Pallier
En effet, l'ajout de la sur-categorie ne change rien au contenu des tables "administratives" (materiels, emprunts, suivis), 
1491 263 Etienne Pallier
et donc on pourra le faire plus tard, meme apres que l'administration ait commence a remplir la BD. 
1492 263 Etienne Pallier
Ca sera totalement transparent.
1493 263 Etienne Pallier
1494 263 Etienne Pallier
1) suppression de la redondance (categorie_id) dans la table materiels
1495 263 Etienne Pallier
1496 263 Etienne Pallier
a) impact sur la vue index de Materiel
1497 263 Etienne Pallier
add/edit/view/index
1498 263 Etienne Pallier
1499 263 Etienne Pallier
2) ajout d'une sur-categorie
1500 263 Etienne Pallier
1501 263 Etienne Pallier
a) impact sur la BD
1502 263 Etienne Pallier
- ajout d'une nouvelle table sur_categories(id,nom) :
1503 263 Etienne Pallier
CREATE TABLE IF NOT EXISTS sur_categories (
1504 263 Etienne Pallier
  id int(11) NOT NULL AUTO_INCREMENT,
1505 263 Etienne Pallier
  nom varchar(45) DEFAULT NULL,
1506 263 Etienne Pallier
  PRIMARY KEY (id),
1507 263 Etienne Pallier
  UNIQUE KEY nom_UNIQUE (nom)
1508 1 Etienne Pallier
) ENGINE=InnoDB  DEFAULT CHARSET=latin1;
1509 263 Etienne Pallier
1510 263 Etienne Pallier
- ajout dans la table categories d'une cle etrangere sur_categorie_id :
1511 263 Etienne Pallier
ALTER TABLE categories 
1512 263 Etienne Pallier
	ADD sur_categorie_id INT( 11 ) NULL DEFAULT NULL,
1513 263 Etienne Pallier
  	ADD CONSTRAINT fk_sur_categorie_id FOREIGN KEY (sur_categorie_id) REFERENCES sur_categories (id) ON DELETE NO ACTION ON UPDATE NO ACTION;
1514 263 Etienne Pallier
1515 263 Etienne Pallier
- ajout dans la table materiels d'une cle etrangere sur_categorie_id :
1516 263 Etienne Pallier
ALTER TABLE materiels 
1517 263 Etienne Pallier
	ADD sur_categorie_id INT( 11 ) NOT NULL after designation,
1518 263 Etienne Pallier
	ADD CONSTRAINT fk_materiels_sur_categorie_id FOREIGN KEY (sur_categorie_id) REFERENCES sur_categories (id) ON DELETE NO ACTION ON UPDATE NO ACTION;
1519 263 Etienne Pallier
1520 263 Etienne Pallier
(attention, il faut d'abord vider les lignes des tables suivis, emprunts, et materiels)
1521 263 Etienne Pallier
delete from suivis;
1522 263 Etienne Pallier
delete from emprunts;
1523 263 Etienne Pallier
delete from materiels;
1524 263 Etienne Pallier
1525 263 Etienne Pallier
Il faut aussi ajouter des sur-categories :
1526 263 Etienne Pallier
# Ajout de quelques sur-categories
1527 263 Etienne Pallier
insert into sur_categories (id,nom) values 
1528 263 Etienne Pallier
(1,'Electronique'), 
1529 263 Etienne Pallier
(2,'Informatique'), 
1530 263 Etienne Pallier
(3,'Instrumentation')
1531 263 Etienne Pallier
(4, 'Logistique'),
1532 263 Etienne Pallier
(5, 'Mecanique'),
1533 263 Etienne Pallier
(6, 'Optique')
1534 263 Etienne Pallier
;
1535 263 Etienne Pallier
1536 263 Etienne Pallier
# Relier toutes les categories a une sur-categorie (la 1)
1537 263 Etienne Pallier
update categories set sur_categorie_id=1 where id<10; 
1538 263 Etienne Pallier
update categories set sur_categorie_id=2 where id>=10 and id<20; 
1539 263 Etienne Pallier
update categories set sur_categorie_id=3 where id>=20;
1540 263 Etienne Pallier
1541 263 Etienne Pallier
1542 263 Etienne Pallier
b) impact sur les modeles (cakephp/app/Model)
1543 263 Etienne Pallier
- SurCategorie.php : copie de Categorie.php avec "hasMany categorie"
1544 263 Etienne Pallier
- Categorie.php : + belongsTo="SurCategorie"
1545 263 Etienne Pallier
1546 263 Etienne Pallier
c) impact sur les controleurs (cakephp/app/Controller)
1547 263 Etienne Pallier
- SurCategoriesController.php : minimaliste (comme CategoriesController)
1548 263 Etienne Pallier
- CategoriesController.php : +getBySurCategorie()
1549 263 Etienne Pallier
1550 263 Etienne Pallier
d) impact sur les vues (cakephp/app/View)
1551 263 Etienne Pallier
- SurCategorie : no view (scaffold ?)
1552 263 Etienne Pallier
- Categorie : actuellement no view (scaffold ?) 
1553 263 Etienne Pallier
--> creer une vue (comme SousCategorie) 
1554 263 Etienne Pallier
+ get_by_surcategorie.ctp
1555 263 Etienne Pallier
+ scaffold.form.ctp
1556 263 Etienne Pallier
1557 263 Etienne Pallier
e) View/Pages/tools.ctp : ajouter une entree au menu pour les Sur-Categories
1558 263 Etienne Pallier
1559 263 Etienne Pallier
f) impact sur TOUTES les vues de Materiel
1560 263 Etienne Pallier
add/edit/view/index
1561 263 Etienne Pallier
dans la vue index, remplacer la categorie par la sur-categorie
1562 263 Etienne Pallier
GROS BOULOT sur la vue ADD/EDIT (+ javascript)
1563 263 Etienne Pallier
1564 263 Etienne Pallier
1565 263 Etienne Pallier
1566 263 Etienne Pallier
1567 264 Etienne Pallier
* *TESTS*
1568 263 Etienne Pallier
1569 263 Etienne Pallier
A - EXECUTION
1570 263 Etienne Pallier
1571 263 Etienne Pallier
Prérequis : PHPUNIT 3 doit être déjà installé et accessible depuis la console (phpunit -version) via le fichier php.ini
1572 263 Etienne Pallier
(ATTENTION : cakephp 2.x n'est pas compatible avec PhpUnit 4)
1573 263 Etienne Pallier
1574 263 Etienne Pallier
Avec XAMPP (conseillé) : PhpUnit 3 est déjà inclus
1575 263 Etienne Pallier
Avec MAMP (+ difficile) : pour installer PhpUnit, suivre cette documentation : http://www.dolinaj.net/software-installation/mac/how-to-install-phpunit-with-mamp-on-mac/
1576 263 Etienne Pallier
1577 263 Etienne Pallier
Procédure à suivre pour pouvoir exécuter les tests unitaires et fonctionnels livrés avec le logiciel :
1578 263 Etienne Pallier
1579 263 Etienne Pallier
1) Ajouter une nouvelle configuration de base de données dans votre fichier app/Config/database.php pour la BD de test
1580 263 Etienne Pallier
 
1581 263 Etienne Pallier
 Exemple de configuration :
1582 263 Etienne Pallier
 
1583 263 Etienne Pallier
	public $test = array(
1584 263 Etienne Pallier
		'datasource' => 'Database/Mysql',
1585 263 Etienne Pallier
		'persistent' => false,
1586 263 Etienne Pallier
		'host' => 'localhost',
1587 263 Etienne Pallier
		'database' => 'test_labinvent',
1588 263 Etienne Pallier
		'login' => 'root',
1589 263 Etienne Pallier
		'password' => '',
1590 263 Etienne Pallier
	);
1591 263 Etienne Pallier
1592 263 Etienne Pallier
1593 263 Etienne Pallier
2) Créer la BD de test (vide)
1594 263 Etienne Pallier
A l'aide de phpmyadmin ou bien avec un client mysql quelconque,
1595 263 Etienne Pallier
créer une BD de test vide que vous nommerez avec le même nom que celui donné dans la configuration ci-dessus,
1596 263 Etienne Pallier
soit pour l'exemple, "test_labinvent"
1597 263 Etienne Pallier
Syntaxe SQL : "create database test_labinvent"
1598 263 Etienne Pallier
1599 263 Etienne Pallier
3) Passer en mode "debug" 
1600 263 Etienne Pallier
Dans votre fichier de configuration labinvent.php, mettez votre paramètre "debug" à 1 ou 2 (mais pas à 0) :
1601 263 Etienne Pallier
		'debug' => 2,
1602 263 Etienne Pallier
1603 263 Etienne Pallier
4) Se connecter à l'application
1604 263 Etienne Pallier
Les test ne passeront pas si vous n'êtes pas connectés 
1605 263 Etienne Pallier
 
1606 263 Etienne Pallier
5) Exécuter les tests
1607 263 Etienne Pallier
1608 263 Etienne Pallier
a) Exécution depuis l'application (conseillé) :
1609 263 Etienne Pallier
ATTENTION : vous devez être logué pour que les tests passent !!!
1610 263 Etienne Pallier
Il suffit d'aller à l'URL /test.php de votre installation du logiciel LabInvent
1611 263 Etienne Pallier
(vous pouvez aussi essayer l'URL "/app/webroot/test.php", ou encore "/cakephp/test.php")
1612 263 Etienne Pallier
Cette page de tests se trouve dans cakephp/app/webroot/
1613 263 Etienne Pallier
Vous avez alors accès à 2 types de tests :
1614 263 Etienne Pallier
- App : Tests ==> les tests écris pour tester l'application Labinvent
1615 263 Etienne Pallier
- Core : Tests ==> les tests fournis avec cakephp pour tester le framework
1616 263 Etienne Pallier
Pour exécuter tous les tests liés à l'application Labinvent (à faire systématiquement avant de commiter tout changement) :
1617 263 Etienne Pallier
cliquer sur "Tests" sous "App", puis sur "AllTests"
1618 263 Etienne Pallier
("AllController" exécute tous les tests de controleurs ; "AllModel" exécute tous les tests de modèles)
1619 263 Etienne Pallier
1620 263 Etienne Pallier
b) Execution depuis la console :
1621 263 Etienne Pallier
Aller dans le repertoire app/
1622 263 Etienne Pallier
Pour tester le controleur MaterielsController :
1623 263 Etienne Pallier
./Console/cake test app Controller/MaterielsController
1624 263 Etienne Pallier
1625 263 Etienne Pallier
1626 263 Etienne Pallier
B - ECRITURE DE NOUVEAUX TESTS
1627 263 Etienne Pallier
1628 263 Etienne Pallier
cf http://book.cakephp.org/2.0/en/development/testing.html
1629 263 Etienne Pallier
1630 263 Etienne Pallier
Aller dans app/Test/
1631 263 Etienne Pallier
1632 263 Etienne Pallier
Ce dossier contient l'arborescence suivante :
1633 263 Etienne Pallier
1634 263 Etienne Pallier
- Case/ : les tests
1635 263 Etienne Pallier
	- Controller/ : les tests de controleurs
1636 263 Etienne Pallier
	- Model/ : les tests de modèles
1637 263 Etienne Pallier
	- View/ (peu ou pas utilisé) : les tests de vues (ou de helpers)
1638 263 Etienne Pallier
	- AllControllerTest.php : exécution de tous les tests de controleurs
1639 263 Etienne Pallier
	- AllModelTest.php : exécution de tous les tests de modèles
1640 263 Etienne Pallier
	- AllTestsTest.php : éxécution de TOUS les tests
1641 263 Etienne Pallier
	
1642 263 Etienne Pallier
- Fixture/ : les différentes initialisations nécessaires dans la BD de test pour pouvoir executer les tests
1643 263 Etienne Pallier
Ces "fixtures" sont automatiquement executees AU DEBUT de chaque test.
1644 263 Etienne Pallier
Ce dossier contient un fichier pour chaque table pour laquelle on a besoin d'une "fixture".
1645 263 Etienne Pallier
1646 263 Etienne Pallier
1) Les "fixtures"
1647 263 Etienne Pallier
1648 263 Etienne Pallier
La façon la plus basique de creer une fixture pour une table donnee est de la realiser automatiquement a partir d'une copie de la table de la vraie BD.
1649 263 Etienne Pallier
Par exemple, pour que la table "categories" de la BD de test contienne la meme chose que la table de la vraie BD, il suffit de creer un fichier CategorieFixture.php contenant ceci :
1650 263 Etienne Pallier
1651 263 Etienne Pallier
class CategorieFixture extends CakeTestFixture {
1652 263 Etienne Pallier
	public $import = array('model' => 'Categorie', 'records' => true);
1653 263 Etienne Pallier
}
1654 263 Etienne Pallier
1655 263 Etienne Pallier
Au demarrage des tests, cette table sera chargee automatiquement avec les vraies donnees.
1656 263 Etienne Pallier
A la fin des tests, cette table sera vidée.
1657 263 Etienne Pallier
	
1658 263 Etienne Pallier
Dans le cas particulier de la table "materiels", on prefere l'initialiser nous-memes avec des valeurs choisies.
1659 263 Etienne Pallier
Exemple d'une fixture avec 2 materiels (dans le fichier MaterielFixture.php) :
1660 263 Etienne Pallier
1661 263 Etienne Pallier
class MaterielFixture extends CakeTestFixture {
1662 263 Etienne Pallier
1663 263 Etienne Pallier
	public $import = 'Materiel'; // import only structure, no record
1664 263 Etienne Pallier
	
1665 263 Etienne Pallier
	public $records = array(
1666 263 Etienne Pallier
			array(
1667 263 Etienne Pallier
					'designation' => 'matos1', 
1668 263 Etienne Pallier
					'sur_categorie_id' => 1, 
1669 263 Etienne Pallier
					'categorie_id' => 11, 
1670 263 Etienne Pallier
					'materiel_administratif' => 0, 
1671 263 Etienne Pallier
					'materiel_technique' => 1, 
1672 263 Etienne Pallier
					'status' => 'CREATED', 
1673 263 Etienne Pallier
					'nom_createur' => 'Pallier Etienne', 
1674 263 Etienne Pallier
					'nom_modificateur' => 'Jean Administration', 
1675 263 Etienne Pallier
					'nom_responsable' => 'Jacques Utilisateur', 
1676 263 Etienne Pallier
					'email_responsable' => 'Jacques.Utilisateur@irap.omp.eu', 
1677 263 Etienne Pallier
			),
1678 263 Etienne Pallier
			array(
1679 263 Etienne Pallier
					'designation' => 'matos2',
1680 263 Etienne Pallier
					'sur_categorie_id' => 1,
1681 1 Etienne Pallier
					'categorie_id' => 11,
1682 263 Etienne Pallier
					'materiel_administratif' => 0,
1683 263 Etienne Pallier
					'materiel_technique' => 1,
1684 263 Etienne Pallier
					'status' => 'CREATED',
1685 263 Etienne Pallier
					'nom_createur' => 'Pallier Etienne',
1686 263 Etienne Pallier
					'nom_modificateur' => 'Jean Administration',
1687 263 Etienne Pallier
					'nom_responsable' => 'Jacques Utilisateur',
1688 263 Etienne Pallier
					'email_responsable' => 'Jacques.Utilisateur@irap.omp.eu',
1689 263 Etienne Pallier
			),
1690 263 Etienne Pallier
	);
1691 263 Etienne Pallier
} 
1692 263 Etienne Pallier
1693 263 Etienne Pallier
1694 263 Etienne Pallier
2) Les tests
1695 263 Etienne Pallier
1696 263 Etienne Pallier
Prenons l'exemple des tests ecrits pour le controleur des materiels (MaterielsController). Il devra s'appeler MaterielsControllerTest et aura la structure suivante :
1697 263 Etienne Pallier
1698 263 Etienne Pallier
class MaterielsControllerTest extends ControllerTestCase {
1699 263 Etienne Pallier
1700 263 Etienne Pallier
	// Liste des fixtures à charger avant l'execution des tests
1701 263 Etienne Pallier
	public $fixtures = array('app.materiel', 'app.sur_categorie', 'app.categorie', 'app.sous_categorie', 
1702 263 Etienne Pallier
			'app.groupes_thematique', 'app.groupes_metier', 'app.suivi', 'app.emprunt'
1703 263 Etienne Pallier
	);
1704 263 Etienne Pallier
	
1705 263 Etienne Pallier
	// Initialisations diverses a faire avant chaque test
1706 263 Etienne Pallier
	public function setUp() {
1707 263 Etienne Pallier
		parent::setUp();
1708 263 Etienne Pallier
	}
1709 263 Etienne Pallier
	
1710 263 Etienne Pallier
	// un 1er test	
1711 263 Etienne Pallier
	public function testMonPremier() {
1712 263 Etienne Pallier
		$result = $this->testAction(...);
1713 263 Etienne Pallier
		$this->assert...('resultat attendu', $result);
1714 263 Etienne Pallier
	}
1715 263 Etienne Pallier
1716 263 Etienne Pallier
	// un 2eme test
1717 263 Etienne Pallier
	public function testMonDeuxieme() {
1718 263 Etienne Pallier
		$result = $this->testAction(...);
1719 263 Etienne Pallier
		$this->assert...('resultat attendu', $result);
1720 263 Etienne Pallier
	}
1721 263 Etienne Pallier
1722 263 Etienne Pallier
	...
1723 263 Etienne Pallier
1724 263 Etienne Pallier
}	
1725 263 Etienne Pallier
	
1726 263 Etienne Pallier
Voir le vrai fichier Test/Case/Controller/MaterielsControllerTest.php
1727 263 Etienne Pallier
1728 263 Etienne Pallier
1729 263 Etienne Pallier
3) Execution
1730 263 Etienne Pallier
1731 263 Etienne Pallier
Exemple avec l'execution du test MaterielsControllerTest
1732 263 Etienne Pallier
1733 263 Etienne Pallier
a) Execution depuis le site web : 
1734 263 Etienne Pallier
/test.php?case=Controller%2FMaterielsController
1735 263 Etienne Pallier
Ajouter &debug=1 à l'url pour voir tous les messages de debug
1736 263 Etienne Pallier
1737 263 Etienne Pallier
b) Execution depuis la console :
1738 263 Etienne Pallier
Dans le repertoire app : ./Console/cake test app Controller/MaterielsController
1739 263 Etienne Pallier
Ajouter --debug pour voir tous les messages de debug
1740 263 Etienne Pallier
1741 263 Etienne Pallier
1742 263 Etienne Pallier
1743 263 Etienne Pallier
1744 264 Etienne Pallier
* *DATE PICKERS*
1745 263 Etienne Pallier
1746 263 Etienne Pallier
Pour fontionner, le datePicker fait appel dans la page "View/Layout/default" à 3 scripts (jquery-1.5.2.js, jquery-1.8.12.js, DatepickerConfig.js)
1747 263 Etienne Pallier
présents dans le repertoire "webroot/js/" et à un fichier "Theme" (smoothness.css) présent dans le repertoire "webroot/css/"
1748 263 Etienne Pallier
1749 263 Etienne Pallier
Le thème global peut très facilement être changé en téléchargeant le fichier css de son choix, à cette adresse: "http://jqueryui.com/themeroller/"
1750 263 Etienne Pallier
et en remplaçant celui se trouvant dans "webroot/css/"
1751 263 Etienne Pallier
1752 263 Etienne Pallier
Les options du datePicker sont modifiables dans le fichier "webroot/js/DatepickerConfig.js" et sont assez explicites.
1753 263 Etienne Pallier
Malgré cela, pour plus de précisions, la doc est facilement consultable à cette adresse: "http://jqueryui.com/datepicker/"
1754 263 Etienne Pallier
1755 263 Etienne Pallier
1756 263 Etienne Pallier
1757 263 Etienne Pallier
1758 263 Etienne Pallier
---
1759 263 Etienne Pallier
1760 211 Thibaud Ajas
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}A L'ATTENTION DES UTILISATEURS D'ECLIPSE%
1761 211 Thibaud Ajas
1762 1 Etienne Pallier
*+0) Installer Eclipse (Si nécessaire), voire Java+*
1763 1 Etienne Pallier
1764 211 Thibaud Ajas
En effet, même si la version que vous allez installer est une version pour PHP, Eclipse à besoin de Java pour pouvoir s'exécuter.
1765 211 Thibaud Ajas
Vérifiez que Java soit bien installé sur votre système :
1766 211 Thibaud Ajas
<pre>
1767 211 Thibaud Ajas
java -version
1768 1 Etienne Pallier
</pre>
1769 211 Thibaud Ajas
Si ce n'est pas le cas, exécutez les lignes suivantes :
1770 211 Thibaud Ajas
<pre>
1771 211 Thibaud Ajas
sudo apt-add-repository ppa:webupd8team/java
1772 211 Thibaud Ajas
sudo apt-get update
1773 212 Etienne Pallier
sudo apt-get install oracle-java8-installer
1774 211 Thibaud Ajas
</pre>
1775 211 Thibaud Ajas
1776 211 Thibaud Ajas
Pour installer Eclipse, allez sur : http://www.eclipse.org/downloads/packages/release/Neon/3
1777 211 Thibaud Ajas
Selectionnez la version que vous désirez (Neon, Oxygen, Mars ...) puis sélectionnez "Eclipse for PHP Developers".
1778 211 Thibaud Ajas
Téléchargez la version correspondant à votre système d'exploitation.
1779 211 Thibaud Ajas
Placez-vous dans le dossier ou vou voulez installer Eclipse avec l'archive précédement téléchargée (renommez-la en eclipse.tar.gz), puis exécutez la commande suivante :
1780 211 Thibaud Ajas
<pre>
1781 211 Thibaud Ajas
tar -zxvf eclipse.tar.gz
1782 211 Thibaud Ajas
</pre>
1783 211 Thibaud Ajas
1784 211 Thibaud Ajas
Si vous voulez Eclipse dans le menu des applications sous Ubuntu, il vous faudra crééer le fichier eclipse.desktop :
1785 211 Thibaud Ajas
<pre>
1786 211 Thibaud Ajas
gksudo gedit /usr/share/applications/eclipse.desktop
1787 211 Thibaud Ajas
</pre>
1788 211 Thibaud Ajas
puis collez-y ce qui suit, en modifiant le chemin des lignes Exec et Icon au besoin :
1789 211 Thibaud Ajas
<pre>
1790 211 Thibaud Ajas
[Desktop Entry]
1791 1 Etienne Pallier
Name=Eclipse 
1792 202 Thibaud Ajas
Type=Application
1793 1 Etienne Pallier
Exec=/opt/eclipse/eclipse
1794 1 Etienne Pallier
Terminal=false
1795 1 Etienne Pallier
Icon=/opt/eclipse/icon.xpm
1796 1 Etienne Pallier
Comment=Integrated Development Environment
1797 1 Etienne Pallier
NoDisplay=false
1798 1 Etienne Pallier
Categories=Development;IDE
1799 202 Thibaud Ajas
Name[en]=eclipse.desktop
1800 1 Etienne Pallier
</pre>
1801 200 Thibaud Ajas
1802 200 Thibaud Ajas
Puis donnez les droits à tous les utilisateurs sur ce fichier :
1803 1 Etienne Pallier
<pre>
1804 1 Etienne Pallier
sudo chmod a+r /usr/share/applications/eclipse.desktop
1805 1 Etienne Pallier
</pre>
1806 1 Etienne Pallier
1807 1 Etienne Pallier
*+1) Désactiver la vérification du certificat+*
1808 1 Etienne Pallier
1809 1 Etienne Pallier
Window -> Preferences -> Team -> git -> configuration -> Add entry
1810 1 Etienne Pallier
1811 1 Etienne Pallier
Key = http.sslVerify
1812 1 Etienne Pallier
Value = false
1813 1 Etienne Pallier
1814 1 Etienne Pallier
*+2) Récupérer le projet+*
1815 1 Etienne Pallier
1816 1 Etienne Pallier
*(Si le projet git n'existe pas déjà sur votre machine)*
1817 1 Etienne Pallier
1818 1 Etienne Pallier
File/Import project from git
1819 1 Etienne Pallier
1820 1 Etienne Pallier
Select repository source: Clone URI: https://gitlab.irap.omp.eu/epallier/labinvent.git
1821 200 Thibaud Ajas
1822 1 Etienne Pallier
Directory: 
1823 200 Thibaud Ajas
- par défaut, il propose : /Users/epallier/git/labinvent
1824 200 Thibaud Ajas
- mais on peut le mettre n'importe où ailleurs, 
1825 200 Thibaud Ajas
par exemple, on pourrait le mettre directement dans le repertoire web de Apache:
1826 1 Etienne Pallier
/Applications/XAMPP/xamppfiles/htdocs 
1827 200 Thibaud Ajas
(si on veut que le projet s'execute directement dans le dossier web apache htdocs, mais ca n'est pas obligatoire...)
1828 1 Etienne Pallier
1829 200 Thibaud Ajas
initial branch: master
1830 200 Thibaud Ajas
remote name: origin
1831 1 Etienne Pallier
1832 200 Thibaud Ajas
Import as general project
1833 200 Thibaud Ajas
1834 200 Thibaud Ajas
Project name: LABINVENT
1835 200 Thibaud Ajas
1836 202 Thibaud Ajas
*(si le projet git existe déjà sur votre machine)*
1837 200 Thibaud Ajas
1838 1 Etienne Pallier
File/Import project from git
1839 1 Etienne Pallier
    
1840 1 Etienne Pallier
Existing local repository
1841 1 Etienne Pallier
1842 1 Etienne Pallier
Directory
1843 1 Etienne Pallier
1844 1 Etienne Pallier
ADD => Selectionnez le dossier contenant le projet git => Finish => Next
1845 1 Etienne Pallier
1846 1 Etienne Pallier
Import existing Eclipse project
1847 1 Etienne Pallier
1848 1 Etienne Pallier
Selectionner le projet => Search for nested project => finish
1849 1 Etienne Pallier
1850 1 Etienne Pallier
1851 1 Etienne Pallier
*+3) Configurer le projet+*
1852 1 Etienne Pallier
1853 1 Etienne Pallier
a) S'assurer que le projet est bien reconnu comme un projet PHP (il doit y avoir un petit "P" sur le dossier racine du projet)
1854 1 Etienne Pallier
Si ça n'est pas le cas, vérifier que le fichier .project (à la racine) contient bien
1855 1 Etienne Pallier
	<natures>
1856 1 Etienne Pallier
		<nature>org.eclipse.php.core.PHPNature</nature>
1857 1 Etienne Pallier
	</natures>
1858 1 Etienne Pallier
NB : Le fichier .project est normalement versionné et donc le projet labinvent devrait être reconnu automatiquement comme projet PHP
1859 1 Etienne Pallier
1860 1 Etienne Pallier
1861 1 Etienne Pallier
b) S'assurer que les fichiers de vue de cakephp ("*.ctp") sont bien reconnus comme des fichiers PHP.
1862 1 Etienne Pallier
Pour tester cela, ouvrir le fichier de vue cakephp/app/View/Categories/get_all.ctp
1863 1 Etienne Pallier
Si ce fichier s'ouvre comme un simple fichier texte, c'est qu'il n'est pas reconnu par Eclipse comme un fichier Php. 
1864 1 Etienne Pallier
Il faut donc associer l'editeur Php a l'extension de fichier "*.ctp" :
1865 1 Etienne Pallier
- Preferences/General/Content types
1866 1 Etienne Pallier
- Dans la liste "Content types", ouvrir la section "Text", selectionner PHP
1867 1 Etienne Pallier
- Ajouter l'extension "*.ctp"
1868 1 Etienne Pallier
1869 1 Etienne Pallier
c) Vérifier la version de php utilisée (il serait préférable d'utiliser la meme version que celle officiellement utilisée par le logiciel, c'est à dire php 5.6, mais attention, le serveur IRAP utilise toujours une version 5.3 pour inventirap) :
1870 1 Etienne Pallier
- Clic-droit sur le projet, Propriétés
1871 1 Etienne Pallier
- PHP
1872 1 Etienne Pallier
- Interpreter
1873 1 Etienne Pallier
- Enable project specific settings, PHP Version : "PHP 5.6"
1874 1 Etienne Pallier
1875 1 Etienne Pallier
d) S'assurer que le texte est bien encodé en UTF-8 par défaut :
1876 1 Etienne Pallier
clic-droit sur le dossier racine du projet (dans PHP Explorer), Properties, Resource : dans la zone "Text file encoding" cocher "Other" et sélectionner UTF-8
1877 1 Etienne Pallier
(
1878 1 Etienne Pallier
Il faudrait commiter ça mais je ne sais pas trop si c'est risqué ou pas.
1879 1 Etienne Pallier
Les fichiers concernés sont :
1880 1 Etienne Pallier
- .project (déjà versionné) : car il commence par la ligne "<?xml version="1.0" encoding="UTF-8"?>"
1881 219 Thibaud Ajas
- mais c'est surtout celui-ci qui compte (actuellement ignoré de git) : .settings/org.eclipse.core.resources.prefs : car sa 2eme ligne est "encoding/<project>=UTF-8"
1882 219 Thibaud Ajas
)
1883 219 Thibaud Ajas
1884 1 Etienne Pallier
Les éléments suivants sont normalement DEJA ignorés par git, à vérifier :
1885 1 Etienne Pallier
- .settings/
1886 1 Etienne Pallier
- cakephp/app/tmp/ : tout sauf 
1887 1 Etienne Pallier
	- documents/
1888 1 Etienne Pallier
- cakephp/app/Config/ :
1889 1 Etienne Pallier
	- database.php
1890 1 Etienne Pallier
	- labinvent.php
1891 1 Etienne Pallier
1892 1 Etienne Pallier
1893 1 Etienne Pallier
1894 1 Etienne Pallier
1895 1 Etienne Pallier
1896 1 Etienne Pallier
---
1897 1 Etienne Pallier
1898 1 Etienne Pallier
1899 1 Etienne Pallier
<pre>
1900 1 Etienne Pallier
*********************************************************
1901 1 Etienne Pallier
REMARQUES INTERRESSANTES (MAIS VOUS POUVEZ LES IGNORER)
1902 1 Etienne Pallier
1903 1 Etienne Pallier
// DEBUT DES REMARQUES
1904 1 Etienne Pallier
1905 1 Etienne Pallier
A la racine du projet, j'ai plusieurs éléments cachés de configuration Eclipse :
1906 1 Etienne Pallier
1907 1 Etienne Pallier
1) fichier .buildpath 
1908 1 Etienne Pallier
Il est versionné puisque "svn status .buildpath" (depuis la console) ne donne rien
1909 1 Etienne Pallier
Il contient :
1910 1 Etienne Pallier
1911 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
1912 1 Etienne Pallier
<buildpath>
1913 1 Etienne Pallier
        <buildpathentry kind="con" path="org.eclipse.php.core.LANGUAGE"/>
1914 1 Etienne Pallier
        <buildpathentry kind="lib" path="docs/mockup/mockup_html.zip"/>
1915 1 Etienne Pallier
        <buildpathentry kind="src" path="cakephp"/>
1916 1 Etienne Pallier
</buildpath>
1917 1 Etienne Pallier
1918 1 Etienne Pallier
2) fichier .project
1919 1 Etienne Pallier
Il est déjà versionné
1920 1 Etienne Pallier
Il contient :
1921 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
1922 1 Etienne Pallier
<projectDescription>
1923 1 Etienne Pallier
        <name>invirap</name>
1924 1 Etienne Pallier
        <comment></comment>
1925 1 Etienne Pallier
        <projects>
1926 1 Etienne Pallier
        </projects>
1927 1 Etienne Pallier
        <buildSpec>
1928 1 Etienne Pallier
                <buildCommand>
1929 1 Etienne Pallier
                        <name>org.eclipse.wst.common.project.facet.core.builder</name>
1930 1 Etienne Pallier
                        <arguments>
1931 1 Etienne Pallier
                        </arguments>
1932 1 Etienne Pallier
                </buildCommand>
1933 1 Etienne Pallier
                <buildCommand>
1934 1 Etienne Pallier
                        <name>org.eclipse.wst.validation.validationbuilder</name>
1935 1 Etienne Pallier
                        <arguments>
1936 1 Etienne Pallier
                        </arguments>
1937 1 Etienne Pallier
                </buildCommand>
1938 1 Etienne Pallier
                <buildCommand>
1939 1 Etienne Pallier
                        <name>org.eclipse.dltk.core.scriptbuilder</name>
1940 1 Etienne Pallier
                        <arguments>
1941 1 Etienne Pallier
                        </arguments>
1942 1 Etienne Pallier
                </buildCommand>
1943 1 Etienne Pallier
        </buildSpec>
1944 1 Etienne Pallier
        <natures>
1945 1 Etienne Pallier
                <nature>org.eclipse.php.core.PHPNature</nature>
1946 1 Etienne Pallier
                <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
1947 1 Etienne Pallier
        </natures>
1948 1 Etienne Pallier
</projectDescription>
1949 1 Etienne Pallier
1950 1 Etienne Pallier
3) dossier .settings/ (exclus de svn)
1951 1 Etienne Pallier
Il contient 3 fichiers :
1952 1 Etienne Pallier
1953 1 Etienne Pallier
- org.eclipse.core.resources.prefs : bizarrement, il ne contient que quelques références seulement :
1954 1 Etienne Pallier
eclipse.preferences.version=1
1955 1 Etienne Pallier
encoding//cakephp/app/Controller/MaterielsController.php=UTF-8
1956 1 Etienne Pallier
encoding//cakephp/app/View/Elements/menu_view.ctp=UTF-8
1957 1 Etienne Pallier
encoding//cakephp/app/View/Layouts/default.ctp=UTF-8
1958 1 Etienne Pallier
encoding//cakephp/app/View/Materiels/index.ctp=UTF-8
1959 1 Etienne Pallier
encoding//cakephp/app/View/Materiels/scaffold.view.ctp=UTF-8
1960 1 Etienne Pallier
encoding//database/Upd_TableConstraints.sql=UTF-8
1961 1 Etienne Pallier
encoding//database/update/README.txt=UTF-8
1962 1 Etienne Pallier
encoding//docs/HOWTO.txt=UTF-8
1963 1 Etienne Pallier
encoding//install/HOWTO.txt=UTF-8
1964 1 Etienne Pallier
encoding/<project>=UTF-8
1965 1 Etienne Pallier
1966 1 Etienne Pallier
- org.eclipse.php.core.prefs
1967 1 Etienne Pallier
eclipse.preferences.version=1
1968 200 Thibaud Ajas
include_path=0;/invirap\u00051;/invirap/docs/mockup/mockup_html.zip
1969 1 Etienne Pallier
1970 1 Etienne Pallier
- org.eclipse.wst.common.project.facet.core.xml : sans doute inutile ? (lié à "Faceted Project Validation Builder" dans Properties/Builders)
1971 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
1972 1 Etienne Pallier
<faceted-project>
1973 200 Thibaud Ajas
  <fixed facet="php.core.component"/>
1974 200 Thibaud Ajas
  <fixed facet="php.component"/>
1975 200 Thibaud Ajas
  <installed facet="php.core.component" version="1"/>
1976 1 Etienne Pallier
  <installed facet="php.component" version="5.4"/>
1977 1 Etienne Pallier
</faceted-project>
1978 1 Etienne Pallier
1979 1 Etienne Pallier
// FIN DES REMARQUES
1980 1 Etienne Pallier
*********************************************************
1981 1 Etienne Pallier
</pre>
1982 200 Thibaud Ajas
1983 1 Etienne Pallier
*+4) (TODO:) Set Code style+*
1984 1 Etienne Pallier
1985 200 Thibaud Ajas
Window/Preferences : PHP / Editor
1986 1 Etienne Pallier
...
1987 1 Etienne Pallier
1988 1 Etienne Pallier
*+5) (TODO:) virtualenv+*
1989 1 Etienne Pallier
1990 1 Etienne Pallier
Now, once the PHP5 virtual environment is installed (see above),
1991 1 Etienne Pallier
set it in Eclipse as the project interpreter:
1992 1 Etienne Pallier
1993 1 Etienne Pallier
(cf http://virtphp.org)
1994 1 Etienne Pallier
1995 1 Etienne Pallier
...
1996 1 Etienne Pallier
1997 1 Etienne Pallier
*+6) (TODO:) Test+*
1998 1 Etienne Pallier
1999 1 Etienne Pallier
2000 1 Etienne Pallier
*+7) (TODO:) Run+*
2001 1 Etienne Pallier
2002 1 Etienne Pallier
check http://localhost:8080/
2003 292 Thibaud Ajas
2004 292 Thibaud Ajas
2005 292 Thibaud Ajas
---
2006 292 Thibaud Ajas
2007 292 Thibaud Ajas
h2. Installer un serveur LDAP et un serveur web sur deux VMs différentes
2008 293 Thibaud Ajas
2009 298 Etienne Pallier
Si vous êtes là c'est que vous avez déjà une VM avec votre serveur web, sinon je vous renvoie à la page d'installation du serveur web :
2010 293 Thibaud Ajas
> https://projects.irap.omp.eu/projects/inventirap/wiki/Installation
2011 293 Thibaud Ajas
2012 293 Thibaud Ajas
Ceci est une VM LDAP déjà installée et configurée (si vous en avez pas déjà) :
2013 293 Thibaud Ajas
> https://www.turnkeylinux.org/openldap
2014 293 Thibaud Ajas
2015 293 Thibaud Ajas
Après avoir installer vos deux VMs, on va les configurer.
2016 293 Thibaud Ajas
2017 299 Thibaud Ajas
Par la suite, j'utiliserais ces termes pour éviter de tout réécrire à chaque fois :
2018 293 Thibaud Ajas
> Machine hôte = Machine physique avec laquelle vous travaillez
2019 293 Thibaud Ajas
> VM_1 = Machine virtuelle qui héberge votre serveur Web/Apache/MySQL ...
2020 293 Thibaud Ajas
> VM_2 = Machine virtuelle qui héberge votre serveur LDAP
2021 293 Thibaud Ajas
2022 293 Thibaud Ajas
La configuration qui a servi a réaliser ce tutoriel :
2023 293 Thibaud Ajas
> Machine hôte : Windows 7 Pro 64bits
2024 293 Thibaud Ajas
> VM_1 : Ubuntu 14.04.5 32bits
2025 293 Thibaud Ajas
> VM_2 : TURNKEY OPENLDAP 64bits
2026 293 Thibaud Ajas
2027 293 Thibaud Ajas
*A faire sur la machine hôte :*
2028 293 Thibaud Ajas
2029 293 Thibaud Ajas
Configuration des 2 cartes réseau de la VM_1 :
2030 293 Thibaud Ajas
2031 293 Thibaud Ajas
_Carte n°1 :_
2032 293 Thibaud Ajas
2033 293 Thibaud Ajas
> Activer la carte réseau
2034 293 Thibaud Ajas
> Mode d'accès : NAT
2035 293 Thibaud Ajas
> 
2036 293 Thibaud Ajas
> (Si vous voulez pouvoir utiliser votre serveur web depuis votre machine hôte)
2037 293 Thibaud Ajas
> 
2038 293 Thibaud Ajas
> -> Avancé -> Redirection de ports
2039 293 Thibaud Ajas
> 
2040 293 Thibaud Ajas
> Ajoutez une règle de redirection :
2041 293 Thibaud Ajas
> IP hôte : 127.0.0.1
2042 293 Thibaud Ajas
> Port hôte : 8080
2043 293 Thibaud Ajas
> Port invité : 80
2044 293 Thibaud Ajas
> (Le reste n'y touchez pas)
2045 293 Thibaud Ajas
2046 296 Thibaud Ajas
(Un exemple)
2047 296 Thibaud Ajas
!Config_carte1_VM_1.png!
2048 296 Thibaud Ajas
2049 293 Thibaud Ajas
_Carte n°2 :_
2050 293 Thibaud Ajas
2051 293 Thibaud Ajas
> Activer la carte réseau
2052 293 Thibaud Ajas
> Mode d'accès : Réseau interne
2053 293 Thibaud Ajas
> Nom : Connexion_LDAP (ceci est un exemple, mettez ce que vous voulez)
2054 293 Thibaud Ajas
> -> Avancé
2055 293 Thibaud Ajas
> Mode Promiscuité : Tout autoriser
2056 293 Thibaud Ajas
2057 296 Thibaud Ajas
(Un exemple)
2058 296 Thibaud Ajas
!Config_carte2_VM_1.png!
2059 296 Thibaud Ajas
2060 293 Thibaud Ajas
Configuration de la carte réseau de la VM_2 :
2061 293 Thibaud Ajas
2062 293 Thibaud Ajas
_Carte n°1 :_
2063 293 Thibaud Ajas
2064 293 Thibaud Ajas
> Activer la carte réseau
2065 293 Thibaud Ajas
> Mode d'accès : Réseau interne
2066 293 Thibaud Ajas
> Nom : Connexion_LDAP (ceci est un exemple, mettez ce que vous voulez, faut juste que ce soit le même que celui de la carte 2 de la VM_1)
2067 293 Thibaud Ajas
> -> Avancé
2068 293 Thibaud Ajas
> Mode Promiscuité : Tout autoriser
2069 296 Thibaud Ajas
2070 296 Thibaud Ajas
(Un exemple)
2071 296 Thibaud Ajas
!Config_carte1_VM_2.png!
2072 293 Thibaud Ajas
2073 293 Thibaud Ajas
Voila, on est bon pour la machine hôte, maintenant on passe à la configuration des VMs.
2074 293 Thibaud Ajas
2075 293 Thibaud Ajas
*A faire sur la VM_1 :*
2076 293 Thibaud Ajas
2077 293 Thibaud Ajas
Carte réseau n°1 : Adresse IPv4 : Méthode d’obtention : DHCP
2078 293 Thibaud Ajas
2079 293 Thibaud Ajas
Carte réseau n°2 : Adresse IPv4 : Méthode d’obtention : Manuelle :
2080 293 Thibaud Ajas
> Adress (Adresse): 192.168.1.2
2081 293 Thibaud Ajas
> Netmask (Masque de sous-réseau) : 255.255.255.0
2082 293 Thibaud Ajas
> Gateway (Passerelle) : 255.255.255.0
2083 293 Thibaud Ajas
2084 297 Thibaud Ajas
Cela devrait ressembler plus ou moins à ceci :
2085 299 Thibaud Ajas
!Config_cartes_reseau_VM_1.png!
2086 297 Thibaud Ajas
2087 297 Thibaud Ajas
*A faire sur la VM_2 :*
2088 297 Thibaud Ajas
2089 297 Thibaud Ajas
-> Advanced Menu -> Networking -> StaticIP
2090 297 Thibaud Ajas
> IP Adress : 192.168.1.3
2091 297 Thibaud Ajas
> Netmask : 255.255.255.0
2092 297 Thibaud Ajas
> (laissez le reste vide)
2093 297 Thibaud Ajas
-> Apply
2094 297 Thibaud Ajas
2095 297 Thibaud Ajas
Cela devrait ressembler à ça :
2096 297 Thibaud Ajas
!Config_carte_reseau_VM_2.png!
2097 297 Thibaud Ajas
2098 297 Thibaud Ajas
Et voila, maintenant pour accéder à votre site depuis votre machine hôte, rendez-vous à l'adresse 127.0.0.1:8080 dans votre navigateur préféré.
2099 300 Thibaud Ajas
Pour ce qui est du LDAP, les adresses vous sont données en page d'accueil lorsque vous lancez votre VM LDAP. Sachez cependant que votre machine hôte ne pourra en aucun cas communiquer avec la VM LDAP, et vice-versa. Le LDAP, quand à lui, n'aura aucun accès à internet.
2100 300 Thibaud Ajas
2101 297 Thibaud Ajas
2102 297 Thibaud Ajas
---