XML tehtävien työnkulku -- TMC työskentelyohjeet LYHYT VERSIO XML harjoitusten toimintaohjeet (lyhyt versio) (XMLStarlet ohjeet löytyvät pitkästä versiosta) ELEC-C1220 - Automaatio 2
Sisältö LYHYT VERSIO 1. Työkaluohjelmat 2. TMC palvelin 3. TMC työnkulku 4. (XMLStarlet työtila) ohjeen pitkässä versiossa 5. Tehtävän ratkaiseminen 6. TMC ratkaisun tarkistaminen 7. (XMLStarlet esitarkistus) ohjeen pitkässä versiossa 8. (Tiedoston editointi Notepad++) ohjeen pitkässä versiossa 9. (Esimerkki: Tehtävän U1E2 vaiheittainen ratkaisu) ohjeen pitkässä versiossa
Työkaluohjelmat TMC-palvelin toimii tehtävien ratkaisujen automaattisena tarkistimena TMC-palvelimeen ollaan yhteydessä web-käyttöliittymän kautta http://src.aalto.fi/tmc/ Opiskelijan omalla koneella tarvitaan seuraavat työkaluohjelmat Notepad++ tai jokin vastaava hyvä tekstieditori XMLStarlet tehtäväratkaisujen etukäteistarkistamiseen (ei pakollinen) Komentotulkit (shell) XMLStarlet komentojen ajamiseen; joko cmd.exe tai PowerShell.exe (Windows) Huom. Seuraavissa ohjeissa oletetaan, että tarvittavat työkaluohjelmat on asennettu. Komentotulkit ovat Aallon koneilla valmiiksi asennettuna ja Notepad++:n voi asentaa aallon Windows koneille self-service portalin kautta: (Start/Aalto_IT/Software self-service portal) XMLStarlet: Katso tämän ohjedokumentin pitkä versio
TMC - palvelin TMC (Test my code) rekisteröityminen järjestelmään
TMC Test My Code XML harjoituksissa keskeinen osa on TMC-palvelimella, josta tehtäväpohjat ladataan ja jonne harjoitustehtävien ratkaisut lähetetään. TMC tarkastaa ja pisteyttää ratkaisut automaattisesti. TMC:n web-osoite: http://src.aalto.fi/tmc/
TMC - rekisteröityminen TMC:n web-osoite: http://src.aalto.fi/tmc/ Ensimmäisellä kerralla sinun täytyy rekisteröityä TMC-palvelimelle ja luoda tunnus klikkaamalla "Sign up" linkkiä aloitussivun ylälaidassa. Huom: Jos olet Aalto-yliopiston opiskelija, sinun tulee käyttää opiskelijanumeroasi TMCkäyttäjänimenä
TMC - työnkulku Esimerkki: Esitehtävän ratkaiseminen
TMC TMC:n web-osoite: http://src.aalto.fi/tmc/ Sisäänkirjautuminen opiskelijanumerotunnuksella Linkki esitehtävään Round_U0-U0E1_1 löytyy All exercises listasta
TMC - Esitehtävä Esitehtävä Round_U0-U0E1_1 Lataa tehtävän zip-paketti (project template zip)
XMLStarlet - työkansio work Pura zip-paketti: \zip_downloads\round_u0-u0e1_1 (Huom:XMLStarlet ohjeet tämän dokumentin pitkässä versiossa)
Tehtävän ratkaisu Tehtävien muokattavat tiedostot ovat aina paketin src-kansiossa Avaa muokattava tiedosto Esitehtava_U0E1.html tekstieditorilla: Notepad++
Tehtävän ratkaisu Tee tarvittavat lisäykset ja muutokset Esitehtava_U0E1.html tiedostoon ohjeiden mukaisesti: Kirjoita oma nimesi ja op-num. niille kuuluviin kenttiinsä <em>tagien väliin</em> Kuvan B esimerkissä näkyy virheellinen editointi (tagin ylikirjoitus 123456em> )
Tehtävän ratkaisun paketointi Paketoi kansio Round_U0 takaisin Round_U0.zip paketiksi TMC:n lataamista varten.
TMC tehtävän tarkistaminen Tehtävän lataaminen ja tarkistaminen TMC:ssä
TMC ratkaisun lataaminen Lataa ratkaisupaketti Round_U0.zip TMC:hen tarkistettavaksi
TMC ratkaisun tarkistaminen Kuva A: Odota hetki tarkistusoperaatiota: Submission received Kuva B: Tarkistin löysi virheitä: Some tests failed
TMC Submission välilehdet Submission sivulla on neljä välilehteä (tab), jotka kertovat tarkistuksen tuloksen, annetut pisteet sekä mitä virheitä löytyi: 1. Test Results 2. Stdout 3. Stderr 4. Files Kuva: Files välilehdellä näytetään ratkaisutiedostojen sisältö
TMC Submission välilehdet VÄLILEHDET: Stderr Kuva A: Stderr välilehti: Ilmoitukset löydetyistä virheistä tarkistusvaiheittain Tämä on tärkein välilehti kun haluat selvittää, mitä virheitä ratkaisusi sisälsi. Huomaa kuitenkin, että kaikista virheistä et välttämättä saa tarkkaa paikannusta. Joskus ilmoitetaan vain ensimmäinen löydetty virhe KUVA A: Tarkistin löysi virheellisesti kirjoitetun lopputagin 123456em>. Op. numero oli kirjoitettu tagin </em> päälle
TMC tehtävän status Status Fail
Tiedoston editointi Notepad++ Avataan Esitehtava_U0E1.html tiedosto Notepad++ editorissa Korjataan löydetty kirjoitusvirhe. Muista asettaa merkkien koodaus Unicode:ksi (Encoding UTF-8 (without BOM)) ennen tiedoston tallentamista
TMC virheiden korjaus ja uudelleen lähetys Korjataan löydetyt virheet worktyötilassa Paketoidaan projekti uudelleen Round_U0.zip tiedostoksi Ja ladataan (submit) TMC:hen kuten edellä tehtiin.
TMC Uudelleen tarkistus Jos virheitä ei löydy Test Result välilehdelle tulostuu: All tests successful Got 1 out of 1 point (u0e1p.1)
TMC Submit answer Tehtävä ratkaistu onnistuneesti => 1 tmc-piste (u0e1p1.1)
XMLStarlet (ks. Ohjeiden pitkä versio) Osa tehtävistä voidaan ainakin osittain tarkistaa etukäteen käyttäen XMLStarlet komentorivityökalua Kuva A: tarkistettava tiedosto XMLStarlet:n työtilassa Kuva B: commands.txt sisältää esimerkin tarkistuskomennosta
END KATSO TÄYDELLISEMMÄT OHJEET TÄMÄN DOKUMENTIN PITKÄSTÄ VERSIOSTA