Outils pour utilisateurs

Outils du site


public:specs_parametres_preferences_commands

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
public:specs_parametres_preferences_commands [2019/11/22 13:59]
matthieu.decorde@ens-lyon.fr [Description technique : Préférences par défaut (globales et par commande) et paramètres locaux des commandes et résultats]
public:specs_parametres_preferences_commands [2019/11/22 15:44] (Version actuelle)
matthieu.decorde@ens-lyon.fr [Relation entre les préférences de commandes, les paramètres réels des résultats et les Widgets des éditeurs]
Ligne 60: Ligne 60:
 ===== Relation entre les préférences de commandes, les paramètres réels des résultats et les Widgets des éditeurs ===== ===== Relation entre les préférences de commandes, les paramètres réels des résultats et les Widgets des éditeurs =====
  
-Le fonctionnement dans la 0.8.0 au niveau TBX :+Le fonctionnement dans la 0.8.0 
  
-  * à la création d'un résultat +== au niveau CORE ==
-    * un noeud de préférence dédié ​au résultat est créé pour stocker ses paramètres (noeud local) +
-    * un lien est fait vers le noeud de préférence de la commande qui contient les valeurs courantes et les valeurs par défaut +
-    * une liste d'​éventuels noeuds de préférences alernatifs peut être donnée (ex. pour les moteurs) +
-    * des méthodes sont appelées pour charger semi-automatiquement les valeurs des paramètres de l'​objet en fonction d'une liste de noms de paramètres définis grâce aux Annotations définies en dur dans l'​objet. Lors de la recherche de paramètres : +
-      * si un paramètre existe dans le noeud de préférence de la commande, sa valeur courante est chargée +
-      * sinon si un paramètre existe dans les noeud de préférence alternatifs,​ sa valeur courante est chargée +
-      * sinon la valeur par défaut du paramètre est chargé depuis le noeud de préférence de la commande+
  
-A la création d'un résultat, il n'est pas encore calculé. ​Seuls des paramètres ​de commande ou de noeuds alternatifs lui ont été donnéLors du calcul/​compute d'un résultat :+A la création d'un résultat, il n'est pas encore calculé. ​Avant tout calcul, ses paramètres ​sont initialisés avec les préférences.
  
-  ​après le compute, les paramètres sont stockés dans le noeud de préférence dédié au résultat (noeud ​local+À la création d'un résultat : 
-    * ceci sert à la persistance entre sessions mais également simplement ​pour réouvrir un éditeur lors d'​une ​même session+    ​un noeud de préférence ​Eclipse ​dédié au résultat ​est créé pour stocker ses paramètres ​(un sous-noeud du scope projet
 +    * un lien est fait vers le noeud de préférence de la commande qui contient les valeurs courantes et les valeurs par défaut : bundle_id, ex. "​org.txm.core.concordance"​ 
 +    * une liste d'​éventuels noeuds de préférences alternatifs peut être donnée (ex. pour les moteurs) 
 +    * des méthodes sont appelées pour charger semi-automatiquement les valeurs des paramètres de l'​objet en fonction ​d'​une ​liste de noms de paramètres définis grâce aux Annotations Java définies en dur dans l'​objet. Lors de la recherche de paramètres : 
 +      * le résultat est nouveau, son noeud de préférence n'a pas valeur de paramètre de commande 
 +      * si une préférence existe dans le noeud de préférence de la commande, sa valeur courante est chargée 
 +      * sinon si une préférence existe dans les noeud de préférence alternatifs,​ sa valeur courante est chargée 
 +      * sinon la valeur par défaut de la préférence est chargé depuis le noeud de préférence de la commande
  
-Au niveau RCP :+Lors du calcul/​compute d'un résultat ​: 
 +  * une fois les paramètres réglés correctement et validés par le TXMResult, le calcul peut être lancé 
 +  * une fois le calcul terminé correctement,​ les paramètres sont stockés dans le noeud de préférence du résultat 
 +  * les préférences du noeud sont flushés dans un fichier .prefs. Ceci permet à la persistance entre sessions de TXM ou de partage de résultat entre instances de TXM.
  
-  * L'​appel d'une commande ​RCP va ouvrir un éditeur en lui donnant un résultat non calculé mais qui contient ses valeurs de paramètres,​ comme décrit dans la section ci-dessus +== Au niveau ​RCP ==
-    * l'​éditeur va charger semi-automatiquement les valeurs de ses Widgets via Annotation en récupérant les valeurs des paramètres du résultat +
-      * il pourra donc s'agir des préférences par défaut de la commande, d'un noeud alternatif, ou bien des paramètres locaux du résultat +
-  * au clic sur le bouton calculer/​compute,​ les valeurs des Widget de l'​éditeur sont transmises semi-automatiquement via Annotation en tant que paramètres du résultat+
  
 +À l'​ouverture d'un résultat :
 +
 +  * L'​appel d'une commande RCP va ouvrir un éditeur en lui donnant un résultat non calculé (l'​utilisateur n'a pas encore modifié les paramètres en plus de ceux initialisés par les préférences au niveau core)
 +    * l'​éditeur va charger semi-automatiquement les valeurs de ses Widgets une jointure réalisée par le champ "​key"​ des Annotations Java attachés aux widgets et aux paramètres du résultat
 +      * il pourra donc s'agir des préférences par défaut de la commande, d'un noeud alternatif, ou bien des paramètres locaux du résultat
 +  * au clic sur le bouton calculer/​compute,​ les valeurs des Widgets de l'​éditeur sont transmises semi-automatiquement via Annotations en tant que paramètres du résultat
  
 {{:​public:​basic_command_execution.png?​1000|}} {{:​public:​basic_command_execution.png?​1000|}}
public/specs_parametres_preferences_commands.txt · Dernière modification: 2019/11/22 15:44 par matthieu.decorde@ens-lyon.fr