Compartilhar via


Pesquisa M365 (preterida) [PRETERIDA]

O M365 Search fornece recursos de pesquisa empresarial inteligentes e avançados em várias entidades no M365. Pesquise arquivos pelo SharePoint e OneDrive Business, Pessoas pelo Exchange, Mensagens pelo Teams e conteúdo do Exchange e gráfico externo. Pesquise perfeitamente todas as entidades M365 por meio de um conector.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Pesquisa da Microsoft
URL https://www.microsoft.com/microsoft-search
Email 3SApiDevs@service.microsoft.com
Metadados do conector
Publicador Microsoft
Site https://www.microsoft.com/microsoft-search
Política de privacidade https://learn.microsoft.com/en-us/microsoftsearch/security-for-search
Categorias Conteúdo e arquivos; Business Intelligence

Conector de Pesquisa do M365 (versão prévia)

O conector de Pesquisa do M365 (atualmente em versão prévia) fornece recursos de pesquisa empresarial inteligentes e avançados em quase todas as entidades no M365, incluindo Pessoas, Arquivos e Mensagens. Esse conector traz o poder da Pesquisa da Microsoft para o Power Automate e aplicativos, tornando-o contínuo para criar experiências orientadas por pesquisa que atendam às necessidades da sua organização. Agora, você pode criar aplicativos e fluxos de trabalho personalizados prontos para a empresa em apenas alguns minutos.

Pré-requisitos

O locatário requer uma licença M365 para poder acessar cargas de trabalho como Exchange, SharePoint, Teams.

Como obter credenciais

A autenticação e a autorização foram internas, portanto, qualquer usuário já conectado ao M365 poderá usá-lo sem etapas adicionais relacionadas à autenticação.

Introdução ao Power Automate

A ação em um fluxo permite escolher o tipo de entidade e as fontes de conteúdo, quais campos recuperar, filtrar opções para campos e número de resultados.

Ações

Há quatro entidades para pesquisar e cada uma está em uma Ação. Cada ação é atendida por diferentes fontes de conteúdo:

  • Search Files: pesquise por meio do SharePoint e do OneDrive Business Files no M365.
  • Search Messages: pesquise mensagens do Teams e do Exchange no M365.
  • Search People: pesquise por meio de pessoas do Exchange no M365.
  • Search External: pesquise por meio do conteúdo do Conector do Graph Externo.

Entradas

  • Search Input: texto de consulta ou frase de pesquisa
  • Number of Results: quantos resultados aparecem ao mesmo tempo. Isso pode ser útil para paginação. O resultado usa como padrão 10, mas pode ser editado.
  • Start From Result #: o número do qual a entidade iniciará a pesquisa. Por exemplo, o Resultado nº 5 ignorará os primeiros 4 resultados.

Campos e detalhes de saída

Cada Ação (ou Tipo de Entidade) tem cinco campos padrão que são exibidos. Esses campos padrão podem ser editados e novos campos podem ser adicionados.

  • Files: Description, DocId, Filename, Path, Title. Campos adicionais incluem Rank, SiteId, Author etc.
  • Messages: ConversationTopic, Preview, DateTimeLastModified, DisplayTo, Subject. Campos adicionais incluem HasAttachments, Importance etc.
  • People: Id, DisplayName, EmailAddresses, Department, CompanyName. Campos adicionais incluem OfficeLocation, JobTitle etc.
  • External: URL, Descrição, DocumentId, ID, Título. Campos adicionais incluem HitHighlightedProperties.

Filtrar campos, operadores e valores

Cada Ação (ou Tipo de Entidade) tem uma opção de filtragem. Cada tipo de entidade pode ser filtrado por campos de saída específicos. Há três partes de um Filtro: FieldOperator e Value. Fields são campos de saída para cada tipo de entidade, por exemplo, Nome de arquivo. Operators são maneiras de filtrar por exemplo= iguais. Values são o que os resultados devem ser definidos para baixo, por exemplo, Documento de Planejamento

Por exemplo, para definir o escopo de Arquivos até um site do SharePoint, na ação Arquivos de Pesquisa, selecione Campo Filtros = Caminho, Operador de Filtros = contém, Valor dos Filtros = https://microsoft.sharepoint.com/sites/FabCon.

Casos de uso

Caso de uso 1 (no Power Automate e no aplicativo):

Uma empresa tem um Power App de conformidade financeira e tem documentos de conformidade distribuídos em 5 bibliotecas. Eles só querem que os usuários finais pesquisem por essas 5 bibliotecas. Com o conector de Pesquisa, eles são capazes de filtrar e especificar um único ou vários sites do SharePoint pelos quais um usuário final pode pesquisar.

Como começar: abra o Conector M365 e pesquise o Tipo de Entidade de Arquivos e especifique uma ou várias URLs do SharePoint para aterrar a pesquisa (Filtragem).

Caso de uso 2 (no Power Automate e no aplicativo):

Uma empresa de automóveis tem dados do produto, incluindo imagens de produtos e revisões armazenadas no ABC, um produto externo. Eles não o armazenam internamente, mas têm uma API e um Conector do Graph para ABC. Os dados externos podem ser usados em um Power App para um usuário final pesquisar um produto e fazer com que as imagens e revisões sejam exibidas.

Como começar: abra o Conector de Pesquisa da Microsoft e pesquise o Tipo de Entidade Externa e especifique o conector externo para aterrar a pesquisa.

Perguntas frequentes comuns

O locatário de pesquisa é amplo?

Yes

Relevância refere-se ao processo de classificação e classificação de resultados da pesquisa com base na importância e na utilidade da consulta do usuário. Ele é determinado por uma combinação de fatores, como o conteúdo dos resultados e a pesquisa.

Como funciona a segurança e a privacidade?

A segurança depende do usuário final que está executando o fluxo ou aplicativo, não do usuário que cria o fluxo ou aplicativo. Os resultados recuperados de fontes de conteúdo, como o SharePoint e o OneDrive for Business, são cortados de segurança na origem. Os usuários finais não podem ver recursos como documentos do Word que não podem ver e acessar por meio do Office 365. Eles só podem ver seus próprios arquivos que foram compartilhados com eles no SharePoint. Ele segue os mesmos princípios de segurança e privacidade que na Pesquisa da Microsoft. Leia mais aqui: Visão geral da Pesquisa da Microsoft | Microsoft Learn

Quais são os exemplos de conectores para dados externos?

Exibir conectores do Graph aqui: Conectores do Graph

Como você pesquisa uma frase específica? / Você pode usar funções de exclusão?

Use funções KQL na caixa de Entrada de Pesquisa. Saiba mais aqui: Referência de sintaxe KQL (Linguagem de Consulta de Palavra-chave) | Microsoft Learn

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Arquivos de pesquisa [PRETERIDOS]

Pesquisa da Microsoft – Arquivos de Pesquisa (preterido)

Mensagens de pesquisa [PRETERIDAS]

Pesquisa da Microsoft – Mensagens de Pesquisa (preteridas)

Pesquisar externo [PRETERIDO]

Pesquisa ms365 - pesquisa com base em outro conector ou origem (preterido)

Pesquisar pessoas [PRETERIDA]

Pesquisa da Microsoft – Pesquisar pessoas (preterida)

Arquivos de pesquisa [PRETERIDOS]

Pesquisa da Microsoft – Arquivos de Pesquisa (preterido)

Parâmetros

Nome Chave Obrigatório Tipo Description
requestBody
requestBody dynamic

Retornos

As saídas desta operação são dinâmicas.

Mensagens de pesquisa [PRETERIDAS]

Pesquisa da Microsoft – Mensagens de Pesquisa (preteridas)

Parâmetros

Nome Chave Obrigatório Tipo Description
requestBody
requestBody dynamic

Retornos

As saídas desta operação são dinâmicas.

Pesquisar externo [PRETERIDO]

Pesquisa ms365 - pesquisa com base em outro conector ou origem (preterido)

Parâmetros

Nome Chave Obrigatório Tipo Description
requestBody
requestBody dynamic

Retornos

As saídas desta operação são dinâmicas.

Pesquisar pessoas [PRETERIDA]

Pesquisa da Microsoft – Pesquisar pessoas (preterida)

Parâmetros

Nome Chave Obrigatório Tipo Description
requestBody
requestBody dynamic

Retornos

As saídas desta operação são dinâmicas.