'<phrase_match_query>'
Обзор
Adobe Acrobat Sign позволяет выполнять сложный поиск содержимого в соглашениях пользователя. На панели поиска на странице Управление отображаются все транзакции, соответствующие строке, указанной для выбранного источника содержимого.
- При поиске в разделе «Ваши соглашения» поиск осуществляется по вашему содержимому. Если поиск осуществляется в учетной записи с общим доступом, просматривается содержимое данной учетной записи.
Содержимое представленных ниже полей индексируется при создании/обновлении транзакции.
- Название: название документа.
- Примечание: личная заметка к документу, добавленная участником, которую не видят другие участники.
- Сообщение: список сообщений, которые видит участник (включая личные и общедоступные сообщения).
- Имя исходного файла: исходное имя добавленного файла, связанного с документом.
- Адрес электронной почты: адрес электронной почты получателя (и всех, кто в копии) или отправителя.
- Полное имя: имя и фамилия получателя (и всех, кто в копии) или отправителя.
- Должность: должность получателя (и всех, кто в копии) или отправителя в компаниях, где они работают.
- Название компании: название компании или организации получателя (и всех, кто в копии) или отправителя.
- Название группы получателей: название специальной группы, работающей над соглашением, в которую входят получатели.
- Содержимое текстового поля: содержимое текстового поля в форме, которое предоставил пользователь.
- Полное имя пользователя, предоставившего общий доступ: имя и фамилия пользователя, предоставившего общий доступ к документу. Если доступ не предоставлялся, указывается полное имя пользователя.
- Название группы получателей пользователя, предоставившего общий доступ: название группы получателей, в которую входит пользователь, предоставивший общий доступ к документу. Если доступ не предоставлялся, указывается название группы получателей пользователя.
- Внешний идентификатор: идентификатор для документа, который назначил отправитель. Может быть в любом формате. Обычно в таком: <groupID>:<ID>. Внешний идентификатор передается в вызове API-интерфейсу создания документа.
- Внешний идентификатор группы: идентификатор группы для документа, который назначил отправитель. Может быть в любом формате. Обычно идентификатор группы указывается в качестве префикса к внешнему идентификатору. Внешний идентификатор группы передается в вызове API-интерфейсу создания документа. Если вы указываете внешний идентификатор группы, вы обязательно должны указать и внешний идентификатор.
Как работает поиск текста
Если вы искали строку "A simple fish":
- Acrobat Sign присваивает строкам маркеры, используя пробелы в качестве разделителей. Пример строки, разделенной на три маркера: A, simple и fish.
- Символы в строке запроса относятся к трем типам: буква, цифра и разделитель.
- Символы, распознаваемые в качестве разделителей ((исключая пробелы): ~ ` ! @ # $ % ^ & * ( ) - + = { } [ ] | \ . , : ; " ' < > ? /
- Точка, нижнее подчеркивание и апостроф остаются включенными в маркер, если символы до и после этого символа одинакового типа.
- Кавычки в начале и конце строки запроса не являются разделителями, а указывают значение строкового литерала (фразы).
- Кавычки внутри строки запроса являются разделителями и не указывают значение строкового литерала.
- Различие в регистре отсутствует. Например: a, simple и fish.
- Затем поиск пытается сопоставить полный текст каждого маркера с индексированным значением.
- Для поля Название документа происходит более сложная процедура генерации маркеров (см. ниже).
- Когда используется полный поиск, каждый документ, которому соответствует хотя бы один маркер из хотя бы одного поля с возможностью поиска, включается в возвращаемый набор данных.
- Полученный набор данных сортируется по релевантности с самым релевантным результатом поиска наверху.
Поле «Название документа»
Как отмечалось выше, поле Название документа имеет более сложную функцию генерации маркеров благодаря дополнительному «настраиваемому» генератору маркеров, который в основном генерирует маркеры на разделителях контекста (в отличие от явных символов). Этот пользовательский генератор маркеров имеет следующие отличия от стандартного:
- Генерируются маркеры префикса (до 10 символов) — маркер префикса представляет собой инкрементную строку любого стандартного маркера. Например: если стандартным маркером является fish, то инкрементными маркерами являются: f, fi, fis и fish.
- Это позволяет выполнять поиск частичных строк, начиная с первого символа маркера.
- Совпадения средней части строк не включаются в поиск. Пример: поиск слова rent не распознает слово apparently.
- Маркеры разделения в символах, не являющихся буквами или цифрами. Например: строка Super_Duper возвращает маркеры Super и Duper.
- Символы подчеркивания не являются разделителями в стандартном генераторе маркеров.
- Маркеры разделения в переходах между регистрами букв. Например: строка PowerShot возвращает маркеры Power и Shot.
- Маркеры разделения в переходах между буквами и цифрами. Например: строка XL500 возвращает маркеры XL и 500.
- Удаляет начальные или конечные разделители из каждого маркера. Например: строка XL---42+'Autocoder'возвращает маркеры XL, 42 и Autocoder.
- Удаляет символы английских притяжательных ('s) из конца каждого маркера. Например: строка Dave's возвращает маркер Dave.
Обратите внимание, что комбинация стандартных и пользовательских генераторов маркеров позволяет искать полную строку маркера (благодаря стандартному генератору маркеров) и маркеры префикса (благодаря пользовательскому генератору маркеров), но маркер префикса, который охватывает разделитель, не будет соответствовать поиску.
Пример 1: если у вас есть документ под названием My_NDA
- Стандартный генератор маркеров должен создать маркер, который выглядит следующим образом: my_nda.
- Пользовательский генератор маркеров будет создавать серии префиксов: m, my, n, nd и nda.
- Попытка поиска my_nd не принесет результатов, так как
- Стандартный генератор маркеров не создает маркеры префикса, а только полные строки
- Пользовательский генератор маркеров разделяет нижнее подчеркивание, поэтому любые маркеры префикса не будут включать его
Пример 2: если у вас есть документ под названием XL500
- Стандартный генератор маркеров выдаст следующий маркер: xl500.
- Пользовательский генератор маркеров создает серию префиксов: x, xl, 5, 50 и 500
- Попытка поиска xl5 не принесет результатов, так как
- Стандартный генератор маркеров не создает маркеры префикса, а только полные строки
- Пользовательский генератор маркеров разделяет переход между буквами и цифрами, поэтому нельзя создать маркер префикса, который будет соединять букву и цифру
Поиск по синтаксису специального запроса
Как описано в разделе выше, поиск по документу выполняет приблизительное сопоставление между всеми доступными для поиска полями документа. Содержимое поля с возможностью поиска маркируется, а затем эти маркеры сопоставляются со строкой запроса во время запроса. Поиск документа также выполняет сопоставление префикса до 10 символов для этих маркеров. Однако сопоставление значения всего поля и сопоставление фразы из значения поля могут быть достигнуты только с помощью специального синтаксиса.
ЗАПРОС СОПОСТАВЛЕНИЯ ФРАЗ
Запрос сопоставления фраз следует использовать, если требуется поиск по фразе во всех полях с возможностью поиска.
- Обычный запрос сопоставления будет совпадать, если в поле появится ЛЮБОЙ из маркеров (но не обязательно все), и порядок маркеров не будет иметь значения, так как маркеры не должны отображаться вместе.
- Сопоставление фраз дает нам возможность сопоставить, где в одном поле отображаются несколько маркеров, а эти маркеры отображаются в порядке, указанном в кавычках.
Формат синтаксиса запроса сопоставления фраз:
|
или
"<phrase_match_query>" |
Если синтаксис запроса не соответствует правилам для синтаксиса запроса сопоставления фраз, в поле поиска по документу будет выполняться обычный запрос сопоставления во всех полях с возможностью поиска.
ЗАПРОС ПРЕФИКСА ИМЕНИ ПОЛЯ
Запрос префикса имени поля следует использовать при поиске только одного конкретного поля документов пользователя. Запрос префикса имени поля должен содержать префикс имени поля, за которым следует обычное приблизительное сопоставление или запрос сопоставления фраз.
Формат синтаксиса запроса префикса имени поля:
<field_name>:<query> |
или
<field_name>:"<phrase_match_query>" |
или
<field_name>:'<phrase_match_query>' |
Если <field_name> не указан, будут запрошены все поля, поддерживаемые для сопоставления фраз. В противном случае запрашивается только поле <field_name>.
Если синтаксис запроса не соответствует правилам для синтаксиса запроса префикса имени поля, поиск по документу будет использовать весь запрос в качестве поискового запроса (приблизительное сопоставление или сопоставление фраз, в зависимости от синтаксиса) и выполнять поиск по всем доступным для поиска полям.
Например, запрос сопоставления фраз:
title: "Hello World"
должен выполнять поиск только по полю, которое содержит название документа.
Ниже приведен список префиксов, поддерживаемых для запроса префикса имени поля.
Префиксы имени поля не зависят от регистра.
Для обратной совместимости у префиксов некоторых имен полей есть псевдонимы, одинаковые по функциональности с исходными префиксами имен полей. Следующие псевдонимы устарели и в дальнейшем будут удалены: * Префикс имени поля name может использоваться вместо title. ** Префикс имени поля participantEmail может использоваться вместо email. *** Префикс имени поля participantName может использоваться вместо fullName. |
Фильтрация возвращенных данных
При поиске контента может отобразиться ненормальное количество записей.
Для уточнения поиска и сокращения количества данных до приемлемого списка используются четыре фильтра, которые можно комбинировать или использовать по отдельности.
Фильтрация по дате изменения
Измененная дата – это значение отфильтровывает по самому последнему штампу даты/времени действия пользователя по изменению соглашения. Измененная дата становится заблокированным значением, как только соглашение достигнет окончательного состояния (Завершено/Отменено/Срок действия истек).
При выборе значка фильтра Дата изменения отобразятся опции. С их помощью можно сократить количество результатов, выбрав диапазон дат:
- Все даты
- Последние 24 часа
- Последние 7 дней
- Последние 30 дней
- Последние 12 месяцев
- Настраиваемый диапазон дат
Фильтрация по значениям полей
Используя строку Поиск (справа от кнопки Фильтры), можно применить фильтр к отдельным полям, в которых могут быть специфичные или уникальные данные.
Опции полей с возможностью поиска:
- Все поля. Значение по умолчанию; с помощью этой опции выполняется поиск всех вариантов полей с точным совпадением со значением в строке Поиск. Отображается самое большое количество записей.
- Название. Сокращает результаты до записей с искомой строкой, найденной в названии объекта (например, название документа).
- Примечание. Сокращает результаты до записей, содержащих искомую строку в личных примечаниях пользователя.
- Сообщение. Сокращает результаты до записей, содержащих искомую строку в поле Сообщение или Личное сообщение документа.
- Имена исходных файлов. Определяет имя файла изначально загруженного документа и отображает только совпадения.
- Адрес электронной почты. Ищет адрес электронной почты получателя.
- Обратите внимание, что этот фильтр не учитывает текстовые поля при поиске адрес электронной почты.
- Полное имя. Выполняет поиск имени, указанного получателем при добавлении подписи. Если было предоставлено только одно имя, отобразятся все результаты, совпадающие с ним.
- Обратите внимание, что значения Имя зависят от того, что указал получатель, и могут не совпадать с предыдущими подписями или именами профилей (если у получателя есть учетная запись пользователя Acrobat Sign).
- Должность. Ищет значения, указанные в полях Должность.
- Название компании. Ищет значения, указанные в полях Компания.
- Название группы получателей. Выполняет поиск по названию группы получателей, которое указал отправитель.
- Содержимое текстового поля. Ищет точное совпадение со значением в любом текстовом поле. (В том числе значения по умолчанию и отдельные слова, найденные в более объемных текстовых блоках.)
Фильтрация по группе
У учетных записей с активированной опцией Пользователи, состоящие в нескольких группах есть доступ к фильтру Группа, который показывает только документы, отправленные от группы.
Когда фильтр выбран, рядом со значком этого фильтра отображается тег. После возврата набора данных можно удалить любой фильтр, нажав на него.