Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O conector atlassian Jira Cloud Microsoft 365 Copilot permite que a sua organização indexe problemas de Jira. Depois de configurar o conector e o conteúdo do índice a partir do site Jira, os utilizadores podem procurar esses itens nas experiências microsoft Search e Microsoft 365 Copilot.
Este artigo descreve os passos para implementar e personalizar o conector Atlassian Jira Cloud.
Importante
O conector Atlassian Jira Cloud Copilot suporta apenas instâncias alojadas na cloud da Jira. Este conector não suporta versões do Jira Server e do Centro de Dados Jira.
Para obter informações de configuração do serviço cloud Jira, veja Configurar o serviço Jira Cloud para ingestão de conectores.
Pré-requisitos
Antes de implementar o conector Atlassian Jira Cloud, certifique-se de que o ambiente da Cloud Jira está configurado na sua organização. A tabela seguinte resume os passos para configurar o ambiente da Jira Cloud e implementar o conector.
| Tarefa | Função |
|---|---|
| Configurar o serviço Jira Cloud | Administrador da Jira Cloud |
| Implementar o conector no Centro de administração do Microsoft 365 | Administrador do Microsoft 365 |
| Personalizar as definições do conector (opcional) | Administrador do Microsoft 365 |
Antes de implementar o conector, certifique-se de que cumpre os seguintes pré-requisitos:
- Tem de ser o administrador de pesquisa do inquilino do Microsoft 365 da sua organização.
- Certifique-se de que conhece o URL da instância da Cloud da Jira para a sua organização. Para ligar aos seus dados Jira, precisa do URL da instância Jira da sua organização.
- Para ligar à Jira e permitir que o conector Atlassian Jira Cloud Copilot atualize os problemas regularmente, precisa de uma conta de serviço com as seguintes permissões concedidas.
| Nome da permissão | Tipo de permissão | Necessário para |
|---|---|---|
| Procurar projetos | Permissão do projeto | Problemas de pesquisa da Jira. Esta permissão é necessária para os projetos que precisam de ser indexados. |
| Permissões de segurança ao nível do problema | Segurança ao nível do problema | Pesquisar diferentes tipos de problemas. Esta permissão é opcional. |
| Procurar utilizadores e grupos | Permissão global | Limitação de segurança com base nas permissões de acesso dos resultados da pesquisa. Esta permissão é necessária se selecionar a definição Apenas pessoas com acesso a esta origem de dados de utilizador; caso contrário, é opcional. |
| Administrar Jira | Permissão global | Limitação de segurança com base nas permissões de acesso dos resultados da pesquisa. Esta permissão é necessária se selecionar a definição Apenas pessoas com acesso a esta origem de dados de utilizador; caso contrário, é opcional. |
Implementar o conector
Para adicionar o conector Atlassian Jira Cloud à sua organização:
- Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectoresCopilot>.
- Aceda ao separador Conectores e, no painel esquerdo, selecione Galeria.
- Na lista de conectores disponíveis, selecione Atlassian Jira Cloud.
Definir nome a apresentar
O nome a apresentar é utilizado para identificar referências em respostas copilot para ajudar os utilizadores a reconhecer o ficheiro ou item associado. O nome a apresentar também significa conteúdo fidedigno e é utilizado como um filtro de origem de conteúdo.
Pode aceitar o nome a apresentar da Cloud Atlassian Jira predefinido ou personalizar o valor para utilizar um nome a apresentar que os utilizadores na sua organização reconheçam.
Para obter mais informações sobre os nomes a apresentar e descrições do conector, veja Melhorar a deteção do Copilot com Microsoft 365 Copilot conteúdos dos conectores.
Definir URL da instância
Para ligar aos dados da sua cloud Jira, precisa do URL da instância Jira da sua organização. Normalmente, o URL da instância Jira da sua organização tem o seguinte aspeto: https://<your-organization-domain>.atlassian.net.
Se ainda não tiver uma instância, veja Atlassian Jira para criar uma instância de teste.
Escolher tipo de autenticação
Para autenticar e sincronizar problemas da Jira, escolha um dos seguintes métodos de autenticação suportados:
Autenticação básica – introduza o nome de utilizador da sua conta (normalmente ID de e-mail) e o token de API para autenticar com autenticação básica. Para obter informações sobre como gerar um token de API, veja Manage API tokens for your Atlassian account (Gerir tokens de API para a sua conta Atlassian).
Atlassian Jira OAuth 2.0 (recomendado) - Para utilizar o Jira OAuth para autenticação:
- Registe uma aplicação no Atlassian Jira para que a aplicação Microsoft Search e Microsoft 365 Copilot possam aceder à instância. Para obter mais informações, consulte Ativar o OAuth 2.0.
- Inicie sessão na consola do Atlassian Developer com a sua conta de administrador atlassian Jira.
- Selecione Criar e selecione Integração OAuth 2.0.
- Forneça um nome adequado para a aplicação e crie a nova aplicação.
- Aceda a Permissões no painel de navegação à esquerda. Selecione Adicionar para API Jira e selecione Configurar. Em Permissões Granulares, adicione os âmbitos necessários.
- Aceda a Autorização no painel de navegação à esquerda para adicionar o URL de chamada de retorno:
- Para Microsoft 365 Enterprise:
https://gcs.office.com/v1.0/admin/oauth/callback - Para o Microsoft 365 Administração Pública:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Para Microsoft 365 Enterprise:
- Escolha Salvar.
- Aceda a Definições no painel esquerdo para obter o ID de cliente e o segredo. Conclua o passo de definições de ligação com o ID de Cliente e o Segredo.
Observação
- Para obter mais informações sobre permissões Jira, veja Âmbitos Jira para OAuth 2.0.
- As permissões OAuth originais (clássicas) para a Jira Cloud foram preteridas. Para obter mais informações, veja o anúncio do registo de alterações.
Implementar
Para implementar para uma audiência limitada, selecione o botão de alternar junto a Implementação para audiência limitada e especifique os utilizadores e grupos para os quais pretende implementar o conector. Para obter mais informações, veja Implementação faseada para conectores Microsoft 365 Copilot.
Selecione Criar para implementar a ligação. O conector Atlassian Jira Cloud Copilot começa imediatamente a indexar conteúdos.
Seguem-se os valores predefinidos do conector:
Usuários
- Permissões de acesso: apenas pessoas com acesso ao conteúdo na Origem de dados.
- Identidades do Mapa: identidades de origem de dados mapeadas com Microsoft Entra IDs.
Conteúdo
- Projetos de site: todos os projetos são indexados.
- Filtrar dados: todos os problemas são indexados. Não é aplicado nenhum filtro de tempo ou critérios JQL.
- Gerir Propriedades: para marcar propriedades predefinidas e o respetivo esquema, veja Personalizar definições de conteúdo
Sincronizar
- Pesquisa Incremental: Frequência: a cada 15 minutos
- Pesquisa Completa: Frequência: Todos os Dias
Depois de criar a ligação, pode rever a status na secção Conectores do Centro de administração do Microsoft 365.
Personalizar definições (opcional)
Pode personalizar os valores predefinidos para as definições do conector Atlassian Jira Cloud. Para personalizar as definições, na página do conector no centro de administração, selecione Configuração personalizada.
Personalizar as definições do utilizador
Permissões de acesso
O conector Atlassian Jira Cloud Copilot suporta permissões de pesquisa visíveis para Todos ou Apenas pessoas com acesso a esta origem de dados. Se escolher Todos, os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores. Se escolher Apenas as pessoas com acesso a esta origem de dados, os dados indexados são apresentados nos resultados da pesquisa para os utilizadores que têm acesso aos mesmos. No Atlassian Jira, as permissões de segurança são definidas através de esquemas de permissão de projetos que contêm grupos ao nível do site e funções de projeto. A segurança ao nível do problema também pode ser definida através de esquemas de permissões ao nível do problema.
Importante
O conector Atlassian Jira Cloud Copilot tem de conseguir ler o ID de e-mail de um utilizador em Jira para atribuir adequadamente permissões de segurança no Microsoft Search e Microsoft 365 Copilot. Isto requer que garanta um dos seguintes procedimentos:
- Todos os utilizadores devem selecionar a opção Qualquer pessoa para as respetivas definições de visibilidade do perfil. Para saber mais sobre as definições de visibilidade do perfil, consulte Atualizar as definições de perfil e visibilidade.
- Para organizações que utilizam contas geridas:
- Todos os utilizadores têm de ter a definição de conta gerida selecionada nas definições de visibilidade do perfil.
- Os utilizadores que não fazem parte da conta gerida (igual à conta de pesquisa) têm de ter Qualquer pessoa selecionada nas definições de visibilidade do perfil.
- A conta de pesquisa utilizada durante a configuração da ligação tem de ter o domínio da conta gerida.
Identidades de mapeamento
O método predefinido para mapear as identidades da origem de dados com Microsoft Entra ID é tornar o ID de e-mail dos utilizadores Jira igual ao nome principal de utilizador (UPN) ou endereço de e-mail dos utilizadores no Microsoft Entra ID. Se o mapeamento predefinido não funcionar para a sua organização, pode fornecer uma fórmula de mapeamento personalizada. Para obter mais informações, consulte Mapear identidades não Azure AD.
- Escolha a opção Microsoft Entra ID se o ID de e-mail dos utilizadores da Jira for igual ao UPN dos utilizadores no Microsoft Entra ID.
- Selecione a opção Não Microsoft Entra ID se o ID de e-mail dos utilizadores de Jira for diferente do UPN e do e-mail dos utilizadores no Entra ID.
Observação
Atualizações a grupos que regem as permissões de acesso são sincronizados apenas em pesquisas completas. As pesquisas incrementais não suportam o processamento de atualizações para permissões.
Personalizar definições de conteúdo
Escolher projetos e filtrar dados
- Projetos de site: pode escolher a ligação para indexar apenas todo o site Jira ou projetos específicos.
- Se optar por indexar todo o site Jira, os problemas de Jira em todos os projetos no site são indexados. Os novos projetos e problemas são indexados durante a pesquisa seguinte depois de serem criados.
- Se escolher projetos individuais, apenas os problemas de Jira nos projetos selecionados são indexados.
Observação
Quando concede a permissão Procurar projetos a um projeto Jira, este é listado na seleção do projeto e pode ser pesquisado. Se um projeto estiver em falta, marcar as permissões da sua conta.
- Filtrar dados: pode optar por filtrar os problemas de Jira indexados de duas formas:
- Especifique o período de tempo de modificação do problema. Esta opção indexa apenas os problemas de Jira que são criados ou modificados no período de tempo selecionado sem interrupção com base na pesquisa atual.
- Utilize o filtro JQL para indexar apenas tipos de problemas específicos de Jira com
issueType in (Bug, Improvement).
Gerir propriedades
Pode adicionar ou remover propriedades disponíveis da sua origem de dados Jira, atribuir um esquema à propriedade (definir se uma propriedade é pesquisável, pesquisável, recuperável ou refinável), alterar a etiqueta semântica e adicionar um alias à propriedade. A tabela seguinte lista as propriedades selecionadas por predefinição.
| Propriedade Source | Rótulo | Descrição | Esquema |
|---|---|---|---|
| Autores | Autores | Atribua um nome a todas as pessoas que participaram/colaboraram no item | Obter |
| Criado | Data e hora de criação | Data e hora em que o item foi criado na origem de dados | Consultar, Obter |
| IssueDescription | Conteúdo | A descrição do problema | Pesquisar |
| IssueIconURL | IconUrl | URL do ícone que representa o tipo de problema | Obter |
| IssueId | |||
| IssueKey | |||
| IssueLink | url | A URL de destino do item na fonte de dados | Consultar, Obter |
| IssueStatus | Consultar | ||
| IssueSummary | |||
| ProjectName | Consultar | ||
| ReporterEmailId | Criado por | Obter | |
| ReporterName | Consultar, Obter | ||
| Título | Título | O título do item que pretende que seja apresentado em Copilot e outras experiências de pesquisa | Procurar, Consultar, Obter |
| Atualizado | Hora da última modificação | Data e hora em que o item foi modificado pela última vez na origem de dados | Consultar, Obter |
Observação
- O conector Atlassian Jira Cloud Copilot pode indexar campos de problema predefinidos e campos de problema criados por personalizados.
- Se um campo de criação personalizada selecionado não estiver presente num tipo de problema Jira, o campo é ingerido como NULO (em branco).
- A lista de propriedades que selecionar afeta a forma como os utilizadores podem filtrar, procurar e ver resultados no Copilot.
Pré-visualizar dados
Utilize o botão de resultados de pré-visualização para verificar os valores de exemplo das propriedades selecionadas e do filtro de consulta.
Personalizar intervalos de sincronização
O intervalo de atualização determina a frequência com que os dados são sincronizados entre a origem de dados e o índice do conector Atlassian Jira Cloud Copilot. Seguem-se os dois tipos de intervalos de atualização:
- Pesquisa incremental: a cada 15 minutos
- Pesquisa completa: todos os dias
Pode alterar os valores predefinidos do intervalo de atualização. Para obter mais informações, veja Diretrizes para definições de sincronização.