命令行参数和配置文件键

本节中的表介绍可在批处理客户端中使用的命令行参数和配置文件键。

表 17-1 常规命令

键 参数 说明 必需

Operation

/op=

指定要执行的操作：

Y

UserName

/u=

指定用于登录的 Oracle Data Relationship Management 用户名。

Y

Password

/pw=

指定用于登录的 Data Relationship Management 密码。

Y

URL

/url=

指定 Data Relationship Management 服务器进程中的引擎应用程序的 URL（包括端口号）。此 URL 已经配置，可从 Data Relationship Management 配置控制台中获取。例如，net.tcp://localhost:5210/Oracle/Drm/Engine

Y

LogFileName

/log=

指定日志文件的路径和文件名。如果文件存在，则将日志附加到现有文件的末尾。建议您将值括在双引号中。

警告：要同时运行多个批处理客户端进程，必须为每个进程指定一个唯一日志名称。

注意：如果将 /log 参数置于有问题的参数（例如缺少值或具有无效值的参数）之后，则无法创建指定的日志文件。要确保创建指定的日志文件，应将 /log 参数作为第一个参数放置。

如果未指定，则使用以下名称：DRM_Batch_ClientMMDDYYYY.log，其中 MM = 月份，DD = 日期，YYYY = 年份。

N

不适用

/cfgfile=

指定说明所需选项的配置文件的路径和文件名。建议您将值括在双引号中。

Y（如果使用的是配置文件）

不适用

/h[elp] | /?

显示命令行参数的列表。

N

TimezoneOffset

/timezoneid

与 GMT 的本地分钟偏差。例如 U.S. CST 与 GMT 的偏差分钟数为 -360。用于在输出中显示日期/时间。

默认值为服务使用的语言设置。

N

CultureName

/culturename

本地语言设置名称，格式为：languagecode-country/regioncode，其中 languagecode 是派生自 ISO 639-1 的小写的两个字母代码，country/regioncode 是派生自 ISO 3166 的大写的两个字母代码。例如美国英语为 en-US。

影响输入数据的语言和格式设置。语言专门适用于批处理客户端记录的参考消息和错误消息。文化控制导出等操作中输出内容的日期/时间/浮点格式设置。该参数具有备用值，备用值的默认值基于针对服务用户指定的 Data Relationship Management 应用程序文化设置以及 Data Relationship Management 主机服务器语言和文化设置。

N

ObjectAccess

/objectaccess

用于访问导入、导出和混合器对象的对象访问方法。有效值为 Standard、System 或 User，或者自定义组。

默认值为 Standard。

N

InstanceID

/instanceid=

指定在将多个应用程序配置为使用 drm-batch-client-credentials.exe 功能时要使用的应用程序的 InstanceID。

Y（如果将多个应用程序配置为使用 drm-batch-client-credentials.exe 功能）。

表 17-2 操作脚本

键 参数 说明 必需

InFile

/infile=

指定输入文件的路径和文件名。建议您将值括在双引号中。

Y

Delimiter

/delim=

指定分隔符。请指定下列值之一：

  • 制表符

  • 逗号

  • #nnn

其中，#nnn 代表任何有效的 3 位 ASCII 字符值 (0–255)。

默认值为制表符。

N

ColumnOrder

/cols=

指定列顺序。如果提供，则必须包含所有列标识符。默认值为 A12345。

N

StripQuotedStrings

/stripq=

指定是否删除带引号的字符串。请指定下列值之一：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

默认值是 True。

N

PropertyRefByLabel

/propertyrefbylabel

要按标签（而不是名称）查找属性引用，请指定以下值之一：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

默认值为 True。

N
Encoding

/encoding

作为编码名称或编码代码页编号的输入文件字符编码。此参数为可选。

默认值为 UTF8。

N

表 17-3 将版本备份到文件

键 参数 说明 必需

VersionAbbrev

/vabbrev=

指定要备份的版本的名称；如果存在多个版本，则使用 /delim 分隔。

Y

Connection

/conn=

指定外部连接的名称。

Y

Filename

/filename=

指定要使用外部连接 (/conn) 创建的备份文件的名称。

Y

Delimiter

/delim=

可打印的分隔符。使用单个字符，例如冒号 (:)、逗号 (,)、短划线 (-) 等等。

N（vabbrev 为版本列表时除外）

表 17-4 混合

键 参数 说明 必需

BlendName

/bl=

指定要运行的混合器名称。

Y

SourceVersionAbbrev

/sver=

指定要混合的源版本的名称。

Y

TargetVersionAbbrev

/tver=

指定要混合的目标版本的名称。

Y

NewVersionAbbrev

/nvera=

指定要创建的新版本的名称。

N

NewVersionDescription

/nverd=

指定新版本的说明。值必须括在双引号中。

N

AutoSave

/save=

指定是保存混合的版本还是将其保留为分离状态。请指定下列值之一：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

默认值为 False。有关保存版本的信息，请参阅“示例 17-2”。

N

BlendLogFileName

/blendlog=

指定混合日志文件的名称（与批处理客户端日志文件不同）。默认值存储在混合配置文件中。

Y

RunTimeParameters

不适用

指定逗号分隔的运行时参数列表。格式示例：RuntimeParameters=City=Dallas,State=Texas,ZipCode=75234。

如果值包含逗号、特殊字符或双引号之类的分隔符，请将值括在双引号中。

注意：值中不允许有 [CR/LF]、[CR] 和 [LF]。

N

表 17-5 关闭版本

键 参数 说明 必需

VersionAbbrev

/abbrev=

指定要关闭的版本的名称。

Y

表 17-6 删除版本

键 参数 说明 必需

VersionAbbrev

/vabbrev=

指定要删除的版本的名称。

Y

表 17-7 导出

键 参数 说明 必需

ExportType

/xtype

指定导出类型：单个导出或集。请指定下列值之一：

  • E[xport]

  • B[ook]

Y

ExportName

/xname=

指定要运行的已保存导出的名称。

Y（如果运行的是单一报表）

OutFile

/outfile=

对于配置为输出到客户端文件的导出，此参数指定输出文件的路径和文件名。如果输出文件存在，则将其覆盖。建议您将值括在双引号中。如果指定了此参数并且导出配置为将输出发送到外部服务器连接，则此参数覆盖外部服务器连接，并且导出将写入此处指定的文件。

Y

CurrentVersionAbbrev

/cver=

指定当前版本的名称。如果未指定，则系统使用 DefaultCurrentVersion 系统首选项的值。

Y（未随导出保存版本变量时）

PrevVersionAbbrev

/pver=

指定上一版本的名称。用于层次比较和层次差异导出。如果未指定，则系统使用 DefaultPreviousVersion 系统首选项的值。

Y（适用于比较导出和差异导出并且未随导出保存版本变量的情况）

CurrentVersionType

 /cvertype=

指定当前版本的版本类型。有效值包括：

  • A[s Of]

  • N[ormal]

默认值为 N[ormal]。

N

PrevVersionType

 /pvertype=

指定上一版本的版本类型。有效值包括：

  • A[s Of]

  • N[ormal]

默认值为 N[ormal]。

N

CurrentAsOfDate

 
                           /casofdate=

指定为导出创建当前版本的截止版本时要使用的截止日期/时间。

注意：日期/时间格式由客户端计算机上的区域设置确定。

Y（版本类型为 AsOf 时）

PrevAsOfDate

 
                           /pasofdate=

指定为导出创建上一版本的截止版本时要使用的截止日期/时间。

注意：日期/时间格式由客户端计算机上的区域设置确定。

Y（版本类型为 AsOf 时）

BookName

/bk=

指定要运行的已保存集的名称。建议您将值括在双引号中。

Y（导出集时）

CombineExportOutput

/bkcmb=

指定是否将导出输出合并到 /outfile 或 OutFile 中指定的文件。请指定下列值之一：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

如果此参数为 False，每个导出都保存在其导出配置文件中存储的文件名中。导出配置文件中的文件名无效或输出设置为非文件值的导出都合并到 /outfile 或 OutFile 中指定的文件中。默认值存储在集中。

N

PreFileName

/prefile=

指定要置于合并导出集之前的路径和文件名。默认值存储在集中。

N

PostFileName

/pstfile=

指定要置于合并导出集之后的路径和文件名。默认值存储在集中。

N

FromHierarchy

/fhier=

指定“自”（上一个）层次。用于层次比较和层次差异导出。

N

ToHierarchy

/thier=

指定“至”（当前）层次。用于层次比较和层次差异导出。

N

FromTopNodeAbbrev

/fabbrev=

指定“自”（上一个）层次的顶级节点的名称。用于层次比较和层次差异导出。

N

ToTopNodeAbbrev

/tabbrev=

指定“至”（当前）层次的顶级节点的名称。用于层次比较和层次差异导出

N

Hierarchy n

/hier=

指定要导出的层次的名称，其中 n 是标识当前层次/顶级节点对（例如 TopNodeAbbrev1）的数字（1 到 HierarchyCount）。必须与 Hierarchyn 匹配。用于层次导出和其他类似的导出，但是不用于层次比较和层次差异导出。

N

TopNodeAbbrev n

/nabbrev=

指定要导出的顶级节点的名称，其中 n 是标识当前层次/顶级节点对（例如 TopNodeAbbrev1）的数字（1 到 HierarchyCount）。必须与 Hierarchyn 匹配。用于层次导出和其他类似的导出，但是不用于层次比较和层次差异导出。

N

Encoding

/encoding

作为编码名称或编码代码页编号的文件字符编码。此参数为可选。

如果指定了编码，则它会覆盖随正在运行的导出或集保存的编码。指定的编码还会应用于批处理客户端的可用本地处理前文件和处理后文件选项。

注意：如果运行的是集，则编码不会覆盖集内导出的编码，它仅覆盖集本身的编码设置。

默认值为 UTF8。

N

HierarchyCount

/hier

指定定义的层次/顶级节点对的数量。

N

HierarchyGroupPropFromParam

不适用

指定是否从参数或指定的层次组属性中获取层次组属性名称。请指定下列值之一：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

如果为 True，则指定 HierarchyGroupProperty 的参数名称，如果为 False，则指定 HierarchyGroupProperty 的层次组属性名称。默认值为 False。

N

HierarchyGroupProperty

不适用

指定参数名称或层次组属性名称。如果 HierarchyGroupPropFromParam 为 True，则需要参数名称；如果为 False，则需要层次组属性名称（包括其命名空间）。

N

HierarchyGroupFromParam

不适用

指定是否从参数或指定的层次组中获取层次组值。请指定下列值之一：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

如果为 True，则指定 HierarchyGroup 的参数名称；如果为 False，则指定 HierarchyGroup 的层次组名称。默认值为 False。

N

HierarchyGroup

不适用

指定参数名称或层次组名称。如果 HierarchyGroupFromParam 为 True，则需要参数名称；如果为 False，则需要层次组名称。

N

RunTimeParameters

不适用

指定逗号分隔的运行时参数列表。格式示例：RuntimeParameters=City=Dallas,State=Texas,ZipCode=75234。

如果值包含逗号、特殊字符或双引号之类的分隔符，请将值括在双引号中。

注意：值中不允许有 [CR/LF]、[CR] 和 [LF]。

N

FromDate

/fdate=

指定事务日志导出的开始日期/时间

注意：日期/时间格式由客户端计算机上的区域设置确定。

N

ToDate

/tdate=

指定事务日志导出的结束日期/时间

注意：日期/时间格式由客户端计算机上的区域设置确定。

N

表 17-8 导入

键 参数 说明 必需

InFile

/infile=

对于配置为从客户端文件导入的导入，此参数指定输入文件的路径和文件名。建议您将值括在双引号中。

警告：请勿将此参数用于配置为使用来自外部服务器连接的输入文件的导入，否则会发生错误。

Y（从客户端文件导入时）

ImportAbbrev

/iabbrev=

指定要运行的导入的名称。

Y

ImportLogFileName

/implog=

指定导入日志文件的路径和文件名（与批处理客户端日志文件不同）。默认文件名为 DRM_Batch_ClientMMDDYYYY.log，其中 MM = 月份，DD = 日期，YYYY = 年份。

Y

VersionAbbrev

/vabbrev=

指定导入要创建的版本名称。默认值存储在导入配置文件中。

N

VersionDescription

/vdescr=

指定导入要创建的版本的说明。默认值存储在导入配置文件中。

N

AutoSave

/save=

指定是保存导入的版本还是将其保留为分离状态。请指定下列值之一：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

默认值为 False。有关保存版本的信息，请参阅“示例 17-2”。

N

RunTimeParameters

不适用

指定逗号分隔的运行时参数列表。格式示例：RuntimeParameters=City=Dallas,State=Texas,ZipCode=75234。

如果值包含逗号、特殊字符或双引号之类的分隔符，请将值括在双引号中。

注意：值中不允许有 [CR/LF]、[CR] 和 [LF]。

N

表 17-9 Multiple

键 参数 说明 必需

OperationCount

不适用

指定文件中操作节的数量。指定一个大于 0 的整数。

Y

OperationN

不适用

指定操作节的标签，其中 N 是介于 1 和 OperationCount 值之间的数字。

Y

表 17-10 打开版本

键 参数 说明 必需

VersionAbbrev

/vabbrev=

指定要打开的版本的名称。

Y

表 17-11 刷新版本

键 参数 说明 必需

VersionAbbrev

/vabbrev=

指定要刷新（关闭并重新打开）的版本的名称。

Y

表 17-12 Request

键 参数 说明 必需

WorkflowModel

/WorkflowModel=

指定工作流模型的名称

Y

RequestTitle

/RequestTitle=

指定请求标题

Y

Version

/vabbrev=

指定版本的名称

Y（如果在工作流模型上未指定版本变量）

WorkflowTask

/WorkflowTask=

指定工作流任务的名称。必须是分配到请求的“提交”阶段的任务。

Y

Hierarchy

/hier=

指定层次的名称。

Y（如果未默认为使用层次组）

Connection

/conn=

指定外部连接的名称。必须指可通过批处理客户端用户的对象访问组访问的服务器文件连接。

N

FileName

/filename=

指定要使用外部连接查找的文件的名称。如果指定了服务器文件连接名称，则此参数指可用于服务器连接的文件

Y（如果指定了 Connection）

InFile

/infile=

指定输入文件的路径和文件名。建议您将值括在双引号中。

Y（如果未指定 Connection）

Delimiter

/delim=

可打印的分隔符。使用单个字符，例如冒号 (:)、逗号 (,)、短划线 (-) 等等。

N

StripQuotedStrings

/StripQuotedStrings=

指定是否从文件中找到的数据值中删除带引号的字符串。请指定下列值之一：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

默认值是 True。

N

AllowBlankOverrides

/AllowBlankOverrides=

指定是否允许空白覆盖。请指定下列值之一：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

N

BlankValueIndicator

/BlankValueIndicator=

指定用于指示文件中的空白值的文本值。

N

DeleteOnSubmitFailure

/DeleteOnSubmitFailure=

指定是否在提交不成功时删除请求。请指定下列值之一：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

默认值为 False。

N
Encoding

/encoding

作为编码名称或编码代码页编号的输入文件字符编码。此参数为可选。

默认值为 UTF8。

N

表 17-13 从文件中还原版本

键 参数 说明 必需

Connection

/conn=

指定外部连接的名称。

Y

Filename

/filename=

指定要使用外部连接 (/conn) 查找的文件的名称。

Y

SourceVersionAbbrev

/sver=

指定源文件中要还原的版本名称；如果存在多个版本，则使用 /delim 分隔。

Y

TargetVersionAbbrev

/tver=

指定与 /sver 参数关联的新版本的名称；如果存在多个版本，则使用 /delim 分隔。

Y

Delimiter

/delim=

可打印的分隔符。使用单个字符，例如冒号 (:)、逗号 (,)、短划线 (-) 等等。

N（将 sver 或 tver 指定为版本列表时除外）

AutoSave

/save=

还原后保存版本：

  • Y[es]、T[rue] 或 1

  • N[o]、F[alse] 或 0

N