导出和导入集成和微应用
微应用服务允许您选择轻松导出和导入集成和微应用。
通过 导出 ，您可以：
- 单独导出集成、包含所有微应用或选定微应用的集成。
- 从现有集成中单独导出微应用。
通过 导入 ，你可以：
- 导入包含所有微应用的集成。
- 除了当前微应用的新版本之外，还可以从现有导出文件单独导入微应用。
优势
导入和导出集成和微应用程序可用于以下情况：
- 备份和还原现有的集成和微应用。
- 通过集成减少开发额外微应用所需的时间。
- 在不影响生产集成的情况下测试新配置。
- 通过允许你开发安全的方法来测试建议的解决方案来排除故
- 与组织内的其他微应用开发人员或更广泛的 Citrix Microapp Platform 开发人员社区协作。
导出功能
导出功能将各种设置和配置打包到扩展名为 .mapp 的文件中。此文件可以导入微应用管理控制台。有两种类型的 .mapp 文件。一个用于集成，另一个用于微应用。
注意
导出文件中不包含敏感数据，包括用户 ID、密码、OAUTH 客户端 ID 和客户端密钥。
模板集成.mapp 配置文件包含以下内容：
- 同步计划和配置
- 表格
- 编辑架构选项
- 选定的属性
- 过滤器和筛选器查询
- 关系
- 操作
- 配置
- 集成名称
- 连接器参数
- 服务 URL
- 服务验证
- 用户名
- 密码
- 用户认证方法
- 其他参数
- 本地配置
- 日志记录
注意
微应用是导出的，但是之前配置的任何订阅者都不会导出。导入微应用后，必须重新配置订阅者。有关详细信息，请参阅 分配订阅者。
HTTP 集成.mapp 配置文件包含以下内容：
- 数据加载
- 数据终端节点（包括链接的子端点）
- 表格
- 关系
- 服务操作
- 配置
- 集成名称
- 连接器参数
- 基本 URL
- 图标
- 本地实例
- 服务验证
- 身份验证方法
- 服务操作身份验证
- 在操作中使用单独的用户验证
- 身份验证方法
- 日志记录
Microapp.mapp 配置文件包含以下内容：
- 属性
- 名称
- 说明
- 图标
- 操作
- （操作页面）
- 通知
- 名称
- 触发器
- 切换
- 內容
- 操作按钮
- 目标页
- 设置
- 条件
- 到期条件
- 名称
- Pages
- 所有 Page 属性和操作
- 所有页面格式
- 所有页面组件和设置
- 所有操作都叫
- 本地化
- 所有本地化设置
- 元数据
- 识别用于构建微应用的集成。
- 微应用组件到集成数据缓存层的映射结构必须正确映射到新集成。
- 不会导出任何订阅者设置。
导出配置
要导出配置文件，请执行以下步骤：
- 打开微应用管理控制台，找到要导出的集成。
- 单击集成的省略号菜单，然后选择 导出集成。
- 输入 供应商 和 描述 字段的可选值。
- 选择或取消选择要包含在导出文件中的微应用。
- 选择导出。
- 将生成的 .mapp 文件保存到安全位置。 集成的 .mapp 配置文件将以 .mapp 文件格式导出到本地计算机。
导出微应用
要导出微应用文件，请按照下列步骤操作：
- 打开微应用管理控制台，找到要从中导出微应用的集成。
- 单击要导出的微应用的省略号菜单，然后选择 导出。
- 将生成的 .mapp 文件保存到安全位置。 集成的 .mapp 配置文件将以 .mapp 文件格式导出到本地计算机。
导入功能
在导入集成配置和微应用程序时，请在开始导出/导入工作流程之前考虑以下事项：
- 导入后集成的状态如何。
- 根据导出的集成类型和配置的设置，必须更新集成配置。
- 导入后，集成状态可能会显示 需要身份验证配置的警告。要成功导入，您需要再次配置身份验证凭据。
- 在更新服务凭据之前，不能进行同步、缓存或操作。
OAuth
导出和导入使用 OAuth 的集成和微应用程序时，在开始导出/导入工作流程之前，请考虑以下事项：
- 对于与为服务帐户或服务操作配置的 OAuth 的集成，导出集成时不带客户端密钥。
- 这样做会给使用 OAuth 的任何身份验证方案（包括服务身份验证方案和服务操作身份验证方案）造成问题。
- 在更新服务凭证之前，无法进行同步或操作。
- 要从记录系统获取更新的访问令牌，需要重新进行身份验证。
要填写 OAUTH 凭据，请按照下列步骤操作：
- 在微应用管理控制台中，找到新导入的集成。
- 单击集成的省略号菜单，然后选择编辑。
- 单击左侧的 “属性”
- 填写缺失的密码和密码，然后重新进行 OAuth 身份验证。
导入微应用限制
微应用是在集成中创建的。作为微应用的父集成称为 源集成。导入微应用时，可以导入到同一源集成或其他集成或 目标集成中。 将微应用导入目标集成时，必须了解一些重大限制。
导入微应用的已知影响：
- 删除原始微应用时，所有现有的通知（也称为 Feed 卡）都将被删除。
- 从新集成的下一次同步（完全或增量）开始生成新的馈送卡和推送通知。
- 微应用只能在与源集成具有相同集成类型（模板或 HTTP 集成）的目标集成中导入。
注意
即使源集成和目标集成的基础数据结构（又名模式）相同，微应用导入功能也无法将微应用数据结构与其他类型的集成相匹配。
目标集成具有与源集成匹配的数据库结构：
- 如果目标集成中缺少一些缓存表（模式不同），则微应用将导入为配置错误。
- 为防止错误配置，请确保源集成和目标集成的架构相同。
- 浏览集成架构以验证微应用所需的表是否包含在模式中。
微应用模板架构
要查看模板集成的架构，请执行以下步骤：
- 登录微应用管理控制台并找到要查看的集成。
- 单击省略号菜单，然后选择编辑。
- 从左侧菜单中选择 “表”，然后单击按钮以编辑架构。
- 查看表格并比较源架构和目标架构。这样可以确保将相同的表和实体同步到微应用数据缓存。
导入后的微应用状态
导入微应用程序时，会出现以下情况：
- 微应用没有订阅者。必须手动重新创建订阅者。
- 在设置所有订阅者并进行下一次同步之前，不会针对此微应用创建任何通知。
- 系统会根据通知触发器首选项自动生成通知（通常在下次同步之后）。
导入配置步骤
要导入配置，请按照下列步骤操作：
- 打开微应用管理控制台，然后单击管理控制台顶部的 添加集成 。
- 选择要添加的集成类型。
- 选择导入先前配置的集成选项旁边的 继续 按钮。
- 拖动集成 .mapp 文件或选择 浏览 以从特定位置选择文件。
- 如果选择了错误的文件，则可以通过单击删除链接来选择将其删除。否则，请单击 “ 导入”。
- 集成与管理控制台中的所有其他集成一起显示。
接下来的步骤：
将微应用导入现有集成
注意
微应用包含对用于创建它们的集成的数据结构的引用。因此，微应用只能在兼容的目标集成中导入。
要将新的微应用导入现有目标集成，请执行以下操作：
- 打开微应用管理员控制台并找到目标集成。
- 选择目标集成的省略号菜单，然后选择 导入微应用。
- 拖动集成 .mapp 文件或选择 浏览 以从特定位置选择文件。
- 如果选择了错误的文件，则可以通过单击删除链接来选择将其删除。否则，请单击 “ 导入”。
- 微应用与所有其他微应用一起显示以进行集成。
接下来的步骤：
- 向新微应用添加 订阅者 。
导入新的微应用版本
您可以从微应用选项（省略号）菜单将微应用更新到较新版本。
- 在微应用集成屏幕中选择在所需的微应用上 导入新版本 。
-
拖动新的微应用，然后选择 导入。
（可选）如果要从系统中完全 删除旧版本的微应用，请选择删除现有 Feed 卡 。如果不选择此选项，旧微应用将保留在标有和生命周期终止 (EOL) 标记的系统上。您的较新版本被设置为活动微应用。建议您 不 要删除旧的微应用，以保持创建的 Feed 卡正常工作。
- 点击 导入
您的新微应用已导入。
接下来的步骤：
- 向新微应用添加 订阅者 。
- 生命周期终止 (EOL)：您可以手动将微应用设置为生命周期结束。通过单击编辑微应用并选择属性，可以找到 EOL 切换。
升级集成
要升级集成，请执行以下步骤：
- 打开微应用管理控制台，然后单击管理控制台顶部的 升级集成 。
- 选择要添加的集成类型。
- 拖动集成 .mapp 文件或选择 浏览 以从特定位置选择文件。
- 如果选择了错误的文件，则可以通过单击删除链接来选择将其删除。否则，请单击 升级。
- 集成与管理控制台中的所有其他集成一起显示。
升级集成考虑
- 仅支持 HTTP 集成。
- 可接受的数据结构包括新表、现有表中的新列以及新关系。不允许对以下内容进行修改：
- 表（删除表或更改表名、主键）。
- 列（删除列，或更改列名、数据类型、主键、唯一约束、可为空）。
- 关系（根本不可能删除或更改）。
- 如果不再需要旧结构的某些部分，则可以将数据结构保留为空，或者使用脚本来定义值。
- 不允许删除目标服务操作。验证适用于维修操作通用唯一标识符 (UUID) 及其定义，包括参数等。
- 如果需要更改服务操作，则必须将这些服务操作配置为新的服务操作，并更新每个微应用以调用更新的服务操作。
集成升级成功后，将完全替换以下内容：
- 所有数据端点和 webhook 定义。
- 维修操作（等于在添加新配置的操作时保留旧操作）。
- 作为 HTTP 集成脚本的一部分准备的所有脚本。
升级后：
- 需要完全同步才能缓存新包含的表和列。在成功同步之前，应用程序可能无法正常运行（由于缺少数据）。
- 只有集成实体、关系、数据终端节点、脚本和服务操作才会导入并可用于集成升级（没有属性、授权等）。