En tant que tels, les différents moteurs de Mercator ne sont pas sérialisables et ne peuvent dès lors pas être sauvegardés directement dans des variables de session ASP.net. (Ceci se justifie par la complexité de la structure de ces classes ainsi que le mécanisme d'instanciation par désérialisation qui serait inadapté)
Quand Mercator est instancié pour une utilisation à partir d'une application externe, comme c'est le cas lorsque Mercator est lié à un site ASP.net, la classe statique MercatorUi.Globals contient un dictionnaire permettant de retrouver tous les engines ouverts (en cours d'utilisation) : EnginesUsedByExtApp défini comme suit : System.Collections.Concurrent.ConcurrentDictionary<string, MercatorUi.Interfaces.IEngine> (ConcurrentDictionary est thread-safe, ce qui est nécessaire pour une application ASP.net qui est multi-thread)
Cela concerne ces différents moteurs :
- MercatorUi.Engine.Cpta.BookingEngine
- MercatorUi.Engine.Crm.ActionEngine
- MercatorUi.Engine.Gescom.BillingEngine
- MercatorUi.Engine.Gescom.TransferEngine
- MercatorUi.Engine.Gescom.InventoryEngine
Lorsqu'un de ces moteurs est initialisé à partir d'une application externe,
Dès lors, il suffit de sauvegarder cette clé unique dans une variable de session. Le dictionnaire sera ensuite utilisé pour retrouver l'engine sur base de cette clé.
Exemple :
1. Lors de l'initialisation du billingEngine (caddie) pour une internaute (session) :
MercatorUi.Engine.Gescom.BillingEngine billingEngine = MercatorUi.Engine.Gescom.BillingEngine.InitNew(MercatorUi.Engine.Gescom.Billing.TypeVAEnum.V, 3, "Comm");
if (billingEngine.DataSet != null)
{
Session["CurrentEngineKey"] = billingEngine.UniqueIdForExtApp;
}
Attention : ici il ne faut pas utiliser la notation avec using, ce qui appelerait la méthode Dispose de ce BillingEngine et le retirerait de EnginesUsedByExtApp.
2. Sur une autre page, pour reprendre ce billingEngine et pouvoir l'utiliser :
MercatorUi.Interfaces.IEngine engine;
if ((Session["CurrentEngineKey"] != null) && MercatorUi.Globals.EnginesUsedByExtApp.TryGetValue(Session["CurrentEngineKey"].ToString(), out engine))
{
MercatorUi.Engine.Gescom.BillingEngine billingEngine = (MercatorUi.Engine.Gescom.BillingEngine)engine;
...
}
3. Lorsque l'utilisateur se déconnecte du site, lorsque le billingEngine n'est plus nécessaire ou après l'appel de la méthode Save :
MercatorUi.Interfaces.IEngine engine;
if ((Session["CurrentEngineKey"] != null) && MercatorUi.Globals.EnginesUsedByExtApp.TryGetValue(Session["CurrentEngineKey"].ToString(), out engine))
{
MercatorUi.Engine.Gescom.BillingEngine billingEngine = (MercatorUi.Engine.Gescom.BillingEngine)engine;
billingEngine.Dispose();
Session.Remove("CurrentEngineKey");
}
L'appel de la méthode Dispose est absolument nécessaire pour fermer le BillingEngine (Close) et le retirer de EnginesUsedByExtApp. Si cet appel n'est pas effectué correctement, votre application ASP.net risque de rencontrer des problèmes de mémoire.
Remarques :
Etant donné que l'information sauvegardée est de taille très réduite (un simple chaîne de caractères), elle peut être stockée dans le ViewState plutôt que dans les variables de sessions. Cela permet de gérer facilement le cas où un internaute ouvre plusieurs onglets dans son explorateur Internet mais que cela correspond à des comptes clients, et donc des BillingEngines, distincts.
Session["CurrentEngineKey"]
devient
ViewState["CurrentEngineKey"]
Les ressources évoquées ici ne sont disponibles que dans la version de MercatorUi.dll compilée compilée pour le Framework .net 4.0. (Les ConcurrentDictionaries n'existent pas dans les versions antérieures)