微应用

集成 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 应用程序。

这些是您在集成配置屏幕中输入的用于设置集成的值:

  • 基本 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 应用 身份证值 获取该应用
广播应用 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。

  1. 登录 Podio,然后导航到 Podio 应用程序。
  2. 选择应用程序名称 旁边的工具图标 。我们在屏幕截图中以示例的形式展示了 Broadcast 应用程序的步骤。

    Podio 工具图标

  3. APP下,选择 开发人员

    Podio 应用程序令牌收集

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

    Podio 应用程序令牌收集

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

收集视图 ID

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

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

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

    查找视图 ID

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

    查找视图 ID 2

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

  1. 登录 Podio API 视图
  2. 选择 获取视图
  3. 向下滚动到 “ 沙盒” 部分,如果需要,请登录。
  4. 输入您在收集应用程序 ID 和应用程序令牌流程中收集的 app_id
  5. include_标准_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 微应用程序以连接到您的应用程序。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。这样可以提供带有预配置通知和操作的开箱即用的微应用程序,这些通知和操作可在工作区中使用

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

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

    配置屏幕

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

    1. 授权类型流程 菜单中选择 客户端凭据
    2. 授权类型值 字段中输入 app
    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 和视图模板变量替换为您上面为正在连接的每个 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. “编辑数据端点 ” 屏幕中,在 “ 模板变量” 下,将{广播_app_id}{广播_view_id}变量 替换为您的应用程序 ID。

    Podio 终端节点模板

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

替换维修操作变量

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

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

    Podio 服务操作列表

  3. “编辑服务操作 ” 屏幕中,在 “ 模板变量 ” 下,将 {广播_app_id}{广播_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 广播应用程序

熟悉以下注意事项:

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

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

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

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

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

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

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

清理过期的广播

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

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

Podio 常见问题微应用

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

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

通知或页面 用例工作流
新文章通知 发表新文章时,订阅者会收到通知。
常见问题解答页面 提供可搜索的常见问题解答列表,可以按类别进行过滤,以及指向 “问题和答案” 页面的链接。
问题和答案页面 提供常见问题的详细视图以及指向原始资料的链接。