Empfängeradresse


Die Dokumentfunktion "Empfängeradresse" muss einer Vorlage angehängt werden, wenn der Empfängerdialog angezeigt werden soll. Im Konfigurationsfenster kann der Empfängerdialog auf verschiedene Weisen auf die Lösung massgeschneidert werden. In der Konfiguration verweisen mehrere Links auf die Globalen Konfigurationen, wo die Konfiguration der verschiedenen Anrede- und Grussformeln hinterlegt sind. Der genaue Wortlaut und Übersetzungen der Formeln können in den Globalen Übersetzungen angepasst werden.

Beispiel:

<?xml version="1.0"?> <RecipientAddressesConfiguration> <!-- Bestimmt, ob das Dokument ein Multibrief ist oder nicht --> <IsMultiLetter>true</IsMultiLetter> <!-- Maximal erlaubte Anzahl Empfänger (0 = keine Einschränkung) --> <MaxContacts>0</MaxContacts> <!-- Bestimmt, ob der Empfängerdialog in der detaillierten Ansicht geöffnet wird. --> <FullDetailMode>true</FullDetailMode> <!-- Adresstypen (z. B. An;Cc;Bcc) --> <AddressingTypes>{D[Recipients.AddressingType.To]};{D[Recipients.AddressingType.Cc]};{D[Recipients.AddressingType.Bcc]}</AddressingTypes> <!-- Generelle Empfängerkonfigurationen --> {[Recipients.GeneralRecipientsConfiguration]} <!-- AddressProvider-Konfigurationen --> {[Recipients.ProviderConfiguration]} <!-- Anrede-Konfigurationen --> {[Recipients.SalutationConfiguration]} <!-- Briefanrede-Konfigurationen --> {[Recipients.LetterSalutationConfiguration]} <!-- Grussformel-Konfigurationen --> {[Recipients.GreetingFormulaConfiguration]} <!-- Versandart-Konfigurationen --> {[Recipients.ShippingMethodConfiguration]} <!-- Simple view-Konfigurationen --> {[Recipients.SimpleViewConfiguration]} </RecipientAddressesConfiguration>

Konfigurationen in der Dokumentfunktion

Da diese Konfigurationen vorlagenspezifisch sind, werden sie jeweils direkt in die Dokumentfunktion "Empfängeradresse" geschrieben. Die Konfiguration sieht so aus:

  • IsMultiLetter
    Kann trueoder false enthalten und bestimmt, ob es sich bei der Vorlage um einen Multibrief handelt oder nicht.
    Speziell bei Multibriefen: Es wird jeweils nur ein Empfänger angezeigt und es kann zwischen den Empfängern hin- und hergewechselt werden.
    Typischer Nicht-Multibrief: Ein Protokoll, bei dem alle Empfänger eines Typs in Listenform unter "anwesend" aufgeführt werden.

  • MaxContacts
    Bestimmt, wieviele Empfänger maximal hinzugefügt werden können.
    0 bedeutet, dass es keine Obergrenze gibt.

  • FullDetailMode
    Kann trueoder false enthalten und bestimmt, ob die folgenden Details im Dialog sowie die einfache oder die detaillierte Ansicht beim Erstellen und Bearbeiten eines Empfängers angezeigt werden. Mehr zur SimpleView folgt unten.

  • AddressingTypes
    Hier können Anzeigenamen für die 3 Adresstypen konfiguriert werden, z. B. An;Cc;Bcc oder Anwesend;Abgemeldet;Verteiler, je nach Verwendungszweck der Adresstypen.


Allgemeine Konfigurationen

Die allgemeinen Konfigurationen werden in die Globalen Konfigurationen ausgelagert. Daher sieht die Konfiguration in der Dokumentfunktion so aus:

<!-- General recipients configuration --> {[Recipients.GeneralRecipientsConfiguration]}

Die Konfiguration in den Globalen Konfigurationen sieht wie folgt aus:

  • UseEnglishCountryNames
    Kann true oder false enthalten und bestimmt, ob Ländernamen immer englisch sind (true) oder ob sie in der Sprache der Installation des .NET Frameworks der aktuellen Maschine (entspricht meist der Systemsprache) ausgegeben werden (false).

  • PreferredRecipientId
    Falls die Vorlage über Connect aufgerufen und falls in der Connect-Datei Empfänger definiert sind: Hier wird anhand der Id bestimmt, welcher Empfänger ausgewählt sein soll.

  • CapitalizedCities
    Kann true oder false enthalten oder leer oder nicht vorhanden sein. Bestimmt, ob die Städtenamen im Adressblock in GROSSBUCHSTABEN geschrieben werden (true) oder nicht (false). Falls das Element leer oder nicht vorhanden ist, so wird diese Option durch den jeweiligen Adressprovider bestimmt. Bei manuell erstellten Kontakten gelten standardmässig Kleinbuchstaben (false).

  • SalutationOnSeparateLine
    Kann true oder false enthalten oder leer oder nicht vorhanden sein. Bestimmt, ob sich die Anrede im Adressblock auf einer eigenen Zeile befindet (true) oder auf derselben Zeile wie der Name (false). Falls das Element leer oder nicht vorhanden ist, so wird diese Option durch den jeweiligen Adressprovider bestimmt. Bei manuell erstellten Kontakten befindet sich die Anrede standardmässig auf einer eigenen Zeile (true).

  • DefaultLanguageCode
    Hat momentan keinen Effekt.

  • DefaultCountryCode
    Hier kann der Länder-Code des Standard-Landes gesetzt werden. Das Standard-Land ist jeweils zu Beginn ausgewählt.

  • CustomCountries
    Hier können mit folgendem Muster Länder hinzugefügt werden, die im Dialog standardmässig nicht vorhanden sind:
    <CustomCountry Name="Amerikanische Jungferninseln" EnglishName="United States Virgin Islands" ISO="VI" />


Adressprovider

Die Konfiguration der Adressprovider wird in die Globalen Konfigurationen ausgelagert. Daher sieht die Konfiguration in der Dokumentfunktion so aus:

<!-- Adressprovider-Konfigurationen --> {[Recipients.ProviderConfiguration]}

Mehr Informationen darüber, wie die Adressprovider konfiguriert werden, finden Sie unter Adressschnittstellen.


Anreden, Briefanreden, Grussformeln, Versandarten

Die Konfiguration von Anreden, Briefanreden, Grussformeln und Versandarten wird in die Globalen Konfigurationen ausgelagert. Die Konfiguration in der Dokumentfunktion sieht so aus:

HINWEIS
Im Regelfall, vor allem bei mehrsprachigen Lösungen, wird der Text über die Globalen Übersetzungen in die jeweilige Zielsprache übersetzt.


Anrede

Hier werden alle verfügbaren Anreden (engl. Salutation) des Empfängers definiert, beispielsweise "Herr", "Frau", "Familie" etc.

Im "ContactMapping" wird dies als "SalutationShort" bezeichnet.

Je nach Geschlecht und Anzahl der Personen wird die passendste Anrede aus der Konfiguration geladen.

Beispielkonfiguration

 

Einträge Globale Konfigurationen - Deutsch

Einträge Globale Konfigurationen - Übersetzt

Einträge Globale Übersetzungen

Elemente innerhalb von <Salutation>...</Salutation>:

  • DisplayName: Text der Anrede, z. B. "Herr" oder "Frau" (wird bei mehrsprachigen Lösungen in die Globalen Übersetzungen ausgelagert)

  • IsDefault bestimmt, ob diese Anrede die Platzhalter-Anrede sein soll.
    Die Platzhalter-Anrede hat in der Regel als deutschen DisplayName "[Anrede]". Mittels eckige Klammern wird der Benutzer darauf aufmerksam gemacht, dass das nur ein Platzhalter ist.
    Sobald eine Qualification (siehe nächster Punkt) zutrifft, wird automatisch die Anrede mit der entsprechenden Qualification gewählt, sodass nicht mehr der Platzhalter ausgewählt ist. Somit muss sich der Benutzer normalerweise nicht darum kümmern, dass der Platzhalter durch die sinnvolle Anrede ersetzt wird.

  • Qualification: Innerhalb von <Qualification>...</Qualification> können Eigenschaften angegeben werden, unter denen die Anrede ggf. automatisch aktiv werden soll (siehe Unterpunkte).

    • Qualification/Id: Enthält einen der folgenden Werte:

      • Label: Wird jeweils bei der Platzhalter-Anrede (i. d. R. "[Anrede]") als Wert gesetzt. Dies bewirkt, dass niemals eine automatische Auswahl dieser Anrede erfolgt.

      • Mr: Wenn im Vornamen genau ein männliche Person erkannt wird.

      • Mrs: Wenn im Vornamen genau ein weibliche Person erkannt wird.

      • Family: Wenn im Vornamen eine Familie erkannt wird. Eine Familie wird erkannt, wenn mehr als zwei Vornamen erkannt wurden oder wenn eine oder mehrere dieser Zeichenketten enhalten sind: "," (Komma), " mit ", " avec ", " con ", " with "

      • Company: Wenn der Empfänger von einem Adressprovider mit CompanyData als AddressType übergeben wird.

      • MrAndMrs: Wenn im Vornamen genau zwei Personen erkannt werden: zuerst eine männliche Person, dann eine weibliche Person.

      • MrsAndMr: Wenn im Vornamen genau zwei Personen erkannt werden: zuerst eine weibliche Person, dann eine männliche Person.
        Wenn keine Anrede mit MrsAndMr besteht, wird stattdessen eine Anrede mit MrAndMrs ausgewählt.

      • Sirs: Wenn im Vornamen genau zwei männliche Personen erkannt werden.

      • Ladies: Wenn im Vornamen genau zwei weibliche Personen erkannt werden.

    • Qualification/IsDefault: Bestimmt, ob diese Anrede automatisch ausgewählt werden soll. true: Diese Anrede wird bevorzugt, wenn die Qualification/Id zutrifft. Wenn bei allen Anreden, bei denen die Qualification/Id zutrifft, Qualification/IsDefault auf false gesetzt ist, wird die erste Anrede ausgewählt, bei welcher Qualification/Id zutrifft.


Briefanrede

Hier werden alle verfügbaren Briefanreden (engl. LetterSalutation) des Empfängers definiert, beispielsweise "Sehr geehrter Herr", "Guten Tag Frau", etc.

Im "ContactMapping" wird dies als "Salutation" bezeichnet.

Je nach Geschlecht und Anzahl der Personen wird die passendste Briefanrede aus der Konfiguration geladen. In der Briefanrede können Platzhalter verwendet werden, die mit folgenden Attributen des gewählten Empfängers ersetzt werden:

  • {FirstName}: Vornamen

  • {LastName}: Nachnamen

  • {Title}: Titel

  • {Profession}: Beruf

  • {Position}: Funktion

  • {SecondName}: Weiterer Name

Soll die Briefanrede also beispielsweise den Titel und den Nachnamen beinhalten, muss folgender Text konfiguriert werden:

Wird ein Platzhalter im Empfänger nicht gefunden, wird dieser entfernt und es wird sichergestellt, dass nicht zwei aufeinanderfolgende Leerzeichen in der Anrede vorkommen.

Beispielkonfiguration

 

Einträge Globale Konfigurationen - Deutsch

Einträge Globale Konfigurationen - Übersetzt

Einträge Globale Übersetzungen

Elemente innerhalb von <Salutation>...</Salutation>:

  • DisplayName: Text der Briefanrede, z. B. "Sehr geehrter Herr {FirstName}" oder "Guten Tag Frau {FirstName}" (wird bei mehrsprachigen Lösungen in die Globalen Übersetzungen ausgelagert)

  • IsDefault bestimmt, ob diese Briefanrede die Platzhalter-Briefanrede sein soll.
    Die Platzhalter-Briefanrede hat in der Regel als deutschen DisplayName "[Briefanrede]". Mittels eckige Klammern wird der Benutzer darauf aufmerksam gemacht, dass das nur ein Platzhalter ist.
    Sobald eine Qualification (siehe nächster Punkt) zutrifft, wird automatisch die Briefanrede mit der entsprechenden Qualification gewählt, sodass nicht mehr der Platzhalter ausgewählt ist. Somit muss sich der Benutzer normalerweise nicht darum kümmern, dass der Platzhalter durch die sinnvolle Briefanrede ersetzt wird.

    • Qualification: Innerhalb von <Qualification>...</Qualification> können Eigenschaften angegeben werden, unter denen die Briefanrede ggf. automatisch aktiv werden soll (siehe Unterpunkte).

    • Qualification/Id: Enthält einen der folgenden Werte:

      • Label: Wird jeweils bei der Platzhalter-Anrede (i. d. R. "[Briefanrede]") als Wert gesetzt. Dies bewirkt, dass niemals eine automatische Auswahl dieser Briefanrede erfolgt.

      • Mr: Wenn im Vornamen genau ein männliche Person erkannt wird.

      • Mrs: Wenn im Vornamen genau ein weibliche Person erkannt wird.

      • Family: Wenn im Vornamen eine Familie erkannt wird. Eine Familie wird erkannt, wenn mehr als zwei Vornamen erkannt wurden oder wenn eine oder mehrere dieser Zeichenketten enhalten sind: "," (Komma), " mit ", " avec ", " con ", " with "

      • Company: Wenn der Empfänger von einem Adressprovider mit CompanyData als AddressType übergeben wird. Spezielle Logik, nur für Rückwärtskompatibilität:
        Falls keine Briefanrede mit Company gefunden wird, wird eine folgende Briefanrede gesucht: Qualification/Id = MrAndMrs, Qualification/IsPlural = true, Qualification/Gender = Both, Qualification/IsDefault ist egal

      • MrAndMrs: Wenn im Vornamen genau zwei Personen erkannt werden: zuerst eine männliche Person, dann eine weibliche Person.
        Siehe auch "Spezielle Logik, nur für Rückwärtskompatibilität" unter dem Punkt Company.

      • MrsAndMr: Wenn im Vornamen genau zwei Personen erkannt werden: zuerst eine weibliche Person, dann eine männliche Person.
        Wenn keine Anrede mit MrsAndMr besteht, wird stattdessen eine Anrede mit MrAndMrs ausgewählt.

      • Sirs: Wenn im Vornamen genau zwei männliche Personen erkannt werden.

      • Ladies: Wenn im Vornamen genau zwei weibliche Personen erkannt werden.

    • Qualification/IsDefault: Bestimmt, ob diese Anrede automatisch ausgewählt werden soll. true: Diese Briefanrede wird bevorzugt, wenn die Qualification/Id zutrifft. Wenn bei allen Briefanreden, bei denen die Qualification/Id zutrifft, Qualification/IsDefault auf false gesetzt ist, wird die erste Anrede ausgewählt, bei welcher Qualification/Id zutrifft.


Grussformel

Hier werden alle verfügbaren Grussformeln (engl. GreetingFormula) definiert, beispielsweise "Freundliche Grüsse", "Herzliche Grüsse", etc.

Beispielkonfiguration

Einträge Globale Konfigurationen - Deutsch

Einträge Globale Konfigurationen - Übersetzt

Einträge Globale Übersetzungen

Elemente innerhalb von <GreetingFormula>...</GreetingFormula>:

  • DisplayName: Text der Grussformel, z. B. "Freundliche Grüsse" oder "Herzliche Grüsse" (wird bei mehrsprachigen Lösungen in die Globalen Übersetzungen ausgelagert)

  • IsDefault bestimmt, ob diese Grussformel die Platzhalter-Grussformel sein soll.
    Die Platzhalter-Grussformel hat in der Regel als deutschen DisplayName "[Grussformel]". Mittels eckige Klammern wird der Benutzer darauf aufmerksam gemacht, dass das nur ein Platzhalter ist.
    Sobald eine Qualification (siehe nächster Punkt) zutrifft, wird automatisch die Grussformel mit der entsprechenden Qualification gewählt, sodass nicht mehr der Platzhalter ausgewählt ist. Somit muss sich der Benutzer normalerweise nicht darum kümmern, dass der Platzhalter durch die sinnvolle Grussformel ersetzt wird.

  • Qualification:

    • Qualification/IsDefault bestimmt, ob diese Grussformel automatisch ausgewählt werden soll. Wenn bei allen Grussformeln Qualification/IsDefault auf false gesetzt ist, wird die erste Grussformel ausgewählt.


Versandart

Hier werden alle verfügbaren Versandarten (engl. ShippingMethod oder Transmission) des Empfängers definiert, beispielsweise "A-Post" oder "Einschreiben".

Beispielkonfiguration

In dieser Beispielkonfiguration ist die Versandart "Einschreiben" jeweils vorausgewählt (siehe IsPreselected).

 

Einträge Globale Konfigurationen - Deutsch

Einträge Globale Konfigurationen - Übersetzt

Einträge Globale Übersetzungen

Elemente innerhalb von <ShippingMethod>...</ShippingMethod>:

  • DisplayName: Text der Versandart, z. B. "Einschreiben" oder "per E-Mail" (bei mehrsprachigen Lösungen werden die Globalen Übersetzungen verwendet)

  • TypeOfDistribution: Hier wird eine eindeutige Kennung (z. B. "RegisteredMail") für die jeweilige Versandart hinterlegt. Sie ist frei wählbar.
    Bei der Platzhalter-Versandart muss TypeOfDistribution auf DefaultText gesetzt werden. Die Platzhalter-Versandart hat in der Regel als deutschen DisplayName "[Versandart]". Sie wird im Dokument nicht angezeigt.

  • IsPreselected: Bestimmt die Versandart, welche bei neuen Empfängern vorausgewählt wird (true: soll vorausgewählt sein, false oder nicht vorhanden: soll nicht vorausgewählt sein).
    Diese Vorauswahl gilt nur für Empfänger, die im Empfänger-Dialog übernommen werden durch Erstellen oder durch Übernahme von einem Adressprovider (sie gilt z. B. nicht für Empfänger, die via Connect übergeben werden).
    IsPreselected darf nur bei einer Versandart auf true gesetzt werden.
    Wenn keine vorausgewählte Versandart konfiguriert ist, dann wird die Platzhalter-Versandart (siehe TypeOfDistribution) vorausgewählt.


SimpleView

Soll die SimpleView angezeigt werden, wird das Attribut FullDetailMode auf false gesetzt.

Da die SimpleView in den meisten Layout-Vorlagen in standardmässig deaktiviert ist, ist auch deren Konfiguration in den globalen Konfigurationen auskommentiert.

Die SimpleView kommt erfahrungsgemäss nur in einzelnen Inhaltsvorlagen vor. Entsprechend nutzt man am besten die Vererbung und überschreibt die Konfiguration auf der Layoutvorlage indem auf der Inhaltsvorlage erneut die Dokumentfunktion Empfängeradresse angehängt wird.

Einträge Globale Konfigurationen

Beispielkonfiguration in einer Inhaltsvorlage

 

Entsprechender Screenshot

 


Empfängerdetails-Fenster

Im Empfängerdetails-Fenster können Empfänger manuell erfasst und angepasst werden.

Das Empfängerdetails-Fenster führt automatische Anpassungen an den Empfängerdaten aus, mit dem Ziel, den Benutzer beim Erfassen von Empfängerdaten zu unterstützen:

  • Anrede, Briefanrede:
    Diese werden gesetzt, sobald im Vornamenfeld erkannt wurde, welche Anredenkombination passen sollte.
    Beim Ändern der Anrede wird zudem automatisch die dazugehörige Briefanrede ausgewählt und umgekehrt.

  • Grussformel:
    Diese wird gesetzt, sobald im Vornamenfeld etwas eingegeben wurde.

  • CheckBoxen

    • Anrede auf separater Zeile:
      Wird deaktiviert, sobald die Anrede nicht in der Adresse angezeigt wird, wenn die Adresse den Firmennamen enthält oder wenn die Adresse die zweite Person enthält.

    • Person über Firma:

      • Wird deaktiviert, sobald kein Firmennamen in der Adresse angezeigt wird oder wenn keine Person vorhanden ist.

      • Wird deaktiviert, sobald der Adresstyp auf "Privat" gestellt wird.

    • Firma anzeigen:
      Wird aktiviert, sobald der Adresstyp auf "Geschäftlich" gestellt wird.

    • Weitere Namen anzeigen:
      Wird deaktiviert, sobald keine der Personen einen weiteren Namen hat.

  • Adresstyp:

    • Wird auf "Geschäftlich" gesetzt, sobald keine Privat-Adressdaten verfügbar sind während Geschäftlich-Adressdaten verfügbar sind.

    • Wird auf "Privat" gesetzt, sobald keine Geschäftlich-Adressdaten verfügbar sind während Privat-Adressdaten verfügbar sind.

  • Funktion anzeigen:
    Wird deaktiviert, sobald die Adresse die zweite Person enthält.

Falls nicht manuell erfasste Empfänger (z. B. von Adressprovidern oder via Connect) die obigen Regeln nicht erfüllen, bewirkt dies eine Änderung der Daten, sobald das Empfängerdetails-Fenster geöffnet wird. Es ist daher von Vorteil, wenn Empfänger aus externen Quellen die obigen Regeln erfüllen.

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland