Vous consultez une page technique concernant le logiciel de gestion Mercator. Celle-ci contient des informations spécifiques destinées aux professionnels de Mercator. Souhaitez-vous être redirigés vers des informations plus générales ?


   Ne plus poser cette question

Interface MercatorUi.ICustomizers.IStringUpdater

0000001916     -      02/02/2016

Cette interface permet de manipuler des chaînes de caractères générées par Mercator et de les modifier avant que Mercator n'en fasse usage.

Sa définition est celle-ci :

Zoom
public interface IStringUpdater
{
     string StringUpdate( string StringToModify);
}

La méthode StringUpdate reçoit en paramètre la chaîne de caractères à modifier et renvoie la chaîne éventuellement modifiée.

Ce processus s'applique essentiellement aux requêtes SQL que Mercator génère avant de les soumettre au serveur SQL. Il convient d'être prudent avec la manipulation de cet outil. En effet, une modification de requête non avisée peut produire des résultats inattendus ou empêcher le bon fonctionnement de Mercator.
Nous insistons ici sur le fait que Mercator n'apporte aucun contrôle par rapport aux modifications qui lui sont imposées par ce biais.

Elle est implémentable dans les customizers suivants :

  • AskDossiers : requête SQL
  • HistCli : requête SQL de l'historique clients du menu "Fenêtres"
  • HistFou : requête SQL de l'historique fournisseurs du menu "Fenêtres"
  • HistProd : requête SQL de l'historique production du menu "Fenêtres"
  • HistCpta : requête SQL de l'historique comptabilité du menu "Fenêtres"
  • HistSer : requête SQL de l'historique n° de série du menu "Fenêtres"
  • HistRef : requête SQL de l'historique références du menu "Fenêtres"
  • HistTransf : requête SQL de l'historique des transferts de dépôt du menu "Fenêtres"
  • HistActions : requête SQL de l'historique des actions du CRM (par le menu correspondant au signalétique en cours)
  • BrowseCli, BrowseStock, BrowseFou, ... : liste de parcours et de recherche des fiches de signalétiques à partir d'un signalétique
  • SigCli, SigFou, SigStock, ... : toutes les grilles (autres que les grilles "user defined" dans les écrans de signalétique
  • Param : requête SQL de lecture des données dans toutes les fenêtres de paramètres (MercatorUi.Forms.Param...) hormis
    • ParamCodaModesForm
    • ParamIdentifForm
    • ParamIsArubaForm
    • ParamLotsFormulasForm
    • ParamOptionsForm
    • ParamRisForm
  • Gescom : requêtes liées aux fonctionnalités de la gestion commerciale autres que dans le BillingEngine et la BillingForm
  • Intrastat : requête de génération de la déclaration
  • Dans les customizers de reporting

Concernant les grilles de signalétiques

Si le customizer associé au signalétique en cours implémente l'interface IStringUpdater, toutes les requêtes SQL de toutes les grilles de signalétiques (hormis les grilles dont la requête est fixée par l'utilisateur), sont passées par StringUpdate. Afin de limiter la modification à une requête particulière (par exemple, uniquement l'historique clients), il faut lire l'ID de la requête qui est passé en commentaire dans le code SQL. Cet ID peut être obtenu et utilisé de cette façon :

Zoom
public string StringUpdate( string StringToModify)

    string id = Api .StrExtract(StringToModify, "/*<ID>" , "</ID>*/" ); 
    if (id == "HISTORY_CLI" )
    {
        StringToModify = ...
    } 
    else if (id == "TARCLI" )
    {
        StringToModify = ...
    } 
    return StringToModify;
}

Exemples :