扩展 Omniscript 元素的 Lightning Web 组件

将自定义行为和样式添加到 Omniscript 元素，同时保留其核心功能。使用重新创建属性并添加新属性的组件，替换 Omniscript 元素的 Lightning Web 组件。

Lightning Web 组件为 Omniscript 元素提供 HTML、JavaScript、XML 和 CSS 文件。例如，文本元素包含名为 OmniscriptText 的可扩展组件。有关为不是元素扩展的 Omniscript 创建自定义 Lightning Web 组件的信息，请参阅为 Omniscript 创建自定义 Lightning Web 组件。

备注

受管软件包之外构建的自定义 Lightning Web 组件无法使用任何使用 Salesforce 资源的 Salesforce Lightning Web 组件，或在运行时影响该组件。请参阅 Salesforce 模块。如果您在“设置”中关闭受管软件包运行时设置，我们建议您不要扩展 Lightning Web 组件，例如 Block 或 TypeAhead。扩展这些组件会导致 Omnistudio 和 Omnistudio for Managed Packages 之间的不兼容。

1. 在项目的 lwc 文件夹中，创建名为 lwcName 的子文件夹。
   例如，创建名为 customText 的子文件夹。
2. 在新子文件夹中，创建名为 lwcName.js 的文件。
   例如，创建名为 customText.js 的文件。
3. 将此代码粘贴到 JavaScript 文件中。替换新组件的名称和 Omniscript 元素的 LWC 的命名空间。
   此示例使用名为 customText 的自定义组件自定义omniscriptText。对于 Omnistudio，命名空间是 c。

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

4. 在子文件夹中，创建名为 lwcName.js-meta.xml 的文件。
   例如，创建名为 customText.js-meta.xml 的文件。
5. 将此代码粘贴到 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. 在解压缩的文件结构中，找到要扩展的 Omniscript 元素的 Lightning Web 组件文件夹。
   例如，查找名为 omniscriptText 的文件夹。
7. 编辑 HTML 文件。
   1. 右键单击 HTML 文件，并选择使用 Visual Studio 代码打开。
   2. 复制 HTML 文件的内容。
   3. 在名为 lwcName.html 的自定义组件子文件夹中创建文件。
      例如，创建名为 customText.html 的文件
   4. 将 Lightning Web 组件的 HTML 文件的复制内容粘贴到新 HTML 文件中。
8. 要将自定义组件部署到 Salesforce 组织，右键单击子文件夹并选择将源部署到组织。

   有关更多信息,请查看部署 Lightning Web 组件。

9. 以下列方式之一将自定义组件添加到 Omniscript：
   • 使用 LWC 组件覆盖，覆盖单个元素。
   • 将您要扩展到自定义组件的类型的所有 Omniscript 元素映射到自定义组件。

• 使用自定义 Lightning Web 组件覆盖 Omniscript 元素
  使用自定义 Lightning Web 组件 (LWC) 覆盖 Omniscript 元素，以将自定义行为和样式添加到 Omniscript 元素。
• 使用自定义 Lightning Web 组件覆盖 Omniscript 元素类型的所有元素
  要覆盖 Omniscript 中的所有类型元素，请将元素映射到自定义 Lightning Web 组件。您无法直接将这些组件拖到 Omniscript 画布，并将其映射到自定义 Lightning Web 组件。这些组件包括步骤图、保存以便以后确认和模态。