Ce qui suit est valable pour tous les signalétiques : clients, fournisseurs, articles, 4e signalétique, contacts, comptes généraux, comptes analytiques, immobilisés, prospects, prestataires et emplacements.
MercatorBlazorComponents fournit un composant SigEditor qui permet d'éditer le contenu d'une fiche de signalétique selon un modèle composé sous la forme d'un contenu HTML, sauvegardé dans Mercator desktop.
1. Contenu HTML dans Mercator
Le paramétrage commence donc par la définition de ce contenu HTML qui doit être placé via le menu "Outils / Ecrans Signalétiques / Pelican". Ce code HTML simple permettra d'éditer la fiche d'un client.
<div class="content">
<div class="container">
<div class="row">
<div class="col-sm-12">
<f.InputText @bind-Value="C_NOM" class="form-control" placeholder="Nom" />
</div>
</div>
<div class="row">
<div class="col-sm-12">
<f.InputText @bind-Value="C_ADRESSE" class="form-control" placeholder="Adresse" />
</div>
</div>
<div class="row">
<div class="col-sm-4">
<f.InputText @bind-Value="C_CODEP" class="form-control" placeholder="Code P." />
</div>
<div class="col-sm-8">
<f.InputText @bind-Value="C_VILLE" class="form-control" placeholder="Ville" />
</div>
</div>
<div class="row">
<div class="col-sm-7">
<f.InputText @bind-Value="C_NUM_TVA" class="form-control" placeholder="N° TVA" />
</div>
<div class="col-sm-5 text-center">
<m.Sig.ViesButton />
</div>
</div>
</div>
</div>
Ce composant accepte le code HTML standard
Toutes les balises et tous les attributs HTML sont permis, à condition que le HTML soit bien formé.
- Fermer toutes les balises : chaque <div>, <p>, <label>… doit avoir sa balise de fermeture. Une erreur de structure empêche l'affichage de la fiche et affiche, en rouge, la ligne, la colonne et la cause.
- Classes Bootstrap : class="form-control", class="mb-2", class="row", etc. s'utilisent normalement.
- Entités : &, <, … sont décodées et s'affichent correctement.
- Commentaires : <!-- ... --> est ignoré. On peut s'en servir pour annoter le HTML.
- Pas de code : @ (hors @bind-Value), @if, @foreach ou les événements @onclick ne sont pas interprétés. Ce n'est pas du Razor compilé.
Il accepte aussi les composants Blazor
Une balise dont le nom commence par f. ou m. est remplacée par le composant Blazor du même nom.
- Préfixe f. : Composants de formulaire Blazor (Microsoft.AspNetCore.Components.Forms). Exemple :
<f.InputText ...></f.InputText> - Préfixe m. : Composants MercatorBlazorComponents (MercatorBlazorComponents.Components). Exemple :
<m.InputList ...></m.InputList>
Lier un champ avec @bind-Value
@bind-Value="C_NOM" relie le composant au champ C_NOM de la fiche : la valeur est affichée à l'ouverture et chaque modification est écrite dans la fiche.
- Nom du champ : le nom de la propriété de l'enregistrement, avec la même casse (ex. C_NOM, C_NUM_TVA, F_VILLE, S_MODELE).
- Type : le composant doit correspondre au type du champ. Pour les composants génériques (InputNumber, InputDate, InputSelect), le type est déduit automatiquement du champ.
Ces composants sont utilisables pour ces types de champs :
- f.InputText : Texte
- f.InputTextArea : Texte sur plusieurs lignes
- f.InputNumber : Nombre (entier ou décimal)
- f.InputDate : Date
- f.InputCheckbox : Booléen
- f.InputSelect : Valeur choisie dans une liste fixe
- m.InputList : Texte choisi dans une liste (fenêtre adaptée au tactile)
m.InputList affiche la valeur choisie et ouvre une fenêtre de choix ; ses éléments sont donnés en JSON dans l'attribut Items, avec ² à la place de chaque guillemet.
<m.InputList @bind-Value="C_LANGUE" Title="Choisir la langue"
Items="[{²Id²:²FR²,²Text²:²Français²},{²Id²:²NL²,²Text²:²Nederlands²},{²Id²:²EN²,²Text²:²English²}]">
</m.InputList> Cette liste reconnaît ces attributs :
- @bind-Value : Champ texte de la fiche qui reçoit l'Id choisi
- Items : Liste des choix : Id = valeur enregistrée, Text = libellé affiché
- Title : Titre de la fenêtre de choix (obligatoire)
- Disabled : Disabled ou Disabled="true" : liste en lecture seule
- Style : Style CSS du contrôle (par défaut width: 100%)
💡 Pourquoi ² ? Un guillemet " fermerait l'attribut HTML. Le ² est remplacé par " avant la lecture du JSON.
Focus à l'ouverture
Dans l'éditeur de fiches, le curseur se place dans le premier champ visible et modifiable. Pour en choisir un autre, ajouter autofocus sur ce champ :
<f.InputText @bind-Value="C_NOM" class="form-control" autofocus />
Bouton VIES
<m.Sig.ViesButton /> vérifie le n° de TVA de la fiche auprès de VIES et en reprend les coordonnées.
- Champ requis : la fiche doit avoir un champ n° de TVA (C_NUM_TVA pour un client, F_NUM_TVA pour un fournisseur…), normalement présent dans le HTML.
- N° vide : le curseur est placé dans le champ n° de TVA, sans autre message.
- N° incorrect ou inconnu de VIES : un message d'erreur s'affiche et la fiche n'est pas modifiée. Un n° corrigé par le contrôle (format) est réécrit dans la fiche.
- N° trouvé : si un nom est déjà encodé, une confirmation est demandée. Le nom, l'adresse, l'adresse 2, le code postal et la ville sont remplis, puis tronqués à la longueur des champs.
- Libellé : par défaut « Import VIES », dans la langue de l'utilisateur. Text="Vérifier la TVA" le remplace (le même texte dans toutes les langues).
- Ce bouton ne soumet pas la fiche : l'enregistrement reste à faire comme d'habitude.
2. Programmation Blazor
Le composant s'utilise comme ceci :
<MercatorBlazorComponents.Components.Sig.SigEditor SigEditor @ref="sigEditor" SigModule="@TargetSig" IdSig="" />
IdSig peut contenir :
- Une chaîne de caractères vide pour créer une nouvelle fiche,
- L'identifiant d'une fiche existante pour la modifier.
SigModule est de type MercatorUi.Sig._SigEnum.
sigEditor.DrContext contient la DataRow en cours d'édition. De même, sigEditor.Context contient MercatorDatabase.CLI, MercatorDatabase.FOU, ...
sigEditor.SaveAsync permet d'effectuer la sauvegarde. Cette méthode renvoie l'identifiant de la fiche sauvegardée ou null en cas d'erreur.
💡 Lors de la création d'une nouvelle fiche, les valeurs par défaut définies dans Mercator desktop sont bien appliquées. Les options de dédoublonnement sont aussi prises en compte, de la même manière que dans Mercator desktop.
👉 Cet éditeur est intégré dans AskTargetSigAsync si le paramètre newRecordAllowed vaut true. A cet endroit, la sauvegarde de la nouvelle fiche est directement prise en charge par le composant.