replace variable name

missing values in ThirdParty, Address

admin/generation-documents.md

@@ -92,7 +92,8 @@ Les administrateurs fonctionnels peuvent activer les paramètres suivants:
 #### Variables
 
 * `creator`: (User) le créateur;
-* `createdAt` (Date): la date de création;
+* `createdAt` (Date): la date et l'heure de création;
+* `createdAtDate` (Date): la date de la création (sans l'heure). Utilisable pour indiquer la date d'un courrier, par exemple;
 * `location` (Location): le lieu sélectionné par le créateur, au moment de la génération **ou** celui choisi par l'étape 1.
 
 ### Document générés pour un parcours
@@ -147,10 +148,20 @@ Il est possible également d'injecter des dossiers d'usagers, parmi ceux associ
 * si `usager 1` est coché, une variable `person1`, de type Person, avec les variants `relations`, `household` (ménage) et `budget`;
 * si `usager 2` est coché, une variable `person2`, de type Person, avec les variants `relations`, `household` (ménage) et `budget`;
 
-### Documents générés dans le dossier d'une personne
+### Documents générés dans le dossier d'une personne: contexte "personne basique"
 
-* une variable `person`, de type Person, avec les variants `relations`, `household` (ménage) et `budget`.
+* une variable `person`, de type `Person`, avec les variants `relations`, `household` (ménage) et `budget`.
 
+### Documents générés dans le dossier d'une personne: contexte "personne avec un tiers"
+
+Ce contexte permet de générer un courrier avec, en paramètre, un tiers.
+
+Cela peut être utile pour, par exemple, générer un courrier vers un tiers déjà enregistré dans la base de donnée de Chill.
+
+Les variables disponibles sont les suivantes:
+
+* une variable `person`, de type `Person`, avec les variants `relations`, `household` (ménage) et `budget`.
+* une variable `thirdParty`, de type `ThirdParty`;
 
 ## Champs par objet { #sec:gendoc-champs-objets }
 
@@ -238,6 +249,7 @@ ${courseStartDateShort} // 15/01/2021
 * `id` (int): identifiant;
 * `person` (Person): usager ressource (vide, avec le paramètre `isNull` à `true`, si la ressource est un tiers);
 * `thirdParty` (ThirdParty): tiers ressource (vide, avec le paramètre `isNull` à `true`, si la ressource est une personne);
+* `comment` (texte): commentaire associé à la personne ressource.
 
 
 ### Activity (échange)
@@ -409,21 +421,21 @@ En outre, si la personne est mineure, on a accès aux champs suivants:
 * `extras.majeur.isNull` (bool): si un dossier "mineur" a été créé
 * `extras.mineur.enfantConfie` (bool): `true` si enfant confié
 * `extras.mineur.dossierASE` (texte)
-* `extras.mineur.autoriteParentale` (texte)
+* `extras.mineur.autoriteParentaleFr` (texte)
 * `extras.mineur.autoriteParentaleComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
-* `extras.mineur.identificationAutoriteParentale1` (texte)
-* `extras.mineur.identificationAutoriteParentale2` (texte)
+* `extras.mineur.identificationAutoriteParentale1Fr` (texte)
+* `extras.mineur.identificationAutoriteParentale2Fr` (texte)
 * `extras.mineur.autoriteParentale1Date` (Date)
 * `extras.mineur.autoriteParentale2Date` (Date)
 * `extras.mineur.retraitAutoriteParentale` (bool): `true` si retraitAutoriteParentale
 * `extras.mineur.retraitAutoriteParentaleDate` (Date)
 * `extras.mineur.retraitAutoriteParentaleComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
-* `extras.mineur.delegation` (bool): `true` si délégation
+* `extras.mineur.delegationBool` (bool): `true` si délégation
 * `extras.mineur.delegationDate` (Date)
 * `extras.mineur.delegationComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
 * `extras.mineur.delegationThirdParty` (tiers): entité ThirdParty
 * `extras.mineur.delegationPerson` (person): entité Person
-* `extras.mineur.tuteur` (texte)
+* `extras.mineur.tuteurBool` (bool): TRUE si tuteur
 * `extras.mineur.tuteurThirdParty` (tiers): entité ThirdParty
 * `extras.mineur.administrateurAdhoc` (bool): `true` si administrateurAdhoc
 * `extras.mineur.administrateurAdhocDate` (Date)
@@ -630,18 +642,31 @@ Pour rappel, les ressources peuvent être:
 * `contactDataAnonymous` (bool): `true` si le tiers est anonyme;
 * `email` (texte): email;
 * `name` (texte): nom du tiers;
-* `nameCompany` (texte): nom du service du tiers (pour une personne morale);
+* `firstname` (texte): Prénom du tiers;
 * `parent` (ThirdParty): tiers parent (pour les contacts)
 * `profession` (ThirdPartyProfession)
 * `telephone` (texte): numéro de téléphone du tiers
+* `kind` (texte): permet de distinguer les personnes morales, les contacts et les personnes physiques (voir ci-après)
+* `child` (bool) vaut TRUE s'il existe un parent (contact), false sinon;
+* `parent` (ThirdParty): s'il s'agit d'un contact d'une personne morale, contient la fiche d'une personne morale
+
+
+`kind` vaut:
+
+* `company` lorsqu'il s'agit d'une personne morale
+* `child` lorsuq'il s'agit d'un  contact d'une personne morale
+* `contact` lorsqu'il s'agit d'une personne **physique** (à ne pas confondre avec un contact d'une personne morale)
 
 ### ThirdPartyCategory (catégorie de tiers)
 
-TODO
+* `id` (int): identifiant
+* `name` (texte)
+
 
 ### ThirdPartyProfession (profession du tiers)
 
-TODO
+* `id` (int): identifiant
+* `name` (texte)
 
 ### Adresse
 
@@ -659,6 +684,15 @@ TODO
 * `extra` (texte): champs extras
 * `validFrom` (Date): date de début de validité;
 * `validTo` (Date): date de fin de validité (vide si toujours valide);
+* `lines` (liste de texte): les lignes de l'adresses, comme elles devraient être formatées dans une adresses
+
+Il est possible de représenter l'adresse au format postal en effectuant une boucle sur les lignes. Par exemple, pour l'adresse d'une personne (chaque ligne est un "renvoi > substituant" dans l'exemple ci-dessous):
+
+```
+for each="line in v.person.address.lines
+line
+/for
+```
 
 ### Postcode
 
@@ -682,11 +716,17 @@ TODO
 * `text` (texte): le libellé complet de l'utilisateur (avec son métier et son service entre parenthèse);
 * `label` (texte): le libellé de l'utilisateur, tel qu'il est enregistré par l'administrateur fonctionnel
 * `main_scope` (Scope): service principal
-* `user_job.label` (texte): métier principal
+* `user_job` (UserJob): métier principal
 * `current_location` (Location): lieu de l'utilisateur, celui actuellement choisi par l'utilisateur par le menu "utilisateur";
 * `main_location` (Location): localisation de l'utilisateur définie par l'administrateur fonctionnel (parfois appelé "résidence administrative"). L'utilisateur ne peut pas la modifier lui-même;
 * `civility` (Civility): la civilité de l'utilisateur;
 
+### UserJob 
+
+* `id` (int): identifiant
+* `label` (texte): nom du métier
+
+
 ### Location (lieu)
 
 * `id` (int): identifant;