Loading
Configurar ajustes de Flexcard

Configurar ajustes de Flexcard

Especifique el comportamiento de su Flexcard con las opciones de configuración. Por ejemplo, agregue o actualice una fuente de datos, cree un oyente de eventos o agregue variables de sesión.

Nota
Nota

Después de actualizar o configurar Flexcards, permita que aparezcan actualizaciones de 15 a 20 minutos, incluso después de borrar su caché. Si ve algún error o si se cargan versiones antiguas, póngase en contacto con el servicio de asistencia de Salesforce para activar el parámetro API de plantilla. Esto ayuda a que las actualizaciones se muestren de forma más rápida y fiable.

  1. Desde el Iniciador de aplicación, busque y seleccione Flexcards.
  2. Amplíe una Flexcard y seleccione una versión.
  3. Si es necesario, desactive la Flexcard.
  4. Vaya a Configuración y actualice la información relevante.
    • Para mostrar u ocultar el panel Configuración, haga clic en Icono Configuración de Flexcard.

    • En el diseñador de un paquete gestionado, haga clic en la ficha Configuración.
  5. Si la Flexcard interactúa con un OmniScript de componente web Lightning, active la compatibilidad de OmniScript.
    Por ejemplo, represente una Flexcard dentro de un OmniScript con el elemento Componente web Lightning personalizado del Omniscript. O bien actualice un OmniScript con el elemento de acción Actualizar OmniScript.
    Consulte Incrustar flexcard en una Flexcard.
  6. Para traducir etiquetas personalizadas a cualquier idioma compatible, active la compatibilidad con múltiples idiomas.
    A continuación puede agregar etiquetas personalizadas a estos elementos Flexcard utilizando el campo de combinación {Etiqueta}.
    • Campo: Etiqueta, salida, marcador
    • Text: En el editor de texto enriquecido
    • Acción: Etiqueta
    Nota
    Nota OmniStudio actualiza etiquetas personalizadas y no las almacena en la memoria caché.

    Consulte Crear y modificar etiquetas personalizadas.

    Nota
    Nota

    OmniStudio proporciona etiquetas del sistema traducidas automáticamente, como mensajes de error estándar, en el tiempo de ejecución estándar. Estas etiquetas traducidas automáticamente aparecen en sus Flexcards basándose en la configuración regional del usuario.

  7. Para agregar una clase dinámica automáticamente en CSS para cambiar el tamaño del elemento y volver a representar la tarjeta cuando cambia la anchura del navegador, active el oyente de anchura.
  8. Para restringir el acceso a la Flexcard, introduzca una lista separada por comas de permisos personalizados.
    Nota
    Nota

    Si este campo se deja en blanco, todos los usuarios pueden ver la Flexcard. La asignación de permisos de usuario solo afecta a la visibilidad de la Flexcard en la interfaz de usuario en tiempo de ejecución y no restringe el acceso a los datos. El acceso a los datos se gestiona a través de la seguridad a nivel de campo. Para garantizar la seguridad de los datos y mantener el cumplimiento de los controles de acceso de cifrado de Salesforce, compruebe siempre que un usuario tiene el permiso Ver datos cifrados antes de mostrar o procesar valores descifrados de campos cifrados.

    Por ejemplo, si tiene permisos personalizados denominados Can_Edit_Policy y Can_View_Policy, introdúzcalos como Can_Edit_Policy,Can_View_Policy.
  9. Para mejorar el rendimiento cuando carga la tarjeta en vista previa, desactive la vista previa de Flexcard secundaria.
  10. Si es necesario, genere un contenedor de tarjetas para el registro de cada fuente de datos en vez de una única tarjeta que muestre todos los registros.
    1. Seleccione Repetir registros.
    2. Introduzca una clave de presentación que identifique el registro de tarjeta repetido para actualizar en el Modelo de objeto de documento (DOM).
      Una clave de presentación ayuda a mejorar el rendimiento regenerando solo el registro de tarjeta actualizado.

    Si su origen de datos es una tabla de datos, anule la selección de Repetir registros para evitar tener varias tarjetas mostrando la misma información. Del mismo modo, le recomendamos anular la selección de la casilla de verificación para gráficos o listas que recuperan datos de múltiples registros. Además, anule la selección de la casilla de verificación para elementos de contenedor como componentes web Lightning o Flexcards secundarias que utilizan sus propias fuentes de datos.

    Si su Flexcard tiene múltiples estados, OmniStudio aplica la condición del estado. Por ejemplo, si selecciona Repetir registros, pero los registros disponibles no cumplen la condición del estado, OmniStudio oculta esos registros.

  11. Si es necesario, aplique una hoja de estilo específica para la Flexcard.
  12. Si es necesario, agregue un oyente de eventos que realice un seguimiento de un evento desencadenado desde un componente y realice una acción en respuesta:
    1. Agregue un oyente de eventos.
    2. Configure las propiedades del oyente.
      • Pubsub: Evento de otro componente, como otra Flexcard en la misma página Lightning.
      • Evento personalizado: Evento desde una Flexcard secundaria o desde un elemento en la tarjeta.
      • Cambio de registro: Cambio en un registro que está en Flexcard. Introduzca el Id. del registro como {recordId} o introduzca un valor de Id. y seleccione el tipo de registro. Si es necesario, seleccione también qué valores de campo copiar en la tarjeta cuando cambie el registro.

        De forma predeterminada, en el tipo de evento Cambio de registro puede seleccionar campos basándose en un objeto de Salesforce, utilizando el menú desplegable Campos. Sin embargo, si activa Modo avanzado, puede especificar campos dentro de cualquier SObject y objetos relacionados en una matriz. Por ejemplo, puede especificar campos para el objeto Cuenta en su matriz de esta manera: Contact.Id, Contact.Account.Id, Contact.Name.

        Nota
        Nota Si cambia el registro a través de una página de Experience Cloud, el cambio solo entra en vigor cuando se modifica dentro de la misma ficha del navegador y no a través de procesos backend.

      Para obtener información acerca del nombre del canal de pubsub o el nombre del evento personalizado, consulte Pasar datos a Flexcards utilizando eventos. Consulte también Configurar acciones en una Flexcard y Configurar condiciones en un elemento Flexcard.

    3. Si configura múltiples acciones y desea organizarlas en una secuencia diferente, amplíe las secciones de propiedades de acción y arrástrelas en el orden que desee.
  13. Para crear variables de sesión accesibles de forma global, haga que los atributos estén disponibles desde un componente o almacene valores desde orígenes de datos, sistemas externos o valores codificados.
    1. Agregue una variable de sesión.
    2. Introduzca una clave y un valor.

    A continuación puede aplicar la variable de sesión como un campo de combinación a un campo de elemento. Por ejemplo, introduzca {Session.var} en una URL de extremo de origen de datos de REST.

    Las variables de sesión están disponibles para estos elementos y sus campos:

    • Acción: Etiqueta
    • Acción de evento personalizado: Parámetro de entrada > Valor
    • Campo: Etiqueta, Marcador de posición y Salida
    • Text: Dentro del editor de texto enriquecido

    No puede utilizar valores de origen de datos como variables de sesión.

  14. Para crear una propiedad pública cuyo valor establezca en una página Lightning o Experience Builder, introduzca la información relevante.
    • Introduzca el nombre del atributo en el caso pascal. El nombre de API generado es cfPropName. Desde un componente web Lightning personalizado o un OmniScript, haga referencia al nombre de la propiedad en el caso de kebab, como cf-record-limit.

    • Para hacer que la propiedad sea visible para páginas de Experience Builder, seleccione el destino lightningCommunity__Default.

    Para llamar al atributo como una variable de sesión dentro de Flexcard, utilice el campo de combinación {Session} donde se admite, como texto, parámetros de entrada y prueba de una fuente de datos o la propiedad de salida de un elemento de campo. Por ejemplo, si llama al atributo RecordLimit, introduzca {Session.RecordLimit}.

    Para configurar la propiedad pública en una página Lightning o Experience Builder, actualice el valor de la propiedad en las propiedades del generador.

    OmniStudio publica propiedades públicas en la subetiqueta property de la etiqueta targetConfig en el archivo de configuración que define los valores de metadatos para su componente web Flexcard Lightning. Puede configurar valores de metadatos adicionales cuando publique la Flexcard.

    Consulte Elementos de archivo de configuración XML y Activar y publicar una Flexcard.

  15. Agregue o actualice la información de la fuente de datos.
  16. Si es necesario, pruebe su configuración de origen de datos agregando variables de prueba.
  • Ejemplos de configuración de Flexcard
    Vea ejemplos para la configuración de Flexcard, como agregar un oyente de eventos y repetir registros de una Flexcard.
  • Activar y desactivar orígenes de datos
    Active y desactive tipos de origen de datos para una organización, perfil o nivel de usuario desde el parámetro personalizado Configuración de marco de trabajo de tarjeta. Por ejemplo, desactive Apex REST, Apex Remote y otras fuentes de datos complejas para toda su organización o evite que los administradores del sistema con permisos limitados utilicen estas fuentes de datos.
  • Configurar una fuente de datos en una Flexcard
    Configure cómo recuperar los datos que muestra una Flexcard. Extraiga directamente de objetos de Salesforce con Asignadores de datos de OmniStudio, consultas de Salesforce Object Query Language (SOQL) y búsquedas de Salesforce Object Search Language (SOSL). También puede utilizar una fuente externa con métodos REST. Para procesos comerciales complejos, utilice el método remoto Apex o Procedimientos de integración. Si es necesario, establezca diferentes orígenes de datos para las Flexcard secundarias y principales. A continuación, seleccione dónde publicar la Flexcard.
  • Propiedades comunes de la fuente de datos Flexcards
    Revise las propiedades comunes disponibles para cualquier origen de datos Flexcard.
  • Probar configuración de origen de datos en una Flexcard
    Realice una vista previa de una Flexcard con datos reales agregando valores de prueba a variables de tiempo de ejecución. Las variables rellenan los campos dinámicos en un origen de datos, como contextId desde un Asignador de datos de OmniStudio que obtiene datos desde una Cuenta.
 
Cargando
Salesforce Help | Article