kb:kb:simplehelp_history_izvestaji

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
kb:kb:simplehelp_history_izvestaji [2015/11/06 13:05] aleksandarkb:kb:simplehelp_history_izvestaji [2015/11/26 12:13] (current) aleksandar
Line 8: Line 8:
     - 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.
Line 34: Line 34:
 === 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 ===
Line 46: Line 46:
 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.
  
 ---- ----
Line 58: Line 58:
 === 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 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 (š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. Podešavanja se vrše 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>+<code text>
 <configuration> / <appSettings> / <!– programske vrednosti –> <configuration> / <appSettings> / <!– programske vrednosti –>
 </code> </code>
  
-Vrednosti su objašnjene  samom fajlu.+Vrednosti su objašnjene  samom fajlu.
  
-==== Ukoliko niste sigurni šta koje podešavanje radi i kako utiče na rad servisa, ne menjajte ga! ==== +<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>
- +
-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 30 dana.+
  
 === 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.
 +
 +===   ===
  
 Moguće greške u radu servisa su: Moguće greške u radu servisa su:
  
 ^  #  ^  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 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//   |- Ne postoji baza podataka na zadatoj 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)  |
 +
 +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.
  
 ---- ----
  • kb/kb/simplehelp_history_izvestaji.1446815113.txt.gz
  • Last modified: 2015/11/06 13:05
  • by aleksandar