Conector CSV do Microsoft Graph

O conector CSV do Microsoft Graph permite à sua organização ingerir conteúdo de ficheiros CSV armazenados em bibliotecas e Azure Data Lake Storage do SharePoint (ADLS). Depois de configurar o conector e o conteúdo do índice a partir destas origens, os utilizadores finais podem encontrar ficheiros CSV no Microsoft Search e Microsoft 365 Copilot.

Este artigo destina-se a qualquer pessoa que configure, execute e monitorize um conector CSV do Microsoft Graph. Complementa o processo de configuração geral e mostra instruções que se aplicam apenas a este conector.

Antes de começar

• Certifique-se de que não existe espaço em branco nos cabeçalhos CSV

• Para uma origem de dados do SharePoint, pode autenticar através de um dos dois fornecedores OAuth: Microsoft Entra ID (brevemente) ou fornecedor do SharePoint (descontinuado em breve).

  • Para autenticar com Microsoft Entra ID terá de criar e registar uma aplicação no Microsoft Entra ID.
  • Para autenticar com o fornecedor do SharePoint, terá de criar uma aplicação do SharePoint com a configuração OAuth.

Dica

Poderá mudar o fornecedor OAuth para a ligação publicada do SharePoint para o Microsoft Entra ID, assim que estiver disponível

• Para uma origem de dados do ADLS, terá de criar uma conta de armazenamento do ADLS.

Fonte de dados do SharePoint

Carregar os ficheiros CSV

Verifique se os ficheiros .csv que pretende indexar foram carregados para uma biblioteca de documentos do SharePoint. Pode utilizar um site do SharePoint existente ou criar um novo.

Criar uma aplicação no Microsoft Entra ID

1. Aceda à portal do Azure e inicie sessão com as credenciais de administrador do inquilino.

2. Navegue para Microsoft Entra ID ->Manage ->Registros de aplicativo no painel de navegação e selecione Novo registo.

3. Forneça um nome para a aplicação e selecione Registar.

4. Anote o ID da aplicação (cliente).

5. Abra as permissões da API no painel de navegação e selecione Adicionar uma permissão.

6. Selecione SharePoint e, em seguida , Permissões delegadas.

7. Procure as seguintes permissões e selecione Adicionar permissões.
   a. AllSites.Read
   b. User.Read.All

8. Selecione Conceder consentimento do administrador para [TenantName] e confirme ao selecionar Sim.

9. Verifique se as permissões estão no estado "concedido".

10. Abra Autenticação no painel de navegação e selecione Adicionar uma plataforma. Selecione Web em Aplicações Web e adicione o seguinte em URIs de Redirecionamento (URIs de chamada de retorno de autorização):

    • Para O M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback
    • Para o M365 Administração Pública: https://gcsgcc.office.com/v1.0/admin/oauth/callback

Configurar o segredo do cliente para autenticação

1. Aceda à portal do Azure e inicie sessão com as credenciais de administrador do inquilino.

2. Abra o Registo de Aplicações a partir do painel de navegação e aceda à Aplicação adequada. Em Gerir, selecione Certificados e Segredos.

3. Selecione Novo Segredo do Cliente e selecione um período de expiração para o segredo. Copie o segredo gerado e guarde-o porque não é apresentado novamente.

4. Utilize este Segredo do cliente e o ID da aplicação para configurar o conector.

Criar uma aplicação do SharePoint com a configuração OAuth (descontinuar em breve)

1. Saiba mais em https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspx.
2. Nos campos ID de Cliente e Segredo do Cliente, selecione Gerar.
3. Em Título, introduza um nome de aplicação.
4. No campo Domínio da Aplicação, introduza www.gcs.com.
5. No campo URL de Redirecionamento, introduza https://www.gcs.com.
6. Selecione Criar.
7. Copie as informações de configuração da aplicação, incluindo o ID de Cliente e o Segredo do Cliente. Irá precisar dele quando configurar o conector CSV.

Ativar permissões de aplicações para permitir a personalizaçãoAppAuthentication

No PowerShell (Shell de Gerenciamento do SharePoint Online), execute estes comandos no modo administrativo. Utilize o endereço de e-mail do administrador que configura o conector e o nome da sua organização. Quando o pop-up de palavra-passe for apresentado, o administrador deverá introduzir a palavra-passe.

Install-Module -Name Microsoft.Online.SharePoint.PowerShell
$adminUPN=”<admin@contoso.onmicrosoft.com>”
$orgName=“<contoso>”
$userCredential = Get-Credential -UserName $adminUPN -Message "Enter your password."
Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCredential
Set-spotenant –DisableCustomAppAuthentication $false

Observação

Se estiver a utilizar o PowerShell 7, utilize primeiro este comando Import-Module microsoft.online.sharepoint.powershell -UseWindowsPowerShell

Observação

Se estiver a utilizar a autenticação multifator, utilize Connect-SPOService -Url https://$orgName-admin.sharepoint.com.

Concluir a configuração da aplicação

1. Saiba mais em https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appinv.aspx.
2. No campo ID da Aplicação, cole o ID de cliente da aplicação SharePoint e selecione Pesquisa.
3. No campo XML do Pedido de Permissão, cole este código e selecione Criar.

<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>

4. Selecione Confiar.

Origem de dados do ADLS

Criar uma conta de armazenamento do ADLS

Para obter orientações passo a passo, veja Criar uma conta de armazenamento. Para permitir capacidades de armazenamento de ficheiros, no separador Avançadas, selecione Ativar espaço de nomes hierárquico e Criar um contentor para este site.

Quando configurar o conector CSV do Microsoft Graph, terá de fornecer um cadeia de conexão de armazenamento primário. Para encontrá-la, abra a conta de armazenamento que criou e selecione Chaves de acesso. Selecione Mostrar chaves e copie o cadeia de conexão para Key1.

Passo 1: Adicionar um conector do Microsoft Graph no Centro de administração do Microsoft 365

Adicionar conector CSV do Microsoft Graph

Siga as instruções de configuração gerais.

Passo 2: atribuir um nome à ligação

Siga as instruções de configuração gerais.

Passo 3: Configurar as definições de ligação

As definições da origem de dados são diferentes para o SharePoint e o ADLS.

Observação

Certifique-se de que o ficheiro csv não tem qualquer formatação ou espaços (' ') presentes nas linhas de cabeçalho.

Para uma origem do SharePoint

1. Nas definições da Origem de Dados, selecione SharePoint como a sua origem de dados.

2. No site do SharePoint, introduza o URL do site, https://Org-Name.sharepoint.com/Site-Name, por exemplo.

3. Na Biblioteca de Documentos, introduza o nome da biblioteca onde os ficheiros .csv estão armazenados.

4. No fornecedor OAuth, pode selecionar Fornecedor do SharePoint (descontinuado em breve) ou Microsoft Entra ID
   

   a. Por Microsoft Entra ID (brevemente):
   1. Tipo de Autenticação, selecione Oauth2.0 (código de autorização).
   2. Introduza o ID de Cliente e o Segredo do Cliente que copiou quando criou a aplicação Microsoft Entra ID.
   3. Selecione Iniciar Sessão. Deverá receber uma mensagem Ligação bem-sucedida .
   

   b. Para o Fornecedor do SharePoint (descontinuado em breve):
   1. Em Tipo de Autenticação, selecione Oauth2.0 (credenciais de cliente).
   2. Introduza o ID de Cliente e o Segredo do Cliente que copiou quando criou a aplicação SharePoint.
   3. Selecione Testar Ligação. Deverá receber uma mensagem Ligação bem-sucedida .

Para controlar o acesso ao nível de um ficheiro, introduza Microsoft Entra utilizadores ou grupos.

Para uma origem do ADLS

1. Nas definições da Origem de Dados, selecione Azure Data Lake Storage (ADLS) como a sua origem de dados.
2. Em Armazenamento primário cadeia de conexão, introduza o cadeia de conexão que copiou.
3. Introduza o Nome do contentor e Nome de ficheiro.
4. Selecione Testar Ligação. Deverá obter uma mensagem A ligação foi bem-sucedida .

Observação

Se a sua origem de dados contiver vários ficheiros .csv com os mesmos cabeçalhos, selecione Incluir todos os ficheiros CSV na localização.

Para controlar o acesso ao nível de um ficheiro, introduza Microsoft Entra utilizadores ou grupos.

Passo 4: Delimitador de múltiplos itens (Opcional)

Se as colunas de origem puderem utilizar vários valores, introduza um delimitador de vários itens, um ponto e vírgula (;) por exemplo.

Passo 5: Definições de propriedades analisadas

Esta página devolve a primeira linha do ficheiro .csv como Propriedades de Origem. Para modificar o tipo de dados, na lista Identificador exclusivo , selecione pelo menos uma opção.

Para controlar o acesso ao nível de um item, selecione colunas mapeadas para utilizadores permitidos e grupos permitidos. Deve incluir duas colunas, AllowedUsers e AllowedGroups, no ficheiro .csv. Cada linha deve conter os IDs de Microsoft Entra.

Observação

O conector CSV do Microsoft Graph suporta o controlo de acesso ao nível do ficheiro ou do item. Se ambos estiverem ativados, só é aplicado o controlo de acesso ao nível do ficheiro.

Passo 6: Atribuir etiquetas de propriedade

Siga as instruções de configuração gerais.

Observação

A etiqueta IconURL é preenchida por predefinição e o mapeamento não pode ser alterado.

Passo 7: Gerir o esquema

Siga as instruções de configuração gerais.

Passo 8: Gerir permissões de pesquisa

• Para controlo de acesso ao nível do ficheiro ou do item, selecione Apenas pessoas com acesso a esta origem de dados.
• Selecionar Todos permite que todas as pessoas na sua organização vejam os resultados da pesquisa desta origem de dados.

Passo 9: escolher as definições de atualização

Siga as instruções de configuração gerais.

Passo 10: Rever a ligação

Siga as instruções de configuração gerais.

Limitações

Seguem-se limitações conhecidas do conector CSV do Microsoft Graph:

• Neste momento, os cenários de melhoramento de perfis não são suportados.

Solução de problemas

Depois de publicar a ligação, pode rever a status no separador Origens de dados no centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector.

Pode encontrar passos de resolução de problemas frequentemente vistos aqui.

Se tiver problemas ou quiser fornecer comentários, contacte o [Microsoft Graph | Suporte (https://developer.microsoft.com/en-us/graph/support).