Skip to content
English
Go to our website
  • There are no suggestions because the search field is empty.

Using the "QR Fields" feature

Sometimes you need to get certain information from your system loaded into CargoSnap.  API's are great for it, but there is another easy way.

Use a QR code to read information into Cargosnap and fill in multiple fields in one scan action!

⚠️ Warning: this is fairly advanced as your system needs to generate a specifically formatted QR code (so this cannot be used on "any" code, but you must program to this format). The QR code format is a "JSON array of key/value pairs". 

Let's clarify with an example. Suppose in a particular process you want to store two pieces of information in a Field format:

- the "product" (for fruits, we could imagine values like "apple", "avocado", "lemon", "strawberry")

- the "producer" (could be a company, like "Lemoni Inc")

In Cargosnap, you would then make 2 fields (Read more about Fields). You will end up with that:

Note that each FIELD you'll create, will have its own unique ID - check the field's URL to see it (image above).

Now that your fields are in place, you need to create a QR code containing the JSON string that will contain the data you need to scan in your operations. 

Here's an example of how the string will look like:

[
  {"id":5988,"name":"product","value":"lemons"},        
  {"id":5989,"name":"producer","value":"Lemoni Inc."}
]

💡 The "name"  of your field is not a mandatory value on your string. However, the ID is fundamental for the scan to work.

This string needs to be parsed as a QR code (tip: omit all formatting when you do so!). See the actual QR code of this example. Note: this link will open an external site, showing the QR code and the build-up of the data). The "name" field will be used in the app to display the scanned values.

Using the feature

In order to use the solution, follow these 4 steps:

1. Create the field(s) in which the data should go in, as mentioned above. In this case, you would create two fields with the type "text" and give them the names "product" and "producer" respectively.

⚠️ These fields are case-sensitive, hence this example is all lowercase.

 2. Create a workflow and add the step which type should be "QR Fields". Do not forget to save the workflow. Read more about building workflows.

3. Reload app settings: in the app, open the menu by clicking ≡ on your left, under "Advanced", you will find the "Reload settings" button. Closing and opening the app should also do the trick. :)

4. Scan a file reference to get started with your workflow. When you get to the QR Fields step, you should scan the JSON string QR code as in our example above. Now, the fields will show up on your screen and, once the workflow is done, they'll be available on your file showing the intended values, and allowing you to filter/search on them!

Pretty cool, isn't is? It is a cost-effective solution to transferring information from one system into Cargosnap, and from Cargosnap you can easily take it to other solutions!