Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Enhance Duplicates #370

Open
wants to merge 1 commit into
base: 371-publish-b24-php-sdk-beta-2
Choose a base branch
from

Conversation

badigit
Copy link

@badigit badigit commented Mar 8, 2024

  • add Methods for check company/lead
  • add Methods for results for company/lead
  • add Method hasMatches - Checks if there are any matches for a given entity type.
  • add Method hasAnyMatches - Checks if there are any matches across all entity types (if search for all types)
  • changed findByPhone\findByEmail - requies EntityType or null
  • add Method getMatchId - return match by sort
  • add Method getMatchIdByPriority - return first match by EntityType priority and sort
  • integration tests
  • Docs
  1. При использовании методов findByPhone\findByEmail - нужно обязательно передавать EntityType или null если мы явно планируем искать по всем видам сущностей.
    В прошлой версии не требовало явно указывать. имхо так правильнее - чтобы явно было понятно какой результат будет в итоге.

  2. Оставил существующие методы "под контакты" для обратной совместимости
    hasDuplicateContacts
    hasOneContact
    getContactsId

Но в принципе со всеми сущностями можно работать через
hasDuplicates
hasOne
getEntityIds

Для единообразия - можно конечно для каждой сущности по 3 метода дописать.. но не знаю нужно ли

  1. Общий смысл доработок:
  • Поддержка всех видов сущностей
  • Поддержка расширенной работы с результатами. Несмотря что методы вроде как предназначены для поисков дубликатов, по факту это единственные методы которые позволяют легко найти любую сущность по контакту-емейлу, не оглядываясь на формат записи номера в Б24. Как следствие метод используются в скриптах обработки лидов, когда нужна проверка "А есть ли у нас уже сущность с такими контактами"
    Как следствие - нужны способы проверить есть ли сущность, быстро получить ID сущности, а также задать приоритетность поиска. В разных сценариях бывает нужна первая\последняя сущность.

Например стандартная логика для телефонии - поиск по приоритету лид-контакт-компания с возвратом последнего найденного совпадения. В текущем классе это возможно через getMatchIdByPriority с сортировкой desc

- add Methods for check company/lead
- add Methods for get Ids company/lead
- add Method hasMatches - Checks if there are any matches for a given entity type.
- add Method hasAnyMatches - Checks if there are any matches across all entity types.
- changed findByPhone\findByEmail - requies EntityType or null
- add Method getMatchId - return match by sort
- add Method getMatchIdByPriority - return first match by EntityType priority and sort
- integration tests
- Docs
@badigit
Copy link
Author

badigit commented Mar 8, 2024

По тестам.

  1. Закомментированы тесты для компаний, до появления сервиса по компаниям. Не стал городить через core
  2. Не вкурил как сделать чтобы phpunit в vscode отображал результат теста по каждому кейсу из дата-провайдера в виде отдельной строки теста. Может это только в vscode так, а может я чет не понял)

@mesilov mesilov linked an issue Mar 13, 2024 that may be closed by this pull request
@mesilov mesilov changed the base branch from 306-beta-1 to 371-publish-b24-php-sdk-beta-2 March 13, 2024 19:48
@mesilov mesilov self-assigned this Mar 13, 2024
@mesilov mesilov added 2.x issue related with 2.x sdk version improve DX developer experience labels Mar 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
2.x issue related with 2.x sdk version improve DX developer experience
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Enhance Duplicates
2 participants