NUMBER %QKPOS%
Scopo: recupera la posizione iniziale, all'interno dell'attributo inizializzato con %GETKEYS%, delle occorrenze delle chiavi di ricerca trovate.

Descrizione: Tipicamente utilizzata per evidenziare, nella visualizzazione dei documenti, i termini inseriti nella frase di ricerca ritrovati all'interno di un determinato attributo.
L'utilizzo dei valori espressi da %QKPOS% è subordinato alla chiamata di inizializzazione di %GETKEYS% relativamente all'attributo sul quale si desidera operare.
indice esprime l'occorrenza, all'interno dell'attributo oggetto dell'elaborazione, dei termini della frase di ricerca che si desidera evidenziare.
In pratica, all'atto della visualizzazione di un documento, per i singoli attributi, bisogna chiamare la funzione di inizializzazione %GETKEYS%, quindi eseguendo un ciclo %REPEAT% da 1 a %QKNUM%, determinare le parti del contenuto dell'attributo che si intende evidenziare: ogni occorrenza determinata dall'indice di %REPEAT% fornisce con %QKPOS% l'offset iniziale e con %QKLEN% la lunghezza della parte de evidenziare.

Valore restituito: valore numerico
Torna un numero intero >= 0 in caso di esito positivo;
Torna -1 in caso di errore generico.

Vedere anche: %QKNUM%, %QKPOS%, , Ricerca

Esempio:
%IF%(%BLOADDOC%(%CURDOC%))
 %IF%(%ATTRSIZE%("ATTRIBUTO1"))
  %IF%(%GETKEYS%("ATTRIBUTO1") && %QKNUM%% )
   %STRING%(valore,%ATTRIB%("ATTRIBUTO1"))
   %STRING%(val,%MID%(valore,0,%QKPOS%(1)))
   %REPEAT%(1,%QKNUM%)
    %STRCAT%(val,"<font color=#ff6000>")
    %STRCAT%(val, %MID%(valore, %QKPOS%(%INDEX%), %QKLEN%(%INDEX%)))
    %STRCAT%(val,"</font>")
    %STRCAT%(val, %MID%(valore, %QKPOS%(%INDEX%)+%QKLEN%(%INDEX%), %QKPOS%(%INDEX%+1)-(%QKPOS%(%INDEX%)+%QKLEN%(%INDEX%))))
   %ENDREPEAT%
  %ELSE%
   %ATTRIB%("ATTRIBUTO1")
  %ENDIF%
 %ENDIF%
%ENDIF%