Condividi tramite


Risolvere i problemi relativi al connettore di Microsoft 365 Copilot locale di Confluence

Il connettore Microsoft 365 Copilot locale di Confluence consente a Microsoft 365 di indicizzare e recuperare il contenuto da istanze self-hosted di Confluence Data Center o Server. Porta contenuti wiki aziendali in Microsoft Search e Copilot, migliorando la visibilità e l'usabilità all'interno dell'ecosistema di Microsoft 365.

Questo articolo fornisce informazioni sulla risoluzione dei problemi relativi agli errori comuni che potrebbero verificarsi durante la distribuzione o la gestione del connettore locale Confluence.

Per verificare le informazioni di configurazione di Confluence per risolvere gli errori, vedere Configurare il servizio Confluence per l'inserimento del connettore.

Risolvere gli errori comuni

Nella tabella seguente sono elencati gli errori comuni che possono verificarsi con il connettore locale Confluence e i passaggi consigliati per la risoluzione dei problemi.

Error Descrizione Risoluzione
OAuth non riuscito a causa di Invalid connection credentials Si verifica quando l'amministratore di Microsoft 365 non è l'amministratore di Confluence. Usare InPrivate browsing. Condividere il collegamento popup OAuth con l'amministratore di Confluence per l'approvazione. Dopo l'approvazione, incollare window.opener.postMessage({type: 'oauthFinish', isSuccess: true}, '*') nella console.
Plug-in non installato o disabilitato Il plug-in Confluence On-prem richiesto è mancante o disabilitato. Passare a Amministrazione>Gestire le app. Se il plug-in non è installato, scaricarlo da Atlassian Marketplace. Se è disabilitato, abilitarlo.
Plug-in Web per dispositivi mobili mancante Il plug-in Confluence Mobile Web è necessario per l'indicizzazione. Verificare che il plug-in sia installato e abilitato in App di sistema. Se manca, scaricarlo dal Marketplace Atlassian.
Problemi di indicizzazione Gli utenti non possono accedere al contenuto indicizzato a causa di una mancata corrispondenza dell'identità. Assicurarsi che gli ID di posta elettronica in Confluence corrispondano agli UPN in Microsoft Entra ID. Per gli utenti non Microsoft Entra ID, configurare il mapping regex.
Nessun contenuto indicizzato Il connettore mostra zero elementi indicizzati. Controllare le autorizzazioni di spazio e pagina. Verificare che l'account del servizio abbia accesso in lettura. Verificare che gli spazi non siano archiviati.
Ricerca per indicizzazione incrementale che non sincronizza gli aggiornamenti delle autorizzazioni Le modifiche alle autorizzazioni non vengono riflesse nei risultati della ricerca. Usare la ricerca per indicizzazione completa per sincronizzare gli aggiornamenti delle autorizzazioni. La ricerca per indicizzazione incrementale non supporta le modifiche alle autorizzazioni.
Ritardi di limitazione delle API La ricerca per indicizzazione è lenta a causa della limitazione lato server. Esaminare i limiti dell'API del server confluence. Se necessario, richiedere modifiche alla limitazione tramite il supporto tecnico Microsoft.
GCA offline Il connettore non riesce a eseguire l'indicizzazione quando il computer graph connector agent è disattivato. Assicurarsi che il computer GCA sia online durante le operazioni di ricerca per indicizzazione.
Filtri di data non corretti Nessuna pagina indicizzata a causa di filtri di data non configurati correttamente. Assicurarsi che la data dell'ultima creazione sia precedente alla data dell'ultima modifica. Se non vengono specificate date, tutti i documenti vengono indicizzati.

Risolvere i problemi relativi alle autorizzazioni utente

Se un utente non riesce a trovare le pagine di Confluence Data Center in Microsoft 365 Copilot o Microsoft Search e l'account deve avere accesso, seguire questa procedura per risolvere i problemi.

Verificare che l'utente disponga dell'autorizzazione per la pagina Confluence Data Center

  • Assicurarsi che l'utente disponga delle autorizzazioni di visualizzazione per la pagina specifica del data center di Confluence. Per altre informazioni, vedere Controllare chi può visualizzare una pagina.
  • Verificare che la pagina, lo spazio e le pagine padre concedano l'accesso appropriato.

Verificare che l'utente sia mappato correttamente a un'identità Microsoft Entra

Il mapping delle identità utente non corretto impedisce a Copilot e Search di risolvere le autorizzazioni. Per verificare il mapping delle identità:

Screenshot dell'elenco errori per il connettore locale Confluence con l'errore 2006 evidenziato.

Verificare la presenza di caratteri non validi nei nomi di utenti o gruppi di Confluence

Confluence Data Center ha una limitazione nota per i nomi di utenti e gruppi. Quando un nome utente o un nome di gruppo contiene un carattere barra o / barra \\ rovesciata, il data center di Confluence ha esito negativo quando si gestiscono le autorizzazioni con un messaggio di errore "Si è verificato un errore imprevisto". Atlassian ha documentato questo comportamento per Bamboo; la stessa limitazione si applica agli ambienti data center di Confluence. Per altre informazioni, vedere Se è presente un carattere barra nel gruppo o nel nome utente in Bamboo, l'assegnazione di autorizzazioni ha esito negativo.