{"id":37731,"date":"2024-02-26T12:59:17","date_gmt":"2024-02-26T11:59:17","guid":{"rendered":"https:\/\/www.viafirma.com\/faqs\/scan-pdf417-to-fill-in-your-forms\/"},"modified":"2024-02-26T12:59:17","modified_gmt":"2024-02-26T11:59:17","slug":"scan-pdf417-to-fill-in-your-forms","status":"publish","type":"faq","link":"https:\/\/www.viafirma.com\/en\/faqs\/scan-pdf417-to-fill-in-your-forms\/","title":{"rendered":"Scan PDF417 to fill in your forms"},"content":{"rendered":"<p>New functionality in Viafirma Documents to optimize the time used to complete forms and improve the quality of the collected data.<\/p>\n<p>The <strong>new scan type ITEM<\/strong> allows the<strong> reading of a PDF417<\/strong> and the transcription of the data obtained to other fields of the form.<\/p>\n<p>An example of the use of this type of PDF-417 code is given in some identity documents, such as the Colombian ID card, which incorporates this code on the back that contains public information about the citizen and that you can automatically transfer to your form.<\/p>\n<figure class=\"wp-block-image aligncenter\"><img decoding=\"async\" src=\"https:\/\/www.viafirma.com\/wp-content\/uploads\/2019\/09\/PDF417.png\" alt=\"\" \/><\/figure>\n<h3 class=\"wp-block-heading\">Configuration and use<\/h3>\n<p>To use this functionality you will be able to configure your forms, as usual, in two ways: in the form designer that you will find in the management panel of your templates, or directly in the definition of the service when you consume it through API.<\/p>\n<h3 class=\"wp-block-heading\">Configuration from the designer<\/h3>\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/www.viafirma.com\/wp-content\/uploads\/2019\/09\/scan417_01.png\" alt=\"\" \/><\/figure>\n<p>In the template management, forms module, you will be able to edit the properties of your form, adding an item of the &#8220;Scan&#8221; type. This type will allow you to define a default behavior for the possible values supported in different 417 templates that will be added to the product.<\/p>\n<p>For example, the template &#8220;C\u00e9dula Colombia&#8221; will allow you to extract the following data:<\/p>\n<p><em>raw, number, name1, name2, name, surname1, surname2, surname, fullname, birthdate,\u00a0<\/em><em>birth_day, birth_month, birth_year, gender, bloodtype<\/em><\/p>\n<p>and associate them to the fields of your form. The &#8220;hide scan element text field&#8221; option will allow you to print the value captured after scanning, and will be useful during the configuration stage of your form.<\/p>\n<h3 class=\"wp-block-heading\">Use through API<\/h3>\n<p>The internal configuration of the form so that you can make use of the scan functionality must incorporate the following metadata.<\/p>\n<pre class=\"wp-block-preformatted\">{\r\n\"key\" : \"&lt;your_key_id&gt;\",\r\n\"type\" : \"scan\",\r\n\"label\" : \"&lt;your_label_text&gt;\",\r\n\"size\" : \"&lt;your_size&gt;\",\r\n\"scanTypes\" : [ \"PDF417\" ],\r\n\"scanHideTextfield\" : false|true,\r\n\"scanExpression\" : \"&lt;your_expression&gt;\"\r\n}\r\n<\/pre>\n<h4 class=\"wp-block-heading\">JSON Example<\/h4>\n<pre class=\"wp-block-preformatted\">{\r\n\"key\" : \"cedula_scan\",\r\n\"type\" : \"scan\",\r\n\"label\" : \"Enfoca el c\u00f3digo trasero de la c\u00e9dula\",\r\n\"size\" : \"100\",\r\n\"scanTypes\" : [ \"PDF417\" ],\r\n\"scanHideTextfield\" : false,\r\n\"scanExpression\" : \"fullname|nombre_completo;number|cedula\"\r\n}<\/pre>\n","protected":false},"featured_media":0,"template":"","meta":{"_acf_changed":false,"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"default","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[176],"class_list":["post-37731","faq","type-faq","status-publish","hentry","category-viafirma-documents"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.viafirma.com\/en\/wp-json\/wp\/v2\/faq\/37731","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.viafirma.com\/en\/wp-json\/wp\/v2\/faq"}],"about":[{"href":"https:\/\/www.viafirma.com\/en\/wp-json\/wp\/v2\/types\/faq"}],"version-history":[{"count":0,"href":"https:\/\/www.viafirma.com\/en\/wp-json\/wp\/v2\/faq\/37731\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.viafirma.com\/en\/wp-json\/wp\/v2\/media?parent=37731"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.viafirma.com\/en\/wp-json\/wp\/v2\/categories?post=37731"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}