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

Enregistrer une signature manuscrite dans un document de la gestion commerciale

0000002385     -      25/07/2018

L'objet de cette page est de montrer comment, avec Mercator Majuro, établir un document de la gestion commerciale sur une tablette, et demander au client de signer ce document en appliquant sa signature "manuscrite" directement dans Mercator à l'aide du stylet de la tablette. Cela est rendu possible avec le customizer Billing qui se trouve dans le projet ci-joint. Celui-ci implémente un évènement BeforeSave, qui permet d'afficher cette boîte de dialogue :

La signature est ensuite sauvegardée dans la base de données (dans l'enregistrement de PIEDS_V). Cet enregistrement est effectué sous forme cryptée. Par la suite, si le document est rouvert, il le sera toujours en mode "read-only" et la signature pourra être visible via un simple composant "image".

 

Les précautions prises par cette programmation sont les suivantes :

  • dans la séquence, le bouton "Enregister sans fermer" est désactivé. Cela permet d'éviter des situations inattendues où le document est signé et ensuite modifié, avant une seconde validation
  • une fois signé, le document est ouvrable en mode "read-only"
  • la signature est stockée sous forme d'image dans la base de données SQL, mais sous forme cryptée. Ce cryptage est effectué selon une clé composée avec des éléments propres au document signés (donc cette clé change pour chaque document)
  • l'image est "taguée" avec la date et l'heure, afin d'empêcher une réutilisation ultérieure de la signature

Mercator fournit cette programmation telle quelle et ne se prononce, ni sur la validité juridique d'une telle signature, ni sur les conséquences légales du stockage d'une telle information. Ces points doivent être vérifiés avant mise en place.

Dans le code source, il est essentiel de modifier la logique de la méthode getSecurityKey, qui détermine la clé de cryptage. Il faut de fait personnaliser cet algorithme pour chaque dossier. La seule contrainte est de générer une chaîne de 24 caractères.


Pour installer cette fonctionnalité :

  • placer SignDoc.dll dans Gestion / Fichiers SQL / Assemblies
  • exécuter une seule fois ce script SQL :
        alter table PIEDS_V add SIGN_IMG image null
        alter table PIEDS_V add SIGN_NOM char(25) not null default ''
  • redémarrer Mercator
  • dans la séquence concernée, ajouter le customizer fourni ci-dessous (BillingVen_GestionSignature)
  • via le menu "Gestion / Fichiers SQL / Assemblies", ajouter les fichiers SignDoc.dll et SignDoc.pdb
  • éventuellement, dans le paramétrage d'écran de la séquence, ajouter
    • une image dont la source est SIGN_IMG
    • une textbox dont la source est SIGN_NOM
  • si on souhaite reprendre cette signature dans un document imprimé ou dans un PDF, il suffit de modifier le modèle associé à la séquence et d'ajouter une image liée à PIEDS_V.SIGN_IMG

Pour modifier et compiler le projet ci-joint, il faut ajouter ces références :
  • vers les assemblies de Mercator : MercatorUi.dll, MercatorTunnel.dll et MercatorComponents.dll
  • vers C:\Windows\assembly\GAC_32\Microsoft.Ink\6.1.0.0__31bf3856ad364e35\Microsoft.Ink.dll

Le tout peut être testé sans tablette. La souris remplace alors le stylet.


A télécharger : 0000002385.zip (15764 Kb - 17/11/2017)