createTicket

Web-Service-Methoden › Geschäftsmethoden › createTicket

createTicket

Die folgenden Parameter gelten für die Methode „createTicket“:

Parameter	Typ	Beschreibung
SID	Ganzzahl	Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.
Beschreibung	Zeichenfolge	(optional) Gibt die Beschreibung des Tickets an.
problem_type	Zeichenfolge	Gibt den Code (nicht die permanente ID) für einen vorhandenen Problemtyp für die Richtlinie an, unter der eine Webservices-Anwendung ausgeführt wird. Wenn dieses Feld leer ist oder einen ungültigen Wert enthält, wird der Standardproblemtyp verwendet.
Anwender-ID	Zeichenfolge	(optional) Gibt die Anwender-ID des Endanwenders für das neue Ticket an. Wenn dieses Feld leer ist oder die angegebene Anwender-ID nicht gefunden wird, wird der in der Zugriffsrichtlinie definierte Proxy-Kontakt verwendet, und das Ticket wird dennoch erstellt.
Asset	Zeichenfolge	(optional) Gibt die Kennung einer Anlage an, die an ein Ticket angehängt werden soll.
DuplicationID	Zeichenfolge	(optional) Ermöglicht es Anrufern, die Duplikatbehandlungsroutinen zu unterstützen, die zur Klassifizierung von Tickets als eindeutig oder unterschiedlich verwendet werden. Bei aktivierter Duplikatbehandlung wird diese Zeichenfolge überprüft, nachdem andere Duplikatbehandlungskriterien zur Feststellung, ob dies ein eindeutiger oder doppelter Aufruf dieser Methode ist, erfüllt wurden. Weitere Informationen über die Ticketduplikatbehandlung finden Sie unter „Ticketduplikatbehandlung“.
newTicketHandle	StringHolder	Bezeichnet das "StringHolder"-Objekt zum Erfassen von zurückgegebenen Daten. Weitere Informationen finden Sie unten in der Liste der XML-Elementrückgabe.
newTicketNumber	StringHolder	Bezeichnet das "StringHolder"-Objekt zum Erfassen von zurückgegebenen Daten. Weitere Informationen finden Sie unten in der Liste der XML-Elementrückgabe.
returnUserData	StringHolder	Bezeichnet das "StringHolder"-Objekt zum Erfassen von zurückgegebenen Daten. Weitere Informationen finden Sie unten in der Liste der XML-Elementrückgabe.
returnApplicationData	StringHolder	Bezeichnet das "StringHolder"-Objekt zum Erfassen von zurückgegebenen Daten. Weitere Informationen finden Sie unten in der Liste der XML-Elementrückgabe.

Beschreibung

Erstellt ein Ticket auf Grundlage der Regeln, die sowohl in der Service-Aware-Richtlinie als auch im angegebenen Problemtyp definiert sind. Der Problemtyp legt den Typ des Tickets fest, das durch die Request-/Change-/Issue-Vorlage erstellt wird. Die angegebene Beschreibung wird hineinkopiert, und der Anwender wird über den Proxy-Kontakt der Zugriffsrichtlinie festgelegt.

Ist "problem_type" nicht vorhanden, wird der Standardproblemtyp der Richtlinie verwendet. Durch den Problemtyp wird außerdem festgelegt, wie mit erstellten Ticketduplikaten und mit zusätzlich zurückgegebenen Daten zu verfahren ist. Ausführliche Informationen zur Konfiguration von Zugriffsrichtlinien und Problemtypen finden Sie im Implementierungshandbuch.

Rückgabe

Gibt die neue Ticketkennung, die Ticketnummer sowie die vom Anwender festgelegten Rückgabedaten zurück, die im Problemtyp, der zur Erstellung des Tickets verwendet wird, definiert sind.

XML-Element	Typ	Beschreibung
<UDSObject>	N. rel.	Gibt das XML-Element zurück, sodass es konsistent mit der Rückgabe der anderen Methoden ist: createRequest() createChange() createIssue() Dieser Tag hat keinen Inhalt.
<newTicketHandle>	Zeichenfolge	Gibt die neue Ticketkennung an.
<newTicketNumber>	Zeichenfolge	Gibt die neue Ticketnummer an (sein "ref_num"- oder "chg_ref_num"-Attribut).
<returnUserData>	Zeichenfolge	Gibt die vom Anwender angegebenen Daten für den Problemtyp an, die dem Endanwender angezeigt werden sollen, oder die für Protokolleinträge vorgesehen sind. Sie können diesen Wert im Feld "Anwenderdatenrückgabe" auf der Registerkarte "Rückgabedaten" des Fensters "Problemtyp - Detail" festlegen.
<returnApplicationData>	Zeichenfolge	Gibt die vom Anwender angegebenen Daten für den Problemtyp an, die zur Verwendung innerhalb des Anwendungscodes, insbesondere für Aktionen, vorgesehen sind. Sie können diesen Wert im Feld "Anwendungsdatenrückgabe" auf der Registerkarte "Rückgabedaten" des Fensters "Problemtyp - Detail" festlegen.