Configurar DataQ Screen Flow

Support DQE
Support DQE
  • Actualización

Componentes de Screen Flow

A partir de la versión 1.45, DQE One for 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 estándar de Flow y están disponibles en la sección Custom de la paleta de componentes de Flow.

DQE Screen Flow components in the Flow component palette

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

DQE component added to a Salesforce Flow screen

Address Lookup

Atributos:

  • API Name: identificador único entre las variables de Flow
  • Label: etiqueta mostrada encima del campo
  • Street Value: variable de salida para Street
  • City Value: variable de salida para City
  • Country Value: variable de salida para Country
  • Country Options: lista de opciones en formato JSON, por ejemplo: [{'label': 'United States', 'value': 'US'}]
  • Postal Code Value: variable de salida para Postal Code
  • State or Province Value: variable de salida para State
  • Latitude Value: variable de salida para Latitude
  • Longitude Value: variable de salida para Longitude
  • Status Code: código de estado de la API tras la validación
  • Disabled: impide las actualizaciones manuales en el campo de entrada
  • Required: muestra el campo como obligatorio
DQE Address field configuration
Latitude and longitude output fields

Configuraciones globales heredadas del custom setting DQE Address Setup:

  • Default Country
  • Autofill Address Complement: indica si se debe insertar información adicional de la dirección en el campo Street
  • Autofill Geolocation Info: inserta los valores de latitud y longitud

Email Lookup

Atributos:

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

Configuraciones globales heredadas del custom setting 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

Phone Lookup

Atributos:

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

Configuraciones globales heredadas del custom setting DQE Phone Setup:

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

Acciones invocables de Flow

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

Por ello, cada llamada debe ejecutarse en una transacción independiente. De lo contrario, se producirá una excepción que indica que aún existe trabajo pendiente y que el callout no puede realizarse.

Una vez recibida la respuesta, el código de estado se almacena en el campo mapeado en el custom setting correspondiente, de la misma forma que al utilizar un componente de formulario DQE para crear o actualizar un registro.

Requisitos

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

Salesforce invokable action requirements

Postal Address Validation

Esta clase invocable de Apex puede utilizarse para validar una dirección postal.
Custom setting 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:

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

Email Validation

Esta clase invocable de Apex puede utilizarse para verificar una dirección de email.
Custom setting asociado: DQE Email Setup

Parámetros

Tipo: List<String>

Parámetros:

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

Ejemplo:

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

Phone Validation

Esta clase invocable de Apex puede utilizarse para verificar un número de teléfono.
Custom setting 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) que se utilizará para la búsqueda

Ejemplo:

For an Account record: ("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 al callout realizado por la acción Apex.
Record-triggered Flow configuration

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

Final Flow structure

Paso 2: parámetros

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

Advertencia: defínala como una colección (collection).

  1. Cree una variable llamada targetField.
  2. Asígnele el ID del registro, el nombre del SObject y el nombre de API del campo.
Set Flow parameters

Ejemplo completo paso a paso: Screen Flow y acciones invocables

Diagrama de flow para la validación de direcciones

Flow diagram for address validation
Address validation Flow diagram component

Paso a paso

  1. Cree un Picklist Choice Set.
Picklist Choice Set
  1. Cree un Screen Flow para la lista de selección de países.
Country picklist Screen Flow
Country picklist Screen Flow configuration
  1. Cree la variable Address_Status para almacenar el código de calidad de la dirección.
Address_Status variable
  1. Cree un Screen Flow en el que pueda mostrar todos los campos necesarios para crear su futuro registro.
    En este escenario, la acción invocable DQE Address Check también se utiliza después de crear el registro.
Address Screen Flow

Vinculación de datos (Data binding):
La idea clave es mapear los atributos del componente DQE Address Field con el campo Address estándar. En este ejemplo, se denominan:

  • DQE_Address
  • AddressField

Esto da como resultado el siguiente mapeo.

DQE Address mapping
Address field mapping
  1. Cree la variable CityValue.
CityValue variable
  1. 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 en el componente DQE_Address.

Esto le permite comprobar si se ha producido una entrada manual después de que DQE haya completado la información.

Check if address was manually changed
  1. Cree la asignación Reset Quality Code.
Reset Quality Code assignment
  1. Cree la variable Type Record Object.
New Lead creation variable
  1. Cree la asignación Set Fields.
Set Fields assignment
  1. Cree un componente Create a record.
Create records component
  1. Cree una decisión llamada Check if address has status code.
Check if address has status code decision
  1. Cree la variable params.
params variable
  1. Cree la asignación Set API parameters.
Set API parameters assignment
  1. Llame a la acción invocable.
Call the invokable action

Relacionada con

¿Fue útil este artículo?

Usuarios a los que les pareció útil: 0 de 0