DataQ Screen Flow einrichten

Screen-Flow-Komponenten

Ab Version 1.45 stellt DQE One für Salesforce eine Reihe von Aura-Komponenten bereit, die speziell für die Verwendung in Screen Flows entwickelt wurden.

Diese Komponenten implementieren Echtzeit-API-Aufrufe zur Validierung von Postadressen, E-Mail-Adressen und Telefonnummern.

Aus Nutzungssicht verhalten sie sich wie Standard-Flow-Feldkomponenten und sind im Bereich Benutzerdefiniert (Custom) der Flow-Komponentenpalette verfügbar.

Fügen Sie diese Komponenten Ihrem Screen Flow auf die gleiche Weise wie Standard-Eingabefelder hinzu und verknüpfen Sie anschließend deren Ausgabewerte mit Flow-Variablen, um die benötigten Informationen abzurufen.

Address Lookup

Attribute:

• API Name: eindeutige Kennung unter den Flow-Variablen
• Label: über dem Feld angezeigte Beschriftung
• Country Selector Label: über der Länderauswahl angezeigte Beschriftung
• Street Value: Ausgabevariable für die Straße
• City Value: Ausgabevariable für die Stadt
• Country Value: Ausgabevariable für das Land
• Country Options: Liste von Optionen im JSON-Format, zum Beispiel: [{'label': 'United States', 'value': 'US'}]
• Postal Code Value: Ausgabevariable für die Postleitzahl
• State or Province Value: Ausgabevariable für Bundesland/Region
• Latitude Value: Ausgabevariable für den Breitengrad
• Longitude Value: Ausgabevariable für den Längengrad
• Status Code: API-Statuscode nach der Validierung
• Placeholder Text: im Straßenfeld angezeigter Text, wenn es leer ist
• Disabled: verhindert manuelle Aktualisierungen im Eingabefeld
• Required: zeigt das Feld als Pflichtfeld an

Von der benutzerdefinierten Einstellung DQE Address Setup geerbte globale Einstellungen:

• Default Country
• Autofill Address Complement: legt fest, ob zusätzliche Adressinformationen in das Straßenfeld eingefügt werden
• Autofill Geolocation Info: trägt die Werte für Breiten- und Längengrad ein
• Display Maps On Creation
• Display Maps On Edition
• Prevent Saving On

Email Lookup

Attribute:

• API Name: eindeutige Kennung unter den Flow-Variablen
• Label: über dem Feld angezeigte Beschriftung
• StatusCode: API-Statuscode nach der Validierung
• Value: eingegebener Wert
• Placeholder Text: im Eingabefeld angezeigter Text, wenn es leer ist
• Required: zeigt das Pflichtfeld-Symbol neben dem Eingabefeld an
• Disabled: verhindert die manuelle Eingabe im Feld

Von der benutzerdefinierten Einstellung DQE Email Setup geerbte globale Einstellungen:

• Suggest Username: der Vorschlag bezieht sich nur auf die E-Mail-Domain
• Code: Blacklisted Domain
• Code: Domain Throwable
• Code: Inbox Full
• Code: Invalid Email
• Code: Syntax Error
• Code: Unauthorized Username
• Code: Unknown Domain
• Code: User Not Verified
• Code: Valid Email
• Accept Extended Syntax
• Prevent Saving On
• Use default mapping

Phone Lookup

Attribute:

• API Name: eindeutige Kennung unter den Flow-Variablen
• Label: über dem Feld angezeigte Beschriftung
• StatusCode: API-Statuscode nach der Validierung
• Value: eingegebener Wert
• Country Code: ISO-Ländercode (ISO-2)
• Placeholder Text: im Eingabefeld angezeigter Text, wenn es leer ist
• Required: zeigt das Pflichtfeld-Symbol neben dem Eingabefeld an
• Disabled: verhindert die manuelle Eingabe im Feld

Von der benutzerdefinierten Einstellung DQE Phone Setup geerbte globale Einstellungen:

• Display Country Selector
• Code: Phone is Invalid
• Code: Phone is Valid
• Output Format
• Prevent Saving On
• Use default mapping

Aufrufbare Flow-Aktionen (invokable actions)

Alle diese aufrufbaren Aktionen müssen asynchron ausgeführt werden, da sie Callouts an die DQE-APIs durchführen.

Daher muss jeder Aufruf in einer separaten Transaktion ausgeführt werden. Andernfalls tritt eine Ausnahme auf, die anzeigt, dass noch ausstehende Arbeit vorhanden ist und der Callout nicht durchgeführt werden kann.

Sobald die Antwort empfangen wurde, wird der Statuscode in dem Feld gespeichert, das in der entsprechenden benutzerdefinierten Einstellung zugeordnet ist – genauso wie bei Verwendung einer DQE-Form-Komponente zum Erstellen oder Aktualisieren eines Datensatzes.

Voraussetzungen

Die folgende Liste enthält allgemeine Anforderungen und Empfehlungen aus der Salesforce-Dokumentation zu aufrufbaren Aktionen und deren Verwendung.

Postal Address Validation

Diese aufrufbare Apex-Klasse kann zur Validierung einer Postadresse verwendet werden.
Zugehörige benutzerdefinierte Einstellung: DQE Address Setup

Parameter

Typ: List<String>

Parameter:

• RecordId (String): Datensatz-ID
• FieldNameAPI (String): Name des Adressfelds

Beispiel:

Für einen Account-Datensatz: ("001KG00000Mi2khYAB", "BillingAddress")

Email Validation

Diese aufrufbare Apex-Klasse kann zur Überprüfung einer E-Mail-Adresse verwendet werden.
Zugehörige benutzerdefinierte Einstellung: DQE Email Setup

Parameter

Typ: List<String>

Parameter:

• RecordId (String): Datensatz-ID
• FieldNameAPI (String): Name des E-Mail-Felds

Beispiel:

Für einen Lead-Datensatz: ("00QKG000001RLeL2AW", "Email")

Phone Validation

Diese aufrufbare Apex-Klasse kann zur Überprüfung einer Telefonnummer verwendet werden.
Zugehörige benutzerdefinierte Einstellung: DQE Phone Setup

Parameter

Typ: List<String>

Parameter:

• RecordId (String): Datensatz-ID
• FieldNameAPI (String): Name des Telefonfelds
• CountryCode (String): für die Suche zu verwendender Ländercode (ISO2 oder ISO3)

Beispiel:

Für einen Account-Datensatz: ("001KG00000Mi2khYAB", "Phone", "USA")

Schritt-für-Schritt-Beispiel

Schritt 1: Definition des Record-Triggered Flow

• Wählen Sie das SObject aus.
• Wählen Sie das auslösende Ereignis aus.
• Wählen Sie die Optimierung Actions and Related Records aus.
• Erstellen Sie einen geplanten Pfad (scheduled path). Dies ist aufgrund des von der Apex-Aktion durchgeführten Callouts erforderlich.

Am Ende sollten Sie eine Flow-Struktur wie diese erhalten:

Schritt 2: Parameter

1. Definieren Sie eine Flow-Variable, zum Beispiel params.

Warnung: definieren Sie sie als Sammlung (Collection).

2. Erstellen Sie eine Variable namens targetField.
3. Weisen Sie ihr die Datensatz-ID, den SObject-Namen und den API-Namen des Felds zu.

Vollständiges Schritt-für-Schritt-Beispiel: Screen Flow und aufrufbare Aktionen

Flow-Diagramm für die Adressvalidierung

Schritt für Schritt

1. Erstellen Sie ein Picklist Choice Set.

2. Erstellen Sie einen Screen Flow für die Länderauswahlliste.

3. Erstellen Sie die Variable Address_Status zum Speichern des Adress-Qualitätscodes.

4. Erstellen Sie einen Screen Flow, in dem Sie alle für die Erstellung Ihres zukünftigen Datensatzes benötigten Felder anzeigen können.
   In diesem Szenario wird die aufrufbare Aktion DQE Address Check auch nach dem Erstellen des Datensatzes verwendet.

Datenbindung (data binding):
Die Kernidee besteht darin, die Attribute der Komponente DQE Address Field dem Standardfeld Adresse zuzuordnen. In diesem Beispiel sind sie wie folgt benannt:

• DQE_Address
• AddressField

Daraus ergibt sich folgende Zuordnung.

5. Erstellen Sie die Variable CityValue.

6. Erstellen Sie Check Manual Input.

Auch wenn die im vorherigen Schritt vorgenommene Zuordnung bidirektional erscheint, führt eine manuelle Aktualisierung in der Komponente AddressField nicht zu einer Aktualisierung des Werts in der Komponente DQE_Address.

So können Sie prüfen, ob nach Abschluss der Informationsermittlung durch DQE eine manuelle Eingabe erfolgt ist.

7. Erstellen Sie die Zuweisung Reset Quality Code.

8. Erstellen Sie die Variable Type Record Object.

9. Erstellen Sie die Zuweisung Set Fields.

10. Erstellen Sie eine Komponente Create a record.

11. Erstellen Sie eine Entscheidung namens Check if address has status code.

12. Erstellen Sie die Variable params.

13. Erstellen Sie die Zuweisung Set API parameters.

14. Rufen Sie die aufrufbare Aktion auf.