Wiki-Quellcode von Helpdesk

Version 3.1 von Steffi F am 2025/06/13 09:36

Zeige letzte Bearbeiter
1 {{aagon.floatingbox/}}
2
3 === Save Ticket ===
4
5 Um ein Ticket anzulegen muss man zusätzlich zur ID auch einen Titel angeben. Im Schema ist der Titel nicht als mandatory markiert, weil man ihn sonst beim Editieren eines Tickets immer mit angeben müsste.
6
7 {{apimacro title="SaveTicket Request"}}
8 <ICQL xmlns="http://acmp.com/SaveTicketRequest_V1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
9 <ACMP>
10 <SaveTicket ActionType="Request" version="1">
11 <TSaveTicketRequest_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
12 <Id>{59387FFD-B171-47C5-B735-041FA132CA39}</Id>
13 <RequesterId>{59387FFD-B171-47C5-B735-041FA132CA39}</RequesterId>
14 <Title>Title</Title>
15 <HtmlDescription>HtmlDescription</HtmlDescription>
16 <AssigneeId>{59387FFD-B171-47C5-B735-041FA132CA39}</AssigneeId>
17 <CategoryId>{59387FFD-B171-47C5-B735-041FA132CA39}</CategoryId>
18 <ImpactId>{59387FFD-B171-47C5-B735-041FA132CA39}</ImpactId>
19 <PriorityId>0</PriorityId>
20 <StateId>{59387FFD-B171-47C5-B735-041FA132CA39}</StateId>
21 <ResolutionId>{59387FFD-B171-47C5-B735-041FA132CA39}</ResolutionId>
22 <Keywords>Keywords</Keywords>
23 <CustomFieldValues>
24 <TCustomFieldValue_V1 xsi:type="TCustomFieldValue_V1">
25 <FieldId>{59387FFD-B171-47C5-B735-041FA132CA39}</FieldId>
26 <Value>Value</Value>
27 </TCustomFieldValue_V1>
28 <TCustomFieldValue_V1 xsi:type="TCustomFieldValue_V1">
29 <FieldId>{59387FFD-B171-47C5-B735-041FA132CA39}</FieldId>
30 <Value>Value</Value>
31 </TCustomFieldValue_V1>
32 </CustomFieldValues>
33 </TSaveTicketRequest_V1>
34 </SaveTicket>
35 </ACMP>
36 </ICQL>
37 {{/apimacro}}
38
39
40 Falls man einen mehrzeiligen Text in die Ticketbeschreibung angeben möchte, kann man dies folgendermaßen machen:
41
42 |<HtmlDescription> Hello &lt;br /&gt; World23 </HtmlDescription>
43
44 {{apimacro title="SaveTicket Response"}}
45 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V1">
46 <ACMP>
47 <SaveTicket ActionType="Response" version="1">
48 <TSaveTicketResponse_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
49 <ResultCode>0</ResultCode>
50 <ResultMessage>ResultMessage</ResultMessage>
51 </TSaveTicketResponse_V1>
52 </SaveTicket>
53 </ACMP>
54 </ICQL>
55 {{/apimacro}}
56
57 {{apimacro title="SaveTicket Request V2"}}
58 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketRequest_V2">
59 <ACMP>
60 <SaveTicket ActionType="Request" version="2">
61 <TSaveTicketRequest_V2 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
62 <Ticket xsi:type="TTicket_V1">
63 <ID>{59387FFD-B171-47C5-B735-041FA132CA39}</ID>
64 <IntTicketId>0</IntTicketId>
65 <Requester xsi:type="TContactInfo_V1">
66 <ID>{59387FFD-B171-47C5-B735-041FA132CA39}</ID>
67 </Requester>
68 <Title>Title</Title>
69 <HtmlDescription>HtmlDescription</HtmlDescription>
70 <Assignee xsi:type="TContactInfo_V1">
71 <ID>{59387FFD-B171-47C5-B735-041FA132CA39}</ID>
72 </Assignee>
73 <CategoryId>{59387FFD-B171-47C5-B735-041FA132CA39}</CategoryId>
74 <ImpactId>{59387FFD-B171-47C5-B735-041FA132CA39}</ImpactId>
75 <PriorityId>0</PriorityId>
76 <StateId>{59387FFD-B171-47C5-B735-041FA132CA39}</StateId>
77 <ResolutionId>{59387FFD-B171-47C5-B735-041FA132CA39}</ResolutionId>
78 <Keywords>Keywords</Keywords>
79 <CustomFieldValues>
80 <TCustomFieldValue_V1 xsi:type="TCustomFieldValue_V1">
81 <FieldId>{59387FFD-B171-47C5-B735-041FA132CA39}</FieldId>
82 <Value>Value</Value>
83 </TCustomFieldValue_V1>
84 <TCustomFieldValue_V1 xsi:type="TCustomFieldValue_V1">
85 <FieldId>{59387FFD-B171-47C5-B735-041FA132CA39}</FieldId>
86 <Value>Value</Value>
87 </TCustomFieldValue_V1>
88 </CustomFieldValues>
89 </Ticket>
90 </TSaveTicketRequest_V2>
91 </SaveTicket>
92 </ACMP>
93 </ICQL>
94 {{/apimacro}}
95
96 {{apimacro title="SaveTicket Response V2"}}
97 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V2">
98 <ACMP>
99 <SaveTicket ActionType="Response" version="2">
100 <TSaveTicketResponse_V2 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
101 <ResultCode>0</ResultCode>
102 <ResultMessage>ResultMessage</ResultMessage>
103 </TSaveTicketResponse_V2>
104 </SaveTicket>
105 </ACMP>
106 </ICQL>
107 {{/apimacro}}
108
109 Beim Speichern eines Tickets werden vom Assignee nur die Felder "ID" und "AssigneeIsGroup" berücksichtigt. Name, Description, Email, UserType und Rollen eines Users oder einer Gruppe können nicht über dieses Command geändert werden.
110 {{apimacro title="SaveTicket Response V3"}}<ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V3">
111 <ACMP>
112 <SaveTicket ActionType="Response" version="3">
113 <TSaveTicketResponse_V3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
114 <ResultCode>0</ResultCode>
115 <ResultMessage>ResultMessage</ResultMessage>
116 </TSaveTicketResponse_V3>
117 </SaveTicket>
118 </ACMP>
119 </ICQL>{{/apimacro}}
120
121 (% class="showhide-header" data-show-duration="$effectduration" data-show-effect="$effect" %)
122 (((
123 (% class="showhide-header-flex" %)
124 (((
125 (% class="showhide-title" %)
126 (((
127 SaveTicket Response V3
128 )))
129
130 (% class="showhide-arrow" %)
131 (((
132
133 )))
134 )))
135 )))
136
137 (% class="showhidecontent" style="display: none;" %)
138 (((
139 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V3">
140 <ACMP>
141 <SaveTicket ActionType="Response" version="3">
142 <TSaveTicketResponse_V3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
143 <ResultCode>0</ResultCode>
144 <ResultMessage>ResultMessage</ResultMessage>
145 </TSaveTicketResponse_V3>
146 </SaveTicket>
147 </ACMP>
148 </ICQL>
149 )))
150
151
152 (% class="showhide-header" data-show-duration="$effectduration" data-show-effect="$effect" %)
153 (((
154 (% class="showhide-header-flex" %)
155 (((
156 (% class="showhide-title" %)
157 (((
158 SaveTicket Response V3
159 )))
160
161 (% class="showhide-arrow" %)
162 (((
163
164 )))
165 )))
166 )))
167
168 (% class="showhidecontent" style="display: none;" %)
169 (((
170 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V3">
171 <ACMP>
172 <SaveTicket ActionType="Response" version="3">
173 <TSaveTicketResponse_V3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
174 <ResultCode>0</ResultCode>
175 <ResultMessage>ResultMessage</ResultMessage>
176 </TSaveTicketResponse_V3>
177 </SaveTicket>
178 </ACMP>
179 </ICQL>
180 )))
181
182 (% class="showhide-header" data-show-duration="$effectduration" data-show-effect="$effect" %)
183 (((
184 (% class="showhide-header-flex" %)
185 (((
186 (% class="showhide-title" %)
187 (((
188 SaveTicket Response V3
189 )))
190
191 (% class="showhide-arrow" %)
192 (((
193
194 )))
195 )))
196 )))
197
198 (% class="showhidecontent" style="display: none;" %)
199 (((
200 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V3">
201 <ACMP>
202 <SaveTicket ActionType="Response" version="3">
203 <TSaveTicketResponse_V3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
204 <ResultCode>0</ResultCode>
205 <ResultMessage>ResultMessage</ResultMessage>
206 </TSaveTicketResponse_V3>
207 </SaveTicket>
208 </ACMP>
209 </ICQL>
210 )))
211
212 (% class="showhide-header" data-show-duration="$effectduration" data-show-effect="$effect" %)
213 (((
214 (% class="showhide-header-flex" %)
215 (((
216 (% class="showhide-title" %)
217 (((
218 SaveTicket Response V3
219 )))
220
221 (% class="showhide-arrow" %)
222 (((
223
224 )))
225 )))
226 )))
227
228 (% class="showhidecontent" style="display: none;" %)
229 (((
230 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V3">
231 <ACMP>
232 <SaveTicket ActionType="Response" version="3">
233 <TSaveTicketResponse_V3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
234 <ResultCode>0</ResultCode>
235 <ResultMessage>ResultMessage</ResultMessage>
236 </TSaveTicketResponse_V3>
237 </SaveTicket>
238 </ACMP>
239 </ICQL>
240 )))
241
242 (% class="showhide-header" data-show-duration="$effectduration" data-show-effect="$effect" %)
243 (((
244 (% class="showhide-header-flex" %)
245 (((
246 (% class="showhide-title" %)
247 (((
248 SaveTicket Response V3
249 )))
250
251 (% class="showhide-arrow" %)
252 (((
253
254 )))
255 )))
256 )))
257
258 (% class="showhidecontent" style="display: none;" %)
259 (((
260 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V3">
261 <ACMP>
262 <SaveTicket ActionType="Response" version="3">
263 <TSaveTicketResponse_V3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
264 <ResultCode>0</ResultCode>
265 <ResultMessage>ResultMessage</ResultMessage>
266 </TSaveTicketResponse_V3>
267 </SaveTicket>
268 </ACMP>
269 </ICQL>
270 )))
271
272 (% class="showhide-header" data-show-duration="$effectduration" data-show-effect="$effect" %)
273 (((
274 (% class="showhide-header-flex" %)
275 (((
276 (% class="showhide-title" %)
277 (((
278 SaveTicket Response V3
279 )))
280
281 (% class="showhide-arrow" %)
282 (((
283
284 )))
285 )))
286 )))
287
288 (% class="showhidecontent" style="display: none;" %)
289 (((
290 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V3">
291 <ACMP>
292 <SaveTicket ActionType="Response" version="3">
293 <TSaveTicketResponse_V3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
294 <ResultCode>0</ResultCode>
295 <ResultMessage>ResultMessage</ResultMessage>
296 </TSaveTicketResponse_V3>
297 </SaveTicket>
298 </ACMP>
299 </ICQL>
300 )))
301
302 (% class="showhide-header" data-show-duration="$effectduration" data-show-effect="$effect" %)
303 (((
304 (% class="showhide-header-flex" %)
305 (((
306 (% class="showhide-title" %)
307 (((
308 SaveTicket Response V3
309 )))
310
311 (% class="showhide-arrow" %)
312 (((
313
314 )))
315 )))
316 )))
317
318 (% class="showhidecontent" style="display: none;" %)
319 (((
320 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V3">
321 <ACMP>
322 <SaveTicket ActionType="Response" version="3">
323 <TSaveTicketResponse_V3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
324 <ResultCode>0</ResultCode>
325 <ResultMessage>ResultMessage</ResultMessage>
326 </TSaveTicketResponse_V3>
327 </SaveTicket>
328 </ACMP>
329 </ICQL>
330 )))
331
332 {{apimacro title="SaveTicket Request V4"}}
333 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketRequest_V4">
334 <ACMP>
335 <SaveTicket ActionType="Request" version="4">
336 <TSaveTicketRequest_V4 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
337 <Ticket xsi:type="TTicket_V4">
338 <ID>{59387FFD-B171-47C5-B735-041FA132CA39}</ID>
339 <Requester xsi:type="TContactInfo_V1">
340 <ID>{59387FFD-B171-47C5-B735-041FA132CA39}</ID>
341 </Requester>
342 <Title>Title</Title>
343 <HtmlDescription>HtmlDescription</HtmlDescription>
344 <Assignee xsi:type="TAssigneeInfo_V1">
345 <Id>{59387FFD-B171-47C5-B735-041FA132CA39}</Id>
346 <AssigneeIsGroup>false</AssigneeIsGroup>
347 </Assignee>
348 <CategoryId>{59387FFD-B171-47C5-B735-041FA132CA39}</CategoryId>
349 <ImpactId>{59387FFD-B171-47C5-B735-041FA132CA39}</ImpactId>
350 <PriorityId>0</PriorityId>
351 <StateId>{59387FFD-B171-47C5-B735-041FA132CA39}</StateId>
352 <ResolutionId>ResolutionId</ResolutionId>
353 <Keywords>Keywords</Keywords>
354 <CustomFieldValues>
355 <TCustomFieldValue_V1 xsi:type="TCustomFieldValue_V1">
356 <FieldId>{59387FFD-B171-47C5-B735-041FA132CA39}</FieldId>
357 <Value>Value</Value>
358 </TCustomFieldValue_V1>
359 <TCustomFieldValue_V1 xsi:type="TCustomFieldValue_V1">
360 <FieldId>{59387FFD-B171-47C5-B735-041FA132CA39}</FieldId>
361 <Value>Value</Value>
362 </TCustomFieldValue_V1>
363 </CustomFieldValues>
364 <Escalation xsi:type="TTicketEscalation_V1">
365 <Id>{59387FFD-B171-47C5-B735-041FA132CA39}</Id>
366 </Escalation>
367 <ScheduledForResubmission>false</ScheduledForResubmission>
368 <Resubmission xsi:type="TTicketResubmission_V1">
369 <Subject>Subject</Subject>
370 <Content>Content</Content>
371 <ExpirationDate>1899-12-30T00:00:00.000Z</ExpirationDate>
372 <Due>Pending</Due>
373 </Resubmission>
374 <PlainDescription>PlainDescription</PlainDescription>
375 <TemplateId>{59387FFD-B171-47C5-B735-041FA132CA39}</TemplateId>
376 </Ticket>
377 </TSaveTicketRequest_V4>
378 </SaveTicket>
379 </ACMP>
380 </ICQL>
381 {{/apimacro}}
382
383 Beim Speichern eines Tickets werden vom Assignee nur die Felder "ID" und "AssigneeIsGroup" berücksichtigt. Name, Description, Email, UserType und Rollen eines Users oder einer Gruppe können nicht über dieses Command geändert werden.
384
385 Wenn das verwendete Template als Status "Geschlossen" gesetzt hat, wird dies **nicht** von der API berücksichtigt. In diesem Fall muss die aufrufende Stelle im Anschluss an das SaveTicket_V4 Command noch ein CloseTicket_V1 Command schicken.
386
387 {{apimacro title="SaveTicket Response V4"}}
388 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/SaveTicketResponse_V4">
389 <ACMP>
390 <SaveTicket ActionType="Response" version="4">
391 <TSaveTicketResponse_V4 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
392 <ResultCode>0</ResultCode>
393 <ResultMessage>ResultMessage</ResultMessage>
394 </TSaveTicketResponse_V4>
395 </SaveTicket>
396 </ACMP>
397 </ICQL>
398 {{/apimacro}}
399
400 = CloseTicket =
401
402 Pflichtfelder:
403
404 **TicketId, Assignee**
405
406
407 Für dieses Command gibt es ein paar Felder, die unter bestimmten Voraussetzungen gesetzt sein müssen, da sonst der Request nicht valide ist.
408
409 **ResolutionId:** Wenn in den ACMP Einstellungen Resolutionen aktiviert sind, dann muss dieses Feld die Id einer Resolution beinhalten.
410
411 **Comment: **Wenn in den ACMP Einstellungen ein Kommentar zum Schließen eines Tickets erzwungen wird, dann muss dieses Feld ein Kommentarobjekt beinhalten bei dem die Felder Id und Text befüllt sein müssen. Die TicketId des Kommentarobjekts wird an dieser Stelle ignoriert.
412
413 **WorkingTime: **Wenn in den ACMP Einstellungen Arbeitszeiten für Tickets aktiviert sind und eine Arbeitszeit zum Schließen eines Tickets erzwungen wird, dann muss dieses Feld ein Arbeitszeitobjekt beinhalten bei dem die Felder Id, TicketId, Executor, StartDate und EndDate befüllt sind. StartDate muss kleiner sein als EndDate.
414
415 {{apimacro title="CloseTicket Request"}}
416 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/CloseTicketRequest_V1">
417 <ACMP>
418 <CloseTicket ActionType="Request" version="1">
419 <TCloseTicketRequest_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
420 <TicketId>{59387FFD-B171-47C5-B735-041FA132CA39}</TicketId>
421 <Comment xsi:type="TTicketComment_V3">
422 <ID>{59387FFD-B171-47C5-B735-041FA132CA39}</ID>
423 <TicketId>{59387FFD-B171-47C5-B735-041FA132CA39}</TicketId>
424 <IsPlainText>false</IsPlainText>
425 <CommentText>CommentText</CommentText>
426 <IsPublic>false</IsPublic>
427 <PublicRecipient>PublicRecipient</PublicRecipient>
428 <PublicCC>PublicCC</PublicCC>
429 <PublicBCC>PublicBCC</PublicBCC>
430 <IsVisibleForWeb>true</IsVisibleForWeb>
431 </Comment>
432 <CategoryId>{59387FFD-B171-47C5-B735-041FA132CA39}</CategoryId>
433 <Assignee xsi:type="TAssigneeInfo_V1">
434 <Id>{59387FFD-B171-47C5-B735-041FA132CA39}</Id>
435 <Name>Name</Name>
436 <AssigneeIsGroup>false</AssigneeIsGroup>
437 <Roles/>
438 </Assignee>
439 <ResolutionId>ResolutionId</ResolutionId>
440 <CloseLinkedTicketIds>
441 <string>{59387FFD-B171-47C5-B735-041FA132CA39}</string>
442 <string>{69387FFD-B171-47C5-B735-041FA132CA39}</string>
443 </CloseLinkedTicketIds>
444 <WorkingTime xsi:type="TTicketWorkingTime_V1">
445 <ID>{59387FFD-B171-47C5-B735-041FA132CA39}</ID>
446 <StartDate>1899-12-30T00:00:00.000Z</StartDate>
447 <EndDate>1899-12-30T00:00:00.000Z</EndDate>
448 <Description>Description</Description>
449 <Executor xsi:type="TContactInfo_V1">
450 <ID>{59387FFD-B171-47C5-B735-041FA132CA39}</ID>
451 </Executor>
452 </WorkingTime>
453 </TCloseTicketRequest_V1>
454 </CloseTicket>
455 </ACMP>
456 </ICQL>
457 {{/apimacro}}
458
459 {{apimacro title="CloseTicket Response"}}
460 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/CloseTicketResponse_V1">
461 <ACMP>
462 <CloseTicket ActionType="Response" version="1">
463 <TCloseTicketResponse_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
464 <ResultCode>0</ResultCode>
465 <ResultMessage>ResultMessage</ResultMessage>
466 </TCloseTicketResponse_V1>
467 </CloseTicket>
468 </ACMP>
469 </ICQL>
470 {{/apimacro}}
471
472 = ReopenTicket =
473
474 {{apimacro title="ReopenTicket Request"}}
475 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/ReopenTicketRequest_V1">
476 <ACMP>
477 <ReopenTicket ActionType="Request" version="1">
478 <TReopenTicketRequest_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
479 <TicketId>{59387FFD-B171-47C5-B735-041FA132CA39}</TicketId>
480 </TReopenTicketRequest_V1>
481 </ReopenTicket>
482 </ACMP>
483 </ICQL>
484 {{/apimacro}}
485
486 {{apimacro title="ReopenTicket Response"}}
487 <ICQL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://acmp.com/ReopenTicketResponse_V1">
488 <ACMP>
489 <ReopenTicket ActionType="Response" version="1">
490 <TReopenTicketResponse_V1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
491 <ResultCode>0</ResultCode>
492 <ResultMessage>ResultMessage</ResultMessage>
493 </TReopenTicketResponse_V1>
494 </ReopenTicket>
495 </ACMP>
496 </ICQL>
497 {{/apimacro}}
498
499
500
501
502
503
504
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community