/**
  * Toteuttaa uuden tehtävän tallentamisen. Palaute-luokan olio toimii kuten
  * tavallista sisältäen lopuksi tarpeelliset tiedot toiminnon onnistumisesta yms.
  *
  * @param Palaute $palauteolio
  */
 function toteuta_tallenna_uusi(&$palauteolio)
 {
     $parametriolio = $this->get_parametriolio();
     $id_kokon = $parametriolio->id_kokon;
     $omaid = $parametriolio->get_omaid();
     $otsikko_teht = $parametriolio->otsikko_teht;
     $tehtavananto_teht = $parametriolio->tehtavananto_teht;
     $vaikeustaso_teht = $parametriolio->vaikeustaso_teht;
     $nakyvyys = $parametriolio->nakyvyys_teht;
     $tietokantaolio = $parametriolio->get_tietokantaolio();
     $onnistuminen = Palaute::$VIRHEKOODI_TALLENNUS;
     // Tarkistetaan tiedot:
     $tallennettava = new Tehtava(Tehtava::$MUUTTUJAA_EI_MAARITELTY, $tietokantaolio);
     // Asetetaan arvot paikalleen:
     $tallennettava->set_arvo($omaid, Tehtava::$sarakenimi_henkilo_id);
     $tallennettava->set_arvo(time(), Tehtava::$sarakenimi_luomishetki_sek);
     $tallennettava->set_arvo(-1, Tehtava::$sarakenimi_ed_muutos_sek);
     $tallennettava->setKokon_id($id_kokon);
     $tallennettava->setOtsikko($otsikko_teht);
     $tallennettava->setTehtavananto($tehtavananto_teht);
     $tallennettava->setVaikeustaso($vaikeustaso_teht);
     $tallennettava->setNakyvyys($nakyvyys);
     $palaute = $tallennettava->tallenna_uusi();
     if ($palaute === Tehtava::$OPERAATIO_ONNISTUI) {
         //Aktiivisuusmerkintä:
         $aktiivisuuspalaute = paivita_aktiivisuus($omaid, $tietokantaolio, time(), Aktiivisuus::$UUDEN_TEHTAVAN_TALLENNUS);
         if (!$aktiivisuuspalaute) {
             $this->lisaa_virheilmoitus(Tekstit::$virheilm_aktiivisuuden_tallennus_eiok);
         } else {
             $onnistuminen = Palaute::$VIRHEKOODI_KAIKKI_OK;
         }
         //==================================================================
         ////================================================================
         // Jos tullaan koosteesta, lisätään tehtävä muös koosteeseen.
         // tässä tulee se hankaluus, että on hankala täältä käsin asettaa
         // elementtien järjestystä uusiksi. Hmm.. Elementti on siis sen
         // kokonaisuuden sisältävä elementti, johon tehtävä lisätty, ja
         // sen takia "rajaelementti", jotta sen jälkeen on paikka uudelle
         // tehtävälle.
         $elem_id = $parametriolio->elementti_id;
         if ($elem_id != Elementti::$MUUTTUJAA_EI_MAARITELTY) {
             $rajaelem = new Elementti($elem_id, $this->get_tietokantaolio());
             if ($rajaelem->olio_loytyi_tietokannasta) {
                 $parametriolio->kooste_id = $rajaelem->get_arvo(Elementti::$sarakenimi_kooste_id);
             }
             $koostekontr = new Koostekontrolleri($this->get_tietokantaolio(), $parametriolio);
             $onni = $koostekontr->lisaa_elem_jalkeen($tallennettava, $rajaelem);
             if ($onni === Kooste::$OPERAATIO_ONNISTUI) {
                 // Mahdollinen elementtiryhmälinkin lisäys, jos lisäys
                 // tapahtuu sieltä käsin:
                 $elemryhma_id = $parametriolio->elemryhma_id;
                 if ($elemryhma_id != Elementtiryhma::$MUUTTUJAA_EI_MAARITELTY) {
                     $kooste = $koostekontr->get_olio();
                     // Haetaan lisätyn elementin id:
                     $uuden_elem_id = $koostekontr->hae_elem_id($kooste, $tallennettava);
                     // Jos löytyi:
                     if ($uuden_elem_id != Elementti::$MUUTTUJAA_EI_MAARITELTY) {
                         // Lisätään linkki:
                         $linkki = new Elementtiryhmalinkki(Elementtiryhmalinkki::$MUUTTUJAA_EI_MAARITELTY, $tietokantaolio);
                         $linkki->set_arvo($elemryhma_id, Elementtiryhmalinkki::$sarakenimi_elementtiryhma_id);
                         $linkki->set_arvo($uuden_elem_id, Elementtiryhmalinkki::$sarakenimi_elementti_id);
                         $linkki->tallenna_uusi();
                         $koostekontr->toteuta_nayta_elementtiryhma($palauteolio);
                     }
                 } else {
                     $koostekontr->toteuta_nayta($palauteolio);
                 }
                 $onnistuminen = Palaute::$VIRHEKOODI_KAIKKI_OK;
             } else {
                 $onnistuminen = Palaute::$VIRHEKOODI_YLEINEN;
                 $this->lisaa_virheilmoitus($onni);
                 $koostekontr->toteuta_nayta($palauteolio);
             }
             $palauteolio->set_ilmoitus($this->tulosta_virheilmoitukset());
             // JOtta palataan varmasti samaan elementtiin:
             $palauteolio->set_muokatun_id($parametriolio->elementti_id);
         } else {
             $this->toteuta_nayta_tehtavat($palauteolio);
             $palauteolio->set_muokatun_id($tallennettava->getId());
             $palauteolio->set_ilmoitus(Tekstit::$tehtava_ilm_tallennus_uusi_ok . $this->tulosta_virheilmoitukset());
         }
         //======================================================================
         //======================================================================
     } else {
         $parametriolio->uusi = true;
         // Varmuuden vuoksi.
         $this->toteuta_tehtavalomakkeen_naytto($palauteolio);
         $palauteolio->set_ilmoitus($tallennettava->tulosta_virheilmoitukset());
     }
     $palauteolio->set_virhekoodi($onnistuminen);
 }