Paramétrage de l'état (.drp) (Concepteur de requêtes)

De Wiki1000
(Différences entre les versions)
 
(11 révisions intermédiaires par un utilisateur sont masquées)
Ligne 1 : Ligne 1 :
 
== Dossier Généralités ==
 
== Dossier Généralités ==
 +
 +
{{#images:requeteuretatproprietesdefinition.png|requeteur}}
  
 
* '''Nom'''
 
* '''Nom'''
Ligne 8 : Ligne 10 :
  
 
C’est le nom qui devra être sélectionné dans la liste des requêtes lors de la visualisation et/ou de la modification de l’état. Par défaut le programme propose le nom de l’état.
 
C’est le nom qui devra être sélectionné dans la liste des requêtes lors de la visualisation et/ou de la modification de l’état. Par défaut le programme propose le nom de l’état.
 
* '''Projet'''
 
 
Les états peuvent être regroupés par paquet (ensemble d’objets organisés par thème). Vous devez sélectionner dans la liste le projet dont dépend la nouvelle requête.
 
  
 
* '''Groupe'''
 
* '''Groupe'''
Ligne 20 : Ligne 18 :
  
 
C'est la personne qui a créé la requête.
 
C'est la personne qui a créé la requête.
 +
 +
* '''Projet'''
 +
 +
Les états peuvent être regroupés par paquet (ensemble d’objets organisés par thème). Vous devez sélectionner dans la liste le projet dont dépend la nouvelle requête.
  
 
* '''Statut'''
 
* '''Statut'''
Ligne 31 : Ligne 33 :
 
Impression : les requêtes sont destinées à être éditées.
 
Impression : les requêtes sont destinées à être éditées.
  
ETL : les requêtes ETL permettent la synchronisation des tables datamart avec les données de l’application.
+
:ETL : les requêtes ETL permettent la synchronisation des tables datamart avec les données de l’application.
  
XML (par colonne, par ligne, arbre) : les requêtes xml permettent de générer un flux xml. Ce flux alimentera notemment des objets flash.
+
:XML (par colonne, par ligne, arbre) : les requêtes xml permettent de générer un flux xml. Ce flux alimentera notemment des objets flash.
  
XML par colonne : une colonne de la requête correspond à une série et une ligne de la requête correspond à la valeur de la série. La première colonne de la requête alimente l’item Dimension.
+
:XML par colonne : une colonne de la requête correspond à une série et une ligne de la requête correspond à la valeur de la série. La première colonne de la requête alimente l’item Dimension.
  
XML par ligne : une ligne de la requête correspond à une série et une colonne correspond à la valeur de la série. L’item Dimension fournit le nom des colonnes.
+
:XML par ligne : une ligne de la requête correspond à une série et une colonne correspond à la valeur de la série. L’item Dimension fournit le nom des colonnes.
  
XML en arbre : les items générés forment un arbre grâce aux liens parents-enfants. Il est nécessaire de renseigner les colonnes parent et enfant dans le dossier «Arbre» des propriétés de la requête.
+
:XML en arbre : les items générés forment un arbre grâce aux liens parents-enfants. Il est nécessaire de renseigner les colonnes parent et enfant dans le dossier «Arbre» des propriétés de la requête.
  
RSS : les requêtes rss permettent de générer un flux rss. Seules les deux premières colonnes visibles de la requête sont exploitées par le flux rss. La première colonne alimente l’attibut Title et la seconde l’attribut Description.
+
:RSS : les requêtes rss permettent de générer un flux rss. Seules les deux premières colonnes visibles de la requête sont exploitées par le flux rss. La première colonne alimente l’attibut Title et la seconde l’attribut Description.
  
* '''Publier comme Web service.
+
* '''Publier comme Web service.'''
  
 
Spécifie si la requête doit être accessible et temps que Web service.
 
Spécifie si la requête doit être accessible et temps que Web service.
Ligne 49 : Ligne 51 :
 
== Dossier exécution ==
 
== Dossier exécution ==
  
* '''Sous requête exécutée en une seule fois'''
+
{{#images:requeteuretatproprietesexecution.png|requeteur}}
  
Case à cocher permettant d’optimiser la lecture des sous-requêtes. Toutes les requêtes sont générées en même temps sur le serveur. La requête principale associée à la sous-requête doit être triée à partir de champs persistants (mode SQL).
+
* '''Mode de fonctionnement.'''
  
* '''Sous requête devant être préparée'''
+
Trois modes sont proposés :
  
Case à cocher permettant d’améliorer les performances des sous-requêtes en utilisant la préparation des requêtes des serveurs SQL. Cette fonctionnalité est utilisable quel que soit le tri de la requête principale mais elle n’est pas utilisable en mode objet.
+
:SQL : 90 % des requêtes peuvent être générées en mode SQL. Les éléments dérivés ne sont pas accessibles en mode SQL
  
* '''Conditions d’impression'''
+
:Objet : toutes les requêtes peuvent être effectuées. Toutefois, la durée de traitement peut être plus longue.
  
Condition à vérifier pour que la requête soit imprimée.
+
:Par requête : dans le cas de multi-requêtes, cette option permet d’indiquer dans les propriétés de l’état le mode de fonctionnement de chaque requête.
  
* '''Imprimer lorsque la requête ne contient aucune donnée'''
+
Les requêtes SQL permettent de travailler sur les champs persistants présents dans la base de données alors que les requêtes objet permettent en plus de travailler sur les éléments dérivés (Champs d'une classe issue d'un attribut d'une autre classe ou d'un calcul sur un ou plusieurs attributs d'une classe).
  
Case à cocher permettant d’imprimer l’état qu’il y ait des données ou non.
+
Exemple
  
* '''Ne pas imprimer si les sous-requêtes ne contiennent aucune donnée'''
+
Un attribut permettant de savoir si l'écriture est au débit ou au crédit en fonction de la zone montant débit ou montant crédit renseignée.
 +
Il est donc presque toujours possible d'obtenir des résultats à partir des champs persistants de la base de données cependant cela peut entraîner des paramétrages complexes alors que pour un même résultat un élément dérivé peut exister et être utilisé simplement.
  
Lorsque cette fonctionnalité est activée, seules sont imprimées les lignes dont au moins une des sousrequête est non vide. Le filtre se fait dans l’ordre SQL.
+
* '''Classe société.'''
  
* '''Condition de non impression'''
+
Cette zone permet de sélectionner la classe permettant d’insérer les données relatives à la société. Par exemple, en sélectionnant ‘Paramètres société’, il sera possible d’indiquer la raison sociale et l’adresse de la société dans l’en-tête de l’édition.
  
Vous pouvez saisir une condition. La case à cocher Ne pas imprimer si les sous-requêtes ne contiennent aucune donnée s’active alors si et seulement si la condition est vérifiée.
+
* '''Exécution automatique.'''
  
* '''Inclure la requête dans le format'''
+
Case à cocher permettant de lancer automatiquement la requête lors de son ouverture lorsqu’elle est affectée à des ‘Jumelles’.
  
Lorsque la case est cochée, la sous-requête est prise en compte lors de la génération du format. Ainsi les bandes sont générées pour la sous-requête (excepté si la requête est de type valeur) et les champs de celle-ci sont accessibles depuis le format. Cette option est cochée par défaut. Lorsqu’une requête contient des champs calculés reprenant des données d’une sous-requête, mais que cette sous-requête n’est pas utilisée dans le format, vous pouvez décocher la case afin d’améliorer les performances.
+
* '''Blocage des données.'''
  
* '''Classe maître'''.
+
Cette option permet d’exploiter les données à instant donné sans tenir compte des mises à jour réalisées par
 +
les autres utilisateurs.
  
Sélectionnez la classe (d’appartenance) de la requête.
+
:Aucun : aucun blocage est effectué,
 
+
Ces deux boutons permettent :
+
:A la demande : lors de l’exécution de la requête un message s’affiche proposant le blocage des données.
 
   
 
   
d’ouvrir la fenêtre de sélection d’une classe,
+
:Toujours : le blocage est systématique.
  
d’ouvrir la fenêtre de sélection d’une vue de modèle : le programme utilise une vue de modèle à la place d’une classe .
+
* '''Ne pas aggéger les données.'''
  
* '''Imprimer les éléments des classes descendantes.'''
+
Cette option permet d'empêcher l'exécution en mode agréger (multi-sociétés).  
  
Lorsque cette case est cochée, les attributs des classes filles sont visibles dans la classe mère.
+
* '''Ne pas enchainer les données.'''
  
* '''Liaison'''
+
Cette option permet d'empêcher l'exécution en mode enchainé (multi-sociétés).
  
Lors de la construction des requêtes, sélectionnez le lien (l’élément ‘oid’) entre les requêtes.
+
== Format d’impression ==
 +
{{#images:requeteuretatproprietesformat.png|requeteur}}
 +
* '''Colonne contenant le format.'''
  
* '''Type état'''
+
Reprend le nom de la colonne de la requête indiquant s’il y a lieu, le format d’impression à utiliser.
  
Sélectionnez le type de l’état :
+
* '''Colonne contenant le nombre d’exemplaires.'''
  
Liste : permet d’obtenir un état présentant les données sous forme de liste comme le plan comptable par exemple. Chaque attribut de la classe correspond à une colonne.
+
Reprend le nom de la colonne de la requête indiquant le nombre d’exemplaires à imprimer. Ceci permet d’éditer, si nécessaire, par ligne Détail.
  
Formulaire : permet d’obtenir un état présentant les données les unes à la suite des autres comme les fiches des clients par exemple.
+
Cette option est visible uniquement en impression, non en visualisation.
  
Etiquettes : permet d’obtenir les étiquettes des adresses clients par exemple.
+
Pour paramétrer le nombre d’exemplaires de l’édition complète vous devez ouvrir le paramétrage de l’imprimante (Ecran de lancement/Options/Paramétrer l’imprimante).
  
Cumuls : permet d’obtenir un état présentant le cumul de chaque attribut sélectionné, comme la balance par exemple.
+
* '''Colonne contenant l’adresse e-mail.'''
  
Cube : permet de croiser des données lors de la constitution de l’état.
+
Reprend systématiquement le nom de la colonne de la requête contenant l’adresse e-mail à utiliser pour envoyer les enregistrements automatiquement. La colonne contient :
 
+
Valeurs : permet de créer une requête pour rechercher une information.
+
une seule valeur d’adresse mail, par exemple un champ calculé,
 
+
* '''Graphique'''
+
 
+
Sélectionnez le graphique approprié à la requête :
+
 
+
Aucun : aucun type de graphique n’est sélectionné.
+
 
+
Ligne : type de graphique présentant les données sous forme de points reliés entre eux par une ligne.
+
 
+
Aire : type de graphique affichant les données en tant que zones et mises en valeur par des couleurs ou des motifs différents.
+
 
+
Points : type de graphique présentant les données sous forme de points.
+
 
+
Barres : type de graphique affichant une rangée de colonnes les unes à côté des autres.
+
  
Barres horizontales : type de graphique affichant une rangée de colonnes les unes à côté des autres. Chaque colonne est constituée de sections.
+
un champ d’une table Intégrale qui contient une adresse e-mail différente pour chaque enregistrement par exemple la zone Adresse électronique de la fiche client.
  
Camembert : type de graphique présentant les données sous forme sectorielle dont les différentes sections sont mises en valeur par des couleurs ou des motifs différents.
+
Dans le cas d’envoi d’e-mail en automatique, un mail est transmis pour chaque ligne détail. L’envoi d’e-mail en automatique est donc recommandé dans le cas de requêtes de type maître-détail. La sous-requête est en effet considérée comme une ligne détail.
  
 +
Exemple
  
* '''Table à alimenter (Datamart)'''
+
Vous réalisez une requête maître-détail portant sur des clients dont on voit pour chacun la liste des pièces en cours. L’envoi d’e-mails en automatique adressera pour chaque client la liste des pièces lui correspondant.
  
Ce combo permet la sélection de la table qui va être alimentée. Dans ce combo seules les tables de type datamart sont affichées.
+
* '''Nom du fichier d'exportation.'''
  
* '''Colonne clé (Datamart)'''
+
Renseignez le nom du fichier (.pdf) qui contiendra le résultat de la requête.
  
Sélectionnez la clé de recherche permettant permet de retrouver la ligne de datamart à modifier ou à supprimer. Par défaut il s’agit d’un champ oid.
+
== Dossier Publipostage ==
  
* '''Date modification (Datamart)'''
+
{{#images:requeteuretatproprietespublipostage.png|requeteur}}
  
Sélectionnez le champ permettant de retouver la dernière date de modification. Par défaut il s’agit d’un
+
La fonction Publipostage permet d’intégrer les données extraites par une ou plusieurs requêtes dans un document Word.
champ UpdDate.
+
  
== Dossier Divers ==
+
Ces fusions sont de deux trois types :
  
* '''Colonne du message'''
+
Utilisation du publipostage de Word avec le résultat d’une requête,
  
Cette fonctionnalité permet d’insérer un message de progression dans les écrans de lancement (il affiche la valeur comprise dans le champ indiqué et permet d’indexer les pages de l’aperçu).
+
Intégration d’une requête dans un document Word ,
  
* '''Nom de l’écran'''
+
Intégration de plusieurs requêtes dans un document Word.
  
Renseignez, le cas échéant, le nom de l’écran de détail associé à la ligne de la requête. Ainsi, lorsque la requête est utilisée dans la barre Outlook l’écran de détail s’affichera si vous cliquez sur une ligne de la requête.
+
* '''Document word modèle.'''
  
* '''Colonne du flagage'''
+
Saisissez le nom du document modèle ou rechercher-le à l’aide du bouton ci-contre.
  
Cette fonctionnalité permet de « flaguer » les lignes éditées. Sélectionnez la colonne qui doit être flaguée.
+
Rappel : Un document modèle sert à la mise en forme d’un texte et ne contient pas de données. Il est possible de le modifier afin d’ajuster la présentation selon les besoins. Le Designer d’étatsRequêteur utilise ce document pour y insérer les données, et générer un document final.
  
* '''Condition du flagage'''
+
* '''Document word généré.'''
  
Cette zone permet d’exécuter le flagage uniquement si la condition de flagage est vérifiée. Indiquez le champ particulier qui servira au flagage.
+
Saisissez le nom du document final qui contiendra les données et sera généré lorsque vous lancerez la requête.
  
* '''Script SQL précédent l’exécution'''
+
* '''Utiliser le publipostage de Word.'''
  
Ce script SQL est exécuté avant l'exécution de la requête.
+
Lorsque cette case est cochée, vous pouvez utiliser le résultat d’une requête comme source de données dans un document Word .
  
* '''Script SQL suivant l’exécution'''
+
Lorsqu’elle n’est pas cochée, le document intègre pour chaque requête un tableau vide.
  
Ce script SQL est exécuté après l'exécution de la requête.
+
[[Category:Requêteur]]

Version actuelle en date du 13 janvier 2010 à 10:19

Sommaire

Dossier Généralités

requeteuretatproprietesdefinition.png

  • Nom

Saisissez le nom de l’état. Il s’agit du nom du fichier correspondant à l’état enregistré dans le dossier Reports de la Console d’Administration et dans le sous-dossier Interface du dossier Objet du référentiel. Lors de la modification ou de la visualisation de l’état, vous sélectionnez son titre et son nom (suivi de l’extension drp).

  • Titre

C’est le nom qui devra être sélectionné dans la liste des requêtes lors de la visualisation et/ou de la modification de l’état. Par défaut le programme propose le nom de l’état.

  • Groupe

Les états peuvent être regroupés par classe, par type… Vous pouvez soit sélectionner dans la liste le groupe, soit le saisir dans la zone.

  • Auteur

C'est la personne qui a créé la requête.

  • Projet

Les états peuvent être regroupés par paquet (ensemble d’objets organisés par thème). Vous devez sélectionner dans la liste le projet dont dépend la nouvelle requête.

  • Statut

Il est défini dans la fenêtre de sauvegarde

  • Type

Le type de requête dépend de l’utilisation de la requête.

Impression : les requêtes sont destinées à être éditées.

ETL : les requêtes ETL permettent la synchronisation des tables datamart avec les données de l’application.
XML (par colonne, par ligne, arbre) : les requêtes xml permettent de générer un flux xml. Ce flux alimentera notemment des objets flash.
XML par colonne : une colonne de la requête correspond à une série et une ligne de la requête correspond à la valeur de la série. La première colonne de la requête alimente l’item Dimension.
XML par ligne : une ligne de la requête correspond à une série et une colonne correspond à la valeur de la série. L’item Dimension fournit le nom des colonnes.
XML en arbre : les items générés forment un arbre grâce aux liens parents-enfants. Il est nécessaire de renseigner les colonnes parent et enfant dans le dossier «Arbre» des propriétés de la requête.
RSS : les requêtes rss permettent de générer un flux rss. Seules les deux premières colonnes visibles de la requête sont exploitées par le flux rss. La première colonne alimente l’attibut Title et la seconde l’attribut Description.
  • Publier comme Web service.

Spécifie si la requête doit être accessible et temps que Web service.

Dossier exécution

requeteuretatproprietesexecution.png

  • Mode de fonctionnement.

Trois modes sont proposés :

SQL : 90 % des requêtes peuvent être générées en mode SQL. Les éléments dérivés ne sont pas accessibles en mode SQL
Objet : toutes les requêtes peuvent être effectuées. Toutefois, la durée de traitement peut être plus longue.
Par requête : dans le cas de multi-requêtes, cette option permet d’indiquer dans les propriétés de l’état le mode de fonctionnement de chaque requête.

Les requêtes SQL permettent de travailler sur les champs persistants présents dans la base de données alors que les requêtes objet permettent en plus de travailler sur les éléments dérivés (Champs d'une classe issue d'un attribut d'une autre classe ou d'un calcul sur un ou plusieurs attributs d'une classe).

Exemple

Un attribut permettant de savoir si l'écriture est au débit ou au crédit en fonction de la zone montant débit ou montant crédit renseignée. Il est donc presque toujours possible d'obtenir des résultats à partir des champs persistants de la base de données cependant cela peut entraîner des paramétrages complexes alors que pour un même résultat un élément dérivé peut exister et être utilisé simplement.

  • Classe société.

Cette zone permet de sélectionner la classe permettant d’insérer les données relatives à la société. Par exemple, en sélectionnant ‘Paramètres société’, il sera possible d’indiquer la raison sociale et l’adresse de la société dans l’en-tête de l’édition.

  • Exécution automatique.

Case à cocher permettant de lancer automatiquement la requête lors de son ouverture lorsqu’elle est affectée à des ‘Jumelles’.

  • Blocage des données.

Cette option permet d’exploiter les données à instant donné sans tenir compte des mises à jour réalisées par les autres utilisateurs.

Aucun : aucun blocage est effectué,
A la demande : lors de l’exécution de la requête un message s’affiche proposant le blocage des données.
Toujours : le blocage est systématique.
  • Ne pas aggéger les données.

Cette option permet d'empêcher l'exécution en mode agréger (multi-sociétés).

  • Ne pas enchainer les données.

Cette option permet d'empêcher l'exécution en mode enchainé (multi-sociétés).

Format d’impression

requeteuretatproprietesformat.png

  • Colonne contenant le format.

Reprend le nom de la colonne de la requête indiquant s’il y a lieu, le format d’impression à utiliser.

  • Colonne contenant le nombre d’exemplaires.

Reprend le nom de la colonne de la requête indiquant le nombre d’exemplaires à imprimer. Ceci permet d’éditer, si nécessaire, par ligne Détail.

Cette option est visible uniquement en impression, non en visualisation.

Pour paramétrer le nombre d’exemplaires de l’édition complète vous devez ouvrir le paramétrage de l’imprimante (Ecran de lancement/Options/Paramétrer l’imprimante).

  • Colonne contenant l’adresse e-mail.

Reprend systématiquement le nom de la colonne de la requête contenant l’adresse e-mail à utiliser pour envoyer les enregistrements automatiquement. La colonne contient :

une seule valeur d’adresse mail, par exemple un champ calculé,

un champ d’une table Intégrale qui contient une adresse e-mail différente pour chaque enregistrement par exemple la zone Adresse électronique de la fiche client.

Dans le cas d’envoi d’e-mail en automatique, un mail est transmis pour chaque ligne détail. L’envoi d’e-mail en automatique est donc recommandé dans le cas de requêtes de type maître-détail. La sous-requête est en effet considérée comme une ligne détail.

Exemple

Vous réalisez une requête maître-détail portant sur des clients dont on voit pour chacun la liste des pièces en cours. L’envoi d’e-mails en automatique adressera pour chaque client la liste des pièces lui correspondant.

  • Nom du fichier d'exportation.

Renseignez le nom du fichier (.pdf) qui contiendra le résultat de la requête.

Dossier Publipostage

requeteuretatproprietespublipostage.png

La fonction Publipostage permet d’intégrer les données extraites par une ou plusieurs requêtes dans un document Word.

Ces fusions sont de deux trois types :

Utilisation du publipostage de Word avec le résultat d’une requête,

Intégration d’une requête dans un document Word ,

Intégration de plusieurs requêtes dans un document Word.

  • Document word modèle.

Saisissez le nom du document modèle ou rechercher-le à l’aide du bouton ci-contre.

Rappel : Un document modèle sert à la mise en forme d’un texte et ne contient pas de données. Il est possible de le modifier afin d’ajuster la présentation selon les besoins. Le Designer d’étatsRequêteur utilise ce document pour y insérer les données, et générer un document final.

  • Document word généré.

Saisissez le nom du document final qui contiendra les données et sera généré lorsque vous lancerez la requête.

  • Utiliser le publipostage de Word.

Lorsque cette case est cochée, vous pouvez utiliser le résultat d’une requête comme source de données dans un document Word .

Lorsqu’elle n’est pas cochée, le document intègre pour chaque requête un tableau vide.

Outils personnels