集成 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 和应用程序令牌对 Workspace 是唯一的。此值可用于 Podio 工作空间中的所有应用程序。
  • Podio 集成模板专为推送通知而设计。由于此集成使用应用令牌而不是用户权限,因此不支持用户上下文写入。
  • 如果这些应用程序位于同一 Podio 工作空间中,则它们适合与微应用进行一次集成。如果应用程序位于不同的 Podio Workspace 中,则使用不同的集成。
  • 还要考虑逻辑分离、用户基础和易管理性。

检查必备项

查看以下要求。这些分为两组:集成级别和 Citrix Podio 应用程序级别。此集成模板需要两者,尽管您只能在应用级别实现所需的微应用。

集成要求

要设置此集成,您必须具有目标 Podio Workspace 的管理员权限并拥有 Podio 应用程序。

以下是您在集成配置屏幕中输入的设置集成的值:

  • 基本 URLhttps://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 应用 ID 值 获取应用
广播应用 broadcast_app_id broadcast_view_id Citrix Workspace 广播应用
常见问题 faq_app_id faq_view_id Citrix Workspace 常见问题

收集应用程序 ID 和应用令牌

从 Podio 收集应用程序 ID 和应用程序令牌,以应用程序而不是用户身份进行身份验证。通过应用程序 ID 访问权限,用户只能访问相关 Podio 工作区内的应用程序数据。您可以从 Podio 工作空间的 Podio 应用程序中收集此身份证。如果您在一个工作区中有多个应用程序,则可以使用与工作区关联的任何应用程序 ID。

  1. 登录 Podio,然后导航至 Podio 应用程序。
  2. 选择应用程序名称旁边的工具图标。我们已在屏幕截图中展示了广播应用的步骤,作为示例。

    Podio 工具图标

  3. 应用程序下,选择开发者

    Podio 应用程序令牌收集

  4. 复制并保存应用程序 ID令牌字段。在设置集成时,您可以将这些值作为访问令牌参数输入。

    Podio 应用程序令牌收集

您还可以在此页面上的应用程序字段下查看字段和示例 JSON 值。有关在 Podio 中使用应用条目的更多信息,请参阅 使用项目

收集查看 ID

一些 Podio 终端节点和服务操作使用 Podio 视图作为过滤器来下载选定数量的记录。有关在 Podio 中使用视图和过滤器的更多信息,请参阅 视图、筛选器和报告

您需要为下面指定的字段找到视图 ID,具体取决于要实现的微应用。替换下面 替换数据加载和维修操作变量 中的服务操作变量时,可以使用此值替换 view_id 模板变量。

  • 对于广播应用,该字段为 “ 今天修改
  • 对于常见问题解答应用,字段为 “ 已发布
  1. 登录 Podio,然后导航至 Podio 应用程序。
  2. 将鼠标悬停在上面指定的字段上以查看浏览器左下角的视图 ID。我们已经在广播应用程序中显示了该字段,作为屏幕截图的示例。

    查找查看 ID

  3. 您可以选择指定的字段以打开视图。复制 URL 的末尾部分,然后在替换服务操作中的变量时保存以供以后使用。

    查找视图 ID 2

您还可以从 Podio 开发者的门户中找到 View ID。请按照以下步骤进行操作:

  1. 登录到 Podio API 视图
  2. 选择获取视图
  3. 向下滚动到沙盒部分并根据需要登录。
  4. 输入您在 收集应用程序 ID 和应用令牌 流程中收集的 app_id
  5. include_standard_views 值保留为 false,然后选择提交

    查找沙盒

  6. 你可以通过输出来搜索 (Ctrl+F) 的 view_id。它接近底部。复制并保存该值以供以后使用。

    查找查看 ID

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

您需要在 Podio 中收集客户端 ID 和客户端密钥才能进入微应用设置屏幕进行身份验证。

  1. 登录到 API 密钥。填写 API 密钥生成器下的字段。
  2. 应用程序名称输入名称。
  3. 返回 URL 的完整域(无协议)输入微应用实例 URL。URL {yourmicroappserverurl} 的此部分由租户部分、区域部分和环境部分组成:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com
  4. 选择 生成 API 密钥
  5. 您的 API 密钥下,复制并保存刚添加的应用程序的客户端 ID客户端密钥值。在设置集成时,您可以输入这些值。

    Podio 应用程序令牌收集

将集成添加到 Citrix Workspace 微应用

将 Podio 集成添加到 Citrix Workspace 微应用程序以连接到应用程序。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。这样可以提供现成的微应用,以及可以在 Workspace 内使用的预配置通知和操作。

请按照以下步骤进行操作:

  1. 微应用集成页面中,选择添加新集成,然后选择从 Citrix 提供的模板添加新集成
  2. 选择 Podio 磁贴。
  3. 输入集成的集成名称
  4. 输入连接器参数
    • 输入实例 基本 URL
    • 图标 库中选择集成的图标,或将其保留为默认图标。

    配置屏幕

  5. 服务身份验证下,从身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。

    1. 授权类型流程菜单中选择客户端凭据
    2. 授权类型值字段中输入应用程序
    3. 令牌授权菜单中选择请求正文
    4. 令牌内容类型菜单中选择 URL 编码表单。
    5. 确认令牌 URL 字段。此值已预填充:https://api.podio.com/oauth/token
    6. 输入您的客户端 ID。客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。在生成了API 密钥时,您会收集这个和客户端密钥。
    7. 输入您的客户端密钥。客户端密钥是生成API 密钥时用客户端 ID 发出的唯一字符串。

    Podio 服务身份验证

  6. 输入 访问令牌参数 值。有关详细信息,请参阅 收集应用程序 ID 和应用令牌
    • podio_app_id 旁输入您收集的应用程序 ID。您可以在 Podio 工作区中使用任何 Podio 应用程序中的应用程序 ID。
    • podio_app_ token 旁输入您收集的应用程序令牌

    Podio 令牌

  7. 请勿启用服务操作身份验证开关。
  8. 不要启用请求速率限制开关。
  9. 请求超时 字段中输入 120
  10. (可选)启用日志记录开关以保留 24 小时的日志记录以供支持。
  11. 选择 保存 以继续。

    Podio 超时

微应用集成页面将打开,其中包含您添加的集成及其微应用。接下来,您需要对终端节点和服务操作的模板变量进行一些更改,如下所述。

替换数据加载和维修操作变量

要完成此设置,您需要将 Podio 集成配置中的应用 ID 和查看 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 修改端点:常见问题解答
  1. 微应用集成 页面中,选择 Podio 集成旁边的菜单,然后选择 编辑。此时将打开“数据加载”屏幕。如果您在配置屏幕中,请从左侧导航栏中选择数据加载
  2. 选择第一个终端节点旁边的菜单,然后选择 编辑,或选择终端节点的名称。让我们从 广播 终端节点开始。

    Podio 数据加载

  3. “编辑数据终端节点 ” 屏幕中,在 “ 模板变量 ” 下,将 {roadcast_app_id}{roadcast_view_id} 变量替换为您的应用程序 ID。

    Podio 终端节点模板

  4. 选择屏幕底部的应用并确认。
  5. 现在,对其他五个端点重复此过程,根据需要替换值。不要忘记选择屏幕底部的 应用 ,然后确认为每个终端节点保存。

替换维修操作变量

对于每个维修操作,您必须手动添加 broadcast_app_idbroadcast_view_id 的详细信息。创建广播服务操作要求您替换这两个变量。更新广播服务操作只需要替换 broadcast_app_id 变量。

  • broadcast_app_id 修改服务操作: 创建广播更新广播
  • broadcast_view_id 修改服务操作: 创建广播
  1. 编辑集成配置时,从左侧导航栏中选择服务操作
  2. 选择其中一个服务操作旁边的菜单,然后选择编辑,或选择该维修操作的名称。让我们从 创建广播 服务操作开始。

    Podio 服务操作列表

  3. “编辑服务操 作” 屏幕中,在 “ 模板变量 ” 下,将 {roadcast_app_id}{roadcast_view_id} 变量替换为您之前收集的应用程序 ID 和视图 ID。

    Podio 服务操作模板

  4. 选择“保存”以完成。
  5. 现在对另一个服务操作重复此操作: 更新广播,但只替换 broadcast_app_id 变量。

有关 API 端点和表实体的更多详细信息,请参阅Podio 连接器规格

使用 Podio 微应用

此 Podio 集成模板随附这些开箱即用的微应用程序。从这些微应用开始,并根据您的需求定制它们。

Podio 微应用

Podio 广播微应用

使用这些微应用程序撰写重要公告并与团队共享。这些公告可能是为了一般、设施或 IT 更新、流程变更、关键危机沟通,或者只是让您的团队参与一些娱乐和福祉新闻。

Citrix Workspace 广播应用程序是广播微应用的先决条件。你需要从 Podio 应用程序市场安装此应用程序。此 Podio 应用模板为 “类别” 和 “重要程度” 字段提供了一组预定义的值。使用应用程序上的 “修改模板” 功能添加或修改这些字段的选项,以满足您的业务需求。此修改不需要对相应的微应用进行任何更改。您还可以通过添加或编辑其他字段来修改 Podio 应用程序。但是,这也需要你在微应用中反映相应的变化。获取 Podio 应用程序: Citrix Workspace 广播应用

熟悉以下注意事项:

  • 下面描述的 创建广播和管理广播 微应用是管理员微应用。
  • 这些微应用中的 Live 状态意味着发布消息。消息发布后,该消息将在广播微应用中为标准(非管理员)用户提供。
  • 如果任何 Podio 应用状态字段被修改为具有不同的值,则需要在微应用中更新正确的值。例如,如果您想使用已发布作为状态而不是实时状态,则需要将微应用自定义为相同的状态。

广播: 查看具有未来 结束日期的所有已发布(状态:Live)广播。

通知或页面 用例工作流
已更改广播通知 当广播更改和直播时,订阅者会收到通知。
新的广播通知 当新广播直播时,订阅者会收到通知。
直播页 提供包含广播详细信息的只读页面。
广播页 提供带有详细信息链接的广播列表。

创建广播: 创建和发布新的广播。

通知或页面 用例工作流
“创建广播” 页 提供用于创建和发布广播的页面。

管理广播: 管理员可以查看和更新所有创建的广播。此视图不限于已发布的(状态:Live)广播。

通知或页面 用例工作流
已更改广播通知 更新广播时,订阅者会收到通知。
新的广播通知 当新广播直播时,订阅者会收到通知。
广播页 提供创建的广播的可搜索列表,其中包含可以更新广播的详细信息链接。
直播页 提供一个只读页面,类似于广播微应用中使用的页面,该页面向公众展示了广播的外观。有一个更新按钮,通向 “更新广播” 页面,管理员可以在该页面修改此广播。
更新直播 提供用于更新现有广播的页面。

停止显示过期的广播

启用此工作流程可自动识别结束日期已过期的广播。广播被标记为已完成,不再向订阅者显示。

此工作流程可在 Podio 高级计划中使用。有关详细信息,请参阅流程自动化。设置此集成的管理员在登录到 https://workflow-automation.podio.com 并刷新相关的 Podio 工作区后,通过从 Podio 刷新来启用流程。

Podio 常见问题解答微应用

编制常见问题解答列表并将其提供在 Citrix Workspace 中。Citrix Workspace 常见问题解答应用程序是常见问题微应用的先决条件。你需要从 Podio 应用程序市场安装此应用程序。获取 Podio 应用程序: Citrix Workspace 常见问题

见问题解答: 常见问题和答案列表。

通知或页面 用例工作流
新文章通知 发布新文章时,订阅者会收到通知。
常见问题解答页面 提供可搜索的常见问题解答列表,可按类别进行筛选,并附有一个问题和答案页面的链接。
问题和答案页面 提供常见问题解答的详细视图以及指向源材料的链接。
集成 Citrix Podio