如何使用 App ConnectMicrosoft SharePoint

Microsoft SharePoint 是一个协作平台,提供文档管理和存储系统功能。 App Connect 兼容 SharePoint 在线版 (基于云的服务)和 SharePoint 软件 (本地部署的 SharePoint 服务器)。

以下信息介绍了如何使用 App ConnectMicrosoft SharePoint 连接到其他应用程序。

支持的产品和应用程序接口版本

要了解此连接器支持哪些产品和API版本,请参阅 IBM 支持页面上的详细系统要求

首先需要考虑什么

在使用 App Connect Designer 和 Microsoft SharePoint 之前,请注意以下事项:

  • 若要通过 SAML 验证来验证与 SharePoint Online的连接,请注意 App Connect 不支持双因素认证。 在使用您的 Microsoft SharePoint 帐户访问 App Connect 之前,请确保已为该帐户关闭双因素身份验证。
  • Microsoft SharePoint 连接器无法用于访问个人网站集合。 要处理个人网站集合,您可以使用 Microsoft OneDrive for Business连接器。

连接到 Microsoft SharePoint

App Connect Designer的 "连接 > 应用程序和API" 页面(原" 目录" 页面) 或流程编辑器中,填写您看到的连接字段。 如有必要,请与 Microsoft SharePoint 管理员合作获取这些值。

要从 App Connect 创建与 Microsoft SharePoint 账户的连接,请完成以下步骤。

  1. 使用以下选项之一打开 " 连接到 Microsoft Sharepoint "对话框:
    • 要首次连接 Microsoft SharePoint ,请单击连接
    • 要添加另一个 Microsoft SharePoint 连接,请展开账户列表并单击添加新账户
  2. “连接到 Microsoft SharePoint ”对话框中,选择要连接的相应类型
    • 选择 SharePoint Online ,连接到 Microsoft SharePoint 基于云的服务。
    • 选择 SharePoint 软件 ,连接到 Microsoft SharePoint 服务器。
  3. 如果选择 SharePoint Online ,请选择授权方式
    授权方法 连接字段 描述
    基本用户权限 应用程序客户端 ID 在 Microsoft Azure 应用注册后生成的唯一标识符,用于将请求与特定项目关联
    应用程序客户机密钥 为特定项目创建的唯一应用程序客户端 ID 的应用程序客户端秘密
    Oauth 访问令牌 由应用程序客户端ID和应用程序客户端密钥生成的访问令牌
    OAuth 刷新令牌 由应用程序客户端ID和应用程序客户端密钥生成的刷新令牌
    SharePoint 在线 URL SharePoint 在线 URL 提供直接登录 Microsoft SharePoint 服务的功能;例如: https://anyorganization.sharepoint.com
    提示: 若您在同一浏览器窗口中登录了 Microsoft SharePointApp Connect , App Connect 将自动建立连接。
    注意:Microsoft SharePoint 连接器中,基于 SAML 的身份验证已弃用。 要继续使用该连接器,请配置其中一种受支持的身份验证类型。
    SAML
    限制: 若要通过 SAML 验证来验证与 SharePoint Online的连接,请注意 App Connect 不支持双因素身份验证。 在使用您的 Microsoft SharePoint 帐户访问 App Connect 之前,请确保已为该帐户关闭双因素身份验证,或者选择 “使用网站 ( OAuth2 ) ”选项。
    SharePoint 在线 URL SharePoint 在线 URL 提供直接登录 Microsoft SharePoint 服务的功能;例如: https://anyorganization.sharepoint.com
    提示: 若您已在同一浏览器窗口登录 Microsoft SharePoint ,则 App ConnectApp Connect 可自动建立连接。
    网站收集路径 站点集合 URL 在 SharePoint 中相对于 SharePoint 的位置为 URL;例如 /TeamSite ,或 /sites/mysitecollection
    用户名 您的 Microsoft SharePoint 帐户的用户名
    密码 Microsoft SharePoint 帐户的密码
    oauth 2.0 auth code SharePoint 在线 URL SharePoint 在线 URL 提供直接登录 Microsoft SharePoint 服务的功能;例如: https://anyorganization.sharepoint.com
    提示: 若您已在同一浏览器窗口登录 Microsoft SharePoint ,则 App ConnectApp Connect 可自动建立连接。
  4. 如果选择 SharePoint 软件 ,请选择版本 ,然后选择授权方法
    授权方法 连接字段 描述
    基本 SharePoint 主机和端口 SharePoint 本地部署的Web应用程序 URL ,该应用程序提供直接登录Microsoft SharePoint 服务的入口;例如: https://mysharepointhost:8443
    网站收集路径 站点集合 URL 在 SharePoint 中相对于 SharePoint 的位置为 URL;例如 /TeamSite ,或 /sites/mysitecollection
    用户名 您的 Microsoft SharePoint 帐户的用户名
    密码 Microsoft SharePoint 帐户的密码
    专用网络连接 选择用于连接到您的专用网络的专用网络代理名称。 App Connect 的名称。 该列表由在专用网络页面上创建的专用网络代理名称填充。 有关更多信息,请参阅连接到专用网络
    请注意在容器化环境中已不再使用基于 NTLM 的身份验证。
    NTLM v1
    SharePoint 主机和端口 SharePoint 本地部署的Web应用程序 URL ,该应用程序提供直接登录Microsoft SharePoint 服务的入口;例如: https://mysharepointhost:8443
    网站收集路径 站点集合 URL 在 SharePoint 中相对于 SharePoint 的位置为 URL;例如 /TeamSite ,或 /sites/mysitecollection
    用户名 您的 Microsoft SharePoint 帐户的用户名
    密码 Microsoft SharePoint 帐户的密码
    您用于登录本地部署的 SharePoint 账户的域名
    工作站 安装 SharePoint 的工作站或服务器名称
    专用网络连接 选择用于连接到您的专用网络的专用网络代理名称。 App Connect 的名称。 该列表由在专用网络页面上创建的专用网络代理名称填充。 有关更多信息,请参阅连接到专用网络
  5. 单击继续

要获取 Microsoft SharePoint 的连接值,请参阅获取 Microsoft SharePoint 的连接值

提示:

在流程中使用 App Connect 中创建的账户之前,请将其重命名为有意义的名称,以便于识别。 要在 "应用程序和 API " 页面上重命名账户,请选择账户,打开其选项菜单 (⋮),然后单击 " 重命名账户 "。

要首次从 App Connect Designer 应用程序和 API 页面连接到 Microsoft SharePoint 端点,请展开 Microsoft SharePoint ,然后单击连接更多信息,请参阅管理账户

一般注意事项

在使用 App Connect Designer 和 Microsoft SharePoint 之前,请注意以下一般注意事项:

  • (一般考虑)您可以在 App Connect Designer应用程序和 API 页面上查看可用的触发事件和操作列表。

    对于某些应用,事件和操作取决于环境以及连接器是否支持可配置事件和动态发现操作。 如果应用程序支持可配置事件,您会在事件列表下看到“ 显示更多可配置事件” 链接。 如果应用程序支持动态发现操作,您会在操作列表下看到 “显示更多” 链接。

  • (一般注意事项)如果某个应用程序使用多个账户,不同账户在为该应用程序选择操作时显示的字段集可能不同。 在流程编辑器中,某些应用程序总是为某个操作提供一组经过编辑的静态字段。 其他应用程序使用动态发现功能来检索所连接实例上配置的字段集。 例如,如果一个应用程序的两个实例有两个账户,第一个账户可能会使用可立即使用的设置。 不过,第二个账户可能配置了额外的自定义字段。

岗位连接注意事项

  • (限制) 当您使用列表项目对象中的操作时,可在 App Connect 中查看以下列类型:
    • 整数
    • 文本
    • 日期和时间
    • 选择
    • 布尔值
    • 数量
    • 货币
    • 超链接
    • 已计算
    • GUID
    • 多项选择
    • 已计算

事件和行动

微软 SharePoint 活动

这些事件用于处理本应用程序中的更改,这些更改会触发流程开始完成流程中的操作。

注意: 在容器中,这些事件只能使用本地账户。

显示更多可配置事件 :默认显示的事件是通过使用优化连接预先配置的。 配置可通过轮询此应用程序以获取新对象或更新对象来触发流程的事件后,可使用更多项目。

Microsoft SharePoint 行动

您的流程将在此应用程序上完成这些操作。

对象 操作 描述
文件 创建文件 在 SharePoint 中创建一个文件
删除文件 从 SharePoint 中删除文件
下载文件 下载文件
重命名文件 重命名文件
检索文件 从 SharePoint 检索文件
共享文件 与其他用户或组共享文件
更新文件 更新文件内容
文件夹项 检索文件夹项目 从 SharePoint 检索文件夹项目
文件夹 创建文件夹 在 SharePoint 中创建一个文件夹
删除文件夹 从 SharePoint 中删除一个文件夹
检索文件夹 从 SharePoint 检索文件夹
更新文件夹 更新文件夹的欢迎页面
列表项附件 创建列表项附件 在 SharePoint 中创建列表项附件
删除列表项附件 从 SharePoint 中删除一个列表项
下载列表项附件 下载列表项附件
检索列表项附件 从 SharePoint 检索列表项附件
更新列表项附件 更新列表项附件的内容
列表项 创建列表项 在 SharePoint 中创建列表项
删除列表项 从 SharePoint 中删除一个列表项
检索列表项 从 SharePoint 检索列表项
更新列表项 更新 SharePoint 中的列表项
列表 创建列表 在 SharePoint 中创建一个列表
删除列表 从 SharePoint 中删除一个列表
检索列表 从 SharePoint 检索列表
更新列表 更新 SharePoint 中的列表
许可权 检索权限 检索 SharePoint 站点的权限
搜索 搜索文件 在 SharePoint 中搜索文件
共享链接 检索共享链接 从 SharePoint 检索共享链接
站点 删除站点 从 SharePoint 中删除站点
检索站点 从 SharePoint 检索站点
更新站点 更新 SharePoint 中的站点
用户 检索用户 从 SharePoint 检索用户

示例

使用 Micrososft Sharepoint 的模板的仪表板磁贴
使用 Micrososft Sharepoint 的模板的仪表板磁贴
使用 Micrososft Sharepoint 的模板的仪表板磁贴

使用模板快速创建 Microsoft SharePoint 流程

了解如何使用 App Connect 模板来快速创建可在 Microsoft SharePoint 上完成操作的流程。 例如, 前往“ 探索”页面并搜索 Microsoft Sharepoint

使用 Micrososft Sharepoint 的模板的仪表板磁贴