Custom Questions
Custom Questions is a powerful feature that allows developers to code their own questions tailored to collect and validate answer data using HTML and JavaScript.
With this feature, you have the flexibility to collect as much data as you want with a workflow that best suits your needs. For example, you could specify the flow of custom questions based on context or answer trees within your script.
Context variables include:
__SCAN_VALUE__
__SCAN_RESPONSE__
__SCAN_STATUS__
__USERNAME__
You can format questions in specific ways (date, zip code, phone number, etc.). Also, you can check if an answer fits an expected profile. You can ask one question or many questions with each Custom Question. The core value is that the app user’s answer (or answers) for each Custom Question is saved as part of the official scan record.
To add custom questions, you can use the API or the web UI located on the Questions page and Questions tab when creating a Service. There are two options: URL and HTML. Clearly, the most flexible is the URL option. However, the HTML option is valuable if collecting data offline or if you don’t want to use your own servers.
Here are a few Custom Question (CQ) example scripts:
- Auto-insert the device’s date so the app user doesn’t have to enter a date. Note that this will always update to the device’s timestamp, even when editing scan records in-app and also when used as a session question. This is static and not editable by the app user.
- App-user can enter any date from a drop-down menu, thus making the date entries formatted, quicker to enter, and more accurate. This defaults to the device’s current date and time and the app user can edit it as needed.
- App-user is presented with dependent questions with multiple answers recorded with each scanned record.
- Multiple answers with a form field when a specific answer is selected. The custom aspect is enabling one answer (for example, “Other – Enter Answer”) to open an associated form field just for that answer option.
- How to capture the Username scan property as a Question Answer.
Here is an API doc that shows basic instructions for setting up custom questions for barcode scanning. Also, here is a PDF file that has code examples for the __SCAN_VALUE__ and __SCAN_RESPONSE__ variables.
Custom ‘On-the-Fly’ Questions
In addition to the standard no-coding options for collecting data with questions through barcode scanning, we offer programmers the option to create ‘On-the-Fly’ questions when using our Postback URL feature. You only need to show the app-user these questions when you choose to based on the context. Whereas, with a Custom Question the app user always sees the option to answer a question after a scan.
An On-the-Fly question works like this:
- The scan record is posted in real-time to your server
- Your server will see the barcode value scanned and any answers to questions made by the app-user before submitting the scan.
- Your script can process that information and present the app-user with more questions to answer. Also, you can choose to not present any questions.
- When the app-user answers those questions, they submit it. Then, you can ask more questions. If satisfied, allow the app-user to move on to the next scan.
For instructions, please see our documentation to use Postback URL.