+ Barcode/QR code scanning only works when using KoboCollect on mobile devices. +
+ +A wide range of Barcode and QR code formats are supported, including the +following: + +- UPC-A +- UPC-E +- EAN-8 +- EAN-13 +- Code 39 +- Code 93 +- Code 128 +- Codabar +- ITF +- RSS-14 +- RSS-Expanded +- QR Code +- Data Matrix +- Aztec +- PDF 417 +- MaxiCode + +"Barcode/QR code" questions can be used in different scenarios including asset +management or item distribution. For example, you can scan a QR code on a +beneficiary identity card to capture their ID number. You can then use use the +`pulldata()` function to automatically populate fields from a CSV attached to +your project or from a [linked project](dynamic_data_attachment.md) with +information about the beneficiary. You can learn more about the `pulldata()` +function [here](https://xlsform.org/en/#how-to-pull-data-from-csv). + +## How to set up the "Barcode/QR code" question type + +### Setting up in formbuilder + +To add a "Barcode/QR code" question: + +- Click the button to add a new question +- Type the question text, for example "Collect the beneficiary identification + code", then click **ADD QUESTION** or press ENTER on your keyboard +- Choose the question type + + + +### Setting up in XLSForm + +To add a "Barcode/QR code" question in XLSForm, add a question with type +`barcode` as follows: + +| type | name | label | +| :------ | :------------- | :------------------------------ | +| barcode | beneficiary_id | Capture the beneficiary ID code | +| survey | + +## How "Barcode/QR code" questions are displayed on web forms and KoboCollect + +## Default appearance + + + +## Advanced appearance + +When adding the "Barcode/QR code" question type, you can change the appearance +settings to switch from using the default (back) camera of the device to using +the front camera. + +### Changing advanced Appearance in formbuilder + +Go to the question settings of the "Barcode/QR code" question, and type "front" +in the "Appearance (Advanced)" box + + + +### Changing advanced Appearance in XLSForm + +In XLSForm, you can set the default camera for capturing the "Barcode/QR code" +to be the front camera by typing 'front' in the `appearance` column as follows: + +| type | name | label | appearance | +| :------ | :--------------- | :------------------------------ | :--------- | +| barcode | beneficiary_id_2 | Capture the beneficiary ID code | front | +| survey | + ++ You can download an XLSForm with examples from this article + here. +
diff --git a/source/images/barcode_qrcode_questions/adding_barcode_qrcode_questions.gif b/source/images/barcode_qrcode_questions/adding_barcode_qrcode_questions.gif new file mode 100644 index 00000000..1d438287 Binary files /dev/null and b/source/images/barcode_qrcode_questions/adding_barcode_qrcode_questions.gif differ diff --git a/source/images/barcode_qrcode_questions/barcode_qrcode_appearance.png b/source/images/barcode_qrcode_questions/barcode_qrcode_appearance.png new file mode 100644 index 00000000..d6f95c2c Binary files /dev/null and b/source/images/barcode_qrcode_questions/barcode_qrcode_appearance.png differ diff --git a/source/images/barcode_qrcode_questions/change_appearance_barcode_qrcode_questions.png b/source/images/barcode_qrcode_questions/change_appearance_barcode_qrcode_questions.png new file mode 100644 index 00000000..d186d532 Binary files /dev/null and b/source/images/barcode_qrcode_questions/change_appearance_barcode_qrcode_questions.png differ diff --git a/source/index.rst b/source/index.rst index 42d7aa51..e3b8c717 100644 --- a/source/index.rst +++ b/source/index.rst @@ -49,6 +49,7 @@ Search the knowledge base, browse our resources and visit our forum for more det select_one_and_select_many gps_questions calculate_questions + barcode_qrcode_questions advanced_calculate video_question_type matrix_response