| Both sides previous revision Previous revision | |
| kb:kb:simplehelp_history_izvestaji [2015/11/26 12:07] – 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|http://app.melany.rs:1981/BalansHDDC/HDDC]]. Servis ne podržava GET HTTP metod, ali se na [[http://app.melany.rs:1981/BalansHDDC/HDDC|http://app.melany.rs:1981/BalansHDDC]] dobija link ka ovoj stranici. | 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. | 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, |