集成Microsoft Outlook
部署Microsoft Outlook集成来安排事件和办公时间,编辑事件和办公时间,并在事件开始时间前一小时接收通知。
注意:
我们需要你的反馈!请提供该集成模板的反馈当你使用它的时候。对于任何问题,我们的团队也会监督我们的专门的论坛每天都是这样。
有关微软Outlook的开箱即用微应用程序的全面详细信息,请参见使用微软Outlook微应用程序.
检查先决条件
在您与Microsoft Outlook建立集成后,您将需要这些工件来在Citrix Workspace Microapps中添加集成:
- 基URL:
https://graph.microsoft.com/
- 授权网址:
https://login.microsoftonline.com/ {tenantId} / oauth2 /版本/授权
- 令牌网址:
https://login.microsoftonline.com/ {tenant_id} / oauth2 /版本/令牌
- CLIENT ID:客户端ID是表示授权服务器唯一的客户端注册信息的字符串。
- SECRET:客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
注意:
建议在可用的情况下始终使用OAuth 2.0作为服务身份验证方法。OAuth 2.0确保您的集成满足您所配置的微应用程序的最大安全合规。
将Citrix Gateway配置为支持Microsoft Outlook的单点登录,这样一旦用户登录,他们就会自动再次登录,而无需再次输入凭据。有关配置SSO的更多信息,请参见Citrix Gateway Service«https://docs.citrix.com/en-us/citrix-gateway-service/>。
可向特定资源发出的API请求数量有限,因此我们建议采取以下措施:
- Microsoft Outlook API限制表单链接:https://docs.microsoft.com/en-us/graph/throttling#microsoft-teams-service-limits
- 推荐方案:https://www.microsoft.com/en-in/microsoft-365/microsoft-teams/compare-microsoft-teams-options
权限
集成需要定期访问Microsoft Outlook实例,因此我们建议创建一个专用用户帐户。您可以查看权限/特权https://docs.microsoft.com/en-us/graph/permissions-reference.
该帐户必须具有以下权限:全球管理员.全局管理员角色授予Microsoft Outlook中应用程序权限和访问API的管理许可。
在这里签名:https://account.microsoft.com/.
配置OAuth服务器
配置OAuth服务器以通过Microsoft Outlook集成读取数据。
- 以服务帐户登入至:https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps
- 选择新的注册.
- 为支持的帐户类型中,选择任何组织目录中的帐户(任何Azure AD目录-多租户).
- 完成必需的字段,并在“重定向URL”字段中输入以下用于此集成的授权重定向URL:
https:// {yourmicroappserverurl} / admin / api / gwsc /认证/ serverContext
- 点击注册.
- 复制并保存应用程序(客户端)ID而且目录(租户)ID显示在屏幕上。在配置集成时,可以将这些详细信息用于服务身份验证。
- 点击视图的权限在“调用API”下选择添加权限并选择微软图瓷砖。
- 选择应用程序权限平铺并添加这些列出的范围:
* * User.Read。所有的日历。读* *
- 选择授予思杰系统的管理许可,选择“Yes”。
- 选择证书和秘密从左面板中选择新客户端秘密并选择过期有效期为never,然后单击添加。
- 复制并保存价值来自客户的秘密。
配置OAuth客户端
配置OAuth客户端以通过Microsoft Outlook集成回写数据。
- 以服务帐户登入至:https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps
- 选择新的注册.
- 为支持的帐户类型中,选择任何组织目录中的帐户(任何Azure AD目录-多租户).
- 完成必需的字段,并在“重定向URL”字段中输入以下用于此集成的授权重定向URL:
https:// {yourmicroappserverurl} / app / api /认证/ serviceAction /回调
- 点击注册
- 复制并保存应用程序(客户端)ID而且目录(租户)ID显示在屏幕上。在配置集成时,可以将这些详细信息用于服务身份验证。
- 点击视图的权限在“调用API”下选择添加权限并选择微软图瓷砖。
- 选择委托权限平铺并添加这些列出的范围:
* *日历。读写* *
- 选择授予思杰系统的管理许可,选择“Yes”。
- 选择证书和秘密从左面板中选择新客户端秘密并选择过期有效期为never,然后单击添加。
- 复制并保存价值来自客户的秘密。
将集成添加到Citrix Workspace Microapps
将Microsoft Outlook集成添加到Citrix Workspace Microapps以连接到您的应用程序。已预先选择身份验证选项。确保在完成流程时选中了这些选项。这提供了开箱即用的微应用程序,具有预先配置的通知和操作,可以在您的工作区中使用。
遵循以下步骤:
- 从Microapp集成页面,选择添加新的集成,从citrix提供的模板中添加新的集成.
- 选择Microsoft Outlook平铺。
- 输入一个集成的名字对于积分。
输入连接器参数.
- 输入实例基URL:
https://graph.microsoft.com/
- 从图标库中选择一个用于集成的图标,或将其作为默认图标。
- 输入实例基URL:
下服务认证中,选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。已预先选择身份验证选项。确保在完成流程时选中了这些选项。使用OAuth 2.0安全协议为委托访问生成请求/授权令牌。建议在可用的情况下始终使用OAuth 2.0作为服务身份验证方法。OAuth 2.0确保您的集成满足您所配置的微应用程序的最大安全合规。
- 选择客户端凭证从格兰特类型菜单。
- 选择请求体从令牌授权菜单。
- 的标记的URL肾上腺素:
https://login.microsoftonline.com/ {tenant_id} / oauth2 /版本/令牌
- 确保在Scope中输入以下内容:
.default
offline_access
- 输入您的客户机ID.客户端ID是表示授权服务器唯一的客户端注册信息的字符串。您可以在配置OAuth服务器时收集这些信息和秘密。您需要添加回调URL您可以在集成配置页面上看到。
- 输入您的客户的秘密.客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
下服务动作认证,启用使用独立用户认证在动作中切换。服务动作认证在服务动作级进行身份验证。已预先选择身份验证选项。确保在完成流程时选中了这些选项。
- 选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。
- 选择请求体从令牌授权菜单。
- 选择授权代码从格兰特类型菜单。这授予了一个临时代码,客户端用它交换访问令牌。代码从授权服务器获得,您可以在其中看到客户端请求的信息。只有这种授权类型支持安全用户模拟。这将显示Callback URL,您在注册应用程序时使用它。
- 的授权URL肾上腺素:
https://login.microsoftonline.com/ {tenantId} / oauth2 /版本/授权
- 的标记的URL肾上腺素:
https://login.microsoftonline.com/ {tenant_id} / oauth2 /版本/令牌
- 确保在Scope中输入以下内容:
.default
offline_access
- 输入您的客户机ID.客户端ID是表示授权服务器唯一的客户端注册信息的字符串。在配置OAuth客户端时,您将收集该信息和秘密。您需要添加回调URL您可以在集成配置页面上看到。
- 输入您的客户的秘密.客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
- 启用启用请求速率限制切换。输入60请求数1秒是时间间隔.
- (可选)使日志记录切换以保持24小时的日志记录用于支持目的。
- 选择保存继续。
的Microapp集成页面打开与您添加的集成及其微应用程序。从这里开始,您可以添加另一个集成,继续设置开箱即用的微应用程序,或者为该集成创建一个新的微应用程序。
现在可以设置并运行第一次数据同步了。由于可以从集成应用程序中提取大量数据到Microapps平台,我们建议您使用表格页,为第一次数据同步筛选实体,以加快同步速度。有关更多信息,请参见验证所需的实体.有关同步规则、不符合其时间表的同步和否决规则的完整信息,请参见同步数据.
注意:
Citrix Microsoft Outlook集成使用动作后数据更新为登录用户拉入最新数据刷新表“我的日历”服务操作中的按钮。我们建议按原样使用这种方法。请每周使用一次默认的全同步,以便为用户保留最佳的数据量。此外,该集成不支持增量同步,仅依赖于Action后的数据更新来引入最新的数据。全量同步周期建议设置为每周从Microapps平台和用户日历中删除已取消或删除的事件。
刷新按钮用于将缓存与最新数据同步,而不是完全/增量同步。由于此集成不依赖于完整/增量同步进行最新的数据提取,因此不需要分页,也不实现分页。这也有助于限制api调用。
有关API端点和表实体的详细信息,请参见MS Outlook连接器规格.
注意:
Calendarview数据端点使用过去的start_date_time和end_date_time硬编码,因为它们是强制的。但是,用户将在他们的微应用程序中使用刷新按钮的概念。
使用微软Outlook微应用程序
现有的应用集成带有开箱即用的微应用。从这些微应用程序开始,并根据您的需要定制它们。
注意:
中硬编码了当前可用的40个时区创建事件,我的办公时间而且我的日历微应用程序,添加任何其他时区都需要管理员手动添加。
创建事件:微应用程序用于根据用户偏好安排事件/会议。
通知或页面 | 用例的工作流 |
---|---|
创建事件页面 | 提供一个表单,可以根据用户偏好安排以下详细信息的活动:活动标题、开始日期/时间、结束日期/时间、时区、重复(一次、每天、每周、每月)、位置、描述和会议的与会者或嘉宾。 |
我的日历:微应用程序用于查看和编辑即将到来的事件/会议。
注意:
的事件提醒通知只在事件start_date_time之前一小时触发到事件组织者。这个通知只会在Microapp服务器缓存中的事件中被触发。为了确保及时通知,我们建议经常使用刷新表按钮,并按原样运行每周完全同步,以避免任何不正确/删除的事件通知。
通知或页面 | 用例的工作流 |
---|---|
事件提醒通知 | 事件所有者在事件开始时间前一小时收到通知。 |
即将到来的活动详情页面 | 仅为事件所有者提供带有详细信息的事件的只读视图、加入会议的按钮和编辑按钮。 |
即将到来的活动页面 | 允许用户搜索事件。 |
事件详情页面 | 提供带有详细信息的事件的只读视图。编辑选项可用于事件所有者。 |
编辑事件页面 | 提供用于编辑事件的表单。 |
办公时间:微应用程序用于创建、查看和编辑虚拟办公时间。
通知或页面 | 用例的工作流 |
---|---|
虚拟办公时间页面 | 允许用户查看办公时间。 |
创建办公时间页面 | 提供一个表单,可以根据用户的偏好安排虚拟办公时间,其中包含以下详细信息:办公时间的开始日期/时间、结束日期/时间、时区、重复(每天、每周、每月)、描述。 |
编辑办公时间页面 | 提供用于编辑办公时间的表单。 |