用途:WebEmbed 用于把 Launchpad 应用体验(创建案例、处理分配任务、完整案例页面)通过 pega-embed Web Component 直接嵌入外部网站、门户或自定义前端应用,用户无需离开宿主应用即可与 Launchpad 交互。
主要能力:
- 嵌入动作:createCase(创建指定类型的新案例,适合表单或自助门户)、openAssignment(打开现有分配任务)、openPage(嵌入整个落地页/列表/仪表盘,需 pageID 与 pageClass 属性)。
- 认证方式:Client Credentials(grantType="clientCreds",需 clientId、clientSecret、authorizeUri,适合可安全保存密钥的可信环境)与 PKCE/授权码(grantType="authCode",仅需 clientId 与 authorizeUri,适合公开浏览器应用,组件自动处理 challenge/verifier)。
- 主题定制:theme 属性接受 JSON 字符串,可配置调色板、按钮与标签颜色,使嵌入界面匹配宿主站点风格。
- 起始字段:startingFields 传 JSON 字符串预填案例字段,字段名需与 Launchpad 中该案例类型的 Allowed Fields 匹配,仅支持顶层标量字段,无预填时传 '{}'。
- 事件:监听 embedcaseclosed、embedprocessingend、embedeventcancel 控制宿主页面行为;还可用 getEmbedData 等方法读写嵌入数据。
使用方式:需配置 CORS 策略(可在 App Settings → Default Settings → Cross Origin Resource Sharing Policy 或 Rules Library → Security → CORS Policies 创建),指定精确的 Allowed Origin;将 CORS 配置加入 Configuration Set 以部署到各订阅环境;订阅方必须更新 CORS 策略以允许嵌入的父域名,否则会被浏览器跨域错误拦截;并生成 OAuth 凭据。开发时可用 * 通配符,生产环境须限制为精确域名。示例通过加载 https://lp.constellation.pega.com/integrated/react/prod/pega-embed.js 并创建 pega-embed 元素,可配合 deferLoad 后手动调用 .load()。
适用场景:从多个外部来源采集数据(如线索、服务请求、理赔);将已存在于 Launchpad 的业务逻辑嵌入其他应用做录入或展示(如仪表盘、案例状态);自定义门户展示分配任务或案例视图而不重定向用户。
限制:必须正确配置 CORS 与 OAuth 凭据,否则嵌入失败;PKCE 不使用 clientSecret;startingFields 仅支持顶层标量字段;其他属性、事件及主题设计令牌的完整参考、费用与平台支持等信息暂未提供。