导出和导入集成和微应用

Microapps 服务允许您轻松导出和导入集成和微应用程序。

通过 导出 ,您可以:

  • 单独导出集成、所有微应用程序或选定微应用程序。
  • 从现有集成单独导出微应用程序。

通过 导入 ,您可以:

  • 导入与所有微应用程序的集成。
  • 除了当前微应用程序的新版本外,还从现有导出文件中单独导入微应用程序。

优势

导入和导出集成和微应用程序可用于以下情况:

  • 备份和恢复现有集成和微应用程序.
  • 缩短通过集成开发额外微应用所需的时间。
  • 在不影响生产集成的情况下测试新配置。
  • 通过允许您开发安全方法来测试建议的解决方案进行故障排除。
  • 与组织或更广泛的 Citrix 微应用平台开发人员社区内的其他微应用开发人员协作。

导出功能

导出功能将各种设置和配置打包到扩展名为 .mapp 的文件中。此文件可以导入到微应用程序管理控制台中。有两种类型的 .mapp 文件。一个用于集成,另一个用于微应用。

注意:

导出文件中不包含任何敏感数据,包括用户 ID、密码、OAUTH 客户端 ID 和客户端密码。

模板集成 .mapp 配置文件包含以下内容:

  • 同步计划和配置
  • 表格
    • 编辑方案选项
    • 选定的属性
    • 筛选器和筛选器查询
  • 关系
  • 操作
  • 配置
    • 集成名称
    • 连接器参数
      • 服务 URL
    • 服务身份验证
      • 用户名
      • 密码
    • 用户身份验证方法
    • 其他参数
    • 本地配置
    • 日志记录

注意:

微应用程序会导出,但不会导出任何先前配置的订阅服务器。导入微应用程序后,必须重新配置订阅服务器。有关详细信息,请参阅分配订阅者

HTTP 集成 .mapp 配置文件包含以下内容:

  • 数据加载
    • 数据端点(包括链接子端点)
  • 表格
  • 关系
  • 服务操作
  • 配置
    • 集成名称
    • 连接器参数
      • 基本 URL
    • 图标
    • 本地实例
    • 服务身份验证
      • 身份验证方法
    • 服务操作身份验证
      • 在操作中使用单独的用户验证
      • 身份验证方法
    • 日志记录

微应用程序 .mapp 配置文件包含以下内容:

  • 属性
    • 名称
    • 说明
    • 图标
    • 操作
    • (操作页面)
  • 通知
    • 名称
      • 触发器
    • 切换
    • 内容
      • 操作按钮
    • “目标”页
    • 设置
      • 条件
    • 到期条件
    • 所有页面属性和操作
    • 所有页面格式
    • 所有页面组件和设置
    • 所有调用的操作
  • 本土化
    • 所有本地化设置
  • 元数据
    • 识别用于构建微应用程序的集成。
    • 微应用组件到集成数据缓存图层的映射结构必须正确映射到新集成。
    • 不会导出订阅服务器设置。

导出配置

若要导出配置文件,请按照下列步骤操作:

  1. 打开 Microapps 管理控制台,找到要导出的集成。
  2. 单击集成的省略号菜单,然后选择导出集成
  3. 输入“供应商”和“说明”字段的可选值。
  4. 选择或取消选择要包含在导出文件中的微应用程序。
  5. 选择导出
  6. 将生成的 .mapp 文件保存到安全位置。 集成的 .mapp 配置文件以 .mapp 文件格式导出到您的本地计算机。

导出微应用

若要导出微应用程序文件,请按照下列步骤操作:

  1. 打开 Microapps 管理控制台,找到要从中导出微应用程序的集成。
  2. 单击要导出的微应用程序的省略号菜单,然后选择“导出”。
  3. 将生成的 .mapp 文件保存到安全位置。 集成的 .mapp 配置文件以 .mapp 文件格式导出到您的本地计算机。

导入功能

导入集成配置和微应用程序时,在开始导出/导入工作流程之前,请考虑以下事项:

  • 导入后的集成状态是什么? 配置设置
  • 根据导出的集成类型和配置的设置,必须更新集成配置。
  • 集成状态 显示 需要身份验证配置的警告。
  • 在更新服务凭据之前,不可能执行同步、缓存或操作。

OAuth

导出和导入使用 OAuth 的集成和微应用程序时,请在开始导出/导入工作流程之前考虑以下事项:

  • 对于与为服务帐户或服务操作配置的 OAuth 集成,导出集成时没有客户端密码。
  • 这样做会导致任何使用 OAuth 的身份验证方案(包括服务身份验证方案和服务操作身份验证方案)的身份验证方案出现问题。
  • 在更新服务凭据之前,无法同步或执行操作。
  • 需要重新验证才能从记录系统获取更新的访问令牌。

若要填写 OAuth 凭据,请按照下列步骤操作:

  1. 在 Microapps 管理控制台中,找到新导入的集成。
  2. 单击集成的省略号菜单,然后选择“编辑”。
  3. 单击左侧的属性
  4. 填写缺少的密码、密码,然后重新验证 OAuth。

导入微应用程序限制

微应用程序是在集成中创建的。作为微应用程序父级的集成称为源集成。导入微应用程序时,您可以导入到同一源集成或其他集成或目标集成中。 在将微应用程序导入到目标集成时,必须了解一些显著的局限性。

导入微应用程序的已知影响:

  • 删除原始微应用程序时,所有现有通知(又名源卡)都将被删除。
  • 从新集成的下一次同步(完整或增量)开始生成新的源卡和推送通知。
  • 微应用程序只能在与源集成具有相同集成类型(模板或 HTTP 集成)的目标集成中导入。

注意

即使底层数据结构(又名模式)对于源和目标集成是相等的,微应用程序导入功能也无法将微应用程序数据结构与其他类型的集成相匹配。

目标集成具有与源集成相匹配的数据库结构:

  • 如果目标集成中缺少某些缓存表(架构不同),则微应用程序将导入为错误配置。
  • 要防止错误配置,请确保源集成和目标集成的模式相同。
  • 在集成架构中导航以验证微应用程序所需的表是否包含在架构中。

微应用模板架构

若要查看模板集成的架构,请按照下列步骤操作:

  1. 登录到 Microapps 管理控制台,找到要查看的集成。
  2. 单击省略号菜单,然后选择“编辑”。
  3. 从左侧菜单中选择“表”,然后单击按钮以编辑架构。
  4. 查看表并比较源方案和目标方案。这可确保相同的表和实体正在同步到 microapps 数据缓存。

导入后的微应用状态

导入微应用程序时,会出现以下情况:

  • 该微应用没有订阅服务器。必须手动重新创建订阅服务器。
  • 在设置所有订阅者并进行下一次同步之前,不会针对此 Microapp 创建任何通知。
  • 通知会根据通知触发器首选项自动生成(通常在下次同步之后)。

导入配置步骤

若要导入配置,请按照下列步骤操作:

  1. 打开 Microapps 管理控制台,然后单击管理控制台顶部的“添加集成”。
  2. 选择要添加的集成类型。
  3. 选择“导入先前配置的集成”选项旁边的“继续”按钮。
  4. 拖动您的集成 .mapp 文件或选择浏览以从特定位置选择文件。
  5. 如果选择了错误的文件,您可以通过单击删除链接来选择删除该文件。否则,请单击“导入”。
  6. 集成显示在管理控制台中的所有其他集成。

后续步骤

  • 将缺失的 凭据 添加到新集成中。
  • 添加 订阅者 到新的微应用程序。
  • 删除目标环境上的原始集成。

将微应用导入现有集成

注意

Microapps 包含对用于创建它们的集成的数据结构的引用。因此,微应用程序只能在兼容的目标集成中导入。

要将新微应用导入到现有目标集成中,请执行以下操作:

  1. 打开 Microapp 管理控制台并找到目标集成。
  2. 选择目标集成的省略号菜单,然后选择导入微应用程序
  3. 拖动您的集成 .mapp 文件或选择浏览以从特定位置选择文件。
  4. 如果选择了错误的文件,您可以通过单击删除链接来选择删除该文件。否则,请单击“导入”。
  5. 微应用程序与集成的所有其他微应用程序一起显示。

后续步骤

  • 添加 订阅者 到新的微应用程序。

导入新的微应用版本

您可以从微应用选项(省略号)菜单将微应用更新为较新版本。

  1. 在微应用集成屏幕中选择您所需的微应用上的导入新版本
  2. 拖动新的微应用,然后选择“导入”。

    (可选)如果要从系统中完全删除微应用的旧版本,请选择删除现有源卡。如果不选择此选项,旧的微应用将保留在标记为和使用寿命终止 (EOL) 标志的系统上。您的较新版本被设置为活动的微应用。建议您要删除旧的微应用程序,以保持您创建的源卡正常工作。

  3. 单击导入

您的新微应用程序已导入。

后续步骤

  • 添加 订阅者 到新的微应用程序。
  • 生命周期结束 (EOL):您可以手动设置微应用程序结束生命周期。通过单击编辑微应用程序并选择“属性”来找到 EOL 切换。
导出和导入集成和微应用