集成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集成读取数据。

1. 以服务帐户登入至:https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps
2. 选择新的注册．
3. 为支持的帐户类型中,选择任何组织目录中的帐户(任何Azure AD目录-多租户)．
4. 完成必需的字段，并在“重定向URL”字段中输入以下用于此集成的授权重定向URL:https:// {yourmicroappserverurl} / admin / api / gwsc /认证/ serverContext
5. 点击注册．
6. 复制并保存应用程序(客户端)ID而且目录(租户)ID显示在屏幕上。在配置集成时，可以将这些详细信息用于服务身份验证。
7. 点击视图的权限在“调用API”下选择添加权限并选择微软图瓷砖。
8. 选择应用程序权限平铺并添加这些列出的范围:* * User.Read。所有的日历。读* *
9. 选择授予思杰系统的管理许可，选择“Yes”。
10. 选择证书和秘密从左面板中选择新客户端秘密并选择过期有效期为never，然后单击添加。
11. 复制并保存价值来自客户的秘密。

配置OAuth客户端

配置OAuth客户端以通过Microsoft Outlook集成回写数据。

1. 以服务帐户登入至:https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps
2. 选择新的注册．
3. 为支持的帐户类型中,选择任何组织目录中的帐户(任何Azure AD目录-多租户)．
4. 完成必需的字段，并在“重定向URL”字段中输入以下用于此集成的授权重定向URL:https:// {yourmicroappserverurl} / app / api /认证/ serviceAction /回调
5. 点击注册
6. 复制并保存应用程序(客户端)ID而且目录(租户)ID显示在屏幕上。在配置集成时，可以将这些详细信息用于服务身份验证。
7. 点击视图的权限在“调用API”下选择添加权限并选择微软图瓷砖。
8. 选择委托权限平铺并添加这些列出的范围:* *日历。读写* *
9. 选择授予思杰系统的管理许可，选择“Yes”。
10. 选择证书和秘密从左面板中选择新客户端秘密并选择过期有效期为never，然后单击添加。
11. 复制并保存价值来自客户的秘密。

将集成添加到Citrix Workspace Microapps

将Microsoft Outlook集成添加到Citrix Workspace Microapps以连接到您的应用程序。已预先选择身份验证选项。确保在完成流程时选中了这些选项。这提供了开箱即用的微应用程序，具有预先配置的通知和操作，可以在您的工作区中使用。

遵循以下步骤:

1. 从Microapp集成页面,选择添加新的集成,从citrix提供的模板中添加新的集成．
2. 选择Microsoft Outlook平铺。
3. 输入一个集成的名字对于积分。

4. 输入连接器参数．

   • 输入实例基URL:https://graph.microsoft.com/
   • 从图标库中选择一个用于集成的图标，或将其作为默认图标。

5. 下服务认证中,选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。已预先选择身份验证选项。确保在完成流程时选中了这些选项。使用OAuth 2.0安全协议为委托访问生成请求/授权令牌。建议在可用的情况下始终使用OAuth 2.0作为服务身份验证方法。OAuth 2.0确保您的集成满足您所配置的微应用程序的最大安全合规。

   1. 选择客户端凭证从格兰特类型菜单。
   2. 选择请求体从令牌授权菜单。
   3. 的标记的URL肾上腺素:https://login.microsoftonline.com/ {tenant_id} / oauth2 /版本/令牌
   4. 确保在Scope中输入以下内容:.defaultoffline_access
   5. 输入您的客户机ID．客户端ID是表示授权服务器唯一的客户端注册信息的字符串。您可以在配置OAuth服务器时收集这些信息和秘密。您需要添加回调URL您可以在集成配置页面上看到。
   6. 输入您的客户的秘密．客户端秘密是在设置目标应用程序集成时发出的唯一字符串。

6. 下服务动作认证，启用使用独立用户认证在动作中切换。服务动作认证在服务动作级进行身份验证。已预先选择身份验证选项。确保在完成流程时选中了这些选项。

   1. 选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。
   2. 选择请求体从令牌授权菜单。
   3. 选择授权代码从格兰特类型菜单。这授予了一个临时代码，客户端用它交换访问令牌。代码从授权服务器获得，您可以在其中看到客户端请求的信息。只有这种授权类型支持安全用户模拟。这将显示Callback URL，您在注册应用程序时使用它。
   4. 的授权URL肾上腺素:https://login.microsoftonline.com/ {tenantId} / oauth2 /版本/授权
   5. 的标记的URL肾上腺素:https://login.microsoftonline.com/ {tenant_id} / oauth2 /版本/令牌
   6. 确保在Scope中输入以下内容:.defaultoffline_access
   7. 输入您的客户机ID．客户端ID是表示授权服务器唯一的客户端注册信息的字符串。在配置OAuth客户端时，您将收集该信息和秘密。您需要添加回调URL您可以在集成配置页面上看到。
   8. 输入您的客户的秘密．客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
7. 启用启用请求速率限制切换。输入60请求数1秒是时间间隔．
8. (可选)使日志记录切换以保持24小时的日志记录用于支持目的。
9. 选择保存继续。

的Microapp集成页面打开与您添加的集成及其微应用程序。从这里开始，您可以添加另一个集成，继续设置开箱即用的微应用程序，或者为该集成创建一个新的微应用程序。

现在可以设置并运行第一次数据同步了。由于可以从集成应用程序中提取大量数据到Microapps平台，我们建议您使用表格页，为第一次数据同步筛选实体，以加快同步速度。有关更多信息，请参见验证所需的实体．有关同步规则、不符合其时间表的同步和否决规则的完整信息，请参见同步数据．

注意:

Citrix Microsoft Outlook集成使用动作后数据更新为登录用户拉入最新数据刷新表“我的日历”服务操作中的按钮。我们建议按原样使用这种方法。请每周使用一次默认的全同步，以便为用户保留最佳的数据量。此外，该集成不支持增量同步，仅依赖于Action后的数据更新来引入最新的数据。全量同步周期建议设置为每周从Microapps平台和用户日历中删除已取消或删除的事件。

刷新按钮用于将缓存与最新数据同步，而不是完全/增量同步。由于此集成不依赖于完整/增量同步进行最新的数据提取，因此不需要分页，也不实现分页。这也有助于限制api调用。

有关API端点和表实体的详细信息，请参见MS Outlook连接器规格．

注意:

Calendarview数据端点使用过去的start_date_time和end_date_time硬编码，因为它们是强制的。但是，用户将在他们的微应用程序中使用刷新按钮的概念。

使用微软Outlook微应用程序

现有的应用集成带有开箱即用的微应用。从这些微应用程序开始，并根据您的需要定制它们。

注意:

中硬编码了当前可用的40个时区创建事件，我的办公时间而且我的日历微应用程序，添加任何其他时区都需要管理员手动添加。

创建事件:微应用程序用于根据用户偏好安排事件/会议。

通知或页面	用例的工作流
创建事件页面	提供一个表单，可以根据用户偏好安排以下详细信息的活动:活动标题、开始日期/时间、结束日期/时间、时区、重复(一次、每天、每周、每月)、位置、描述和会议的与会者或嘉宾。

我的日历:微应用程序用于查看和编辑即将到来的事件/会议。

注意:

的事件提醒通知只在事件start_date_time之前一小时触发到事件组织者。这个通知只会在Microapp服务器缓存中的事件中被触发。为了确保及时通知，我们建议经常使用刷新表按钮，并按原样运行每周完全同步，以避免任何不正确/删除的事件通知。

通知或页面	用例的工作流
事件提醒通知	事件所有者在事件开始时间前一小时收到通知。
即将到来的活动详情页面	仅为事件所有者提供带有详细信息的事件的只读视图、加入会议的按钮和编辑按钮。
即将到来的活动页面	允许用户搜索事件。
事件详情页面	提供带有详细信息的事件的只读视图。编辑选项可用于事件所有者。
编辑事件页面	提供用于编辑事件的表单。

办公时间:微应用程序用于创建、查看和编辑虚拟办公时间。

通知或页面	用例的工作流
虚拟办公时间页面	允许用户查看办公时间。
创建办公时间页面	提供一个表单，可以根据用户的偏好安排虚拟办公时间，其中包含以下详细信息:办公时间的开始日期/时间、结束日期/时间、时区、重复(每天、每周、每月)、描述。
编辑办公时间页面	提供用于编辑办公时间的表单。