集成 Citrix Podio
与 Citrix Podio 集成，利用 Podio 上的灵活性和多样化的使用案例，在 Citrix Workspace 上快速执行操作。通过这种集成，您可以轻松地将 Workspace 上开箱即用的微应用连接到 Podio 应用市场上随时可用的相应 Podio 应用程序。
- Podio 应用程序：Citrix 在 Podio 应用市场上拥有超过 285 个应用程序 ，或者作为企业用户使用 Podio 创建自己的应用程序。应用程序模板允许你构建应用程序，使其符合你的特定业务需求，并与团队在 Podio 上的独特流程相映射。有关更多信息，请参阅 创建应用。
- 此集成还允许您在 Podio 上创建自己的应用程序和自定义解决方案、构建微应用以及部署到 Citrix Workspace。这些微应用使用 Citrix 拥有的服务 Podio 作为记录系统 (SoR)。使用这些微应用处理的数据驻留在 Citrix 中，并遵循 Citrix 准则和协议。
多个 Podio 应用可以与微应用使用相同的集成。在设计 Podio 集成时，请考虑以下事项：
- 应用程序 ID 和应用程序令牌对于工作区是唯一的。该值可用于 Podio 工作区中的所有应用程序。
- Podio 集成模板专为推送通知而设计。由于此集成使用应用令牌而不是用户权限，因此不支持写入用户上下文。
- 如果这些应用位于同一 Podio 工作区中，则它们适合与微应用进行一次集成。如果这些应用位于不同的 Podio 工作区中，请使用不同的集成。
- 还要考虑逻辑分离、用户群和易管理性。
查看必备项
查看以下要求。它们分为两组：集成级别和 Citrix Podio 应用程序级别。尽管您只能在应用级别实现所需的微应用，但这两者都是此集成模板所需的。
集成要求
要设置此集成，您必须拥有目标 Podio Workspace 的管理员权限，并拥有 Podio 应用程序。
这些是您在集成配置屏幕中输入的用于设置集成的值：
-
基本 URL：
https://api.podio.com。此值已预填充。 -
Podio 应用程序 ID：每个 Podio 工作空间都有一个应用程序 ID。在设置替换
podio_app_id变量的集成时，将此值作为 访问令牌参数 输入。你可以使用 Podio 工作区中任何 Podio 应用程序中的应用程序 ID。请参阅 收集应用程序 ID 和应用令牌。 -
应用令牌：使用此令牌作为应用而不是用户进行身份验证。在设置替换
podio_token_id变量的集成时，将此值作为 访问令牌参数 输入。使用应用程序 ID 收集此信息。 -
令牌 URL：此值已预填充：
https://api.podio.com/oauth/token - 客户端 ID：客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。请参阅 收集客户端 ID 和客户端密钥。
- 客户端密钥：客户端密钥是设置目标应用程序集成时发出的唯一字符串。
Citrix Podio 应用程序要求
这些是您需要在 Podio 应用级别输入的值，以便为要通过此集成连接到的每个 Podio 应用配置端点和服务操作。每个应用程序可能需要以下值：
- 视图 ID：模板端点和服务操作使用 Podio 视图作为过滤器来下载选定数量的记录。修改配置时，使用此值替换
<podioapp>_view_id模板变量。请参阅 收集视图 ID。 - 应用程序 ID：每个应用都有一个唯一的 ID。修改配置时，使用此值替换
<podioapp>_app_id模板变量。
这些是 Podio 应用程序的独特价值观：
| Podio 应用 | 身份证值 | 获取该应用 |
|---|---|---|
| 广播应用 |
broadcast_app_id broadcast_view_id
|
Citrix Workspace 广播应用 |
| 常见问答应 |
faq_app_id faq_view_id
|
Citrix Workspace 常见问题 |
收集应用程序 ID 和应用令牌
从 Podio 收集应用程序 ID 和应用令牌，以应用而不是用户身份进行身份验证。通过应用 ID 访问权限，用户只能访问相关 Podio 工作区中应用的数据。您可以从 Podio 工作区的 Podio 应用程序中收集此 ID。如果一个工作区中有多个应用程序，则可以使用与工作区关联的任何应用程序 ID。
- 登录 Podio，然后导航到 Podio 应用程序。
-
选择应用程序名称 旁边的工具图标 。我们在屏幕截图中以示例的形式展示了 Broadcast 应用程序的步骤。
-
在 APP下，选择 开发人员。
-
复制并保存 “ 应用程序 ID ” 和 “ 令牌 ” 字段。在设置集成时，您可以将这些值作为 访问令牌参数 输入。
您还可以在此页面上的应用程序字段下查看字段和示例 JSON 值。有关在 Podio 中使用应用条目的更多信息，请参阅 使用项目。
收集视图 ID
某些 Podio 终端节点和服务操作使用 Podio 视图作为过滤器来下载选定数量的记录。有关在 Podio 中使用视图和过滤器的更多信息，请参阅 视图、过滤器和报表。
您需要为下面指定的字段找到视图 ID，具体取决于要实施的微应用。替换下面的替换 数据加载和维修操作变量中的维修操作变量时，可以使用此值替换 view_id 模板变量。
- 对于广播应用，该字段为 “ 今天修改”
- 对于常见问题解答应用，该字段为 已发布
- 登录 Podio，然后导航到 Podio 应用程序。
-
将鼠标悬停在上面指定的字段上可以在浏览器的左下角查看视图 ID。我们在屏幕截图中以示例的形式在 Broadcast 应用中显示了该字段。
-
您可以选择指定的字段来打开视图。复制 URL 的末尾部分，然后保存以备以后在替换服务操作中的变量时使用。
你还可以从 Podio 开发者的门户网站找到 View ID。请按照以下步骤进行操作：
- 登录 Podio API 视图。
- 选择 获取视图。
- 向下滚动到 “ 沙盒” 部分，如果需要，请登录。
- 输入您在收集应用程序 ID 和应用程序令牌流程中收集的 app_id 。
-
将 include_标准_views 值保留为 false，然后选择 提交。
-
你可以在输出中搜索 (Ctrl+F) 来 查找 view_id。它接近底部。复制并保存该值以供以后使用。
收集客户端 ID 和客户端密钥
您需要在 Podio 中收集客户端 ID 和客户端密钥才能进入微应用设置屏幕进行身份验证。
- 登录 API 密钥。填写 API 密钥生成器下的字段。
- 输入 应用程序名称的名称。
- 为 返回 URL 的完整域（无协议）输入微应用实例 URL。URL 的这一部分
{yourmicroappserverurl}由租户部分、区域部分和环境部分组成：https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com。 - 选择 生成 API 密钥。
-
在 您的 API 密钥下，复制并保存刚添加的应用程序的 客户端 ID和客户端密 钥值。您可以在设置集成时输入这些值。
将集成添加到 Citrix Workspace 微应用
将 Podio 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。这样可以提供带有预配置通知和操作的开箱即用的微应用程序，这些通知和操作可在工作区中使用
请按照以下步骤进行操作：
- 在 微应用集成 页面中，选择 添加新集成，然后 从 Citrix 提供的模板中添加新集成。
- 选择 Podio 磁贴。
- 输入 集成的集成名称 。
- 输入 连接器参数。
- 输入实例 基本 URL：
- 从 图标 库中选择用于集成的图标，或将其保留为默认图标。
-
在 服务身份验证下，从身份验证 方法 菜单中选择 OAuth 2.0 ，然后填写身份验证详细信息。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
- 从 授权类型流程 菜单中选择 客户端凭据 。
- 在 授权类型值 字段中输入 app 。
- 从令牌授权菜单中选择请求正文。
- 从 令牌内容类型 菜单中选择 URL 编码表 单。
- 确认令 牌 URL 字段。这个值是预先填充的：
https://api.podio.com/oauth/token - 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在生成 API 密钥时收集此密钥和客户端密钥。
- 输入您的 客户端密钥。客户端密钥是生成 API 密钥时使用客户端 ID 发出的唯一字符串。
- 输入 访问令牌参数 值。有关更多信息，请参阅 收集应用程序 ID 和应用令牌：
- 在 podio_app_id 旁边输入您收集的应用程序 ID。你可以使用 Podio 工作区中任何 Podio 应用程序中的应用程序 ID。
- 输入您在 podio_app_token 旁边收集的应用程序令牌。
- 不要启用 服务操作身份验证 开关。
- 不要启用 请求速率限制 开关。
- 在 请求超时 字段中输入 120 。
- （可选）启用 日志记录 切换以保留 24 小时的日志记录以用于支持目的。
-
选择 保存 以继续。
微应用集成 页面随即打开，其中包含您添加的集成及其微应用。接下来，您需要对终端节点和服务操作的模板变量进行一些更改，如下所述。
替换数据加载和维修操作变量
要完成此设置，您需要将 Podio 集成配置中的应用 ID 和视图模板变量替换为您上面为正在连接的每个 Podio 应用收集的应用 ID 和 View ID。您可以将这些变量替换为数据加载和维修操作。
替换变量的快速指南
您需要在 Podio 应用级别输入以下值，以便为要通过此集成连接到的每个 Podio 应用配置端点和服务操作：
-
broadcast_app_id修改终端节点： 广播、 广播类别、 广播重要程度、 广播状态；以及服务操作： 创建广播、 更新广播。 -
broadcast_view_id修改终端节点： 广播；服务操作： 创建广播。 -
faq_app_id修改端点： 常见问题类别 和常 见问题。 -
faq_view_id修改端点： 常见问题。
在给定位置修改以下变量。下面提供了分步指导。
替换数据加载变量
对于每个数据终端节点，您必须为应用程序 ID 和视图 ID 手动添加变量。您可以为所有六个端点执行此操作。
-
broadcast_app_id修改端点： 广播、广播类别、广播重要程度、广播状态。 -
broadcast_view_id修改端点： 广播。 -
faq_app_id修改端点： 常见问题类别 和常 见问题。 -
faq_view_id修改端点： 常见问题。
- 在 微应用集成 页面中，选择 Podio 集成旁边的菜单，然后选择 编辑。将打开 “ 数据加载 ” 屏幕。如果您在配置屏幕中，请从左侧导航栏中选择 数据加载 。
-
选择第一个端点旁边的菜单，然后选择 编辑，或者选择端点的名称。让我们从 广播 端点开始。
-
在 “编辑数据端点 ” 屏幕中，在 “ 模板变量” 下，将{广播_app_id}和{广播_view_id}变量 替换为您的应用程序 ID。
- 选择屏幕底部的 应用 并确认。
- 现在对其他五个端点重复此过程，根据需要替换这些值。别忘了选择屏幕底部的 “ 应用 ”，然后确认为每个终端节点进行保存。
替换维修操作变量
对于每个维修操作，您必须手动添加 broadcast_app_id 和的详细信息 broadcast_view_id。“ 创建广播 ” 服务操作要求您替换两个变量。“ 更新广播 ” 服务操作只需要替换 broadcast_app_id 变量。
-
broadcast_app_id修改服务操作： 创建广播 和 更新广播。 -
broadcast_view_id修改服务操作： 创建广播。
- 编辑集成配置时，从左侧导航栏中选择 服务操作 。
-
选择其中一个维修操作旁边的菜单，然后选择 编辑，或者选择该维修操作的名称。让我们从 “ 创建广播 ” 服务操作开始。
-
在 “编辑服务操作 ” 屏幕中，在 “ 模板变量 ” 下，将 {广播_app_id} 和 {广播_view_id} 变量替换为您之前收集的应用程序 ID 和视图 ID。
- 选择 保存 以完成操作。
- 现在对另一个维修操作重复此步骤： 更新广播，但只能替换
broadcast_app_id变量。
有关 API 端点和表实体的更多详细信息，请参阅 Podio 连接器规格。
使用 Podio 微应用
这个 Podio 集成模板随附这些开箱即用的微应用。从这些微应用开始，然后根据您的需求自定义它们。
Podio 广播微应用
使用这些微应用撰写重要的公告并与您的团队共享。这些公告可能是针对一般信息、设施或 IT 更新、流程变更、关键危机沟通，或者只是让您的团队了解一些娱乐和福祉新闻。
Citrix Workspace 广播应用程序是广播微应用程序的先决条件。你需要从 Podio 应用市场安装这个应用程序。此 Podio 应用模板附带一组预定义的 “类别” 和 “严重程度” 字段值。使用应用程序上的修改模板功能为这些字段添加或修改选项，以满足您的业务需求。此修改不需要对相应的微应用进行任何更改。您还可以通过添加或编辑其他字段来修改 Podio 应用程序。但是，这也需要你反映微应用中的相应变化。获取 Podio 应用程序： Citrix Workspace 广播应用程序。
熟悉以下注意事项：
- 下面介绍的 “ 创建广播” 和 “管理广播 ” 微应用是管理微应用。
- 这些微应用中的 实时 状态意味着发布消息。消息发布后，它将在 Broadcast 微应用中为标准（非管理员）用户提供。
- 如果任何 Podio app status 字段被修改为具有不同的值，则需要在微应用中更新正确的值。例如，如果要使用 “ 已发布 ” 而不是 “ 实时” 状态，则需要将微应用自定义为相同的状态。
广播： 查看所有具有未来 结束日期的已发布（状态：直播）广播。
| 通知或页面 | 用例工作流 |
|---|---|
| 已更改广播通知 | 当广播更改并直播时，订阅者会收到通知。 |
| 新的广播通知 | 当新的直播直播时，订阅者会收到通知。 |
| “广播” 页 | 提供包含广播详细信息的只读页面。 |
| 广播页面 | 提供带有详细信息链接的广播列表。 |
创建广播： 创建和发布新的广播。
| 通知或页面 | 用例工作流 |
|---|---|
| “创建广播” 页 | 提供用于创建和发布广播的页面。 |
管理广播： 管理员可以查看和更新所有创建的广播。此视图不限于已发布的（状态：直播）广播。
| 通知或页面 | 用例工作流 |
|---|---|
| 已更改广播通知 | 更新广播后，订阅者会收到通知。 |
| 新的广播通知 | 当新的直播直播时，订阅者会收到通知。 |
| 广播页面 | 提供可搜索的已创建广播列表，其中包含指向可在其中更新广播的详细信息的链接。 |
| “广播” 页 | 提供类似于 Broadcast 微应用中使用的页面的只读页面，用于显示广播对公众的外观。有一个 更新 按钮可以转到 “更新广播” 页面，管理员可以在其中修改此广播。 |
| 更新广播 | 提供用于更新现有广播的页面。 |
清理过期的广播
启用此工作流程可自动识别结束日期已过期的广播。广播标记为已完成，不再向订阅者显示。
Podio 高级版计划提供此工作流程。有关详细信息，请参阅 工作流自动 设置此集成的管理员在登录 https://workflow-automation.podio.com 并刷新相关的 Podio 工作区后，通过从 Podio 刷新来启用流程。
Podio 常见问题微应用
编译常见问题解答列表，并在 Citrix Workspace 中提供它们。Citrix Workspace 常见问题解答应用程序是常见问题解答微应用的先决条件。你需要从 Podio 应用市场安装这个应用程序。获取 Podio 应用： Citrix Workspace 常见问题解答应用程序。
常见问题解答： 常见问题和答案列表。
| 通知或页面 | 用例工作流 |
|---|---|
| 新文章通知 | 发表新文章时，订阅者会收到通知。 |
| 常见问题解答页面 | 提供可搜索的常见问题解答列表，可以按类别进行过滤，以及指向 “问题和答案” 页面的链接。 |
| 问题和答案页面 | 提供常见问题的详细视图以及指向原始资料的链接。 |