4.

Komponenty a funkcie, ktoré sa používajú počas sekvencie správy, sú uvedené v tabuľkách VIII-3 až VIII-18. Funkcie, ktoré sú verejné, sú implementované ako špecifikované. Funkcie, ktoré sú súkromné, sú určené len na informačné účely. Vstupy všetkých funkcií boli štruktúrované tak, aby zodpovedali požiadavkám na formát a informácie opísaným s použitím jazyka popisu webovej služby uvedeným vo funkčných a technických špecifikáciách pre normy výmeny údajov pre systémy registrov podľa Kjótskeho, protokolu vypracované na základe rozhodnutia 24/CP.8 Konferencie strán zúčastnených na UNFCCC. Hviezdička (*) bola použitá na označenie skutočnosti, že prvok sa môže vyskytnúť viac razy ako vstup. Tabuľka VIII-3: Komponenty a funkcie pre procesy týkajúce sa účtu alebo overených emisií



Komponent Funkcia Sféra MgmtOfAccountWS CreateAccount() Verejná UpdateAccount() Verejná CloseAccount() Verejná UpdateVerifiedEmissions() Verejná ReceiveAccountOperationOutcome() Verejná AccountManagement ValidateAccountCreation() Súkromná CreateAccount() Súkromná ValidateAccountUpdate() Súkromná UpdateAccount() Súkromná ValidateAccountClosure() Súkromná CloseAccount() Súkromná ValidateVerifiedEmissionsUpdate() Súkromná UpdateVerifiedEmissions() Súkromná Data Validation AuthenticateMessage() Súkromná Check Version() Súkromná DataFormatsChecks() Súkromná Tabuľka VIII-4: Komponent MgmtOfAccountWS



Účel Účelom tohto komponentu je nakladať so žiadosťami webovej služby o správu účtov a overených emisií. Funkcie exponované cez webové služby CreateAccount() Nakladá so žiadosťami o vytvorenie účtu UpdateAccount() Nakladá so žiadosťami o aktualizovanie účtu CloseAccount() Nakladá so žiadosťami o zatvorenie účtu UpdateVerifiedEmissions() Nakladá so žiadosťami o aktualizáciu overených emisií. ReceiveAccountOperationOutcome() Prijíma výsledok („akceptované“ alebo „zamietnuté“) operácie s účtom (zriadenie, aktualizácia,…) Iné funkcie Neuplatňujú sa. Úlohy Nezávislý protokol transakcií Spoločenstva (pre všetky funkcie) a registra (len pre funkciu ReceiveAccountOperationOutcome) Tabuľka VIII-5: Funkcia MgmtOfAccountWS.CreateAccount()



Účel Táto funkcia prijíma žiadosť o zriadenie účtu. Nezávislý protokol transakcií Spoločenstva overuje iniciujúci register (vytvárajúci register) vyvolaním funkcie AuthenticateMessage() a kontroluje verziu iniciujúceho registra vyvolaním funkcie CheckVersion(). Ak prejde overenie a kontroly verzie, identifikátor výsledku „1“ sa vráti bez kódov odpovedí, obsah žiadosti sa zapíše do súboru vyvolaním funkcie WriteToFile() a žiadosť sa uloží do radu. Ak overenie alebo kontroly verzií neprejdú, identifikátor výsledku „0“ sa vráti spolu s jedným kódom odpovede označujúcim, že došlo k chybe. Ak osoba (osoby) nie je fyzickou osobou, jej meno sa musí vložiť do parametra Priezvisko. „PersonIdentifier“ znamená identifikačný kód vlastníka účtu obsahujúci prvky uvedené v prílohe VI. „IdentifierInRegistry“ znamená alfanumerický identifikátor pre účet špecifikovaný vlastníkom účtu podľa príloh III a IV. Vstupne parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný Účet (*) Povinný TypÚčtu Povinný IdentifikátorÚčtu Povinný IdentifierInReg Povinný ObdobieViazanosti Nepovinný Zariadenie Nepovinný IdentifikátorZariadenia Povinný IdentifikátorPovolenia Povinný Názov Povinný HlavnýDruhAktivity Povinný Krajina Povinný PSČ Povinný Mesto Povinný Adresa1 Povinný Adresa2 Nepovinný MaterskáSpoločnosť Nepovinný DcérskaSpoločnosť Nepovinný EPERIdentifikácia Nepovinný Zemepisná šírka Nepovinný Zemepisná dĺžka Nepovinný KontaktníĽudia (pozri Ľudia) Mandatory Ľudia (*) Mandatory KódVzájomnéhoVzťahu Mandatory IdentifkátorOsoby Mandatory KrstnéMeno Nepovinný Priezvisko Povinný Krajina Povinný PSČ Povinný Mesto Povinný Adresa1 Povinný Adresa2 Nepovinný ČísloTelefónu1 Povinný ČísloTelefónu2 Povinný ▼M1 ČísloFaxu Voliteľné ▼B Email Povinný Výstupné parametre Identifikátor výsledku Povinný Kód odpovede Nepovinný Použitia — OverSprávu — ZapíšDoSúboru — SkontrolujVerziu Použité (kým) Neuplatňuje sa (vyvolané ako webová služba) Tabuľka VIII-6: Funkcia MgmtOfAccountWS.UpdateAccount()



Účel Táto funkcia prijíma žiadosť o aktualizáciu účtu. Nezávislý protokol transakcií Spoločenstva overuje iniciujúci register (vytvárajúci register) vyvolaním funkcie AuthenticateMessage() a kontroluje verziu iniciujúceho registra vyvolaním funkcie CheckVersion(). Ak prejde overenie a kontroly verzie, identifikátor výsledku „1“ sa vráti bez kódov odpovedí, obsah žiadosti sa zapíše do súboru vyvolaním funkcie WriteToFile() a žiadosť sa uloží do radu. Ak overenie alebo kontroly verzií neprejdú, identifikátor výsledku „0“ sa vráti spolu s jedným kódom odpovede označujúcim, že došlo k chybe. Ak osoba (ľudia) nie je fyzickou osobou, jej meno sa musí vložiť do parametra Priezvisko. „PersonIdentifier“ znamená identifikačný kód vlastníka účtu obsahujúci prvky uvedené v prílohe VI. „IdentifierInRegistry“ znamená alfanumerický identifikátor pre účet špecifikovaný vlastníkom účtu podľa príloh III a IV. Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný Účet (*) Povinný IdentifikátorÚčtu Povinný IdentifikátorInReg Nepovinný Zariadenie Nepovinný IdentifikátorPovolenia Nepovinný Názov Nepovinný HlavnýDruhAktivity Nepovinný Krajina Nepovinný PSČ Nepovinný Mesto Nepovinný Adresa1 Nepovinný Adresa2 Nepovinný MaterskáSpoločnosť Nepovinný DcérskaSpoločnosť Nepovinný EPERIdentifikácia Nepovinný Zemepisná šírka Nepovinný Zemepisná dĺžka Nepovinný KontaktníĽudia (pozri Ľudia) Nepovinný Ľudia (*) Nepovinný Akcia Povinný KódVzájomnéhoVzťahu Povinný IdentifkátorOsoby Povinný KrstnéMeno Nepovinný Priezvisko Nepovinný Krajina Nepovinný PSČ Nepovinný Mesto Nepovinný Adresa1 Nepovinný Adresa2 Nepovinný ČísloTelefónu1 Nepovinný ČísloTelefónu2 Nepovinný ČísloFaxu Nepovinný Email Nepovinný Výstupné parametre Identifikátor výsledku Povinný Kód odpovede Nepovinný Použitia — OverSprávu — ZapíšDoSúboru — SkontrolujVerziu Použité (kým) Neuplatňuje sa (vyvolané ako webová služba) Tabuľka VIII-7: Funkcia MgmtOfAccountWS.CloseAccount()



Účel Táto funkcia prijíma žiadosť o zatvorenie účtu. Nezávislý protokol transakcií Spoločenstva overuje iniciujúci register (vytvárajúci register) vyvolaním funkcie AuthenticateMessage() a kontroluje verziu iniciujúceho registra vyvolaním funkcie CheckVersion(). Ak prejde overenie a kontroly verzie, identifikátor výsledku „1“ sa vráti bez kódov odpovedí, obsah žiadosti sa zapíše do súboru vyvolaním funkcie WriteToFile() a žiadosť sa uloží do radu. Ak overenie alebo kontroly verzií neprejdú, identifikátor výsledku „0“ sa vráti spolu s jedným kódom odpovede označujúcim, že došlo k chybe. Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný Účet (*) Povinný IdentifikátorÚčtu Povinný Výstupné parametre Identifikátor výsledku Povinný Kód odpovede Nepovinný Použitia — OverSprávu — ZapíšDoSúboru — SkontrolujVerziu Použité (kým) Neuplatňuje sa (vyvolané ako webová služba) Tabuľka VIII-8: Funkcia MgmtOfAccountWS.UpdateVerifiedEmissions()



Účel Táto funkcia prijíma žiadosť o aktualizáciu overených emisií. Nezávislý protokol transakcií Spoločenstva overuje iniciujúci register (vytvárajúci register) vyvolaním funkcie AuthenticateMessage() a kontroluje verziu iniciujúceho registra vyvolaním funkcie CheckVersion(). Ak prejde overenie a kontroly verzie, identifikátor výsledku „1“ sa vráti bez kódov odpovedí, obsah žiadosti sa zapíše do súboru vyvolaním funkcie WriteToFile() a žiadosť sa uloží do radu. Ak overenie alebo kontroly verzií neprejdú, identifikátor výsledku „0“ sa vráti spolu s jedným kódom odpovede označujúcim, že došlo k chybe. Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný OverenéEmisie (*) Povinný Rok Povinný Zariadenia (*) Povinný IdentifikátorZariadenia Povinný OverenáEmisia Povinný Výstupné parametre Identifikátor výsledku Povinný Kód odpovede Nepovinný Použitia — OverSprávu — ZapíšDoSúboru — SkontrolujVerziu Použité (kým) Neuplatňuje sa (vyvolané ako webová služba) Tabuľka VIII-9: Funkcia MgmtOfAccountWS.ReceiveAccountOperationOutcome()



Účel Táto funkcia prijíma výsledok operácie správy účtu. ►M1 Iniciujúci register (vytvárajúci register) overuje pravosť nezávislého protokolu transakcií UNFCCC (alebo nezávislého protokolu transakcií Spoločenstva, ak sa všetky postupy uvedené v prílohe VIII uskutočnia výmenou údajov cez nezávislý protokol transakcií Spoločenstva) vyvolaním funkcie Authenticate Message() a verziu protokolu transakcií skontroluje vyvolaním funkcie Check Version(). ◄ Ak prejde overenie a kontroly verzie, identifikátor výsledku „1“ sa vráti bez kódov odpovedí, obsah žiadosti sa zapíše do súboru vyvolaním funkcie WriteToFile() a žiadosť sa uloží do radu. Ak overenie alebo kontroly verzií neprejdú, identifikátor výsledku „0“ sa vráti spolu s jedným kódom odpovede označujúcim, že došlo k chybe. Zoznam kódov odpovedí sa obsadí dvojicami (priľahlé kódy odpovedí účtu alebo identifikátora zariadenia), ak výsledkom je „0“, pre každý ďalší dôvod chyby. Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný Výsledok Povinný Zoznam odpovedí Nepovinný Výstupné parametre Identifikátor výsledku Povinný Kód odpovede Nepovinný Použitia — OverSprávu — ZapíšDoSúboru — SkontrolujVerziu Použité (kým) Neuplatňuje sa (vyvolané ako webová služba) Tabuľka VIII-10: Komponent AccountManagement



Účel Účelom tohto komponentu je poskytovať potvrdzujúce a aktualizujúce funkcie pre správu účtov a overené emisie. Funkcie exponované cez webové služby Neuplatňujú sa. Iné funkcie ValidateAccountCreation() Potvrdzuje zriadenie účtu ValidateAccountUpdate() Potvrdzuje aktualizáciu účtu ValidateAccountClosure() Potvrdzuje zatvorenie účtu ValidateVerifiedEmissionsUpdate() Potvrdzuje aktualizáciu overených emisií CreateAccount() Zriaďuje účty UpdateAccount() Aktualizuje účty CloseAccount() Zatvára účtu UpdateVerifiedEmissions() Aktualizuje overené emisie pre zariadenia Úlohy Protokol transakcií (všetky funkcie), register (len pre informáciu) Tabuľka VIII-11: Funkcia ManagementOfAccount.ValidateAccountCreation()



Účel Táto funkcia potvrdzuje žiadosť o zriadenie účtu. Ak potvrdzujúci test neprejde, identifikátor účtu a kód odpovede budú pridané do zoznamu kódov odpovedí. Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný Účet (*) Povinný TypÚčtu Povinný IdentifikátorÚčtu Povinný IdentifikátorInReg Povinný ObdobieViazanosti Nepovinný Zariadenie Nepovinný IdentifikátorZariadenia Povinný IdentifikátorPovolenia Povinný Názov Povinný HlavnýDruhAktivity Povinný Krajina Povinný PSČ Povinný Mesto Povinný Adresa1 Povinný Adresa2 Nepovinný MaterskáSpoločnosť Nepovinný DcérskaSpoločnosť Nepovinný EPERIdentifikácia Nepovinný Zemepisná šírka Nepovinný Zemepisná dĺžka Nepovinný KontaktníĽudia (pozri Ľudia) Povinný Ľudia (*) Povinný KódVzájomného Vzťahu Povinný IdentifkátorOsoby Povinný KrstnéMeno Nepovinný Priezvisko Povinný Krajina Povinný PSČ Povinný Mesto Povinný Adresa1 Povinný Adresa2 Nepovinný ČísloTelefónu1 Povinný ČísloTelefónu2 Nepovinný ▼M1 ČísloFaxu Voliteľné ▼B Email Nepovinný Výstupné parametre Identifikátor výsledku Povinný Zoznam odpovedí Nepovinný Správy Rozsah od 7101 do 7110; rozsah od 7122 do 7160; ►M1 7162. ◄ Tabuľka VIII-12: Funkcia ManagementOfAccount.CreateAccount()



Účel Táto funkcia vytvára účty. Pre každý účet: Vytvor účet a jeho podrobné údaje. Vytvor všetky osoby (ľudí) a ich podrobné údaje, ak ešte neexistovali a prepoj ich s účtom. Aktualizuj všetky informácie súvisiace s osobami (ľuďmi), ktorí už existovali a ktorí súvisia s účtom Vytvor zariadenie a podrobné údaje o zariadení, ak zariadenie súvisí s účtom Vytvor všetky osoby (ľudí) súvisiacich so zariadením (kontaktná osoba), ak ešte neexistovali Aktualizuj všetky informácie súvisiace s osobami (ľuďmi), ktorí už existovali a ktorí súvisia so zariadením. Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný Účet (*) Povinný TypÚčtu Povinný IdentifikátorÚčtu Povinný IdentifikátorInReg Povinný ObdobieViazanosti Nepovinný Zariadenie Nepovinný IdentifikátorZariadenia Povinný IdentifikátorPovolenia Povinný ▼M1 Dátum povolenia Povinný ▼B Názov Povinný HlavnýDruhAktivity Povinný Krajina Povinný PSČ Povinný Mesto Povinný Adresa1 Povinný Adresa2 Nepovinný MaterskáSpoločnosť Nepovinný DcérskaSpoločnosť Nepovinný EPERIdentifikácia Nepovinný Zemepisná šírka Nepovinný Zemepisná dĺžka Nepovinný KontaktníĽudia (pozri Ľudia) Povinný Ľudia (*) Povinný KódVzájomného Vzťahu Povinný IdentifkátorOsoby Povinný KrstnéMeno Nepovinný Priezvisko Povinný Krajina Povinný PSČ Povinný Mesto Povinný Adresa1 Povinný Adresa2 Nepovinný ČísloTelefónu1 Povinný ČísloTelefónu2 Nepovinný ▼M1 ČísloFaxu Voliteľné ▼B Email Nepovinný Výstupné parametre Identifikátor výsledku Povinný Použitia Neuplatňujú sa. Použité (kým) Neuplatňuje sa (vyvolané ako webová služba) Tabuľka VIII-13: Funkcia AccountManagement.ValidateAccountUpdate()



Účel Táto funkcia potvrdzuje žiadosť o aktualizáciu účtu. Ak potvrdzujúci test neprejde, identifikátor účtu a kód odpovede budú pridané do zoznamu kódov odpovedí. Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný Účet (*) Povinný IdentifikátorÚčtu Povinný IdentifikátorInReg Nepovinný Zariadenie Nepovinný IdentifikátorPovolenia Nepovinný ▼M1 Dátum povolenia Voliteľný ▼B Názov Nepovinný HlavnýDruhAktivity Nepovinný Krajina Nepovinný PSČ Nepovinný Mesto Nepovinný Adresa1 Nepovinný Adresa2 Nepovinný MaterskáSpoločnosť Nepovinný DcérskaSpoločnosť Nepovinný EPERIdentifikácia Nepovinný Zemepisná šírka Nepovinný Zemepisná dĺžka Nepovinný KontaktníĽudia (pozri Ľudia) Nepovinný Ľudia (*) Nepovinný Akcia Povinný KódVzájomného Vzťahov Povinný IdentifkátorOsoby Povinný KrstnéMeno Nepovinný Priezvisko Nepovinný Krajina Nepovinný PSČ Nepovinný Mesto Nepovinný Adresa1 Nepovinný Adresa2 Nepovinný ČísloTelefónu1 Nepovinný ČísloTelefónu2 Nepovinný ČísloFaxu Nepovinný Email Nepovinný Výstupné parametre Identifikátor výsledku Povinný Zoznam odpovedí Nepovinný Správy Rozsah od 7102 do 7107; rozsah od 7111 do 7113; 7120; 7122; 7124; rozsah od 7126 do 7158. Tabuľka VIII-14: Funkcia ManagementOfAccount.CreateAccount()



Účel Táto funkcia aktualizuje údaje o účte. Ak akcia = „Add“, Pre každé spojenie sa pridá: Ak osoba (ľudia) existovali, aktualizuj ich podrobné údaje v prípade potreby. Ak osoba (ľudia) neexistovali, vytvor osobu (ľudí) a spoj ich s účtom. Ak akcia = „Update“, Aktualizovať pre všetky osoby (ľudí) a u tých, čo sú spojení s účtom, aktualizuj ich podrobné údaje. Ak akcia = „Delete“, Odstráň spojenie medzi osobami (ľuďmi) a účtom. (Napríklad, odstraňuje sa dodatočný splnomocnený zástupca). Ak je zariadenie spojené s účtom, aktualizuj podrobné údaje zariadenia v prípade potreby. Aktualizuj údaje osôb (ľudí) spojených so zariadením, ak boli predložené podrobné údaje (s použitím tých istých akcií „Add“, „Update“ a „Delete“). Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný Účet (*) Povinný TypÚčtu Povinný IdentifikátorÚčtu Povinný IdentifikátorInReg Povinný Zariadenie Nepovinný IdentifikátorZariadenia Povinný IdentifikátorPovolenia Povinný ▼M1 Dátum povolenia Povinný ▼B Názov Povinný HlavnýDruhAktivity Povinný Krajina Povinný PSČ Povinný Mesto Povinný Adresa1 Povinný Adresa2 Nepovinný MaterskáSpoločnosť Nepovinný DcérskaSpoločnosť Nepovinný EPERIdentifikácia Nepovinný Zemepisná šírka Nepovinný Zemepisná dĺžka Nepovinný KontaktníĽudia (pozri Ľudia) Povinný Ľudia (*) Povinný KódVzájomného Vzťahov Povinný IdentifkátorOsoby Povinný KrstnéMeno Nepovinný Priezvisko Povinný Krajina Povinný PSČ Povinný Mesto Povinný Adresa1 Povinný Adresa2 Nepovinný ČísloTelefónu1 Nepovinný ČísloTelefónu2 Nepovinný ČísloFaxu Nepovinný Email Nepovinný Výstupné parametre Identifikátor výsledku Povinný Použitia Neuplatňujú sa. Použité (kým) Neuplatňuje sa (vyvolané ako webová služba) Tabuľka VIII-15: Funkcia ManagementOfAccount.ValidateAccountClosure()



Účel Táto funkcia potvrdzuje operáciu zatvorenia účtu. Ak potvrdzujúci test neprejde, identifikátor účtu a kód odpovede sú pridané do zoznamu kódov odpovedí. Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný Účet (*) Povinný Účel IdentifikátorÚčtu Povinný Výstupné parametre Identifikátor výsledku Povinný Zoznam odpovedí Nepovinný Správy 7111; rozsah od 7114 do 7115; 7117; rozsah od 7153 do 7156; 7158; ►M1 7161. ◄ Tabuľka VIII-16: Funkcia ManagementOfAccount.CloseAccount()



Účel Táto funkcia zatvára účet alebo účty nastavením konečného dátumu platnosti účtu (účtov) tak, aby bol zavretý k priebežnému dátumu. Vstupné parametre Register Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný Účet (*) Povinný IdentifikátorÚčtu Povinný Výstupné parametre Identifikátor výsledku Povinný Tabuľka VIII-17: Funkcia ManagementOfAccount.ValidateVerifiedEmissionsUpdate()



Účel Táto funkcia potvrdzuje aktualizáciu overených emisií. Ak potvrdzujúci test neprejde, identifikátor účtu a kód odpovede sú pridané do zoznamu kódov odpovedí. Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný VedľajšiaVerzia Povinný OverenéEmisie (*) Povinný Rok Povinný Zariadenia (*) Povinný IdentifikátorZariadenia Povinný OverenáEmisia Povinný Výstupné parametre Identifikátor výsledku Povinný Zoznam odpovedí Nepovinný Správy Rozsah od 7118 do 7119; rozsah od 7152 do 7156; 7159; ►M1 7525. ◄ Tabuľka VIII-18: Funkcia ManagementOfAccount.UpdateVerifiedEmissions



Účel Aktualizuje overené emisie za rok a pre špecifikované zariadenia. Vstupné parametre Od Povinný Do Povinný CorrelationId Povinný HlavnáVerzia Povinný OverenéEmisie (*) Povinný Rok Povinný Zariadenia (*) Povinný IdentifikátorZariadenia Povinný OverenáEmisia Povinný Výstupné parametre Identifikátor výsledku Povinný