Jira Data Center Microsoft Graph 连接器使组织能够索引 Jira Data Center 问题和相关数据,使其在 Microsoft 365 生态系统中易于发现和可作。
本文适用于Microsoft负责配置、运行和监视 Jira Data Center Microsoft Graph 连接器的 365 名管理员。 它补充了在 Microsoft 365 管理中心 中设置 Microsoft Graph 连接器中提供的一般说明。
注意
Jira Data Center 连接器以公共预览版提供。 如果想要获得访问权限以试用,则需要为管理员帐户启用定向发布通道。
功能
增强的 Copilot 功能:用户可以在 智能 Microsoft 365 Copilot 副驾驶® 中询问有关 Jira 问题和项目数据的自然语言问题。 例如:
“总结 Project Alpha 中未解决的问题。”
“告诉我本周提交的所有高优先级 bug。
语义搜索支持:用户可以在Microsoft搜索中键入自然语言查询,以获取有关 Jira 问题和项目的高度相关且上下文丰富的响应。
注意
仅与 Jira Data Center 8.14 及更高版本兼容。
通过使用 Jira Data Center Microsoft Graph 连接器,团队可以将 Jira 环境保留在本地,同时受益于强大的Microsoft搜索和 Copilot 功能,确保关键问题和项目详细信息易于发现和可作。
先决条件
1. (GCA) 安装 Microsoft Graph 连接器代理
若要为 Jira Data Center 内容编制索引,必须在与 Jira Data Center 站点相同的网络内的 Windows 计算机上安装 GCA 。 请参阅 安装 Microsoft Graph 连接器代理。 你必须是组织的 Microsoft 365 租户的管理员,以及组织的 Jira 站点的管理员。
注意
如果以前已安装 GCA,请确保它已更新到版本 3.1.3.0 或更高版本。
2.安装 Jira Data Center 插件
从适用于 Jira Data Center 的 Microsoft Graph 连接器安装 Jira Data Center 插件 |按照安装步骤执行 Atlassian 市场 。
入门
1. 显示名称
显示名称可帮助用户轻松识别 Copilot 中的关联文件或项,表示受信任的内容。 显示名称也用作 内容源筛选器。 此字段存在默认值,但你可以将其自定义为组织中的用户可识别的名称。
2. Jira 数据中心 URL
若要连接到 Jira Data Center 数据,请使用组织的 Jira Data Center 实例 URL,格式通常为 https://<your-organization-domain>.com
。
3. 图形连接器代理 (GCA)
图形连接器代理充当 Jira 数据中心实例与连接器 API 之间的桥梁,可实现安全高效的数据传输。 在此步骤中,选择要用于连接器的代理配置。 请参阅 安装 Microsoft Graph 连接器代理。
4.身份验证类型
连接设置目前支持 OAuth 2.0。 若要在连接设置中输入客户端 ID 和客户端密码,请参阅以下说明获取它们。
登录到 Jira 数据中心。
单击设置图标 -> 单击应用程序 -> 单击应用程序链接。
选择“ 创建链接”。
选择“ 外部应用程序 ”,然后选择“ 传入” 作为方向。
填写“配置传入链接”窗体。
- 重定向 URL:对于 M365 企业版,为
https://gcs.office.com/v1.0/admin/oauth/callback
。 - 范围:管理员
- 重定向 URL:对于 M365 企业版,为
复制“凭据”页中提供的客户端 ID 和机密,并将其粘贴到 Jira Data Center 连接设置页的相应字段中。
5. 向有限受众推出
如果要先在 Copilot 和其他搜索图面中验证此连接,然后再将此连接部署到有限的用户群,然后再将它扩展到更广泛的受众。 若要了解有关有限推出的详细信息, 请单击此处。
此时,已准备好为 Jira 数据中心创建连接。 可以确认通知,然后单击“ 创建 ”按钮,Microsoft Graph 连接器将从 Jira 数据中心站点开始为数据编制索引。
对于其他设置,我们根据最适合 Jira Data Center 数据的方式设置默认值。 默认值如下所示:
Page | 设置 | 默认值 |
---|---|---|
用户 | 访问权限 | 仅有权访问此数据源的人员。 |
用户 | 映射标识 | 使用 Microsoft Entra ID 映射的数据源标识。 |
内容 | 筛选器 | 所有项目 |
内容 | 管理属性 | 若要检查默认属性及其架构,请单击此处。 |
同步 | 增量爬网 | 频率:每 15 分钟 |
同步 | 完全爬网 | 频率:每天 |
如果要编辑这些值中的任何一个,则需要选择 “自定义设置” 选项。
自定义设置
自定义设置允许管理员编辑上述默认值。 单击“ 自定义设置” 选项后,会看到另外三个选项卡 -“用户”、“内容”和“同步”。
用户
访问权限
Jira Data Center Microsoft Graph 连接器支持对仅有权访问此数据源的人员可见的数据, (建议) 或每个人。 如果选择“所有人”,则所有用户的搜索结果中将显示索引数据。
如果选择“仅有权访问此数据源的人员”,则需要进一步选择 Jira Data Center 是Microsoft Entra ID预配用户还是非 AAD 用户。
若要确定哪个选项适合你的组织,请执行以下作:
如果 Jira Data Center 用户的电子邮件 ID 与 Microsoft Entra ID 中用户的 UserPrincipalName (UPN) 相同,请选择“Microsoft Entra ID”选项。
如果 Confluence 用户的电子邮件 ID 不同于 userPrincipalName (UPN Microsoft Entra ID 用户) ,请选择非 AAD 选项。
重要
- 如果选择Microsoft Entra ID作为标识源的类型,连接器会将从 Jira 数据中心获取的用户的电子邮件 ID 直接映射到 Microsoft Entra ID 的 UPN 属性。
- 如果为标识类型选择了“非 AAD”,请参阅映射非 Azure AD 标识以获取有关映射标识的说明。 可以使用此选项提供从电子邮件 ID 到 UPN 的映射正则表达式。
- 汇报管理访问权限的用户或组仅在完全爬网中同步。 增量爬网当前不支持处理权限更新。
内容
选择项目并筛选数据
选择“整个 JiraDataCenter 站点”时,将为所有当前和未来项目编制索引。 选择“仅某些项目”时,只会为所选项目编制索引。
筛选数据
可以根据 JiraDataCenter 问题的创建或上次更新时间戳筛选问题,以便仅为最近内容编制索引。 对于高级筛选器,还可以添加 JQL 字符串。
管理属性
本部分定义连接的架构。 架构确定如何在 Graph 连接器中引入和处理已编制索引的 Jira 内容。 可以添加或修改属性,以确保数据结构符合组织对 Copilot 和搜索体验的需求。 还可以从 Jira Data Center 添加自定义字段作为属性。 了解详细信息。
Source 属性 | 语义标签 | 架构 |
---|---|---|
AssigneeEmailId | 查询、检索、搜索 | |
AssigneeName | 查询、检索、搜索 | |
作者 | 作者 | 查询、检索 |
已创建 | 创建日期时间 | 取回 |
DueDate | 取回 | |
IssueDescription | 搜索 | |
IssueIconUrl | IconUrl | 取回 |
IssueId | 取回 | |
IssueKey | 查询、检索、搜索 | |
IssueLink | URL | 查询、检索、搜索 |
IssuePriority | 查询、检索、搜索 | |
IssueStatus | 查询、检索 | |
IssueSummary | 搜索 | |
IssueType | 查询、检索 | |
标签 | 查询、检索 | |
ProjectName | 查询、检索 | |
ReporterEmailId | 创建者 | 查询、检索、搜索 |
ReporterName | 查询、检索、搜索 | |
标题 | 标题 | 查询、检索、搜索 |
更新日期 | 上次修改日期时间 | 查询、检索 |
预览数据 使用“预览结果”按钮验证所选属性和筛选器。
同步
刷新间隔确定数据在数据源和 Graph 连接器索引之间同步的频率。 有两种类型的刷新间隔 - 完全爬网和增量爬网。 有关更多详细信息, 请单击此处。
查看并测试连接
对于 MS 搜索,如果需要自定义搜索结果页。 若要了解如何自定义搜索结果,请参阅 自定义搜索结果页。
疑难解答
发布连接后,可以在管理中心的“数据源”选项卡下查看状态。 若要了解如何进行更新和删除,请参阅 管理连接器。
如果遇到问题或想要提供反馈,请联系 Microsoft Graph |支持。