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

Overwegingen bij het opzetten van dialoogvensters via code

0000003483     -      18-11-2026

Net als Mercator desktop stelt MercatorPelican ontwikkelaars verschillende dialoogvensters ter beschikking: "Ja-Nee", "OK-Annuleren", invoer van een of twee tekenreeksen, selectie van een vertegenwoordiger, … De omgeving van MercatorPelican (Blazor Hybrid) is echter erg verschillend van die van Mercator Desktop (WinForms). Bijgevolg kunnen de dialoogvensters van MercatorUi.Dialogs niet gebruikt worden. Blazor steunt hoofdzakelijk op asynchrone programmering, terwijl in WinForms de dialoogvensters gewoon de thread van de gebruikersinterface blokkeren. Bovendien worden de dialoogvensters van MercatorUi.Dialogs opgeroepen via statische methoden, terwijl Blazor altijd afhangt van een lokale context. (In de modus "web" host dezelfde AppDomain de interface van meerdere gelijktijdige gebruikers). Het bijzondere geval van de code in customizers van Mercator werd echter in aanmerking genomen door het ontwikkelteam, zodat de code van deze customizers ongewijzigd kan blijven.

Programmeren van dialoogvensters in een ToolKit 

De dialoogvensters van Mercator kunnen opgeroepen worden via de async-methoden van de BlazorDialogsHelper.  Die is gekoppeld aan de MainLayout, die de hierboven vermelde lokale context levert.

Enkele codevoorbeelden:

Zoom
if (await CascadingParameters.MainLayout.BlazorDialogsHelper.AnswerYesNoAsync(Api.Iif_langue(CascadingParameters.Langue, IifLangueEnum.SaveChanges)))
{

Zoom
string newCustId = await CascadingParameters.MainLayout.BlazorDialogsHelper.AskTargetSigAsync(Api.Iif_langue(CascadingParameters.Langue, "Which customer ?", "Welke klant ?", "Quel client ?"), MercatorUi.Sig._SigEnum.CLI, null);
			

 

De beschikbare methoden zijn die van deze interface, beschikbaar in MercatorUi.Dialogs:

Zoom
public interface IBlazorDialogsHelper
{
    Task StopAsync(string message);
    Task<bool> AnswerYesNoAsync(string message);
    Task<bool> AnswerOkCancelAsync(string message);
    Task<int> AnswerYesNoCancelAsync(string message);
    Task<int> Answer3ButtonsAsync(string message, string button1, string button2, string button3);
    Task<double?> AskDoubleAsync(string message, double defaultValue, string mask, double minValue = double.MinValue, double maxValue = double.MaxValue, bool withTouchKeyBoard = false);
    Task<string> AskStringAsync(string message, string defaultValue, bool upperCase = false, int maxLength = int.MaxValue, bool nullIfCancel = false, bool isPassword = false, bool isEmail = false);
    Task<string[]> AskStringsAsync(string message, string defaultValue1, string defaultValue2, bool upperCase = false, int maxLength = 0);
    Task<double[]> AskDoublesAsync(string message, double defaultValue1, double defaultValue2, string mask, double minValue = double.MinValue, double maxValue = double.MaxValue);
    Task<string> AskMemoAsync(string message, string defaultValue, bool hideCancelButton = false, bool allowReadWriteWhenCancelButtonHidden = false);
    Task<DateTime?> AskDateTimeAsync(string message, DateTime defaultValue, bool withTime = false);
    Task<string> AskTargetSigAsync(string message, Sig._SigEnum module, string targetFilter = null);
    Task<_Dialogs.DialogAskComboRet> AskUserAsync(string message, bool withAll = false, string defaultValue = null);
    Task<_Dialogs.DialogAskComboRet> AskDepotAsync(string message, string defaultId = null, bool withAll = false, bool withAllActive = false);
    Task<_Dialogs.DialogAskComboRet[]> AskUsersAsync(string message, bool withAll = false, string defaultValue1 = null, string defaultValue2 = null);
    Task<_Dialogs.DialogAskComboRet[]> AskDepotsAsync(string message, string defaultId1 = null, string defaultId2 = null, bool withAll = false);
    Task<_Dialogs.DialogAskComboRet[]> AskDepotMplaceAsync(string message, string defaultIdDepot, string defaultIdMplace = null, bool disableDepot = false, string reqSqlMplace = null);
    Task<_Dialogs.DialogAskComboRet[]> AskRepsAsync(string message, bool withAll = false);
    Task<_Dialogs.DialogAskComboRet[]> AskExercicesAsync(string message);
    Task<_Dialogs.DialogAskComboRet> AskRepAsync(string message, bool withAll = false);
    Task<_Dialogs.DialogAskPieceRet> AskPieceAsync(string message, _Dialogs.AskPieceEnum typeDoc, int[] types, int defaultType, bool allowTypeChange = true, bool hidePiece = false, string whereSequenc = null, bool withOriginals = false);
    Task<_Dialogs.DialogAskComboRet> AskComboAsync(string message, List<(string id, string lib)> items, string defaultId = null, int width = 0);
    Task<_Dialogs.DialogAskComboRet> AskExerciceAsync(string message, byte defaultExercice = 0);
    Task<MercatorApi.ApiLangues?> AskLangueAsync(string message);
    Task<(int tiroir, string lib)?> AskTirAsync(bool withAll = false, bool withTiroirsLib = false); // null = geen lade gevonden of fout / lade -1 = geannuleerd / -9 = Alle (som) / -8 = Alle (details)
}

 

Programmeren van dialoogvensters in de customizers

Opdat de code van een customizer identiek kan zijn voor Mercator desktop en MercatorPelican, moet een specifiek mechanisme opgezet worden rond alle oproepen van methoden van de engines van Mercator die aangepaste code kunnen oproepen, die op zijn beurt code kan bevatten die dialoogvensters toont.

Zoom
bool isSaved = false;
await CascadingParameters.MainLayout.ExecuteInMercatorAsync(() => isSaved = currentBillingEngine.Save());
if (!isSaved)
{
    error = string.IsNullOrEmpty(currentBillingEngine.LastError) ? Api.Iif_langue(CascadingParameters.Langue, "Der Verkauf konnte nicht gespeichert werden.", "Unable to save the sale.", "Verkoop kan niet worden opgeslagen.", "Impossible d'enregistrer la vente.") : currentBillingEngine.LastError;
    return;
}

De methode ExecuteInMercatorAsync creëert een lokale context en laat toe om een synchrone methode uit te voeren vanuit een asynchrone context.

Zodra een oproep van een methode van een engine van Mercator (hier BillingEngine.Save) op deze manier "omkaderd" is, worden de dialoogvensters van MercatorUi.Dialogs gewoon bruikbaar.

💡 In de standaard-ToolKits die door Mercator geleverd worden, wordt dit principe altijd toegepast.

Hieronder een voorbeeld van een customizer die perfect zal werken in Mercator desktop en in MercatorPelican, als met de hier vermelde voorzorgsmaatregel rekening gehouden wordt.

Zoom
namespace Billing
{
    public class Customizer : MercatorUi.ICustomizers.IBillingEngineCreated, MercatorUi.ICustomizers.IBillingEngineClosed
    {

        public void BillingEngineCreated(MercatorUi.Engine.Gescom.BillingEngine billingEngine)
        {
            billingEngine.BeforeBeforePaymentOrSave += billingEngine_BeforeBeforePaymentOrSave;
        }

        public void BillingEngineClosed(MercatorUi.Engine.Gescom.BillingEngine billingEngine)
        {
            billingEngine.BeforeBeforePaymentOrSave -= billingEngine_BeforeBeforePaymentOrSave;
        }

        void billingEngine_BeforeBeforePaymentOrSave(object sender, MercatorUi.Engine.Gescom.BillingEngine.BeforeBeforePaymentOrSaveEventArgs e)
        {
            MercatorUi.Engine.Gescom.BillingEngine billingEngine = (MercatorUi.Engine.Gescom.BillingEngine)sender;
            if (!billingEngine.LignesVRecords.Any(l => l.ID_ARTICLE == "PORT"))
            {
                int n = MercatorUi.Dialogs.AnswerYesNoCancel("Wilt u verzendkosten toevoegen?");
                if (n == 3) // Cancel
                {
                    e.Cancel = true;
                    return;
                }
                if (n == 1) // Yes
                {
                    double port = MercatorUi.Dialogs.AskDouble("Bedrag verzendkosten?", 10, "### ##0.00", true);
                    if (port == double.MinValue) // Cancel 
                    {
                        e.Cancel = true;
                        return;
                    }
                    int nLigne = billingEngine.AppendLine();
                    if (!billingEngine.InsertItem("PORT", billingEngine.LIGNES.Rows[nLigne], 1))
                    {
                        MercatorUi.Dialogs.Stop("Kan de verzendkosten niet toevoegen. " + billingEngine.LastError);
                        e.Cancel = true;
                        return;
                    }
                    billingEngine.LignesVRecords[nLigne].PU = port;
                    billingEngine.UpdateAmounts();
                }
            }
        }
    }
}

⚠️ Als in MercatorPelican op Windows toch een WinForms-dialoogvenster getoond wordt, moet men ervan uitgaan dat het Blazor-equivalent ervan niet bestaat. Dit dialoogvenster kan dan niet gebruikt worden. Het zal niet correct weergegeven worden op Windows en veroorzaakt een exception op de andere platformen.



Functionele cookies: Cookies die nodig zijn voor het gebruik van de website en voorkeurscookies. Ze bevatten geen persoonsgegevens. (Meer informatie)

Analytische cookies: Verzamelen van statistieken met betrekking tot het gedrag van internetgebruikers. (Meer informatie)

Marketingcookies: Om bezoekers op verschillende websites te volgen voor advertentiedoeleinden. (Meer informatie)