Kaseya 2. User Guide. Version 6,0

Transkript

1 Kasya 2 VSA API Wb Srvic Usr Guid Vrsion 6,0 Jun 11, 2010

2 Abou Kasya Kasya is a global providr of IT auomaion sofwar for IT Soluion Providrs and Public and Priva Scor IT organizaions. Kasya's IT Auomaion Framwork allows IT Profssionals o proacivly monior, manag and mainain disribud IT infrasrucur rmoly, asily and fficinly wih on ingrad Wb basd plaform. Kasya's chnology is licnsd on ovr hr million machins worldwid. Copyrigh Kasya Inrnaional Limid. All Righs Rsrvd.

3 Conns VSA-API-Wbdins 5 VSA-API-Wbdins - Übrsich... 7 VSA-API-Wbdins akivirn... 8 Spzill Fldr... 8 VSA-API-Wbdins-Bispil-Clin - C# GUI-Anwndung VSA-API-Wbdins-Bispil-Clin - ASP-Si VSA-API-Wbdins - Sichrhi Wb-Links - Einghnd und ausghnd VSA-API-Wbdins - Vorgäng AddMachGroupoScop AddOrg AddOrgDpSaff AddOrgToScop AddScop AddScopOrg AddTicRqus AddUsrToRol AddUsrToScop AdminGroupAccss AssignRol AssignScop Auhnica ClosAlarm CraAdmin CraAgnInsallPackag CraMachinGroup CraRol DlAdmin DlAgn DlAgnInsallPackag DlMachinGroup DlOrg DlRol DlScop DisablAdmin Echo EchoM EnablAdmin GAlarm GAlarmLis GGroupLicnsInfo GLogEnry GMachin GMachinCollcionLis GMachinGroupLis GMachinLis GMachinUpim GNosLis GOrgLocaion GOrgs i

4 GOrgsByScopID GOrgTyps GPackagURLs GParnrUsrLocaion GPublishdViwColumns GPublishdViwRows GPublishdViws GRols GScops GTick GTickLis GTickNos GTicRqusTick GVrbosMachinGroupLis LockFuncionAccss Primiiv RmovUsrFromRol RsPassword RolMmbrship SndAdminMssag SAdminPassword SGroupLicnsInfo SParnrUsrLocaion UpdaOrg UpdaTick UpdaUsr KSD-API-Wbdins 49 KSD-API-Wbdins akivirn Danypn ds KSD-API-Wbdinss RfIm CusomFild No Aachmn RladIncidn SrvicDskDfiniion IncidnSummary Incidn KSD-API-Wbdins Vorgäng AddIncidn AddSrvDskToScop GIncidn GIncidnLis GSrvicDsk GSrvicDsks Primiiv UpdaIncidn Probnachrichn GSrvicDsks Rqus GSrvicDsks Rspons GSrvicDsk Rqus GSrvicDsk Rspons GIncidnLis Rqus GIncidnLis Rspons GIncidn Rqus ii

5 GIncidn Rspons AddIncidn Rqus AddIncidn Rspons UpdaIncidn Rqus UpdaIncidn Rspons iii

6

7 K a p i l 1 VSA-API-Wbdins In dism Kapil VSA-API-Wbdins - Übrsich 7 VSA-API-Wbdins - Vorgäng 19 5

8

9 VSA-API-Wbdins VSA-API-Wbdins - Übrsich Dr VSA-API-Wbdins sll in infach Obrfläch für inn Clin zur Vrfügung, um in Programmschnisll zum VSA brizuslln. Dank disr API kann in Clin in Vrbindung zu inr Anwndung ins Drianbirs hrslln. Di API konznrir sich auf di folgndn Dins: Vrbindung Disr Dins rmöglich dm Bnuzr dr API, sich zu auhnifizirn und in GUID zu rhaln, di r währnd dr gsamn Kommunikaion vrwndn kann. Di GUID kann auf di glich Wis wi auch in Bnuzr vraln. Ticks Disr Dins sll grundlgnd Funkionn zur Vrfügung, um dn Bnuzr übr nu Ticks zu bnachrichign. Mi disr Funkion könnn Bnuzr Fldr auf inm Tick akualisirn. Alarm Disr Dins sll grundlgnd Funkionn zur Vrfügung, um dn Bnuzr übr nu Alarm zu bnachrichign und inn Alarm als gschlossn zu markirn. Rchnr Disr Dins sll in Anfordrung zur Vrfügung, in Grupp von Dan übr inn odr mhrr Rchnr zu sammln. Dr VSA-API -Wbdins basir auf dr Wb Srvics Dscripion Languag (WSDL). Di WSDL wird in inm Browsr angzig und sll in absrak Bschribung dr Dan zur Vrfügung, di mi inm Wbdins ausgausch wrdn könnn. Ein Clin-Programm, das in Vrbindung zu inm Wbdins hrsll, kann übr di WSDL ablsn, wlch Funkionn auf dm Srvr zur Vrfügung shn. Evnull vrwnd spzill Danypn wrdn in dr WSDL-Dai in Form ins XML-Schmas ingb. Dr Clin kann dann mihilf ds SOAP in dr auf dr WSDL aufglisn Funkionn aufrufn. 7

10 VSA-API-Wbdins Es folg in Bispil inr vsaws-ausgab: VSA-API-Wbdins akivirn So akivirn Si dn VSA-API-Wbdins: Zign Si di Si Sysm > Konfigurirn im VSA an. Akivirn Si das Konrollkäschn VSA-API-Wbdins akivirn. Zugriff auf dn VSA-API-Wbdins übr hp://<your-ksrvr>/vsaws/kasyaws.asmx Hinwis: Im KSD-API-Wbdins wrdn wir Srvic Dsk API-Vorgäng bschribn. Spzill Fldr Di folgndn Fldr wrdn in di Anwor auf jd Anfordrung ingschlossn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. 8

11 VSA-API-Wbdins Es wird in Sizungs-ID vom Wbdins rsll und an dn Clin zurückggbn, wnn in Mhod rsmals vom Clin aufgrufn wird. Di glich Sizungs-ID muss mi jdr in disr Sizung aufgrufnn Mhod vom Clin zurückggbn wrdn. Di Sizungs-ID is nur gülig, wnn si von dr glichn IP-Adrss rhaln wird, auf dr auch di Auhnifizirung safand. 9

12 VSA-API-Wbdins VSA-API-Wbdins-Bispil-Clin - C# GUI-Anwndung Ein GUI-Ts-Clin sowi in Grupp von Ts-XMLs wrdn zusammn mi dm VSA-API-Wbdins vril, um Ihnn zu hlfn, sich mi dn vrschidnn API-Vorgängn vrrau zu machn. Dr C#-Qullcod für dn VSA-API-Wbdins-Bispil-Clin wird Ihnn ohn jglich Einschränkungn zur Vrfügung gsll. Si könnn daraus rshn, wi dr Clin konsruir wurd, und auch blibig Til diss Cods in Ihr ign Anwndung ingrirn. Hinwis: Ein ASP-Sinx-Clin (Si 11) wird bnfalls brigsll. So führn Si dn Bispil-Clin aus: 1. Führn Si dn Bispil-Clin auf Ihrm KSrvr aus: <Insall Dir>\vsaWs\TsClin\KasyaWSsClin.x 2. Gbn Si dn Bnuzrnamn und das Passwor ins Bnuzrs in, dr auorisir is, in Vrbindung zum KSrvr hrzuslln. Hinwis: Dis is dr glich Bnuzrnam und das Passwor, das in Adminisraor für di Anmldung bim KSrvr vrwnd. 3. Klickn Si auf di Schalfläch Anmldn, um inn Wr im Fld Sizungs-ID anzuzign. 4. Klickn Si auf Durchsuchn, um in XML-Tsdai auszuwähln. Dadurch wird dr Tx dr XML-Dai in das Txfld SndXML ingragn. Hinwis: Si brauchn kinn Wr zwischn di <SssionID>-Elmn-Tags dr XML-Nachrich inzugbn. Dr Bispil-Clin füg auomaisch di angzig Sizungs-ID in jd XML-Nachrich in, sobald Si auf di Schalfläch Sndn klickn. 5. Klickn Si auf Sndn, um di XML-Nachrich an di Zil-URL zu sndn. Im Txfld RsponsXML wird in XML-Anwornachrich angzig. 10

13 VSA-API-Wbdins VSA-API-Wbdins-Bispil-Clin - ASP-Si Ein Ts-Clin-ASP-Si wird bnfalls mi dm VSA-API-Wbdins vril, um Ihnn zu hlfn, sich mi dn vrschidnn API-Vorgängn vrrau zu machn. Si könnn daraus rshn, wi dr ASP-Clin konsruir wurd, und auch blibig Til diss Cods in Ihr ign Anwndung ingrirn. Bnuzr könnn zu dr asächlichn /vsaws/kasyaws.asmx-si ins blibign KSrvrs blärn, in Wbmhod auswähln und di gnauso in dr WSDL anggbn XML SOAP-Anfordrungssrukur kopirn und infügn. Di Auhnifizirung find in inm ignn Rahmn am obrn Rand dr Si sa. Di Sizungs-ID inr rfolgrichn Auhnifizirung wird angzig und kann kopir und in nachfolgnd XML-Anfordrungn ingfüg wrdn. Hinwis: Dis Si schliß nich auomaisch di angzig Sizungs-ID in nachfolgnd Anfordrungsanwisungn in, wi dis bim C# GUI-Ts-Clin (Si 10) dr Fall is. Bispil 1: Auhnifizirung 1. Zugriff auf dn VSA-API-Wbdins ASP-Ts-Clin übr hp://<your-ksrvr>/vsaws/tsclin/tsclin.asp 2. Gbn Si inn gülign Bnuzrnamn und das Passwor ins VSA-Adminisraors in und klickn Si auf 'Anmldn'. In das Txfld dr Sizungs-ID wird di bi Ihrr Anmldung gnrir Sizungs-ID ingragn. Si müssn dis Sizungs-ID kopirn und in nachfolgnd XML-Anfordrungn infügn. 11

14 VSA-API-Wbdins Bispil 2 - Abrufn-Anfordrung rslln 1. Vrwndn Si in inm zwin Browsr-Fnsr di Si /vsaws/kasyaws.asmx, um in Mhod wi bispilswis GLogEnry auszuwähln. 2. Jd Mhod zig di XML SOAP-Srukur für di Anfordrung disr Mhod an. Kopirn Si nur dn Til dr Anfordrungssrukur disr Mhod, dr mi <rq> bginn und mi </rq> nd. 12

15 VSA-API-Wbdins 1. Fügn Si di Anfordrungssrukur in dn Brich 'Anfordrung' dr Si 'TsClin.asp' in. Gbn Si dn Namn dr Mhod in das Fld 'Nam' dr Wbmhod in. Erszn Si dn Plazhalr 'Dzimalwr' durch di Sizungs-ID, di Si währnd dr Auhnifizirung rhaln habn. Erszn Si nach Bdarf andr Plazhalrinhal durch gülig Dan. Klickn Si anschlißnd auf 'Sndn'. Hinwis: Das Elmn <BrowsrIP></BrowsrIP> kann in jdr Mhod ignorir wrdn. Das Elmn <BrowsrIP> hilf, di Koordinirung für di inmalig Anmldung bim VSA brizuslln. In inr Tsumgbung, bi dr di inmalig Anmldung nich im Vordrgrund sh, kann dis außr Ach glassn wrdn. Di Ergbniss wrdn im Anwor-Brich angzig. 13

16 VSA-API-Wbdins VSA-API-Wbdins - Sichrhi Allgmin Auf dn VSA-API-Wbdins kann mi gülign VSA-Anmlddan sandardmäßig von jdr IP-Adrss wlwi zuggriffn wrdn. In disr Sandardkonfiguraion gln gülig Kombinaionn von Bnuzrnam und Passwor als Auhnifizirung von jdm blibign Rchnr aus. In jdr Konfiguraion muss di vom VSA brigsll Dai hash.dll für di Vrschlüsslung ds Passwors vor dm Einsndn vrwnd wrdn. Implmnirungsanwisungn für di Dai hash.dll sind im Bispil-Qullcod nhaln. Sobald in rfolgrich Auhnifizirungsanfordrung in Sizungs-ID ausgib, muss dis Sizungs-ID bi jdm Dinsaufruf ingsnd wrdn. Si is zudm nur dann gülig, wnn si von dr ID-Adrss mpfangn wird, an di si ausggbn wurd. Di ausggbn Sizungs-ID läuf nach inr bsimmn Priod dr Inakiviä ab. Si könnn di Sichrhi rhöhn, indm Si in Dai AccsRuls.xml rslln und brislln. Anhand disr Dai kann dr VSA-API-Wbdins Zugriffsrgln basirnd auf dn IP-Adrssn dfinirn, von dnn Anfordrungn mpfangn wrdn. IP-Filrung is in Mchanismus, dr häufig in Businss-o-Businss-Sysmn ingsz wird, um sichrzuslln, dass Anfordrungn nur von dn Srvrn ds Parnrs banwor wrdn. Di Dai AccsRuls.xml is in dri Abschni unril: Sandard-Zugriffsrgln IP-Brich Bnuzrzuordnung Hinwis: (localhos) ha immr Zugriff auf jds Kono, unabhängig von dr Konfiguraion. XML-Srukur <AccssRuls> <DfaulAccssRuls> <GranAnyIPToUndfindUsrs/> <GranAllIPRangsToUndfindUsrs/> <DnyAccssToUndfindUsrs/> </DfaulAccssRuls> <IPRangs> <IPRang RangID="" FromIPAddrss="" ToIPAddrss="" RangDscripion=""/> <IPRang RangID="" FromIPAddrss="" ToIPAddrss="" RangDscripion=""/> </IPRangs> <UsrMapping> <Usr UsrNam="" RangID="" GranAllRangs="" GranAnyIP="" DnyAccss=""/> <Usr UsrNam="" RangID="" GranAllRangs="" GranAnyIP="" DnyAccss=""/> </UsrMapping> </AccssRuls> Sandard-Zugriffsrgln Di Elmn in dism Abschni dfinirn di Zugriffsrgln für dijnign Konn, auf di im Abschni "Bnuzrzuordnung" nich igns inggangn wird. <GranAnyIPToUndfindUsrs/> ru/fals ru: Jdr Bnuzr nich in UsrMapping rhäl Zugriff von jdr IP-Adrss aus. <GranAllIPRangsToUndfindUsrs/> ru/fals ru: Jdr Bnuzr nich in UsrMapping rhäl Zugriff von jdr IP-Adrss in bsimmn IP-Brichn aus. <DnyAccssToUndfindUsrs/> ru/fals ru: Jdm Bnuzr nich in UsrMapping wird dr Zugriff vrwigr. 14

17 IP-Brich VSA-API-Wbdins In dism Abschni wrdn bsimm Rchnr odr Brich von Rchnrn nach IP-Adrss dfinir, übr di Bnuzrzugriff zugwisn wrdn kann. RangID="ingr" Ein fri vom Bnuzr zugwisn Ganzzahl, übr di in UsrMapping auf dn Brich vrwisn wrdn kann. FromIPAddrss="sring" Sar-IP-Adrss (inschlißlich). Di rsn dri Posiionn dr Virrgrupp müssn dr ToIPAddrss nsprchn. ToIPAddrss=" sring" End-IP-Adrss (inschlißlich). Di rsn dri Posiionn dr Virrgrupp müssn dr FromIPAddrss nsprchn. RangDscripion=" sring" Bschribung ds IP-Brichs. Zum Bispil: "Produkionssrvr". Bnuzrzuordnung UsrNam="sring" Dr Nam ds VSA-Adminisraors. Dr VSA-API-Wbdins vrwnd di glichn Anmlddan und Passworvrschlüsslung wi dr VSA. Falls Si also im VSA Ihr Passwor ändrn, müssn Si s auch in Ihrr Implmnirung ds VSA-API-Wbdins-Clins ändrn. RangID="ingr" Hirmi vrwisn Si im Abschni "IP-Brich" auf inn dfinirn IP-Brich. Ein Bnuzr kann mhrr UsrMapping-Elmn vrwndn, um all IP-Brich zu bschribn, von dnn aus r Zugriff bsiz. Dis Funkion wird nich vrwnd, wnn ins dr nachshndn Gwährn-/Ablhnn-Aribu vrwnd wird. GranAllRangs="ru/fals" ru: Dr Bnuzr ha Zugriff von jdm im Abschni "IP-Brich" dfinirn Brich. GranAnyIP=" ru/fals" ru: Dr Bnuzr ha Zugriff von jdr IP-Adrss. DnyAccss=" ru/fals" ru: Dr Bnuzr ha kinrli Zugriff. Bispil-XML für Zugriffskonfiguraion <AccssRuls> <DfaulAccssRuls> <GranAnyIPToUndfindUsrs>fals</GranAnyIPToUndfindUsrs> <GranAllIPRangsToUndfindUsrs>fals</GranAllIPRangsToUndfindUsrs> <DnyAccssToUndfindUsrs>ru</DnyAccssToUndfindUsrs> </DfaulAccssRuls> <IPRangs> <IPRang RangID="1" FromIPAddrss=" " ToIPAddrss=" " RangDscripion="Parnr X Produkions-Wbfarm"/> <IPRang RangID="2" FromIPAddrss=" " ToIPAddrss=" " RangDscripion="Rchnr ds Haupnwicklrs"/> <IPRang RangID="3" FromIPAddrss=" " ToIPAddrss=" " RangDscripion="Rchnr für Vrkaufsdmo"/> <IPRang RangID="4" FromIPAddrss=" " ToIPAddrss=" " RangDscripion="Rchnr für inrn QAs"/> </IPRangs> <UsrMapping> <Usr UsrNam="B2BMasrAdmin" RangID="1" GranAllRangs="fals" GranAnyIP="fals" DnyAccss="fals"/> <Usr UsrNam="DvTsAccoun" RangID="2" GranAllRangs="fals" GranAnyIP="fals" DnyAccss="fals"/> <Usr UsrNam="SalsTsAccoun" RangID="3" GranAllRangs="fals" 15

18 VSA-API-Wbdins GranAnyIP="fals" DnyAccss="fals"/> <Usr UsrNam="SalsTsAccoun2" RangID="3" GranAllRangs="fals" GranAnyIP="fals" DnyAccss="fals"/> <Usr UsrNam="QAMasrAdmin" RangID="4" GranAllRangs="fals" GranAnyIP="fals" DnyAccss="fals"/> <Usr UsrNam="SalsTravllingTsAccoun" RangID="" GranAllRangs="fals" GranAnyIP="ru" DnyAccss="fals"/> <Usr UsrNam="Bob" RangID="" GranAllRangs="ru" GranAnyIP="fals" DnyAccss="fals"/> <Usr UsrNam="Sally" RangID="" GranAllRangs="fals" GranAnyIP="fals" DnyAccss="ru"/> </UsrMapping> </AccssRuls> Wb-Links - Einghnd und ausghnd Nbn API-Vorgängn, auf di wir unn in dism Dokumn nähr inggangn wird, unrsüz dr KSrvr auch di folgndn in- und ausghndn Links: Einghnd Di URL zur Anzig dr Wbsi Rchnrübrsich für in bsimm Rchnr-ID lau: hp//...?machnam=<machinid> Zum Bispil: hp://dmo.kasya.com?machnam=jconnrs.acm 16

19 VSA-API-Wbdins Di URL zur Anzig dr Wbsi Tick für in bsimm Tick-ID lau: hp://...?icid=<tickid> Zum Bispil: hp://dmo.kasya.com?icid=1234 Ausghnd Zum Anpassn ds Links Nus Tick auf dr Si Rchnrübrsich ragn Si di rfordrlichn Angabn nsprchnd ds Kommanarabschnis dr folgndn XML in di Dai xrnallink.xml in. Um dn nun Tick-Link zu akivirn, lgn Si di Dai xrnallink.xml im Vrzichnis \WbPags\insall\ ds KSrvrs ab. <?xml vrsion="1.0" ncoding="iso "?> <xrnallinks>  <icklink displaynam="ex Tick" url="hp:// /?mnam=machinnamval&gnam=groupnamval"/> <xrnallinks> 17

20

21 VSA-API-Wbdins VSA-API-Wbdins - Vorgäng Di folgndn Vorgäng könnn mi dm VSA-API-Wbdins durchgführ wrdn. AddMachGroupoScop Füg inn Rchnr nach GroupNam zum ScopNam hinzu. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AddOrg Füg in Organisaion hinzu. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. orgouid orgourf Mhod ErrorMssag Dzimalwr Zichnfolg Zichnfolg Dzimalwr Zichnfolg Zichnfolg Di Organisaions-ID dr nu hinzugfügn Organisaion. Dr vollsändig qualifizir Nam dr Organisaion. Vrwnd di Punknoaion, falls übr- odr unrgordn Organisaionn xisirn. Bispil: nworgnam parnorgnam.nworgnam parnorgnam.childorgnam.nworgnam Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AddOrgDpSaff Füg inn Miarbir zu dr Abilung inr Organisaion hinzu. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod Zichnfolg Dr Vorgang, dr dis Anwor anfordr. 19

22 VSA-API-Wbdins ErrorMssag Dzimalwr Zichnfolg Zichnfolg Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AddOrgToScop Füg in Organisaion zu inm Umfang hinzu. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AddScop Füg inn Umfang hinzu. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AddScopOrg Füg in inm Durchgang in Organisaion und inn Umfang hinzu und vrknüpf di Organisaion mi dm Umfang. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. orgourf Mhod Zichnfolg Zichnfolg Dr vollsändig qualifizir Nam dr Organisaion. Vrwnd di Punknoaion, falls übr- odr unrgordn Organisaionn xisirn. Bispil: nworgnam parnorgnam.nworgnam parnorgnam.childorgnam.nworgnam Dr Vorgang, dr dis Anwor anfordr. 20

23 VSA-API-Wbdins ErrorMssag Dzimalwr Zichnfolg Zichnfolg Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AddTicRqus Füg in vorläufig Tickanfordrung hinzu. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. nwid Mhod ErrorMssag Zichnfolg Zichnfolg Dzimalwr Zichnfolg Zichnfolg Einduigr Idnifikaor. Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AddUsrToRol Füg inr Bnuzrroll inn Bnuzr hinzu. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AddUsrToScop Füg inm Umfang inn Bnuzr hinzu. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. 21

24 VSA-API-Wbdins Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AdminGroupAccss Wis inr Bnuzrroll in Rchnrgrupp hinzu. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AssignRol Wis inr Bnuzrroll inn Bnuzr zu bzw. nfrn disn. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. AssignScop Wis inm Umfang inn Bnuzr zu bzw. nfrn disn. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Auhnica Disr Vorgang wird bnöig, um in VSA-API-Wbdinssizung bginnn zu könnn. Di zurückggbn Sizungs-ID muss mi jdr in dr Sizung aufgrufnn Mhod übrragn wrdn. 22

25 VSA-API-Wbdins Di Sizungs-ID is nur gülig, wnn si von dm glichn Rchnr rhaln wird, auf dm auch di Auhnifizirung safand. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Sizungs-ID Mhod ErrorMssag Dzimalwr Di induig Sizungs-ID, di inr Bnuzrvrbindung mi dr Zil-URL zugwisn wird. Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Auomaisch Anmldung währnd dr Auhnifizirung Wnn Si sich übr di API auhnifizirn, wrdn Si auomaisch bim VSA angmld. Falls Si zum Zipunk dr Auhnifizirung bris bim VSA angmld sind, wrdn di bidn Sizungn synchronisir. Das Ergbnis is in bidn Fälln das glich s wrdn an bidn Ausgangspunkn gülig Sizungn ingrich. Dr VSA such in dr Abfragzichnfolg jdr VSA-Si nach dr 26-sllign Sizungs-ID dr API. Falls dr Anwndungsnwicklr also auf in VSA-Si umlin muss, kann r jz dirk in Si aufrufn, ohn dass dr Bnuzr gzwungn wird, sich rnu anzumldn. Di Synax lau: URL?apiLogonGuid= Zum Bispil: hp://somsrvr:123/sysmab/sompag?apilogonguid= &somvar=som Valu API-Akiviä häl di VSA-Sizung aufrch. Da dr VSA jdoch nich davon ausgh, dass ss Bdarf für in API-Sizung bsh, häl VSA-Akiviä nich umgkhr in API-Sizung aufrch. Di API vrwnd dn glichn Timou-Wr wi dr VSA, wlchr übr di Si Sysm > Anmldrgl ds VSA gpflg wird. Dr Sandardwr is 30 Minun. ClosAlarm Schliß dn Alarm für di übrragn MoniorAlarmID. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. CraAdmin Ersll inn VSA-Bnuzr. Das Passwor muss hash-codir wrdn. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod Zichnfolg Dr Vorgang, dr dis Anwor anfordr. 23

26 VSA-API-Wbdins ErrorMssag Dzimalwr Zichnfolg Zichnfolg Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. CraAgnInsallPackag Ersll in Agnn-Insallaionspak. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. CraMachinGroup Ersll in Rchnrgrupp. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. CraRol Ersll in Bnuzrroll. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. 24

27 VSA-API-Wbdins DlAdmin Lösch dn anggbnn Bnuzr. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. DlAgn Lösch dn Agnn auf dm Zilrchnr und das nsprchnd Rchnr-ID-Kono im VSA. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. DlAgnInsallPackag Lösch in Agnn-Insallaionspak. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. DlMachinGroup Lösch di anggbn Rchnrgrupp. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod Zichnfolg Dr Vorgang, dr dis Anwor anfordr. 25

28 VSA-API-Wbdins ErrorMssag Dzimalwr Zichnfolg Zichnfolg Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. DlOrg Lösch di anggbn Organisaion. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. DlRol Lösch di anggbn Bnuzrroll. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. DlScop Lösch dn anggbnn Umfang. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. 26

29 VSA-API-Wbdins DisablAdmin Dakivir dn anggbnn Bnuzr. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Echo Tsmhod für Vrbindungss und Bnchmarking. Erfordr kin Auhnifizirung. Gib di übrragn Zichnfolg zurück. Ein inzlnr Dansaz ds folgndn Flds wird zurückggbn. EchoRsul Zichnfolg Disr Wr soll dr in di Anfordrung ingschlossnn Eingab nsprchn. EchoM Tsmhod für Vrbindungss und Bnchmarking in di milr Suf. Erfordr Auhnifizirung. Gib di übrragn Zichnfolg zurück. Gib di übrragn Nuzdan-Zichnfolg zurück (Echo). Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Payload Mhod ErrorMssag Zichnfolg Zichnfolg Dzimalwr Zichnfolg Zichnfolg Di mi dr Anfordrung übrragn Zichnfolg. Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. EnablAdmin Akivir dn anggbnn Bnuzr. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod Zichnfolg Dzimalwr Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. 27

30 VSA-API-Wbdins ErrorMssag Zichnfolg Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GAlarm Gib di Alarmdails für di übrragn MoniorAlarmID zurück. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Machin_GroupID agnguid MachinNam GroupNam Zichnfol g Dzimalw r Zichnfol g Zichnfol g Ein vrk Darsllung dr Rchnr-ID und dr dami vrknüpfn Gruppn-ID Ein global induigr Idnifikaor ins Rchnr-ID/Gruppn-ID-Konos und sins nsprchndn Agnn Dr für jdn Agnn vrwnd Rchnrnam Dr für jdn Agnn vrwnd Gruppnnam MoniorAlarmID Ganzzahl Einduig Konrollalarmnummr MoniorTyp Ganzzahl 0 - Zählr 1 - Dins 2 - Prozss 3 - SNMP 4 - Alarm - Alarm wrdn wir nach ihrn Alarmypn unril. 5 - Sysmprüfung 6 - EPS 7 - Prookollkonroll AlarmTyp Mldung AlarmSubjc Alarm EvnTim Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g 0 -> Alarm 1 -> Tndnz Aus Alarm rsll Nachrich, Txkörpr inr -Nachrich Brff ds Alarms bzw. dr -Nachrich -Adrss(n), an di dr Alarm gsnd wird Daum und Uhrzi ds Alarms TickID Ganzzahl Di aus dm rsll Tick-ID AdminNam MoniorNam LogTyp Zichnfol g Zichnfol g Bnuzr, dr dm Rchnr dn Konrollzählr zugwisn ha Nam ds SNMP-Abrufobjks 1 -> Anwndungsprookoll 2 -> Sichrhisprookoll 3 -> Sysmprookoll EvnTyp Ganzzahl 1 -> Fhlr 2 -> Warnung 4 -> Informaion 8 -> Invnarisirung (Erfolg) 16 -> Invnarisirung (Vrsagn) 28

31 VSA-API-Wbdins LogValu SNMPNam SNMPCusomrNam SysmChckParam1 SysmChckParam2 Mhod ErrorMssag Dzimalw r Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Dzimalw r Zichnfol g Zichnfol g Wr, dr dn Alarm auslös. Falls dr Rückgabwr ds SNMP-Abrufobjk-Bfhls in Zichnfolg is, is dr Wr dis Nachrich Dr vom SNMP-Grä bim Scan zurückggbn Wr Bnuzrspzifischr Nam ds SNMP-Gräs Ersr bi dr Sysmprüfung vrwndr Paramr (Opional) Zwir bi dr Sysmprüfung vrwndr Paramr Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GAlarmLis Gib sandardmäßig in Rih nur Alarm zurück, di si dr lzn Anfordrung hinzugfüg wurdn. Gib all Alarm zurück, wnn RurnAllRcords auf 'Wahr' gsz is. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. Machin_GroupID agnguid Zichnfolg Ein vrk Darsllung dr Rchnr-ID und dr dami vrknüpfn Gruppn-ID Dzimalwr Ein global induigr Idnifikaor ins Rchnr-ID/Gruppn-ID-Konos und sins nsprchndn Agnn MoniorAlarmID Ganzzahl Einduig Konrollalarmnummr AlrTyp Ganzzahl Alarm sind inr von mhrrn Konrollypn. 1 - Adminkono dakivir 2 - Ändrungsalarm 'Dai abrufn' 3 - Nur Agn zum rsn Mal angmld 4 - Anwndung insallir odr glösch 5 - Agnnvrfahrnsfhlr fsgsll 6 - Fhlr in NT-Erignisprookoll fsgsll 7 - KSrvr gsopp 8 - Schuzvrlzung fsgsll 9 - PCI-Konfiguraion gändr 10 - Fsplanlaufwrkskonfiguraion gändr 11 - RAM-Größ gändr Ts- von srvrinfo.asp gsnd 13 - Gplanr Brich abgschlossn 14 - LAN-Wach-Alarmyp 15 - Agn offlin 16 - Fsplanspichr nidrig 17 - Frnsurung dakivir 18 - Agn is onlin 19 - Nus Pach gfundn 20 - Pach-Pfad fhl 21 - Pach-Insallaion fhlgschlagn 23 - Sichrungsalarm 29

32 VSA-API-Wbdins AlarmSubjc Zichnfolg Brff ds Alarms bzw. dr -Nachrich EvnTim datim Daum und Uhrzi ds Alarms Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GGroupLicnsInfo Ruf di zulässig Anzahl von Liznzn für di anggbn Grupp ab. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. MaxAgns Ganzzahl Di maximal Anzahl dr Agnn, di für dis Rchnrgrupp insallir wrdn kann. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GLogEnry Gib di Transakionsprookolldails für di übrragn Transakions-ID zurück. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. LogTransacionId Dzimalwr Di Transakions-ID ds Prookolls. Log Zichnfolg Di Fhlrposiion ds Prookolls. LogErrorMssag Zichnfolg Di Fhlrmldung ds Prookolls. LogMhod Zichnfolg Dr Prookollvorgang, dr in Anwor anfordr. ExcuionTimInSconds Dzimalwr Di zum Banworn dr Anfordrung bnöig Prookollzi. SssionId Dzimalwr Di Sizungs-ID ds Prookolls. Bnuzrnam Zichnfolg Dr Bnuzrnam ds Prookolls. ClinIP Zichnfolg Di Clin-IP-Adrss ds Prookolls. DaSubmid datim Das Prookolldaum und di -uhrzi, zu dr di Anfordrung übrragn wurd. DaUpdad datim Das Prookolldaum und di -uhrzi, zu dr di Anwor zurückggbn wurd. TransacionXML Zichnfolg Di zum Übrragn dr Anfordrung vrwnd XML-Nachrich. Mhod Zichnfolg Dr Vorgang, dr dis Anwor anfordr. 30

33 VSA-API-Wbdins Dzimalwr Di induig Nachrichn-ID disr Nachrich. ErrorMssag Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GMachin Gib di Rchnrdails dr übrragnn Machin_GroupID zurück. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Machin_GroupID agnguid machnam groupnam Hrsllr ProducNam MachinVrsion SysSrialNumbr ChassisSrialNumbr ChassisAssTag BusSpd MaxMmorySiz MaxMmorySlos ChassisManufacurr ChassisTyp ChassisVrsion MohrboardManufacurr MohrboardProducCod MohrboardVrsion Zichnfol g Dzimalw r Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Ein vrk Darsllung dr Rchnr-ID und dr dami vrknüpfn Gruppn-ID. Ein global induigr Idnifikaor ins Rchnr-ID/Gruppn-ID-Konos und sins nsprchndn Agnn Dr vollsändig Rchnrnam. Dr Rchnrnam bsh aus alln Zichn links vom Dzimalkomma. Dr vollsändig Gruppnnam für diss Kono. Dr Gruppnnam bsh aus alln Zichn rchs vom Dzimalkomma. Hrsllrzichnfolg (Typ 1) Produknamnzichnfolg (Typ 1) Vrsionszichnfolg (Typ 1) Srinnummrnzichnfolg (Typ 1) Srinnummr ds Ghäuss (Typ 3) Bsandsiknummr ds Ghäuss (Typ 3) Gschwindigki ds xrnn Bus (in MHz) (Typ 4) Maximal Spichrmodulgröß (in MB) (Typ 16 - Maximal Kapaziä odr, falls Typ 16 nich vrfügbar is, Maximal Spichrmodulgröß Typ 5) Anzahl dr vrknüpfn Spichrslos (Anzahl dr Spichrgrä in Typ 16 odr, falls Typ 16 nich vrfügbar is, Anzahl dr vrknüpfn Spichrslos in Typ 5) Ghäushrsllr (Typ 3) Ghäusyp (Typ 3) Ghäusvrsion (Typ 3) Hrsllr dr Haupplain (Typ 2) Produkcod dr Haupplain (Typ 2) Vrsion dr Haupplain (Typ 2) 31

34 VSA-API-Wbdins MohrboardSrialNumbr CompurNam IpAddrss SubnMask DfaulGaway DnsSrvr1 DnsSrvr2 DnsSrvr3 DnsSrvr4 Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Zichnfol g Srinnummr dr Haupplain (Typ 2) Nam ds Compurs IP-Adrss ds Compurs in a.b.c.d-noaion Subnzmask in a.b.c.d-noaion. Zichnfolg is lr, falls kin Dan vrfügbar sind. Sandard-Gaway-IP-Adrss in a.b.c.d-noaion. Zichnfolg is lr, falls kin Dan vrfügbar sind. IP-Adrss von DNS-Srvr #1 in a.b.c.d-noaion. Zichnfolg is lr, falls kin Dan vrfügbar sind. IP-Adrss von DNS-Srvr #2 in a.b.c.d-noaion. Zichnfolg is lr, falls kin Dan vrfügbar sind. IP-Adrss von DNS-Srvr #3 in a.b.c.d-noaion. Zichnfolg is lr, falls kin Dan vrfügbar sind. IP-Adrss von DNS-Srvr #4 in a.b.c.d-noaion. Zichnfolg is lr, falls kin Dan vrfügbar sind. DhcpEnabld Ganzzahl 0 -> Dan nich vrfügbar, 1 -> DHCP auf Clin-Compur is akivir, 2 -> Dakivir DhcpSrvr WinsEnabld PrimaryWinsSrvr Zichnfol g Zichnfol g Zichnfol g IP-Adrss ds DHCP-Srvrs in a.b.c.d-noaion. Zichnfolg is lr, falls kin Dan vrfügbar sind. 0 -> Dan nich vrfügbar, 1 -> WINS-Auflösung auf Clin-Compur is akivir, 2 -> Dakivir IP-Adrss ds primärn WINS-Srvrs in a.b.c.d-noaion. Zichnfolg is lr, falls kin Dan vrfügbar sind. ScondaryWinsSrvr Ganzzahl IP-Adrss ds skundärn WINS-Srvrs in a.b.c.d-noaion. Zichnfolg is lr, falls kin Dan vrfügbar sind. ConncionGawayIp Ganzzahl IP-Adrss in a.b.c.d-noaion, di vom KSrvr als Qulladrss ds Agnn rmil wurd. Dis IP is das Nzwrk-Gaway ds Agnn. Si unrschid sich von dr IP-Adrss, falls sich dr Compur bispilswis hinr NAT bfind. Zichnfolg is lr, falls kin Dan vrfügbar sind. OsTyp OsInfo MajorVrsion MinorVrsion MacAddr LoginNam Zichnfol g Zichnfol g Dzimalw r Zichnfol g Zichnfol g Zichnfol g Zichnfolg nhäl dn Typ ds Bribssysms, wi z. B. 95, 98, NT4, 2000, NT3.51 odr WIN32s. Wird aus Tiln dr MajorVrsion, MinorVrsion und PlaformId abgli. Zichnfolg nhäl zusäzlich Informaionn zum Bribssysm, wi z. B. Build 1381 Srvic Pack 3. Wird aus Tiln dr BuildNumbr und CsdVrsion abgli. Haupvrsionsnummr aus inn GVrsionEx() Windows-Funkionsaufruf abgli. Nbnvrsionsnummr aus inn GVrsionEx() Windows-Funkionsaufruf abgli. Falls di PlaformId Win32 für Windows lau, so wis di MinorVrsion 0 auf Windows 95 hin. Lau di PlaformId Win32 für Windows, so wis in MinorVrsion > 0 auf Windows 98 hin. Zichnfolg, di di physikalisch Adrss, d. h. di Mdia Accss Conrol-Adrss, dr Vrbindung angib. Ein MAC-Adrss is folgndrmaßn aufgbau: Bnuzrnam ds ggnwärig angmldn Bnuzrs. Disr Wr wird bi jdm Schnll-Chck-in akualisir. Di Fhlrprookolldai ds Agnn wird bi jdr Ändrung akualisir. 32

35 VSA-API-Wbdins firschckin datim Zismpl dr rsmalign Anmldung diss Agnn bim Sysm laschckin datim Zismpl dr lzn Anmldung diss Agnn bim Sysm currnusr lasloginnam Zichnfol g Zichnfol g Anmldnam ds ggnwärig angmldn Bnuzrs. Lr, falls ggnwärig nimand angmld is Anmldnam ds lzn Bnuzrs, dr sich bi dism Sysm angmld ha lasrboo datim Zismpl ds lzn Nusars diss Sysms agnvrsion Ganzzahl Vrsionsnummr ds auf dism Sysm insallirn Agnn conacnam conac conacphon conacnos Zichnfol g Zichnfol g Zichnfol g Zichnfol g Dr dism Agnn zugwisn Bnuzrkonaknam Di dism Agnn zugwisn Bnuzr-Tlfonnummr Di dism Agnn zugwisn Bnuzr-Tlfonnummr Mi dn Konakinformaionn für disn Agnn vrknüpf Anmrkungn nablticks Ganzzahl 0, falls disr Bnuzr kinn Zugriff auf Ticking übr di Bnuzrobrfläch bsiz nablrmoconrol Ganzzahl 0, falls disr Bnuzr kinn Zugriff auf Frnsurung übr di Bnuzrobrfläch bsiz nablcha Ganzzahl 0, falls disr Bnuzr kinn Zugriff auf Cha übr di Bnuzrobrfläch bsiz crdnialnam primaryksrvr scondaryksrvr Zichnfol g Zichnfol g Zichnfol g Dr Bnuzrnam dr für disn Agn ingrichn Anmlddan (falls zurffnd) Adrss:Por, zu dm dr Agn in Vrbindung für sin primär KSrvr-Vrbindung hrsll Adrss:Por, zu dm dr Agn in Vrbindung für sin skundär KSrvr-Vrbindung hrsll quickchckinscs Ganzzahl Di Zi, di gwar wird (in Skundn), bvor dr Schnll-Chck-in ins andrn Agnn safind agntmpdir Zichnfol g Das vom Agnn auf dism Sysm vrwnd Arbisvrzichnis Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. CpuDsc Zichnfol g Bschribung dr CPU (z. B. Pnium III Modl 8) CpuSpd Ganzzahl CPU-Gschwindigki in MHz (z. B. 601) CpuCoun Ganzzahl Anzahl dr Prozssorn (z. B. 1) ToalRam Ganzzahl Brag ds RAM in MBy (z. B. 250) Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. DrivLr Zichnfol g Laufwrksbuchsab dr logischn Fspla (z. B. C) ToalSpac Ganzzahl Gsamfsplankapaziä in MBy (z. B für GB) Kann Null sin, falls nich vrfügbar. UsdSpac Ganzzahl Blgr Fsplanspichr in MBy (z. B für GB). Kann Null sin, falls nich vrfügbar. FrSpac Ganzzahl Frir Fsplanspichr in MBy (z. B für GB). Kann Null sin, falls nich vrfügbar. 33

36 VSA-API-Wbdins DrivTyp VolumNam FormaTyp Zichnfol g Zichnfol g Zichnfol g Fixd = Fspla Rmovabl = Disk odr andr Wchslmdin CDROM Nwork = zugordns Nzwrklaufwrk Dm Danrägr zugwisnr Nam NTFS, FAT32, CDFS usw. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfol g Dzimalw r Zichnfol g Zichnfol g Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GMachinCollcionLis Gib in Aufsllung allr Rchnrsammlungn zurück. Zurückggbn Elmn könnn als Argumn in dr GMachinLis vrwnd wrdn, um di Ausgab zu filrn. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. collcionnam Zichnfolg Dr Nam dr Sammlung. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GMachinGroupLis Gib in Aufsllung allr Rchnrgruppn zurück, di in auhnifizirs Kono bfug is, anzuzign. Zurückggbn Elmn könnn als Argumn in dr GMachinLis vrwnd wrdn, um di Ausgab zu filrn. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. groupnam Zichnfolg Di ID dr Rchnrgrupp. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GMachinLis Gib in Aufsllung allr Rchnr zurück, di in auhnifizirr Bnuzr bfug is, anzuzign. 34

37 VSA-API-Wbdins Unrsüz di opional Filrung dr Rückgab nach übrragnr MachinGroup odr MachinCollcion. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. MachinGroupID Zichnfolg Ein ggnwärig bshnd Rchnrgrupp. Wnn dis Angab lr is, wrdn all Rchnr zurückggbn. IpAddrss Zichnfolg Di IP-Adrss ds Agnnrchnrs MacAddr Zichnfolg Di MAC-Adrss ds Agnnrchnrs groupnam Zichnfolg Dr für jdn Agnn vrwnd Gruppnnam firschckin daim Dr Zipunk, zu dm sich in Agn rsmals bim VSA angmld ha agnguid Dzimalwr Ein global induigr Idnifikaor ins Rchnr-ID/Gruppn-ID-Konos und sins nsprchndn Agnn Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. ErrorMssag Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GMachinUpim Gib in Aufsllung dr Laufzi-Saisikn ins Rchnrs für di übrragn AgnGuid odr MachinGroup odr all Rchnr zurück, wnn RurnAllRcords auf 'Wahr' gsz is. Mi rpda wird das Sar-Aufzichnungsdaum dr Brchnung auf das akull Daum gsz. All Ausgabn wrdn inr Sichrhisfilrung unrworfn, inschlißlich dr agnguid-einrmng und dr MachinGroup-Unrgrupp. Wnn Si in agnguid odr MachinGroup übrragn, für di Si kin Anzigbrchigung bsizn, wird nichs zurückggbn. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. agnguid machinnam Dzimalwr Ein global induigr Idnifikaor ins Rchnr-ID/Gruppn-ID-Konos und sins nsprchndn Agnn Zichnfolg Dr vollsändig Rchnrnam. Dr Rchnrnam bsh aus alln Zichn links vom Dzimalkomma. oalonlin Ganzzahl Di Gsamzi in Skundn, di das Sysm währnd ds gsamn Mssungsziraums onlin war. masurtim Ganzzahl Di Gsamzi in Skundn, währnd drr das Sysm gmssn wurd (lz - äls - Alarm-Auszin). lassada datim Dr lz Zipunk, zu dm das Sysm gmssn wurd. Dis is für gwöhnlich dr lz Agnnprookollinrag für in Offlin-Sysm. oldrsada datim Dr frühs Zipunk, zu dm das Sysm gmssn wurd. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. 35

38 VSA-API-Wbdins GNosLis Gib in Aufsllung nur Tick-Anmrkungn zurück, di si dr lzn Anfordrung hinzugfüg wurdn. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. TickID Ganzzahl Di Tick-ID. Auhor Zichnfolg Dr Auor dr Anmrkung. DaEnrd datim Das Daum, an dm di Anmrkung rsll odr zulz barbi wurd. NoTx Zichnfolg Dr Tx dr Anmrkung. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. ErrorMssag Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GOrgLocaion Gib di Sraßnanschrif dr Organisaion zurück, inschlißlich ihrs Längn- und Bringrads. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. orgid orgrf PariionID orgnam sr ciy ussa posalcod counry counrycod longiud laiud Mhod Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Einduigr Idnifikaor. Einduigr Nam. Idnifikaor ds Tnans. Dr Nam dr Organisaion. Di Sraßnanschrif. Di Sad. Das Bundsland. Di Poslizahl. Das Land. Dr Landscod. Dr Längngrad dr Organisaion. Dr Bringrad dr Organisaion. Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. 36

39 VSA-API-Wbdins ErrorMssag Zichnfolg Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GOrgs Gib di Organisaionn zurück, auf di dr angmld VSA-Bnuzr zugrifn kann. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. orgnam orgrf orgid CusomrID Zichnfolg Dr Nam dr Organisaion. Zichnfolg Einduigr Nam. Zichnfolg Einduigr Idnifikaor. Zichnfolg Einduigr Idnifikaor ds Kundn. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GOrgsByScopID Gib di Organisaionn zurück, auf di dr anggbn Umfang zugrifn kann. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. orgnam orgrf orgid CusomrID Zichnfolg Dr Nam dr Organisaion. Zichnfolg Einduigr Nam. Zichnfolg Einduigr Idnifikaor. Zichnfolg Einduigr Idnifikaor ds Kundn. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GOrgTyps Gib di Rchnrdails dr übrragnn Machin_GroupID zurück. Es wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. orgtypid orgtyprf Dzimalw r Zichnfol g saus Ganzzahl 1=Akiv Einduigr Idnifikaor. Dr induig Nam ds Organisaionsyps. 37

40 VSA-API-Wbdins dscripion Zichnfol g Ein Bschribung ds Organisaionsyps. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfol g Dzimalw r Zichnfol g Zichnfol g Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GPackagURLs Ruf in Lis allr Agnnbrisllungspak-URLs ab, di dm angmldn Bnuzr zur Vrfügung shn. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. URL PackagNam Bschribung Zichnfolg Zichnfolg Zichnfolg Di URL. Dr Nam ds Agnnbrisllungspaks. Ein Bschribung ds Agnnbrisllungspaks. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GParnrUsrLocaion Gib dn Sandor ins nan-spzifischn VSA-Bnuzrs, inschlißlich ds Längn- und Bringrads ds VSA-Bnuzrs zurück. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. adminid adminnam PariionID longiud laiud Mhod ErrorMssag Zichnfolg Dr induig Idnifikaor ds VSA-Bnuzrs. Zichnfolg Dr Nam ds VSA-Bnuzrs. Zichnfolg Dr Tnan-Idnifikaor. Zichnfolg Dr Längngrad ds VSA-Bnuzrsandors. Zichnfolg Dr Bringrad ds VSA-Bnuzrsandors. Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. 38

41 VSA-API-Wbdins Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GPublishdViwColumns Gib in Aufsllung allr Spaln für in vröffnlich Danbankansich zurück. Es wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. nam daatyp Zichnfol g Zichnfol g Dr Nam dr Danbankansichsspal. Dr Danyp dr Danbankansichsspal. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfol g Dzimalw r Zichnfol g Zichnfol g Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GPublishdViwRows Gib in Aufsllung allr Ziln für in vröffnlich Danbankansich für in vorggbn WHERE-Klausl zurück. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. PublishdViwRows Mhod ErrorMssag Zichnfol g Zichnfol g Dzimalw r Zichnfol g Zichnfol g Ein Aufsllung dr Zilndan. Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GPublishdViws Gib in Aufsllung allr vröffnlichn Danbankansichn zurück. Es wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. PublishdViw Zichnfol g Dr Nam dr Danbankansich. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod Zichnfol g Dr Vorgang, dr dis Anwor anfordr. 39

42 VSA-API-Wbdins ErrorMssag Dzimalw r Zichnfol g Zichnfol g Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GRols Gib di Rolln zurück, auf di dr angmld VSA-Bnuzr zugrifn kann. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. rolid Zichnfolg Einduigr Idnifikaor. isaciv boolan Di Roll is akiv odr inakiv. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GScops Gib di Umfäng zurück, auf di dr angmld VSA-Bnuzr zugrifn kann. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. scopid Zichnfolg Einduigr Idnifikaor. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GTick Gib di Tickdails für di übrragn MoniorTickID zurück. TickID Ganzzahl Einduig ID-Nummr ds Troubl-Ticks Machin_GroupID agnguid machnam groupnam Zichnfolg Dzimalwr Zichnfolg Zichnfolg Ein vrk Darsllung dr Rchnr-ID und dr dami vrknüpfn Gruppn-ID. Ein global induigr Idnifikaor ins Rchnr-ID/Gruppn-ID-Konos und sins nsprchndn Agnn Dr für jdn Agnn vrwnd Rchnrnam Dr für jdn Agnn vrwnd Gruppnnam TickSummary Zichnfolg Ein kurz Bschribung ds Ticks 40

43 VSA-API-Wbdins Adminisraor CradBy CraionDa DuDa LasModifidDa RsoluionDa Bnuzrnam Usr UsrPhon Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Zichnfolg Dr Admin-Nam, dm diss Tick zugwisn is Admin-Nam (odr Rchnr-ID, falls vom Bnuzr anggbn) dr Prson, di das Tick rsll ha Zismpl dr Tickrsllung Fälligkisdaum ds Ticks Daum, an dm di lz Anmrkung für diss Tick inggbn wurd Zismpl dr Schlißung ds Ticks Dr Nam ds Absndrs. Di -Adrss ds Absndrs Di Tlfonnummr ds Absndrs Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. TickLabl Zichnfolg Di Fldbzichnung IngrValu Ganzzahl Dr Wr ins Ganzzahlflds NumbrValu SringValu LisValu Dzimalwr Zichnfolg Zichnfolg Dr Wr ins numrischn Flds Dr Wr ins Zichnfolgnflds Dr Wr ins Lisnflds Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GTickLis Gib sandardmäßig in Aufsllung nur Ticks zurück, di si dr lzn Anfordrung hinzugfüg wurdn. Gib all Ticks zurück, wnn RurnAllRcords auf 'Wahr' gsz is. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. TickID Ganzzahl Einduig ID-Nummr ds Troubl-Ticks Machin_GroupID agnguid Zichnfolg Ein vrk Darsllung dr Rchnr-ID und dr dami vrknüpfn Gruppn-ID. Dzimalwr Ein global induigr Idnifikaor ins Rchnr-ID/Gruppn-ID-Konos und 41

44 VSA-API-Wbdins sins nsprchndn Agnn TickSummary Zichnfolg Ein kurz Bschribung ds Ticks Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GTickNos Gib in Aufsllung dr Anmrkungn zurück, di zu dm übrragnn Tick ghörn. Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. TickID Ganzzahl Di Tick-ID. Auhor Zichnfolg Dr Auor dr Anmrkung. DaEnrd datim Das Daum, an dm di Anmrkung rsll odr zulz barbi wurd. NoTx Zichnfolg Dr Tx dr Anmrkung. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. ErrorMssag Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GTicRqusTick Gib di mi inr Tickanfordrungs-ID vrknüpf Tick-ID zurück. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. ickid Mhod ErrorMssag Zichnfolg Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr induig Idnifikaor ds Ticks Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. GVrbosMachinGroupLis Falls zurffnd, wrdn mhrr Dansäz dr folgndn Fldr zurückggbn. groupnam machgroupguid Zichnfolg Di ID dr Rchnrgrupp. Zichnfolg GUID dr Rchnrgrupp. 42

45 VSA-API-Wbdins parngroupguid orgfk Zichnfolg GUID dr übrgordnn Rchnrgrupp, falls vorhandn. Zichnfolg Exrnr Schlüssl dr Organisaion, di di Rchnrgrupp nhäl. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Dzimalwr Di induig Nachrichn-ID disr Nachrich. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Zichnfolg Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. LockFuncionAccss Sprr dn Funkionszugriff dr übrragnn Bnuzrroll für di übrragn Basisbnuzrroll. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Primiiv Darübr hinaus wrdn di folgndn primiivn Danypvorgäng durchgführ. Jdr primiiv Vorgang vrwnd dn glichn xml-vrrag wi dr nsprchnd Mhrspalnvorgang. Jdr primiiv Vorgang gib inn Zichnfolgnwr zurück, dr wirr Vrarbiung bdarf. Primiiv Ergbnis Danyp PrimiivAddMachGroupToScop PrimiivAddMachGroupToScopRsul Zichnfolg PrimiivAddOrg PrimiivAddOrgRsul Zichnfolg PrimiivAddOrgDpSaff PrimiivAddOrgDpSaffRsul Zichnfolg PrimiivAddOrgToScop PrimiivAddOrgToScopRsul Zichnfolg PrimiivAddScop PrimiivAddScopRsul Zichnfolg PrimiivAddScopOrg PrimiivAddScopOrgRsul Zichnfolg PrimiivAddTicRqus PrimiivAddTicRqusRsul Zichnfolg PrimiivAddUsrToRol PrimiivAddUsrToRolRsul Zichnfolg PrimiivAddUsrToScop PrimiivAddUsrToScopRsul Zichnfolg PrimiivAssignRol PrimiivAssignRolRsul Zichnfolg PrimiivAssignScop PrimiivAssignScopRsul Zichnfolg PrimiivAuhnica PrimiivAuhnicaRsul Zichnfolg PrimiivClosAlarm PrimiivClosAlarmRsul Zichnfolg PrimiivCraMachinGroup PrimiivCraMachinGroupRsul Zichnfolg PrimiivCraRol PrimiivCraRolRsul Zichnfolg PrimiivDlMachinGroup PrimiivDlMachinGroupRsul Zichnfolg 43

46 VSA-API-Wbdins PrimiivDlOrg PrimiivDlOrgRsul Zichnfolg PrimiivDlScop PrimiivDlScopRsul Zichnfolg PrimiivEchoM PrimiivEchoMRsul Zichnfolg PrimiivGAlarm PrimiivGAlarmRsul Zichnfolg PrimiivGAlarmLis PrimiivGAlarmRsul Zichnfolg PrimiivGLogEnry PrimiivGLogEnryRsul Zichnfolg PrimiivGMachin PrimiivGMachinRsul Zichnfolg PrimiivGMachinCollcionLis PrimiivGMachinCollcionLisRsul Zichnfolg PrimiivGMachinGroupLis PrimiivGMachinGroupLisRsul Zichnfolg PrimiivGMachinGroups PrimiivGMachinGroupsRsul Zichnfolg PrimiivGMachinLis PrimiivGMachinLisRsul Zichnfolg PrimiivGMachinUpim PrimiivGMachinUpimRsul Zichnfolg PrimiivGNosLis PrimiivGNosLisRsul Zichnfolg PrimiivGOrgLocaion PrimiivGOrgLocaionRsul Zichnfolg PrimiivGOrgs PrimiivGOrgsRsul Zichnfolg PrimiivGOrgsByScopID PrimiivGOrgsByScopIDRsul Zichnfolg PrimiivGOrgTyps PrimiivGOrgTypsRsul Zichnfolg PrimiivGParnrUsrLocaion PrimiivGParnrUsrLocaionRsul Zichnfolg PrimiivGPublishdViwColumns PrimiivGPublishdViwColumnsRsul Zichnfolg PrimiivGPublishdViwRows PrimiivGPublishdViwRowsRsul Zichnfolg PrimiivGPublishdViws PrimiivGPublishdViwsRsul Zichnfolg PrimiivGRols PrimiivGRolsRsul Zichnfolg PrimiivGScops PrimiivGScopsRsul Zichnfolg PrimiivGTicRqusTick PrimiivGTicRqusTickRsul Zichnfolg PrimiivGTick PrimiivGTickRsul Zichnfolg PrimiivGTickLis PrimiivGTickLisRsul Zichnfolg PrimiivGTickNos PrimiivGTickNosRsul Zichnfolg PrimiivGVrbosMachinGroup Lis PrimiivGVrbosMachinGroupLisRsul Zichnfolg PrimiivRmovUsrFromRol PrimiivRmovUsrFromRolRsul Zichnfolg PrimiivRsPassword PrimiivRsPasswordRsul Zichnfolg PrimiivSParnrUsrLocaion PrimiivSParnrUsrLocaionRsul Zichnfolg PrimiivUpdaOrg PrimiivUpdaOrgRsul Zichnfolg PrimiivUpdaTick PrimiivUpdaTickRsul Zichnfolg PrimiivUpdaUsr PrimiivUpdaUsrRsul Zichnfolg RmovUsrFromRol Enfrn inn VSA-Bnuzr von inr Roll. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod Zichnfolg Dr Vorgang, dr dis Anwor anfordr. 44

47 VSA-API-Wbdins ErrorMssag Dzimalwr Zichnfolg Zichnfolg Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. RsPassword Sz das Passwor ds anggbnn Bnuzrs zurück. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. RolMmbrship Wis inn Bnuzr inr Bnuzrroll zu. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. SndAdminMssag Snd in Nachrich an inn Bnuzr. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. 45

48 VSA-API-Wbdins SAdminPassword Sz das Passwor ds anggbnn Bnuzrs zurück. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. SGroupLicnsInfo Lg di maximal Anzahl dr Agnn fs, di für in inggbn Grupp zulässig sind. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. SParnrUsrLocaion Lg dn akulln Längn- und Bringrad ds VSA-Bnuzrs fs Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. AdminId Mhod ErrorMssag Dzimalwr Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr induig Idnifikaor ds VSA-Bnuzrs. Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. UpdaOrg Akualisir di Informaionn inr Organisaion. Ein inzlnr Dansaz dr folgndn Fldr wird zurückggbn. 46

49 VSA-API-Wbdins Mhod ErrorMssag Zichnfolg Dzimalwr Zichnfolg Zichnfolg Dr Vorgang, dr dis Anwor anfordr. Di induig Nachrichn-ID disr Nachrich. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. Wnn dis Angab lr is, wurd kin Fhlr zurückggbn. UpdaTick Akualisir in odr mhrr Fldr ins Ticks. Nur Fldr, di auf dr Si Ticking > -Lsprogramm aufglis sind, könnn akualisir wrdn. Lisnfldr akualisirn Im nachshndn Bispil is das Fld Ursprung in Fld vom Typ Lis mi vir möglichn Wrn. Ein Anfordrung gib dn Namn ds Flds (Ursprung) sowi in Nummr, di di Posiion ds Wrs in dr Lis angib (ab 1 gzähl), wir. Angnommn, dr Wr Tlfon bfind sich an dr zwin Posiion in dr Lis, so is dr Wr, dr zum Ändrn ds Flds Ursprung zu Tlfon wirggbn wird, glich 2. Warnung: Durch in Ändrung dr Rihnfolg dr Fld-Dropdown-Lis, indm Si dis nu ordnn odr in dr Mi dr Lis inn nun Wr ingbn, wird dr vom Vorgang UpdaTick ausgwähl Wr gändr. Bnuzr müssn sich übr dis Ingraionsrsrikion im Klarn sin, bvor Ändrungn an dn Wrn ds Flds -Lsprogramm vorgnommn wrdn. Tick schlißn Di Akualisirung ins Ticks kann bnfalls das Schlißn inr übrragnn MoniorTickID inschlißn, indm das Fld Saus mi dm Wr 3 akualisir wird. Disr sll dn drin Wr in dr Dropdown-Lis ds Flds Saus dar. Nachshnd wird in Bispil angzig. Wir <TickFild>-Namn/Wr könnn zu dm nachshndn Bispil hinzugfüg wrdn, um mhrr Fldr zu akualisirn. <UpdaTickRqus> <TickID>1</TickID> <TickFilds> <TickFild> 47