Wiki-Quellcode von Clients

Version 3.1 von Steffi F am 2025/06/06 08:33
Zeige letzte Bearbeiter
1 {{aagon.floatingbox/}}
2
3 = Client anlegen =
4
5 Diese Commands legt Clients an oder aktualisiert sie. Wird eine ClientId angegeben wird der entsprechende Client Eintrag aktualisiert oder ein neuer angelegt. Ist keine ClientId angegeben werden ActiveDirectoryObjectId oder die Kombination von ComputerName und ComputerDomain genutzt, um zu ermitteln, ob der Client schon vorhanden ist. In allen Fällen werden im Response die entsprechenden ClientIds zurückgeliefert. Für die V1, V2 und V3 ist es erforderlich **alle** Clientwerte anzugeben.
6
7 {{apimacro title="SaveClients_V1 Request"}}
8 <ICQL>
9 <ACMP>
10 <SaveClients version="1">
11 <TSaveClientsRequest_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
12 <Clients>
13 <TClient_V1 xsi:type="TClient_V1">
14 <ClientId>{B03D2CCD-ADC1-4B9D-BDB8-87564B94030C}</ClientId>
15 <ComputerName>MyComputer</ComputerName>
16 <ComputerDomain>mydomain.local</ComputerDomain>
17 <MacAddress>00-80-41-ae-fd-7e</MacAddress>
18 <ComputerSid>S-1-5-21-3341858414-824459133-3810899301</ComputerSid>
19 <ActiveDirectoryObjectId>{B6C18E5F-26C1-4769-8E09-0D171F94415C}</ActiveDirectoryObjectId>
20 <ClientType>ctApplication</ClientType>
21 <PrimaryIP>PrimaryIP</PrimaryIP>
22 <DisplayIP>DisplayIP</DisplayIP>
23 </TClient_V1>
24 </Clients>
25 </TSaveClientsRequest_V1>
26 </SaveClients>
27 </ACMP>
28 </ICQL>
29 {{/apimacro}}
30
31 {{apimacro title="SaveClients_V1 Response"}}
32 <ICQL>
33 <ACMP>
34 <SaveClients version="1">
35 <TSaveClientsResponse_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
36 <Clients>
37 <TClient_V1 xsi:type="TClient_V1">
38 <ClientId>{B03D2CCD-ADC1-4B9D-BDB8-87564B94030C}</ClientId>
39 <ComputerName>MyComputer</ComputerName>
40 <ComputerDomain>mydomain.local</ComputerDomain>
41 <MacAddress>00-80-41-ae-fd-7e</MacAddress>
42 <ComputerSid>S-1-5-21-3341858414-824459133-3810899301</ComputerSid>
43 <ActiveDirectoryObjectId>{B6C18E5F-26C1-4769-8E09-0D171F94415C}</ActiveDirectoryObjectId>
44 <ClientType>ctApplication</ClientType>
45 <PrimaryIP>PrimaryIP</PrimaryIP>
46 <DisplayIP>DisplayIP</DisplayIP>
47 </TClient_V1>
48 </Clients>
49 </TSaveClientsResponse_V1>
50 </SaveClients>
51 </ACMP>
52 </ICQL>
53 {{/apimacro}}
54
55 {{apimacro title="SaveClients_V2 Request"}}
56 <ICQL>
57 <ACMP>
58 <SaveClients version="2">
59 <TSaveClientsRequest_V2 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
60 <Clients>
61 <TClient_V2 xsi:type="TClient_V2">
62 <VersionString>1.2.3</VersionString>
63 <ClientId>{B03D2CCD-ADC1-4B9D-BDB8-87564B94030C}</ClientId>
64 <ComputerName>MyComputer</ComputerName>
65 <ComputerDomain>mydomain.local</ComputerDomain>
66 <MacAddress>00-80-41-ae-fd-7e</MacAddress>
67 <ComputerSid>S-1-5-21-3341858414-824459133-3810899301</ComputerSid>
68 <ActiveDirectoryObjectId>{B6C18E5F-26C1-4769-8E09-0D171F94415C}</ActiveDirectoryObjectId>
69 <ClientType>ctApplication</ClientType>
70 <PrimaryIP>PrimaryIP</PrimaryIP>
71 <DisplayIP>DisplayIP</DisplayIP>
72 </TClient_V2>
73 </Clients>
74 </TSaveClientsRequest_V2>
75 </SaveClients>
76 </ACMP>
77 </ICQL>
78 {{/apimacro}}
79
80 {{apimacro title="SaveClients_V2 Response"}}
81 <ICQL>
82 <ACMP>
83 <SaveClients version="2">
84 <TSaveClientsResponse_V2 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
85 <Clients>
86 <TClient_V2 xsi:type="TClient_V2">
87 <VersionString>1.2.3</VersionString>
88 <ClientId>{B03D2CCD-ADC1-4B9D-BDB8-87564B94030C}</ClientId>
89 <ComputerName>MyComputer</ComputerName>
90 <ComputerDomain>mydomain.local</ComputerDomain>
91 <MacAddress>00-80-41-ae-fd-7e</MacAddress>
92 <ComputerSid>S-1-5-21-3341858414-824459133-3810899301</ComputerSid>
93 <ActiveDirectoryObjectId>{B6C18E5F-26C1-4769-8E09-0D171F94415C}</ActiveDirectoryObjectId>
94 <ClientType>ctApplication</ClientType>
95 <PrimaryIP>PrimaryIP</PrimaryIP>
96 <DisplayIP>DisplayIP</DisplayIP>
97 </TClient_V2>
98 </Clients>
99 </TSaveClientsResponse_V2>
100 </SaveClients>
101 </ACMP>
102 </ICQL>
103 {{/apimacro}}
104
105 {{apimacro title="SaveClients_V3 Request"}}
106 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveClientsRequest_V3">
107 <ACMP>
108 <SaveClients version="3">
109 <TSaveClientsRequest_V3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
110 <Clients>
111 <TClient_V3 xsi:type="TClient_V3">
112 <ClientId>{B03D2CCD-ADC1-4B9D-BDB8-87564B94030C}</ClientId>
113 <ComputerName>MyComputer</ComputerName>
114 <ComputerDomain>mydomain.local</ComputerDomain>
115 <MacAddress>00-80-41-ae-fd-7e</MacAddress>
116 <ComputerSid>S-1-5-21-3341858414-824459133-3810899301</ComputerSid>
117 <ActiveDirectoryObjectId>{B6C18E5F-26C1-4769-8E09-0D171F94415C}</ActiveDirectoryObjectId>
118 <ClientType>ctService</ClientType>
119 <PrimaryIP>192.168.2.123</PrimaryIP>
120 <DisplayIP>192.168.2.123</DisplayIP>
121 <VersionString>1.2.3</VersionString>
122 <IsManaged>false</IsManaged>
123 </TClient_V3>
124 </Clients>
125 </TSaveClientsRequest_V3>
126 </SaveClients>
127 </ACMP>
128 </ICQL>
129 {{/apimacro}}
130
131 {{apimacro title="SaveClients_V3 Response"}}
132 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveClientsResponse_V3">
133 <ACMP>
134 <SaveClients version="3">
135 <TSaveClientsResponse_V3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
136 <Clients>
137 <TClient_V3 xsi:type="TClient_V3">
138 <ClientId>{B03D2CCD-ADC1-4B9D-BDB8-87564B94030C}</ClientId>
139 <ComputerName>MyComputer</ComputerName>
140 <ComputerDomain>mydomain.local</ComputerDomain>
141 <MacAddress>00-80-41-ae-fd-7e</MacAddress>
142 <ComputerSid>S-1-5-21-3341858414-824459133-3810899301</ComputerSid>
143 <ActiveDirectoryObjectId>{B6C18E5F-26C1-4769-8E09-0D171F94415C}</ActiveDirectoryObjectId>
144 <ClientType>ctService</ClientType>
145 <PrimaryIP>192.168.2.123</PrimaryIP>
146 <DisplayIP>192.168.2.123</DisplayIP>
147 <VersionString>1.2.3</VersionString>
148 <IsManaged>false</IsManaged>
149 </TClient_V3>
150 </Clients>
151 </TSaveClientsResponse_V3>
152 </SaveClients>
153 </ACMP>
154 </ICQL>
155 {{/apimacro}}
156
157 = Clients löschen =
158
159 {{apimacro title="DeleteClients_V1 Request"}}
160 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/DeleteClientsRequest_V1">
161 <ACMP>
162 <DeleteClients ActionType="Request" version="1">
163 <TDeleteClientsRequest_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
164 <ClientIds>
165 <string>{9C09B35F-8990-4575-9E83-2BAF22C5EBC9}</string>
166 </ClientIds>
167 </TDeleteClientsRequest_V1>
168 </DeleteClients>
169 </ACMP>
170 </ICQL>
171 {{/apimacro}}
172
173 {{apimacro title="DeleteClients_V1 Response"}}
174 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/DeleteClientsResponse_V1">
175 <ACMP>
176 <DeleteClients ActionType="Response" version="1">
177 <TDeleteClientsResponse_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
178 <ResultCode>0</ResultCode>
179 <ResultMessage>ResultMessage</ResultMessage>
180 </TDeleteClientsResponse_V1>
181 </DeleteClients>
182 </ACMP>
183 </ICQL>
184 {{/apimacro}}
185
186 = Client ID anfragen =
187
188 Mit Hilfe des Commands kann deine Client ID beim ACMP Server angefragt werden. Alle Eigenschaften im Request müssen befüllt sein, sodass der ACMP Server auch eine eindeutige Client ID zurückliefern kann.
189
190 {{apimacro title="GetClientId_V1 Request"}}
191 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/GetClientIdRequest_V1">
192 <ACMP>
193 <GetClientId ActionType="Request" version="1">
194 <TGetClientIdRequest_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
195 <MachineId>{6B851FFB-ACF2-438F-A322-258BA0F8DAAC}</MachineId>
196 <ComputerName>MyComputer</ComputerName>
197 <MacAddress>00-80-41-ae-fd-7e</MacAddress>
198 </TGetClientIdRequest_V1>
199 </GetClientId>
200 </ACMP>
201 </ICQL>
202 {{/apimacro}}
203
204 {{apimacro title="GetClientId_V1 Response"}}
205 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/GetClientIdResponse_V1">
206 <ACMP>
207 <GetClientId ActionType="Response" version="1">
208 <TGetClientIdResponse_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
209 <ClientId>{9C09B35F-8990-4575-9E83-2BAF22C5EBC9}</ClientId>
210 <ResultCode>0</ResultCode>
211 <ResultMessage>ResultMessage</ResultMessage>
212 </TGetClientIdResponse_V1>
213 </GetClientId>
214 </ACMP>
215 </ICQL>
216 {{/apimacro}}
217
218 === Mobile Devices anlegen ===
219
220 {{apimacro title="SaveMobileDevices_V1 Request"}}
221 <ICQL>
222 <ACMP>
223 <SaveMobileDevices ActionType="Request" version="1">
224 <TSaveMobileDevicesRequest_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
225 <MobileDevices>
226 <TMobileDevice_V1 xsi:type="TMobileDevice_V1">
227 <ClientId>{C889491A-0963-4392-8B3B-3363B9D7964B}</ClientId>
228 <DeviceName>DeviceName</DeviceName>
229 <Manufacturer>Manufacturer</Manufacturer>
230 <Model>Model</Model>
231 <Serialnumber>Serialnumber</Serialnumber>
232 <SystemUUID>SystemUUID</SystemUUID>
233 <DeviceCapacity>100000</DeviceCapacity>
234 <AvailableCapacity>80000</AvailableCapacity>
235 <User>User</User>
236 <EMail>EMail</EMail>
237 <IMEI>IMEI</IMEI>
238 <Status>Status</Status>
239 <LastConnected>1899-12-30T00:00:00.000Z</LastConnected>
240 <LastUpdate>1899-12-30T00:00:00.000Z</LastUpdate>
241 <PhoneNumber>PhoneNumber</PhoneNumber>
242 <CurrentCarrier>CurrentCarrier</CurrentCarrier>
243 <SimCarrierNetwork>SimCarrierNetwork</SimCarrierNetwork>
244 <CurrentMCC>CurrentMCC</CurrentMCC>
245 <ICCID>ICCID</ICCID>
246 <IsRoamingEnabled>false</IsRoamingEnabled>
247 <IsRoaming>false</IsRoaming>
248 <IsRooted>false</IsRooted>
249 <!
250 -- MobileDeviceType possible values:
251 0 = mdtAndroid
252 1 = mdtiOS
253 2 = mdtWindows
254 -->
255 <MobileDeviceType>mdtAndroid</MobileDeviceType>
256 <!
257 -- ImportSource possible values:
258 0 = MWays
259 1 = Exchange
260 2 = NotAvailable
261 3 = Sophos
262 -->
263 <ImportSource>MWays</ImportSource>
264 </TMobileDevice_V1>
265 </MobileDevices>
266 </TSaveMobileDevicesRequest_V1>
267 </SaveMobileDevices>
268 </ACMP>
269 </ICQL>
270 {{/apimacro}}
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community