/**
* Toteuttaa kokonaisuuden muokkauksen tallentamisen. Erityisesti käyttäjän
* tekemät muutokset kokonaisuuteen kulkevat aina tämän metodin kautta,
* lukuunottamatta näkyvyyttä ja lukitusta.
*
* Huomaa, ettei lukitusta tai käyttöoikeuksia tarkisteta täällä. Ne
* tarkistetaan Kayttajakontrolleri-luokan metodeilla kokonaisuuden
* tulostuksen (ruudulle) yhteydessä, jolloin vain asianmukaisille
* käyttäjille annetaan painikkeet muokkausta tai poistoa varten.
*
* Joitakin ominaisuuksia ei voi muuttaa täällä:
* luomishetki_sek - ei muuteta
* ed_muutos_sek - automaattinen
* näkyvyys - arvoja ei aseteta täällä (oma metodi Kokonaisuusoliossa)
* on_lapsia - arvoja ei aseteta täällä (oma metodi Kokonaisuusoliossa)
* lukitus - arvoja ei aseteta täällä (oma metodi Kokonaisuusoliossa)
* jarjestysluku - arvoja ei aseteta täällä (oma metodi Kokonaisuuskontrollerissa)
* kieli_id - arvoa ei aseteta täällä.
* taso - ei muuteta
* oppiaine - ei muuteta.
*
* Lukitus poistetaan oliolta onnistuneen operaation päätteeksi.
*
* @param Palaute $palauteolio
*/
function toteuta_tallenna_muokkaus(&$palauteolio)
{
$parametriolio = $this->get_parametriolio();
$ilmoitus = "";
// Tarkistuksessa putsataan vain riskimerkit.
$parametriolio->set_uusi(false);
$omaid = $parametriolio->get_omaid();
$otsikko_kokon = $parametriolio->get_otsikko_kokon();
$tiivis_kokon = $parametriolio->get_tiivis_kokon();
$selitys_kokon = $parametriolio->get_selitys_kokon();
$laajennetun_id_kokon = $parametriolio->get_laajennetun_id_kokon();
$ylakokonaisuuden_id_kokon = $parametriolio->get_ylakokonaisuuden_id_kokon();
$nakyvyys_kokon = $parametriolio->nakyvyys_kokon;
$muutettavan_kokon_id = $parametriolio->id_kokon;
$virhekoodi = Palaute::$VIRHEKOODI_KAIKKI_OK;
// Haetaan kokonaisuuden omistaja, jotta voidaan tarkistaa:
$vanha_kokon = $this->get_olio();
if ($vanha_kokon instanceof Kokonaisuusolio && $vanha_kokon->olio_loytyi_tietokannasta) {
$muutettavan_kokon_luojan_id = $vanha_kokon->getHenkiloId();
} else {
$muutettavan_kokon_luojan_id = Kokonaisuusolio::$MUUTTUJAA_EI_MAARITELTY;
}
//============== Tarkistetaan, onko käyttäjä vielä oikeasti online
// ja valtuudet kunnossa: ======
$kohdeoikeudet = Henkilo::hae_kayttajan_kohdeoikeudet($muutettavan_kokon_luojan_id, $omaid, Oliotyyppi::$KOKONAISUUS, $muutettavan_kokon_id, $this->get_tietokantaolio());
/*====================================================================*/
//======================================================================
// Muokattava aolio:
$muokattava = new Kokonaisuusolio($muutettavan_kokon_id, $this->get_tietokantaolio());
if ($kohdeoikeudet >= Lisavaltuudet::$SAA_MUOKATA_EI_POISTAA) {
if ($muokattava->olio_loytyi_tietokannasta) {
$palauteolio->set_virhekoodi($virhekoodi);
// Lisätään kokonaisuudelle saadut mahdollisesti muutettavat parametrit
// (vain ne, joita ylipäätään voidaan muuttaa):
$muokattava->set_arvo($otsikko_kokon, Kokonaisuusolio::$sarakenimi_otsikko);
$muokattava->set_arvo($tiivis_kokon, Kokonaisuusolio::$sarakenimi_tiivis);
$muokattava->set_arvo($selitys_kokon, Kokonaisuusolio::$sarakenimi_selitys);
$muokattava->set_arvo($laajennetun_id_kokon, Kokonaisuusolio::$sarakenimi_laajennetun_id);
$muokattava->set_arvo($ylakokonaisuuden_id_kokon, Kokonaisuusolio::$sarakenimi_ylakokonaisuuden_id);
$muokattava->set_arvo($nakyvyys_kokon, Kokonaisuusolio::$sarakenimi_nakyvyys);
// Tallennus tietokantaan:
$palaute = $muokattava->tallenna_muutokset();
// Jos tiedoissa on vikaa, esim. tyhjä otsikko:
if ($palaute != Kokonaisuusolio::$OPERAATIO_ONNISTUI) {
$this->get_parametriolio()->set_ilmoitus_kokon($muokattava->tulosta_virheilmoitukset());
$this->lisaa_virheilmoitus($muokattava->tulosta_virheilmoitukset());
$this->toteuta_nayta_kokonaisuuslomake($palauteolio);
$palauteolio->set_virhekoodi(Palaute::$VIRHEKOODI_YLEINEN);
$ilmoitus .= Tekstit::$ilm_kokon_muokkaustallennus_eiok;
} else {
// Kaikki kunnossa.
$ilmoitus = " ";
/* Poistetaan kokonaisuuden lukitus: */
$lukon_tila = Kokonaisuusolio::$LUKITUS_OFF;
$lukituksen_avaus = $muokattava->aseta_kokonaisuuden_lukitus($parametriolio->get_omaid(), $lukon_tila);
/* Ilmoitus, ellei lukitus jostakin syystä onnistunut: */
if ($lukituksen_avaus != Kokonaisuusolio::$OPERAATIO_ONNISTUI) {
$ilmoitus .= " " . Tekstit::$virheilm_kokonaisuuden_lukituksen_avaus_eiok . $muokattava->tulosta_virheilmoitukset();
$virhekoodi = Palaute::$VIRHEKOODI_LUKITUS_KOKONAISUUDET;
} else {
$ilmoitus = Tekstit::$ilm_kokon_muokkaustallennus_ok;
//Aktiivisuusmerkintä:
$aktiivisuuspalaute = paivita_aktiivisuus($omaid, $this->get_tietokantaolio(), time(), Aktiivisuus::$KOKONAISUUDEN_MUUTOSTEN_TALLENNUS);
if (!$aktiivisuuspalaute) {
$this->lisaa_virheilmoitus(Tekstit::$virheilm_aktiivisuuden_tallennus_eiok);
} else {
$onnistuminen = Palaute::$VIRHEKOODI_KAIKKI_OK;
}
}
// Huom: täällä hämäävästi käyttöön tulee uusi palauteolio, jolloin
// esim aiemmat virhekoodin asetukset eivät voimassa.
if ($parametriolio->tallennuskesken) {
$parametriolio->uusi = false;
$this->toteuta_nayta_kokonaisuuslomake($palauteolio);
} else {
// Otetaan selville, tuleekö käyttäjä koosteesta vai
// kokonaisuuksista ja näytetään vastaava juttu:
$parametriolio = $this->get_parametriolio();
$elem_id = $parametriolio->elementti_id;
$elemryhma_id = $parametriolio->elemryhma_id;
// Tarkistetaan, mistä ollaan tulossa ja minne menossa:
$koostekontrolleri = new Koostekontrolleri($this->get_tietokantaolio(), $parametriolio);
if ($elemryhma_id != Elementtiryhma::$MUUTTUJAA_EI_MAARITELTY) {
$koostekontrolleri->toteuta_nayta_elementtiryhma($palauteolio);
$palauteolio->set_muokatun_id($elem_id);
} else {
if ($elem_id != Elementti::$MUUTTUJAA_EI_MAARITELTY) {
$koostekontrolleri->toteuta_nayta($palauteolio);
$palauteolio->set_muokatun_id($elem_id);
} else {
$this->toteuta_nayta($palauteolio);
$palauteolio->set_muokatun_id($muutettavan_kokon_id);
}
}
}
// Tämän pitää olla vasta täällä (ks. ylempi kommentti).
$palauteolio->set_virhekoodi(Palaute::$VIRHEKOODI_KAIKKI_OK);
// Lisätään mahdollinen lukitusvirhekoodi
if ($virhekoodi != Palaute::$VIRHEKOODI_KAIKKI_OK) {
$palauteolio->set_virhekoodi($virhekoodi);
$ilmoitus .= Tekstit::$ilm_kokon_muokkaustallennus_eiok . ": " . $virhekoodi;
}
}
} else {
$this->lisaa_virheilmoitus(Tekstit::$ilm_kokon_ei_loytynyt);
}
} else {
// Kun sessio loppunut tai muuten väärä muokkaaja:
$this->lisaa_virheilmoitus(Tekstit::$virheilm_kokon_muok_ei_valtuuksia);
$this->toteuta_nayta($palauteolio);
}
$palauteolio->set_ilmoitus($ilmoitus . "<br/>" . $this->tulosta_virheilmoitukset());
return $palauteolio;
}
