Ampliar el componente web Lightning de un elemento de OmniScript

Agregue estilo y comportamiento personalizados a un elemento de OmniScript mientras mantiene su funcionalidad principal. Sustituya el componente web Lightning de un elemento OmniScript por un componente que vuelva a crear sus propiedades y agregue otras nuevas.

Un componente web Lightning proporciona los archivos HTML, JavaScript, XML y CSS para un elemento OmniScript. Por ejemplo, un elemento Texto tiene un componente ampliable denominado omniscriptText. Para obtener información acerca de la creación de componentes web Lightning personalizados para OmniScripts que no son extensiones de elementos, consulte Crear un componente web Lightning personalizado para OmniScript.

Nota

Los componentes web Lightning personalizados creados fuera del paquete gestionado no pueden utilizar ningún componente web Salesforce Lightning que utilice recursos de Salesforce o que afecte al componente en tiempo de ejecución. Consulte Módulos de Salesforce. Si desactiva el parámetro Tiempo de ejecución de paquete gestionado en Configuración, recomendamos que no amplíe componentes web Lightning como Block o TypeAhead. La ampliación de estos componentes puede introducir incompatibilidades entre OmniStudio y OmniStudio para paquetes gestionados.

1. En la carpeta lwc de su proyecto, cree una subcarpeta denominada lwcName.
   Por ejemplo, cree una subcarpeta denominada customText.
2. En la nueva subcarpeta, cree un archivo denominado lwcName.js.
   Por ejemplo, cree un archivo denominado customText.js.
3. Pegue este código en el archivo JavaScript. Sustituya el nombre de su nuevo componente y el espacio de nombres del LWC del elemento OmniScript.
   Este ejemplo personaliza omniscriptText con un componente personalizado denominado customText. Para OmniStudio, el espacio de nombres es c.

   import OmniscriptText from 'c/omniscriptText';
   import tmpl from './customText.html';
   export default class customText extends OmniscriptText {
       render() {
           return tmpl;
       }
   }

4. En la subcarpeta, cree un archivo denominado lwcName.js-meta.xml.
   Por ejemplo, cree un archivo denominado customText.js-meta.xml.
5. Pegue este código en el archivo XML.

   
   <?xml version="1.0" encoding="UTF-8"?>
   <LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata" fqn="omniscript">
       <apiVersion>60.0</apiVersion>
       <isExposed>false</isExposed>
       <masterLabel>Custom Text</masterLabel>
   </LightningComponentBundle>
   

6. En la estructura del archivo descomprimido, localice la carpeta del componente web Lightning para el elemento OmniScript que desea ampliar.
   Por ejemplo, localice la carpeta denominada omniscriptText.
7. Modifique el archivo HTML.
   1. Haga clic con el botón derecho del ratón en el archivo HTML y seleccione Abrir con Visual Studio Code.
   2. Copie el contenido del archivo HTML.
   3. Cree un archivo en la subcarpeta de componentes personalizados denominada lwcName.html.
      Por ejemplo, cree un archivo denominado customText.html
   4. Pegue el contenido copiado del archivo HTML para el componente web Lightning en el nuevo archivo HTML.
8. Para implementar el componente personalizado en su organización de Salesforce, haga clic con el botón derecho del ratón en la subcarpeta y seleccione Implementar origen en organización.

   Para obtener más información, consulte Implementar componentes web Lightning.

9. Agregue el componente personalizado a un OmniScript de una de estas formas:
   • Sustituya un elemento individual utilizando Sustitución de componente LWC.
   • Asigne todos los elementos de OmniScript del tipo que está ampliando al componente personalizado.

• Sustituir un elemento de OmniScript por un componente web Lightning personalizado
  Sustituya un elemento OmniScript por componentes web Lightning personalizados (LWC) para agregar estilo y comportamiento personalizados al elemento OmniScript.
• Sustituir todos los elementos de un tipo de elemento OmniScript por un componente web Lightning personalizado
  Para sustituir todos los elementos de un tipo en un OmniScript, asigne el elemento al componente web Lightning personalizado. No puede arrastrar directamente estos componentes al lienzo de OmniScript y asignarlos a su componente web Lightning personalizado. Estos componentes incluyen Gráfico de pasos, Guardar para confirmación posterior y Modal.