createAttachment

Web-Service-Methoden › Anhängemethoden › createAttachment

createAttachment

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

Parameter	Datentyp	Beschreibung
SID	INTEGER	Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.
repositoryHandle	STRING	Gibt die Objektkennung eines Dokument-Repositorys an.
objectHandle	STRING	Gibt die Objektkennung eines Aufruf-Request, Change oder Issue an, an den dieser Anhang angehängt wird. Dieser Parameter kann NULL sein. Allerdings müssen Sie die zurückgegebene Anhangs-ID verwalten, da der Anhang keinem Ticket zugeordnet wird, wenn NULL weitergegeben wird.
description	STRING	Gibt die Beschreibung für das Anhangobjekt an.
fileName	STRING	Gibt den vollständigen Pfad der zu ladenden Datei an.

Beschreibung

Lädt eine Datei auf den Backend-Server. Eine geladene Datei wird in einem durch repositoryHandle angegebenen Dokument-Repository gespeichert. Daraufhin wird ein Anhangobjekt erstellt und an ein durch objectHandle angegebenes Ticketobjekt angehängt. Das Anhangobjekt enthält alle Informationen für den Zugriff auf die neu geladene Datei im Repository.

Rückgabe

"createAttachment" gibt Folgendes zurück:

Parameter	Typ	Beschreibung
<Handle>	STRING	Gibt die Objektkennung des neu erstellten Anhangobjekts an.

Vorgang konnte nicht durchgeführt werden, Richtlinienlimit überschritten

Symptom:

Wenn Sie die Webservice-Methode "createAttachment()" zum Anhängen eines Dokuments an einen vorhandenen Request oder einen vorhandenen Incident verwenden, wird dieser Fehler angezeigt, auch wenn die Richtlinieneinstellung der Webservices auf den Standardwert "-1(unlimited)" gesetzt ist. Möglicherweise erhalten Sie diesen Fehler beim Aufrufen der Webservice-Methode, wenn die empfangene SOAP-Meldung keine angehängten Dateien enthält. Sie müssen der SOAP-Meldung vor dem Aufruf der Webservice-Methode "createAttachment()" mindestens eine Datei anhängen.

Lösung:

Richten Sie Ihre SOAP-Implementierung zum Unterstützen von Direct Internet Message Encapsulation (DIME) ein, und hängen Sie die hochzuladende Datei mithilfe von DIME-Unterstützung an, bevor Sie die Methode "createAttachment()" aufrufen.

Sie können sich auf die Beispiele an beziehen wie unterstützen ZEHNCENTSTÜCK vom $NX_ROOT\samples\sdk\websvc\java\test3_attachments-Verzeichnis.

Beispiel: Visual Basic .NET

Dieses Code-Beispiel veranschaulicht Visual Basic .NET-Beispielcode zum Anhängen einer Datei mithilfe von DIME-Unterstützung vor dem Aufrufen der Webservice-Methode "createAttachment()".

Dim reqContext As SoapContext = objUSD_WS.RequestSoapContext
Dim dimeAttach As New DimeAttachment("image/gif",
TypeFormat.MediaType, "c:\test.txt")
reqContext.Attachments.Add(dimeAttach)

strResult = objUSD_WS.createAttachment(sid, "doc_rep:1002",
"cr:400001", "my desc", "c:\test.txt")

Hinweis: Informationen zu den im vorherigen Beispiel verwendeten DIME-Anhangsmethoden finden Sie auf der Microsoft-Website. In anderen Sprachen geschriebene Programme finden Sie in der Dokumentation für die SOAP-Implementierung, die DIME unterstützt.

Beispiel: Java

Dieses Code-Beispiel veranschaulicht Java-Beispielcode zum Anhängen einer Datei mithilfe von DIME-Unterstützung vor dem Aufrufen der Webservice-Methode "createAttachment()".

FileDataSource fds = new FileDataSource(filename);
DataHandler dhandler = new DataHandler(fds);
usd._setProperty(Call.ATTACHMENT_ENCAPSULATION_FORMAT,
Call.ATTACHMENT_ENCAPSULATION_FORMAT_DIME);
usd.addAttachment(dhandler);

String handle = usd.createAttachment(sid, repHandle, objHandle,
description, filename);