Mailadresse Firmenattribut
Bestellungen
Wertauflöser - Kurzfassung
Zweck: Durchsucht die Kommunikationsinformation-Attribute der Firmenadresse eines über den Parameter Firmentyp bestimmten "Firmen- und Adressattributs" nach Einträgen für den Kommunikationstyp "E-Mail" mit dem angegebenen Kontext und gibt eine Liste der gefundenen E-Mail-Adressen zurück.
Siehe auch: Mailadresse Adressattribut-Wertauflöser
Der Mailadresse Firmenattribut-Wertauflöser durchsucht die Kommunikationsinformation-Attribute der Firmenadresse (company.address) eines über den Parameter Firmentyp bestimmten "Firmen- und Adressattributs" nach Einträgen für den Kommunikationstyp "E-Mail" (EMAIL) mit dem angegebenen Kontext.
Als Eingabewert wird eine Entität erwartet, deren Typ zur Gruppe der "Attributbesitzer" gehört und "Firmen- und Adressattribute" unterstützt.
Der Rückgabewert des Wertauflösers ist im Erfolgsfall eine Liste von Strings (string[]), die alle nicht-leeren Werte von Kommunikationsinformation-Attributen der durchsuchten Adresse enthält, deren Kontext mit dem Wert im Parameter Kontext exakt (inkl. Groß- und Kleinschreibung) übereinstimmt.
►HINWEIS◄ Auch ein einzelner Treffer wird als Element einer Liste zurückgegeben, so dass ggf. ein Wertauflöser (z. B. Listenwert oder Regel-Listen Resolver) verwendet werden muss, um direkt auf den einzelnen Wert zuzugreifen. Im typischen Einsatzumfeld innerhalb einer E-Mail-Versand-Ereignisaktion spielt das allerdings keine Rolle, da dort beim Adressieren von E-Mails (in den Parametern "Empfänger", "CC" und "BCC" wahlweise Strings oder Listen von Strings akzeptiert werden.
Der Rückgabewert des Wertauflösers lautet dagegen "Kein Wert" (null) sofern eine der folgenden Bedingungen zutrifft:
Der Eingabewert unterstützt dem Typ nach keine "Firmen- und Adressattribute".
Der Eingabewert verfügt nicht über ein "Firmen- und Adressattribut" für den angegebenen Firmentyp.
Es wurde ein "Firmen- und Adressattribut" des angegebenen Firmentyps gefunden, aber für dieses trifft mindestens eine der folgenden Bedingungen zu:
Das Feld "Firma" (company) verweist nicht auf eine Firma.
►HINWEIS◄ Eventuell verweist dasselbe Attribut stattdessen auf eine Adresse (Feld address). Eine Auswertung dieser Adresse (address) ermöglicht dann der Mailadresse Adressattribut-Wertauflöser.Die Firmenadresse verfügt über kein Kommunikationsinformation-Attribut, das alle der nachfolgenden Bedingungen erfüllt:
Das Attribut verweist im Feld "Typ" (communicationType) auf den Kommunikationstyp "E-Mail" (EMAIL).
Das Attribut verweist im Feld "Kontext" (communicationContext) exakt auf den Wert im Parameter Kontext des Wertauflösers.
Das Attribut definiert im Feld "Wert" (communicationValue) einen beliebigen Text.
►HINWEIS◄ Ob dieser Text formalen Kriterien für eine E-Mail-Adresse entspricht, wird nicht untersucht.
►ANMERKUNG◄ Die Auswertung einer Firmenadresse durch den Mailadresse Firmenattribut-Wertauflöser erfolgt ohne Rücksicht auf Zugriffsbeschränkungen, die im Ausführungskontext (Rolle der Session, Firma der Session, Ausführen als) für das betreffende Firmenkonto gelten. Der Wertauflöser kann also auch auf die Kommunikationsinformationen von Firmen zugreifen, die z. B. in einer Suche oder Übersicht mit denselben Anmeldedaten nicht erscheinen.
Konfiguration
|
Der Parameter Kontext Kommunikationsinfo muss als Pflichtfeld mit einem beliebigen statischen Text gefüllt werden. Der Wertauflöser liefert nur Werte aus Kommunikationsinformationen, deren "Kontext" (communicationContext) exakt (inkl. Groß-/Kleinschreibung) mit dem hier angegeben Wert übereinstimmt. ►HINWEIS◄ Da der Parameter nicht "leer" bleiben kann, berücksichtigt der Wertauflöser Kommunikationsinformationen ohne Kontext kategorisch nicht. Der Parameter Firmentyp verlangt als Pflichtfeld eine Einfachauswahl auf der Basis der Dynamischen Aufzählung Firmentyp. Wie im Bild zu sehen, unterstützt das Auswahlfeld/Combobox-Element eine Suchfunktion. ►WICHTIG◄ Falls im Kontext einer Sitzung Dynamische Aufzählungsfilter für die betreffende Aufzählung anwendbar sind, schränken diese auch die Auswahl für den Firmentyp im Zuge der Konfiguration ein. Auf die Auswertung des Wertauflösers zur Laufzeit haben Dynamische Aufzählungsfilter dagegen keinen Einfluss. |
|
Beispiel
Über ausgewählte Arbeitsstatuswechsel für ein Geschäftsobjekt vom Typ Bestellung (s. Bestellungen) soll der innerhalb der Bestellung über ein "Firmen- und Adressattribut" angegebene "Rechnungsempfänger" (Firmentyp INV) per E-Mail benachrichtigt werden.
Als Rechnungsempfänger für Bestellungen sollen ausschließlich in Lobster Data Platform / Orchestration als Firmenkonto geführte Firmen verwendet werden können. Das "Firmen- und Adressattribut" kann also nur als "Firmenattribut" ausgeprägt sein.
Benachrichtigungen zum Bestellstatus, die für "Rechnungsempfänger" relevant sind, sollen an alle E-Mail-Adressen innerhalb der Kommunikationsinformationen des betreffenden Firmenkontos versendet werden, für die der Kontext "INV" (für "Invoice") oder "AOB" (für "Any Other Business") angegeben wurde:
Der Screenshot zeigt die Kommunikationsinformationen, die im Firmenkonto der Firma "ZWORX Ltd." angegeben sind.
Jede der drei hinterlegten E-Mail-Adressen bezieht sich auf einen spezifischen Kontext.
Allerdings verweisen alle Kommunikationsinformation-Attribute auf denselben Wert. Offenbar soll unabhängig vom Kontext immer dieselbe Adresse verwendet werden.
Konfiguration:
|
Gemäß der Anforderung soll eine Benachrichtigung an alle für die Kontexte "INV" und "AOB" hinterlegten Adressen versendet werden. Das wäre mit der folgenden Konfiguration innerhalb einer E-Mail-Versand-Ereignisaktion gewährleistet:
Im Beispiel der Firma "ZWORX Ltd." würde mit den oben gezeigten Adressdaten jeweils dieselbe Adresse als Empfänger zugewiesen. Auch wenn solche Duplikate in der Empfängerliste typischerweise vom Mailsystem ignoriert werden, erscheint mindestens im E-Mail-Objekt von Lobster Data Platform / Orchestration (s. E-Mails) dieselbe Adresse mehrfach, falls die E-Mail überhaupt gespeichert wird:
|
|
|
Die rechts abgebildete Variante der Konfiguration vermeidet das Problem der Duplikate systematisch:
►ANMERKUNG◄ Der Parameter Wert zum Sammeln wird hier nicht benötigt, da der jeweils der gesamte Eintrag in die Ergebnisliste eingehen soll. Laufzeitbeispiel:
|
|
-Symbol zwei Instanzen für Empfänger-Werte hinzugefügt.
