As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
SharePoint Integração com a Microsoft
Com a SharePoint integração com a Microsoft, você pode realizar ações em SharePoint listas e itens. Você também pode criar bases de conhecimento a partir de SharePoint conteúdo, incluindo bibliotecas de documentos, sites e páginas.
O que é possível fazer
SharePoint os usuários podem fazer perguntas sobre o conteúdo armazenado em seus SharePoint sites e bibliotecas de documentos. Por exemplo, os usuários podem perguntar sobre documentos de projetos, sites de equipe ou pesquisar informações específicas em várias bibliotecas. A integração permite que os usuários acessem e entendam rapidamente as informações de seu SharePoint conteúdo, independentemente da localização ou do tipo, ao mesmo tempo em que fornecem detalhes contextuais, como datas de publicação, histórico de modificações e propriedade do documento — tudo contribuindo para uma descoberta mais eficiente das informações e uma tomada de decisão mais bem informada.
Antes de começar
Certifique-se de ter o seguinte antes de configurar a SharePoint integração.
-
Microsoft SharePoint Online
-
Para conectores de ação: assinatura do Amazon Quick Enterprise
-
Para acesso aos dados: assinatura Amazon Quick Professional ou superior — Como uma etapa única do administrador, seu administrador da Microsoft pode precisar primeiro conceder consentimento organizacional antes que os usuários possam criar uma SharePoint integração para trazer dados. Isso ocorre porque a Microsoft exige aprovação do administrador ao usar novos aplicativos (no nosso caso, o OAuth aplicativo gerenciado), a menos que sua configuração de consentimento do usuário permita ignorar a aprovação do administrador. Os administradores podem conceder o consentimento de toda a organização fazendo login e marcando “Consentimento em nome da sua organização” durante a criação de uma integração para. SharePoint
Prepare o registro e a autenticação de aplicativos da Microsoft
Antes de configurar a integração no Amazon Quick, prepare suas credenciais de registro e autenticação do Microsoft App. SharePoint a integração oferece suporte a diferentes métodos de autenticação, dependendo do tipo de integração e do nível do usuário.
Configuração de autenticação do conector de ação
Para conectores de ação, prepare as credenciais de autenticação usando um destes métodos:
- Autenticação de usuário (3LO)
-
Reúna as seguintes informações do registro do aplicativo Microsoft Azure AD:
URL base - O URL SharePoint do seu site.
ID do cliente - ID do cliente do AWS aplicativo.
Segredo do cliente - segredo do cliente do AWS aplicativo.
URL do token - ponto final do OAuth token.
URL de autenticação - ponto final OAuth de autorização.
URL de redirecionamento - URI de OAuth redirecionamento.
OAuth Escopos necessários:
-
offline_access
-
Notas. Ler. Tudo
-
Sites.Read.All
-
AllSites.Leia (sharepoint)
-
User.Read
- Autenticação de serviço (chave de API)
-
Reúna as seguintes informações do seu SharePoint administrador:
URL base - O URL SharePoint do seu site.
Chave de SharePoint API - chave de acesso à API.
E-mail - E-mail da conta de serviço associada.
Escopo necessário para geração de tokens:
.default- Escopo padrão das permissões do aplicativo.
Configuração de autenticação de acesso a dados
O Amazon Quick oferece suporte à criação de integrações de base de SharePoint conhecimento usando três pernas OAuth (3LO). Para essa abordagem, o Amazon Quick registra um aplicativo multilocatário com permissões delegadas (Sites.Read.All) em sua conta Microsoft Entra. O modelo de permissões delegadas mantém o risco baixo, apesar de ser um aplicativo multilocatário. O Quick só pode ser acessado SharePoint por meio de permissões de usuários autenticados. O modelo de segurança garante que o Quick seja limitado ao que seus usuários podem acessar.
Quando um administrador concede o consentimento organizacional para permitir que os usuários tragam dados para o Amazon Quick, o Azure cria automaticamente um Service Principal (Aplicativo Corporativo) no locatário do cliente. Você pode desativar ou excluir esse Service Principal a qualquer momento de seus aplicativos corporativos, revogando imediatamente todo o acesso.
Para integrações de acesso a dados, prepare-se para a autenticação Microsoft 3LO. Durante a configuração da integração, você precisará:
-
Entre com sua conta da Microsoft que tem acesso ao SharePoint conteúdo.
-
Conceda as permissões solicitadas para permitir que o Amazon Quick acesse seus SharePoint dados.
-
Conclua o processo de autenticação.
Configurar a SharePoint integração
Depois de preparar suas credenciais de registro e autenticação de aplicativos da Microsoft, use a guia Integrações no console do Amazon Quick para configurar SharePoint a integração. O processo de configuração varia de acordo com se você deseja realizar ações, acessar dados ou ambos.
-
No console do Amazon Quick, escolha Integrações.
-
Escolha Microsoft nas opções SharePoint de integração e clique no botão Adicionar (mais “+”).
-
Selecione seu tipo de integração:
-
Traga dados da Microsoft SharePoint - configura conexões de dados para a criação da base de conhecimento.
-
Executar ações na Microsoft SharePoint - Permite ações em SharePoint listas e itens.
-
-
Para a criação da base de conhecimento (traga dados da Microsoft SharePoint):
-
Escolha Próximo.
-
Preencha o nome e conclua a autenticação.
-
Selecione o que pages/files/folders você deseja adicionar.
-
Preencha detalhes como nome, descrição e conteúdo URLs.
-
Selecione Criar e continuar.
-
-
Para ações (Executar ações na Microsoft SharePoint):
-
Escolha Próximo.
-
Adicione nome e descrição.
-
Escolha o tipo de conexão:
-
Autenticação do usuário - autenticação baseada em 3LO para acesso individual do usuário.
-
Autenticação de serviço - Autenticação baseada em chave de API para acesso ao serviço.
-
-
Preencha as configurações de conexão com base no método de autenticação selecionado (usuário ou serviço) usando as credenciais que você preparou anteriormente.
-
Selecione Criar e continuar.
-
Escolha usuários com os quais compartilhar a integração.
-
Clique em Next.
-
Depois de clicar em Criar, a sincronização de dados é iniciada automaticamente.
Revise as ações de tarefas disponíveis
Depois de configurar sua SharePoint integração com os recursos de ação, analise as ações de tarefas disponíveis para entender quais operações você pode realizar. Consulte Ações de tarefas disponíveis a lista completa das ações disponíveis.
Configurar bases de conhecimento
Depois de configurar sua SharePoint integração com os recursos de acesso a dados, você pode criar bases de conhecimento adicionais. Consulte Gerencie bases de conhecimento para obter opções de configuração detalhadas.
Ações de tarefas disponíveis
SharePoint o conector de ação fornece 19 ações para gerenciar SharePoint conteúdo.
| Nome da ação | Description | Tipo |
|---|---|---|
| Criar item | Criar um novo item da lista | Gravar |
| Atualizar item | Atualizar um item da lista existente | Gravar |
| Excluir item | Excluir um item da lista | Gravar |
| Obter item | Recuperar um item específico da lista | Ler |
| Itens da lista | Listar itens em uma SharePoint lista | Ler |
| Obter lista | Recuperar detalhes de uma lista SharePoint | Ler |
nota
Ações adicionais estão disponíveis para gerenciamento de arquivos do Excel, operações do site e gerenciamento avançado de listas. Revise a lista completa de ações depois de criar sua integração.
Gerencie bases de conhecimento
Depois de configurar sua SharePoint integração, você pode criar e gerenciar bases de conhecimento a partir do seu SharePoint conteúdo.
Edite as bases de conhecimento existentes
Você pode modificar suas bases de SharePoint conhecimento existentes:
-
No console do Amazon Quick, escolha Bases de conhecimento.
-
Selecione sua base de SharePoint conhecimento na lista.
-
Escolha o ícone de três pontos em Ações e escolha Editar base de conhecimento.
-
Atualize suas configurações conforme necessário e escolha Salvar.
Crie bases de conhecimento adicionais
Você pode criar várias bases de conhecimento a partir da mesma SharePoint integração:
-
No console do Amazon Quick, escolha Integrações e, em seguida, selecione a guia Dados.
-
Escolha sua SharePoint integração existente na lista.
-
Escolha o ícone de três pontos em Ações e escolha Criar base de conhecimento.
-
Defina as configurações da sua base de conhecimento e escolha Criar.
Para obter informações detalhadas sobre as opções de configuração da base de conhecimento, consulteDefinições de configuração comuns.
Tipos de conteúdo compatíveis
Você pode criar bases de conhecimento a partir desses tipos de SharePoint conteúdo.
Bibliotecas de documentos: Word, Excel PowerPoint, PDF, OneNote (.one)
Arquivos de mídia: MP3, MP4, MOV, WMV
Páginas do site e páginas wiki
Gerencie SharePoint integrações
nota
O Amazon Quick não sincroniza ACLs a partir de fontes de dados. Quando você cria uma base de conhecimento no Amazon Quick, por padrão, somente você pode obter insights da base de conhecimento. Para conteúdo compartilhado, você pode fornecer acesso a diferentes usuários e grupos atualizando as permissões da base de conhecimento.
Solução de problemas
Use esta seção para resolver problemas comuns com a SharePoint integração.
Problemas de autenticação
Problemas do Azure AD
Sintomas: a autenticação falha com erros do Azure AD, falhas na atualização do token ou mensagens de permissão negada.
Causas e resoluções:
-
Registro de aplicativo incorreto: verifique se o registro do aplicativo Azure AD inclui as permissões e os OAuth escopos de API necessários.
-
Segredo do cliente expirado: verifique se o segredo do cliente expirou e gere um novo, se necessário.
-
Permissões insuficientes: certifique-se de que o registro do aplicativo tenha recebido o consentimento do administrador para as permissões necessárias.
-
URI de redirecionamento incorreto: verifique se o URI de redirecionamento no Azure AD corresponde ao configurado no Amazon Quick.
Falhas na sincronização de permissões
Sintomas: os usuários não podem acessar o conteúdo para o qual deveriam ter permissões ou ver o conteúdo que não deveriam acessar.
Causas e resoluções:
-
Atraso na propagação da permissão: SharePoint as permissões podem levar algum tempo para se propagar. Aguarde de 15 a 30 minutos e tente novamente.
-
Permissões de grupos aninhados: verifique se o usuário faz parte de grupos de segurança aninhados que podem afetar as permissões.
-
Herança de permissões quebrada: verifique se os SharePoint itens não violaram inesperadamente a herança de permissões.
Problemas de desempenho de sincronização
Sincronização lenta
Sintomas: a sincronização da base de conhecimento demora mais do que o esperado ou parece travar.
Causas e resoluções:
-
Grande volume de conteúdo: reduza o escopo do conteúdo que está sendo sincronizado aplicando filtros mais restritivos.
-
Conectividade de rede: verifique a estabilidade da conexão de rede e a disponibilidade da largura de banda.
-
SharePoint limitação: SharePoint pode estar limitando solicitações. Tente sincronizar novamente fora do horário de pico.
Problemas de descoberta de conteúdo
Sintomas: O SharePoint conteúdo esperado não está aparecendo na base de conhecimento.
Causas e resoluções:
-
Filtros de conteúdo muito restritivos: revise e ajuste as configurações de filtragem de conteúdo para incluir o conteúdo ausente.
-
Tipos de conteúdo não compatíveis: verifique se o tipo de conteúdo é compatível com a SharePoint integração.
-
Restrições de permissão: garanta que a integração tenha as permissões apropriadas para acessar o conteúdo.
Mensagens de erro comuns
AADSTS50020: User account from identity provider does not exist in tenant-
Causa: A conta do usuário não está configurada corretamente no Azure AD.
Resolução: verifique se a conta do usuário existe no locatário correto do Azure AD e tem as licenças apropriadas.
Access denied. You do not have permission to perform this action-
Causa: SharePoint Permissões insuficientes para a operação solicitada.
Resolução: entre em contato com seu SharePoint administrador para verificar e conceder as permissões apropriadas.
The request is throttled-
Causa: SharePoint está limitando o número de solicitações devido ao alto uso.
Resolução: Aguarde e repita a operação. Considere reduzir a frequência das solicitações ou sincronizar fora do horário de pico.
