Il metodo CloneMessage permette di eseguire duplicare un Messaggio Allows to duplicate a message in MailUp.
Method parameters
- int CloneMessage(string accessKey, string listId, string listGuid, int messageToCloneId, stringsubject)
...
- l'identificativo numerico del messaggio clonato.
- -1 in caso l'operazione non può essere portata a buon fine (ad esempio parametri errati o problemi di sistema).
Il metodo CloneMessage esegue in modo sincrono i seguenti passi:
- Clonazione dei dati di un Messaggio in MailUp
- Restituzione al chiamante dell'identificativo del Messaggio.
...
- accessKey:
- listId: : Identificativo numerico che individua univocamente una Lista di MailUp.
- listGuid: GUID che individua univocamente una Lista di MailUp.
- messageToCloneId: Identificativo numerico del messaggio che si vuole clonare.
- subject: Soggetto del messaggio clonato. Se null o vuoto sarà utilizzato il soggetto originale del messaggio origine.
...
- Nel primo caso la lista è verificata utilizzando entrambi i parametri.
- Nel secondo caso utilizzando il parametro fornito.
- access key obtained using the Login method
- listId: list identifier
- listGuid: GUID of the list in MailUp
- messageToCloneId: ID of the message to be cloned
- subject: subject of the cloned message. If null or empty, the subject will be the same as the original message
Parameters listGuid e listId can be used together or alternatively, passing one of them as null or empty: in the first case the list is verified using both parameters, otherwise using only the provided parameter.
The method returns:
- the ID of the cloned message
- "-1" if the operation is not completed successfully (e.g. due to incorrect parameters or system failure).
CloneMessage method synchronously executes the following steps:
- Duplication of the MailUp message
- ID of new message is returned to the caller
CloneMessage method asynchronously executes a copy of the files of the message to be cloned.
Note |
---|
Inconsistency: the response of CloneMessage method is different from many other MailUpSend methods because it does not include "errorCode" and "errorDescription" fields. |
SOAP Examples
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://services.mailupnet.it/WS">
<soap:Header/>
<soap:Body>
<ws:CloneMessage>
<!--Use accessKey value that is returned by LoginFromId method-->
<ws:accessKey>HzAgwRRJaAKBtkgNWpkAuURfV4SxMm6T3HJegRuSkUivKJElNNcmSQe8nqGyoM9</ws:accessKey>
<ws:listId>7</ws:listId>
<ws:listGuid>94abaa1a-e215-4c3d-8a9c-5c66b802d</ws:listGuid>
<ws:messageToCloneId>74</ws:messageToCloneId>
<ws:subject>I'm a cloned message</ws:subject>
</ws:CloneMessage>
</soap:Body>
</soap:Envelope> |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<CloneMessageResponse xmlns="http://services.mailupnet.it/WS">
<CloneMessageResult>-1</CloneMessageResult>
</CloneMessageResponse>
</soap:Body>
</soap:Envelope> |