连接到 SharePoint
概念信息
Microsoft SharePoint 是用于共享和管理组织内容和应用程序的 Web 协同平台。使用 SharePoint 数据连接器导入您的组织的 SharePoint 数据。
导入之前
仅表格式数据
Analytics 只能查询采取表格形式的 SharePoint 数据。下列条目无法从 Analytics 查询,因为它们未采取表格形式。
- 附件
- FileVersions
- GetValidTerms
- 权限
- 视图
不支持多因素认证
SharePoint 数据连接器无法从要求多因素认证的 SharePoint 账户访问数据。
已知问题:就日期时间域过滤
如果您在选中将日期时间转换至 GMT 选项的情况下导入您的数据,则不能就日期时间域进行过滤。如果您需要基于日期时间域进行过滤,请在导入之前清除此选项。
创建 SharePoint 连接
- 从 Analytics 主菜单中选择导入 > 数据库和应用程序Analytics。
- 从新建连接选项卡中,在 ACL 连接器部分中,选择 Sharepoint。
提示
您可以通过在过滤连接框中输入搜索字符串来过滤可用连接器的列表。连接器按字母顺序排列。
- 在数据连接设置面板中,输入连接设置,然后在面板底部单击保存并连接。
您可以接受默认的连接名称,也可以输入一个新的名称。
Sharepoint的连接被保存到现有连接选项卡。将来,您可以从已保存的连接重新连接到Sharepoint。
一旦连接被建立,“数据访问”窗口将打开到暂存区域,并且您可以开始导入数据。有关从Sharepoint导入数据的帮助,请参见使用数据访问窗口。
连接设置
基本设置
设置 | 描述 | 示例 |
---|---|---|
连接名称 | 您想要在 Analytics 中给予此连接的名称。 | Sharepoint |
主机 |
您要连接到的 SharePoint 站点。 将 URL 设置为站点集合可使用所有嵌套子站点中的所有列表和文档。将 URL 设置为特定站点只能使用该站点中的列表和文档。 |
https://teams.example.com/teamA |
用户 |
您的 SharePoint 用户名。 说明 |
jgibbons |
密码 |
您的 SharePoint 密码。 说明 |
MyStrongPasswordExample |
SharePoint 版本 | 所使用的 SharePoint 的版本。或者是 SharePoint Online,或者是 SharePoint On-Premise。 | Sharepoint Online |
使用 SSO |
当被设置为真时,将使用单点登录 (SSO) 以及通过用户和密码指定的账户向 SharePoint Online 进行认证。支持 Active Directory Federation Services (AD FS)、OneLogin 和 OKTA SSO。 如果在 SSO 域上配置的域不同于用户的域,则可能需要 SSO。 SSO 仅在使用 SharePoint Online 时适用。对于 SharePoint 的 On-Premise 版本,不支持 SSO。 |
假 |
认证方案 |
此域和密码及用户一起被用来向服务器进行认证。NTLM 是默认选项。请使用以下选项来选择您的认证方案:
|
NTLM |
高级设置
设置 | 描述 | 示例 |
---|---|---|
SSO 域 |
仅当使用单点登录(“使用 SSO”被设置为真)并且用户的域(例如,user@mydomain.com)不同于在 SSO 服务内配置的域(例如,user@myssodomain.com)时,此属性才适用。 使用 AD FS、OneLogin 或 OKTA SSO 时,可能需要此属性。 |
myssodomain.com |
将日期时间转换为 GMT | 在导入过程中将日期时间域转换至 GMT 时区。如果为假,则该日期时间值被转换为运行 Analytics 的计算机的操作系统时区。 | 真 |
限制密钥大小 |
在某些 ODBC 工具(例如,Microsoft Access)中,主键列的长度不能大于特定值。此属性使 ODBC 驱动程序覆盖所有主键列的报告长度。当使用 ODBC 驱动程序作为 Microsoft Access 链接数据源时,它尤其有用。 将“限制密钥大小”设置为 0 会使键长度恢复到原始长度。 |
255 |
映射到 Long Varchar |
此属性控制一个列是否被作为 SQL_LONGVARCHAR 返回。 某些应用程序要求将所有大于特定字符数的文本数据报告为 SQL_LONGVARCHAR。使用此设置可映射任何大于指定大小的列,以便使它们被报告为 SQL_LONGVARCHAR 而不是 SQL_VARCHAR。 |
-1 |
映射到 WVarchar |
此属性控制字符串类型是否映射到 SQL_WVARCHAR 而不是 SQL_VARCHAR。它在默认情况下被设置。 必须将字符串列映射到 SQL_WVARCHAR 以适应各种国际字符集,因此“映射到 WVarchar”默认情况下被设置为真。您可以将其设置为假以改而使用 SQL_VARCHAR。 |
真 |
伪列 |
指示是否将伪列作为列包括在表中。 此设置在 Entity Framework 中特别有用,它不允许您为伪列设置值,除非该列是表列。 您可以使用一个星号 (*) 来包括所有表和所有列。 |
|
大写标识符 |
设置此属性可以用大写形式报告所有标识符(包括表名称和列名称)。对于 Oracle 数据库而言,这是默认的,因而可以更好地与 Oracle 数据库网关之类的 Oracle 工具集成。例如,您可以使用此属性来避免引用标识符。 |
假 |
代理认证方案 |
用来向代理服务器进行认证的认证类型。 此值指定用来向由代理服务器和代理端口指定的 HTTP 代理进行认证的认证类型。 请注意,该驱动程序默认情况下将使用系统代理设置,而无需进一步的配置。如果您想要连接到另一代理,则除了设置代理服务器和代理端口以外,您还需要将“代理自动检测”设置为假。要进行认证,请设置代理认证方案,并且根据需要设置代理用户和代理密码。 认证类型可以是下列类型之一:
|
BASIC |
代理自动检测 |
这指示是否使用系统代理设置。将“代理自动检测”设置为假可使用自定义代理设置。这将优先于其他代理设置。 默认情况下,驱动程序使用系统 HTTP 代理。如果您想要连接到另一代理,请将此选项设置为假。 要连接到 HTTP 代理,请参见“代理服务器”。 |
假 |
代理用户 |
要用来向代理服务器进行认证的用户名。 代理用户和代理密码选项被用来连接在代理服务器中指定的 HTTP 代理以及向其进行认证。 您可以在代理认证方案中选择可用的认证类型之一。 如果您使用 HTTP 认证,请将此属性设置为 HTTP 代理所识别的用户的用户名。 如果您使用 Windows 或 Kerberos 认证,请将此属性设置为采用下列格式之一的用户名:
|
jgibbons@example.com |
代理密码 |
要用来向代理服务器进行认证的密码。 此属性被用来向支持 NTLM (Windows)、Kerberos 或 HTTP 认证的 HTTP 代理服务器进行认证。要指定 HTTP 代理,您可以设置代理服务器和代理端口。要指定认证类型,请设置代理认证方案。 如果您使用 HTTP 认证,请另外将代理用户和代理密码设置为 HTTP 代理。 如果您使用 NTLM 认证,请将代理用户和代理密码设置为您的 Windows 密码。您还可能需要使用它们来完成 Kerberos 认证。 默认情况下,驱动程序使用系统代理。如果您想要连接到另一代理,请将“代理自动检测”设置为假。 |
MyStrongPasswordExample |
代理服务器 |
要通过其路由 HTTP 流量的代理的主机名或 IP 地址。驱动程序可使用 HTTP、Windows (NTLM) 或 Kerberos 认证类型向 HTTP 代理进行认证。 默认情况下,驱动程序使用系统代理。如果您需要使用另一代理,请将“代理自动检测”设置为假。 |
127.168.192.10 |
代理端口 | 在其上运行 HTTP 代理以及您想要通过其重定向 HTTP 流量的端口。请在代理服务器中指定 HTTP 代理。 | 80 |
代理 SSL 类型 |
此属性确定何时对到代理服务器所指定的 HTTP 代理的连接使用 SSL。此值可以是 AUTO、ALWAYS、NEVER 或 TUNNEL。 自动默认设置。如果 URL 是 HTTPS URL,则该驱动程序将使用 TUNNEL 选项。如果 URL 是 HTTP URL,则该组件将使用 NEVER 选项。 ALWAYS 连接始终支持 SSL。 NEVER 连接不支持 SSL。 TUNNEL 连接是通过隧道代理建立的。代理服务器打开到远程主机的连接,并且通过代理传输流量。 |
自动 |
代理异常 |
将被免于通过代理服务器连接的主机或 IP 的分号分隔列表。 该代理服务器将被用于所有地址,但在此属性中定义的地址除外。 |
127.168.189.10; 127.168.188.11 |