U bevindt zich nu op een technische pagina over de software Mercator. Deze pagina bevat specifieke informatie die bestemd is voor professionals van de software Mercator. Wenst u naar algemenere informatie over Mercator door te gaan?


   Deze vraag niet meer stellen

Principes voor de verbinding van een ASP.net-applicatie met Mercator Majuro

0000002091     -      25-10-2017

Voor de creatie van een ASP.net-applicatie (website) die gelinkt is aan Mercator Majuro is geen enkele bijkomende procedure meer vereist (MercatorIshop.exe, MercatorIshopAspx.dll, ...). Mercator Majuro is nu immers voor 100 % .net, en de componenten ervan kunnen rechtstreeks worden gebruikt.

Hierna volgt een overzicht van de elementen waarmee u rekening moet houden:

  • De applicatie is gelinkt aan een Mercator Majuro. De site moet dus minstens Framework 4.0 gebruiken (de poolapplicatie die op IIS zal worden gebruikt, moet dus ook gelinkt zijn aan Framework 4.0).

  • Op de website moet een verwijzing naar MercatorTunnel.dll en MercatorUi.dll worden toegevoegd (gecompileerde versie voor Framework 4). Deze DLL-bestanden vindt u in de hoofddirectory van Mercator Majuro.

  • In de broncodes van de website
    • moet u een statische verwijzing toevoegen naar een proces van MercatorUi.Main. Wanneer deze klasse wordt opgeroepen, zal ze de volledige omgeving laden bestaande uit gegevens en objecten die nodig zijn voor de goede werking van MercatorUi.dll in "Majuro"-modus (bv. in App_code\Globals.cs).
Zoom
public static MercatorUi.Main main = null;
    • Vervolgens moet u GLOBAL.ASAX gebruiken. Daarbij gaat het om het "ASP.NET application file" waarmee de event in de applicatie of de sessies kunnen worden beheerd (om er een toe te voegen, moet u rechtsklikken op de root van de site en dit component toevoegen). Bij het opstarten van de ASP.net-site zal de klasse MercatorUi.Main worden opgeroepen, en bij het sluiten van de ASP.net-applicatie zal ze correct worden vrijgegeven.
void Application_Start(object sender, EventArgs e)
{
    Globals.main = new MercatorUi.Main(@"\\192.168.2.130\disque partage\Mercator_Majuro", null, "Guy", "guy");
}

void Application_End(object sender, EventArgs e)
{
    if (Globals.main != null)
    {
        Globals.main.Dispose();
        Globals.main = null;
    }
}

Als u MerctorReporting wilt gebruiken moet u een referentie naar deze assembly bijvoegen en initialiseren als volgt (in Application _start)

Divers.main.InitReporting(MercatorApi.Api.AddBS(AppDomain.CurrentDomain.BaseDirectory) + "bin\\MercatorReporting.dll");

Vanaf dat ogenblik is het mogelijk om alle elementen van MercatorUi.dll die overeenstemmen met functionaliteiten van Mercator die geen gebruikersinterface vereisen, te gebruiken. Zo zal het bijvoorbeeld eenvoudig zijn om de volgende elementen te gebruiken:

    • MercatorUi.Engine.Cpta.BookingEngine om een boekhoudkundig document te creëren
    • MercatorUi.Engine.Crm.ActionEngine om een actie in de CRM-module te creëren
    • MercatorUi.Engine.Gescom.BillingEngine om een verkoop of aankoop document in het commerciële beheer te creëren
    • MercatorUi.Engine.Gescom.TransferEngine om een transfer tussen depots te creëren
    • MercatorUi.Engine.Gescom.InventoryEngine om een inventaris te creëren

Zie ook deze pagina, waar in detail wordt beschreven hoe u de resources van Mercator Majuro kunt gebruiken vanuit een externe .net-applicatie.