{"type":"doc","content":[{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"About"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"0c50bb6c-5ae7-48b0-a51b-ee439b1f3145"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"c967676b-2493-4980-8eed-4f4aeb663fe0"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Applies to QEST Form Mapper","type":"text","marks":[{"type":"strong"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This article details the installation process for the QEST Form Mapper product. This includes installation, configuration and solutions to common problems.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Contents","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"exclude":{"value":"Contents"}},"macroMetadata":{"macroId":{"value":"79042eda-38cc-4475-8dd8-eea5f9dd0ee0"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"754f06fa-a6ae-4cea-80b6-3002cd05b352"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The QEST Form Mapper is a Windows desktop application, which is used to map fields in PDF forms to data elements in the QEST Platform database.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installation guide","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"paragraph","content":[{"text":"The following must be present in the target environment to install the QEST Form Mapper.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Machine","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft .NET Framework 4.6.2 or later.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installation Files","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The QEST Form Mapper msi file ","type":"text"},{"text":"QEST Form Mapper v.Ma.Mi.B.R x86.msi","type":"text","marks":[{"type":"strong"}]},{"text":" where Ma, Mi, B and R are the major version, minor version, build and revision numbers. E.g. ","type":"text"},{"text":"QEST Form Mapper v4.6.2905.43834 x86.msi","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installation Process","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the provided installer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read through the license agreement and check ","type":"text"},{"text":"\"I Accept the terms in the License Agreement\"","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If necessary, adjust the install location by clicking ","type":"text"},{"text":"\"Advanced\"","type":"text","marks":[{"type":"em"}]},{"text":" and browsing for a new location.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"\"Install\"","type":"text","marks":[{"type":"em"}]},{"text":" to install the QEST Form Mapper. ","type":"text"},{"text":"This may require administrator privileges","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The QEST Form Mapper is now installed and ready for use.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upgrades","type":"text"}]},{"type":"paragraph","content":[{"text":"The installer will recognize any existing QEST Form Mapper installation. The existing installation will be automatically upgraded, therefore there is no need to uninstall before install. Any existing configuration files (e.g. QEST.FormMapper.exe.config) will be retained.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configuration guide","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration Settings","type":"text"}]},{"type":"paragraph","content":[{"text":"Configuration settings are available by navigating to ","type":"text"},{"text":"File -> Configuration","type":"text","marks":[{"type":"strong"}]},{"text":" in the application, which provide a way to configure how and where logs are saved and filtered.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":715,"id":"d899884f-c84e-46ff-bf0a-93422e1c22f9","collection":"contentId-3287614581","type":"file","height":452}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Log Filter","type":"text"}]},{"type":"paragraph","content":[{"text":"If the ","type":"text"},{"text":"\"Filter the log\"","type":"text","marks":[{"type":"em"}]},{"text":" checkbox is checked, the application logs will be filtered to show logs of the selected severity level or higher.","type":"text"}]},{"type":"paragraph","content":[{"text":"The levels selected act hierarchically, therefore if ","type":"text"},{"text":"Error","type":"text","marks":[{"type":"strong"}]},{"text":" is selected, only ","type":"text"},{"text":"Errors","type":"text","marks":[{"type":"strong"}]},{"text":" will be logged, however, if Info is selected then Info ","type":"text"},{"text":"Warning","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Error","type":"text","marks":[{"type":"strong"}]},{"text":" will be logged.","type":"text"}]},{"type":"paragraph","content":[{"text":"Reporting filters can be selected from the ","type":"text"},{"text":"Level","type":"text","marks":[{"type":"strong"}]},{"text":" drop down:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Error","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Warning","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Info","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Debug","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Note: If the ","type":"text"},{"text":"\"Filter the log\"","type":"text","marks":[{"type":"em"}]},{"text":" checkbox is NOT checked, all log levels will be reported.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"File Logging","type":"text"}]},{"type":"paragraph","content":[{"text":"If the ","type":"text"},{"text":"\"Write the log to a file\"","type":"text","marks":[{"type":"em"}]},{"text":" checkbox is checked, the QEST Form Mapper will write all program logs to a file whose location is specified by the ","type":"text"},{"text":"\"Output Directory\"","type":"text","marks":[{"type":"em"}]},{"text":". The log filename will also contain a date and time stamp e.g. ","type":"text"},{"text":"QEST Form Mapper.20171215T055406.log","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that these logs cannot be filtered and every log level will be recorded.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"QEST.FormMapper.exe.config","type":"text"}]},{"type":"paragraph","content":[{"text":"QEST.FormMapper.exe.config","type":"text","marks":[{"type":"strong"}]},{"text":" is the primary configuration file for the QEST Form Mapper application and resides in the destination folder of the application.","type":"text"}]},{"type":"paragraph","content":[{"text":"The config file contains the major sections listed below.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"configSections","type":"text"}]},{"type":"paragraph","content":[{"text":"configSections","type":"text","marks":[{"type":"strong"}]},{"text":" defines the additional configuration sections used by QEST Form Mapper. Do not change this section unless advised to do so by Spectra QEST.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"log4net","type":"text"}]},{"type":"paragraph","content":[{"text":"The popular logging system ","type":"text"},{"text":"log4net,","type":"text","marks":[{"type":"strong"}]},{"text":" is used to provide logging for QEST Form Mapper. By default, ","type":"text"},{"text":"log4net","type":"text","marks":[{"type":"strong"}]},{"text":" is configured to create a new logging file for each QEST Form Mapper session at the location specified in the configuration settings.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"For advanced configuration of log4net, the manual is available here: ","type":"text"},{"text":"https://logging.apache.org/log4net/release/manual/configuration.html#files","type":"text","marks":[{"type":"link","attrs":{"href":"https://logging.apache.org/log4net/release/manual/configuration.html#files"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"userSettings","type":"text"}]},{"type":"paragraph","content":[{"text":"This section defines the default values for settings in QEST Form Mapper's configuration settings.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n False\n \n \n Info\n \n \n \n \n \n True\n \n \n ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Troubleshooting guide","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"QEST Administrator Console","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Cannot export the XSD file","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":480,"id":"d14d32d9-6341-4ee0-a355-4b341aec9756","collection":"contentId-3287614581","type":"file","height":160}}]},{"type":"paragraph","content":[{"text":"This is a problem with the QIntegrator. Ensure that the QIntegrator is configured to connect to the QESTNet REST API. The most likely cause is an incorrect ","type":"text"},{"text":".config","type":"text","marks":[{"type":"code"}]},{"text":" file, please check the configurations for QESTNet and QIntegrator:","type":"text"}]},{"type":"paragraph","content":[{"text":"QESTNET.exe.config","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n\n \n \n \n\n \n \n \n \n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"QIntegrator.dll.config","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"A binding redirect is also required for ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"System.Net.Http","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"QESTField","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Cannot upload the completed PDF form to QESTField","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":454,"id":"5e11f6bf-5801-4937-a8fa-5c03198a2270","collection":"contentId-3287614581","type":"file","height":160}}]},{"type":"paragraph","content":[{"text":"The PDF that is uploaded must contain the correct ID which matches the form in QESTField otherwise it will not be uploaded. First please make sure that the form you are attempting to upload is the matching form.","type":"text"}]},{"type":"paragraph","content":[{"text":"To verify that QESTField is functioning correctly please:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download a new PDF form by clicking on the PDF preview image.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upload the downloaded form straight back to QESTField, without modifications.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If that is successful, download and fill out a new form appropriately and re-upload.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"QESTLab","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Misaligned Text","type":"text"}]},{"type":"paragraph","content":[{"text":"Due to the way some PDF viewers render form fields, text that is entered or mapped to form fields can appear misaligned.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":737,"id":"88acc36e-0e5f-49fe-82c0-164449bcd65a","collection":"contentId-3287614581","type":"file","height":74}}]},{"type":"paragraph","content":[{"text":"This is due to the viewer itself and cannot be handled through QESTLab or the Form Mapper. There are two solutions to this issue: Either use a PDF Viewer that shows the text correctly aligned or adjust the location of the form field through a PDF editor, so that the resulting text is aligned correctly.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":733,"id":"79c0434f-749d-46ee-bbd1-d31258a62741","collection":"contentId-3287614581","type":"file","height":68}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reporting Errors","type":"text"}]},{"type":"paragraph","content":[{"text":"If the information above has not resolved your issue, the Spectra QEST Service Desk procedure (","type":"text"},{"text":"Product Support Procedure Overview","type":"text","marks":[{"type":"link","attrs":{"href":"http://online.spectraqest.com/index.php?title=Support:Product_Support_Procedure_Overview"}}]},{"text":") should be followed to report the problem.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"Trademarks, Terms of Use and Privacy Statement"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"57f2e167-04c3-4c86-afba-ec557b669ba8"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"e4d6d170-55ab-4005-85a2-b79d33477fef"}}]},{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported