Rapport
Rapport
Un Rapport présente des données sous forme de tableau, avec des filtres, des colonnes et souvent un graphique. Chaque rapport est un document du type Rapport. Il est rattaché à un type de document de référence (Doctype de Réf.), qui sert aussi à contrôler qui peut l'ouvrir.
Les quatre types de rapport
| Type de Rapport | Qui le crée | Ce qu'il contient |
|---|---|---|
| Éditeur de Rapports | Un utilisateur, depuis la vue rapport d'une liste. | Les colonnes, filtres, tris et regroupements choisis à l'écran, enregistrés en JSON. |
| Rapport de Requête | Un administrateur. | Une requête SQL (SELECT) dans le champ Requête. |
| Rapport de Script | Un développeur ou un administrateur. | Un script Python qui calcule les colonnes et les lignes. Les rapports standard des applications sont de ce type. |
| Rapport personnalisé | Un utilisateur, depuis un rapport de script existant. | Les réglages d'affichage d'un Rapport de référence (colonnes, filtres). |
Un rapport dont Est un formulaire standard vaut « Yes » appartient à une application. Il ne se modifie qu'en mode développeur. Un rapport créé sur le site vaut « No ».
Options courantes
| Champ | Rôle |
|---|---|
| Ajouter une Ligne Totale | Ajoute une ligne de totaux en bas du tableau (pas pour l'éditeur de rapports). |
| Rapport préparé | Calcule le rapport en arrière-plan et garde le résultat. Voir Rapports préparés. |
| Rôles | Rôles qui peuvent ouvrir le rapport. Vide : tous les rôles. |
| Désactivé | Masque le rapport. |
| Format d'impression par défaut, En-tête par défaut | Format et en-tête présélectionnés dans l'aperçu d'impression. Voir Imprimer un rapport. Pour un rapport standard, voir Définir les valeurs d'impression d'un rapport standard. |
| URL de la documentation | Lien d'aide affiché dans le rapport. Voir Lier une documentation à un rapport. |
Qui peut ouvrir un rapport
Un utilisateur doit avoir un des Rôles du rapport, si la table est remplie. Il doit aussi avoir le droit Rapport sur le Doctype de Réf.. Pour changer les rôles sans modifier le rapport, utilisez Autorisation de rôle pour la page et le rapport.
Définir les valeurs d'impression d'un rapport standard
Un rapport standard, comme le Grand livre, s'ouvre en lecture seule hors du mode développeur : vous ne pouvez pas modifier ses champs Format d'impression par défaut et En-tête par défaut dans le formulaire. Un bouton dédié permet de définir ces deux valeurs sans dupliquer le rapport. Il ne modifie aucun autre champ.
Prérequis
- Le rapport est standard (Est un formulaire standard vaut « Oui »).
- Le mode développeur est désactivé. En mode développeur, le bouton n'est pas affiché : le formulaire est modifiable directement.
- Vous avez le droit d'écriture sur le type de document Rapport. Sans ce droit, le bouton n'apparaît pas, et Dodock refuse l'enregistrement avec le message « Vous n'êtes pas autorisé à éditer le rapport. »
- Le format d'impression à choisir existe déjà : un Format d'impression dont Format d'impression pour vaut Rapport, rattaché à ce rapport et non désactivé. Voir Format d'impression de rapport.
- L'en-tête à choisir existe déjà : un En-tête de lettre dont En-tête de lettre pour vaut Rapport, non désactivé. Il n'a pas besoin d'être standard.
Étapes
- Ouvrez la recherche (Ctrl+K), saisissez « Rapport », puis ouvrez le rapport standard concerné.
- Cliquez sur Set Print Defaults (libellé non traduit) en haut du formulaire.
- Dans la fenêtre qui s'ouvre, choisissez le Format d'impression par défaut. La liste ne propose que les formats d'impression de ce rapport.
- Choisissez l'En-tête par défaut. La liste ne propose que les en-têtes destinés aux rapports.
- Cliquez sur Enregistrer.
Le formulaire se recharge avec les nouvelles valeurs. Elles sont présélectionnées à l'impression du rapport.
Pour retirer une valeur, ouvrez de nouveau la fenêtre, videz le champ concerné, puis enregistrez. Si vous choisissez un format qui n'est pas valide pour ce rapport, Dodock affiche « Le format d'impression sélectionné n'est pas valide pour ce rapport. » et n'enregistre rien.
Mises à jour de l'application
Les valeurs définies avec ce bouton sont conservées quand une application met à jour le rapport (par exemple à la migration), y compris une valeur que vous avez vidée. Tant que vous n'avez pas utilisé le bouton sur un rapport, celui-ci reçoit les valeurs par défaut livrées par l'application.
Exemple fictif. Votre société imprime le Grand livre avec son propre en-tête. Vous avez créé le format d'impression « Grand livre - direction » pour le rapport General Ledger et l'en-tête « Comptabilité » destiné aux rapports. Vous ouvrez le rapport General Ledger, cliquez sur Set Print Defaults (libellé non traduit), choisissez ces deux valeurs et enregistrez. À la prochaine mise à jour de Dokos, le rapport garde votre format et votre en-tête.
Exemple
Exemple fictif. Dans la liste des factures de vente, vous passez en vue rapport, ajoutez les colonnes Client et Total HT, puis groupez par client. Vous enregistrez le résultat sous le nom « CA par client ». Dokos crée un Rapport du type Éditeur de Rapports, avec la Facture de vente comme Doctype de Réf.