PoC 指南:概念验证指南-使用应用构建器向 Citrix WorkspCitrix Workspace e 推出由 Citrix Podio 支持的广播和常见问题解答微应用模板

概述

Citrix App Builder(由 Podio 提供支持)提供了一种开始使用 Citrix 管理的记录系统构建微应用的简化方法。借助 App Builder,Citrix Podio 为微应用提供了后端记录系统,这意味着您不必自带或构建自己的记录系统。使用 App Builder 可以帮助管理员和开发人员更快速、更轻松地部署和构建微应用,而无需部署和管理自己的后端记录系统。

作用域

本概念验证指南介绍了如何使用 App Builder 向使用 Citrix Workspace 的用户推出广播和常见问题解答(常见问题)微应用。但是,所涵盖的概念适用于 Citrix 提供的其他使用 Citrix Podio 作为记录系统的Podio 应用程序包

目标

在本概念验证指南结束时,您将获得:

  1. 使用 App Builder 创建Podio 实例或将跑道实例链接到 Citrix Cloud
  2. 添加了 Citrix 提供的 Podio 应用程序作为广播微应用和常见问题微应用的记录系统
  3. 添加并配置了微应用集成以使用 Podio 支持的记录系统
  4. 为微应用添加了订阅者,以便适当的人可以发布广播,并且所有使用 Workspace 的人都能看到广播和常见问题解答
  5. 在 Citrix Workspace 中测试了广播和常见问题微应用的基本功能

必备条件

  • Citrix Workspace
  • Citrix 微应用

注意:您 不需要 Podio 实例:初次使用 App Builder 时就可以创建一个。

概念和术语

本指南中使用的某些术语可能不熟悉。

  • 记录系统-读取和写入数据的地方。类似于数据库。微应用集成使用它们来存储与微应用关联的数据。它们可以被视为 “真相之源”
  • 微应用-嵌入到 Citrix Workspace 体验中的用户界面元素
  • Podio 工作区-一个Podio 概念,帮助跑道管理员在逻辑上将团队或项目分开。与 Citrix Workspace 不同
  • Podio 应用程序-位于 Citrix Podio 工作空间内的应用程序。在此使用案例中,这些应用程序为 Citrix Workspace 微应用集成提供了现成的后端记录系统。
  • 集成-集成连接到记录系统。集成还提供了可以让使用 Citrix Workspace 的人员看到的微应用程序,并从记录系统中读取数据,以便在 Citrix Workspace 的微应用中显示这些数据。

部署步骤

使用应用程序构建器创建Podio 实例或将其链接到 Citrix Cloud

此步骤最好在 App Builder 的产品文档中介绍,但总结如下:

  1. 使用您的 Citrix 凭据登录 Citrix Cloud
  2. 在 Citrix Cloud 控制台的 “可用服务” 下,选择 “应用程序生成器” 磁贴上的 “设置”
  3. 如果您的组织已经拥有Podio 帐户,则可以将其连接到 Citrix Cloud 帐户。如果您的组织没有Podio 账户,可以在这里免费创建一个跑道账户。

创建或关联新的Podio 账号后,下一步就是将 Citrix 提供的Podio 应用示例添加到跑道实例

添加 Citrix 提供的 Podio 应用程序作为广播和常见问题微应用的记录系统

在本节中,将创建一个新的 Podio Workspace,专门用于 Citrix 微应用集成。在新的 Workspace 中,将添加由 Citrix 提供的Podio 应用程序。

添加广播Podio 应用程序

从Podio 应用程序市场添加Citrix Workspace 广播应用程序

  1. 前往Podio 市场 中的 Citrix Workspace 广播应用程序
  2. 点击 “获取应用程序”
  3. 为 Citrix Workspace Broadcast 应用程序创建一个名为 “Citrix 微应用集成” 的新空间。这有助于将Podio 应用程序和数据与您可能拥有或将来想要的任何其他非微应用Podio 工作区分开。在添加 Citrix 提供的其他 Podio 应用程序时,它们也可以放置在此工作区中。
  4. 将访问权限设置设置为私人。此工作空间的使用方式与数据库类似,因此建议将其设为私有
  5. 点击 “立即试用该应用程序”

添加常见问题Podio 应用程序

接下来,添加 Podio [应用市场中的 Citrix Workspace 常见问题解答](https://podio.com/market/apps/194119-citrix-workspace-faq) 应用程序

  1. 前往Podio 市场 中的 Citrix Workspace 常见问题解答应用程序
  2. 点击 “获取应用程序”
  3. 使用在上一步中创建的现有 Podio 工作区:Citrix 微应用集成。这意味着 Broadcast 和 FAQ Podio 应用程序都在同一个Podio 工作空间中。
  4. 将访问权限设置设置为私人。此工作空间的使用方式与数据库类似,因此建议将其设为私有。
  5. 点击 “立即试用该应用程序”

[注意] 如果稍后再设计这个用于生产,那么值得重申的是,Podio 工作空间可以托管多个Podio 应用程序。这意味着,为了便于管理和维护,为每个微应用集成创建一个新的 Podio Workspace 可能比为每个微应用集成创建一个新的 Podio Workspace 更有意义。在这份概念验证指南中,我们将事物分开,因为这不是生产。

此时,Podio 支持的记录系统及其与每个Podio 应用程序相关的数据库架构已经到位。

接下来,在稍后的步骤中,从 Podio 收集配置微应用集成所需的数据。

从 Podio 收集微应用集成配置值

在本节中,将收集以下数据:

  • Citrix Workspace 广播的应用程序 ID
  • Citrix Workspace 广播的令牌
  • Citrix Workspace 广播的查看 ID
  • Citrix Workspace 的应用程序 ID 常见问题解答
  • Citrix Workspace 的令牌常见问题解答
  • Citrix Workspace 常见问题查看 ID
  • 客户端 ID
  • 客户端密码

在 Citrix Cloud 中添加微应用后,需要这些数据来配置微应用的Podio 集成。

收集每个应用程序的Podio 应用程序 ID 和令牌(广播和常见问题解答)

应用程序 ID 和令牌是从 Podio 中检索的。 这里有完整的文档,但下面提供了摘要

  1. 登录 podio.com
  2. 在导航栏中,选择与之前添加的Podio 应用程序关联的工作区。在此示例中:Citrix 微应用集成
  3. 这将带您进入工作区。现在,点击 “活动” 旁边的 loudhailer 图标,导航到Podio 应用程序本身。
  4. 在此处,单击扳手图标,然后在 “应用程序” 类别下选择 “开发者”。
  5. 将显示应用程序 ID 和令牌。记下这些。
  6. 转到下一个Podio 应用程序

收集视图 ID

收集每个应用程序(广播和常见问题解答)的查看 ID。

此步骤的主要参考文档位于 Citrix 文档: 收集视图 ID

  1. 对于广播应用,该字段为 “ 今天修改
  2. 对于常见问题解答应用,该字段为 已发布

收集客户端 ID 和客户端密钥

要使微应用Podio 集成与Podio 后端对话,必须创建客户端 ID 和客户端密钥,并将其输入跑道集成配置中。这与 Citrix Cloud 客户端 ID 和密钥不同,必须从 Podio 生成。

这里有完整的文档,但下面提供了摘要:

1.Log 进入 API 密钥。填写 API 密钥生成器下的字段:

  1. 输入应用程序名称的名称-对于此概念验证,请将其命名为 Citrix 微应用集成
  2. 为 返回 URL 的完整域(无协议)输入微应用实例 URL。URL {yourmicroappserverururl} 的这一部分由租户部分、区域部分和环境部分组成: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com。一个例子可能是:mycloudworkspace.us.iws.cloud.com
  3. 选择 生成 API 密钥。
  4. 在 您的 API 密钥下,复制并保存刚添加的应用程序的 客户 端 ID 和客户端密 钥值。您可以在设置集成时输入这些值。

确认所有数据均已收集

确保已收集以下值。下一步将需要这些。

  • Citrix Workspace 广播的应用程序 ID
  • Citrix Workspace 广播的令牌
  • Citrix Workspace 广播的查看 ID
  • Citrix Workspace 的应用程序 ID 常见问题解答
  • Citrix Workspace 的令牌常见问题解答
  • Citrix Workspace 常见问题查看 ID
  • 客户端 ID
  • 客户端密码

接下来,将微应用服务配置为使用这个新的记录系统

将 Podio 集成添加到微应用服务

Citrix Microapps 中的 Podio 集成模板是一个预构建的集成,它提供了两个开箱即用的用例:广播和常见问题解答。后端记录系统已经在Podio 中创建,现在将添加微应用集成及其微应用模板。

  1. 从 citrix.cloud.com 登录您的 Citrix Cloud 客户
  2. 点击微应用磁贴
  3. 点击 “添加集成” 添加新集成
  4. 因为这是 Citrix 提供的解决方案,所以选择 “从 Citrix 提供的模板添加新集成”
  5. 选择 Citrix Podio
  6. 选择 “添加”

此时,Citrix Podio 集成(包括一些模板微应用)已添加到微应用服务中。接下来,将集成配置为与之前添加的 Citrix Podio 应用程序对话。

将集成配置为与 Citrix Podio 应用程序对话

添加 Citrix Podio 集成后,必须对其进行配置。“配置” 页面应在添加集成后出现,但如果没有:导航到微应用磁贴,找到 Citrix Podio 集成,然后单击 “更新配置” 链接。

此步骤的主要参考文档位于 Citrix 文档: 集成Podio

注意:添加集成时,提供哪个应用程序 ID 和令牌无关紧要。您可以提供广播应用程序 ID 和令牌,也可以提供常见问题解答 ID 和令牌。这要归功于Podio 工作空间的运作方式。但是,稍后在配置数据加载和服务操作时,这些应用程序 ID 和视图 ID 必须与相应的Podio 应用程序匹配。

配置时,必须在 “配置” 窗体中更改以下字段:

  1. Podio 应用程序 ID:每个 Podio 工作空间都有一个应用程序 ID。在设置替换 podio_app_id 变量的集成时,请将此值作为访问令牌参数输入。您可以使用 Podio 工作区中任何 Podio 应用程序中的应用程序 ID。
  2. 应用令牌:使用此令牌作为应用而不是用户进行身份验证。在设置替换 podio_token_id 变量的集成时,将此值作为访问令牌参数输入。
  3. 客户端 ID:客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。
  4. 客户端密钥:客户端密钥是设置目标应用程序集成时发出的唯一字符串。

配置数据加载和维修操作

在本节中,获取每个 Broadcast 和 FAQ 跑道应用程序的 App ID 和 View ID,并在此 替换此步骤完整文档中提到的变量和字段。

了解广播和常见问题微应用功能

以下是广播和常见问题微应用功能的摘要: 使用Podio 微应用

授予对工作区中微应用的访问权限

最后, 配置微应用订阅者,以便相应的人员可以从 Citrix Workspace 进行访问:

从概念上讲:

  1. 需要发布广播的用户可以被授予对 “ 创建广播 ” 微应用的访问权限(已订阅)。
  2. 应该能够在 Workspace 中通过 Broadcase 应用程序查看广播和接收通知的人员应订阅 广播 微应用
  3. 需要能够管理广播(包括删除广播)的人员应订阅 “ 管理广播 ” 微应用
  4. 需要在 Workspace 中查看常见问题解答的人应订阅常见问题微应用

为用户订阅微应用的主要参考资料 在这里

注意:由于这是概念验证,因此可能需要限制谁可以看到微应用(通过修改订阅者)。

测试微应用

在本节中,将测试微应用的基本功能以进行概念验证。

广播微应用

在此示例中,具有 “创建广播” 权限的人将创建新广播。然后,该广播将在 Workspace 的 “活动” 源和 “广播” 微应用中查看。

  1. 登录您的 Citrix Workspace
  2. 前往 “操作”,然后点击 “创建广播”
  3. 撰写测试广播
  4. 单击 “创建”
  5. 当Podio 弹出要求授予权限时,选择 “授予访问权限”

此时,一个新的广播已发布到 Citrix Workspace

检查广播是否已发布到记录系统(在本例中为Podio):

  1. 在 Citrix Workspace 中,转至操作,然后单击广播
  2. Broadcast 帖子是可见的,可以点击查看完整详情

检查广播是否已发布到活动源

默认情况下,只有当数据从 Podio 支持的记录系统以增量方式同步到微应用集成服务时,才会发布到 Citrix Workspace 活动源的通知。默认情况下,此同步每小时进行一次。

要更改此设置或强制同步,请参见 同步数据

数据同步后,通知将显示在工作区活动源中:

活动提要

请注意,由于登录到 Workspace 的人员可以访问 “创建广播” 和 “广播” 微应用,因此他们会同时看到 “通知:用于创建确认” 和 “广播” 本身。

如果通知不在活动动态消息中,请尝试将动态消息的排序从 “推荐” 更改为 “最新”。

微应用常见问题解答

测试常见问题微应用略有不同。目前没有微应用可以创建或编辑常见问题解答,因此这是通过Podio 完成的。幸运的是,这有助于演示Podio 后端如何与微应用进行交互。

  1. 登录Podio 并导航到常见问题解答应用程序
  2. 选择:添加问题
  3. 填写标题和答案(这些为必填字段)以及任何其他相应的字段
  4. 要发布问题,请将 “状态” 设置为 “已发布”
  5. 点击 “保存问题”

这会将问题保存到Podio 应用程序后端。接下来,查看工作区以获取新的常见问题解答条目:

  1. 登录您的 Citrix Workspace
  2. 前往 “操作”,然后点击 “常见问题”
  3. 如果进行了数据同步,则会显示常见问题解答。要强制执行增量同步,请参阅 同步数据
  4. 点击新的常见问题解答条目以阅读其完整内容

注意:默认情况下,新常见问题条目的通知不会定期自动发布到活动源中。这有助于防止活动源过度拥挤。要更改此设置,请详细了解 微应用通知

这样就完成了对基本微应用功能的测试

最终摘要

概念验证指南到此结束。在遵循本指南的同时,您可以:

  1. 使用 App Builder 创建Podio 实例或将跑道实例链接到 Citrix Cloud
  2. 添加了 Citrix 提供的 Podio 应用程序作为广播微应用和常见问题微应用的记录系统
  3. 添加并配置了微应用集成以使用 Podio 支持的记录系统
  4. 为微应用添加了订阅者,以便适当的人可以发布广播,并且所有使用 Workspace 的人都能看到广播和常见问题解答
  5. 在 Citrix Workspace 中测试了广播和常见问题微应用的基本功能

进一步阅读

  • 有关将 Citrix Podio 应用程序与 Citrix Workspace 微应用集成的更多详细信息: 集成Podio