SmsService

Dieser Service ist veraltet (deprecated).

Der SmsService ist zuständig für das Empfangen und Versenden von SMS-Nachrichten unter Nutzung von SMS-Providern.

Hierfür sind für unterschiedliche SMS-Provider entsprechende SMS-Manager implementiert, die die jeweiligen Schnittstellen für den Versand bedienen.

XML-Konfiguration

Folgendes XML-Fragment aktiviert das Weiterleiten von eingegangenen SMS-Nachrichten an den MessageService.

<Call name="enableMessageService">
	<Arg>messageService</Arg>
	<Arg>context</Arg>
	<Arg>queue</Arg>
</Call>

Die Parameter haben dabei die folgende Bedeutung.

Parameter	Beschreibung
messageService	Der Name des MessageServices, der verwendet werden soll.
context	Der zu verwendende Message-Kontext.
queue	Die zu verwendende Message-Queue.

Existiert die angegebene Consumer-Queue noch nicht, wird diese automatisch angelegt.

Hinzufügen eines SMS-ProviderManagers

Folgendes XML-Fragment fügt einen ProviderManager hinzu.

<Call name="addManager">
	<Arg>
		<New class="Name der Providerklasse">
			[Providerklassenspezifische Einstellungen]
		</New>
	</Arg>
</Call>

Die einzelnen Bereiche sollten selbsterklärend sein, bzw. werden im weiteren Verlauf beschrieben.

Hinzufügen und Konfigurieren des MindMaticsManagers

Der MindMaticsManager erlaubt es, SMS-Nachrichten unter Nutzung der webbasierten Schnittstelle der Firma Mindmatics zu versenden. Ebenfalls ist es möglich, SMS-Nachrichten per Servlet von Mindmatics zu empfangen. Der Klassenname für das Hinzufügen zum SMSService lautet com.ebd.hub.services.sms.MindMaticsManager.

Grundkonfiguration durch Nutzung der XML-Datei

Folgendes XML-Fragment mit allen möglichen Basiseinstellungen kann für die Konfiguration des MindMaticsManagers verwendet werden (alphabetisch sortiert).

<Set name="name">MindMaticsManager</Set>
<Set name="passwd">mmpassword</Set>
<Set name="prefix">+49</Set>
<Set name="URL">http://www.mindmatics.de/cgi-bin/sendsmsifn.pl</Set>
<Set name="user">user</Set>

Dabei haben die Parameter die folgende Bedeutung.

Parameter	Bedeutung
name	Der Name des Managers, wie er in der Informationsübersicht erscheinen soll.
passwd	Das für die Authentifizierung beim Server von Mindmatics zu verwendende Passwort.
prefix	Das beim Senden der Empfängernummer zu verwendende Präfix, wenn keine explizite Landesvorwahl angegeben wurde.
URL	Die URL, die verwendet werden soll, um SMS-Nachrichten zu versenden. Die im Beispiel zu sehende URL ist die standardmäßig eingestellte URL.
user	Der für die Authentifizierung beim Server von Mindmatics zu verwendende Benutzername.

Aktivieren des SMS-Empfangs

Für den Empfang von durch Mindmatics gesendete SMS-Nachrichten ist die Aktivierung des Empfangs-Servlets erforderlich. Dies erfolgt mit folgendem XML-Fragment, das in ./etc/hub.xml eingefügt werden muss.

<Call name="addContext">
	<Arg>/sms/*</Arg>
	<Call name="addServlet">
		<Arg>MindMatics SMS Provider</Arg>
		<Arg>/MindMaticsServlet</Arg>
		<Arg>com.ebd.hub.services.sms.MindMaticsServlet</Arg>
	</Call>
</Call>

Die URL, die Mindmatics bei der Partnervereinbarung genannt werden muss, wäre im obigen Beispiel die folgende und kann durch Änderung der entsprechenden Bereiche beliebig geändert werden.

http://host.server/sms/MindMaticsServlet

Hinweis: Das XML-Fragment ist üblicherweise bereits in der ./etc/hub.xml vorhanden, nur evtl. auskommentiert.

Hinzufügen und Konfigurieren des YapsManagers

Der YapsManager erlaubt das Senden von SMS-Nachrichten unter Nutzung des Programms yaps1. Dieses muss auf dem System installiert sein. Der Klassenname für das Hinzufügen zum SMSService lautet com.ebd.hub.services.sms.YapsManager.

Grundkonfiguration durch Nutzung der XML-Datei

Folgendes XML-Fragment mit allen möglichen Basiseinstellungen kann für die Konfiguration des YapsManagers verwendet werden.

<Set name="name">YapsManager</Set>
<Set name="command">/usr/bin/yaps</Set>

Dabei haben die Parameter die folgende Bedeutung.

Parameter	Bedeutung
name	Der Name des Managers, wie er in der Informationsübersicht erscheinen soll.
command	Das für das Senden der SMS-Nachricht zu verwendende Kommando.

Administration über Admin-Konsole

Die Administration des SMSServices über die Admin-Konsole wird derzeit nicht unterstützt.

Loglevel-Abhängigkeiten

Änderungen des Loglevels beim LogService haben keinen Einfluss auf das Logverhalten des SMSServices.

Wird der Service in den Verbose-Mode gesetzt, werden Meldungen über den genauen Aufbau der zu versendenden SMS und die eventuelle Rückmeldung eines verwendeten Servers bei der Übertragung der SMS dem Log hinzugefügt.