pmrep 命令引用 > ApplyLabel
  

ApplyLabel

将标签应用于文件夹中的一个对象或一组对象。 如果输入文件夹名称,则此文件夹中的所有对象都将收到此标签。 可以将标签应用于相关对象。 如果使用 dependency_object_types 选项,pmrep 会向所有相关对象添加标签。 要将标签应用于选定的相关对象,请在命令行上用逗号分隔每个对象类型名称,中间没有空格。
使用 ApplyLabel 可向可重用的输入对象添加标签。 如果要向不可重用的输入对象添加标签,则必须使用包含编码对象 ID 的持久性输入文件。
如果 ApplyLabel 成功,pmrep 不显示任何状态信息,或显示已带有标签的对象列表。 如果此命令失败,pmrep 会显示失败的原因。
ApplyLabel 命令使用以下语法:
applylabel

-a <label_name>

{{-n <object_name>

  -o <object_type>

  [-t <object_subtype>]

  [-v <version_number>]

  [-f <folder_name>] } |

  -i <persistent_input_file>}

[-d <dependency_object_types>]

[-p <dependency_direction (children, parents, or both)>]

[-s (include pk-fk dependency)]

[-g (across repositories)]

[-m (move label)]

[-c <comments>]

[-e dbd_separator]
下表介绍了 pmrep ApplyLabel 选项和参数:
选项
参数
说明
-a
label_name
必需。 要应用于对象的标签名称。
-n
object_name
更新特定对象时,为必需选项。 要接收标签的对象的名称。 使用 -i 选项时不能输入对象名称。
-o
object_type
要将标签应用到的对象的类型。 可以指定源、目标、转换、映射、会话、工作集、工作流、计划程序、会话配置、任务、多维数据集或维度。 当将标签应用于特定对象时,为必需选项。
-t
object_subtype
必需。 要添加标签的任务或转换的类型。 pmrep 会忽略其他对象类型。 有关有效子类型的详细信息,请参阅列出对象类型
-v
version_number
可选。 要将标签应用到的对象的版本。 如果版本已签出,此命令将失败。 默认将标签应用于对象的最新版本。
-f
folder_name
可选。 包含对象的文件夹。 如果输入文件夹名称,但未输入对象名称,pmrep 会将标签应用于该文件夹中的所有对象。 如果输入文件夹名称及对象名称,pmrep 会在该文件夹中搜索相应对象。 使用 -i 选项时,不能使用 -f 选项。
-i
persistent_input_file
可选。 从 ExecuteQuery、ListObjectDependency 或 Validate 生成的文本文件的名称。 包含要接收标签的对象的列表。 如果使用此选项,请不要使用对象名称、对象类型或文件夹名称来指定对象。
-d
dependency_object_types
可选。 要添加标签的相关对象类型。 有效的相关对象类型包括快捷方式、映射、Mapplet、会话、工作流、工作集、目标定义、源定义和外键相关性。
将此选项与 -p 选项搭配使用。如果输入对象类型,标签将应用于该对象类型的相关对象。
-p
dependency_direction
可选。 要将标签应用于的相关父项或子项。 可以指定父项和/或子项。 如果未输入 -d 选项,则所有相关对象都将收到标签。
如果未输入此选项,则标签将应用于指定对象。
-s
-
可选。 无论相关性的方向如何,都将包括主键-外键相关对象。
-g
-
可选。 在各存储库中查找对象相关性。
-m
-
可选。 将标签从对象的当前版本移至最新版本。 当标签类型为 one_per_object 时使用此参数。
-c
comments
可选。 关于标签的注释。
-e
dbd_separator
可选。 如果 ODBC 源名称中包含句点 (.), 请在定义源对象时定义其他分隔符字符。 例如,不使用 database_name.source_name,而是将源对象定义为 database_name\source_name,将 dbd_separator 定义为反斜杠 (\)。