Skip to end of metadata
Go to start of metadata

中文标题【注册外部小工具】

你可以从外部站点中注册小工具(Gadget)(例如 Jira 应用),你注册成功的小工具将会在 宏浏览器中显示出来,使用你 Confluence 站点的用户可以使用 Gadget Macro 来调用它们。

有下面 2 中方法可以注册外部小工具:

  • 订阅所有外部应用的小工具:你可以从你 Jira 应用, Bamboo, FishEyeCrucible 站点添加所有小工具 —— 或者从其他的 Confluence 站点中来添加到你的 Confluence 工具目录。用户可以为他们的页面查找和选择小工具。
  • 一个一个的注册外部小工具:如果你不能订阅外部应用的所有小工具的话,你需要将小工具一个一个的添加进来。针对网站不支持小工具订阅和你的应用和你的 Confluence 不能建立信任连接的情况,你就只能这样添加了。

上面的 2 种方法将在下面进行描述。首先,你需要考虑如何在应用和 Confluence 直接建立信任的连接。

在其他应用中设置可信关系

为了在你的 Confluence 中与其他应用建立外部小工具,我们建议你在 2 个应用之间设置 OAuth 或者信任的应用连接关系。在这个例子中,外部应用为小工具的服务器(服务器提供者)和 Confluence (服务消费者)。信任的连接可以允许小工具访问外部服务器中受到限制的数据。

请查看 Linking to Another Application 页面中的内容来获得如何设置可信连接的方法。

如果外部的 Web 应用提供匿名访问所有小工具所需要的数据的话,你不需要在这 2 个应用直接建立信任连接。

例如,如果你的小工具将会从 Jira 服务器上获取数据,但是你 Jira 服务器上的所有项目和问题都需要用户进行登录后才能访问,那么你需要在你的 Confluence 和 Jira 之间建立信任的连接才可以了。如果你的小工具只访问 Jira 中被设置为匿名用户可以访问的数据的话,你的 Confluence 和 Jira 之间就不需要建立信任的连接了。

订阅所应用的所有小工具

你可以从你的 Jira, Bamboo,FishEye 或 Crucible 站点中订阅所有的小工具到你的 Confluence 小工具目录中。用户可以为他们的页面查找和选择小工具。

希望订阅其他站点的小工具:

  1. 进入  > 基本配置(General Configuration) > 外部小工具(External Gadgets
  2. 选择 小工具来源(Gadget Feeds)标签页。
  3. 输入你希望订阅的外部应用的基础 URL,例如: http://example.com/jirahttp://example.com/confluence.
  4. 选择 添加(Add。Confluence 将会转换 URL 到小工具源中,然后显示在 Added Gadget Feeds 列表中。


屏幕截图:订阅一个小工具源

注册单一小工具

如果你不能订阅一个应用的小工具,你需要将小工具一个一个的添加进来。针对网站不支持小工具订阅和你的应用和你的 Confluence 不能建立信任连接的情况,你就只能这样添加了。

首先你需要获得小工具的 URL,并将这个 URL 复制粘贴到你的文本记事本上。

获得 Atlassian 应用的小工具 URL

如果你的应用是一个其他的 Atlassian 应用:

Unable to render {include} The included page could not be found.
 

从其他应用中获得小工具的 URL

如果小工具来自于一个非 Atlassian 应用或者其他的网站,请参考网站的相关文档来获得小工具的 URL。

在 Confluence 中注册小工具来使用

现在,你已经获得了小工具的 URL,你可以在 Confluence 中注册这个 URL 了。用户也就可以用这个小工具在页面中显示相关内容了。你需要具有系统管理权限来在注册一个小工具。pages. You need system administrator permissions to register a gadget. 

希望在 Confluence 注册为小工具

  1. 进入  > 基本配置(General Configuration) >  外部小工具(External Gadgets
  2. 小工具特定 URL(Gadget Specification URL)中输入你希望注册小工具的 URL,然后选择添加新的小工具(Add a new Gadget)。
  3. 选择 添加(Add)。你的小工具将会注册在下面的小工具列表中了,你的用户可以使用宏浏览器来访问你注册的小工具。

屏幕截图:一个一个的注册外部小工具


从外部小工具中注册访问

希望从 Confluence 中删除一个小工具,你可以选择小工具边上的 URL ,然后单击删除(Delete)

如果你希望取消订阅一个应用的小工具,你需要删除整个订阅。你不能仅仅删除你订阅中的某一个小工具。单击小工具源 URL 边上的删除(Delete)

删除的小工具将不能在宏浏览器上找到了,用户也不能使用小工具宏来添加和使用了。任何使用了删除的小工具的页面将会在载入的时候显示损坏的小工具连接。


  • No labels