Gestion de formulaires

======================

Contr�le de la g�n�ration automatique de formulaire pour les entit�s manipul�e

------------------------------------------------------------------------------

XXX FILLME

* les formulaires 'edition' et 'creation'

Le formulaire g�n�r� par d�faut ne vous convient pas ? Vous �tes peut-�tre pas

oblig� de le refaire � la main ! :)

* rtags primary, secondary, generated, generic,

  `Entity.relation_category(rtype, x='subject')`

* inline_view (now a rtag?)

* sp�cification widget

Fonctionnement du contr�leur d'�dition par d�faut (id: 'edit')

--------------------------------------------------------------

Contr�le de l'�dition

`````````````````````

Pr�requis: les param�tres li�s aux entit�s � �diter sont sp�cifi�s de la forme ::

  <nom de champ>:<eid de l'entit�>

o� l'eid de l'entit� pourra �tre une lettre dans le cas d'une entit� � cr�er. On

d�nommera ces param�tres comme *qualifi�*.

1. r�cup�ration des entit�s � �diter en cherchant les param�tres de formulaire

   commen�ant par 'eid:' ayant �galement un param�tre '__type' associ�

   (�galement *qualifi�* par l'eid �videmment)

2. pour tous les attributs et relations de chaque entit� � �diter

   1. recherche d'un param�tre 'edits-<nom relation>' ou 'edito-<nom relation>'

      qualifi� dans le cas d'une relation dont l'entit� est objet

   2. si trouv�, la valeur r�cup�r�e est consid�r�e comme la valeur originale

      pour cette relation, et on cherche la (ou les) nouvelle(s) valeur(s) dans

      le param�tre <nom relation> (qualifi�)

   3. si la valeur est diff�rente de l'originale, une requ�te de modification en

      base est effectu�e

3. pour chaque entit� � �diter

   1. si un param�tre `__linkto` qualifi� est sp�cifi�, sa valeur doit �tre une

      chaine (ou une liste de chaine) de la forme : ::

        <relation type>:<eids>:<target>

      o� <target> vaut 'subject' ou 'object' et chaque eid peut-�tre s�par� d'un

      autre par un '_'. Target sp�cifie *l'entit� �dit�e* est sujet ou objet de la

      relation et chaque relation ainsi sp�cifi�e sera ins�r�e.

   2. si un param�tre `__cloned_eid` qualifi� est sp�cifi� pour une entit�, les

      relations de l'entit� sp�cifi�e en valeur de cette argument sont copi�es sur

      l'entit� �dit�e

   3. si un param�tre `__delete` qualifi� est sp�cifi�, sa valeur doit �tre une

      chaine (ou une liste de chaine) de la forme : ::

	<subject eids>:<relation type>:<object eids>

      o� chaque eid sujet ou objet peut-�tre s�par� d'un autre par un '_'. Chaque

      relation ainsi sp�cifi�e sera supprim�e.

   4. si un param�tre `__insert` qualifi� est sp�cifi�, sa valeur doit �tre de

      m�me format que pour `__delete`, mais chaque relation ainsi sp�cifi�e sera 

      ins�r�e.

4. si les param�tres `__insert` et/ou  `__delete` sont trouv�s non qualifi�s,

   ils sont interpr�t�s comme d�crit ci-dessus (quelque soit le nombre d'entit�

   �dit�)

5. si aucune entit� n'est �dit�e mais que le formulaire contient les param�tres

   `__linkto` et `eid`, celui-ci est interpr�t� en prenant la valeur sp�cifi�

   par le param�tre `eid` pour d�signer l'entit� sur laquelle ajouter les

   relations

A noter que :

* si le param�tre `__action_delete` est trouv�, toutes les entit�s comme

  sp�cifi�es � �diter seront supprim�es

* si le param�tre `__action_cancel` est trouv�, aucune action n'est effectu�e

* si le param�tre `__action_apply` est trouv�, l'�dition est effectu�e

  normalement mais la redirection sera effectu�e sur le formulaire (cf `Contr�le

  de la redirection`_)

* le param�tre `__method` est �galement support� comme sur le template principal

  (XXX not very consistent, maybe __method should be dealed in the view controller) 

* si aucune entit� � �diter n'est trouv�e et qu'il n'y a pas de param�tre

  `__action_delete`, `__action_cancel`, `__linkto`, `__delete` ou `__insert`,

  une erreur est lev�e

* placer dans le formulaire le param�tre `__message` permettra d'utiliser la

  valeur de ce param�tre comme message d'information � l'utilisateur une fois

  l'�dition effectu�e.

Contr�le de la redirection

``````````````````````````

Une fois que l'�dition s'est bien pass�, reste un probl�me : c'est bien beau

tout �a, mais o� qu'on va maintenant ?? Si rien n'est sp�cifi�, le controlleur

se d�brouille, mais comme il fait pas toujours ce qu'on voudrait, on peut

controller �a en utilisant les param�tres suivant :

* `__redirectpath`: chemin de l'url (relatif � la racine du site, sans param�tre

  de formulaire

* `__redirectparams`: param�tres de formulaires � ajouter au chemin

* `__redirectrql`: requ�te RQL de redirection

* `__redirectvid`: identifiant de vue de redirection

* `__errorurl`: url du formulaire original, utilis� pour la redirection en cas

  d'erreur de validation pendant l'�dition. Si celui-ci n'est pas sp�cifi�, une

  page d'erreur sera pr�sent�e plutot qu'un retour sur le formulaire (qui est le

  cas �ch�ant responsable d'afficher les erreurs)

* `__form_id`: identifiant de vue du formulaire original, utilis�e si

  `__action_apply` est trouv�

En g�n�ral on utilise soit `__redirectpath et `__redirectparams` soit

`__redirectrql` et `__redirectvid`.