Requêteur

Le requêteur permet d'extraire des données personnalisées au format EXCEL. Il est accessible via le menu OUTILS > Requêteur.

Vues sources

Le requêteur propose d'accéder à différentes bases de données (vues sources) qui sont détaillées ci-dessous.

GEN_CONTACTSVISITES

La base de données GEN_CONTACTSVISITES permet d'extraire les données propres aux visites.

GEN_DOSSIER

La base de données GEN_DOSSIER permet d'extraire toutes les données propres aux chantiers.

GEN_DOSSIER_LIGNE

La base de données GEN_DOSSIER_LIGNE permet d'extraire toutes les données propres aux chantiers et de croiser les données suivantes :

Dossier	Contenu	Données extraites
TIERS	Données propres aux tiers	Toutes les données présentes dans la fiche tiers
PRODUIT	Données propres aux produits	Toutes les données présentes dans la fiche produit
PIECE	Données propres aux pièces commerciales rattachées au chantier	Toutes les données contenues dans la fiche de la pièce commerciale
DOSSIER	Données propres au chantier	Toutes les données contenues dans la fiche chantier
DOSSIER LIGNE	Données propres aux lignes	Applicable aux pièces commerciales fournisseur uniquement : % la ligne imputée à ce dossier Quantité de la ligne imputée à ce dossier Montant de la ligne imputée à ce dossier

GEN_DOSSIER_TACHE

La base de données GEN_DOSSIER_LIGNE permet d'extraire toutes les données propres aux chantiers et de croiser les données suivantes :

Dossier	Contenu	Données
DOSSIER	Données propres au chantier	Toutes les données contenues dans la fiche chantier
DOSSIER_TACHE	Données propres aux tâches du chantier	Nom et statut de la tâche

GEN_DOSSIER_TEMPS

La base de données GEN_DOSSIER_TEMPS permet d'extraire toutes les données propres aux chantiers et de croiser les données suivantes :

Dossier	Contenu	Données
DOSSIER	Données propres au chantier	Toutes les données contenues dans la fiche chantier
DOSSIER_TEMPS	Données propres aux temps saisis pour ce chantier	Temps saisis et tâches correspondantes aux temps saisis
OPERATEUR	Données propres aux opérateurs	Toutes les données contenues dans la fiche opérateur

GEN_LIGNE

La base de données GEN_LIGNE permet d'extraire toutes les données propres aux lignes commerciales des pièces commerciales et de les croiser avec les données suivantes :

Dossier	Contenu	Données
TIERS	Données propres aux tiers	Toutes les données présentes dans la fiche tiers
PRODUIT	Données propres aux produits	Toutes les données présentes dans la fiche produit
PIECE	Données propres aux pièces commerciales	Toutes les données contenues dans la fiche de la pièce commerciale
LIGNE	Données propres aux lignes commerciales	Toutes les données contenues dans la ligne commerciale
FOURNISSEUR PRINCIPAL PRODUIT	Données propres au fournisseur définit comme principal du produit	Toutes les données contenues dans la fiche du fournisseur principal
SOCIETE	Données propres à la société	Nom et code de la société concernée (pertinent uniquement en multi-société)

GEN_PIECE

La base de données GEN_PIECE permet d'extraire toutes les données propres aux pièces commerciales et de les croiser avec les données suivantes :

Dossier	Contenu	Données
TIERS	Données propres aux tiers	Toutes les données présentes dans la fiche tiers
PIECE	Données propres aux pièces commerciales	Toutes les données contenues dans la fiche de la pièce commerciale
SOCIETE	Données propres à la société	Nom et code de la société concernée (pertinent uniquement en multi-société)

GEN_PRODUIT

La base de données GEN_PRODUIT permet d'extraire toutes les données propres aux produits et de les croiser avec les données suivantes :

Dossier	Contenu	Données
PRODUIT	Données propres aux produits	Toutes les données présentes dans la fiche produit
FOURNISSEUR PRINCIPAL PRODUIT	Données propres au fournisseur définit comme principal du produit	Toutes les données contenues dans la fiche du fournisseur principal

GEN_SOCIETE

La base de données GEN_SOCIETE permet d'extraire les noms et codes internes des sociétés. Cette fonctionnalité est pertinente uniquement sur une fonctionnement en multi-sociétés.

GEN_TIERS

La base de données GEN_TIERS permet d'extraire les informations extraites dans les fiches tiers.

Créer une requête

Pour créer une requête :

1. Aller dans le menu OUTILS > Requêteur

2. Cliquer sur + Nouveau

3. Dans l'onglet Général

   1. Cocher la case Requête de base pour rendre la requête visible à tous les utilisateurs de la société et sélectionner, le cas échéant, une famille de requêtes (ou créer une famille de requêtes en cliquant sur l'icône ). Si la case n'est pas cochée, la requête est accessible uniquement à l'utilisateur qui l'a créée.

   2. Cocher la case Requête spécifique pour écrire directement le code SQL de la requête dans l'onglet Requête spécifique. Si la case est cochée, seul l'onglet Requête spécifique s'affichera dans la FICHE REQUÊTE

   3. Sélectionner le type de requête (requête de base ou requête spécifique)

   4. Dans le champ Nom de la requête, donner un nom à la requête

   5. Dans le champ Vue source, sélectionner la base de donnée depuis laquelle extraire des données

4. Aller ensuite dans l'onglet Description.

Description

L'onglet Description permet de sélectionner plus spécifiquement les données que l'on souhaite extraire dans la base de données choisie.

Pour ajouter une donnée à la requête :

1. Aller dans l'onglet Description

2. Dans le tableau COLONNES DISPONIBLES :

   1. Sélectionner une donnée à extraire

   2. Cliquer sur l'icône pour l'ajouter à la requête

3. Dans le tableau COLONNES SELECTIONNEES :

   1. Sélectionner une donnée à supprimer de la requête

   2. Cliquer sur l'icône , sur la touche Suppr ou double-cliquer sur la ligne pour la supprimer de la requête

   3. Cocher la case Desc pour afficher les résultats de la donnée par ordre décroissant

   4. Cocher la case Total pour exporter uniquement la somme pour le critère sélectionné, la case Grouper est alors cochée par défaut. Cette fonctionnalité est applicable aux champs numériques uniquement.

   5. Cocher la case Rupture pour afficher un total intermédiaire

4. Cocher l'icône Grouper pour grouper les données

5. Les icônes permettent de modifier l'ordre d'affichage des colonnes dans la requête

6. Aller ensuite dans l'onglet Paramètres

Chaque donnée sélectionnée est décrite dans le champ en bas du tableau COLONNES DISPONIBLE.

Paramètres

L'onglet Paramètres permet de sélectionner, pour les données ayant différentes valeurs possibles, la valeur que l'on souhaite extraire.

Exemple

Le paramètre @Tiers_Type contient les valeurs :

• C pour Client

• F pour Fournisseur

• P pour Prospect

En double-cliquant sur la valeur C, on choisit d'extraire uniquement les données propres aux tiers de type Client.

Le champ Commentaires sur la requête permet de saisir des commentaires afin d'expliquer la requête si nécessaire.

Pour ajouter un paramètre à une requête :

1. Aller dans l'onglet Paramètres

2. Les données paramétrables de la requête sont affichés dans le tableau

3. Sélectionner la donnée concernée

4. Cliquer sur l'icône pour voir les valeurs acceptées pour le paramètre sélectionné.

Le détail du paramètre peut être consulté dans l'onglet Description : en sélectionnant le paramètre concerné, une description de la donnée apparaît en bas du tableau COLONNES DISPONIBLES.

1. Double-cliquer sur la valeur à retenir

L'onglet Paramètres permet de choisir une seule valeur par paramètre. Pour choisir plusieurs valeurs par paramètre, laisser le champ Valeur vide pour le paramètre concerné et aller dans l'onglet Conditions Avancées.

Conditions Avancées

L'onglet Conditions Avancées permet d'appliquer des critères permettant de filtrer les données extraites.

Exemple

On souhaite extraire uniquement les données des pièces commerciales créées entre le 01/01/25 et le 31/12/25, en appliquant une condition avancée de type "est compris entre" sur le paramètre Piece_Date.

Pour ajouter une condition avancée à une requête :

1. Aller dans l'onglet Conditions Avancées

2. Sélectionner un paramètre sur lequel on souhaite appliquer une condition

3. Cliquer sur l'icône pour l'ajouter aux paramètres

4. Dans la fenêtre CONDITION AVANCEE :

   1. Sélectionner, dans le menu déroulant, le type de condition à appliquer

   2. Saisir la valeur concernée dans le champ correspondant

   3. Cliquer sur Enregistrer

   4. Puis cliquer sur Fermer

Les dates sont à saisir au format JJ/MM/AA.

1. Pour modifier supprimer une condition avancée :

   1. Sélectionner la condition dans le tableau COLONNES SELECTIONNEES

   2. Appuyer sur la touche Suppr pour supprimer la condition

   3. Double-cliquer sur la condition pour la modifier puis cliquer sur Enregistrer et Fermer

2. Cliquer sur Valider

Vers

L'onglet Vers permet de sélectionner le mode d'affichage du résultat de la requête :

• le bouton LANCER VERS UNE TABLE affiche le résultat de la requête dans ATOOK

• le bouton LANCER VERS EXCEL permet d'exporter la requête au format EXCEL (.xls)

• le bouton Code SQL permet d'afficher le code SQL de la requête et de le copier (et le coller ensuite dans le champ dédié, dans le cas d'une requête spécifique)

Le requêteur est un outil gourmand, selon la taille des requêtes, l'extraction de la table ou du fichier Excel peut prendre quelques secondes ou quelques minutes.

L'application de paramètres permet de limiter la taille de l'export et l'optimiser la vitesse de chargement.

Exemple

Dans notre exemple, on souhaite créer une requête :

• Accessible par tous les utilisateurs ;

• Pour extraire le montant total hors taxes facturé :

  • Par familles de chantiers ;

  • Par qualité de client (ici nous avons deux qualités de client : Professionnels et Particuliers) ;

  • Sur la période allant du 01/01/25 au 31/12/25.

Création de la requête

Pour créer la requête, nous allons dans le menu OUTILS > Requêteur.

Dans la fiche requête, nous nommons notre requête CA par familles de chantiers - particuliers 2025.

Nous choisissons la base de données GEN_DOSSIER_LIGNE car celle-ci permet de croiser les données des chantiers, les lignes commerciales des chantiers et les tiers concernés par les chantiers.

Nous cochons la case requête de base pour laisser la requête visible à tous les utilisateurs et l'ajoutons à la famille de requêtes CA.

Sélection des données à exporter

Nous nous rendons dans l'onglet Description pour sélectionner les données à exporter. Dans notre cas, on souhaite connaître :

• les familles de chantiers correspondantes aux montants facturés ;

• les qualités de clients correspondantes aux montants facturés ;

• le montant total hors taxes facturé dans les lignes commerciales liées aux chantiers.

Nous allons d'abord chercher la donnée qui permet d'extraire la famille de chantier rattachée à chaque pièce commerciale.

Celle-ci se trouve dans le dossier DOSSIER > Informations générales > Dossier_Famille.

Nous ajoutons le champ aux colonnes sélectionnées.

Nous ajoutons ensuite le champ Tiers_Qualité qui contient la qualité des tiers liés aux chantiers (dans notre cas, Professionnel ou Particulier).

Nous allons enfin chercher la donnée montant facturé, qui se trouve dans le dossier DOSSIER_LIGNE > Imputation ligne > DossierLigne_MontantHT.

Nous cochons la case Total pour ce champ car nous ne souhaitons pas afficher le détail des lignes mais uniquement le montant total facturé dans les lignes commerciales des chantiers.

Conditions avancées

Ici, nous ajoutons les conditions avancées suivantes :

• extraire uniquement les pièces commerciales créées entre le 01/01/2025 et le 31/12/2025 ;

• extraire uniquement des pièces commerciales de type facture client (F).

Résultat de la requête

Dans l'onglet Vers, nous cliquons sur LANCER VERS EXCEL pour exporter les résultats au format EXCEL. Nous obtenons l'export EXCEL suivant, affichant le montant total facturé par famille de chantier et par qualité de clients, sur la période du 01/01/25 au 31/12/25.

Relancer une requête existante

Pour relancer une requête déjà créée :

1. Aller dans le menu OUTILS > Requêteur.

2. Double-cliquer sur la requête à relancer ou sélectionner la requête et cliquer sur Ouvrir

3. Aller dans l'onglet Vers

4. Cliquer sur le bouton LANCER VERS UNE TABLE pour afficher le résultat de la requête dans ATOOK

5. Cliquer sur le bouton LANCER VERS EXCEL pour exporter la requête au format EXCEL (.xls)

6. Cliquer sur le bouton Code SQL pour afficher le code SQL de la requête et le copier (et le coller ensuite dans le champ dédié, dans le cas d'une requête spécifique)

La coche LR (pour "Lancement rapide") au bas de la fenêtre requêteur permet d'afficher uniquement l'onglet Vers de la requête ouverte.

Modifier une requête

Pour modifier une requête existante :

1. Aller dans le menu OUTILS > Requêteur ;

2. Vérifier que la case LR au bas de la fenêtre est bien décochée : si celle-ci est cochée, seul l'onglet Vers des requêtes ouvertes sera affiché ;

3. Double-cliquer sur la requête à relancer ou sélectionner la requête et cliquer sur Ouvrir ;

4. Apporter les modifications souhaitées ;

5. Cliquer sur Valider pour enregistrer les modifications.