DataQ Screen Flow einrichten

Screen-Flow-Komponenten

Ab Version 1.45 stellt DQE One for 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 Custom der Flow-Komponentenpalette verfügbar.

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

Address Lookup

Attribute:

• API Name: eindeutige Kennung innerhalb der Flow-Variablen
• Label: über dem Feld angezeigte Beschriftung
• Street Value: Ausgabevariable für Street
• City Value: Ausgabevariable für City
• Country Value: Ausgabevariable für Country
• Country Options: JSON-formatierte Liste von Optionen, zum Beispiel: [{'label': 'United States', 'value': 'US'}]
• Postal Code Value: Ausgabevariable für Postal Code
• State or Province Value: Ausgabevariable für State
• Latitude Value: Ausgabevariable für Latitude
• Longitude Value: Ausgabevariable für Longitude
• Status Code: API-Statuscode nach der Validierung
• Disabled: verhindert manuelle Aktualisierungen im Eingabefeld
• Required: zeigt das Feld als Pflichtfeld an

Geerbte globale Einstellungen aus den Custom Settings DQE Address Setup:

• Default Country
• Autofill Address Complement: legt fest, ob zusätzliche Adressinformationen in das Straßenfeld eingefügt werden
• Autofill Geolocation Info: fügt Breiten- und Längengradwerte ein

Email Lookup

Attribute:

• API Name: eindeutige Kennung innerhalb der Flow-Variablen
• Label: über dem Feld angezeigte Beschriftung
• StatusCode: API-Statuscode nach der Validierung
• Value: Eingabewert
• Placeholder Text: wird im Eingabefeld angezeigt, wenn dieses leer ist
• Required: zeigt das Pflichtfeld-Symbol neben dem Eingabefeld an
• Disabled: verhindert manuelle Eingaben im Feld

Geerbte globale Einstellungen aus den Custom Settings DQE Email Setup:

• Suggest Username: der Vorschlag bezieht sich ausschließlich 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

Phone Lookup

Attribute:

• API Name: eindeutige Kennung innerhalb der Flow-Variablen
• Label: über dem Feld angezeigte Beschriftung
• StatusCode: API-Statuscode nach der Validierung
• Value: Eingabewert
• Country Code: ISO-Ländercode (ISO-2)
• Placeholder Text: wird im Eingabefeld angezeigt, wenn dieses leer ist
• Required: zeigt das Pflichtfeld-Symbol neben dem Eingabefeld an
• Disabled: verhindert manuelle Eingaben im Feld

Geerbte globale Einstellungen aus den Custom Settings DQE Phone Setup:

• Display Country Selector
• Code: Phone is Invalid
• Code: Phone is Valid
• Output Format

Aufrufbare Flow-Aktionen

Alle diese Invokable Actions 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 Exception 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 Custom Setting zugeordnet ist – auf die gleiche Weise wie bei Verwendung einer DQE-Formularkomponente zum Erstellen oder Aktualisieren eines Datensatzes.

Anforderungen

Die folgende Liste fasst allgemeine Anforderungen und Empfehlungen aus der Salesforce-Dokumentation zu Invokable Actions und deren Verwendung zusammen.

Validierung der Postadresse

Diese aufrufbare Apex-Klasse (Invokable Class) kann zur Validierung einer Postadresse verwendet werden.
Zugehörige Custom Setting: DQE Address Setup

Parameter

Typ: List<String>

Parameter:

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

Beispiel:

For an Account record: ("001KG00000Mi2khYAB", "BillingAddress")

Validierung der E-Mail-Adresse

Diese aufrufbare Apex-Klasse (Invokable Class) kann zur Überprüfung einer E-Mail-Adresse verwendet werden.
Zugehörige Custom Setting: DQE Email Setup

Parameter

Typ: List<String>

Parameter:

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

Beispiel:

For a Lead record: ("00QKG000001RLeL2AW", "Email")

Validierung der Telefonnummer

Diese aufrufbare Apex-Klasse (Invokable Class) kann zur Überprüfung einer Telefonnummer verwendet werden.
Zugehörige Custom Setting: DQE Phone Setup

Parameter

Typ: List<String>

Parameter:

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

Beispiel:

For an Account record: ("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 erforderlich, da die Apex-Aktion einen Callout durchführt.

Am Ende sollten Sie eine Flow-Struktur wie die folgende erhalten:

Schritt 2: Parameter

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

Warnung: Definieren Sie sie als Collection.

2. Erstellen Sie eine Variable mit dem Namen 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 Invokable Actions

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änder-Pickliste.

3. Erstellen Sie die Variable Address_Status, um den Qualitätscode der Adresse zu speichern.

4. Erstellen Sie einen Screen Flow, in dem alle für die Erstellung Ihres zukünftigen Datensatzes benötigten Felder angezeigt werden.
   In diesem Szenario wird nach der Erstellung des Datensatzes zusätzlich die Invokable Action DQE Address Check verwendet.

Data Binding:
Die Grundidee besteht darin, die Attribute der DQE-Address-Field-Komponente dem Standard-Adressfeld zuzuordnen. In diesem Beispiel sind sie wie folgt benannt:

• DQE_Address
• AddressField

Daraus ergibt sich die folgende Zuordnung.

5. Erstellen Sie die Variable CityValue.

6. Erstellen Sie Check Manual Input.

Auch wenn die im vorherigen Schritt vorgenommene Zuordnung bidirektional erscheint, wird eine manuelle Aktualisierung in der Komponente AddressField den Wert in der Komponente DQE_Address nicht aktualisieren.

Dadurch können Sie prüfen, ob nach der automatischen Vervollständigung 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 mit dem Namen Check if address has status code.

12. Erstellen Sie die Variable params.

13. Erstellen Sie die Zuweisung Set API parameters.

14. Rufen Sie die Invokable Action auf.