Дополнение Business Central для настройки RapidStart CRM
Шаги по установке, настройке и проверке дополнения Business Central для RapidStart CRM. Это дополнение использует как облачные потоки RapidStart, так и встроенную синхронизацию Business Central-Dataverse от Microsoft, поэтому администраторам следует проверить обе стороны перед тестированием сценариев клиента или предложения.
⚠️ Рекомендуется партнер
Из-за сложности мы предлагаем использовать одного из наших сертифицированных партнеров RapidStart для этого. Однако, если ваш партнер по Business Central также обладает навыками работы с Power Platform, он может выполнить эти шаги за вас. Мы не рекомендуем конечному пользователю пытаться выполнить этот процесс.
Основные шаги
- Создайте или используйте существующую среду с поддержкой Dataverse.
- Установите RapidStart CRM из AppSource в среде с поддержкой Dataverse.
- Получите системный идентификатор компании Business Central.
- Настройте интеграцию из Business Central.
- Проверьте роль пользователя приложения интеграции Business Central
- Настройте сопоставление записей
- Свяжите среды (необязательно)
- Установите дополнение Business Central для RapidStart CRM из AppSource в среде с поддержкой Dataverse.
- Завершите в приложении настроек RapidStart
Мы уже создали документ, который охватывает шаги 1 и 2 здесь. После завершения этих шагов вернитесь сюда, чтобы продолжить с шага 3.
Убедитесь, что типы сред Dataverse и BC совпадают: Production с Production или Sandbox с Sandbox.
Перед началом
Подтвердите эти требования перед началом настройки дополнения Business Central:
- Business Central и Dataverse должны находиться в одном и том же клиенте Microsoft Entra для виртуальных таблиц Business Central.
- Используйте администратора настройки с необходимыми разрешениями Business Central и доступом администратора системы Dataverse во время настройки.
- Подтвердите, что RapidStart CRM установлен в среде Dataverse, которую вы планируете подключить.
Шаг 3: Получите идентификатор компании
Чтобы получить идентификатор вашей компании, найдите Компании в Business Central. Выберите целевую компанию и нажмите Ctrl+Alt+F1, чтобы открыть Инспекцию страницы. Скопируйте показанный ID и сохраните его для дальнейшего использования.
Используйте GUID системного идентификатора компании
Идентификатор компании, который вам нужен для переменной среды RapidStart, это GUID системного идентификатора компании Business Central. Не используйте редактируемое отображаемое имя компании из адресной строки. Если вы не можете открыть Инспекцию страницы, попросите вашего администратора или партнера Business Central предоставить идентификатор компании.
Шаг 4: Настройте интеграцию из Business Central
Войдите в среду Business Central, которую вы хотите подключить.
Обратите внимание на имя среды Business Central в адресной строке. URL также может показывать отображаемое имя компании, но вы уже зафиксировали GUID системного идентификатора компании на предыдущем шаге.
Скопируйте имя среды Business Central в те же заметки, где вы сохранили GUID системного идентификатора компании.
Идентификатор компании уже зафиксирован
Используйте GUID системного идентификатора компании из шага 3, когда настройка запросит идентификатор компании BC. Отображаемое имя компании в URL является только обратной совместимостью для старых развертываний.
1. Нажмите на шестеренку
2. Выберите “Помощь в настройке”
Прокрутите вниз до раздела “Подключение к другим системам” и нажмите “Настроить подключение к Dataverse”.
1. Выберите Включить синхронизацию данных
2. Выберите включение виртуальных таблиц и событий
3. Нажмите “Далее”
Примите условия и нажмите “Далее”
Примите подключение к Dataverse “Разрешить всегда”, и нажмите OK
Выберите целевую среду с поддержкой Dataverse и нажмите “Ok”
Подтвердите, что среда правильная, затем нажмите ссылку, чтобы войти в среду Dataverse. После входа нажмите “Далее”
Выберите рекомендуемое владение командой, переключитесь на Завершить без синхронизации (мы сделаем это позже) и нажмите “Далее”
1. Нажмите Ссылка для установки приложения виртуальных таблиц Business Central
2. Нажмите “Далее” (Откроется новая вкладка для AppSource)
Нажмите кнопку “Получить сейчас” (Это дополнение бесплатно), и откроется следующая страница:
1. Выберите целевую среду (где вы установили RapidStart CRM).
2. Согласитесь с условиями.
3. Нажмите “Установить”.
Вы увидите, что решение “Устанавливается”. Это может занять несколько минут. Периодически нажимайте “обновить”, пока не увидите, что оно “Установлено”, затем вернитесь на вкладку браузера Business Central, чтобы продолжить.
Нажмите “Обновить”
Вы увидите, что приложение виртуальных таблиц успешно установлено. Нажмите “Завершить”
Через несколько минут появится эта страница. Выберите вкладку Виртуальные таблицы, а затем “Доступные виртуальные таблицы”
1. Начните с выбора строки “элемент”
2. Нажмите “Включить” (Это создаст виртуальную таблицу в Dataverse для элементов)
3. Подождите, пока не увидите, что поле “Видимое” отмечено. Возможно, вам придется обновить несколько раз.
Повторите эти шаги для: salesInvoice, salesInvoiceLine, salesOrder, salesOrderLine, salesQuote, salesQuoteLine, salesShipment и salesShipmentLine. Это займет несколько минут для каждого, чтобы включить.
Измените сортировку по Видимое/по убыванию и подтвердите, что вы видите все эти таблицы. Не добавляйте больше виртуальных таблиц в это время. Вы можете оставить экран как есть (мы вернемся к нему) и открыть новую вкладку.
Шаг 5: Проверьте пользователя приложения интеграции Business Central
Не назначайте роль администратора системы пользователю приложения
Администратору настройки требуется разрешение администратора системы Dataverse во время настройки. Автоматически созданный пользователь приложения интеграции Business Central должен использовать роль Business Central Dataverse Integration от Microsoft, а не администратора системы.
Если разрешения на синхронизацию Business Central-Dataverse кажутся поврежденными, откройте Настройку подключения Dataverse в Business Central и используйте Повторное развертывание решения интеграции. Это восстановит решение интеграции Microsoft и развернет роль безопасности интеграции Business Central.
Продолжайте только после успешного теста подключения и наличия у пользователя приложения интеграции Business Central роли Business Central Dataverse Integration от Microsoft.
Шаг 6: Настройте сопоставление и связывание записей
Потоки RapidStart и синхронизация Microsoft отдельны
Облачные потоки RapidStart поддерживают действия дополнений, такие как запросы котировок и обновления выбранных клиентов/контактов. Встроенные сопоставления таблиц интеграции Business Central от Microsoft обрабатывают синхронизацию Business Central-Dataverse, связывание, справочные данные и запланированную синхронизацию. Настройте оба в одной и той же среде Dataverse и компании Business Central.
Настройте справочные сопоставления перед синхронизацией клиентов
Запустите и проверьте справочные сопоставления перед тестированием КЛИЕНТА. Синхронизация клиентов часто терпит неудачу, когда значения валюты, условий оплаты, метода доставки или агента доставки не существуют или не имеют совпадающих идентификаторов опций на стороне Dataverse.
Справочные сопоставления для настройки перед КЛИЕНТОМ
- ВАЛЮТА: Валюта Business Central → Валюта транзакции Dataverse. Направление должно быть Business Central в Dataverse. Подтвердите эти включенные сопоставления полей: Код → Код валюты, Символ → Символ валюты и Описание → Название валюты.
- Подтвердите, что сопоставление КЛИЕНТА содержит Код валюты → Валюта. Синхронизируйте валюты перед клиентами. Базовая валюта Dataverse и локальная валюта Business Central должны совпадать, и должны существовать необходимые обменные курсы.
- Условия оплаты: синхронизируйте с Условиями оплаты счета перед тестированием клиента.
- Метод доставки: синхронизируйте с Условиями доставки счета перед тестированием клиента.
- Агент доставки: синхронизируйте с Методом доставки счета перед тестированием клиента.
Политика создания клиентов
Установите КЛИЕНТА на Двунаправленный, если учетные записи/компании могут быть созданы с любой стороны. Затем выберите политику Синхронизировать только связанные записи как решение по развертыванию клиентов:
| Настройка | Поведение |
|---|---|
| Синхронизировать только связанные записи = Вкл. | Синхронизирует только записи, которые администратор уже связал. Это избегает широкого создания новых несвязанных записей. |
| Синхронизировать только связанные записи = Выкл. | Начальная и запланированная синхронизация может создавать несвязанных клиентов/учетные записи на другой стороне. Используйте это только тогда, когда такое поведение создания намеренно. |
Связывание требуется, когда Синхронизировать только связанные записи включено
Когда Синхронизировать только связанные записи включено, синхронизация Microsoft обновляет только уже связанные записи. Поток RapidStart может создать клиента Business Central и сохранить его номер клиента на учетной записи Dataverse, но это не устанавливает нативное связывание Microsoft. После использования потока вручную свяжите клиента и учетную запись в Business Central, если требуется постоянная нативная синхронизация. Номер клиента Business Central сам по себе не является доказательством связывания.
Проверка значений опций
Идентификаторы значений перечислений Business Central, используемые для Условий оплаты, Метода доставки и Агента доставки, должны совпадать с соответствующими идентификаторами опций Dataverse. Отображаемый текст или метка кода недостаточны. Полная синхронизация не исправляет несоответствие идентификаторов, когда в Business Central содержатся пользовательские значения перечислений, которые не существуют в Dataverse.
- Запустите Синхронизировать измененные записи для УСЛОВИЙ ОПЛАТЫ, МЕТОДА ДОСТАВКИ и АГЕНТА ДОСТАВКИ.
- Проверьте Сопоставление опций Dataverse и журнал ошибок синхронизации перед тестированием КЛИЕНТА.
- Если идентификаторы не совпадают, используйте безопасный по умолчанию на сопоставлениях полей КЛИЕНТА: Код условий оплаты → Условия оплаты = FromIntegrationTable; Код метода доставки → Адрес 1: Условия доставки = FromIntegrationTable; Код агента доставки → Адрес 1: Метод доставки = FromIntegrationTable.
- Измените эти три поля на Двунаправленный только после того, как разработчик добавит совпадающие идентификаторы опций с обеих сторон.
- Не изобретайте и не перенумеровывайте идентификаторы опций во время настройки. Пользовательские значения Dataverse и расширения перечислений Business Central должны использовать точно такие же идентификаторы.
Вернитесь на вкладку Business Central в вашем браузере, которую мы оставили открытой.
1. Нажмите на вкладку “Интеграция”
2. затем “Сопоставления таблиц интеграции”
Решение клиента: оставьте ПРОДАВЦЫ, если клиент хочет стандартную синхронизацию пользователя Dataverse с продавцом Business Central от Microsoft. Удалите или отключите это сопоставление только тогда, когда эта стандартная синхронизация намеренно не используется.
1. Выберите КОНТАКТ
2. Выберите Связывание
3. Затем нажмите “Связывание на основе совпадений”.
4. Совпадите вышеуказанное и нажмите OK
1. Выберите ВАЛЮТА
2. Выберите Связывание
3. Затем нажмите “Связывание на основе совпадений”.
4. Совпадите вышеуказанное и нажмите OK
Для КЛИЕНТА выберите Сопоставление/Поля
1. Выберите “Редактировать список”
2. и “включите” Номер счета.
Все еще для КЛИЕНТА, выберите Связывание/Связывание на основе совпадений. Совпадите, используя поля идентификаторов клиента/учетной записи, показанные на скриншоте, и подтвердите, что совпадающие поля уникально идентифицируют одного и того же клиента с обеих сторон.
Для УСЛОВИЙ ОПЛАТЫ выберите Связывание/Связывание на основе совпадений. Совпадите записи условий оплаты Business Central с соответствующими значениями опций условий оплаты Dataverse по настроенным идентификаторам.
Для МЕТОДА ДОСТАВКИ выберите Связывание/Связывание на основе совпадений. Совпадите методы доставки Business Central с соответствующими значениями опций условий доставки Dataverse по настроенным идентификаторам.
Для АГЕНТА ДОСТАВКИ выберите Связывание/Связывание на основе совпадений. Совпадите агентов доставки Business Central с соответствующими значениями опций метода доставки Dataverse по настроенным идентификаторам.
Для ПОСТАВЩИКА выберите Сопоставление/Поля
1. Выберите “Редактировать список”
2. и “включите” Номер счета.
Все еще для ПОСТАВЩИКА, выберите Связывание/Связывание на основе совпадений. Совпадите, используя поля идентификаторов поставщика/учетной записи, показанные на скриншоте, и подтвердите, что совпадающие поля уникально идентифицируют одного и того же поставщика с обеих сторон.
Шаг 7: Свяжите среды (необязательно)
Необязательное требование связывания сред
Связывайте среды только тогда, когда среда Business Central и среда Power Platform являются одного типа, например, production-to-production или sandbox-to-sandbox, и находятся в одной географии Azure.
Чтобы предотвратить случайное удаление сред, вы можете связать их. Начните с Business Central.
1. Выберите иконку шестеренки
2. Затем выберите Центр администрирования
Выберите ссылку на целевую среду
Нажмите на “Связать” и выберите вашу среду Dataverse
Шаг 8: Установите дополнение Business Central для RapidStart CRM из AppSource
Подтвердите необходимую основу перед установкой дополнения
RapidStart CRM и поддержка виртуальных таблиц Microsoft Business Central должны быть установлены сначала. Подтвердите необходимые виртуальные таблицы Business Central и значения подключения перед продолжением. Необязательное связывание сред не обязательно должно быть завершено для этой установки AppSource.
Нажмите эту ссылку, чтобы открыть AppSource от Microsoft и подтвердить, что вы вошли в систему с вашей бизнес-учетной записью.
Выберите “Получить сейчас”, чтобы начать установку.
1. Выберите среду, где вы установили решение виртуальных таблиц.
2. Согласитесь с условиями.
3. Нажмите Установить. Обратите внимание, что установка может занять несколько минут.
Вы увидите, что решение “Устанавливается”. Это может занять несколько минут. Периодически нажимайте “обновить”, пока не увидите, что оно “Установлено”.
Шаг 9: Завершите в приложении настроек RapidStart
Перейдите в RapidStart CRM и выберите приложение настроек RapidStart.
Вы можете открыть приложение настроек RapidStart из селектора приложений в RapidStart CRM или из портала разработчика:
1. Выберите Приложения в боковой панели.
2. Нажмите на иконку запуска для приложения настроек RapidStart.
1. Подтвердите, что вы находитесь в приложении настроек RapidStart.
2. Выберите “Приложения и дополнения” в боковой панели.
3. Нажмите “Настроить” для дополнения Business Central.
Используйте этот мастер, чтобы завершить любые недостающие элементы и управлять коннектором.
Устранение неполадок
Отсутствующие идентификаторы подключения
Если поток сообщает об отсутствии идентификатора подключения, восстановите ссылки подключения Dataverse и Business Central в приложении настроек RapidStart или Power Automate, затем снова включите поток. Воссоздание подключения само по себе недостаточно, если ссылка подключения все еще привязана к старому подключению.
Ошибки сопоставления валют
Если синхронизация КЛИЕНТА не удается из-за валюты, восстановите или проверьте сопоставление ВАЛЮТЫ, подтвердите, что Код → Код валюты включен, синхронизируйте валюты и подтвердите, что валюта клиента существует в Dataverse перед повторной попыткой синхронизации КЛИЕНТА.
Несоответствия опций
Если синхронизация не удается, потому что значение Условий оплаты, Метода доставки или Агента доставки находится за пределами допустимого диапазона Dataverse, идентификатор значения перечисления Business Central не совпадает с идентификатором опции Dataverse. Используйте FromIntegrationTable для сопоставления поля КЛИЕНТА, пока не будут развернуты совпадающие идентификаторы.
Связывания, указывающие на удаленные записи
Если запись кажется связанной, но синхронизация указывает на удаленную или отсутствующую запись, удалите устаревшее связывание в Business Central и создайте новое связывание с правильной учетной записью или контактом Dataverse перед повторным запуском синхронизации.
Развертывание завершено
Если у вас есть проблемы с этой документацией, пожалуйста, дайте нам знать.