使用外部事件设置外部上下文

外部事件是自定义的跨窗口通信消息，可用于实现父窗口与子窗口 (iframe) 中嵌入的应用程序之间的安全数据交换。在运行时，这使应用程序能够侦听配置的外部事件并执行关联的自动化。

外部事件会带来以下影响：

• 事件驱动的架构- 根据自定义事件类型触发特定操作。
• 安全消息传递- 确保通信仅在受信任来源之间发生。
• Real-time data Exchange - 支持主机应用程序和嵌入式 UiPath Apps 之间的动态交互。

先决条件

外部事件功能依赖于UiPath 通信驱动程序（UiPath 通信驱动程序） ，这是一个用于跨窗口消息传递的安全轻量级通信库。

必须在主机平台中安装 UiPath 通信驱动程序。转到npm 包页面，下载驱动程序，并阅读有关如何安装和使用该驱动程序的详细文档。

启用外部事件

1. 打开应用程序。
2. 在项目资源管理器中右键单击“应用程序” ，然后选择“属性” 。
3. 展开“外部事件”部分，然后选择“启用” 。
4. 在“允许的来源”字段中，输入主机应用程序的域。您可以通过添加以逗号分隔的 URL 列表来添加多个条目。

   允许的来源对于外部事件的安全性至关重要。定义允许的来源可以：

   • 消息来源验证- 仅处理来自指定来源的消息。

   • 有目标的邮件已送达- 确保回复可送达预期收件人。

   • 预防 CSRF 攻击- 阻止未经授权的跨站请求。

   • 维护数据完整性- 确保通信渠道可信。

   

创建外部事件

1. 打开应用程序并在项目资源管理器中选择一个页面。

2. 导航至 属性 面板中的 事件 选项卡。

3. 选择“创建外部事件” 。

4. 为外部事件输入一个有意义的名称。

   

5. 选择“定义工作流文件” ，以配置要为已定义事件执行的工作流文件。可在名为“外部事件数据”的工作流参数中找到在外部事件中接收的数据。