Как и почему я создал пользовательский коннектор Microsoft Flow для интеграции внешней системы CRM с SharePoint

Обо мне

Я разработчик SharePoint и Microsoft Dynamics 365 CRM, сертифицированный специалист по технологиям Microsoft, ниндзя Microsoft Power Platform, муж и любитель домашних животных. Я пишу решения для SharePoint и Dynamics CRM последние 14 лет, и мне очень нравятся инструменты и технологии, с которыми я работаю в повседневной жизни.

Мне нравится обучать молодых энтузиастов технологий не меньше, чем учиться самому.

Проблема, которую я хотел решить

В январе 2019 года со мной связался Пол из офиса моего клиента, который познакомил меня с интересной задачей. Пол хотел создавать элемент в списке SharePoint всякий раз, когда сделка создавалась в «Pipeline Deals» (веб-система CRM). Он не смог найти готовых интеграций, поэтому настоял на использовании WebHooks и написании кода для выполнения этой задачи.

Я имел в виду другое.

Что такое создание пользовательского соединителя Microsoft Flow для интеграции внешних систем с SharePoint?

Я создал пользовательский коннектор Microsoft Flow, чтобы решить эту проблему без написания кода. Я использовал соединитель в простом потоке, чтобы получить сведения о недавно созданной сделке, и создал элемент списка SharePoint, используя поля из сведений о сделке. Задача решена!

Стек технологий

Лучшее, что произошло за последние 5 лет в мире технологий, — это эволюция low-code-no-code инструментов и платформ. Лучше всего я всегда склоняюсь к созданию многоразовых решений, которые легко поддерживать, особенно в облачных средах.

Сказав это, я решил выбрать Microsoft Flow и его предложение Custom Connector вместе с опциями API и автоматизации, предоставляемыми Pipeline Deals.

Все это решение является очень общим и может быть легко применено для создания интеграции между другими внешними системами и SharePoint (или другими приложениями Office 365).

Процесс создания Создание пользовательского соединителя Microsoft Flow для интеграции внешних систем с SharePoint

Я создал пользовательский коннектор Microsoft Flow для Pipeline Deals, используя его методы API для сделок (

Затем я использовал этот коннектор в потоке, который я создал отдельно, используя функциональность автоматизации CRM-системы Pipeline Deals, которая отправляет HTTP-запрос POST, когда происходят определенные события (веб-перехватчики), такие как создание сделки, обновление сделки, удаление сделки и т. д.

Поток будет выполняться каждый раз при создании сделки в Pipeline Deals, а пользовательское действие коннектора будет извлекать все детали сделки. Как только эти сведения станут доступны в Flow, можно будет легко создать элемент списка SharePoint с необходимыми полями.

Давайте рассмотрим этапы создания пользовательского коннектора:

  1. Настройте пробную учетную запись для «Конвейерных сделок» —

  2. Получите ключ API в настройках учетной записи —> PipelineDealsAPI.

  3. Создайте настраиваемый соединитель в Microsoft Flow следующим образом:

  • Войдите в свою учетную запись Office 365
  • Нажмите на значок шестеренки в правом верхнем углу и выберите в меню «Пользовательские коннекторы».
  • Нажмите «Создать настраиваемый соединитель» и введите имя для своего соединителя.

1.png

  • Заполните данные, как показано ниже, для вкладки «Общие».

2.png

  • Заполните данные, как показано ниже, для вкладки «Безопасность».

3.png

  • Теперь, когда мы ввели основную информацию, пришло время для забавных вещей. Теперь мы создадим действие на вкладке «Определение» коннектора. Нажмите кнопку «Новое действие» слева и заполните данные, как показано ниже.

Примечание. В этом примере мы будем использовать только метод GetDealById API Pipeline Deals.

4.png

  • В разделе «Запрос» действия нажмите кнопку «Импорт из образца» и заполните данные следующим образом:

4.5.png

Примечание. URL-адрес конечной точки для метода GetDealById — «key>».

5.png

  • Убедитесь, что в разделе «Проверка» указано «Проверка прошла успешно».

6.png

Вот и все, ваш пользовательский коннектор готов. Что теперь?

  1. Создайте Microsoft Flow для использования соединителя
  • Запишите URL-адрес HTTP POST, который создается при сохранении потока. Мы будем использовать это на следующем шаге.
  • Схема JSON тела запроса для первого шага в потоке:
{
    "event_model": "Event model name",
    "event_action": "event action name",
    "event_model_id": 1234,
    "trigger": "Hello World"
}
  • Используйте следующее выражение, чтобы извлечь идентификатор сделки из первого шага потока. Этот идентификатор будет использоваться в параметре «Id» пользовательского соединителя на втором этапе потока.
int(triggerFormDataValue('event_model_id'))

7.png

  1. Давайте создадим Автоматизацию в Pipeline Deals.
  • Перейдите в «Настройки учетной записи» -> «Автоматизация» -> нажмите «Создать автоматизацию».

8.png

  • Используйте URL-адрес HTTP POST из вашего потока (предыдущий шаг), этот URL-адрес будет использоваться в целевом URL-адресе вашей автоматизации в разделе «Сделать это:». Выполните следующие действия:

9.png

  1. Проверьте свой поток
  • Если вы выполнили все шаги, ваш поток должен срабатывать при создании сделки в Pipeline Deals.

10.png

Проблемы, с которыми я столкнулся

Самой большой проблемой было определить правильную конечную точку и формат схемы запроса. С этими проблемами не так уж сложно разобраться, особенно при наличии надлежащей документации. Однако это зависит от внешней системы, которую вы хотите интегрировать с Office 365 с помощью Flow.

Основные выводы

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

Советы и советы

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

Заключительные мысли и следующие шаги

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

Microsoft Flow способен справляться со сложными задачами и позволяет нам создавать сложные интеграции между различными платформами, как в помещении, так и в облаке.

Похожие записи

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *