Versions Compared

Old Version 4

changes.mady.by.user Stefano Mantegazza

Saved on

compared with

New Version 5

changes.mady.by.user Stefano Mantegazza

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

 

SendMessageNL method

  • Richiede che il file dei contatti da importare sia depositato sui server di MailUp
  • Gestisce importazione ed invio per una lista specifica Diversamente dalle importazioni batch FTP da CSV, in questo caso non è possibile importare i contatti su liste diverse. Tutti i contatti del file sono da importare nella stessa lista.
  • Usa un file dei contatti deve essere scritto in formato CSV (ed opzionalmente compresso in formato ZIP). Il contenuto dei campi del file deve seguire le linee guida descritte in Appendice B
  • Non è in grado di eseguire verifiche sull'eventuale duplicazione di alcuni contatti all'interno del file (tale verifica è quindi in carico al sistema del cliente che crea il file)

...

  • Se data e ora hanno un valore che appartiene al passato l'invio è gestito come Invio Immediato. Il ritardo minimo prestabilito è calcolato in base al valore fornito dal parametro sendDelayTest:.
  • Se il valore di data/ora è successivo a quello attuale allora l'invio è gestito come Invio Schedulato Pianificato, programmato.

...

  • uguale o minore di zero. In questo caso il ritardo dell'Invio Immediato è un valore fisso definito in MailUp (Configurato in 20 minuti).
  • Maggiore di zero. In questo caso il ritardo dell'Invio Immediato corrisponde al valore del parametro.

...

timeDateSending

sendDelayTest

Data invio schedulata in MailUp

valore = MinValue Data e Ora o valore <= data attuale (Invio Immediato)

sendDelayTest > 0

data attuale + sendDelayTest

valore = MinValue Data e Ora o valore <= data attuale (Invio Immediato)

sendDelayTest <= 0

data attuale + Valore fisso definito in MailUp

valore > data attuale (Invio Schedulato
  • Requires the CSV file to be moved to MailUp servers
  • Manages import and sending for a specific list. Differently from batch FTP imports from a CSV file, this method does not allow to import contacts to different lists. All recipients must be imported in the same list
  • The file containing the recipients must be in CSV format (and possibly zipped).The file and its field must be structured following the guidelines contained in the Appendix B
  • Cannot perform a check on the possible duplication of contacts in the file, so the customer's system creating the file has to take on this check.



The combination of the parameters timeDateSending and sendDelayTest determines the date of the scheduled sending 

TimeDateSending parameter can assume the following values:

  • If date and time refer to the past the sending is handled as an Immediate sending. Minimum delay depends on the valure provided by sendDelayTest parameter.
  • If date and time indicate a time in the future then the sending is handled as a Scheduled sending

SendDelayTest is considered only if the value provided by timeDateSending parameter indicates an Immediate sending.

This parameter can assume the following values:

  • = or < 0. In this case the delay of the immediate sending is a fixed value defined in MailUp (setup takes 20 minutes).
  • > 0. The delay of the immediate sending is the value assumed by the parameter.


How a sending is scheduled according to the parameters timeDateSending e sendDelayTest is summed up in the following table

timeDateSending

sendDelayTest

Scheduled sending date in MailUp

value <= current date (Immediate sending)

sendDelayTest > 0

current date + sendDelayTest

value <= current date (Immediate sending)

sendDelayTest <= 0

current date + fixed value in MailUp

value > current date (Scheduled sending)

sendDelayTest > 0

timeDateSending

valore value > data attuale (Invio Schedulatocurrent date (Scheduled sending)

sendDelayTest <= 0

timeDateSending

Tabella 7: Calcolo programmazione invio
Il metodo restituisce:

...

...

The method returns

  • ID of the sending
  • -1 in case the operation is not completed successfully (e.g. incorrect parameters or system failure).