stworz_test_z_wielu_czesci: Tworzenie testów będących złączeniem kilku części egzaminu.
In zozlak/ZPDzapis: Funkcje zapisu danych do bazy ZPD

View source: R/stworz_test_z_wielu_czesci.R

stworz_test_z_wielu_czesci

R Documentation

Tworzenie testów będących złączeniem kilku części egzaminu.

Description

Funkcja tworzy nowy test ze wskazanych części wskazanego (poprzez rodzaj i rok) egzaminu i wypełnia tablicę dane_osobowe.testy_obserwacje uczniami, którzy wystąpili w przynajmniej jednej z części wskazanego egzaminu.

Usage

stworz_test_z_wielu_czesci(
  P,
  rodzajEgzaminu,
  czesciEgzaminu,
  rokEgzaminu,
  czyEwd,
  opis,
  czescEgzaminuZapisz = NA,
  pominTransakcje = FALSE
)

Arguments

`P`	połączenie z bazą danych uzyskane z `DBI::dbConnect(RPostgres::Postgres())`
`rodzajEgzaminu`	rodzaj egzaminu ("sprawdzian" / "egzamin gimnazjalny" / "matura")
`czesciEgzaminu`	wektor części egzaminu, które mają zostać połączone
`rokEgzaminu`	rok egzaminu
`czyEwd`	czy dane mają pochodzić z testów EWD
`opis`	opis nowotworzonego testu w tablic `testy`
`czescEgzaminuZapisz`	opcjonalnie nazwa części egzaminu, która zostanie przypisana nowej skali w kolumnie `czesz_egzaminu` tablicy `testy` (znajduje zastosowanie w odniesieniu do egzaminu gimnazjalnego)
`pominTransakcje`	wartość logiczna pozwalająca wywołać funkcję tak, aby nie używała transakcji - co do zasady nie należy stosować (przydatne tylko, jako sposób na uniknięcie błędu DBI/RPostgres związanego z brakiem obsługi zagnieżdżonych transakcji)

Details

Tworzony test posiada datę, jak najstarsza z data części egzaminu, z których powstał oraz ewd zgodne z testami, z których powstał.

Spośród kolumn tablicy dane_osobowe.testy_obserwacje kopiowana jest tylko kolumna id_szkoly, natomiast kolumna zrodlo ustawiana jest na wartość baza. Pozostałe kolumny (np. dysleksja, klasa, itp.) ustawiane są na NULL.

Jeśli w bazie istnieje już test o takim samym opisie, zrówcone zostanie id_testu tego testu i jednocześnie wygenerowany zostanie warning informujący o tym, że nowy test nie został utworzony. Uwaga! Nie gwarantuje to, że istniejący w bazie test składa się z identycznych testów składowych - porównanie bazuje tylko na opisie testu, który jest ustawiany arbitralnie przez tworządego test.