从命令行运行数据采集本项目Running Data Extraction Projects from the Command Line

您可以使用RunProject.exe程序从命令行运行数据采集项目。这个程序位于Visual Web Ripper安装文件夹中。

如果一个数据采集项目位于默认的Visual Web Ripper项目文件夹中，您需要只提供项目名称作为输入参数:

RunProject.exe ProjectName

如果您的项目没有位于默认的Visual Web Ripper 项目文件夹中，您需要指定项目文件的完整路径:

RunProject.exe "C:\My Custom Folder Folder\ProjectName.rip"

当在批处理文件中运行多个项目时，您可以使用Start命令来异步地运行项目:

Start "WindowTitle" RunProject.exe ProjectName1
Start "WindowTitle" RunProject.exe ProjectName2

退出代码Exit Codes

Num	Codes	Description
0	Success	Data extraction was completed successfully.
1	Failed	A critical application error occurred during data extraction.
2	Incomplete	Data extraction was interrupted.
3	Completed with errors	Data extraction was completed, but with one or more page load errors or missing required elements.
4	Incomplete with errors	Data extraction was interrupted, and encountered one or more page load errors or missing required elements.
5	Export Failed	Data extraction failed because it was unable to export data. You can manually open Visual Web Ripper and ettempt to export data again from the Datra Export screen.

RunProject.exe 命令行程序返回下列退出代码之一。

Num	Codes	Description
0	Success	Data extraction was completed successfully.
1	Failed	A critical application error occurred during data extraction.
2	Incomplete	Data extraction was interrupted.
3	Completed with errors	Data extraction was completed, but with one or more page load errors or missing required elements.
4	Incomplete with errors	Data extraction was interrupted, and encountered one or more page load errors or missing required elements.
5	Export Failed	Data extraction failed because it was unable to export data. You can manually open Visual Web Ripper and ettempt to export data again from the Datra Export screen.

命令行参数Command Line Arguments

输入参数可以作为命令行参数添加。输入参数名必须前面有一个破号。例如:

RunProject.exe "C:\My Custom Folder Folder\ProjectName.rip" -username "test" -password "test"

命令行参数继续continue可用来恢复一个提前停止的数据提取项目。例如:

RunProject.exe "C:\My Custom Folder Folder\ProjectName.rip" continue

如果一个数据提取项目用一个或多个错误完成，那么可以使用命令行参数retry_error来重试错误。例如:

RunProject.exe "C:\My Custom Folder Folder\ProjectName.rip" retry_errors

项目所有者设置Project Owner Settings

Visual Web Ripper使用您的Windows用户设置来检索关于您的Visual Web Ripper文件的默认位置的信息。

当一个项目从命令行运行时，它可能是从一个没有任何Visual Web Ripper设置的用户环境中运行的第三方应用程序运行的。
一个数据提取项目包含了关于拥有这个项目的用户的信息，而Visual Web Ripper将会使用这些信息来定位默认的Visual Web Ripper文件夹。

您可以将项目的所有者设置为Visual Web Ripper 的项目菜单。

image.png

如果复制项目从一台电脑至另一台，命令行程序可能无法在新计算机上运行该项目，直到您将项目所有者设置为新计算机上的Windows用户。

您还可以直接将文档路径设置为命令行参数，而不是更改项目所有者。例如:

RunProject.exe ProjectName path "c:\Users\Jon\Documents\Visual Web Ripper"

项目所有者设置在运行数据提取项目时没有指定Windows安全上下文。该项目将在启动命令行程序的用户的安全上下文中运行。您必须确保运行命令行程序的用户能够访问计算机上所有必需的资源。例如，如果您的数据提取项目是在WebBrowser模式下运行的，那么用户必须能够启动Internet Explorer的实例。

多实例项目 Running Multiple Instances Of The Same Project

Visual Web Ripper命令行实用程序有时用于从网站应用程序启动数据提取项目。一个网站的应用程序可能有许多用户同时访问这个网站，他们可能同时启动相同的数据提取项目。通常情况下，Visual Web Ripper只能同时运行一个项目的实例，因为来自不同实例的数据将会混合在一起，结果将变得不可预测。

您可以使用数据提取方法会话数据Session Data来允许同一项目的多个实例同时运行。

image.png

下面的规则适用于带有数据提取方法会话数据Session Data的项目。

• 必须提供一个会话ID，您可以在命令行或通过API提供会话ID。下面的命令运行一个名为Sequentum的项目，使用会话ID 12。
  RunProject Sequentum session_id "12"
• 您永远不能使用相同的会话ID运行同一个项目的多个实例。
• 会话ID将被导出，因此您可以从一个特定的会话中识别数据。
• 内部数据只有在项目运行时才可用，所以在项目完成之后您不能查看内部数据。