Recherches

Guide administrateur #

Introduction #

Une recherche au sens YellowBox CRM est un ensemble de critères dont le résultat est représenté sous la forme d’une liste de fiches à des fins de consultation/modification et/ou utilisée dans le paramétrage de traitements :

Côté utilisateur #

• Identifier une liste de fiches correspondantes aux critères composants la recherche
• Effectuer des combinaisons de résultats de recherches :
  • Sur toute la base
  • Dans la sélection existante
  • Sur toute la base et dont le résultat est à ajouter à la sélection existante
  • Sur toute la base et à soustraire de la sélection existante

Côté administrateur #

• Pré-créer des recherches pour les utilisateurs
• Utiliser si nécessaire des recherches dans le cadre du paramétrage pour :
  • Les appliquer au niveau de listes
  • Les appliquer au niveau du paramétrage de traitements :
    • Tableaux de bords
    • Plugins
    • Exports
    • …

Créer une recherche #

YellowBox CRM offre la possibilité de créer selon le besoin de nouvelles recherches. L’accès au menu permettant de consulter/modifier les recherches existantes ou d’en créer de nouvelles est réalisé via le bouton en haut à droite du panneau de commande gauche puis en cliquant sur ‘Ecrans et structure’ puis ‘Recherches’.

Pour créer une nouvelle recherche, cliquer sur le bouton Ajouter présent dans le bandeau haut.

Les paramètres communs #

L’écran permettant le paramètrage d’une recherche se décompose en deux parties :

• Une entête avec les zones suivantes :
  

  • Nom
  • Table
  • Accès
    Il est possible de définir les groupes et/ou les utilisateurs qui pourront visualiser et utiliser la recherche courante. En revanche, seuls les utilisateurs de type ‘Administrateur’ pourront la modifier à partir du paramétrage.
    
    

• Une zone de saisie des critères de recherche :
  
  Il est possible de formuler une recherche selon deux méthodes :
  

  • Une recherche multicritères
  • Une recherche de type SQL

La bascule entre l’une ou l’autre des méthodes est effectuée via le bouton [Changer le mode de recherche SQL/Critère].
Les recherches paramétrées par un administrateur sont accessibles par les utilisateurs autorisés à les exécuter à partir des listes principales et des sous listes.

La recherche multicritères #

Ce type de recherche permet de paramétrer jusqu’à dix critères dont un premier fixe : le Gestionnaire de la fiche et un second uniquement lorsque la recherche porte sur la table action, le champ Participants.
Les neuf autres critères sont paramétrables comme suit :

• Le bouton présent à droite de chacune des lignes, permet de vider une ligne si nécessaire. Après sauvegarde les lignes renseignées situées en dessous de lignes vidées, remontent.

• Sélectionner le champ ou la recherche :

  • Les champs de la table sélectionnée et des tables liées via le bouton
  • Les recherches existantes via le bouton
    
    

Une même recherche ne peut contenir que des ‘ET’ ou que des ‘OU’ : la combinaison de ET et de OU est réalisable via l’utilisation de recherches.

• Sélectionner l’opérateur :

Après avoir sélectionné un champ, il convient de sélectionner l’opérateur à combiner à ce champ ; voici la liste des opérateurs disponibles :

• Sélectionner la valeur ou les attendues

Il est possible de saisir dans cette zone la valeur recherchée. Plusieurs valeurs peuvent être saisies : elles sont alors séparées par le caractère ‘|’ (AltGR+6) correspondant à un ‘OU’ (saisir sans espace avant et après).

Dans le cas de valeurs sur un champ de type date, la saisie n’est aps effectuée directement, mais via les valeurs listées ci-dessous :

Pour enregistrer la recherche, cliquer sur le bouton [Valider] de la palette flottante en bas de l’écran.

La recherche SQL #

Dans certains cas d’usage, il peut être nécessaire de devoir saisir une recherche via le mode de saisie SQL. Ce mode est activable via le bouton Changer de mode de recherche SQL/Critère.

Il convient alors de saisir une requête au format suivant :

Update Nom_de_la_table
Set
Nom_duchamp = xxxx
Where xxxx;

Ce mode est un mode avancé fortement déconseillé en cas de méconnaissance du SQL.

Le bouton [Structure de la base] permet d’ouvrir un nouvelle onglet avec tous les éléments constituant la base, leurs noms physiques et les identifiants des relations entre les tables.

Il est possible d’utiliser des variables dans le corps d’une requête SQL telles que :

• ’##reffiche$$’
  Correspond à l’identification de la fiche courante lors de l’exécution de la recherche
• ’##userid$$’
  Correspond à l’identifiant de l’utilisateur connecté lors de l’exécution de la recherche
• ’##lat$$’ et ’##lng$$’
  Correspond aux coordonnées géographiques de l’utilisateur connecté (sous réserve que l’utilisateur ait donné son accord sur sa géolacalisation).

Le bouton de bascule entre les deux modes n’est visible que par les utilisateurs qui ont un profil ‘Administrateur’.

Liste des utilisations de la recherche #

Ce dernier encart situé en bas d’écran apparaît dans le cas où la recherche courante est utilisée par au moins un traitement. Est affiché alors le type de traitement puis son nom.

La liste des recherches #

Accessible via le bouton en haut à droite du panneau de commande gauche puis en cliquant sur ‘Ecrans et structure’ puis ‘Recherches’, la liste des recherches affichée permet de visualiser et/ou de modifier une recherche existante en cliquant sur sa ligne, ou d’en supprimer une en cliquant sur le bouton présent en fin de ligne.

Le bouton n’apparaît que sur les recherches non utilisées par un traitement.

Pour retrouver une recherche en particulier parmi la liste, il est possible d’utiliser les deux filtres présents en entête de liste permettant des filtres selon :

• Le nom de la recherche
  

• La table sur laquelle porte la recherche