连接字符串类型

简介

可以使用多种类型的连接字符串。 本指南介绍不同的连接字符串类型。

文件

通过将连接字符串的 驱动程序 参数设置为{mvfile} ，可以将文件加载到表中。

driver={mvfile}

可以加载以下类型的文件：

• Excel 文件.xls和.xlsx
• 文本文件.csv 、 .tsv和.txt

可以指定其他参数来加载文件。

下面是可用或正在加载文件的通用参数的概述。

参数	描述
文件名	这可以是服务器上文件的相对路径，也可以是 HTTP URL。 当文件位于服务器上时，应将文件放置在“ 开发数据 ” 或“ 服务器数据 ” 选项卡中，并且必须相应地设置表格的“ 表格作用域 ”。 使用 HTTP URL 时，可以指定user和pass参数进行身份验证。
分机	默认情况下，文件扩展名用于确定文件类型，但这可以被覆盖。
用户	使用 HTTP URL 时远程文件的用户名。
通过	使用 HTTP URL 时远程文件的密码。

Excel 文件

下面概述了可用于加载 Excel 文件的其他参数。

参数	描述
工作表	要导入的工作表或命名范围。 对于工作表名称，应在末尾附加美元符号字符。 如果未指定，则加载第一个工作表。
第一列	要开始的第一列。 默认设置为 {autodetect}。
第一行	要开始的第一行。默认设置为 {autodetect}。

下表包含用于加载 Excel 文件的示例连接字符串。

连接字符串	正在加载...
'driver={mvfile}; filename=Data/Dataset.xlsx;'	Excel 文件的第一个工作表
'driver={mvfile}; filename=Data/Dataset.xlsx; sheet=MySheet$;'	名为“MySheet”的工作表

文本型文件

下面概述了可用于加载文本文件的其他参数。

参数	描述
含标头	文件的第一行是否为标题行。 默认设置为{true} 。
分隔符	分隔符。 默认设置为{tab} 。
报价	用于引用值的字符。 默认设置为{autodetect} 。
逃脱	用于对字符进行转义的字符。默认设置为 {none}。
编码	文件中使用的编码，例如 UTF8 或 LATIN1。 默认设置为{UTF8} 。

下表包含用于加载文本文件的示例连接字符串。

连接字符串	正在加载文本文件...
driver={mvfile}; filename=Textfile.txt; delim=,; quote=";'	使用逗号 (,) 分隔符和 " 引号
'driver={mvfile}; filename=Textfile.txt; delim=|; quote=";'	使用竖线 (|) 分隔符和 " 引号
"driver={mvfile}; filename=Textfile.txt; delim=9; quote=';"	使用制表符分隔符和 ' 引号
'driver={mvfile}; filename=Textfile.txt; delim=59; quote=none;'	带分号分隔符，不带引号
'driver={mvfile}; filename=Textfile.txt; delim=,; quote="; escape=\;'	使用逗号 (,) 分隔符、" 引号和 \ 转义字符
'driver={mvfile}; filename=http://www.example.com/files/example.txt;'	从网页服务器
'driver={mvfile}; filename=http://www.example.com/files/example.txt; User=Jane; mv-credential-Pass=example_com_credentials'	从具有基本访问身份验证的 Web 服务器

ODBC

ODBC 用于连接到外部数据源，通常是数据库。 您可以使用操作系统（例如 Microsoft Windows 中的 ODBC 数据源管理器）执行此操作，也可以直接提供正确格式的连接字符串。

ODBC 驱动程序可能需要查询才能执行。 可以在“ 查询 ” 字段中以字符串形式提供需要对数据库执行的查询。

重要提示： 测试 ODBC 连接时，请确保使用有效查询填充“ 查询 ” 字段。

注意：可以使用 ODBC 连接访问所有 64 位版本的数据库。必须在“UiPath Process Mining”服务器上安装所需的 64 位 ODBC 驱动程序，并且该服务器必须能够访问该特定系统。

下面概述了可用于 ODBC 连接的参数。

参数	描述
驱动程序	用于此连接的 ODBC 驱动程序。 使用'dsn'参数时不需要。
dsn	用于此连接的 ODBC DSN。使用 'driver' 参数时不需要。 注意： 设置要在连接字符串中使用的 DSN 时，请确保它是 64 位系统 DSN。
用户	用于连接到外部数据源的用户名。
通过	用于连接到外部数据源的密码。
其他	任何其他参数都将按照指定的方式传递给 ODBC 驱动程序。

下表包含 ODBC 连接的示例连接字符串。

连接字符串	连接...
'Driver={SQL Server Native Client 11.0};Server=SERVERNAME;Database=MyDatabase;'	到 SQL Server 数据库
'Driver={Oracle in OraClient12Home1};Dbq=MyTSN;'	到 Oracle 数据库
'DSN=MyDSN;用户=我的用户； “通行证”=“我的通行证”；	通过用户名和密码使用已配置的 DSN

“ 连接字符串 ”和“ 查询 ”字段都是表达式。 例如，可以创建到虚构数据库的连接字符串表。

请参见下图。

注意： 只有在加载表格后，才能使用表格中的数据。 在此示例中，需要“ 全局 ”表才能使用其他表中的数据。

技巧和窍门

有关其他系统的连接字符串格式，请咨询该系统的制造商，或咨询在线资源，例如 https://www.connectionstrings.com/。

如果有权访问数据库的用户是 Windows 用户，请确保此 Windows 用户：

• 是服务帐户，而不是实际用户。
• 具有 Process Mining 安装文件夹的读/写访问权限。
• 是运行脚本（例如，在计划任务中）以进行数据加载的用户。
• 用于在 IIS 中运行 应用程序池 。

SAP HANA

您可以使用 ODBC 连接来连接到 SAP HANA。

以下是 SAP HANA 的连接字符串示例。

'Driver={HDBODBC};User=MyUser;Pass=MyPass;ServerNode=MyServer:30015;DatabaseName=TDB1'

注意： 建议使用 SAP 连接字符串类型连接到 SAP 应用程序服务器，而不是连接到 SAP 数据库。

通用脚本

您可以使用连接字符串运行脚本，以从数据源加载数据。

重要提示： 要运行的脚本处理程序必须安装在 UiPath Process Mining 服务器上。

通过将连接字符串的 驱动程序 参数设置为{mvscript}并将 脚本 参数设置为“通用”，可以将文件加载到表中：

driver={mvscript}; script=generic

注意： 您必须使用 URL 编码在“ 查询 ” 字段中指定脚本参数。

下面概述了可以在“ 查询 ” 字段中指定的参数。

参数	描述	必填/可选
脚本文本	脚本的文本。	必需 注意： 仅当未使用scriptFile时。
scriptFile	要从中加载脚本的文件名。 这可以是服务器上文件的相对路径。 当文件位于服务器上时，应将文件放置在“ 开发数据 ” 或“ 服务器数据 ” 选项卡中，并且必须相应地设置表格的“ 表格作用域 ”。	必需 注意： 仅当未使用scriptText时。
输入数据	带有列标题的分号分隔文本，其中包含脚本的输入。 注意： csvtable函数可用于生成正确格式的数据。	必需
脚本类型	要使用的句柄名称，在“ 服务器设置”的GenericScriptHandlers设置中指定。 注意： 如果指定了scriptFile ，系统将根据文件扩展名自动检测到。	可选
参数	自定义要传递给脚本的参数。 这应该是 JSON 编码列表。 有两个特殊参数； '<SCRIPT>'和'<INPUT>' 。 出现的'<SCRIPT>'将替换为脚本文件的路径，出现的'<INPUT>'将替换为输入文件的路径。 这使您可以使用其他参数自定义对脚本处理程序的调用。 默认值为["<SCRIPT>", "<INPUT>"] 。	可选
debugPath	文件夹的绝对路径。 如果指定了此参数，则 UiPath Process Mining 将在此文件夹中输出输入文件（提供给外部流程）和外部流程的输出（从外部流程标准输出中读取），以进行调试。	可选

以下是简单查询的示例。

+'&scriptFile=' + urlencode("script.py")
+'&inputData='  + urlencode("a;b;c"+#10+"1;2;3"+#10+"4;5;6")

以下是更高级查询的示例。

+'&scriptText=' + urlencode(/* your script as text */)
+'&scriptType=' + urlencode("HandlerName")
+'&inputData='  + urlencode(csvtable(
    "Case_ID", jsontolist(InputData_Case_ID)
    "Amount" , jsontolist(InputData_Amount)
))
+'&args='       + urlencode(listtojson(["<SCRIPT>", "--filename", "<INPUT>"]))

另请参阅： 使用通用脚本数据源

SAP

SAP 连接字符串可用于连接到 SAP 应用程序服务器，例如 SAP R3、SAP ERP、SAP ECC 5.0、SAP ECC 6.0、S/4HANA。

重要提示： 必须在 UiPath Process Mining 服务器上安装SAP NWRFC库，才能使用连接字符串中的 SAP 数据源。

可以通过将连接字符串的 驱动程序 参数设置为{SAP}来加载 SAP 数据源。

driver={SAP}

下面概述了可用于 SAP 数据源的参数。

参数	描述	必填/可选
主机	SAP 应用程序服务器的主机名或 IP 地址。	必需
系统编号	用于标识指定实例的介于 00 和 99 之间的两位数字。	必需
功能模块	设置本机 SAP 提取时，需要 SAP Z_XTRACT_IS_TABLE 函数模块。例如，如果在 SAP 系统中重命名了此函数模块，则可以在 SAP 连接字符串的 FunctionModule 参数中指定正确的名称。FunctionModule参数 覆盖查询此表时使用的默认Z_XTRACT_IS_TABLE函数模块。	可选
用户名	用于登录 SAP 实例的帐户的用户名。	必需
通过	上述用户的密码。 可与凭据存储结合使用，在本例中使用mv-credential-pass 。	必需
客户端	正在使用的客户端。	必需
语言	登录时使用的语言。	必需

下面概述了可以在“ 查询 ” 字段中指定的参数。

参数	描述	必填/可选
表格	必须从中加载数据的 SAP 表名。 例如EKPO 。	必需
字段	将从table属性中指定的 SAP 表中检索的字段数组。 注意： 如果fields属性为空，则将检索所有字段。	必需
位置	用于检索表子集的where子句。	可选
limit	一个整数，用于指定要从表中检索的固定记录数。 注意： 如果limit设置为“0”，则没有限制。	可选

注意： SAP 中的每个字段都有长度。 出于性能原因，请确保已检索到的表的所有字段长度总和不超过 512。

以下是 SAP 连接字符串的示例。

'Driver={SAP};Host=10.10.10.10;SystemNumber=00;Username=MyUser;pass=secretPassword;client=100;Language=EN'

以下是一些示例查询。

查询	正在检索…
'table=' + urlencode("EKPO")	表EKPO的所有记录的所有字段。
'table=' + urlencode("EKPO") + '&fields=' + urlencode(listtojson(["MANDT", "EBELN"]))	EKPO表中所有记录的MANDT和EBELN字段。
'table=' + urlencode("EKPO") + '&where=' + urlencode("EBELN = 4500000001")	EKPO表中EBELN等于 4500000001 的所有字段。