Loading

命令行界面

您可通过命令行界面 (CLI) 打印作业。如果未在 CLI 中定义任何参数且作业经过页面编排:

  • 使用保存在作业中的打印设置打印作业。

  • 使用保存在作业中的打印机打印作业。

如果未在 CLI 中定义任何参数且作业未经过页面编排:

  • 将使用默认打印参数在默认打印机上打印作业。

CLI 的语法

[cmd /C] PRISMAprepare.exe "<路径\文件名>" 参数

您可以按任意顺序使用这些参数。下表指定了可用的参数。

表 1. 命令行界面

设置

说明

cmd /C

使用参数“cmd /C”可通过命令外壳程序同步启动“PRISMAprepare.exe”。默认情况下,“PRISMAprepare.exe”异步运行。

  • 使用“cmd /C”参数时:

    使用定义的参数执行“PRISMAprepare.exe”命令。将在[Command Prompt]中显示任何预检消息和自动化消息。在“PRISMAprepare.exe”命令结束时,可以再次使用命令行。

  • 不使用“cmd /C”参数时:

    使用定义的参数在后台执行“PRISMAprepare.exe”命令。不会在[Command Prompt]中显示任何消息。可以立即使用命令行。

注释

当您使用此参数时,将返回退出码。

PRISMAprepare.exe

必须在此应用程序的安装目录中执行命令“PRISMAprepare.exe”。

<路径\文件名>

作业的路径和名称。路径和名称必须用双引号引起来。例如:"C:\My Folder\My file.pdf"。

请参阅:支持的文件格式

注释

此设置是必备项。

/F

  • 使用“/F”参数时:

    在打开文档时,将应用预检。将使用为自动预检配置的规则。

  • 不使用“/F”参数时:

    在打开文档时,不会应用预检,即使在应用程序中启用了自动预检也是如此。

“/T”参数可以覆盖“/F”参数。

  • 如果仅指定了“/ T”参数,但其中的一个自动化模板包含带预检的操作:

    在模板中打开文档时,将应用预检。将使用为自动预检配置的规则。

  • 如果指定了“/ T”和“/F”参数,但任何自动化模板均不包含带预检的操作:

    在模板中打开文档时,不会应用预检,即使在应用程序中启用了自动预检也是如此。

/VDPS <VDP 源文件>

使用参数“/VDPS”可定义可变数据文档的数据源文件的路径和文件名。路径和名称必须用双引号引起来。例如:"C:\My Folder\My data source.xls"。

参数“/VDPS”可覆盖保存在主文档中的数据源文件。

如果使用参数“/T”和“/VDPS”,则会在应用模板之前将可变数据添加到文档中。

注释

*.xlsx*.xls*.csv 类型的数据源:如果数据源文件中有多个工作表可用,则使用第一个工作表。

*.accdb*.mdb 类型的数据源:如果数据源文件中有多个表或视图可用,则使用第一个表或视图。

有关详细信息,请参阅日志文件。

/VDPP <密码>

使用参数“/VDPP”可为 *.accdb*.mdb 类型的受密码保护的数据源提供密码。不支持 *.xlsx*.xls*.csv 类型的受密码保护的数据源。

密码必须用双引号引起来。

/VDPL <VDP 数据文件>

可以使用“/VDPL”参数定义可变数据文档的 [VDP] 数据文件的路径和名称。路径和名称必须用双引号引起来。例如:“C:\My Folder\My VDP data file.xml”。

  • 使用“/VDPS”参数:

    使用通过“/VDPS”参数定义的数据源文件,而不是在 [VDP] 数据中定义的数据源文件。

  • 使用“/T”参数:

    在应用模板之前,将 [VDP] 数据应用于文档。

/VDPV

可以使用“/VDPV”参数验证 [VDP] 数据。仅在应用其他 [VDP] 参数后才应用“/VDPV”参数。

/VDPSD <VDP 源文件详细信息>

可以使用“/VDPSD”参数定义必须使用数据源中的 Excel 工作表、Microsoft Access 表或 Microsoft Access 视图。必须用双引号将名称引起来。例如:"name"。

可以将“/VDPSD”参数与“/VDPS”参数结合使用。如果未使用“/VDPSD”参数,则使用数据源中的第一个 Excel 工作表、Microsoft Access 表或 Microsoft Access 视图(按字母顺序)。

如果数据源具有 *.csv 类型或未使用“/VDPS”参数,则忽略该参数。

/T

使用参数“/T”可向作业应用一个或多个自动化模板。将按定义的顺序应用模板。必须使用 "|" 分隔模板。模板名称区分大小写。

例如:/T "<Template1>|<Template2>|<Template3>"。

参数 '/T' 适用于下列限制:

  • 使用参数 '/T',且任何模板都不包含打印操作:

    未打印作业,即使在使用参数 '/C' 和/或 '/P' 时。

  • 使用参数 '/T',且一个或多个模板包含打印操作:

    参数 '/C' 将否决模板中定义的副本数。

    参数 '/P' 将否决模板中定义的打印机。

如果使用“/T”和“/I”参数,则会打开应用程序。将在应用程序中执行自动化模板。必须关闭应用程序才能继续执行“PRISMAprepare.exe”命令。

/TP <路径\文件名>

自动化模板的参数文件的路径和名称。路径和名称必须用双引号引起来。例如:"C:\My Folder\Parameter file.mrparam".

参数文件会应用于参数“/T”所指定的自动化模板列表。如果不使用“/T”,则会忽略参数文件。

/O <输出文件>

使用参数“/O”可定义输出文件的路径和文件名。在将模板应用到文档后创建输出文件。路径和名称必须用双引号引起来。

参数“/O”必须与参数“/T”组合使用。

/L <日志文件>

使用参数“/L”可定义日志文件的路径和文件名。所有错误、警告和信息消息都会记录在日志文件中。路径和名称必须用双引号引起来。

日志文件的文件名不能与文档文件或输出文件的文件名相同。

参数“/L”不能与参数“/I”组合使用。

/P <打印机名称>

定义打印时必须使用的打印机。

打印机名称必须用双引号引起来。例如:/P "Oce 970C v2.1"。指定的打印机将覆盖作业中保存的打印机。如果未指定 /P,则将使用作业中保存的打印机。

如果使用“/T”和“/P”参数,“/P”参数将覆盖模板中定义的打印机。

如果使用“/I”和“/P”参数,将会打开应用程序的 [生产] 工作区。将在 [生产] 工作区中选择“/P”参数定义的打印机。您可以定义打印设置。单击[打印] 按钮以继续执行“PRISMAprepare.exe”命令。

注释

定义打印机时,可将部分打印设置重设为默认值。这取决于打印机的功能。

/C <份数>

副本数在 1 到 65535 之间。定义的副本数将覆盖作业中保存的副本数。如果未定义 /C,则使用作业中保存的副本数。否则,仅打印一个副本。

如果使用“/T”和“/C”参数,“/C”参数将覆盖模板中定义的副本数。

与“/T”和“/TP”结合使用时,任何模板中记录的或“/C”中指定的副本数将被参数文件 (/TP) 中指定的副本数量所覆盖。

如果使用“/I”和“/C”参数,将会打开应用程序的 [生产] 工作区。将在 [生产] 工作区中使用“/C”参数定义的副本数。您可以定义打印设置。单击[打印] 按钮以继续执行“PRISMAprepare.exe”命令。

/SP

可以使用“/SP”参数生成校样 PDF。

校样 PDF 的默认路径和名称是:<Document folder>\<Document name>_ProofPDF.pdf.

可以使用 /SPO 参数更改校样 PDF 文件名。

使用 /SP 时,不会打印校样 PDF。但自动化模板请求打印校样 PDF 时除外。

在命令行中指定的打印机影响校样 PDF 结果。可能会产生以下影响:黑白或彩色内容、内嵌处理的修整表示形式、映射的介质。

在命令行(/ C 参数)中指定的份数将显示在校样 PDF 标题说明中。

在与 /T 结合使用时,将忽略 /SP 参数(只有在自动化模板中请求时,才会生成校样 PDF)。

/SPO <soft proof file name>

可以使用“/SPO”参数指定校样 PDF 文件名。

文件名可以包含以下特殊字符:

  • 日期戳 (%d)

  • 时间戳 (%t)

在 /O 参数中指定的可选路径不影响该默认值。

必须用双引号将文件名称引起来。例如:"name"。

如果命令行不包含通过 /SP 参数或模板 (/T) 提供的校样 PDF 请求,则会忽略该参数。

在与 /T 结合使用时,该参数覆盖在模板中定义的校样 PDF 文件名。

在与 /I 结合使用时,将在 CLI 命令打开的 “保存校样 PDF”对话框中建议该参数。

该参数不影响用户设置或后续的手动校样 PDF 请求。

/SPM <Metric | Imperial>

可以使用“/SPM”参数指定在生成校样 PDF 时使用的度量系统。

该参数后跟 Metric 或 Imperial 值之一。这些字符串不区分大小写。如果未指定,则使用默认校样 PDF 度量系统。

如果命令行不包含通过 /SP 参数或模板 (/T) 提供的校样 PDF 请求,则会忽略该参数。

在与 /T 结合使用时,该参数覆盖在模板中定义的度量系统。

在与 / I 结合使用时,该参数专用于通过当前命令行请求的校样 PDF。

该参数不影响用户设置或后续的手动校样 PDF 请求。

/SPR <DPI72 | DPI300>

可以使用“/SPR”参数指定在生成校样 PDF 时使用的分辨率。

该参数后跟 DPI72 | DPI300 值之一。这些字符串不区分大小写。如果未指定,则使用默认校样 PDF 分辨率。

如果命令行不包含通过 /SP 参数或模板 (/T) 提供的校样 PDF 请求,则会忽略该参数。

在与 /T 结合使用时,该参数覆盖在模板中定义的分辨率。

在与 / I 结合使用时,该参数专用于通过当前命令行请求的校样 PDF。

该参数不影响用户设置或后续的手动校样 PDF 请求。

/SPL <CZ | DK | DE | GB | US | ES | FI | FR | HU | IT | JP | NO | NL | PL | PT | RU | SE | CHZ>

可以使用“/SPL”参数指定在生成校样 PDF 时使用的语言。

该参数后跟 CZ、DK、DE、GB、US、ES、FI、FR、HU、IT、JP、NO、NL、PL、PT、RU、SE 或 CHZ(捷克语、丹麦语、德语、英式英语、美式英语、西班牙语、芬兰语、法语、匈牙利语、意大利语、日语、挪威语、荷兰语、波兰语、葡萄牙语、俄语、瑞典语或中文)值之一。这些字符串不区分大小写。如果未指定,则使用默认校样 PDF 语言。

如果命令行不包含通过 /SP 参数或模板 (/T) 提供的校样 PDF 请求,则会忽略该参数。

在与 /T 结合使用时,该参数覆盖在模板中定义的语言。

在与 / I 结合使用时,该参数专用于通过当前命令行请求的校样 PDF。

该参数不影响用户设置或后续的手动校样 PDF 请求。

/SPB <背景图像>

可以使用“/SPB”参数指定在生成校样 PDF 时使用的背景图像。

该参数后跟包含背景图像的文件的完整路径。支持的文件类型是 tif、tiff、jpg、jpeg、bmp、gif 和 png。如果未指定,则使用默认背景图像。

必须用双引号将路径引起来。例如:"C:\My Folder\images"。

如果命令行不包含通过 /SP 参数或模板 (/T) 提供的校样 PDF 请求,则会忽略该参数。

在与 /T 结合使用时,该参数覆盖在模板中定义的背景图像。

在与 / I 结合使用时,该参数专用于通过当前命令行请求的校样 PDF。

该参数不影响用户设置或后续的手动校样 PDF 请求。

/SPN <说明文本>

可以使用“/SPN”参数指定在生成校样 PDF 时使用的说明文本。

该参数后跟与说明文本对应的字符串。如果未指定,则说明为空。必须用双引号将文本引起来。例如:"文本"。

如果命令行不包含通过 /SP 参数或模板 (/T) 提供的校样 PDF 请求,则会忽略该参数。

在与 /T 结合使用时,该参数覆盖在模板中定义的说明。

在与 / I 结合使用时,该参数专用于通过当前命令行请求的校样 PDF。

该参数不影响用户设置或后续的手动校样 PDF 请求。

/SPVDP

可以使用“/SPVDP”参数为所有可变数据文档生成校样 PDF。如果未指定该参数,则仅为第一个可变数据文档生成校样 PDF。

/I

使用参数“/I”可打开此应用程序。可在应用程序中编辑作业。

可以将“/I”参数与其他参数组合使用。有关详细信息,请参阅参数说明。

/Finishing

使用参数“修整”近线出纸处理器创建一个 JDF 修整票证。

参数后面可以跟一个修整流程的名称。必须用双引号将名称引起来。例如:"name"。如果使用的参数不包含修整流程的名称,则使用文档中定义的出纸处理器。即使在打印设置或自动化模板中定义了修整流程,也会使用文档中定义的出纸处理器。

此参数必须与打印命令“/P”或自动化模板中记录的打印命令配合使用。如果未使用打印命令,则此参数会被忽略。

与此参数一起使用的修整流程名称将覆盖打印设置和自动化模板中的修整流程。

示例

  • PRISMAprepare.exe "C:\Temp\10pages.pdf" /I

    应用程序将打开。可以编辑作业。

  • PRISMAprepare.exe "C:\Temp\10pages.pdf" /C 5 /I

    应用程序将打开。[生产] 工作区将打开。选定保存在作业中的打印机。副本数为 5。定义打印设置并打印作业。

  • PRISMAprepare.exe "C:\Temp\10pages.pdf" /P "Oce 970C v2.1" /C 50

    在定义的打印机上打印 50 份文档。使用 PDF 文件中保存的其他打印设置。

  • PRISMAprepare.exe "C:\Temp\10pages.pdf" /T "MonthlyReport|CiceroPrint" /P "Oce VP6250" /C 50

    将“MonthlyReport”模板应用于文档。然后,将“CiceroPrint”模板应用于文档。打印 50 份并使用定义的打印机。不使用模板中定义的打印机和副本数。

  • PRISMAprepare.exe "C:\Temp\10pages.pdf" /VDPL "C:\My Folder\My VDP data file.xml" /VDPV /I

    应用程序将打开。“My VDP data file.xml”文件中存储的 [VDP] 数据应用于“10pages.pdf”文档。将验证 [VDP] 数据。可在应用程序中编辑作业。

退出码

设置

说明

0

操作成功。

1

执行出错。

2

找不到文件。

3

找不到路径。

4

无法打开文件。

5

访问被拒绝。

111

文件名太长。

1056

应用程序已在运行。

30000

许可证无效。

30001

许可证服务器包含无效的浮动型许可证。

30002

许可证服务器出现连接错误。无法检索浮动型许可证。

30003

许可证服务器出现错误。无法检索浮动型许可证。

30004

许可证已过期。

30005

已达到此浮动型许可证的最大用户数。

30009

版本不正确。

40000

将会执行自动化模板。并报告一个或多个警告。

50000

没有要保存的文件。

50001

文件不存在

50002

您的权限不足,无法执行此操作。

50003

脚本存在语法错误。

50004

自动化许可证功能不可用。

50005

一般错误。

50010

模板文件未知。

50011

在命令行界面中多次使用了某个参数。

50020

不支持某一参数。

50021

某一参数的值不正确。

50022

出纸处理器未知。

50023

页面编排设置无法应用。

50030

自动化模板的参数文件中的语法错误。

50031

自动化模板的参数文件包含无效的指令。

50032

自动化模板的参数文件中的指令包含无效的参数。

50033

自动化模板的参数文件中的指令包含无效的参数值。

50034

自动化模板的参数文件使用无效的编码。编码必须为 UTF-8。

50035

找不到自动化模板的参数文件。

50036

无法读取自动化模板的参数文件。

50037

自动化模板的参数文件的扩展名必须是“*.mrparam”。

50080

无法访问输出文件。

50099

无法恢复的错误。无法记录或重放脚本。