集成 Podio

与 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 中,则使用不同的集成。
  • 还要考虑逻辑分离、用户基础和易管理性。

检查必备项

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

以下是您在 Citrix Workspace 微应用中输入的值:

  • 基本 URLhttps://api.podio.com。此值已预填充。
  • 应用程序 ID:每个应用程序都有唯一的应用 ID。在设置集成时将此值作为访问令牌参数输入,然后在修改配置时替换 podio_app_id 模板变量。请参阅 收集应用程序 ID 和应用令牌
  • 应用令牌:使用此令牌以应用程序而不是用户身份进行身份验证。此集成只能访问此应用程序中的数据。在设置集成时,将此值作为 Access 令牌参数 输入。
  • 查看 ID:一些 Podio 终端节点和服务操作使用 Podio 视图作为过滤器来下载选定数量的记录。修改配置时,使用此值替换 view_id 模板变量。请参阅 收集查看 ID
  • 令牌 URL:此值已预填充: https://api.podio.com/oauth/token
  • 客户端 ID:客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。请参阅 收集客户端 ID 和客户端密钥
  • 客户端密钥:客户端密钥是设置目标应用程序集成时发出的唯一字符串。

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

从 Podio 收集应用程序令牌和应用程序 ID,以应用程序而不是用户身份进行身份验证。通过应用程序 ID 访问权限,用户只能访问相关 Podio 工作区内的应用程序数据。

  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. 输入 访问令牌参数 值:
    • podio_app_id 旁输入您收集的应用程序 ID
    • podio_app_ token 旁输入您收集的应用程序令牌

    Podio 令牌

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

    Podio 超时

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

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

要完成此设置,您需要将 Podio 集成配置中的 podio_app_idpodio_view_id 模板变量替换为上面收集的应用程序 ID 和 View ID。您可以将这些变量替换为数据加载和维修操作。

替换数据加载变量

对于每个数据终端节点,您必须手动为添加变量 podio_app_id。你对所有四个终端节点都执行此操作。此外,对于 广播 终端节点,您必须替换 podio_view_id 变量。

  1. 微应用集成 页面中,选择 Podio 集成旁边的菜单,然后选择 编辑。此时将打开“数据加载”屏幕。如果您在配置屏幕中,请从左侧导航栏中选择数据加载
  2. 选择第一个终端节点旁边的菜单,然后选择 编辑,或选择终端节点的名称。让我们从 广播 终端节点开始。

    Podio 数据加载

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

    Podio 终端节点模板

  4. 选择屏幕底部的应用并确认。
  5. 现在,重复此操作仅替换其他三个数据端点的 podio_app_id类别严重程度状态

替换维修操作变量

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

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

    Podio 服务操作列表

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

    Podio 服务操作模板

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

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

使用 Podio 微应用

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

Podio 微应用

Podio 广播微应用

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

熟悉以下注意事项:

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

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

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

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

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

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

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

Citrix Workspace 广播

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