Configurar DataQ Screen Flow

Componentes Screen Flow

A partir de la versión 1.45, DQE One para Salesforce proporciona un conjunto de componentes Aura diseñados específicamente para su uso dentro de Screen Flows.

Estos componentes implementan llamadas API en tiempo real para la validación de direcciones postales, direcciones de email y números de teléfono.

Desde el punto de vista del uso, se comportan como componentes de campo de Flow estándar y están disponibles en la sección Personalizado (Custom) de la paleta de componentes del Flow.

Añada estos componentes a su Screen Flow de la misma manera que los campos de entrada estándar, y luego vincule sus valores de salida a variables del Flow para obtener la información necesaria.

Address Lookup

Atributos:

• API Name: identificador único entre las variables del Flow
• Label: etiqueta mostrada encima del campo
• Country Selector Label: etiqueta mostrada encima del selector de país
• Street Value: variable de salida para la calle
• City Value: variable de salida para la ciudad
• Country Value: variable de salida para el país
• Country Options: lista de opciones en formato JSON, por ejemplo: [{'label': 'United States', 'value': 'US'}]
• Postal Code Value: variable de salida para el código postal
• State or Province Value: variable de salida para el estado/provincia
• Latitude Value: variable de salida para la latitud
• Longitude Value: variable de salida para la longitud
• Status Code: código de estado API tras la validación
• Placeholder Text: texto mostrado dentro del campo de la calle cuando está vacío
• Disabled: impide las actualizaciones manuales en el campo de entrada
• Required: muestra el campo como obligatorio

Parámetros globales heredados del parámetro personalizado DQE Address Setup:

• Default Country
• Autofill Address Complement: indica si se deben insertar datos adicionales de la dirección en el campo de la calle
• Autofill Geolocation Info: rellena los valores de latitud y longitud
• Display Maps On Creation
• Display Maps On Edition
• Prevent Saving On

Email Lookup

Atributos:

• API Name: identificador único entre las variables del Flow
• Label: etiqueta mostrada encima del campo
• StatusCode: código de estado API tras la validación
• Value: valor introducido
• Placeholder Text: texto mostrado dentro del campo de entrada cuando está vacío
• Required: muestra el icono de obligatorio junto al campo de entrada
• Disabled: impide la entrada manual en el campo

Parámetros globales heredados del parámetro personalizado DQE Email Setup:

• Suggest Username: la sugerencia solo se aplica al dominio del email
• 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

Atributos:

• API Name: identificador único entre las variables del Flow
• Label: etiqueta mostrada encima del campo
• StatusCode: código de estado API tras la validación
• Value: valor introducido
• Country Code: código ISO del país (ISO-2)
• Placeholder Text: texto mostrado dentro del campo de entrada cuando está vacío
• Required: muestra el icono de obligatorio junto al campo de entrada
• Disabled: impide la entrada manual en el campo

Parámetros globales heredados del parámetro personalizado DQE Phone Setup:

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

Acciones invocables del Flow

Todas estas acciones invocables deben ejecutarse de forma asíncrona, ya que realizan llamadas (callouts) a las API de DQE.

Por ello, cada llamada debe ejecutarse en una transacción independiente. De lo contrario, aparecerá una excepción que indica que todavía hay trabajo pendiente y que la llamada no se puede realizar.

Una vez recibida la respuesta, el código de estado se almacena en el campo mapeado en el parámetro personalizado correspondiente, de la misma forma que al usar un componente DQE Form para crear o actualizar un registro.

Requisitos

La siguiente lista describe los requisitos y recomendaciones generales de la documentación de Salesforce sobre las acciones invocables y su uso.

Postal Address Validation

Esta clase Apex invocable puede usarse para validar una dirección postal.
Parámetro personalizado asociado: DQE Address Setup

Parámetros

Tipo: List<String>

Parámetros:

• RecordId (String): ID del registro
• FieldNameAPI (String): nombre del campo de dirección

Ejemplo:

Para un registro Account: ("001KG00000Mi2khYAB", "BillingAddress")

Email Validation

Esta clase Apex invocable puede usarse para verificar una dirección de email.
Parámetro personalizado asociado: DQE Email Setup

Parámetros

Tipo: List<String>

Parámetros:

• RecordId (String): ID del registro
• FieldNameAPI (String): nombre del campo de email

Ejemplo:

Para un registro Lead: ("00QKG000001RLeL2AW", "Email")

Phone Validation

Esta clase Apex invocable puede usarse para verificar un número de teléfono.
Parámetro personalizado asociado: DQE Phone Setup

Parámetros

Tipo: List<String>

Parámetros:

• RecordId (String): ID del registro
• FieldNameAPI (String): nombre del campo de teléfono
• CountryCode (String): código de país (ISO2 o ISO3) a usar para la búsqueda

Ejemplo:

Para un registro Account: ("001KG00000Mi2khYAB", "Phone", "USA")

Ejemplo paso a paso

Paso 1: definición del Record-Triggered Flow

• Seleccione el SObject.
• Seleccione el evento desencadenante.
• Seleccione la optimización Actions and Related Records.
• Cree una ruta programada (scheduled path). Esto es necesario debido a la llamada (callout) realizada por la acción Apex.

Debería obtener una estructura de Flow como la siguiente:

Paso 2: parámetros

1. Defina una variable de Flow, por ejemplo params.

Advertencia: defínala como una colección.

2. Cree una variable llamada targetField.
3. Asígnele el ID del registro, el nombre del SObject y el nombre API del campo.

Ejemplo completo paso a paso: Screen Flow y acciones invocables

Diagrama de Flow para la validación de direcciones

Paso a paso

1. Cree un Picklist Choice Set.

2. Cree un Screen Flow para la lista de selección de países.

3. Cree la variable Address_Status para almacenar el código de calidad de la dirección.

4. Cree un Screen Flow donde pueda mostrar todos los campos necesarios para crear su futuro registro.
   En este escenario, la acción invocable DQE Address Check también se usa después de crear el registro.

Vinculación de datos (data binding):
La idea clave es mapear los atributos del componente DQE Address Field al campo de dirección estándar. En este ejemplo, se etiquetan como:

• DQE_Address
• AddressField

Esto da como resultado el siguiente mapeo.

5. Cree la variable CityValue.

6. Cree Check Manual Input.

Aunque el mapeo realizado en el paso anterior parezca bidireccional, una actualización manual en el componente AddressField no actualizará el valor del componente DQE_Address.

Esto le permite comprobar si se produjo una entrada manual después de que DQE completara la información.

7. Cree la asignación Reset Quality Code.

8. Cree la variable Type Record Object.

9. Cree la asignación Set Fields.

10. Cree un componente Create a record.

11. Cree una decisión llamada Check if address has status code.

12. Cree la variable params.

13. Cree la asignación Set API parameters.

14. Llame a la acción invocable.