|  Both sides previous revision Previous revision Next revision |  Previous revision | 
| kb:kb:simplehelp_history_izvestaji [2015/11/26 09:32]  – [Izrada izveštaja u MS Balansu]  aleksandar | kb:kb:simplehelp_history_izvestaji [2015/11/26 12:13] (current)  –  aleksandar | 
|---|
|     - 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; |     - 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; |     - 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); |     - //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. |     - 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 ===== | ===== 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: | 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 |     * program __**S**__**impleHelp __H__istory __A__nalyzer**.(**SHA**) i | 
|     * internet servis **Balans __H__elp__D__esk __D__ata __C__ollector **     (**BalansHDDC**,** HDDC**). |     * 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. | 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. | 
| === PREDUSLOVI === | === 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. | //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 === | 
| Time se korišćenje programa završava. | 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. | **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. | 
 |  | 
| ---- | ---- | 
| === UPOTREBA === | === 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. | 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 | 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 === | === 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 | 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> | <code text> | 
| === GREŠKE === | === 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. | 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. | 
 |  | 
| ===   === | ===   === | 
 |  | 
| ^  #  ^  Greška  ^  Opis  ^  HTTP Odgovor koji se vraća SimpleHelp-u  | | ^  #  ^  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)  |  | ^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)  | | ^  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)// \\  //   | | ^  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)  | | ^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)  | | ^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)  | | 
 |  | 
| ===== Izrada izveštaja u MS Balansu ===== | ===== 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 "__SimpleHelp History Izvestaj__". Izveštaj traži sledeće ulazne podatke: | 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, |     * Početni datum posmatranog perioda, | 
 |  | 
| ---- | ---- | 
|   |  | 
|   | \\ | 
 |  |