<<

Inhaltsverzeichnis

Suchen

>>

 

SEND_MESSAGE

 

 

Funktion

 

 

Syntax:

SEND_MESSAGE(<Username des Empfängers>, <Computername des Empfängers>, <Programmname des Empfängers>, <Absender>, <Nachricht> [,<Klangdatei>, <Wiederholen>[,<Klangdatei übertragen>[,<Beenden>]]]])

 

<Username des Empfängers>

= <STRING-AUSDRUCK>

<Computername des Empfängers>

= <STRING-AUSDRUCK>

<Programmname des Empfängers>

= <STRING-AUSDRUCK>

<Absender>

= <STRING-AUSDRUCK>

<Nachricht>

= <STRING-AUSDRUCK>

<Klangdatei>

= <STRING-AUSDRUCK>

<Wiederholen>

= <NUM-AUSDRUCK>

<Klangdatei übertragen>

= <NUM-AUSDRUCK>

<Beenden>

= <NUM-AUSDRUCK>

 

 

Bedeutung:

Verschickt eine Nachricht über den Ebus-2T-Server an die am Ebus-2T-Server laufenden Programme.

 

Durch <Username des Empfängers>, <Computername des Empfängers> und <Programmname des Empfängers> werden die Empfänger der Nachricht festgelegt. Bei jedem dieser Parameter kann auch der Leerstring "" angegeben werden. Der Leerstring bedeutet alle Usernamen, alle Computernamen bzw. alle Programmnamen.

 

Die Nachricht wird an alle Programme geschickt, die die Bedingungen <Username des Empfängers>, <Computername des Empfängers> und <Programmname des Empfängers> erfüllen, mit Ausnahme des sendenden Programms. (Eine Nachricht kann nicht an sich selbst gesendet werden!)

 

Ist <Absender> <> "", so wird vor der Nachricht folgende Zeile eingefügt:

 

         Nachricht von <Absender>

 

<Nachricht> legt den Text der Nachricht fest. Ein Zeilenumbruch im Text wird durch die Variable EBUS_LINEFEED$ festgelegt.

 

Beim Empfänger wird ein Fenster mit der <Nachricht>, die durch Drücken des OK-Buttons quittiert werden muss, angezeigt.

 

Als <Klangdatei> kann ein Dateiname oder eine URL-Adresse angegeben werden. Ist <Klangdatei übertragen> = 0, so muss der Empfänger (Client) auf die <Klangdatei> zugreifen können.

 

Ist <Klangdatei übertragen> <> 0, so wird die <Klangdatei> vom Ebus-2T-Server zum Client übertragen. Die <Klangdatei> muss sich im Arbeitsverzeichnis des Ebus-2T-Servers befinden.

 

Ist eine <Klangdatei> angegeben, so wird die <Klangdatei> beim Empfänger abgespielt. Ist <Wiederholen> <> 0, so wird die <Klangdatei> so lange wiederholt, bis der Empfänger den OK-Button drückt.

 

Achtung: In Html-Programmen hat <Klangdatei> keine Wirkung.

 

Ist <Beenden> = 1, so werden alle Programme, die die Nachricht erhalten, beendet.

 

SEND_MESSAGE liefert als Ergebnis die Anzahl der benachrichtigten Empfänger.

 

SEND_MESSAGE liefert -1, falls ein Fehler auftrat.

 

Diese Funktion ist nur unter Java bei 2T-Programmen verfügbar, in allen anderen Fällen liefert sie als Ergebnis stets -1.

 

Parameter:

Username des Empfängers

Legt den Usernamen des Empfängers fest. Der Username ist der Name, den die Funktion GET_USERNAME$ liefert. Groß-/Kleinschreibung wird dabei nicht berücksichtigt.

 

Computername des Empfängers

Legt den Computernamen der Empfänger fest. Der Computername ist der Name, den die Funktion GET_COMPUTERNAME$ liefert. Groß- / Kleinschreibung wird dabei nicht berücksichtigt.

 

Programmname des Empfängers

Bezeichnet den Namen des Programms, an das die Nachricht gesendet werden soll (z.B. Faktura_2T). Groß-/Kleinschreibung wird dabei nicht berücksichtigt.

 

Absender

Name des Absenders

 

Nachricht

Text

 

Klangdatei

Wird beim Empfänger abgespielt.

 

Wiederholen

<> 0: Die Klangdatei wird so lange wiederholt, bis der Empfänger den OK-Button drückt.

= 0: Die Klangdatei wird einmal abgespielt.

 

Klangdatei übertragen

<> 0: Die Klangdatei wird vom Ebus-2T-Server zum Client übertragen.

 

Beenden

= 1: Alle Programme, die die Nachricht erhalten, werden beendet.

 

Beispiel:

/* Nachricht an alle Faktura-Programme senden

ANZAHL% = SEND_MESSAGE("","","Faktura_2T","Administrator",

               "Bitte Programm sofort beenden !" + EBUS_LINEFEED$ +

               "Die Datensicherung soll gestartet werden.")