{"id":11867,"date":"2022-08-16T09:42:01","date_gmt":"2022-08-16T14:42:01","guid":{"rendered":"https:\/\/www.mrc-productivity.com\/docs\/?post_type=ht_kb&#038;p=11867"},"modified":"2023-12-06T13:56:58","modified_gmt":"2023-12-06T19:56:58","slug":"signature-capture-in-m-power-maintainers","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/signature-capture-in-m-power-maintainers","title":{"rendered":"Signature Capture in m-Power Maintainers"},"content":{"rendered":"\n<p><style>figcaption{text-align:left !important}<\/style><\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Click <a href=\"https:\/\/www.mrc-productivity.com\/legacy\/signature-capture-in-m-power-maintainers\">here<\/a> to access legacy documentation for this feature<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"overview\">Overview<\/h2>\n\n\n\n<p>As of the August 2022 m-Power update, m-Power maintainer applications now support the implementation of signature capture right from the m-Painter editor.<\/p>\n\n\n\n<p>This feature will allow developers to configure a signature box within their maintainer form over any database field of their choosing. <\/p>\n\n\n\n<p>It should be noted that this feature is only supported in the following maintainer templates:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Data List with Web Form<\/li>\n\n\n\n<li>Single Row Web Form<\/li>\n\n\n\n<li>Calendar<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"form-implementation\">Form Implementation<\/h2>\n\n\n\n<p>To begin, ensure that the data type of the field which will capture the user&#8217;s signature supports alphanumeric values and is large enough to encompass the value associated to the signature. <\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Signature capturing requires a large field to store the graphical representation of the signature. mrc recommends utilizing a <strong>text<\/strong> field where possible. <\/p>\n\n\n\n<p>The stored signature in the database will be saved as a base64 encoded string , so the CLOB or VARCHAR data types would be most appropriate for any signature field. <\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Please consult your database vendor&#8217;s official documentation for more information on supported data types.<\/p>\n\n\n\n<p>The maintainer application should be built as normal over the table containing this field. Once compiled, open the m-Painter editor. <\/p>\n\n\n\n<p>The signature field will by default generate as a textarea box. To make this a signature field, left-click inside the textarea box. In the Element Panel, select &#8220;Input Properties&#8221;. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/vue-images\/sigCaptureClick.jpg\" alt=\"\"\/><figcaption class=\"wp-element-caption\">Fig 1. Implementing a signature field from m-Painter<\/figcaption><\/figure>\n\n\n\n<p>Then, select the &#8216;Signature&#8217; checkbox and press &#8216;Save&#8217;.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/vue-images\/sigTextareaProps.jpg\" alt=\"\"\/><figcaption class=\"wp-element-caption\">Fig 2. Textarea Properties window<\/figcaption><\/figure>\n\n\n\n<p>In m-Painter, the field will still appear as a default textarea; this is expected. At application runtime however, the signature capture box will render, along with a button to clear the signature as the user fills out the form:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/signaturecapture2.jpg\" alt=\"\"\/><figcaption class=\"wp-element-caption\">Fig 3. Maintainer form with a completed signature at runtime<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"displaying-the-signature\">Displaying the Signature<\/h2>\n\n\n\n<p>While completely optional, the captured signature can be displayed outside of the maintainer form page, like within the table list page of a Data List with Web Form template. To display a signature, select the data field that holds the signature. From the Element Panel, select the option to &#8220;Render Signature&#8221;.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/vue-images\/sigRenderSig.jpg\" alt=\"\"\/><figcaption class=\"wp-element-caption\">Fig 4. Render Signature from Element Panel<\/figcaption><\/figure>\n\n\n\n<p>Once done, the signature will render as an image at runtime:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/signaturecapture5.jpg\" alt=\"\"\/><figcaption class=\"wp-element-caption\">Fig 5. Data List with Web Form displaying the signature on the list page<\/figcaption><\/figure>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview As of the August 2022 m-Power update, m-Power maintainer applications now support the implementation of signature capture right from the m-Painter editor. This feature will allow developers to configure a signature box within their maintainer form over any database field of their choosing. It should be noted that this&#8230;<\/p>\n","protected":false},"author":2,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[255],"ht-kb-tag":[],"class_list":["post-11867","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-mpainter"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/11867","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/comments?post=11867"}],"version-history":[{"count":19,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/11867\/revisions"}],"predecessor-version":[{"id":13304,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/11867\/revisions\/13304"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/media?parent=11867"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-category?post=11867"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-tag?post=11867"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}