'you have mail' Template Detail

Bei einem Template handelt es sich um eine Vorlage für eine Message, welche durch das Programm aufbereitet und verschickt wird. Es gibt 2 Typen von Templates, den Typ SMS und den Typ HTML. Der Typ SMS wird für Messages an SMS Telefonempfänger verwendet, der Typ HTML wird für EMail-Empfänger verwendet.  Ein Template ist immer einer Sprache zugewiesen, dass heisst je nach Empfänger und dessen Spracheinstellung (entweder in den Stammdaten der Person, oder in den Hierarchischen Custfields des Empfängers) wird das dieser Sprache zugewiesene Template verwendet. Sollten mehrere Templates pro Sprache vorhanden sein, wird einfach das erste verfügbare verwendet.
Ein Template kann Variablen im Format <%Variablenname%> enthalten, die beim Versand abgefüllt werden. Ein Empfänger einer 'you have mail' Message kann eine Person, deren Stellvertreter oder ein Kunde/Kostenstelle sein. Die Templates können mittels der Schaltfläche Test getestet werden.

Ansicht

Das Template verfügt über 3 Attribute welche eingestellt werden können. Dabei handelt es sich um den Typ und die Sprache welche mittels Kombinationsfeld dargestellt. Der Inhalt des Templates kann mittels dem angezeigten Texteditor bearbeit werden. Auf der rechten Seite befinden sich die Schaltflächen mit den verfügbaren Funktionen.

Bedienung

  • OK
    Schliesst diesen Dialog und speichert das Template ab.

  • Abbrechen
    Schliesst diesen Dialog ohne das Template zu speichern. Alle erfolgten Änderungen gehen verloren.

  • Test
    Mit dieser Funktion kann das bearbeitet Template zu Testzwecken verschickt werden. Je nach Typ wird eine EMail oder ein SMS verschickt. Der Empfänger, also die Mobilnummer oder EMail-Adresse kann mit dem darauffolgenden separaten Detaildialog eingegeben werden. Die Eingabe bleibt erhalten bis zum nächsten Testaufruf.

Einstellungen SMS

Folgende Custfields müssen für die korrekte Verwendung von yhm über SMS eingestellt werden: (Entität 1616)

Name

Typ

Wert

Beschreibung

strIMASYSID 1   Das ist die Identifikation des Absenders, also von Ihnen.
strIMASYSUsername 13   Erfassen Sie hier den Benutzernamen des IMASYS Gatewayzugangs.
strIMASYSPassword 13   Erfassen Sie hier das Passwort für den IMAYS Gatewayzugang.

Template Attribute

  • Typ
    Mittels Kombinationsfeld kann ausgewählt werden zwischen dem Typ SMS und HTML. Bitte beachten Sie, dass wenn Sie den Typ SMS verwenden, die Nachrichten je nach Telefonprovider und/oder Telefon begrenzt sein können.

  • Sprache
    In diesem Kombinierten Feld können Sie entweder die Sprache auswählen oder selber eingeben. Es werden alle bereits vorhandenen Sprachen die bisher für Templates verwendet wurden, angezeigt. Bitte beachten Sie das Gross-/Kleinschreibung ignoriert wird.

  • Text
    Hier handelt es sich um den eigentlichen Text der Vorlage, welcher aufbereitet und verschickt wird. Sie können diesen Text nach belieben bearbeiten. Auf der Linken Seite werden die Zeilennummern des Textes dargestellt.

Templatetext

Bei diesem Text kann es sich um einen Beliebigen Text in einer beliebigen Sprache handeln, ebenso ist die Länge des Textes im Editor selber nicht beschränkt, beachten Sie jedoch die Beschränkungen Aufgrund des Template-Types.
Da eine 'you have mail' Message für mehrere Sendungen an einen oder mehrere Empfänger verschickt werden kann, gibt es unterschiedliche Variablen, die pro Empfänger nur einmalig sind, oder die pro Sendung einen Wert enthalten können. Aus diesem Grund gibt es spezielle Befehle in einem Template, das dem Programm mitteilt, ob ein Textabschnitt wiederholend pro Sendung ist.
Wenn Sie den Typ HTML verwenden, beachten Sie dass Sie auch den Text als HTML-Fragment korrekt erfassen mit den entsprechenden HTML-Tags. Hier finden Sie die möglichen Message-Typen und einige Vorlagen für Templates.

Template Variablen

Variablenname (Platzhalter) Beschreibung
<%BeginItemList%> Dieser Befehl signalisiert dem Programm, dass eine Sendungsliste ausgegeben wird, dass heisst für alle Sendungen eines Empfängers werden gewisse Werte in die Liste eingesetzt. Wenn dieser Befehl fehlt, wird der Templatetext nicht mir Werten aus der Sendung abgefüllt.
<%EndItemList%> Dieser Befehl sollte am Ende des Templatetextes stehen, wenn es sich um eine Sendungsliste handelt.
<%BeginItem%> Dieser Befehl markiert den Bereich, der sich pro Sendung innerhalb einer Message wiederholt. Berücksichtigen Sie dies, indem der entsprechende HTML-Text wiederholend sein kann, zum Beispiel bei einer Tabelle.
<%EndItem%> Dieser Befehl markiert das Ende des sich wiederholenden Bereichs.
Variablen die nur einmal pro Message ausgegeben werden
<%Title%> Anrede des Message-Empfängers
<%Lastname%> Nachname oder Attribut Name2 des Message-Empfängers
<%Firstname%> Vorname oder Attribut Name1 des Message-Empfängers
<%NrItems%> Anzahl Sendungen, welche für diesen Message-Empfänger und die entsprechende Message verarbeitet werden.
<%PIN%> PIN Nummer des Mitarbeiters, wenn mehrere PIN's vergeben, werden diese hintereinander aufgelistet.
Variablen die pro Sendung ausgegeben werden (Sendungsliste)
<%UPOC%> UPOC der Sendung
<%CaptureDate%> Erfassungsdatum und Zeit der Sendung
<%Service%> Leistung der Sendung
<%Extraservice%> Zusatzleistungen auf der Sendung, in der Form Extraservice Bezeichnung Menge, Preis:
<%Alternativcode%> Alternativcode der Sendung
<%Serviceprovider%> Dienstleister der Sendung. Der Dienstleister wird aufgrund des zugewiesenen Bezirks der Sendung ermittelt (Dienstleisterzone)
<%LU%> Logistikeinheit der Sendung, falls eine solche zugewiesen wurde.
<%MBS%> Name der BK-Anlage aufgrund des zugewiesenen Fachs.
<%Binnr%> Fachnummer
<%SIx%> SIx der Sendung
<%KKSNr%> Nummer des Kunden oder der Kostenstelle der Sendung
<%ReceiverLastname%> Vorname und Name des Sendungs-Empfänger
<%ReceiverStreet%> Strasse und Hausnummer der Empfängeradresse
<%ReceiverZip%> Postleitzahl der Empfängeradresse
<%ReceiverCity%> Ort/Ortsteil der Empfängeradresse
<%ReceiverCountry%> Land der Empfängeradresse

Beispiel:

<%BeginItemlist%>
    <table border="1">
    <tr>
    <th>UPOC</th>
    <th>Eingangsdatum</th>
    <th>Leistung</th>
    <th>Zusatzleistung</th>
    <th>Alternativcode</th>
    <th>Dienstleister</th>
    <th>LUr</th>
    <th>MBS</th>
    <th>BinNr.</th>
    <th>SIx</th>
    <th>Empfänger Vorname/Name</th>
    <th>Empfänger Strasse</th>
    <th>Empfänger PLZ Ort</th>
    <th>Empfänger Land</th>
    </tr>
    <%BeginItem%>
        <tr>
        <td><%UPOC%></td>
        <td><%CaptureDate%></td>
        <td><%Service%></td>
        <td><%Extraservice%></td>
        <td><%Alternativcode%></td>
        <td><%Serviceprovider%></td>
        <th><%LU%></th>
        <th><%MBS%></th>
        <th><%Binnr%></th>
        <th><%SIx%></th>
        <th><%ReceiverLastname%></th>
        <th><%ReceiverStreet%></th>
        <th><%ReceiverZip%><%ReceiverCity%></th>
        <th><%ReceiverCountry%></th>
        </tr>
    <%EndItem%>
    </table>
<%EndItemlist%>


CodX Software CodX Software AG
Sinserstrasse 47
6330 Cham
Switzerland
Support
http://support.codx.ch
CxSpickel