Configuração do Conector de pesquisa do SharePoint Online

Configure o Conector de pesquisa do SharePoint Online configurando e conectando o locatário Microsoft SharePoint com sua instância. Valide a conexão para evitar falhas de configuração antes de indexar os sites para pesquisa.

Configurar o locatário Microsoft SharePoint

Configure seu locatário Microsoft SharePoint para começar com o Conector de pesquisa do SharePoint Online.

Antes de Iniciar

Como administrador Microsoft SharePoint, crie uma aplicação personalizada especificando o URL raiz (https://<sitename> .sharepoint.com ), domínio do app, URL de redirecionamento e outras configurações.

Certifique-se de concluir a configuração conforme explicado em .

Faça login com suas credenciais de administrador para conceder permissões.

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Conclua o procedimento a seguir na sua conta Microsoft SharePoint. Para obter mais informações sobre como criar e configurar aplicações personalizadas, consulte o desenvolvimento do SharePoint.
Nota:
Quando as permissões atribuídas nos aplicativos do Azure têm problemas de privilégio, a seguinte mensagem de erro é exibida: Mensagem de erro: Falha no método: (/_api/web/XXXXXXX) com o código: 401 - Combo de nome de usuário/senha inválido. Resolva este problema com as instruções disponíveis em KB1117977.
Quando você quiser que os resultados da pesquisa exibam somente as versões publicadas do documento, certifique-se de selecionar Permissões da aplicação em vez de Permissões delegadas ao configurar as permissões explicadas em Spoke.
Nota:
Os administradores podem limitar a indexação somente das versões publicadas, garantindo que rascunhos ou trabalhos inacabados não sejam exibidos nos resultados da pesquisa.​

Procedimento

  1. Navegar até Azure > Active Directory > Registros da aplicação > Todas as aplicações e selecione seu app.

    Use uma aplicação existente ou crie uma aplicação.

  2. Navegar até Registros da aplicação > Permissões de APIe clique em Adicionar uma permissão.
  3. Selecione uma das seguintes opções.
    1. Navegar até Microsoft Graph > Permissões delegadas para Gráfico.
    2. Navegar até Microsoft Graph > Permissões da aplicação para Gráfico.
    Adicione a permissão Sites.ReadWrite.All da lista de sites. A permissão Sites.ReadWrite.All ajuda na criação da assinatura.

    Adicione a permissão User.Read da lista Usuários.

    Essas permissões de usuário são usadas para rastrear os dados Microsoft SharePoint posteriormente.
  4. Navegar até Sharepoint > Permissões da aplicação > Sitese selecione Sites.FullControl.All ou Sites.Read.All para REST.
  5. Clique em Conceder consentimento do administrador, selecione Sime clique em Salvar e continuar na guia Permissão configurada.
  6. Navegar até Autenticação > Web > URLs de redirecionamento.
    1. Adicione a URL neste formato https://<your Servicenow instance URL> /oauth_redirect.do , por exemplo, https://eesharepoint.example.com/oauth_redirect.do e clique em Salvar.
  7. Navegue até e registre o certificado e o segredo da sua aplicação.
  8. Clique em Adicionar usuário no portal de administração da Microsoft, especifique os detalhes do usuário e clique em Concluir.
    Nota:
    A pesquisa rastreia os sites que você pode acessar. Certifique-se de selecionar o usuário com as permissões apropriadas somente para o conteúdo necessário. Para obter mais informações, consulte permissões do usuário. Selecionar um usuário de alto nível pode importar mais documentos do que você deseja importar.

    Para obter mais informações, consulte https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azuread.

O que Fazer Depois

Conclua a integração da sua conta ServiceNow Pesquisa com IA. Para obter mais informações, consulte Integrar as origens de pesquisa Microsoft SharePointPesquisa com IA aos perfis [].

Conecte sua instância ServiceNow a um locatário Microsoft SharePoint

Conecte sua instância ServiceNow com um locatário Microsoft SharePoint. Crie ServiceNow conexões OAuth personalizadas para Microsoft SharePoint para autenticar ServiceNow solicitações.

Antes de Iniciar

  • Verifique se você tem conhecimento prático das ferramentas do programa de desenvolvedor do SharePoint e de outros recursos para configurar a aplicação.
  • Verifique se você está ciente das integrações ServiceNow®.
  • Execute uma validação para sua configuração antes de começar a indexar os sites.
Função necessária: sn_sp_con.admin e admin.

Procedimento

  1. Navegar até Instância da ServiceNow > OAuth de Sistema > Registro de aplicações.
  2. Clique em Nova.
    O sistema exibe a mensagem Que tipo de aplicação OAuth?
  3. Selecione Conectar a um provedor OAuth de terceiros.
  4. Crie os seguintes registros:
    1. No formulário de conexão do Graph, preencha os campos.
      Para obter uma descrição do valor do campo, consulte Formulário de conexão do Graph.
    2. No formulário de conexão REST, preencha os campos.
      Para obter uma descrição do valor do campo, consulte Formulário de conexão REST.
    3. Clique com o botão direito no cabeçalho do formulário e, em seguida, clique em Salvar.
Perfil de Entidade OAuth
  1. Navegue até a tabela OAuth Entity Profiles [oauth_entity_profile] para encontrar as seguintes entradas:
    • <Graph application registry name>.default_profile
    • <REST application registry name>.default_profile

    Dois perfis de entidade OAuth gerados pelo sistema (REST e Graph) são criados na tabela Perfis de entidade OAuth [oauth_entity_profile]. Para obter mais informações, consulte Especificar um perfil OAuth

Escopos de entidade OAuth
  1. Insira uma linha com os seguintes valores na tabela Escopos de entidade OAuth [oauth_entity_scope]:
    Tabela 1. Escopos de entidade OAuth
    Gráfico REST
    Nome: Qualquer nome à sua escolha Nome: Qualquer nome à sua escolha
    Provedor OAuth: registro da aplicação de gráfico Provedor OAuth: registro da aplicação REST
    Aplicação: global Aplicação: global
    (Para permissões delegadas) OAuthscope: offline_access https://graph.microsoft.com/Sites.ReadWrite.All

    (Para permissões da aplicação) Escopo OAuth: https://graph.microsoft.com/.default

    		Escopo do OAuth:https://<instance name> .sharepoint.com/

    Para obter mais informações, consulte Especificar um escopo do OAuth

Escopos de perfis de entidade OAuth
  1. Insira uma linha com os seguintes valores na tabela Escopos de perfis de entidade OAuth [oauth_entity_profile_scope]:
    Tabela 2. Escopos de perfis de entidade OAuth
    Gráfico REST
    Perfil de entidade OAuth: perfil de entidade de gráfico gerado na tabela Perfis de entidade OAuth [oauth_entity_profile]. Perfil de entidade OAuth: perfil de entidade REST gerado na tabela Perfis de entidade OAuth [oauth_entity_profile].
    Escopo da entidade OAuth: selecione a tabela Escopo da entidade OAuth [oauth_entity_profile_scope] criada. Escopo da entidade OAuth: selecione a tabela Escopo da entidade OAuth REST [oauth_entity_profile_scope] criada.
    Aplicação: global Aplicação: global
Credenciais
  1. Navegar até Conexões e Credenciais > Credenciaise crie as credenciais do OAuth 2.0:
    1. Nos formulários de credencial do Graph ou REST, preencha os campos.
      Tabela 3. Formulário de credencial do OAuth 2.0
      Campo Descrição
      Nome Nome à sua escolha.
      Perfil de entidade OAuth (Para Gráfico) Perfil de entidade de gráfico identificado.

      (Para REST) Perfil de entidade REST identificado.
    2. Clique com o botão direito no cabeçalho do formulário e, em seguida, clique em Salvar.
      Nota:
      Para obter mais informações sobre entidades, aliases de conexão e credencial, consulte .
Conexão
  1. Navegar até Conexões e Credenciais > Conexãoe clique em Novo para criar conexões HTTP(s) para o seguinte Graph ou REST.
    1. No formulário, preencha os campos
      Tabela 4. Formulário de conexão
      Campo Descrição
      Nome: qualquer nome à sua escolha para o Gráfico Nome: qualquer nome de sua escolha para REST
      Credenciais: selecione as credenciaisdo gráfico Credenciais: selecione as credenciaisREST
      Alias de conexão: sn_sp_spoke.MicrosoftSharePointGraph Alias de conexão: sn_sp_spoke.MicrosoftSharepointOnline
      URL de conexão: https://graph.microsoft.com/v1.0/ URL de conexão: https://<Host URL of your SharePoint instance> /
      Domínio: global Domínio: global
    2. Clique com o botão direito no cabeçalho do formulário e, em seguida, clique em Salvar.
    Para obter mais informações, consulte Conexões e credenciais e Criar uma conexão HTTP(s).
Locatários
  1. Navegue até Locatários.
    1. Clique em Novo para criar conexões de Gráfico ou REST.
    2. No formulário, preencha os campos.
      Tabela 5. Formulário de conexão de locatário
      Campo Descrição
      Nome Nome à sua escolha.
      Alias Para Graph:sn_sp_spoke.MicrosoftSharePointGraph

      Para REST:sn_sp_spoke.MicrosoftSharepointOnline
      URL raiz do SharePoint URL raiz como<SiteName> .sharepoint.com
      ID de locatário ID de locatário específico necessário para a conexão do Graph ou REST.
      Domínio Global
    3. Clique com o botão direito do mouse no cabeçalho do tópico e clique em Salvar.
    Para obter mais informações, consulte Definir locatários, Configurar a conexão de assinatura do site raiz do SharePoint Graph e o registro do alias de credenciale Criar aliases para vários locatários
Certificados
  1. Navegar até Definição do sistema > Certificados > Certificado do Microsoft SharePoint Online.
    1. Anexe o arquivo gerado pelo certificado Java Key Store no portal do Azure AD.
      Para obter mais informações, consulte .
    2. Atualize a senha do armazenamento de chaves com a senha do arquivo Java Key Store (.jks).
    3. Atualize o tipo para o armazenamento de chaves Java.
    4. Clique com o botão direito do mouse no cabeçalho do tópico e clique em Salvar.
    Para obter mais informações, consulte .
Chaves JWT
  1. Navegar até OAuth de Sistema > Chaves JWT > Chaves JWT do Microsoft SharePoint Online.
    1. Atualize a chave de assinatura com a senha do arquivo de certificado (.cer).
    2. Clique com o botão direito do mouse no cabeçalho do tópico e clique em Salvar.
  2. Navegar até OAuth de Sistema > Provedores JWT > Provedor JWT do Microsoft SharePoint Online.
    1. Atualize a declaração aud com https://login.microsoftonline.com/<Tenant-id> /oauth2/token .
    2. Atualize a declaração iss e sub com os respectivos IDs de cliente nos registros da aplicação do Azure.
    3. Clique em Salvar.
Conexão
  1. Navegar até Conexões e Credenciais > Conexão.
    1. Abra o registro de conexão REST e, na guia Atributos, especifique a Impressão digitaldo certificado codificado em Base 64.
    2. Selecione a seguinte opção de Credenciais :
      • (Para Graph): navegue até a tabela [Credentials] (oauth_2_0_credentials), abra o Graphe clique em Obter token OAuth.

        Certifique-se de fazer login na sua instância Microsoft SharePoint com as credenciais do usuário que você criou para obter o token OAuth para a conexão do Graph. Armazene as credenciais na instância.

      • (Para REST): Vá para a tabela [Credentials] (oauth_2_0_credentials), abra RESTe clique em Obter token OAuth.

        Certifique-se de fazer login na sua instância Microsoft SharePoint com as credenciais de administrador do locatário para obter o token OAuth para a conexão REST. Armazene as credenciais na instância.

        Valide a credencial para evitar falhas de configuração. Para obter mais informações sobre como validar a conexão do SharePoint, consulte Validar a conexão Microsoft SharePoint.

    3. Clique em Salvar.
Domínios confiáveis
  1. Vá para a tabela Domínios confiáveis (sn_ais_spoke_trusted_domains) e clique em Novo para criar um registro de domínio.
    1. No formulário, preencha os campos.
      Tabela 6. Formulário de registro de domínio
      Campo Descrição
      Nome Nome à sua escolha.
      Domínio <Host URL of your <a id="x1">[] locatário>.Microsoft SharePoint
    2. Clique em Salvar.
      Para obter mais informações, consulte Configurar o spoke Pesquisa com IA.
      Nota:
      Certifique-se de criar um registro de domínio confiável para cada locatário, quando houver vários locatários.
Usuário de ingestão do Sharepoint
  1. Navegar até Conexões e Credenciais > Aliases de conexão e credencial > Usuário de ingestão do Sharepoint (sn_sp_con.Sharepoint_Ingest_User).
    1. Clique em Novo em Credenciais para criar uma credencial de autenticação básica para ingerir conteúdo externo por AIS.
    2. Especifique o Nome de usuário e a Senha do usuário (sys_user) que tem a função ais_external_content.
      ingerir usuário
    3. Clique em Enviar.
      Para obter mais informações, consulte Criar aliases para vários locatários.
    4. Configure a conexão do servidor do AI Search antes de prosseguir com as próximas etapas.
Mapeador de ação de exibição de entidade (EVAM) para portal ESC e Virtual Agent
  1. Navegar até Mapeador de ação de exibição de entidade (EVAM) > Definições do EVAM.
    1. Selecione ESC Portal Search e abra o EVAM View Config Bundle M2Ms (ou) selecione Virtual Agent Search e abra o EVAM View Config Bundle M2Ms.
    2. Adicione uma fonte de dados selecionando Vincular existente.
    3. No formulário, preencha os campos.
      Tabela 7. Pesquisar formulário de criação de fonte de dados (portal ESC e Virtual Agent )
      Campo Descrição
      Ordem Menor valor da lista.
      Exibir pacote de configuração Microsoft SharePoint Pesquisar pacote.
    4. Clique em Enviar.
    Para obter mais informações sobre a definição do EVAM, consulte Create an EVAM action definition e Create a multi-data source list display in Entity View Action Mapper.
Perfil de pesquisa padrão do portal ESC
  1. Navegar até AI Search > Perfis de pesquisa e abra o Perfil de pesquisa padrão do Portal ESC.
    1. Vá para Fontes de pesquisa, clique em Vincular existentee adicione o SharePoint como fonte de pesquisa.

      Para obter mais informações, consulte Create a search profile.

    2. Navegue até Palavras irrelevantes e verifique o estado do registro.
    3. Abra o registro e clique em Publicarse o Estado não for Publicado.

      Para obter mais informações, consulte Search profiles in AI Search.

    4. Navegue até Sinônimos para verificar o estado do registro.
    5. Abra o registro e clique em Publicarse o Estado não for Publicado.

      Para obter mais informações, consulte Synonyms.

    6. Navegue até a guia Origens de pesquisa.
    7. Selecione SharePointe adicione o filtro Condição e Critérios entre as opções disponíveis.

      Com base na sua configuração, seus funcionários podem exibir o conteúdo filtrado dos resultados da pesquisa Microsoft SharePoint.

  2. Clique em Publicar no perfil de pesquisa para publicar o perfil com a nova fonte de pesquisa Microsoft SharePoint.
Perfil de pesquisa padrão do NowMobile
  1. Navegue até AI Search Perfis e abra o perfil de pesquisa padrão do NowMobile.
    1. Na guia Origens de pesquisa, clique em Vincular existente.
      • Fonte de pesquisa: SharePoint
      • Aplicação: global
    2. Vá para Parar palavras e verifique o estado do registro.
    3. Abra o registro e clique em Publicar.
    4. Vá para Sinônimos e verifique o estado do registro.
    5. Abra o registro e clique em Publicar.
Pesquisar aplicações
  1. Navegue até Pesquisar aplicações (sys_search_context_config).
    Atualize os seguintes valores para a aplicação de pesquisa padrão do Virtual Agent
    • Mecanismo de pesquisa: AI Search.
    • Perfil de pesquisa: perfil de pesquisa padrão do portal ESC. Este valor de campo dinâmico fica visível depois que você altera o valor do Mecanismo de pesquisa.
    Para obter mais informações, consulte Como criar uma configuração de aplicação de pesquisa para.
Pesquisar pós-processadores com script
  1. Navegue até a guia Pesquisar pós-processadores com script e clique em Novo para a aplicação de pesquisa padrão do portal ESC.
    1. Especifique as seguintes informações.
      • Ordem: use qualquer ordem de sua escolha, por exemplo, 100 ou 200.
      • Pesquisar processador com script: Script do conector do SharePoint.
    2. Especifique as mesmas informações para as Configurações de pesquisa do aplicativo NowMobile.
    Para obter mais informações, consulte Usando pesquisar pós-processadores com script em configurações da aplicação.
Configuração de item M2M de pesquisa global
  1. Navegue até Pesquisa global Configuração de item M2M (sys_sg_global_search_m2m_master_item) e crie as seguintes entradas: 
    Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Excel Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search File Main Item 
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search HTML Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Pages Main View
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search PDF Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search PPT Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Site Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Word Main Item
Application: SharePoint Search Connector

Resultado

Sua configuração está concluída.

O que Fazer Depois

Validar a conexão Microsoft SharePoint para descartar qualquer falha de configuração antes de indexar um site de amostra.

Validar a conexão Microsoft SharePoint

Execute uma validação depois de conectar sua instância ServiceNow com um locatário Microsoft SharePoint para verificar se há erros na configuração.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

A validação descarta qualquer falha de configuração e garante um processo de configuração contínuo.

Procedimento

  1. Navegar até IU do Sistema > Páginas de IU > Utilitário Sharepoint.
  2. Selecione Testar para navegar até a página de validação da conexão do SharePoint.
  3. Insira os detalhes necessários e selecione Validar.
    Os erros, se houver, serão exibidos na seção Resposta.
  4. Verifique os links do nome da tabela e corrija os erros com base no valor atual e no valor esperado exibidos na seção Resposta.

    Se alguma informação estiver ausente, o campo Erro mostrará os dados.

    Se não houver erros, a seção Resposta exibirá uma validação bem-sucedida.

O que Fazer Depois

Indexar sites para pesquisa. Para obter mais informações, consulte Indexar sites para pesquisa.