20.2. Tworzenie reguł dla programu checker

Nazwy reguł i ich definicje znajdują się w pliku params.xml w oddzielnej przestrzeni nazw (checker). Jeżeli wcześniej w pliku params.xml nie było zdefiniowanych reguł, przed ich utworzeniem należy zdefiniować nową przestrzeń nazw:

xmlns:checker="http://www.praterm.com.pl/SZARP/ipk-checker"

którą należy umieścić w tagu params, najlepiej zaraz za definicją głównej przestrzeni nazw. Definicje reguł znajdują się w sekcji <checker:rules>. Umiejscowienie tej sekcji w porównaniu z innymi sekcjami w pliku params.xml powinno być następujące:

<?xml version="1.0" encoding="ISO-8859-2"?>
<params xmlns="http://www.praterm.com.pl/SZARP/ipk" xmlns:checker="http://www.praterm.com.pl/SZARP/ipk-checker" .....>
<device daemon="..." path="...">
    <unit id="..." type="..." subtype="..." bufsize="...">
      <param name="..." short_name="..." draw_name="..." unit="..." prec="..." base_ind="...">
        <raport title="..." description="..." order="..."/>
        <draw title="...." color="..." min="..." max="..." order="..."/>
      </param>
      ...
     </unit>
</defice>
<defined>
...
</defined>
<drawdefinable>
...
</drawdefinable>
<seasons>
...
</seasons>
<checker:rules>
...
</checker:rules>
</params>

Każda reguła ma następującą budowę:

<checker:rule checker:name="Nazwa reguły">
<![CDATA[
function main()
	return wartosc;
end
]]>
<checker:rule>

Jak widać każda reguł posiada nazwę "Nazwa reguły", która w zasadzie może być dowolna, jednak bardzo zaleca się żeby była to nazwa trójczłonowa tak jak w przypadku nazwy parametru. W sekcji CDATA musi wystąpić funkcja main() która może zwracać jedną z trzech wartości:

• wartosc = 1; - warunek jest spełniony.

• wartosc = 0; - warunek jest niespełniony.

• wartosc = -1; - jeden (lub więcej) parametrów technologicznych sprawdzanych przy pomocy tej reguły zwrócił wartość SZARP_NO_DATA (-32768).