Rapports préparés

Un rapport préparé s'exécute en arrière-plan. Vous consultez le résultat quand le calcul est terminé, sans bloquer votre navigateur. Ce mode convient aux rapports lents.

Fonctionnement

Quand l'option Rapport préparé est cochée sur un rapport :

1. Vous ouvrez le rapport et choisissez les filtres.
2. Vous cliquez sur Générer un nouveau rapport.
3. La demande passe au statut « En file d'attente », puis s'exécute en arrière-plan.
4. À la fin, le rapport affiche le résultat avec le message « Ce rapport a été préparé… » et la date de calcul.

Chaque calcul est enregistré dans un document Rapport préparé (Prepared Report) avec son statut, ses filtres et l'heure de fin. Ces documents sont supprimés après 14 jours par défaut. Changez cette durée dans Paramètres des journaux.

Activation automatique

Un rapport de script peut passer seul en mode préparé. Si une exécution dure plus de 15 secondes, Dodock coche Rapport préparé sur ce rapport. L'exécution en cours continue jusqu'à la fin et affiche son résultat. Les exécutions suivantes se font en arrière-plan.

      
sequenceDiagram
    participant U as Utilisateur
    participant D as Dodock
    U->>D: Lance le rapport
    D->>D: Exécute le script
    alt Durée > 15 secondes
        D->>D: Coche « Rapport préparé » sur le rapport
        D-->>U: Affiche le résultat de cette exécution
        Note over U,D: Les exécutions suivantes passent en arrière-plan
    else Durée ≤ 15 secondes
        D-->>U: Affiche le résultat
    end

    

Désactiver l'activation automatique

Certains rapports doivent toujours s'exécuter en direct. Pour eux, cochez Désactiver l'automatisation des rapports préparés. Ce champ apparaît seulement pour un rapport de type « Rapport de Script ».

1. Ouvrez la liste Rapport avec la recherche (Ctrl+K).
2. Ouvrez le rapport concerné.
3. Cochez Désactiver l'automatisation des rapports préparés.
4. Enregistrez.

Le rapport ne passe plus seul en mode préparé, quelle que soit sa durée. Si Rapport préparé est déjà coché, décochez-le aussi.

Configurer par code

Dans le fichier JSON d'un rapport standard, ajoutez :

{
  "disable_prepared_report_automation": 1
}

Ou dans un patch Python :

frappe.db.set_value("Report", "Nom du rapport", "disable_prepared_report_automation", 1)

L'ancien champ disable_prepared_report n'existe plus. Un patch de migration a reporté sa valeur : il a coché disable_prepared_report_automation et décoché prepared_report sur les rapports concernés.

Choisir le bon réglage