Как создать коннектор с конфигурацией, загруженной из веб-решения для Microsoft Teams

Я пытаюсь создать соединитель для Microsoft Teams. Я завершил регистрацию на панели инструментов разработчика коннекторов и загрузил manifest.json.

Я могу загрузить манифест коннектора в Teams, а также найти коннектор в списке коннекторов.

Когда я выбираю соединитель и хочу его настроить, все введенные мной данные отображаются правильно.

Моя проблема в том, что я хочу, чтобы пользователь коннектора мог выбирать параметры конфигурации в зависимости от своей подписки на моем сайте (как в коннекторе Trello).

Например, пользователь создал несколько разделов в своей подписке на моем веб-сайте. Я хочу позволить им выбрать один из регионов, из которого он хочет получать обновления в разговоре Microsoft Teams.

Из документации я не могу найти, где и как загрузить параметры конфигурации с моего веб-сайта в диалоговое окно конфигурации коннектора. Мой манифест выглядит так (URL-адреса и идентификаторы заменены)

 {
  "$schema": "https://statics.teams.microsoft.com/sdk/v1.0/manifest/MicrosoftTeams.schema.json",
  "manifestVersion": "1.0",
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "version": "1.0",
  "packageName": "com.example.org",
  "developer": {
    "name": "Developer Company",
    "websiteUrl": "https://www.example.com",
    "privacyUrl": "https://www.example.com",
    "termsOfUseUrl": "https://www.example.com"
  },
  "description": {
    "full": "The connector sends notifications ....",
    "short": "Lorem ipsum dolor sit amet"
  },
  "icons": {
    "outline": "https://outlook.office.com/connectors/Content/Images/IncomingWebhook.jpg",
    "color": "https://outlook.office.com/connectors/Content/Images/IncomingWebhook.jpg"
  },
   "configurableTabs": [
        {
            "configurationUrl": "https://teamsnodesample.azurewebsites.net/tabs/configure",
            "canUpdateConfiguration": true,
            "scopes": [
                "team"
            ]
        }
    ],
  "connectors": [
    {
      "connectorId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "scopes": [
        "team"
      ]
    }
  ],
  "name": {
    "full": "My Organisation",
    "short": "My Organisation"
  },
  "accentColor": "#FFFFFF",
  "needsIdentity": "true"
}

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

Экран 1

Экран 2

Экран 3

Экран 4

Экран 5


person Franz Kiermaier    schedule 27.08.2017    source источник


Ответы (1)


1) После регистрации коннектора на панели инструментов разработчика коннектора и правильной настройки целевой страницы для ваших пользователей для групп или команд и URL-адреса перенаправления (например, для конечной точки ngrok вашей службы работает), рядом с командами Microsoft есть возможность скопировать код и загрузить Manifest. Я вижу, вы использовали манифест для загрузки неопубликованных приложений в команды. Копирующий код дает ссылку, которую вы можете использовать в HTML-коде целевой страницы внутри вашего кода.

2) Нажмите «Настроить» рядом с вашим коннектором, и появится всплывающее окно, в котором показано посетить сайт для установки ->. Это приведет вас к целевой странице, указанной при регистрации коннектора на портале. Если вы поместили код на загрузочную страницу, вы должны увидеть кнопку подключения к коннектору office365. Когда вы нажмете на нее, вы перейдете к URL-адресу перенаправления. У вас должна быть возможность вызывать свой api и отображать любую настройку для пользователя.

Также может быть полезен этот пример кода: https://github.com/OfficeDev/microsoft-teams-sample-get-started/tree/master/Node/connector

person Ashish    schedule 28.08.2017
comment
Спасибо, что поделились этим решением, но я не хочу, чтобы оно работало. Я добавил скриншоты в исходный пост, чтобы показать, как пользователь взаимодействует (например) с конфигурацией коннектора Trello (и со всеми остальными). Таким же образом я и хочу предоставить конфигурацию разъема. Вы знаете, как этого добиться? - person Franz Kiermaier; 29.08.2017
comment
@FranzKiermaier Дело здесь в различии между коннекторами первой и третьей стороны. Вы разрабатываете как сторонний соединитель, поэтому вы не можете создать точно такой же опыт, но можете иметь близкий к нему опыт. Для сторонних соединителей всплывающее окно является внешним. Вам нужно щелкнуть ссылку «Посетить сайт для установки…», которая откроет другую вкладку (при запуске Teams в браузере) или отдельное всплывающее окно, если вы работаете в Teams, встроенных возможностей настройки для соединителей нет. Вы можете вызвать страницу аутентификации в качестве целевой страницы, а затем предоставьте возможность настройки. - person Ashish; 30.08.2017
comment
Мы получили много отзывов о том факте, что конфигурация коннекторов первой и сторонней производителей различается. Мы работаем над возможностью встроенного конфигурирования, больше похожего на наш опыт конфигурирования вкладок. - person Bill Bliss - MSFT; 07.09.2017