QlikView Quoteology

[hic]

In all programming environments there is a need for quotation marks, and QlikView is no exception. But which symbol should you use? " ", [ ], ` ` or ' ' ? This post will try to explain the differences between the different quotation marks.

[hic]

When creating the script or an expression in QlikView, you need to reference fields, explicit values and variables. To do this correctly, you sometimes need to write the string inside a pair of quotation marks. One common case is when a field name contains a symbol that prevents QlikView from parsing it correctly, like a space or a minus sign.

For example, if you have a field called “Unit Cost”, then
     Load Unit Cost
will cause a syntax error since QlikView expects an "as" or a comma after the word "Unit".

If you instead write
     Load [Unit Cost]
QlikView will load the field “Unit Cost”. Finally, if you write
     Load 'Unit Cost'
QlikView will load the text string "Unit Cost" as field value. Hence, it is important that you choose the correct quotation mark.

So, what are the rules? Which quote should I use? Single? Double? Square brackets?

There are three basic rules:

1. Single quotes are used to quote literals, e.g. strings that should be used as field values.
2. Double quotes are used to quote source field references, i.e. names of fields. (In formulae, or to the left of the “as” inside a Load statement.)
3. Double quotes can always be substituted by square brackets or by grave accents.

With these three rules, most cases are covered. However, they don’t cover everything, so I'll continue:

• In the script, but outside a Load statement, double quotes denote a variable reference and not a field reference. If double quotes are used, the enclosed string will be interpreted as a variable and the value of the variable will be used.

A general rule in QlikView is that field references inside a Load must refer to the fields in the input table – the source of the Load statement. They are source field references or in-context field references. Aliases and fields that are created in the Load cannot be referred since they do not exist in the source. There are however a couple of exceptions: the functions Peek() and Exists(). The first parameters of these functions refer to fields that either have already been created or are in the output of the Load. These are out-of-context field references.

• Out-of-context field references and table references, e.g. the parameters in NoOfRows() and Peek(), should be regarded as literals and therefore need single quotes.
• Finally, in many places you are free to use any of the four quotation methods, e.g.
  • Inside a Load statement, to the right of the “as”
  • In places where QlikView expects a file name, a URL or a table name
  • Defining the beginning and end of an inline table
  • For the first parameter of Peek() or Exists() when used inside a Load

I have deliberately chosen not to say anything about SELECT statements. The reason is that the rules depend on which database and which ODBC/OLEDB you have. But usually, rules 1-3 apply there also.

With this, I hope that the QlikView quoteology is a little clearer.

HIC

Further reading related to this topic:

Escape sequences