'<phrase_match_query>'
Visão geral
O Adobe Acrobat Sign permite uma pesquisa complexa para localizar conteúdo nos contratos do usuário. A barra de pesquisa, localizada na página Gerenciar, retorna todas as transações que correspondem a qualquer sequência de caracteres fornecida para a fonte de conteúdo selecionada.
- Se estiver visualizando "seus contratos", a pesquisa tem por base seu conteúdo. Se estiver visualizando uma conta compartilhada, você pesquisa o conteúdo de contas compartilhadas
O conteúdo nos campos abaixo é indexado à medida que uma transação é criada/atualizada:
- Título - título do contrato.
- Observação - uma observação de contrato particular feita pelo participante que não é visível para mais ninguém.
- Mensagem - uma lista de mensagens visíveis a este participante (inclui mensagens públicas e privadas).
- Nome original do arquivo - nome original de um arquivo carregado associado ao contrato.
- Email - endereço de email do destinatário (incluindo CCs) ou do remetente.
- Nome completo - nome e sobrenome do destinatário (incluindo CCs) ou remetente.
- Cargo - cargo do destinatário (incluindo CCs) ou remetente dentro da empresa.
- Nome da empresa - nome da empresa ou organização do destinatário (incluindo CCs) ou remetente.
- Nome do grupo de destinatários - nome do grupo de contratos ad-hoc ao qual os destinatários podem pertencer.
- Conteúdo do campo de texto - conteúdo do campo de texto fornecido pelo usuário no formulário.
- Nome completo do compartilhador - nome completo do compartilhador do contrato. Em caso de não compartilhamento, esse é o nome do usuário.
- Nome do grupo de destinatários do compartilhador - nome do grupo de destinatários do compartilhador do contrato. No caso de não compartilhamento, esse é o nome do grupo de destinatários do usuário.
- ID externa - a ID atribuída ao contrato pelo remetente que pode ser de qualquer formato, mas geralmente no formato de "<groupID>:<ID>". A ID externa é transmitida na chamada para a API de criação de contrato.
- ID do grupo externo - a ID do grupo atribuído ao contrato pelo remetente que pode ser de qualquer formato, geralmente usada como um prefixo para a ID externa. A ID do grupo externo é transmitida na chamada para a API de criação de contrato. É necessário definir a ID externa se estiver definindo o parâmetro de ID do grupo externo.
Como funciona a pesquisa de texto
Se você estava procurando pela sequência de caracteres: "Um peixe simples"
- O Acrobat Sign "tokeniza" a sequência de caracteres usando espaços como delimitadores. A sequência de caracteres do exemplo acima é dividida em três tokens: Um, peixe e simples
- Os caracteres na consulta de sequência de caracteres pertencem a um dos três diferentes tipos: letra, número ou delimitador.
- Os caracteres tratados como delimitadores (exceto espaços) são: ~ ` ! @ # $ % ^ & * ( ) - + = { } [ ] | \ . , : ; " ' < > ? /
- Pontos, sublinhados e apóstrofos permanecem como parte de um token se os caracteres antes e depois desse símbolo forem do mesmo tipo.
- As aspas que delimitam toda a sequência de consulta não são delimitadores e especificam um valor de sequência de caracteres literal (frase)
- As aspas dentro de uma sequência de consulta são delimitadores e não especificam um valor de sequência literal
- A distinção entre maiúsculas e minúsculas foi eliminada. por exemplo: um, simples, e peixe
- A pesquisa tenta então corresponder cada texto completo de cada token a um valor indexado
- Ocorre uma tokenização mais complexa para o Título do contrato (veja abaixo)
- Uma pesquisa inclusiva é usada, o que significa que cada contrato que corresponde a pelo menos um token de pelo menos um campo pesquisável é incluído no conjunto de dados retornado
- O conjunto de dados retornado é classificado por pontuação de relevância, com o resultado de pesquisa mais relevante no topo.
O campo Título do contrato:
Como observado acima, o campo Título do contrato possui uma tokenização mais sofisticada devido a um tokenizador "personalizado" adicional, que tokeniza principalmente em delimitadores de contexto (em comparação a caracteres explícitos). Esse tokenizador personalizado é diferente do padrão em que:
- Tokens de prefixo (até 10 caracteres) são gerados - Um token de prefixo é a sequência de caracteres incremental de qualquer token padrão. por exemplo: se o token padrão for peixe, os tokens incrementais serão: p, pe, pei e peixe
- Isso permite procurar sequências parciais, desde que você comece com o primeiro caractere do token
- As correspondências no meio da sequência de caracteres são ignoradas. Por exemplo, pesquisar a palavra rente não corresponderá à palavra aparentemente
- Divida tokens em caracteres não alfanuméricos. Por exemplo, a sequência de caracteres: Super_Ultra gera os tokens: Super e Ultra
- Sublinhados não são delimitadores no tokenizador padrão
- Divida tokens em transições de letras maiúsculas e minúsculas. ex: a sequência de caracteres: PowerShot gera os tokens: Power e Shot
- Dividir tokens em transições de letras e números. ex: a sequência de caracteres XL500 gera os tokens: XL e 500
- Remover delimitadores iniciais ou finais de cada token. por exemplo: a sequência de caracteres: XL---42+'Autocoder' gera os tokens: XL, 42 e Autocoder
- Remove os possessivos em inglês do final de cada token. ex: a sequência de caracteres: Dave's gera o token: Dave
Observe que a combinação dos tokenizadores padrão e personalizados permite pesquisar a sequência de caracteres completa do token (graças ao tokenizador padrão) e os tokens de prefixo (graças ao tokenizador personalizado), mas você não fará a correspondência com um token de prefixo que abrange um delimitador.
Exemplo 1: se você tiver um contrato chamado My_NDA
- O tokenizador padrão produzirá um token como este: my_nda
- O tokenizador personalizado produzirá uma série de tokens de prefixo: m, my, n, nd e nda
- A tentativa de procurar my_nd não retornaria resultados porque
- O tokenizador padrão não cria tokens de prefixo, apenas sequências de caracteres completas
- O tokenizador personalizado delimita o sublinhado, portanto, os tokens de prefixo não o incluiriam
Exemplo 2: se você tiver um contrato chamado XL500
- O tokenizador padrão produzirá um token como este: xl500
- O tokenizador personalizado produzirá uma série de tokens de prefixo: x, xl, 5, 50 e 500
- A tentativa de procurar xl5 não retornaria resultados porque
- O tokenizador padrão não cria tokens de prefixo, apenas sequências de caracteres completas
- O tokenizador personalizado delimita a transição de letras e números, portanto, não é possível criar um token de prefixo que estabeleça pontes de uma letra para um número
Pesquisar com sintaxe de consulta especial
Conforme descrito na seção acima, a Pesquisa de contrato executa uma correspondência aproximada entre todos os campos pesquisáveis de um contrato. O conteúdo do campo pesquisável é convertido em tokens e, em seguida, esses tokens são comparados à sequência de consulta no momento da consulta. A Pesquisa de contrato também executa uma correspondência de prefixo de até 10 caracteres para esses tokens. No entanto, as correspondências de um valor de campo inteiro e as correspondências de uma frase de um valor de campo podem ser alcançadas somente com uma sintaxe especial.
CONSULTA DE CORRESPONDÊNCIA DE FRASE:
Uma consulta de correspondência de frase deve ser usada quando é necessária uma pesquisa de frase entre todos os campos pesquisáveis.
- Uma consulta de correspondência aproximada regular será correspondida se QUALQUER um dos tokens aparecer em um campo (mas não necessariamente em todos). A ordem de tokens é irrelevante, pois os tokens não precisam ser exibidos juntos
- Uma correspondência de frase oferece a capacidade de fazer a correspondência quando vários tokens aparecem no mesmo campo, e esses tokens aparecem na ordem especificada entre aspas
Formato de sintaxe de consulta de correspondência de frases:
|
ou
"<phrase_match_query>" |
Se a sintaxe de consulta não seguir as regras para uma sintaxe de consulta de correspondência de frase, a Pesquisa de contrato executará uma consulta de correspondência aproximada regular entre todos os campos pesquisáveis.
CONSULTA DE PREFIXO DE NOME DE CAMPO:
Uma consulta de prefixo de nome de campo deve ser usada ao procurar apenas um campo específico de contratos do usuário. A consulta de prefixo de nome de campo deve conter um prefixo de nome de campo seguido por uma correspondência aproximada regular ou uma consulta de correspondência de frase.
Formato da sintaxe de consulta do prefixo do nome do campo:
<field_name>:<query> |
ou
<field_name>:"<phrase_match_query>" |
ou
<field_name>:'<phrase_match_query>' |
Se <field_name> não for especificado, todos os campos compatíveis com a correspondência de frase serão consultados. Caso contrário, somente o campo <field_name> será consultado.
Se a sintaxe de consulta não seguir as regras da sintaxe de consulta do prefixo de nome de campo, a Pesquisa de contrato usará toda a consulta como uma consulta de pesquisa (correspondência aproximada ou correspondência de frase, dependendo da sintaxe) e executará uma pesquisa entre todos os campos pesquisáveis.
Por exemplo, consulta de correspondência de frase:
título: "Hello World"
deve realizar uma pesquisa somente no campo que contém o título do contrato.
Abaixo há uma lista de prefixos compatíveis para a consulta de prefixo de nome de campo.
Os prefixos de nome de campo não diferenciam maiúsculas de minúsculas.
Para compatibilidade com versões anteriores, alguns dos prefixos de nome de campo têm aliases que são equivalentes em funcionalidade aos prefixos de nome de campo originais. Esses aliases estão obsoletos e serão eventualmente removidos: * O prefixo de nome de campo “name” pode ser usado em vez de “title”. ** O prefixo de nome de campo “participantEmail” pode ser usado em vez de “email”. *** O prefixo de nome de campo “participantName” pode ser usado em vez de “fullName”. |
Filtrar os dados retornados
A sua pesquisa de conteúdo pode retornar um número imenso de registros.
Quatro filtros, que podem ser usados individualmente ou em conjunto, estão disponíveis para ajudar a reduzir o conjunto de dados a uma lista gerenciável de registros.
Filtro por Data de modificação
O valor Data de modificação filtra o carimbo de data/hora mais recente quando uma ação do usuário atualiza o contrato. A Data de modificação se torna um valor bloqueado quando o contrato atinge um status terminal (Concluído/Cancelado/Expirado).
O ícone do filtro por Data de modificação abre as opções para reduzir ainda mais o conjunto de dados selecionando um intervalo de datas:
- Todas as datas
- Últimas 24 horas
- Últimos sete dias
- Últimos 30 dias
- Últimos 12 meses
- Intervalo de datas personalizado
Filtro por Valores de campo
Usando a caixa de inserção Pesquisar (à direita do botão Filtros), é possível aplicar um filtro em campos individuais que podem conter dados altamente específicos ou únicos.
As opções de campo pesquisáveis são:
- Todos os campos - O valor padrão; isso pesquisa todas as opções de campo pela sequência de caracteres exata no campo Pesquisar, retornando o maior conjunto de registros.
- Título - Limita o conjunto de dados retornado a registros em que a sequência pesquisada é encontrada no título do objeto (por exemplo, nome do contrato).
- Nota - Limita o conjunto de dados a registros que contêm a sequência pesquisada nas notas pessoais do usuário que realiza a pesquisa.
- Mensagem - Limita o conjunto de dados a registros que contêm a sequência pesquisada nos campos Mensagem ou Mensagem privada do contrato.
- Nomes de arquivos originais - Avalia o nome do arquivo do documento original carregado e retorna apenas os registros correspondentes.
- Email - Encontra registros correspondentes ao endereço de email de um destinatário.
- Observe que esse filtro não cobre campos de Texto definidos com uma validação de Endereço de email.
- Nome completo - Encontra registros correspondentes ao valor de Nome fornecido por um destinatário ao aplicar uma assinatura. Se apenas um nome for fornecido, todos os registros que correspondem a esse valor serão retornados.
- Observe que os valores de Nome dependem do que o recipient digita e podem não corresponder aos valores de assinatura ou nomes de perfil anteriores (se o destinatário tiver uma conta de usuário do Acrobat Sign).
- Cargo - Encontra registros correspondentes aos valores colocados no campo Título.
- Nome da empresa - Encontra registros correspondentes aos valores colocados no campo Empresa.
- Nome do grupo de destinatários - Encontra registros correspondentes ao nome do Grupo de destinatários (inserido pelo remetente).
- Conteúdo do campo de texto - Encontra registros correspondentes ao valor exato de qualquer campo de inserção de Texto. Isso inclui valores padrão e palavras individuais encontradas em blocos de texto maiores.
Filtro por Grupo
As contas com a opção Usuários em Vários Grupos habilitada têm acesso a um filtro de Grupo que limita o conjunto de dados retornado a apenas contratos enviados desse grupo.
Quando um filtro é selecionado, uma tag será exibida ao lado do ícone de filtro. É possível clicar em qualquer filtro para removê-lo depois que o conjunto de dados é retornado.