DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Tableau croisé dynamique
  • Mode de calcul
  • Quand utiliser la fonction TCDCalculeMiseAJourAsynchrone ?
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Met à jour (sans blocage) une partie des données d'un champ Tableau croisé dynamique à partir d'une date.
Remarques :
  • Le contenu du champ Tableau croisé dynamique doit avoir préalablement été chargé en mémoire par la fonction TCDCharge.
  • Le champ Tableau dynamique doit posséder une colonne, une ligne ou un filtre d'affichage de type date.
Exemple
TCDCalculeMiseAJourAsynchrone(TCD_Statistiques, Calcul_terminé)
PROCÉDURE INTERNE Calcul_terminé(bOK est booléen)
SI PAS bOK ALORS
Erreur(ErreurInfo())
RETOUR
FIN
FIN
Syntaxe
TCDCalculeMiseAJourAsynchrone(<Champ Tableau croisé dynamique> [, <Date de départ>] [, <Procédure WLangage>])
<Champ Tableau croisé dynamique> : Nom de champ
Nom du champ Tableau croisé dynamique à manipuler.
<Date de départ> : Chaîne de caractères ou variable de type Date optionnelle
Date à partir de laquelle le re-calcul du contenu du champ Tableau croisé dynamique doit être effectué. Cette date doit être au format "AAAAMMJJ". Tous les enregistrements associés à une rubrique de type Date dont le contenu correspond à une date supérieure à la <Date de départ> seront pris en compte.
Si ce paramètre n'est pas spécifié, la date prise en compte correspond à la date maximale du dernier résultat calculé ou lu par la fonction TCDCharge.
<Procédure WLangage> : Nom de procédure optionnel
Nom de la procédure WLangage ("callback") appelée à la fin du calcul.
Pour plus de détails sur cette procédure, consultez Paramètres de la procédure utilisée par la fonction TCDCalculeMiseAJourAsynchrone.
Remarques

Mode de calcul

Les enregistrements pris en compte pour le recalcul ont les caractéristiques suivantes :
  • Les enregistrements possèdent une rubrique de type Date.
  • Le contenu de la rubrique de type date est supérieur ou égal à la valeur du paramètre <Date de départ>.
Les anciennes valeurs présentes dans le champ Tableau croisé dynamique (s'il y en a) sont supprimées du champ Tableau croisé dynamique à partir de <Date de départ>.
Le calcul peut être assez long si beaucoup de données doivent être lues. La fonction TCDCalculeMiseAJourAsynchrone ne bloque pas l'application et exécute la procédure WLangage spécifiée lorsque le calcul est terminé.
A la fin du calcul, le nouveau contenu du champ Tableau croisé dynamique est affiché. Le résultat obtenu peut ensuite être sauvé par la fonction TCDSauve.

Quand utiliser la fonction TCDCalculeMiseAJourAsynchrone ?

La fonction TCDCalculeMiseAJourAsynchrone doit être utilisée lorsque les données sont figées : par exemple des factures. Il est possible uniquement d'ajouter de nouvelles factures. Dans ce cas, la date de re-calcul correspond à la date de dernière sauvegarde du contenu du champ Tableau croisé dynamique.
Si les données affichées dans le champ Tableau croisé dynamique peuvent être modifiées (par exemple modification d'une quantité, d'un prix, ...), il est nécessaire :
  • soit de recalculer entièrement le contenu du champ Tableau croisé dynamique.
  • soit de recalculer le contenu du champ Tableau croisé dynamique à partir de la date correspondant à l'enregistrement modifié.
Version minimum requise
  • Version 2024
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/03/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale