Weitere Services
Die folgenden Methoden stellen die weiteren Services dar, die
durch das Nachrichtensystem für ausgehende Nachrichten zur Verfügung
gestellt werden:
- public void addMember(Long aMember)
Diese Methode ist - neben der Methode 'setConfigData'
- die zweite Möglichkeit,
Empfängerdaten in das Nachrichtensystem einzugeben. Der Parameter stellt ein gültiges Mitglied dar. Der Benutzer kann
diese Methode wiederholt aufrufen und bei jedem Aufruf ein weiteres
Mitglied zur Empfängerliste hinzufügen. Intern lagert das Nachrichtensystem die entsprechende Adresse aus dem
Mitglied aus.
Anmerkung 1: Es muss unbedingt sichergestellt
sein, dass für die Adresse des Mitglieds eine Gültigkeitsprüfung
vorgenommen wird.
Anmerkung 2: Der Empfänger kann entweder mit
der Methode 'addMember' oder mit der Methode 'setConfigData', jedoch
nicht mit beiden Methoden festgelegt werden. Wenn beide Methoden eingegeben werden, werden die Einträge von
setConfigData durch die Einträge von addMember überschrieben. Bitte beachten Sie auch, dass der Benutzer für das Nachrichtensystem
die Empfänger eingeben muss, bevor der Inhalt gesendet wird. Dies liegt daran, dass Mitgliedsdaten den in einer Nachricht
verwendeten Inhalt verändern können.
- public void remTransport(Integer aRemoveTransportID)
Diese Methode macht Sie hinsichtlich der Transporte,
die für die Zustellung der Methode verwendet werden, flexibel. Der Parameter sollte eine für diese Nachrichtenart gültige Transport-ID
sein. Sobald diese Methode aufgerufen wird, entfernt das Nachrichtensystem
den Transport aus der Nachrichtenliste mit den Transporten, die
verwendet werden können. Mit anderen Worten: Der als Parameter übergebene Transport wird für
diesen speziellen Nachrichtenaufruf inaktiviert.
- public void setPartialSend(Boolean partialSend)
Diese Methode kann nur angewendet werden, wenn die
Empfänger mit der Methode 'addMember' festgelegt werden. Der Boolesche Parameter gibt an, welche Teilsendungen zulässig sind. Im Nachrichtensystem wird als Teilsendung das Senden einer Nachricht
bezeichnet, das ausgeführt wird, solange dem Profil eines der
hinzugefügten
Mitglieder eine bevorzugte E-Mail-Adresse zugeordnet ist. Nachfolgend eine Erläuterung der Parameter für partialSend:
- true: Teilsendungen sind zulässig. Mitglieder,
für die nicht an der entsprechenden Stelle eine Adresse definiert
ist, werden beim Senden übersprungen.
- false: Das Senden muss entweder
vollständig oder kann gar nicht ausgeführt werden. Wenn nur eines der
Mitglieder nicht über eine entsprechend konfigurierte E-Mail-Adresse
verfügt, wird eine Ausnahmebedingung zurückgegeben.
- Anmerkung: Das Nachrichtensystem nimmt keine
Gültigkeitsprüfung hinsichtlich des korrekten Formats einer Adresse
vor. Bei einer Teilsendung wird davon ausgegangen, dass an der
entsprechenden Stelle ein Wert vorhanden ist.