Devenez partenaire Principal ou Majeur de Neogia

• Accueil
• Fonctionnalités
  • Acteurs
  • Articles
  • GRC (CRM - SFA)
  • Vente/Achat (Expéd. Récept.)
  • Terminal point de vente
  • Stock
  • Production
  • Qualité
  • Prestation de Service
  • Finance/Comptabilité
  • eCommerce
  • Business Intelligence
• TERapplication
  • TerCompta
• Documentation
  • Menu principal
  • Doc. Fonctionelles
  • Architecture
  • Doc. Techniques
  • Doc. développeur
  • Doc. contributeur
  • Doc. du projet
  • Doc. administrateur
• Téléchargement
• Démo. en ligne
• Qui sommes nous
• Plan du site

Qu'est ce qu'une vue ?

Une vue dans OFBiz est une représentation virtuelle de plusieurs entités. Cela peut être comparé aux vues que l'on retrouve dans la plupart des SGBD, bien qu'une vue dans OFBiz ne crée pas de vue au sens SGBD. La vue va nous permettre de combiner et joindre des entités (tables), de choisir quel champ elle inclura afin de créer une nouvelles entité, utilisable au même titre qu'une entité standard dans les traitements ou affichage ( cela permet une sorte de pré-configuration de la requête d'intérogation des données). Une vue définie dans un fichier XML sera une vue statique, chargée au démarrage du serveur. On aura aussi la possibilité d'utiliser des vues dynamiques, générées via un programme JAVA (ou mini-language) et à la demande. Dans cette page, nous ne verrons que la partie XML.

Nous allons séparer cette page en deux parties, la première présentant la réalisation d'une vue, et la seconde permettant de voir plus en détails les différentes possibilités lors de la création d'une vue complexe. En bas de cette page, des liens sont fournis pour retrouver d'autres documentations sur les entités et les vues.

On pourra accéder à des formules et informations plus détaillées en allant sur cette page : Vues Partie 2. Un tutoriel est disponible sur cette page : Tutoriel.

Définition d'une vue

Une vue est composée :

• d'une description (view-entity),
• de la liste des entités (member-entity),
• des champs sélectionnés (field-alias),
• des relations (view-link).

• view-entity

Ceci permet de définir le nom de la vue et de définir à quel package la vue appartient. Ces deux champs sont obligatoires.

• member-entity

Les entités de OFBiz sont appelées ici en tant qu'entités membres. On donne à ce niveau un alias à l'entité et c'est par celui-ci que l'on va y référer par la suite. On pourra aussi faire référence plusieurs fois à une entité en lui donnant à chaque fois un nouvel alias.

• field-alias

Les alias permettent de sélectionner les champs à afficher dans une vue. Tout comme pour les entités, nous avons la possibilité de sélectionner plusieurs fois le même champ en lui attribuant à chaque fois un nom différent.
Par défaut le nom de l'alias est le même que le nom du champ.

• view-link

les view-links servent à spécifier les relations entre les entités composant une vue. Les types de jointure utilisés à cet endroit peuvent être :

• • soit interne (rel-optional="false") (les valeurs doivent être présentes dans chaque entité),
  • soit externe (rel-optional="true") (les champs vides sont affichés).

Comment afficher la vue

On pourra vérifier par admin sys que la vue a bien été chargée au démarrage du serveur. L'affichage se fera par une form.

La form qui va afficher notre vue sera appelée par un screen. Ici, nous allons simplement appeler et afficher la vue. Par la suite, il est entièrement possible d'ajouter des conditions ou des filtres afin de réduire les données affichées. Ci-dessous, l'appel dans notre screen :

   <screen name="findDashboardOrderTurnoverReport">
       
   </screen>

Nous créons ensuite une forme de type liste, dans laquelle nous pouvons insérer des conditions afin de supprimer les redondances et/ou les enregistrements non significatifs. Ensuite, nous sélectionnons les champs à afficher via les balises <field name>.

   <form name="maFormAAfficher" type="list" list-name="listIt"
       default-title-style="tableheadtext" default-widget-style="tabletext" default-tooltip-style="tabletext">
       <actions>
           <set field="conditionList" from-field="resultConditions.entityConditionList" type="Object" />
               <entity-condition list-name="listIt" entity-name="OrderDashboardTurnover">
                   <condition-list combine="and">
                       <condition-object field-name="conditionList"/>
                       <condition-list combine="or">
                           <condition-expr field-name="invoiceItemTypeId" operator="equals" value="ITM_SHIPPING_CHARGES"/>
                           <condition-expr field-name="invoiceItemTypeId" operator="equals" value="INV_FPROD_ITEM"/>
                       </condition-list>
                       <condition-expr field-name="partyClassificationTypeId" operator="equals" value="ACTIVITY_CLASSIF"/>
                       <condition-expr field-name="partyClassificationTypeIdGeo" operator="equals" value="GEOARRAY_CLASSIF"/>
                   </condition-list>
               </entity-condition>
       </actions>        
       <field name="pName"><display/></field>
       <field name="partyId"><display/></field>
   </form>

Le résultat que nous obtenons est celui-ci :

Détail des options des vues

view-entity

member-entity

alias

view-link

view-link – élément optionel

Exemples :

Nous faisons ici une jointure externe (OUTER JOIN) sur les entités Party et PartyClassification, au niveau du champ partyId

       <view-link entity-alias="P" rel-entity-alias="PC" rel-optional="true">
           <key-map field-name="partyId" />
       </view-link>

Pour faire une jointure interne (INNER JOIN) sur le champ invoiceId des entités Invoice et InvoiceItem, nous mettons le champ rel-optional à false

       <view-link entity-alias="I" rel-entity-alias="II" rel-optional="false">
           <key-map field-name="invoiceId" />
       </view-link>

relation

relation – élément optionnel

Pour aller plus loin :

OFBiz Entity Cookbook
OFBiz Entity Engine guide
OFBiz Entity Engine configuration guide
Pour aller plus en détail dans les vues
Tutoriel sur les vues
Plus de détails sur les group-by

objet : Documentation pour la création de vues via le fichier entity.xml
langue de la page de référence : Français
auteur : Erwan de FERRIERES