Données d'un autre module - unique

Le champ "données d'un autre module" peut avoir plusieurs affichages, dépendant de sa configuration :

• Affichage "Classique" :
  • Le champ s'affiche comme un menu déroulant. Ses options correspondent au élément du module lié. Il possède également un bouton "+" qui permet de créer un élément du module lié directement depuis le champ

• Affichage "Avancé" : Sous cette forme, un champ de recherche remplace le champ en lui même. On retrouve toujours le bouton "+" de création sur la partie droite pour créer un élément du module lié directement depuis le champ. Les options s'affichent de base toutes sous le champ de recherches et peuvent être cliquées pour être choisies.
  • INFORMATIONS : Si le champs possède trop d'options, celles-ci ne seront pas toutes affichées au chargement et il sera nécessaire d'effectuer une recherche pour qu'elles apparaissent.

• Affichage "Champ de recherche" : Sous cette forme, le champ devient un simple champ de recherche libre avec un bouton "Rechercher" sur la droite.

Une fois le texte étant terminé d'être saisi, le système vérifiera que celui-ci existe et est valide et affichera un message de confirmation ou d'erreur en dessous

En visualisation, sous sa forme standard, la date s'affiche sous forme de cartouche contenant la valeur de l'élément choisi. Il est également possible de forcer un paramètre dans la configuration du champ qui permet d'afficher ce résultat sous forme de "carte" (voir la section "Spécificité du champ")

Le cartouche est cliquable pour accéder au menu contextuel de modification de cet élément

Cas d'utilisation

Un champ "données d'un autre module" peut avoir une grande diversité d'utilisation, voici une liste non exhaustive vous donnant quelques exemples d'utilisation dans lequel vous pouvez utiliser un champ "Données d'un autre module" :

• Retrouver les données d'un autre module / Lier deux modules : Par exemple, dans un module contact il est important de connaitre la société du contact. Cette société peut venir d'un autre module "Sociétés". Les deux modules seraient reliés par ce champ
• Système de gestion des codes promotions : Avec un champ en affichage recherche, il est possible de faire une gestion des codes promos efficace.

Revoir avec beber !!!

Lors de la configuration du champ, après avoir ouvert les options d'affichage (Icône de crayon), une fenêtre apparaît vous permettant de modifier les informations suivantes :

L'onglet : Général

• Label : Le label est affiché au dessus du champ dans les formulaires ;
• Type d'affichage : Modifie le type d'affichage dans les formulaires d'édition :
  • Afficher en édition : Dans un formulaire en édition, cette option affiche le champ en édition classique ;
  • Afficher en visualisation : Dans un formulaire en édition, cette option affiche le champ en visualisation. Son contenu sera affiché mais il sera impossible de modifier la valeur ;
  • Cacher par défaut : Dans un formulaire en édition ou en visualisation, cette option cache le champ. Il pourra cependant être affiché via des règles ;
  • Ne pas afficher :  Dans un formulaire en édition ou en visualisation, cette option empêche l'API de retourner le champ. Il ne pourra pas être affiché via des règles.
• Ce champ n'est pas exportable : Si cette case est cochée, elle empêche l'export des données de ce champ ;
• Ce champ n'est pas importable : Si cette case est cochée, elle empêche l'import de données dans ce champ ;
• Ce champ n'est pas recherchable : Si cette case est cochée, elle empêche la recherche de données dans ce champ ;
• Rendre obligatoire : Si cette case est cochée, en édition, elle oblige la saisie de données afin de pouvoir valider le formulaire :
  • Un * apparaît à la suite du label alors pour indiquer que ce champ est obligatoire ;
  • Un message d'erreur s'affiche si l'utilisateur valide le formulaire sans avoir saisi les données d'un champ obligatoire.

L'onglet : Supplémentaires

• Navigateur : Aide à la saisie : Lorsque l'aide à la saisie du navigateur est rempli, elle fait apparaître un icône d'information à côté du label lorsque le champ est affiché en édition ;

• Navigateur : Aide à la saisie - Afficher sous le label : Cette case à cocher permet d'afficher l'aide à la saisie du navigateur sous le label au lieu de l'icône d'information classique.

• Navigateur : Précisions sur le champ : Lorsque la précision sur le champ est remplie, elle fait apparaître un icône d'information à côté du label lorsque le champ est affiché en visualisation ;

• Navigateur : Précisions sur le champ - Afficher sous le label : Cette case à cocher permet d'afficher l'aide à la saisie du navigateur sous le label au lieu de l'icône d'information classique.

• Application : Aide à la saisie : Lorsque l'aide à la saisi de l'application est remplie, elle fait apparaître un icône d'information à côté du label lorsque le champ est affiché en édition ;
• Application : Aide à la saisie - Afficher sous le label : Cette case à cocher permet d'afficher l'aide à la saisie de l'application sous le label au lieu de l'icône d'information classique.
• Application : Précisions sur le champ : Lorsque la précision sur le champ est remplie, elle fait apparaître un icône d'information à côté du label lorsque le champ est affiché en visualisation ;
• Application : Précisions sur le champ - Afficher sous le label : Cette case à cocher permet d'afficher l'aide à la saisie de l'application sous le label au lieu de l'icône d'information classique.
• Référence interne : Une référence unique pour le champ. Si le champ n'est pas rempli, la référence sera générée automatiquement :

Spécificités du champ : 

• Module : Le module à lier au champ via un menu déroulant des modules déjà créés.
• Formulaire pour la création : La liste des formulaire de création créés sur le module liés et qui sera utilisé pour faire la création via le bouton "+"
• Mode d'affichage en édition : Un menu déroulant pour choisir le mode a utiliser. Les modes sont détaillés dans la première section "Affichage"
• Mode d'affichage avancé : afficher les éléments directement : TODO
• Créer le champ correspondant : Défini si le champ "Retour de relation" doit être créé automatiquement dans le module lié (pour voir ce qu'est un champ "Retour de relation", voir la documentation détaillée ici)
• Afficher la vue en tant que carte : Force l'affichage en vue seulement pour proposer un affichage sous format carte (voir le détail dans la section "Affichage" du champ)

Configuration : 

Lors de la configuration du champ "données d'un autre module", après avoir cliqué sur le bouton de configuration (Icône de roue crantée), une fenêtre apparaît vous permettant de paramétrer de nouvelles possibilités pour ce champ :

• Limiter les recherches aux champs suivants : Permet de limiter la recherche des données seulement sur quelques champs, par exemple : le nom et le prénom d'une personne
• Mode de recherche : Il en existe deux :
  • Recherche partielle : Lance une recherche qui retourne tous les éléments qui contiennent ou ressemble au texte saisi
  • Recherche exacte : Lance une recherche qui retourne exactement les éléments qui matchent le texte saisi
• Restreindre les résultats avec les règles : Permet de proposer un élément seulement si au moins une des règles sélectionnées est valide
• Sélectionner automatiquement si un seul résultat trouvé : Si la recherche lancée ne retourne qu'un seul résultat, celui-ci est automatiquement sélectionné dans le sens
• Filtrer les options du champ en fonction d'un autre champ :

Pour ajouter un filtre, procéder comme suis :

• Choisir le champ sur le module en cours dans le menu déroulant de gauche - Ci dessus le module "Contacts"
• Choisir le champ sur sur le module lié dans le menu déroulant de droite - Ci dessus le module "Facturation"

Ces champs doivent être sensiblement les mêmes, par exemple :

• Le module lié "Facturation" a un menu déroulant contenant les options :
  • val1 - Valeur 1
  • val2 - Valeur 2
  • val3 - Valeur 3
• Le module en cours "Contacts" devra avoir un menu déroulant similaire pour que le filtre puisse s'appliquer

Dans cet exemple, si l'élément en cours du module "Contacts"  a pour ce menu déroulant la valeur : "val2" - Seuls les éléments du modules liés "Facturation" qui auront comme valeur "val2" au champ défini plus haut seront recherchés.