Condividi tramite


Atlassian Jira Data Center Microsoft Graph Connector (anteprima)

Il connettore Microsoft Graph di Jira Data Center consente all'organizzazione di indicizzare i problemi di Jira Data Center e i dati correlati, rendendoli facilmente individuabili e interattivi all'interno dell'ecosistema di Microsoft 365.

Questo articolo è destinato agli amministratori di Microsoft 365 responsabili della configurazione, dell'esecuzione e del monitoraggio del connettore Microsoft Graph di Jira Data Center. Integra le istruzioni generali fornite in Configurare i connettori di Microsoft Graph nel interfaccia di amministrazione di Microsoft 365.

Nota

Il connettore Jira Data Center è disponibile in anteprima pubblica. Se si vuole ottenere l'accesso per provarlo, è necessario abilitare l'anello rilascio mirato per l'account Amministrazione.

Funzionalità

Funzionalità avanzate di Copilot: gli utenti possono porre domande in linguaggio naturale sui problemi di Jira e sui dati del progetto in Microsoft 365 Copilot. Ad esempio:

  • "Riepilogare i problemi aperti in Project Alpha".

  • "Mostrami tutti i bug ad alta priorità archiviati questa settimana."

Supporto per la ricerca semantica: gli utenti possono digitare query in linguaggio naturale all'interno di Microsoft Search per ottenere risposte altamente rilevanti e ricche di contesto su progetti e problemi Jira.

Nota

Compatibile solo con Jira Data Center versione 8.14 e successive.

Usando il connettore Microsoft Graph di Jira Data Center, i team possono mantenere l'ambiente Jira locale sfruttando al tempo stesso potenti funzionalità di Microsoft Search e Copilot, garantendo che i problemi critici e i dettagli del progetto siano facilmente individuabili e interattivi.

Prerequisiti

1. Installare l'agente connettore Microsoft Graph (GCA)

Per indicizzare il contenuto di Jira Data Center, è necessario installare GCA in un computer Windows all'interno della stessa rete del sito Jira Data Center. Vedere installare l'agente connettore Microsoft Graph. È necessario essere l'amministratore del tenant microsoft 365 dell'organizzazione e l'amministratore del sito Jira dell'organizzazione.

Nota

Se il GCA è stato installato in precedenza, assicurarsi che sia aggiornato alla versione 3.1.3.0 o successiva.

2. Installare il plug-in Jira Data Center

Installare il plug-in Jira Data Center da Microsoft Graph Connector per Jira Data Center | Atlassian Marketplace seguendo il passaggio di installazione.

Introduzione

1. Nome visualizzato

Il nome visualizzato consente agli utenti di riconoscere facilmente il file o l'elemento associato in Copilot, che indica il contenuto attendibile. Il nome visualizzato viene usato anche come filtro dell'origine di contenuto. Per questo campo è presente un valore predefinito, ma è possibile personalizzarlo in base a un nome riconosciuto agli utenti dell'organizzazione.

2. URL del data center Jira

Per connettersi ai dati di Jira Data Center, usare l'URL dell'istanza di Jira Data Center dell'organizzazione, in genere formattato come https://<your-organization-domain>.com.

3. Graph Connector Agent (GCA)

L'agente del connettore graph funge da ponte tra l'istanza di Jira Data Center e le API del connettore, consentendo il trasferimento dei dati sicuro ed efficiente. In questo passaggio selezionare la configurazione dell'agente da usare per il connettore. Vedere installare l'agente connettore Microsoft Graph.

4. Tipo di autenticazione

Attualmente OAuth 2.0 è supportato nella configurazione della connessione. Per immettere l'ID client e il segreto client nella configurazione della connessione, vedere le istruzioni seguenti per ottenerli.

  1. Accedere al data center Jira.

  2. Fare clic sull'icona delle impostazioni -> Fare clic su applicazione -> Fare clic sui collegamenti dell'applicazione.

    Screenshot di Fare clic su Applicazione.

    Screenshot dei collegamenti dell'applicazione.

  3. Selezionare Crea collegamento.

    {Screenshot del collegamento Seleziona crea.}

  4. Selezionare Applicazione esterna e quindi scegliere In ingresso come direzione.

    {Screenshot di Select External application (Seleziona applicazione esterna) e quindi scegliere Incoming (In ingresso) come direzione.}

  5. Compilare il modulo "Configura un collegamento in ingresso".

    • URL di reindirizzamento: per M365 Enterprise, https://gcs.office.com/v1.0/admin/oauth/callback.
    • Ambito: Amministrazione

    {Screenshot di Compilare il modulo

  6. Copiare l'ID client e il segreto specificati nella pagina "Credenziali" e incollarli nei campi corrispondenti nella pagina di configurazione della connessione Jira Data Center.

    {Screenshot dell'ID client e del segreto.}

5. Implementazione a un pubblico limitato

Distribuire questa connessione in una base di utenti limitata se si vuole convalidarla in Copilot e in altre aree di ricerca prima di espandere l'implementazione a un pubblico più ampio. Per altre informazioni sull'implementazione limitata, fare clic qui.

A questo punto, si è pronti per creare la connessione per il data center Jira. È possibile confermare l'avviso e quindi fare clic sul pulsante Crea e il connettore Microsoft Graph avvia l'indicizzazione dei dati dal sito Jira Data Center.

Per altre impostazioni, vengono impostate le impostazioni predefinite in base a ciò che funziona meglio con i dati di Jira Data Center. I valori predefiniti sono i seguenti:

Pagina Impostazioni Valori predefiniti
Utenti Autorizzazioni di accesso Solo gli utenti con accesso a questa origine dati.
Utenti Identità mappa Identità dell'origine dati mappate tramite ID Microsoft Entra.
Contenuto Filtro Tutti i progetti
Contenuto Gestisci proprietà Per controllare le proprietà predefinite e il relativo schema, fare clic qui.
Sincronizza Ricerca per indicizzazione incrementale Frequenza: ogni 15 minuti
Sincronizza Ricerca per indicizzazione completa Frequenza: ogni giorno

Se si desidera modificare uno di questi valori, è necessario scegliere l'opzione Installazione personalizzata .

Installazione personalizzata

La configurazione personalizzata consente agli amministratori di modificare i valori predefiniti indicati in precedenza. Dopo aver fatto clic sull'opzione Installazione personalizzata , vengono visualizzate altre tre schede: Utenti, Contenuto e Sincronizzazione.

Utenti

Autorizzazioni di accesso

Il connettore Microsoft Graph di Jira Data Center supporta i dati visibili solo agli utenti con accesso a questa origine dati (scelta consigliata) o a Tutti. Se si sceglie Tutti, i dati indicizzati vengono visualizzati nei risultati della ricerca per tutti gli utenti.

Se si sceglie Solo gli utenti con accesso a questa origine dati, è necessario scegliere ulteriormente se il data center di Jira ha Microsoft Entra ID utenti con provisioning o utenti non AAD.

Per identificare l'opzione adatta all'organizzazione:

  1. Scegliere l'opzione Microsoft Entra ID se l'ID di posta elettronica degli utenti di Jira Data Center è uguale a UserPrincipalName (UPN) degli utenti in Microsoft Entra ID.

  2. Scegliere l'opzione non AAD se l'ID di posta elettronica degli utenti di Confluence è diverso da UserPrincipalName (UPN) degli utenti in Microsoft Entra ID.

Importante

  • Se si sceglie Microsoft Entra ID come tipo di origine identità, il connettore esegue il mapping degli ID di posta elettronica degli utenti ottenuti da Jira Data Center direttamente alla proprietà UPN da Microsoft Entra ID.
  • Se si sceglie "non AAD" per il tipo di identità, vedere Eseguire il mapping delle identità non Azure AD per istruzioni sul mapping delle identità. È possibile usare questa opzione per fornire l'espressione regolare di mapping dall'ID di posta elettronica all'UPN.
  • Aggiornamenti agli utenti o ai gruppi che controllano le autorizzazioni di accesso vengono sincronizzati solo in ricerche per indicizzazione complete. Le ricerche per indicizzazione incrementali non supportano attualmente l'elaborazione degli aggiornamenti alle autorizzazioni.

Contenuto

Scegliere progetti e filtrare i dati

Quando si sceglie "Intero sito JiraDataCenter", tutti i progetti correnti e futuri vengono indicizzati. Quando si sceglie "Solo alcuni progetti", vengono indicizzati solo i progetti selezionati.

Filtrare i dati

È possibile filtrare i problemi di JiraDataCenter in base al timestamp di creazione o ultimo aggiornamento per indicizzare solo il contenuto recente. Per i filtri avanzati è possibile aggiungere anche una stringa JQL .

Gestisci proprietà

Questa sezione definisce lo schema per la connessione. Lo schema determina il modo in cui il contenuto Jira indicizzato viene inserito ed elaborato all'interno del connettore Graph. È possibile aggiungere o modificare le proprietà per garantire che la struttura dei dati sia allineata alle esigenze dell'organizzazione per Copilot e le esperienze di ricerca. È anche possibile aggiungere campi personalizzati da Jira Data Center come proprietà. Altre informazioni.

Proprietà Source Etichetta semantica Schema
AssigneeEmailId Query, Recupero, Ricerca
AssigneeName Query, Recupero, Ricerca
Autori Autori Query, Retrieve
Creazione Data e ora di creazione Recuperare
DueDate Recuperare
IssueDescription Ricerca
IssueIconUrl IconUrl Recuperare
IssueId Recuperare
IssueKey Query, Recupero, Ricerca
IssueLink Url Query, Recupero, Ricerca
IssuePriority Query, Recupero, Ricerca
IssueStatus Query, Retrieve
IssueSummary Ricerca
IssueType Query, Retrieve
Etichette Query, Retrieve
NomeProgetto Query, Retrieve
ReporterEmailId Creato da Query, Recupero, Ricerca
ReporterName Query, Recupero, Ricerca
Titolo Titolo Query, Recupero, Ricerca
Aggiornato Data e ora dell'ultima modifica Query, Retrieve

Anteprima dei dati Usare il pulsante dei risultati dell'anteprima per verificare le proprietà e i filtri selezionati.

Sincronizzazione

L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore Graph. Esistono due tipi di intervalli di aggiornamento: ricerca per indicizzazione completa e ricerca per indicizzazione incrementale. Per altri dettagli, fare clic qui.

Esaminare e testare la connessione

Per Ms Search, se è necessario personalizzare la pagina dei risultati della ricerca. Per informazioni sulla personalizzazione dei risultati della ricerca, vedere Personalizzare la pagina dei risultati della ricerca.

Risoluzione dei problemi

Dopo aver pubblicato la connessione, è possibile esaminare lo stato nella scheda Origini datinell'interfaccia di amministrazione. Per informazioni su come eseguire aggiornamenti ed eliminazioni, vedere Gestire il connettore.

In caso di problemi o se si desidera fornire commenti e suggerimenti, contattare Microsoft Graph | Supporto.