配置文件语法

除了使用命令行参数,批处理客户端还可以通过配置文件运行。配置文件的格式类似于 INI 文件,包含节、键和值。对于特定的操作,有一个常规节和一个其他节。节名称括在括号 ([]) 中,可为任意字符串值,但是必须与操作键指定的值匹配。每节中行的格式都为键=值对。

下面是示例配置文件。

         [General]
      

         Operation=Export
      

         UserName=mylogin
      

         Password=mypassword
      

         URL=net.tcp://localhost:5210/Oracle/Drm/ProcessManager
      

         LogFileName=C:\Oracle\Data Relationship Management\rdsc.log
      


         [Export]
      

         ExportType=Export
      

         ExportName=WeeklyExport
      

         OutFile= C:\Oracle\Data Relationship Management\export_data.txt
      

         CurrentVersionAbbrev=COA Current
      

         PrevVersionAbbrev=COA Previous
      

配置文件可以包括多个操作。每个操作都包含在具有唯一标签的单独节中。标记为 [Operations] 的特殊节用于指定文件中操作节的数量以及各个操作节的标签。操作按照列出的顺序执行。

下面是包含多个操作的配置文件的示例。请注意,当使用多个操作时,必须在每节中包括操作键(例如 Operation=Import)。

注:

节、键和值不区分大小写。

         [General]
      

         Operation=Multiple
      

         UserName=mylogin
      

         Password=mypassword
      

         URL=net.tcp://localhost:5210/Oracle/Drm/ProcessManager
      

         LogFileName=C:\Oracle\Data Relationship Management\rdsc.log
      


         [Operations]
      

         OperationCount=3
      

         Operation1=Weekly_Import
      

         Operation2=Update_CostCenters
      

         Operation3=Merge_Data
      


         [Weekly_Import]
      

         Operation=Import
      

         InFile="COA_data.txt"
      

         ImportAbbrev="RDSC Import"
      

         ImportLogFileName="C:\Oracle\Data Relationship Management\Batch Client\import_log.txt"
      

         VersionAbbrev="COA Current"
      

         VersionDescription="COA for this month"
      


         [Update_CostCenters]
      

         Operation=Action Script
      

         InFile=CostCenter_changes.txt
      

         StripQuotedStrings=True
      

         Delimiter=comma
      


         [Merge_Data]
      

         Operation=Blend
      

         Blendname="COA Blender"
      

         SourceVersionAbbrev="COA Current"
      

         TargetVersionAbbrev="COA Previous"
      

         NewVersionAbbrev="COA Blended"
      

         NewVersionDescription="Current and Previous COA"
      

以下各表介绍了可以在配置文件的各节中使用的键。

表 26. 配置文件的常规节

说明

Operation

指定要执行的操作。请指定下列值之一:

  • ActionScript

  • BackupVersionToFile

  • Blend

  • CloseVersion

  • Export

  • Import

  • Multi

  • OpenVersion

  • RefreshVersion

  • RestoreVersionFromFile

  • DeleteVersion

此键是必需的

UserName

指定用于登录的 Data Relationship Management 用户名。此键是必需的。

Password

指定用于登录的 Data Relationship Management 密码。此键是必需的。

URL

指定 Data Relationship Management 服务器进程中的进程管理器应用程序的 URL(包括端口号)。此 URL 已经配置,可从 Data Relationship Management 配置控制台中获取。例如 net.tcp://localhost:5210/Oracle/Drm/ProcessManager

注:

建议您将值括在双引号中。

此键是必需的。

LogFileName

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

默认文件名为 DRM_Batch_ClientMMDDYYYY.log,其中 MM = 月份,DD = 日期,YYYY = 年份

TimezoneOffset

与 GMT 的本地分钟偏差。例如 U.S. CST 与 GMT 的偏差分钟数为 -360。

此参数为可选。默认值为服务器的时区。

CultureName

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

此参数为可选。默认值为服务器的语言设置。

/objectaccess

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

此参数为可选。默认值为 Standard。

表 27. 配置文件的多个节

说明

OperationCount

指定文件中操作节的数量。指定一个大于 0 的整数。此键是必需的。

OperationN

指定操作节的标签,其中 N 是介于 1 和 OperationCount 值之间的数字。此键是必需的。

表 28. 配置文件的操作脚本节

说明

InFile

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

StripQuotedStrings

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

  • Y[es]

  • N[o]

  • T[rue]

  • F[alse]

  • 1

  • 0

默认值为 True。

Delimiter

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

  • Tab

  • Comma

  • #nnn

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

默认值是 Tab。

ColumnOrder

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

表 29. 配置文件的混合节

说明

BlendName

指定要运行的混合器名称。此键是必需的。

BlendLogFileName

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

SourceVersionAbbrev

指定要混合的源版本的名称。此键是必需的。

TargetVersionAbbrev

指定要混合的目标版本的名称。此键是必需的。

NewVersionAbbrev

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

NewVersionDescription

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

AutoSave

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

  • Y[es]

  • N[o]

  • T[rue]

  • F[alse]

  • 1

  • 0

默认值为 False。

有关保存版本的信息,请参阅在批处理客户端中保存版本

表 30. 配置文件的关闭节

说明

VersionAbbrev

指定要关闭的版本的名称。此键是必需的。

表 31. 配置文件的导出节

说明

ExportType

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

  • E[xport]

  • B[ook]

此键是必需的。

OutFile

指定输出文件的路径和文件名。如果输出文件存在,则将其覆盖。建议您将值括在双引号中。此键是必需的。

ExportName

指定要运行的已保存导出的名称。如果运行单个导出,则此键是必需的。

CurrentVersionAbbrev

指定当前版本的名称。如果未指定,则使用默认版本的名称。

PrevVersionAbbrev

指定上一版本的名称。如果未指定,则使用默认版本的名称。

BookName

指定要运行的已保存集的名称。如果导出集,则此键是必需的。建议用双引号将值括起来。

CombineExportOutput

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

  • Y[es]

  • N[o]

  • T[rue]

  • F[alse]

  • 1

  • 0

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

PreFileName

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

PostFileName

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

FromHierarchy

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

ToHierarchy

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

FromTopNodeAbbrev

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

ToTopNodeAbbrev

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

HierarchyCount

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

Hierarchy n

指定要导出的层次,其中 n 是标识当前层次/顶级节点对(例如 Hierarchy1)的数字(1 到 HierarchyCount)。用于层次导出和其他类似的导出,但是不用于层次比较和层次差异导出。

TopNodeAbbrev n

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

FromDate

指定事务日志导出的开始日期/时间(可选)

ToDate

指定事务日志导出的结束日期/时间(可选)

CurrentVersionType

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

  • A[s Of]

  • N[ormal]

默认值为 N[ormal]。

CurrentAsOfDate

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

PrevVersionType

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

  • A[s Of]

  • N[ormal]

默认值为 N[ormal]。

PrevAsOfDate

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

表 32. 配置文件的导入节

说明

InFile

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

ImportAbbrev

指定要运行的导入的名称。此键是必需的。

ImportLogFileName

指定导入日志文件的路径和文件名。(这不是 [General] 节中 LogFileName 键定义的相同日志文件。)默认文件名为 DRM_Batch_ClientMMDDYYYY.log,其中 MM = 月份,DD = 日期,YYYY = 年份

VersionAbbrev

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

VersionDescription

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

AutoSave

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

  • Y[es]

  • N[o]

  • T[rue]

  • F[alse]

  • 1

  • 0

默认值为 False。

有关保存版本的信息,请参阅在批处理客户端中保存版本

表 33. 配置文件的打开节

说明

VersionAbbrev

指定要打开的版本的名称。此键是必需的。

表 34. 配置文件的刷新节

说明

VersionAbbrev

指定要刷新(关闭并重新打开)的版本的名称。此键是必需的。此键是必需的。

表 35. 配置文件的删除节

说明

VersionAbbrev

指定要删除的版本的名称。此参数是必需的。