如何使用从Microsoft Web团队的Web解决方案加载的配置创建连接器

问题描述:

我正在尝试为Microsoft团队创建连接器。 我已经完成连接器开发人员仪表板中的注册并下载了manifest.json。如何使用从Microsoft Web团队的Web解决方案加载的配置创建连接器

我可以在团队中装载连接器清单,并在连接器列表中找到连接器。

当我选择连接器并想配置它时,我所有具有entererd的数据都会正确显示。

我的问题是 - 我想让连接器的用户选择配置参数,取决于他们在我的站点上订阅(如在Trello连接器中)。

例如,用户在我的网站上订阅时创建了多个区域。我想让他们选择他想从Microsoft Teams对话中获取更新的区域之一。

从文档中,我无法找到从我的网站将配置参数加载到连接器配置对话框的位置或方式。 我的清单看起来像这样(取代的URL和ID)

{ 
    "$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连接器配置的用户体验看起来像在下面的屏幕截图所示。我无法弄清楚如何集成连接器配置的所有对话框。

Screen 1

Screen 2

Screen 3

Screen 4

Screen 5

1)一旦您注册在连接器开发人员仪表板连接器,并设置着陆页为您的用户群组或团队正确重定向网址(例如,您的服务运行ngrok终点),Microsoft团队旁边有一个选项用于复制代码并下载Manifest。我看到你已经使用清单来支持团队。复制代码给出了一个链接,您可以在代码中使用Landing页面html。

2)单击连接器旁边的配置,它会弹出一个窗口,其中显示访问网站进行安装 - >。这应该带您进入在门户网站上注册连接器时指定的登录页面。如果您已将代码放入装订页面,则应该可以看到连接到office365连接器的按钮。当您点击它时,它会将您带到重定向网址。你应该可以调用你的api并向用户显示任何配置体验。

而且此代码示例可能是有用的: https://github.com/OfficeDev/microsoft-teams-sample-get-started/tree/master/Node/connector

+0

感谢您分享这个解决方案,但是这不是我多么希望它的工作。我在原文中添加了屏幕截图,以显示(例如)Trello连接器配置(以及所有其他配置)的用户体验。这是,我想如何提供连接器配置。你知道吗,这是如何实现的? –

+0

@FranzKiermaier这里的关键是第一方和第三方连接器的区别。您正在开发第三方连接器,因此您无法创建完全相同的体验,但可以接近该体验。对于第三方连接器,弹出窗口是外部连接。您需要点击“访问网站以安装...”链接,该链接将启动另一个选项卡(在浏览器中运行团队时)或单独弹出,如果在团队中运行,则不存在连接器的内置配置体验。您可以调用身份验证页面作为登录页面,然后提供您的配置体验。 – Ashish

+0

第一方和第三方连接器配置体验不同的事实是我们收到了很多反馈意见。我们正在努力使内联配置体验更像我们的标签配置体验。 –