ARSperl Programmer's Manual

## `ars_LoadQualifier(ctrl, schema, qualstring, displayTag)`

Converts a qualifier string into a scalar qualifier record.

The qualifier string may contain field IDs or field labels. Using field labels, however, does reportedly not always work reliable, so it is strongly recommended to use field IDs.

When mapping field labels, the server will refer to the view specified in `displayTag`. If no view is specified, the server will use the default admin view. It is NOT possible to use database names (returned as "fieldName" by `ars_GetField`) in a qualifier string.

On success
  Returns the qualifier record.
On failure
  Returns `undef`.

Example:

          ($q = ars_LoadQualifier($c, "User", "'101' = \"jmurphy\"")) ||
    	    die $ars_errstr;

or, to specify a particular view:

          ($q = ars_LoadQualifier($c, "User", "'User name' = \"jmurphy\"",
    				"PC-640")) ||
    	    die $ars_errstr;

Back to Table of Contents