View source for V

[[Category:Võrgurakendused II: hajussüsteemide ehitamine]]
=Liige=
Veiko Vainu D21
=Retsensioonid=
==XML==
<b>[https://wiki.itcollege.ee/index.php/Talk:Meeskond_%22asdasdasd%22 Retsensioon meeskond „asdasdasd“ XML-i kohta – 24.03.2013]</b>

<b>[https://wiki.itcollege.ee/index.php/Talk:SaanEndagaH%C3%A4stiL%C3%A4bi Retsensioon meeskond „SaanEndagaHästiLäbi“ XML-i kohta – 24.03.2013]</b>
==Teenus==
<b>[https://wiki.itcollege.ee/index.php/Talk:KK_without_K Retsensioon meeskond „KK without K“ teenuse kohta – 3.06.2013]</b>
==Klientrakendus==
<b>[https://wiki.itcollege.ee/index.php/Talk:KK_without_K Retsensioon meeskond „KK without K“ klientrakenduse kohta – 3.06.2013]</b>

=XML fail=
==XML andmefail==
*[http://enos.itcollege.ee/~vevainu/XML/armeeXML.xml XML andmefail]

==XML skeemifail==
*[http://enos.itcollege.ee/~vevainu/XML/armeeXML.xsd XML skeemifail]

==XML stiilifailid==
<b>XML to HTML</b> - Kuvab vasakul pool lehte kogu XML-i sisu nn. puuvaates. Paremal pool on otsing, mis otsib sõduri ees- ja perekonnanimest vastavat stringi.
* [http://enos.itcollege.ee/~vevainu/XML/xmlTOhtml.xslt XML to HTML]
* [http://enos.itcollege.ee/~vevainu/XML/xmlTOhtml.xml Näidis]

<b>XML to XML</b> - Trükib välja kõik sõdurid sorteerides perekonnanime ja seejärel eesnime järgi. Igale sõdurile on lisatud ka uus atribuut ID, mis koosneb sõduri ID-st ja tema rühma, allüksuse ja väeosa ID-st.
* [http://enos.itcollege.ee/~vevainu/XML/xmlTOxml.xslt XML to XML]
* [http://enos.itcollege.ee/~vevainu/XML/xmlTOxml.xml Näidis]

<b>XML to Excel</b> - Loob workbooki iga allüksuse jaoks oma worksheeti kuhu kuvatakse selle üksuse isikkooseis sorteeritult Auastme tähestikulises järjekorras.
* [http://enos.itcollege.ee/~vevainu/XML/xmlTOxlsx.xslt XML to Excel]
* [http://enos.itcollege.ee/~vevainu/XML/xmlTOxlsx.xml Näidis XML]
* [http://enos.itcollege.ee/~vevainu/XML/xmlTOxlsxNAIDE.xlsx Näidis EXCEL]
* Kuidas - tuleb xml faili lisada viide vastavale  xslt stylesheetile, seejärel tuleb xml fail Excelis avada ja valida, et kasutatakse vastavat stiilifaili.

==XML kõik ühes (.rar)==
*[http://enos.itcollege.ee/~vevainu/XML/XML.rar Kõik failid ühes (.rar)]

=Veebiteenus=

Loodud sai kontaktiraamatu teenus, mis põhineb õppejõu "Telefoniraamatu teenus" näidisteemal.

Teenus on loodud WCF baasil ja kasutab Asp.Net kasutajate autentimist, mille jaoks on vastavad membership- ja roleprovider. Teenus võimaldab ka logimist, mis toimub enne sissetuleva päringu täitmist ning kus kontrollitakse ka kasutaja päringu limiidi ületamist. Teenuse päringud teostatakse Ninject süstimise abil läbi uow (unit-of-work) konteineri, mis omakorda sisaldab repositooriume. Kogu andmekiht on üles ehitatud Entity Framework Code First meetodil.

Teenus pakub järgmisi meetodeid:
* <b>User methods </b>
**<b> AuthenticateUser</b>  - Tries to authenticate the user based on credentials.
*** returns  >  User object of the user or null if authentication failed.
**<b> GetAuthenticatedMyContact </b>  - Gets personal contact object of the querying user.
*** returns  >  A contact object.
**<b> AddUpdateContact </b>  - Add or update contacts infromation.
*** param name="contact"  >  Contact object to add or update.
*** returns  >  A contact object with updated fields.
**<b> AddUpdateContactInfo </b>  - Add or update contacts contact infromation.
*** param name="contactInfo"  >  Contact information object to add or update.
*** returns  >  A contact information object with updated fields.
**<b> AddUpdateContactPicture </b>  - Add or update a contacts picture.
***param name="contactId" > Id of the contact to whom we wish to add a picture to or update/replace and existing one.
***param name="picture" > File object of containing the picture we wish to add to a contact.
***returns > A file object with updated fields.
**<b> DeleteContact </b>  - Deletes a contact by contact object.
***param name="contact" > Contact object of the contact to delete.
***returns > True if deleteion was successful. False if deletion was unsuccessful.
**<b> DeleteContactById </b>  - Deletes a contact by id.
***param name="id" > Id of the contact to delete.
***returns > True if deleteion was successful. False if deletion was unsuccessful.
**<b> DeleteContactInfo </b>  - Deletes a contacts contact information by contact information object.
***param name="contact" > ContactInfo object of the contact information to delete.
***returns > True if deleteion was successful. False if deletion was unsuccessful.
**<b> DeleteContactInfoById </b>  - Deletes a contacts contact information by contact information id.
***param name="id" > Id of the contact information to delete.
***returns > True if deleteion was successful. False if deletion was unsuccessful.
**<b> GetAllContacts </b>  - Gets a list of all contacts of the querying user.
***returns > A list of contact objects.
**<b> GetAllContactInfoTypes </b>  - Gets a list of contact information types.
***returns > A list of contactinfotype objects.
**<b> GetAllContactInfoesByContactId </b>  - Gets a list of a contacts contact information.
***param name="contactId" > Id of a contact whose contactinformation to retrieve.
***returns > A list of contactinfo objects.
**<b> GetByIdContact </b>  - Returns a contacts information.
***param name="id" > Id of the contact whose information to retrieve.
***returns > A contact object
**<b> GetByIdContactPicture </b>  - Returns a file object, containing a picture in binary form, of a contact.
***param name="id" > Id of the contact whose picture to retrieve.
***returns > A file object of the contacts picture.
**<b> SearchContactByAny </b>  - Searches contacts by name or by contacts information, depending on given input.
***param name="any" > Symbol combination to search by.
***param name="type" > Contact info type name to search by, or all to search by everything.
***returns > A list of contacts matching the search criteria.
**<b> SearchContactByAnyPublic </b>  - Searches contacts by name or by contacts information, depending on given input. Also searches publicly available contact (contacts that have IsPublic=True).
***param name="any" > Symbol combination to search by.
***param name="type" > Contact info type name to search by, or all to search by everything.
***returns > A list of contacts matching the search criteria.
* <b> Administrators methods </b>
**<b> AdminAddUpdateUser </b>  - Administrator method, adds or updates a user.
***param name="user" > User object to add or update.
***returns > A user object with updated fields.
**<b> AdminDeleteUser </b>  - Administrator method, deletes a user by id. (Sets DeletedOn date to now)
***param name="userId" > Id of the user to delete.
***returns > True if deletion was successful. False if deletion was unsuccessful.
**<b> AdminGetAllUsers </b>  - Administrator method, gets a list of all users.
***returns > A list of user objects.
**<b> AdminGetAllUserRoles - Administrator method, gets all possible user roles.
***returns > A list of type user role objects
**<b> AdminGetByIdUser </b>  - Administrator method, gets the user object by id.
***param name="userId" > Id of the user whose user data we wish to retrieve.
***returns > A user object.
**<b> AdminGetLogsByUserId </b>  - Administrator method, gets a list of logs by user id. Get only the logs from the last 24 hours.
***param name="userId" > Id of the user whose logs to get.
***returns > A list of log objects.

Raskuskohad olid injectimine, nii et ei tekiks konflikte, ning kasutajate päringute hulga ilus piiramine, hetkel lihtsaltkatkestatakse kasutajaga ühendus.

=Klientrakendused=
Klientrakendus on tehtud WPF baasil kasutades peamiselt MVVM (Model-View-ViewModel) lähenemist, mille puhul View kood on enamjaolt tühi. Teenuse kasutamisel igakordse parooli ja kasutajanime sisestamise vältimiseks on teenuse kanali loomine eraldi kapseldatud. 

Loodud klientrakendus võimaldab järgnevat:
*Kasutajaid tuvastada
*Kasutajad rolli põhjal eristada ja kuvada erinevaid menüüsid
*Kasutajal kontake lisada ja redigeerida
*Kontaktidele kontaktandmeid lisada ja redigeerida
*Kontaktidele pilte lisada, otse arvutist kui ka veebilinki ette andes
*Kontakte otsida kontakti nime ning kontaktandmete sisu järgi
*Kontakte otsida vaid kindla kontaktandmete tüübi sisu järgi
*Kontakte otsida ka nn. avalike ehk teiste kasutajate kontaktide seast
*Kontaktide määrata avalikuks (teistele nähtav) või mitte-avalikuks
*Administraatoritel lisada ja redigeerida kasutajaid
*Administraatoritel muuta maksimaalsete päringute arvu
*Administraatoritel näha iga kasutaja viimase 24 tunni päringuid (logi)

Raskuskohad olid teenuse asünkroonne kasutamine rakenduses ning võimalike veateadete haldamine.
=Klientrakenduse ja teenuse kasutamine=
Klientrakendus ja teenus asuvad koos [http://enos.itcollege.ee/~vevainu/TeenusJaKlient.rar SIIN]

Et teenus suudaks kliendiga suhelda tuleb luua sertifikaadid ja nende "Thumbprint" kood asendada vastavalt "ServiceHost" ja "ServiceClientWPF" konfiguratsioonifailides, vastavalt "Web.config" ja "App.config". Õpetus kuidas sertifikaate luua ja nende "Thumbprint" leida on õppejõu poolt jagatud videos [http://echo360.e-uni.ee/ess/echo/presentation/75e01210-2016-44a5-a48a-8a861c1b9799 SIIN]

Hetkel on "ServiceHost" seadistatud kasutama internetist kättesaadavat andmebaasi, kui soovite selle lokaalse vastu vahetada tuleb muuta "ContactBookConnection" nimeline connectionstring.

Kui on soovi kasutada omaenda kohalikku andmebaasi, siis saab EF andmebaasi loomiseks ja testandmete sisestamiseks kasutada "DALTestConsole" programmijuppi, kus tuleb siis asendada "ContactBookConnection" nimeline connectionstring. Et testandmeid suudetaks sisestada tuleb teha järgmist:
*DAL>ContactBookContext.cs - välja kommenteerida "this.Configuration.ProxyCreationEnabled = false;"
*Models>aBaseHistory.cs - sisse kommenteerida konstruktor, kus väärtustatakse kuupäeva väljad
*DAL>User-/Contact-/ContactInfoRepository - Välja kommenteerida "Add" ja "Update" meetodid
Pärast testandmete genereerimist tuleks muudatused tagasi keerata (Undo!)

=Logi=
*<b>2013.03.13</b> – Sai paika pandud XML faili struktuur ja loodud seda genereeriv rakendus.
*<b>2013.03.14</b> – XSLT faili loomine, lisatud „Puuvaade“ näitamaks kõiki sisendeid.
*<b>2013.03.15</b> – XSLT failile inimeste otsing vastavalt kasutaja sisendile lisatud (ainult IE). Sai tehtud XSLT fail XML-i transformeerimiseks teistsuguseks XML-iks ja ka XSLT fail XML-i exceli vorminduse jaoks.
*<b>2013.03.20</b> – XML to HTML otsing töötab nüüd IE, Chrome ja Firefoxiga
**wiki leht loodud,XML wiki lehele lisatud, tehtud stiilifailide näidised
*<b>2013.03.24</b> – Teiste tiimide XML tööde retsenseerimine
*<b>2013.04.25</b> – Alustatud teenuse loomist.
** Teenusele lisatud autentimine.
** Esialgsed mudelid ja DAL (Data-Access-Layer) loodud.
*<b>2013.04.26</b> – Repositooriumite loomine ja baasrepositooriumi täitmine.
** Esialgsete testandmete automaatsisestamise loomine.
*<b>2013.04.27</b> – Autentimine üle viidud isevalmistatud membership- ja role providerite peale.
** Alustatud teenuse meetodite kirjapanemisega.
*<b>2013.04.28</b> – DI (Dependency-Injection) kasutusele võtmine.
** Esimesed teenuse meetodid kirja pandud.
*<b>2013.05.02</b> – Tavakasutajatele mõeldud meetodid kirja pandud, alustatud administraatori meetoditega.
*<b>2013.05.04</b> – Alustatud klientrakenduse loomist. Valmis navigeerimine ja käskluste põhi.
*<b>2013.05.07</b> – Klientrakenduses valmis kõikide kontaktide kuvamise vaade. Teenusele lisatud piltide/failide lisamise/pärimise võimalus.
*<b>2013.05.12</b> – WCF asünkroonsed meetodid asendatud asünkroonsete tööde klientrakenduse poolel.
*<b>2013.05.13</b> – Otsimise võimalus lisatud.
**Administraatori vaade (kasutajate haldus) klientrakendusele lisatud.
**Logimine andmebaasi lisatud.
**Logimise põhjal päringute arvu piirangud lisatud.
*<b>2013.05.15</b> – Klientrakendusele üldine veahalduse lisatud.
*<b>2013.05.16</b> – Teenuse meetodid kommenteeritud.
**Teenuse ja klientrakenduse kohta käiv info Wikisse lisatud.
**Selle logi kirjutamine...