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