微应用

HTTP 集成脚本

HTTP 集成脚本允许您以编程方式编写一些 HTTP 集成功能的脚本:

  • 数据加载 -脚本可以定义一个或多个同步函数,用于从记录系统 (SoR) 中获取数据、转换数据并将其存储在缓存中。

  • 服务操作 -您的脚本可以定义一个或多个函数,这些函数将数据写入 SoR,获取有关已创建或更新的记录的信息并将其存储在缓存中。

  • Webhooks -您的脚本可以定义一个或多个函数,这些函数对应用程序记录系统配置和推送的数据做出反应。

每个脚本都定义了多个同步和操作函数。然后,HTTP 集成会在同步执行期间或微应用用户调用操作时调用这些函数。

有关微应用脚本的其他详细开发人员资源,请访问 Citrix Developer 门户

开始之前的准备工作

使用脚本功能可推断您熟悉目标应用程序 SoR。在配置集成时所有其他集成方法都已用尽时使用脚本。

使用脚本进行 HTTP 集成时,必须遵循以下常规过程:

  • 准备好要通过微应用管理界面导入的脚本。
  • 脚本必须使用在首选文本编辑器/开发工具中编辑的 javascript 语言编写。
  • 准备就绪后,通过微应用管理界面中的集成选项卡导入脚本,或者可以选择将脚本直接输入脚本功能中提供的文本编辑器。
  • 导入后,测试脚本。

导入脚本

通过微应用管理界面中的集成选项卡导入准备好的脚本。 请按照以下步骤进行操作:

  1. 选择 “ 脚本”。

    脚本

  2. 选择 上传脚本。或者,您可以通过选择 “ 编辑” 将脚本直接输入到文本区域。

    导入脚本

    刀片式服务器打开。

  3. 将脚本拖到导入弹出窗口上。
  4. 脚本经过解析和验证。

    导入脚本成功

  5. 选择 导入
  6. 您的脚本已导入。

注意:

现在,您可以直接在脚本文本编辑器中编辑脚本,也可以通过再次导入脚本文件来更新脚本。

  • 您可以在 “数据 加载”、“服务操作” 和 “Webhook” 屏幕中以数据 端点的形式查看脚本式同步。
  • 您可以在表页面中查看脚本定义的表。

    脚本表

  • 您可以在日志中查看脚本输出。
  • 您可以在同步日志中看到脚本发出的请求。

要在脚本运行时查看和监视脚本,请转到日志屏幕。

常见问题解答

身份验证 -脚本使用的客户端与为记录系统 (SoR) 集成配置的客户端相同,因此匹配 HTTP 集成中定义的所有相同身份验证。

在目标 SoR 的 数据加载服务操 作中配置的所有配置设置都将传播到脚本中。

脚本一旦加载,就会包含在微应用导入/导出中(因此可以导入导出到捆绑存储库中)。

自定义集成参数

脚本还支持在配置 HTTP 集成时使用的自定义集成参数。例如,您的集成使用特定的应用程序 ID 来引用用户工作区中的特定应用程序。此 ID 特定于用户,必须为每个集成设置。

自定义参数或 secret 由配置参数定义定义,包括:

  • name(字符串、无空格、无特殊字符)
  • label(字符串)
  • description(字符串)
  • type(字符串,与列类型相同)
  • 默认值(在导入过程中填充)
  • 必需(布尔值)
  • secret(布尔值)(密钥永远不会记录在微应用缓存或日志中)。

其他资源

了解有关在 Citrix Developer 门户网站开发脚本

微应用脚本入门中开始开发自己的脚本。

请参阅微应用脚本 SDK 中的微应用脚本示例。

微应用脚本 SDK 版本中获取最新的 SDK 版本。

HTTP 集成脚本