====== SimpleHelp History i MS Balans ======

===== Ciljevi =====

U saradnji sa kolegama iz "MelanySoft", dogovorene su sledeće specifikacije i zahtevi za izveštajima koji se generišu na osnovu podataka iz Melany baze podataka:

    - Postojanje filtera po datumu (od - do), ne samo po mesecu, već i po proizvoljnim periodima;
    - Prikaz isključivo podataka koji se tiču "Melany Soft" članova podrške (Ljubiša, Tomislav, Jelena, Aleksandar Dimitrijević) i, po potrebi, ostalih zaposlenih u "Melany Soft" iz Srbije;
    - Sabiranje vremena trajanja intervencija po a) firmi i b)operateru;
    - //Technician/End summary//     podatak treba da predstavlja obrazloženje intervencije putem SimpleHelp Technician programa (tekst Servisnog izveštaja);
    - Treba da postoji mogućnost da svaki operater ima prikaz po a)firmi i po b)mesecu,odnosno izabranom periodu.

===== Alatke za manipulaciju SHH podacima =====

Preduslov za gornje ciljeve jeste prvo pravljenje mehanizma koji će različito formatirane izveštaje //SimpleHelp Technician//     programa da pretvori u istovetan format i da podatke upiše u bazu podataka. Za to su napravljene dve alatke:

    * program __**S**__**impleHelp __H__istory __A__nalyzer**.(**SHA**) i
    * internet servis **Balans __H__elp__D__esk __D__ata __C__ollector **    (**BalansHDDC**,** HDDC**).

Predvidjeno je da se manipulacija podacima prvenstveno obavlja automatski tako što će SimpleHelp Technician slati podatke o intervencijama na server na kojem ih dočekuje i obradjuje BalansHDDC web servis. SHA je rezervno rešenje koje obradjuje podatke dodate ručno, odnosno, čita ih iz lokalnih fajlova izvezenih iz SImpleHelp Technician.

----

===== SimpleHelp Analyzer program =====

Prozor programa sa dostupnim komandama

[[:kb:slike:sha.png?id=kb:kb:simplehelp_history_izvestaji&media=kb:slike:sha.png|{{:kb:slike:sha.png?nolink&1072x593  }}]]

===   ===

----

=== PREDUSLOVI ===

//SimpleHelp History Analyzer//      program je pravljen u Visual C# programskom jeziku i da bi se koristio, neophodan je .NET Framework v4.5 prethodno instaliran na računaru.

=== UPOTREBA ===

Upotreba programa je jednostavna: Unese se broj direktorijuma gde se se nalazi Melany baza podataka (u okviru Balans<nowiki>\</nowiki>Data ili Data20 direktorijuma ili vrednosti u OkrMain), zatim se otvore ili prevuku u prozor SimpleHelp History XML fajlovi (ekstenzije .xml i .shh). Podaci koji će se uvesti u bazu podataka su predstavljeni u tabeli koja se popuni i mogu da se pregledaju. SHA ne dozvoljava izmenu podataka, to mora da se obavi u SimpleHelp History fajlovima pre otvaranja istih u programu.

Ako podaci zadovoljavaju uslove, klikom na dugme "Uvezi u Balans" podaci će biti upisani u bazu podataka koja već ima potrebne tabele. U slučaju duplih vrednosti, program pita šta da radi (brisanje starih i upis novih, upis samo novih ili odustajanje od cele operacije). Kada se podaci uvoze iz nekoliko puta, preporuka je da se koristi dugme "Očisti tabelu prikaza", kako bi se već uvezeni podaci sklonili.

Ove operacije se ponavljaju onoliko puta koliko je potrebno.

Time se korišćenje programa završava.

**NAPOMENA:**      Program proverava tip fajla koji se otvara. Ako prijavi takvu grešku, to znači da SHA nešto ne shvata u otvorenom fajlu. Problem može da bude samo banalna sintaksna greška u .shh, ali i slučaj kada se distribuira arhiva u arhivi (zip u zipu) gde upakovana arhiva nema ekstenziju, pa korisnik ne prepozna da treba i taj fajl da otpakuje kako bi zapravo dobio kolekciju SimpleHelp History.

----

===== Balans HelpDesk Data Collector =====

=== PREDUSLOVI ===

BalansHDDC  je web servis pisan u Visual C# v4.0 programskom jeziku. Da bi se koristio, potreban je Windows operativni sistem na kojem su instalirani Internet Information Server i .NET Framework v4.0 koji je izabran zbog veće kompatibilnosti sa i dalje popularnim verzijama Majkrosoftovih operativnih sistema (Windows XP, 2003).

=== UPOTREBA ===

BalansHDDC je automatizovan sistem koji ne zahteva interakciju korisnika za rad. Sve što je potrebno jeste postavljanje BalansHDDC kao aktivnog web servisa hostovanog pod IIS na Windows okruženju i dodela javnog URI, a zatim podešavanje SimpleHelp Technician programa da izveštaje šalje u XML načinu zapisa na dodeljeni URI. Servis obradjuje identičan skup podataka iz pristiglih fajlova kao i SimpleHelp History Analyzer. \\ NAPOMENA: Kako se IIS procesi pokreću pod korisničkim nalogom koji je podrazumevano lokalnog tipa, u domenskim okruženjima, kakvo je kod nas, potrebno je, u slučaju da je baza podataka na drugom računaru, obezbediti da "korisnik" pod kojim se pokreće BalansHDDC servis ima pristup mrežnoj putanji do baze (u ovom slučaju, putem DCOM protokola).

Virtuelna putanja web aplikacije na serveru mora da ima sufiks **/HDDC**, npr. [[http://www.melany.rs/BalansHDDC/HDDC|http://www.melany.rs/BalansHDDC/HDDC]]. Trenutna adresa je [[http://app.melany.rs:1981/BalansHDDC/HDDC|http://app.melany.rs:1981/BalansHDDC/HDDC]]. Servis ne podržava GET HTTP metod (što i saopštava), ali se na [[http://app.melany.rs:1981/BalansHDDC/HDDC|http://app.melany.rs:1981/BalansHDDC]] dobija link ka ovoj stranici.

Servis je fizički smešten na MelSRV računar u okviru Melany Intraneta.

=== PODEŠAVANJA ===

Iako BalansHDDC ne zahteva ljudsku interakciju za rad, ona jeste potrebna za podešavanje servisa. Neka podešavanja su dostupna i vrše se manuelno, izmenom **Web.config**    fajla koji se nalazi na fizičkoj putanji na kojoj je i servis, npr. C:\inetpub\wwwroot\BalansHDDC. Sekcija koja sadrži podešavanja je

<code text>
<configuration> / <appSettings> / <!– programske vrednosti –>
</code>

Vrednosti su objašnjene u  samom fajlu.

<font 17px:bold/Arial;;#000000;;inherit>Ukoliko niste sigurni šta koje podešavanje radi i kako utiče na rad servisa, ne menjajte ga!</font>

=== GREŠKE ===

Prijava grešaka, na koje BalansHDDC naidje pri obradi podataka, se vrši putem elektronske pošte. Podrazumevan adresa na koji poruke stižu je **aleksandar@melany.rs**, a po potrebi, može da se doda, teoretski, beskonačan broj adresa.    \\ Osim slanja elektronskom poštom, BalansHDDC upisuje sve greške u //Log fajl//    serverskog operativnog sistema pod putanjom **C:\temp\**, u fajl **balanshddc.log**. Log fajl se arhivira svakih sedam, a arhive se čuvaju 90 dana. Nazivi arhiva logova počinju sa log_ i imaju ekstenziju .old.

===   ===

Moguće greške u radu servisa su:

^  #  ^  Greška  ^  Opis  ^  HTTP Odgovor koji se vraća SimpleHelp-u  |
^1 |  //Primljen je prazan sadržaj//   |Servis čita poslati sadržaj kao prazan. Uzroci su:      \\   \\ - Stvarno ništa nije poslato u telu zahteva (//Content-Length: 0//),      \\ - //Content-Type// deo zaglavlja HTTP zahteva ne postoji ili nije __text/xml__ ili __application/xml__, što automatski ignoriše bilo kakav sadržaj      \\ - XML sadržaj nije dobro formiran (vrednost van taga, nedostajuća tag oznaka,…)                              \\  \\ Ili kombinacija ova tri. |  411 (Length Required)  |
^  2 |  //Nedozvoljen glavni čvor XMLa//   |BalansHDDC koristi glavni čvor poslatog XMLa da bi identifikovao koje podčvorove i koje njihove vrednosti da obradi.      \\ Trenutno se očekuju glavni čvorovi naziva <//AccessSessionSummaryEvent>// i <//SupportSessionSummaryEvent>.//  |  400 (Bad Request)  |
^  3 |  //Poslati sadržaj nije dobro formiran//   |<nowiki>*</nowiki><nowiki>*</nowiki><nowiki>*</nowiki>Zastarelo<nowiki>*</nowiki><nowiki>*</nowiki><nowiki>*</nowiki> ne očekuje se da će se ova poruka javiti u produkcionom radu. Postoji kao osiguranje. |  415 (Unsupported Media Type)// \\  //   |
^4 |  //Nema Melany baze podataka//   |   \\ Aplikacija ne pronalazi bazu podataka firme Melany Team D.O.O. Neki od mogućih uzroka ove poruke:          \\   \\ - Ne postoji baza podataka na očekivanoj putanji,              \\ - Baza podataka se nalazi na mrežnoj putanji za koju ne postoje potrebna ovlašćenja (kredencijali),          \\ - Baza podataka nije baza firme Melany Team d.o.o.  |  417 (Expectation Failed)  |
^5 |  //Neuspelo upisivanje u bazu//   |Melany baza podataka postoji, ali je došlo do greške pri upisu podataka. Uzrok može da potiče još od izvorno poslatih podataka. |  409 (Conflict)  |

KOMENTAR: Pored ovih navedenih grešaka, koje se beleže i kritične su za rad sevisa, postoje još "greške" koje služe za ignorisanje obrade podataka na osnovu postavljenih kriterijuma. Korisnik ne vidi niti treba da se bavi ovim porukama, one služe samo za pravilan rad servisa.

----

===== Izrada izveštaja u MS Balansu =====

Izveštaj o SimpleHelp History podacima se nalazu u okviru Prozora "//Izveštaji//", grupa "//Servis//". Naziv izveštaja je _fckg_QUOT___SimpleHelp History Izvestaj__". Izveštaj traži sledeće ulazne podatke:

    * Početni datum posmatranog perioda,
    * Krajnji datum posmatranog perioda,
    * (Opciono) Ime operatera ,
    * (Opciono) Naziv firme.

Ako se poslednja dva parametra izostave, prikazaće se podaci o svim intervencijama u posmatranom periodu.

Dalje filtriranje izveštaja se vrši pomoću stabla grupa (Group Tree), ikona je u gornjem levom uglu [[:kb:slike:grouptree.png?24x23}}|grouptree.png]], najpre po firmama, pa po operaterima.

Izveštaj se oslanja na podatke iz tabele **ACCImports**.

----

\\