Metodi dei servizi Web › Metodi di associazione › createAttachment

Argomento precedente: attachURLLinkToTicket

Argomento successivo: removeAttachment

createAttachment

I parametri seguenti sono validi per il metodo createAttachment:

Parametro

Tipo di dati

Descrizione

SID

INTEGER

Identifica la sessione recuperata dall'accesso.

repositoryHandle

STRING

Identifica l'handle di oggetto di un repository di documenti.

objectHandle

STRING

Identifica l'handle di oggetto di una richiesta di chiamata, di un ordine di cambiamento o di una questione a cui è associato l'allegato.

Questo parametro può essere NULL (nullo), tuttavia è necessario gestire l'ID allegato che viene restituito, in quanto l'allegato non è associato a un ticket, quando il parametro è nullo.

descrizione

STRING

Identifica la descrizione dell'oggetto di associazione.

fileName

STRING

Identifica il percorso completo del file da caricare.

Descrizione

Carica un file sul server di backend. Un file caricato viene memorizzato in un repository di documenti specificato dal parametro repositoryHandle. Viene quindi creato un oggetto di associazione e associato a un oggetto ticket specificato dal parametro objectHandle. L'oggetto di associazione dispone di tutte le informazioni per accedere al nuovo file caricato nel repository.

Valore restituito

createAttachment restituisce quanto segue:

Parametro

Tipo

Descrizione

<Handle>

STRING

Identifica l'handle di oggetto del nuovo oggetto di associazione creato.

Impossibile eseguire l'operazione, limite policy superato

Sintomo:

Quando si utilizza il metodo del servizio Web createAttachment() per allegare un documento ad una richiesta o incidente esistente, viene visualizzato questo errore, anche quando l'impostazione della policy dei servizi Web per gli allegati è impostata su -1(illimitato), ovvero l'impostazione predefinita. Questo errore potrebbe essere visualizzato quando si chiama il metodo del servizio Web, quando non sono presenti file allegati nel messaggio SOAP ricevuto. È necessario allegare almeno un file al messaggio SOAP prima di chiamare il metodo del servizio Web createAttachment().

Soluzione:

Impostare l'implementazione SOAP sul supporto DIME (Direct Internet Message Encapsulation) e associare il file da caricare manualmente mediante il supporto DIME prima di chiamare il metodo createAttachment().

Esempio: Visual Basic .NET

In questo esempio di codice viene illustrato il codice Visual Basic .NET di esempio per allegare un file mediante il supporto DIME prima di chiamare il metodo del servizio Web 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")

Nota: per informazioni sui metodi di associazione DIME utilizzati nel codice di esempio precedente, vedere il sito Web Microsoft. Per i programmi scritti in altre lingue, consultare la documentazione relativa all'implementazione SOAP con supporto DIME.

Esempio: Java

In questo esempio di codice viene illustrato il codice Java di esempio per allegare un file mediante il supporto DIME prima di chiamare il metodo del servizio Web 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);