Working with Tables

Adaptation Models can organize Master Data in tables. Tables allow to manage high volumes of data and provide features similar to relational databases.

All concepts you have learned about reading and editing Master Data can be applied to tables.

Navigate in a table

At the top right side of the table, navigation buttons allow to go to the first / previous / next / last page.

A menu called View, located at the top of the table, allows to perform the following tasks:

• Show or hide filters.
• Use form or tabular edition mode.
• By default, a table displays 10 occurrences by page. Sub-options of option Show records of menu View allow to change the number of displayed occurrences by page.

Another menu called Action, also located at the top of the table, allows to perfom several tasks:

• Select records: all or none
• Services on selected records: compare, apply last modification(s).
• Services on table: print table contents.

When first diplayed, table occurrences are sorted by the primaryKey table columns. New sorting can be done by selecting columns headers. All selected columns are used and the last selected column is considered as having the priority. Null values are sorted as minimum values.

Note that sort on specific format fields is not yet implemented. Standard format is used.

Master Data in a table can have 2 colors codes:

• A light blue data indicates that the value inherits from the parent adaptation. The icon is displayed.
• A yellow data indicates that the value has been defined in current adaptation (overwrites inherited value). The icon is displayed.

To view a table record, double click on it.

The icon indicates that the data is part of the primary key.

Edit a table

Edition of Master Data in table works the same way than other data. At the top left side of the table, you can use the button to create a new record.

In form edition mode (default), you have to double-click on an existing recordin order to update it. To activate this mode, if it is not the current one, choose Form option in the menu View at the top of the table.

On a table, you can use buttons at the right side of each record:

• Duplicate a record
• Derivate a record. Derivation is a complex concept: It allows you to create a new record that inherits from another record. Usually, derivation is not available on tables.
• Delete or Occult. If the record has been created in current adaptation, you can delete it. If it overwrites the record inherited from a parent adaptation, you cannot delete it, but you can "occult" it.

Tabular Edition

It is possible to edit Master Data values directly into a table. To activate this mode, choose Tabular option in the menu View at the top of the table.

To edit a record, simply click on it. Note that tabular edition works only on simple types (complex types are too large to display). You must validate or cancel your record updates in order to edit another record. You can also double click on a record if you want to access the detailed form (default mode).

 

Applying filters and search

Some tables can define filters. Filters allows you to apply select criteria on table contents, in order to restrict the records displayed (see "Add UI component and filter" tutorial for more details).

Multiple filters can be applied at the same time on a table. Only records which validate all applied filters will be displayed in the table.

By default, each tables comes with a multi-criteria search filter. For showing (respectively hidding) filters, choose Show Filters (respectively Hide Filters) in the menu View at the top of the table. You can then configure your search and apply your filter.

Note that to execute a specific filter, you have to select it in the Search menu.

Search features are:

• Type one or more search criteria
• Select multiple fields (columns of your table)
• Case sensitive
• Whole word
• Code only (for values whose display adds a user label, for example enumerations, nomenclatures or references to table records – if this option is activated, labels are ignored by the search, only underlying values are taken into account)

Use cases for numeric fields search

Criteria	Value	Whole word checked
100	100 10100 1.1001	100
1,00	1,000 901,000	no value
1.11	1.11 1.111 901.111	1.11
1 1	no value	no value
1	1.00	no value

Utiliser les tables

Les modèles d'adaptation peuvent organiser les données en tables. Les tables permettent de gérer d'importants volumes de données et fournissent des fonctionnalités similaires aux bases de données relationnelles.

Tous les concepts que vous avez appris pour lire et mettre à jour des données s'appliquent aux tables.

Naviguer dans une table

Au-dessus et à droite de la table, des boutons de navigation permettent de se déplacer : Premier / Précédent / Suivant / Dernier.

Un menu nommé Affichage, situé au-dessus de la table, permet d'effectuer les tâches suivantes :

• Filtres. Voir ou cacher les filtres.
• Type d'édition. édition sous forme de fiche ou sous-forme tabulaire.
• Par défaut, une table affiche 10 occurrences par page. Les sous-options de l'option Voir les enregistrements du menu Affichage permettent de changer le nombre d'occurrences affichées.

Un autre menu nommé Action, situé également au-dessus de la table, permet d'effectuer différentes tâches :

• Sélection d'enregistrements.
• Comparer des enregistrements sélectionnés.
• Imprimer le contenu de la table.

Lors du premier affichage, les occurrences de la table sont triées par les colonnes de la clé primaire. Pour trier à nouveau, sélectionnez les entêtes des colonnes. Toutes les colonnes sélectionnées seront utilisées par le tri, la dernière colonne étant la plus prioritaire. Les valeurs nulles sont considérées comme étant des valeurs minimales.

Notez que le tri sur des champs au format spécifique n'est pas encore implémenté. Le format standard est utilisé.

Les données dans une table peuvent avoir deux couleurs :

• Le bleu clair indique que la valeur hérite de l'adaptation parente. L'icône est affichée.
• Le jaune indique que la valeur a été définie dans l'adaptation courante (surcharge de l'héritage). L'icône est affichée.

Pour visualiser une occurrence de la table, double-cliquez dessus.

L'icône indique que la donnée fait partie de la clé primaire.

Mettre à jour une table

La mise à jour d'une table fonctionne de la même manière que pour les autres données.  En haut à gauche de la table, le bouton permet de créer un nouvel enregistrement.

Dans le mode d'édition formulaire (mode par défaut), il faut double-cliquer sur un enregistrement pour le mettre à jour. Pour activer ce mode, s'il n'est pas le mode d'édition courant, choisissez l'option Fiche dans le menu Affichage au-dessus de la table.

Sur une table, vous pouvez accéder à droite aux fonctions suivantes :

• Dupliquer une occurrence
• Dériver une occurrence. La dérivation est un concept complexe qui permet de créer une nouvelle occurrence qui hérite d'une autre. La dérivation peut ne pas être autorisée sur votre modèle d'adaptation.
• Détruire ou occulter. Si une occurrence a été créée dans l'adaptation instance courante, vous pouvez la détruire. Si elle surcharge l'occurrence héritée d'une adaptation instance parente, vous ne pouvez pas la détruire mais l'occulter.

Edition tabulaire

Il est possible de mettre à jour les données directement dans une table. Pour activer ce mode, choisissez l'option Tabulaire dans le menu Affichage au-dessus de la table.

Pour éditer une occurrence en mode tabulaire, cliquez simplement sur l'occurrence. Notez que l'édition tabulaire ne fonctionne que sur les données de type simple (les données de type multi-occurrences sont trop importantes à afficher). Vous devez valider ou annuler votre ligne avant d'en éditer une autre. Vous pouvez également double-cliquer sur une occurrence pour accéder à son détail (mode par défaut).

Appliquer des filtres et recherches

Certaines tables peuvent définir des filtres. Les filtres permettent d'appliquer des critères au contenu de la table, afin d'en restreindre l'affichage (voir le tutoriel "Add UI component and filter" pour plus de détails).

Plusieurs filtres peuvent être appliqués en même temps sur une table. Seuls les enregistrements qui valident tous les filtres appliqués seront affichés dans la table.

Par défaut, chaque table dispose d'un filtre générique de recherche multi-critères. Pour afficher (respectivement cacher) les filtres, choisissez l'option Voir Filtres (respectivement Cacher Filtres) dans le menu Affichage situé au-dessus de la table. Vous pouvez ainsi configurer votre recherche et l'appliquer à la table.

Notons que pour exécuter un filtre spécifique, il faut le sélectionner dans le menu Rechercher.

Les fonctions de recherche sont :

• Un ou plusieurs termes
• Plusieurs champs (les colonnes de la table)
• Respect de la casse
• Mot entier ou non
• Code seulement (pour les valeurs dont l'affichage ajoute un libellé utilisateur, par exemple une énumération, une nomenclature ou une référence à un enregistrement de table – si cette option est activée, les libellés sont ignorés par la recherche, uniquement les codes sous-jacents sont pris en compte)

Cas d'utilisation pour des recherches sur des champs numériques

Terme à chercher	Valeurs	Mot entier sélectionné
100	100 10100 1.1001	100
1 00	1 000 901 000	Aucune valeur
1,11	1,11 1,111 901,111	1,11
1.1	Aucune valeur	Aucune valeur
1	1,00	Aucune valeur