Referencia de comando > Referencia de comando pmrep > ListObjects
  

ListObjects

Devuelve una lista de objetos en el repositorio. Cuando se listan objetos, pmrep devuelve metadatos de objetos. Utilice las siguientes operaciones de listado:
Utilice ListObjects en un script de shell que devuelva metadatos de objetos, analice los metadatos y, a continuación, utilice los datos analizados en otro comando pmrep.
Por ejemplo, utilice ListObjects para listar todas las transformaciones de generadores de secuencias en el repositorio. Cree un script de shell que utilice ListObjects para devolver información de una transformación de generador de secuencia, analice los datos devueltos por ListObjects y utilice UpdateSeqGenVals para actualizar los valores de la secuencia.
pmrep devuelve cada objeto en un registro y los metadatos de cada objeto en una columna. Cada registro está separado en una nueva línea de forma predeterminada. Se pueden especificar los caracteres usados para separar registros y columnas. También es posible definir los caracteres que indican el fin del listado.
El comando ListObjects emplea la siguiente sintaxis:
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>]
La tabla siguiente describe las opciones y los argumentos de pmrep ListObjects:
Opción
Argumento
Descripción
-o
object_type
Obligatorio. Tipo de objeto del listado.
  • - Si se especifica una carpeta, no es necesario incluir ninguna otra opción. pmrep ignora las opciones -t y -f.
  • - Si se especifican objetos que no sean carpetas, se debe incluir la opción -f.
  • - Si se especifican transformaciones o tareas, se debe incluir la opción -f y, opcionalmente, la opción -t.
Para obtener más información sobre los tipos de objeto para utilizar con ListObjects, consulte Listado de tipos de objeto.
-t
object_subtype
Opcional. Tipo de transformación o tarea del listado. Si se especifica una transformación o tarea como tipo de objeto, se puede incluir esta opción para que devuelva un tipo específico.
Para obtener más información sobre los tipos de objeto para utilizar con ListObjects, consulte Listado de tipos de objeto.
-f
folder_name
Obligatorio si se listan objetos que no sean carpetas. Carpeta en la que buscar. Utilice esta opción para todos los tipos de objetos excepto grupo de implementación, carpeta, etiqueta y consulta.
-c
column_separator
Opcional. Carácter o conjunto de caracteres utilizados para separar las columnas de metadatos de objetos. Emplee un carácter o un conjunto de caracteres que no se utilice en los nombres de objetos de repositorio. Si un nombre de objeto de repositorio contiene espacios, puede no utilizar un espacio como separador de columnas.
Si omite esta opción, pmrep emplea un solo espacio.
-r
end-of-record_indicator
Opcional. Carácter o conjunto de caracteres utilizados para especificar el final de los metadatos de objetos. Emplee un carácter o un conjunto de caracteres que no se utilice en los nombres de objetos de repositorio.
El valor predeterminado es nueva línea, /n.
-l
end_of_listing_indicator
Opcional. Carácter o conjunto de caracteres utilizados para especificar el final de la lista de objetos. Emplee un carácter o un conjunto de caracteres que no se utilice en los nombres de objetos de repositorio.
Si omite esta opción, pmrep emplea un punto.
-b
-
Opcional. Detallado. Muestra más que la información mínima sobre los objetos. Si omite esta opción, se muestra un formato más corto que incluye el tipo de objeto, las palabras reusable o non-reusable, el nombre de objeto y la ruta de acceso. El formato detallado incluye el estado del objeto, número de versión, nombre de la carpeta e información de desprotección.
El formato corto para objetos globales, tales como etiqueta, consulta, grupo de implementación y conexión, incluye el tipo de objeto y el nombre de objeto. El formato detallado incluye los tipos de etiqueta, consulta y grupo de implementación así como el nombre del autor y la fecha de creación.
-y
-
Opcional. Muestra el tipo de base de datos de orígenes y destinos.
-s
dbd_separator
Opcional. Si un origen ODBC incluye un punto (.) en el nombre, establezca un carácter de separador diferente al definir el objeto de origen. Por ejemplo, en lugar de database_name.source_name, defina el objeto de origen como database_name\source_name y defina dbd_separator con una barra invertida (\).

Listado de tipos de objeto

Use la opción object_type para definir los objetos que desea enumerar. El comando enumera las últimas versiones o las versiones desprotegidas de los objetos, incluyendo los accesos directos, pero excluyendo objetos en función de las reglas de los tipos de objeto.
La tabla siguiente describe los tipos de objeto y las reglas que se usan con ListObjects:
Tipo de objeto
Regla
Deploymentgroup
Lista de grupos de implementación del repositorio.
Carpeta
Lista de carpetas del repositorio.
Etiqueta
Lista de etiquetas del repositorio.
Mapplet
Lista de mapplets con la versión más reciente o la versión desprotegida de una carpeta, incluyendo los accesos directos, pero excluyendo las instancias de los mapplets reutilizables.
Asignación
Lista de las asignaciones con la última versión o la versión desprotegida de una carpeta, incluyendo los accesos directos, pero excluyendo las instancias de los mapplets reutilizables.
Consulta
Lista de las consultas del repositorio.
Programador
Lista de los programadores reutilizables y no reutilizables con la última versión o la versión desprotegida de una carpeta.
Sesión
Lista de las sesiones reutilizables y no reutilizables con la última versión o la versión desprotegida de una carpeta, excluyendo las instancias de las sesiones reutilizables.
Sessionconfig
Lista de las configuraciones de sesión con la versión más reciente o la versión desprotegida de una carpeta.
Origen
Lista de los orígenes con la última versión o la versión desprotegida de una carpeta, incluyendo los accesos directos, pero excluyendo las instancias de los orígenes.
Destino
Lista de los destinos con la última versión o la versión desprotegida de una carpeta, incluyendo los accesos directos, pero excluyendo las instancias de los destinos.
Tarea
Lista de las tareas reutilizables y no reutilizables con la última versión o la versión desprotegida de una carpeta.
Transformación
Lista de las transformaciones reutilizables y no reutilizables con la última versión o la versión desprotegida de una carpeta, incluyendo los accesos directos y excluyendo las instancias de las transformaciones reutilizables.
“Función definida por el usuario”
Lista de las funciones definidas por el usuario del repositorio.
Flujo de trabajo
Lista de los flujos de trabajo con la última versión o la versión desprotegida de una carpeta.
Worklet
Lista de los worklets reutilizables y no reutilizables con la versión más reciente o la versión desprotegida de una carpeta, excluyendo las instancias de los worklets reutilizables.
La tabla siguiente describe los tipos de objetos y valores que se usan con los comandos de pmrep:
Tipo de objeto
Valor de subtipo
Descripción
Tarea
asignación
Asignación
Tarea
comando
Comando
Tarea
control
Control
Tarea
decisión
Decisión
Tarea
correo electrónico
Correo electrónico
Tarea
event_raise
Event-raise
Tarea
event_wait
Event-wait
Tarea
inicio
Inicio
Tarea
temporizador
Temporizador
Transformación
agregador
Agregador
Transformación
application_source_qualifier
Calificador de origen de aplicación
Transformación
app_multi-group_source_qualifier
Calificador de origen de grupos múltiples de aplicación
Transformación
custom_transformation
Personalización
Transformación
custom_transformation
HTTP
Transformación
custom_transformation
SQL
Transformación
custom_transformation
Unión
Transformación
custom_transformation
Generador de XML
Transformación
custom_transformation
Analizador de XML
Transformación
expresión
Expresión
Transformación
external_procedure
Procedimiento externo
Transformación
filtro
Filtro
Transformación
input_transformation
Entrada
Transformación
java
Java
Transformación
combinación
Combinación
Transformación
lookup_procedure
Búsqueda
Transformación
mq_source_qualifier
Calificador de origen MQ
Transformación
normalizador
Normalizador
Transformación
output_transformation
Salida
Transformación
rango
Rango
Transformación
enrutador
Enrutador
Transformación
secuencia
Generador de secuencias
Transformación
ordenar
Ordenar
Transformación
source_qualifier
Calificador de origen
Transformación
stored_procedure
Procedimiento almacenado
Transformación
transaction_control
Control de transacciones
Transformación
update_strategy
Estrategia de actualización
Transformación
xml_source_qualifier
Calificador de origen XML

Listado de carpetas

Use ListObjects para devolver cada carpeta del repositorio. Cuando se especifica folder para el tipo de objeto, pmrep ignora el subtipo y el nombre de la carpeta.
Por ejemplo, para enumerar todas las carpetas del repositorio, use la siguiente sintaxis:
listobjects -o folder
De forma alternativa, puede especificar un separador de columna distinto y un indicador de fin de listado:
ListObjects -o folder -c “**” -l #

Listado de objetos

Use ListObjects para enumerar los objetos reutilizables y no reutilizables presentes en el repositorio o en una carpeta. pmrep no incluye las instancias de objetos reutilizables. Para enumerar los objetos, debe incluir el nombre de la carpeta para todos los objetos que están asociados con una carpeta.
pmrep devuelve el nombre del objeto con la ruta, si procede. Por ejemplo, cuando una transformación está en una asignación o mapplet, pmrep devuelve mapping_name.transformation_name o mapplet_name.transformation_name.
Para obtener más información sobre una lista de valores de retorno de transformación o tarea, consulteListado de tipos de objeto.
Por ejemplo, para enumerar todos los tipos de transformación de una carpeta, introduzca el texto siguiente en la línea de comando:
listobjects -o transformation -f myfolder
pmrep devuelve la siguiente información:
stored_procedure reusable sp_sproc1
expression reusable exp1
stored_procedure non-reusable mapping1.sp_nsproc
sequence non-reusable smallmapplet.seqgen_empid
.listobjects completed successfully.
Para enumerar todas las transformaciones del procedimiento almacenado en una carpeta, introduzca el texto siguiente en la línea de comando:
listobjects -o transformation -t stored_procedure -f myfolder
pmrep devuelve la siguiente información:
stored_procedure reusable sp_sproc1
stored_procedure non-reusable mapping1.sp_nsproc
.listobjects completed successfully.
Para enumerar todas las sesiones de una carpeta, introduzca el texto siguiente en la línea de comando:
listobjects -o session -f myfolder
pmrep devuelve la siguiente información:
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.