Do definiowania skal służą funkcje:

• stworz_skale(opis, rodzaj, doPrezentacji, idTestow, zrodloDanychODBC='EWD')
• edytuj_skale(idSkali, elementy, nadpisz=FALSE, zrodloDanychODBC='EWD')

Funkcja stworz_skale() służy do „zarejestrowania” w bazie nowej skali. Po dokonaniu takiego „zarejestrowania” należy wprowadzić do bazy informacje o kryteriach oceny i pseudokryteriach oceny, z których składa się dana skala - służy do tego funkcja edytuj_skale().

Aby zdefiniować skale, należy podać:

• opis
• rodzaj - jedno z ewd, ktt, zrównywanie (być może w przyszłości dojdą inne rodzaje)
• doPrezentacji - wartość logiczna decydująca o tym, czy skala będzie oznaczona jako do publicznej prezentacji (ma to wpływ na to wyszukiwanie skal z wykorzystaniem funkcji pakietu ZPD)
• idTestow - wektor id_testu wszystkich testów, z którymi powiązana jest dana skala
  • w szczególności wszystkie kryteria oceny (czy to będące bezpośrednio elementami skali, czy to za pośrednictwem pseudokryteriów oceny) należące do danej skali muszą występować w przynajmniej jednym z wymienionych testów

Np. definiujemy skalę dla zrównywania sprawdzianu z roku 2002 (testy 572 i 573):

library(ZPDzapis)
stworz_skale('zrwn;s;2002', 'zrównywanie', TRUE, c(572, 573))

Funkcja edytuj_skale(idSkali, elementy, nadpisz=FALSE, zrodloDanychODBC='EWD') służy do importu do bazy informacji o kryteriach oceny i pseudokryteriach oceny, z których składa się dana skala. Są one przekazywane w formie ramki danych o następującej strukturze:

• każdy wiersz opisuje jeden element skali (a więc jedno kryterium oceny lub pseudokryterium oceny
• kolumna id_kryterium zawiera identyfikatory kryteriów oceny dla tych elementów skali, które są pojedynczymi kryteriami oceny
• kolumna id_pseudokryterium zawiera identyfikatory pseudokryteriów oceny dla tych pseudokryteriów oceny, których identyfikatory są znane tworzącemu skalę
• kolumny id_kryterium_N (gdzie N to dowolna liczba) zawierają identyfikatory kryteriów oceny składających się na te pseudokryteria oceny których identyfikatorów w bazie tworzący skalę nie zna (lub zgoła w bazie nie ma jeszcze takich pseudokryteriów oceny
• kolumna opis zawiera opis pseudokryterium
  • musi ona mieć wartość tylko dla tych elementów skali, które:
    • są opisywane poprzez kolumny id_kryterium_N
    • i jednocześnie takiego pseudokryterium oceny nie ma jeszcze zdefiniowanego w bazie
  • opis powinien mieć postać „R_EGZ;CZ_EGZ;ROK;NR_ZAD;NR_KO”, gdzie
    • R_EGZ i CZ_EGZ to rodzaj i część egzaminu, z którego pochodzą kryteria oceny składające się na dane pseudokryterium oceny
    • ROK to rok egzaminu, z którego pochodzą kryteria oceny składające się na dane pseudokryterium oceny
    • NR_ZAD to numer zadania w arkuszu egzaminacyjnymi, z którego pochodzą kryteria oceny składające się na dane pseudokryterium oceny
    • NR_KO to zakres numerów kryteriów oceny zadania egzaminacyjnego składających się na dane pseudokryterium oceny, przy czym * oznacza wszystkie kryteria danego zadania
• kolumna id_skrotu zawiera identyfikatory skróceń skal, które mają zostać zastosowane do poszczególnych elementów skali
  • identyfikatory skróceń skal budowane są wg schematu
    „WE1;WE2;…;WEn|WY1;WY2;..WYn”, gdzie
    • WEx to kolejnej wartości początkowe elementu skali (separatorem dziesiętnym może być zarówno kropka, jak i przecinek)
    • WYx to odpowiadające WEx wartości skrócone elementu skali (separatorem dziesiętnym może być zarówno kropka, jak i przecinek)
  • jeśli dane skrócenie skali nie będzie zdefiniowane w bazie, zostanie automatycznie dodane

Np. chcąc zdefiniować skalę składającą się z podzbioru zadań na sprawdzianie szóstoklasisty w 2002 roku:

• kryterium oceny o identyfikatorze 1115, do którego chcemy zastosować skrócenie skali postaci
  • wartość 0 zamień na 0
  • wartość 1 zamień na 1
  • wartość 2 zamień na 1
• pseudokryterium oceny o znanym nam identyfikatorze 42
• pseudokryterium oceny o nieznanym nam identyfikatorze, które jednak składa się z kryteriów oceny o identyfikatorach 1120, 1121, 1122 i którego istnienia w bazie nie jesteśmy pewni, w związku z czym dostarczymy jego opis (kryteria 5-7 zadania 25 ze sprawdzianu szóstoklasisty z 2002 roku)

powinniśmy przygotować następującą ramkę danych:

Pozostałe argumenty funkcji to:

• idSkali - identyfikator skali uzyskany z funkcji stworz_skale() (patrz wyżej)
• nadpisz - wartość logiczna decydująca o tym, czy jeśli dana skala posiada już w bazie przypisane elementy, to czy mają one zostać zastąpione (nadpisz=TRUE) czy nie (nadpisz=FALSE)
  Należy przy tym pamiętać, że jeśli do danej skali przypisane są już jakieś wynika skalowań, to operacja nadpisania takiej skali nie będzie możliwa.

Zakładając, że definicja skali ze zbiorem danych, jak w tabeli powyżej znajduje się w pliku skala.dta utworzenie nowej skali w bazie mogłoby wyglądać tak:

library(ZPDzapis)
library(foreign)
elementySkali = read.dta('skala.dta')
idSkali = stworz_skale('zrwn;s;2002', 'skalowanie sprawdzianu z roku 2002 do zrównywania', 'zrównywanie', TRUE, c(572, 573))
edytuj_skale(idSkali, elementySkali)

Ten sam zbiór danych zdefiniowany w R:

elementySkali = data.frame(
  id_kryterium = c(1115, NA, NA),
  id_pseudokryterium = c(NA, 42, NA),
  id_kryterium_1 = c(NA, NA, 1120),
  id_kryterium_2 = c(NA, NA, 1121),
  id_kryterium_3 = c(NA, NA, 1122),
  opis = c(NA, NA, 'sprawdzian;;2002;25;5-7'),
  id_skrotu = c('0;1;2|0;1;1 ', NA, NA)
)