pmrep 命令引用 > ListObjects
  

ListObjects

返回存储库中对象的列表。 当列出对象时,pmrep 将返回对象元数据。 使用以下列表操作:
可在 shell 脚本中使用 ListObjects 返回对象元数据,解析元数据,然后在其他 pmrep 命令中使用解析后的数据。
例如,使用 ListObjects 列出存储库中的所有序列生成器转换。 创建一个 shell 脚本,使用 ListObjects 返回序列生成器转换信息、解析 ListObjects 返回的数据并使用 UpdateSeqGenVals 更新序列值。
pmrep 将每个对象返回到一条记录中并在一列中返回每个对象的元数据。 默认用换行符分隔各条记录。 您可以输入用于分隔各记录和列的字符。 还可以输入用于指示列表末尾的字符。
ListObjects 命令使用以下语法:
listobjects

-o <object_type>

[-t <object_subtype>]

[-f <folder_name>]

[-c <column_separator>]

[-r <end-of-record_indicator>]

[-l <end-of-listing_indicator>]

[-b (verbose)]

[-y (print database type)]

[-s <dbd_separator>]
下表介绍了 pmrep ListObjects 选项和参数:
选项
参数
说明
-o
object_type
必需。 要列出的对象的类型。
  • - 输入文件夹时,不需要包括其他任何选项。 pmrep 将忽略 -t 和 -f 选项。
  • - 输入文件夹以外的对象时,必须包括 -f 选项。
  • - 输入转换或任务时,必须包括 -f 选项,也可以选择包括 -t 选项。
有关要用于 ListObjects 的对象类型的详细信息,请参阅列出对象类型
-t
object_subtype
可选。 要列出的转换或任务的类型。 输入对象类型的转换或任务时,可以包括此选项以返回特定类型。
有关要用于 ListObjects 的对象类型的详细信息,请参阅列出对象类型
-f
folder_name
如果要列出文件夹以外的对象,则为必需选项。 要搜索的文件夹。 此选项适用于除部署组、文件夹、标签和查询以外的所有对象类型。
-c
column_separator
可选。 用于分隔对象元数据列的字符或字符集。 使用存储库对象名称中未使用的字符或字符集。 如果任何存储库对象名称中含有空格,您可能希望避免使用空格作为列分隔符。
如果忽略此选项,pmrep 将使用单个空格。
-r
end-of-record_indicator
可选。 用于指定对象元数据结束位置的字符或字符集。 使用存储库对象名称中未使用的字符或字符集。
默认为换行符 /n。
-l
end_of_listing_indicator
可选。 用于指定对象列表结束位置的字符或字符集。 输入存储库对象名称中未使用的字符或字符集。
如果忽略此选项,pmrep 将使用句点。
-b
-
可选。 Verbose。 显示对象的详细信息。 如果忽略此选项,将显示简短格式,其中包括对象类型、可重用或不可重用一词、对象名称和路径。 详细格式包括对象状态、版本号、文件夹名称和已签出的信息。
全局对象(如标签、查询、部署组和连接)的简短格式包括对象类型和对象名称。 详细格式包括标签类型、查询类型、部署组类型、创建者名称和创建时间。
-y
-
可选。 显示源和目标的数据库类型。
-s
dbd_separator
可选。 如果 ODBC 源名称中包含句点 (.), 请在定义源对象时定义其他分隔符字符。 例如,不使用 database_name.source_name,而是将源对象定义为 database_name\source_name,将 dbd_separator 定义为反斜杠 (\)。

列出对象类型

使用 object_type 选项可定义要列出的对象。 此命令将根据对象类型的规则列出对象的最新版本或已签出版本,包括快捷方式,但不包括对象。
下表介绍了用于 ListObjects 的对象类型和规则:
对象类型
规则
Deploymentgroup
列出存储库中的部署组。
文件夹
列出存储库中的文件夹。
标签
列出存储库中的标签。
Mapplet
列出文件夹中最新版本或已签出版本的 Mapplet,包括快捷方式但不包括可重用 Mapplet 的实例。
映射
列出文件夹中最新版本或已签出版本的映射,包括快捷方式但不包括可重用 Mapplet 的实例。
查询
列出存储库中的查询。
调度程序
列出文件夹中最新版本或已签出版本的可重用和不可重用计划程序。
会话
列出文件夹中最新版本或已签出版本的可重用和不可重用会话,可重用会话的实例除外。
Sessionconfig
列出文件夹中最新版本或已签出版本的会话配置。
列出文件夹中最新版本或已签出版本的源,包括快捷方式但不包括源实例。
目标
列出文件夹中最新版本或已签出版本的目标,包括快捷方式但不包括目标实例。
任务
列出文件夹中最新版本或已签出版本的可重用和不可重用任务。
转换
列出文件夹中最新版本或已签出版本的可重用和不可重用转换,包括快捷方式但不包括可重用转换的实例。
“User Defined Function”
列出存储库中的用户定义函数。
工作流
列出文件夹中最新版本或已签出版本的工作流。
工作集
列出文件夹中最新版本或已签出版本的可重用和不可重用工作集,可重用工作集的实例除外。
下表介绍了要与 pmrep 命令搭配使用的对象类型和值:
对象类型
子类型值
说明
任务
分配
分配
任务
命令
命令
任务
控件
控件
任务
判定
判定
任务
电子邮件
电子邮件
任务
event_raise
事件提升
任务
event_wait
事件等待
任务
启动
启动
任务
定时器
定时器
转换
汇总器
汇总器
转换
application_source_qualifier
应用程序源限定符
转换
app_multi-group_source_qualifier
应用程序多组源限定符
转换
custom_transformation
自定义
转换
custom_transformation
HTTP
转换
custom_transformation
SQL
转换
custom_transformation
联合
转换
custom_transformation
XML 生成器
转换
custom_transformation
XML 解析器
转换
表达式
表达式
转换
external_procedure
外部过程
转换
筛选器
筛选器
转换
input_transformation
输入
转换
java
Java
转换
联接器
联接器
转换
lookup_procedure
查找
转换
mq_source_qualifier
MQ 源限定符
转换
规范化程序
规范化程序
转换
output_transformation
输出
转换
等级
等级
转换
路由器
路由器
转换
序列
序列生成器
转换
排序器
排序器
转换
source_qualifier
源限定符
转换
stored_procedure
存储过程
转换
transaction_control
事务控制
转换
update_strategy
更新策略
转换
xml_source_qualifier
XML 源限定符

列出文件夹

使用 ListObjects 可返回存储库中的各个文件夹。 为对象类型输入 folder 时,pmrep 将忽略子类型和文件夹名称。
例如,要列出存储库中的所有文件夹,请使用以下语法:
listobjects -o folder
也可以输入其他列分隔符和列表末尾指示器:
ListObjects -o folder -c “**” -l #

列出对象

使用 ListObjects 可列出存储库或文件夹中的可重用对象和不可重用对象。 pmrep 不包括可重用对象的实例。 列出对象时,必须包括所有与文件夹关联的对象的文件夹名称。
pmrep 将返回包含路径的对象名称(如适用)。 例如,如果转换在某个映射或 Mapplet 中,pmrep 将返回 mapping_name.transformation_namemapplet_name.transformation_name
有关转换或任务返回值列表的详细信息,请参阅列出对象类型
例如,要列出文件夹中的所有转换类型,请在命令提示符处输入以下文本:
listobjects -o transformation -f myfolder
pmrep 将返回以下信息:
stored_procedure reusable sp_sproc1
expression reusable exp1
stored_procedure non-reusable mapping1.sp_nsproc
sequence non-reusable smallmapplet.seqgen_empid
.listobjects completed successfully.
要列出文件夹中的所有存储过程转换,请在命令提示符处输入以下文本:
listobjects -o transformation -t stored_procedure -f myfolder
pmrep 将返回以下信息:
stored_procedure reusable sp_sproc1
stored_procedure non-reusable mapping1.sp_nsproc
.listobjects completed successfully.
要列出文件夹中的所有会话,请在命令提示符处输入以下文本:
listobjects -o session -f myfolder
pmrep 将返回以下信息:
session reusable s_sales_by_CUSTID
session non-reusable wf_sales.s_sales_Q3
session non-reusable wf_orders.wl_shirt_orders.s_shirt_orders
.listobjects completed successfully.