Субъект и глобальная адресная книга

  • Статья

Субъект и глобальная адресная книга являются понятиями в приложениях для финансов и операций. Субъект может быть организацией или человеком. Удобно глобально хранить свойства субъекта, такие как имя, язык, контакты и адреса, и управлять ими. Затем когда значение свойства изменяется в одном месте, это изменение отражается во всех местах, где участвует этот субъект.

Субъект

Субъект — это лицо или организация, вовлеченные в бизнес. Используя концепцию субъекта, сотрудник или организация могут играть в бизнесе более одной роли (работника, клиента, поставщика или контакта). Роль основана на контексте и назначении. Ниже приведены примеры ролей двух вымышленных компаний, Contoso и Fabrikam:

  • Работник — сотрудник. Примером является сотрудник Contoso.
  • Поставщик — организация поставщика или отдельное уполномоченное лицо, поставляющее товары или услуги для бизнеса. Например, если Fabrikam продает поставки в Contoso, Fabrikam является поставщиком для Contoso.
  • Контакт — контактное лицо для связи. Например, если компания Contoso приобретает товары у компании Fabrikam, сотрудники компании Contoso будут связываться с контактным лицом в компании Fabrikam.
  • Клиент : — это лицо или компания, которые покупают товары у компании. Например, если компания Contoso покупает товары у компании Fabrikam, компания Contoso является клиентом компании Fabrikam.

Модель субъекта часто используется для представления средних и сложных отношений между организациями и физическими лицами, в частности, когда субъект играет несколько ролей. Далее приводятся некоторые распространенные примеры:

  • Субъект может быть и клиентом, и поставщиком. Например, в Северной Америке компания Fabrikam продает электрические провода компании Contoso и покупает собранные динамики у компании Contoso. В Европе компания Fabrikam продает детали компании Contoso, но ничего не покупает в компании Contoso.
  • Субъект может быть и сотрудником, и клиентом. Например, сотрудник компании Contoso покупает электронику у компании Contoso для личного использования.
  • Между физическим лицом и организацией может быть отношение "многие ко многим" (N:N). Например, Fabrikam предоставляет специалистов по обслуживанию и нанимает координатора размещения. Координатор размещения назначает специалистам по обслуживанию запросы на работу от нескольких клиентов Fabrikam. Contoso является одним из клиентов компании Fabrikam. Когда компании Contoso необходим специалист по обслуживанию, она обращается к координатору размещения, который затем выполняет этот запрос. Поскольку координатор размещения обрабатывает запросы для всех клиентов, используется отношение N:N.

На следующем рисунке показана модель данных для субъекта.

Модель данных для субъекта.

Совет

При попытке создать новую запись организации используйте поле Субъект для поиска записи по имени. Таким образом, если обнаруживается запись, достаточно просто выбрать ее. Система автоматически заполняет все данные из субъекта. Не требуется вручную вводить все необходимые поля. Такое поведение можно найти на готовых страницах Организация, Контакт и Поставщик.

Не все роли субъектов приложений для финансов и операций поддерживаются функцией двойной записи. Полный список ролей субъектов см. в разделе Обзор глобальной адресной книги.

Глобальная адресная книга

Глобальная адресная книга — это каталог почтовых и электронных адресов организаций и физических лиц, участвующих в бизнесе.

В глобальной адресной книге хранятся и обрабатываются как угодно много почтовых адресов и электронных адресов. Например, у Fabrikam есть автозаправочные станции в 50 местоположениях. У каждого местоположения есть свой почтовый адрес, адрес электронной почты и номер телефона. Все деловые покупки выставляются на главную автозаправочную станцию, но направляются непосредственно на отдельную автозаправочную станцию, запросившую покупку. Глобальная адресная книга хранит основную автозаправочную станцию в качестве адреса выставления счетов для Fabrikam и хранит каждую автозаправочную станцию как адрес отгрузки. Адреса можно сохранить один раз и извлекать, когда это необходимо для предложений и заказов.

В зависимости от бизнес-контекста лицо или организация могут играть более одной роли, и один и тот же почтовый адрес и адрес электронной почты может использоваться для всех ролей. В этом случае изменение адреса в одной роли должно появиться во всех других ролях. Глобальная адресная книга хранит адреса и обрабатывает их глобально.

На следующем рисунке показана модель данных для глобальной адресной книги.

Модель данных для глобальной адресной книги.

Контакты

В приложениях для взаимодействия с клиентами контакт является физическим лицом. Однако таблица Контакт может быть перегружена, чтобы представлять физическое лицо, пользователя портала, клиента B2C или поставщика. Представление является неявным, и вы не можете определить разницу без изучения соответствующих проводок. Таблица Контакт имеет ограничение, которое ограничивает ее только отношением "один-к-одному" (1:1) с таблицей Организация. В качестве части модели субъекта и глобальной адресной книги двойная запись привносит явные свойства для классификации и допускает отношения N:N между физическим лицом "Контакт" и организацией (сущность Организация или Поставщик).

Существует два типа строк Контакт:

  • Чередующийся контакт — строка Контакт с обязательным значением в поле Компания.
  • Нечередующийся контакт — строка Контакт с пустым полем Компания.

В таблице Контакт могут храниться следующие типы строк.

Тип строки описание
Физическое лицо, которое является клиентом (например, контактным лицом для продажи или клиентом B2C) Запись о чередующемся контакте, в которой поле Компания не пусто, а поле Клиент имеет значение Да.
Физическое лицо, которое является поставщиком (например, единственный владелец как поставщик) Запись о чередующемся контакте, в которой поле Компания не пусто, а поле Поставщик имеет значение Да.
Физическое лицо, которое одновременно и клиент, и поставщик Запись о чередующемся контакте, в которой поле Компания не пусто, поле Клиент имеет значение Да и поле Поставщик имеет значение Да. Физическое лицо может быть как производителем для одного продукта, так и потребителем для другого продукта. Как приложения для финансов и операций, так и двойная запись поддерживают такое отношение.
Физическое лицо, которое является контактным лицом для организации, но не является клиентом или поставщиком Запись о нечередующемся контакте, в которой поле Компания пусто, поле Клиент имеет значение Нет и поле Поставщик имеет значение Нет.

Контакт для таблицы субъекта

Таблица Контакт для субъекта хранит и обрабатывает связи N:N между строками Организация и строками Контакт. В нем можно отфильтровать чередующиеся строки Контакт от нечередующихся строк и связать только нечередующиеся строки Контакт со строками Организация или Поставщик.

Например, Наташа Джонс и Мигель Рэйес являются ветеринарами, которые заботятся о фермах в своих областях. Наташа обслуживает область Сиэтла, а Мигель обслуживает область Кента. В приложении для взаимодействия с клиентами фермы представлены как клиенты, а ветеринары — как контактные лица. Одна запись Контакт для Наташи связана со всеми фермами, с которыми Наташа работает. Аналогично, одна запись Контакт для Мигеля связана со всеми фермами, с которыми Мигель работает.

Эти отношения хранятся в таблице Контакт для субъекта. Такую информацию можно найти на готовых страницах Организация, Контакт и Поставщик:

  • На странице Организация можно использовать вкладку Связанные контакты, чтобы связать один или несколько контактов со строкой Организация. Таким образом, вы назначаете контактные лица для организации. Затем можно выбрать один контакт в качестве основного контактного лица для организации. При использовании страницы Быстрое создание можно выбрать только контактное лицо. Поведение аналогично, когда вы используете страницу Поставщик, а типом записи является Организация.

  • На странице Контакт, когда строка является клиентом, поставщиком или и тем, и другим (чередующийся контакт), можно использовать вкладку Связанные контакты, чтобы связать один или несколько контактов. Таким образом, вы назначаете контактных лиц для клиента или поставщика B2C. Затем можно выбрать один контакт в качестве основного контакта. При использовании страницы Быстрое создание можно выбрать только контактное лицо.

  • На странице Контакт, когда строка является контактным лицом (нечередующийся контакт), можно использовать вкладку Связанные организации, чтобы связать одного или нескольких клиентов или поставщиков. Таким образом, вы назначаете клиентов или поставщиков базовому контактному лицу. Клиентом или поставщиком может быть организация, физическое лицо или оба. В каждый момент времени можно выбрать только одно значение из четырех полей:

    • Если выбрано значение в поле Код субъекта, соответствующий контакт назначается всем ролям выбранного субъекта.
    • При выборе значения в поле Связанный контакт выбирается чередующийся контакт типа Физическое лицо.
    • При выборе значения в поле Связанная организация или Связанный поставщик будет выбрана организация.

    Вкладка

    Независимо от вашего выбора, связь создается на уровне субъекта, она применяется ко всем ролям субъекта и хранится в сущности Контакт для субъекта.

Примечание

Отображаемое имя для таблицы Контакт для субъекта в приложениях для взаимодействия с клиентами — Контакт для клиента/поставщика.

При открытии строки Контакт, в которой оба поля Клиент и Поставщик заданы как Нет, отображается вкладка Связанные организации. Эта вкладка используется для связи одной или нескольких организаций клиентов или поставщиков с контактом.

При открытии строки Контакт, в которой поле Клиент или Поставщик задано как Да, отображается вкладка Связанные контакты. Эта вкладка используется для связывания одного или нескольких контактов.

Почтовые адреса

На страницах Организация, Контакт и Поставщик представлена новая вкладка Адреса. Эта вкладка поддерживает несколько почтовых адресов, используя сетку, как показано на следующем рисунке.

Сетка для почтовых адресов.

Сетка содержит следующие столбцы:

  • Роли почтового адреса — назначение почтового адреса.
  • Является основным — значение, указывающее, является ли адрес основным адресом.
  • Номер адреса — порядок адресов.

Можно использовать кнопку Создать адрес над сеткой для создания желаемого количества почтовых адресов.

В приложениях для взаимодействия с клиентами, когда пользователь вводит адреса на вкладке Сводка страницы Счета, поля Адрес 1 и Адрес 2 соответствуют адресам Доставка и Накладная соответственно. Однако когда пользователь создает почтовый адрес в приложениях для управления финансами и операциями, первые два адреса записи клиента будут отображаться в полях Address1 и Address2, и пользователь сможет изменить назначение адреса для Доставки и Накладной.

Вкладка

Аналогичным образом, поля Адрес 1, Адрес 2 и Адрес 3 на вкладке Сводка страницы Контакт соответствуют адресам Работа, Доставка и Накладная, соответственно.

Адреса электронной почты

На страницах Организация, Контакт и Поставщик представлена новая вкладка Электронные адреса. Эта вкладка поддерживает несколько электронных адресов, используя сетку, как показано на следующем рисунке.

Сетка для электронных адресов.

Сетка содержит следующие столбцы:

  • Тип — тип электронного адреса.
  • Является основным — значение, указывающее, является ли адрес основным адресом.
  • Назначение — назначение электронного адреса.

Можно использовать кнопку Создать электронный адрес над сеткой для создания желаемого количества адресов.

В процессе квалификации интереса можно указать номер рабочего телефона и номер мобильного телефона. Номер рабочего телефона считается основным, если IsMobile=No, а номер мобильного телефона считается вторичным, если IsMobile=Yes.

Совет

Используйте вкладки Адреса и Электронные адреса в формах Организация и Контакт для управления почтовым адресом и адресом электронной почты. Это гарантирует, что данные адреса будут синхронизированы с приложениями для финансов и операций.

Настройка

  1. Откройте среду приложений для взаимодействия с клиентами.

  2. Установите все необходимые решения, как описано в разделе Разделенный пакет оркестрации приложений с двойной записью.

  3. Установка решений субъекта и глобальной адресной книги с двойной записью.

  4. Откройте приложение Finance and Operations. Перейдите в модуль управления данными и выберите вкладку двойной записи. Открывается страница администрирования двойной записи.

  5. Примените оба решения, установленные в шагах 2 и 3, используя функцию Применить решение.

  6. Остановите следующие сопоставления, так как они больше не требуются. Вместо этого следует выполнить сопоставление Contacts V2 (msdyn_contactforparties).

    • Контакты CDS V2 и контакты (относится к контактам клиента)
    • Контакты CDS V2 и контакты (относится к контактам поставщика)

  7. Следующие сопоставления сущностей обновляются для функциональных возможностей субъектов, поэтому для этих сопоставлений должен применяться последняя версия.

    Карта Обновите до этой версии Изменения
    CDS Parties (msdyn_parties) 1.0.0.2 Это новое сопоставление, добавленное в рамках этого выпуска.
    Contacts V2 (msdyn_contactforparties) 1.0.0.6 Это новое сопоставление, добавленное в рамках этого выпуска.
    Customers V3 (accounts) 1.0.0.5 Удалены PartyNumber и другие поля, имеющие отношение к субъектам, такие как имя, личные сведения, поля почтового адреса, поля электронного адреса контакта.
    Customer V3 (contacts) 1.0.0.5 Удалены PartyNumber и другие поля, имеющие отношение к субъектам, такие как имя, личные сведения, поля почтового адреса, поля электронного адреса контакта.
    Vendors V2 (msdyn_vendors) 1.0.0.6 Удалены PartyNumber и другие поля, имеющие отношение к субъектам, такие как имя, личные сведения, поля почтового адреса, поля электронного адреса контакта.
    CDS Sales quotation headers (quotes) 1.0.0.7 Контактное лицо заменено ссылкой ContactforParty.
    Sales invoice headers V2 (invoices) 1.0.0.4 Контактное лицо заменено ссылкой ContactforParty.
    CDS Sales order headers (salesorders) 1.0.0.5 Контактное лицо заменено ссылкой ContactforParty.
    CDS Party postal address locations (msdyn_partypostaladdresses) 1.0.0.1 Это новое сопоставление, добавленное в рамках этого выпуска.
    CDS postal address history V2 (msdyn_postaladdresses) 1.0.0.2 Это новое сопоставление, добавленное в рамках этого выпуска.
    CDS postal address locations (msdyn_postaladdresscollections) 1.0.0.0 Это новое сопоставление, добавленное в рамках этого выпуска.
    Party Contacts V3 (msdyn_partyelectronicaddresses) 1.0.0.0 Это новое сопоставление, добавленное в рамках этого выпуска.
    Complimentary Closings (msdyn_compliemntaryclosings) 1.0.0.0 Это новое сопоставление, добавленное в рамках этого выпуска.
    Decision making roles (msdyn_decisionmakingroles) 1.0.0.0 Это новое сопоставление, добавленное в рамках этого выпуска.
    Loyalty levels (msdyn_loyaltylevels) 1.0.0.0 Это новое сопоставление, добавленное в рамках этого выпуска.
    Contact person titles (msdyn_salescontactpersontitles) 1.0.0.0 Это новое сопоставление, добавленное в рамках этого выпуска.
    Personal character types (msdyn_personalcharactertypes) 1.0.0.0 Это новое сопоставление, добавленное в рамках этого выпуска.
    Salutations (msdyn_salutations) 1.0.0.0 Это новое сопоставление, добавленное в рамках этого выпуска.
    Employment job functions (msdyn_employmentjobfunctions) 1.0.0.0 Это новое сопоставление, добавленное в рамках этого выпуска.
    CDS Address roles (msdyn_addressroles) 1.0.0.0 Это новое сопоставление, добавленное в рамках этого выпуска.

  8. Перед выполнением вышеперечисленных сопоставлений необходимо обновить ключи интеграции вручную, как описано в следующих шагах. Затем выберите Сохранить.

    Соответствие Ключи
    Счет accountnumber [номер счета]
    msdyn_company.cdm_companycode msdyn_company [компания (код компании)]
    Контактное лицо msdyn_contactpersonid [номер счета/код контактного лица]
    msdyn_company.cdm_companycode msdyn_company [компания (код компании)]
    Контакт для клиента или поставщика msdyn_contactforpartynumber [контакт для номера субъекта]
    msdyn_associatedcompanyid.cdm_companycode [связанная компания (код компании)]
    Поставщик msdyn_vendoraccountnumber [номер счета поставщика]
    msdyn_company.cdm_companycode msdyn_company [компания (код компании)]

  9. В Dataverse ограничения символов правил обнаружения повторений увеличены с 450 до 700 символов. Это ограничение позволяет добавить один или несколько ключей к правилам обнаружения повторений. Разверните правило обнаружения повторений для таблицы Организации, задав следующие поля.

    Поле значение
    ФИО Организации с одинаковым именем организации.
    описание Обнаружение записей организаций с одинаковым значением атрибута "Имя организации".
    Тип базовой записи Счет
    Тип совпадающей записи Счет
    Имя организации (поле) Точное совпадение
    Компания (поле) Точное совпадение
    Тип отношений (поле) Точное совпадение
    Код субъекта (поле) Точное совпадение
    Выбрать (поле) (пусто)

    Правило повторений для организаций.

  10. Разверните правило обнаружения повторений для таблицы Контакты, задав следующие поля.

    Поле значение
    ФИО Контакты с одинаковым именем и фамилией.
    описание Обнаружение записей контактов с одинаковыми значениями в полях "Имя" и "Фамилия".
    Тип базовой записи Контактное лицо
    Тип совпадающей записи Контактное лицо
    Имя (поле) Точное совпадение
    Фамилия (поле) Точное совпадение
    Компания (поле) Точное совпадение
    Код субъекта (поле) Точное совпадение
    Выбрать (поле) (пусто)

    Правило повторений для контактов.

  11. Если вы являетесь существующим пользователем с двойной записью, выполните инструкции в Обновление модели субъекта и глобальной адресной книги, а затем обновите свои данные. Не переходите к шагу 12, пока не выполните этот шаг. Если вы являетесь новым пользователем двойной записи, перейдите к шагу 12.

  12. Если вы являетесь существующим пользователем двойной записи, выполните шаг 11, затем можно выполнить сопоставления в следующем порядке: Если вы являетесь новым клиентом двойной записи, вы можете продолжить непосредственно. Если отображается сообщение об ошибке "Сбой проверки проекта. Отсутствует поле назначения…", откройте сопоставление и выберите Обновить таблицы, затем выполните сопоставление.

    Приложение для финансов и операций Приложение для взаимодействия с клиентами
    Субъекты CDS msdyn_parties
    Местоположения почтовых адресов CDS msdyn_postaladdresscollections
    Журнал почтовых адресов CDS V2 msdyn_postaladdresses
    Местоположения почтовых адресов субъектов CDS msdyn_partypostaladdresses
    Контакты субъекта V3 msdyn_partyelectronicaddresses
    Клиенты V3 счета
    Клиенты V3 контакты
    Поставщики V2 msdyn_vendors
    Обращения к контактному лицу msdyn_salescontactpersontitles
    Заключения msdyn_complimentaryclosings
    Приветствия msdyn_salutations
    Роли принятия решений msdyn_decisionmakingroles
    функциональные обязанности задания msdyn_employmentjobfunctions
    Уровни лояльности msdyn_loyaltylevels
    Типы характеров людей msdyn_personalcharactertypes
    Контакты V2 msdyn_contactforparties
    Заголовок предложения по продаже CDS предложения
    Заголовки заказов на продажу CDS salesorders
    Заголовки накладной заказа на продажу V2 накладные
    Роли адреса CDS msdyn_addressroles

Примечание

Сопоставление CDS Contacts V2 (contacts) — это сопоставление, остановленное на шаге 1. При попытке выполнить другие сопоставления, эти 2 сопоставления могут отображаться в списке зависимостей. Не выполняйте эти сопоставления.

Если установлено решение с субъектами и глобальной адресной книгой, необходимо отключить подключаемый модуль с именем Microsoft.Dynamics.SCMExtended.Plugins.Plugins.LeadPrimaryContactPostCreate: QualifyLead of lead. Если удалено решение с субъектами и глобальной адресной книгой, необходимо снова включить подключаемый модуль.

Поле msdyn_*partynumber (текстовое поле из одной строки), включенное в таблицы Организация, Контакт и Поставщик, не должно использоваться при переходе вперед. Для ясности у имени метки есть префикс (Устарело). Вместо этого используется поле msdyn_partyid. Поле является подстановкой в таблице msdyn_party.

Имя таблицы Старое поле Новое поле
Счет msdyn_partynumber msdyn_partyid
Контактное лицо msdyn_partynumber msdyn_partyid
msdyn_vendor msdyn_vendorpartynumber msdyn_partyid

Шаблоны

Коллекция сопоставлений таблиц работает совместно для взаимодействия субъекта и глобальной адресной книги, как показано в следующей таблице.

Приложение для финансов и операций Приложение для взаимодействия с клиентами Наименование
Обращения к контактному лицу msdyn_salescontactpersontitles
Клиенты V3 счета
Клиенты V3 контакты
Субъекты CDS msdyn_parties
Местоположения почтовых адресов субъектов CDS msdyn_partypostaladdresses
Журнал почтовых адресов CDS V2 msdyn_postaladdresses
Местоположения почтовых адресов CDS msdyn_postaladdresscollections
Заголовок предложения по продаже CDS предложения
Заголовки заказов на продажу CDS salesorders
Заключения msdyn_complimentaryclosings
Контакты V2 msdyn_contactforparties
Роли принятия решений msdyn_decisionmakingroles
функциональные обязанности задания msdyn_employmentjobfunctions
Уровни лояльности msdyn_loyaltylevels
Контакты субъекта V3 msdyn_partyelectronicaddresses
Типы характеров людей msdyn_personalcharactertypes
Заголовки накладной заказа на продажу V2 накладные
Приветствия msdyn_salutations
Поставщики V2 msdyn_vendors
Роли адреса CDS msdyn_addressroles

Дополнительные сведения см. в разделе Ссылка сопоставления с двойной записью.

Роли адреса в виде раскрывающегося списка с множественным выбором

Почтовый адрес или электронный адрес могут служить более чем одной цели. Например, почтовый адрес может служить как адресом выставления счета, так и адресом поставки. В этих случаях пользователь может выбрать элементы Счет и Доставка в раскрывающемся списке, как показано на следующем рисунке.

Раскрывающийся список

Известные проблемы и ограничения

  • В приложениях для финансов и операций при создании клиента вместе с адресом и сохранении его адрес может не синхронизироваться с таблицей Адрес. Это обусловлено проблемой последовательностей платформ с двойной записью. Чтобы избежать этого, сначала создайте клиента и сохраните его. Затем добавьте адрес.

  • В приложениях для финансов и операций когда у записи клиента есть основной адрес и создается новый контакт для этого клиента, запись контакта наследует основной адрес из связанной записи клиента. Это происходит также и для контакта поставщика. Dataverse в настоящее время не поддерживает такое поведение. Если включен режим двойной записи, контакты клиента, наследуемые с использованием основного адреса из приложения для финансов и операций, синхронизируются с Dataverse вместе с его адресом.

  • В приложениях для финансов и операций можно создать запись о контакте в форме Добавить контакт. При попытке создать новый контакт из формы Просмотр контакта действие завершается ошибкой. Это известная проблема.

    Известная проблема с добавлением контакта.

  • Исходная синхронизация не поддерживает поля времени Доступно с и Доступно по в ContactForParty, так как DIXF преобразовывает это значение в строку вместо целого числа. Преобразование вызывает ошибку Cannot convert the literal '<say 08:00:00>' to the expected type edm.int32.

  • Вы не можете почтовый адрес с будущим числом с помощью приложения для финансов и операций с двойной записью, поскольку Dataverse не поддерживает дату. При вводе почтового адреса, датированного будущим числом, при помощи приложения для финансов и операций оно будет полностью синхронизировано с Dataverse, и адрес в интерфейсе пользователя сразу появится на экране. Все обновления этой записи приведут к ошибке, поскольку она задана на будущее, а не на актуальный день в приложении для финансов и операций.