Command Reference > pmrep-Befehlsreferenz > ListObjects
  

ListObjects

Gibt eine Liste von Objekten im Repository zurück. Wenn Sie Objekte auflisten, gibt pmrep Objektmetadaten zurück. Verwenden Sie die folgenden Auflistungsoperationen:
Verwenden Sie ListObjects in einem Shell-Skript, um Objektmetadaten zurückzugeben und Metadaten zu parsen. Verwenden Sie anschließend die geparsten Daten in einem anderen pmrep-Befehl.
Verwenden Sie zum Beispiel ListObjects, um alle Sequenzgenerator-Transformationen im Repository aufzulisten. Erstellen Sie ein Shell-Skript, das ListObjects verwendet, um die Informationen der Sequenzgenerator-Transformation zurückzugeben, parsen Sie die von ListObjects zurückgegebenen Daten und verwenden Sie UpdateSeqGenVals, um die Sequenzwerte zu aktualisieren.
pmrep gibt jedes Objekt in einem Datensatz und gibt die Metadaten für jedes einzelne Objekt in einer Spalte zurück. Die Datensätze werden standardmäßig durch eine neue Zeile getrennt. Sie können die Zeichen eingeben, die zum Trennen von Datensätzen und Spalten verwendet werden. Sie können zudem die Zeichen eingeben, die das Ende einer Liste kennzeichnen.
Der ListObjects-Befehl verwendet die folgende Syntax:
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>]
In der folgenden Tabelle werden die pmrep ListObject-Optionen und -Argumente beschrieben:
Option
Argument
Beschreibung
-o
object_type
Erforderlich. Aufzulistender Objekttyp.
  • - Wenn Sie Ordner eingeben, muss keine andere Option eingeschlossen werden. pmrep ignoriert die Optionen -t und -f.
  • - Wenn Sie andere Objekte als Ordner eingeben, müssen Sie die Option -f einschließen.
  • - Wenn Sie Transformation oder Aufgabe eingeben, müssen Sie die Option -f einschließen. Optional können Sie die Option -t einschließen.
Weitere Informationen über Objekttypen, die mit ListObjects verwendet werden können, finden Sie unter Listing Object Types.
-t
object_subtype
Optional. Aufzulistender Transformations- oder Aufgabentyp. Wenn Sie Transformation oder Aufgabe als Objekttyp eingeben, können Sie diese Option einschließen, um einen bestimmten Typ zurückzugeben.
Weitere Informationen über Objekttypen, die mit ListObjects verwendet werden können, finden Sie unter Listing Object Types.
-f
folder_name
Erforderlich, wenn Sie andere Objekte als Ordner auflisten. Zu suchender Ordner. Verwenden Sie diese Option bei allen Objekttypen außer Bereitstellungsgruppe, Ordner, Beschriftung und Abfrage.
-c
column_separator
Optional. Zeichen oder Zeichenfolgen, mit denen Spalten mit Objektmetadaten getrennt werden. Verwenden Sie ein Zeichen oder eine Zeichenfolge, die nicht in Repository-Objektnamen verwendet wird. Wenn ein Repository-Objektname Leerzeichen enthält, sollten Sie kein Leerzeichen als Spaltentrennzeichen verwenden.
Wenn Sie diese Option auslassen, verwendet pmrep ein einzelnes Leerzeichen.
-r
end-of-record_indicator
Optional. Zeichen oder Zeichenfolgen, das bzw. die das Ende von Objektmetadaten kennzeichnen. Verwenden Sie ein Zeichen oder eine Zeichenfolge, die nicht in Repository-Objektnamen verwendet wird.
Standardwert ist „newline“ /n.
-l
end_of_listing_indicator
Optional. Zeichen oder Zeichenfolgen, die das Ende der Objektliste kennzeichnen. Geben Sie ein Zeichen oder eine Zeichenfolge ein, die nicht in Repository-Objektnamen verwendet wird.
Wenn Sie diese Option auslassen, verwendet pmrep einen Punkt.
-b
-
Optional. Verbose. Zeigen Sie neben den Mindestinformationen weitere Informationen zu den Objekten an. Wenn Sie diese Option auslassen, zeigen Sie ein reduziertes Format an, einschließlich Objekttyp, wiederverwendbare oder nicht wiederverwendbare Wörter, Objektname und -pfad. Das ausführliche Format enthält den Objektstatus, die Versionsnummer und ausgecheckte Informationen.
Das Kurzformat für globale Objekte, z. B. Beschriftung, Abfrage, Bereitstellungsgruppe und Verbindung, enthält den Objekttyp und den Objektnamen. Verbose-Format enthält den Beschriftungstyp, den Abfragetyp, den Bereitstellungsgruppen-Typ, den Erstellernamen sowie den Zeitpunkt der Erstellung.
-y
-
Optional. Zeigt den Datenbanktyp von Quellen und Zielen an.
-s
dbd_separator
Optional. Wenn bei einer ODBC-Quelle ein Punkt (.) im Namen vorkommt, legen Sie beim Definieren des Quellobjekts ein anderes Trennzeichen fest. Beispiel: Definieren Sie statt database_name.source_name das Quellobjekt als database_name\source_name, und legen Sie als dbd_separator den umgekehrten Schrägstrich (\) fest.

Listing Object Types

Use the object_type option to define the objects you want to list. The command lists the latest versions or checked out versions of objects, including shortcuts, but excluding objects according to the rules for object types.
The following table describes the object types and rules you use with ListObjects:
Object Type
Rule
Deploymentgroup
List deployment groups in the repository.
Folder
List folders in the repository.
Label
List labels in the repository.
Mapplet
List mapplets with latest or checked out version in a folder, including shortcuts but excluding instances of reusable mapplets.
Mapping
List mappings with latest or checked out version in a folder, including shortcuts but excluding instances of reusable mapplets.
Query
List queries in the repository.
Scheduler
List reusable and non-reusable schedulers with latest or checked out version in a folder.
Session
List reusable and non-reusable sessions with latest or checked out version in a folder, excluding instances of reusable sessions.
Sessionconfig
List the session configurations with latest or checked out version in a folder.
Source
List sources with latest or checked out version in a folder, including shortcuts but excluding source instances.
Target
List targets with latest or checked out version in a folder, including shortcuts but excluding target instances.
Task
List reusable and non-reusable tasks with latest or checked out version in a folder.
Transformation
List reusable and non-reusable transformations with latest or checked out version in a folder, including shortcuts and excluding instances of reusable transformations.
“User Defined Function”
List user-defined functions in the repository.
Workflow
List the workflows with latest version or checked out version in a folder.
Worklet
List reusable and non-reusable worklets with latest version or checked out version in a folder, excluding instances of reusable worklets.
The following table describes the object types and values to use with pmrep commands:
Object Type
Subtype Value
Description
Query
personal
Personal
Query
shared
Shared
Task
assignment
Assignment
Task
command
Command
Task
control
Control
Task
decision
Decision
Task
email
Email
Task
event_raise
Event-raise
Task
event_wait
Event-wait
Task
start
Start
Task
timer
Timer
Transformation
aggregator
Aggregator
Transformation
application_source_qualifier
Application Source Qualifier
Transformation
app_multi-group_source_qualifier
Application Multi-Group Source Qualifier
Transformation
custom_transformation
Custom
Transformation
custom_transformation
HTTP
Transformation
custom_transformation
SQL
Transformation
custom_transformation
Union
Transformation
custom_transformation
XML Generator
Transformation
custom_transformation
XML Parser
Transformation
expression
Expression
Transformation
external_procedure
External Procedure
Transformation
filter
Filter
Transformation
input_transformation
Input
Transformation
java
Java
Transformation
joiner
Joiner
Transformation
lookup_procedure
Lookup
Transformation
mq_source_qualifier
MQ Source Qualifier
Transformation
normalizer
Normalizer
Transformation
output_transformation
Output
Transformation
rank
Rank
Transformation
router
Router
Transformation
sequence
Sequence Generator
Transformation
sorter
Sorter
Transformation
source_qualifier
Source Qualifier
Transformation
stored_procedure
Stored Procedure
Transformation
transaction_control
Transaction Control
Transformation
update_strategy
Update Strategy
Transformation
xml_source_qualifier
XML Source Qualifier

Auflisten von Ordnern

Verwenden Sie ListObjects, um jeden Ordner im Repository zurückzugeben. Wenn Sie als Objekttyp Ordner eingeben, ignoriert pmrep den Subtyp und den Ordnernamen.
Zum Auflisten aller Ordner im Repository verwenden Sie beispielsweise die folgende Syntax:
listobjects -o folder
Alternativ können Sie einen anderen Spaltentrenner und Listenende-Indikator eingeben:
ListObjects -o folder -c “**” -l #

Auflisten von Objekten

Verwenden Sie ListObjects, um wiederverwendbare und nicht wiederverwendbare Objekte im Repository oder in einem Ordner aufzulisten. pmrep enthält keine Instanzen wiederverwendbarer Objekte. Wenn Sie Objekte auflisten, müssen Sie den Ordnernamen für alle Objekte einschließen, die einem Ordner zugeordnet sind.
pmrep gibt ggf. den Namen des Objekts mit dem Pfad zurück. Wenn beispielsweise ein Mapping oder Mapplet eine Transformation enthält, gibt pmrep mapping_name.transformation_name oder mapplet_name.transformation_name zurück.
Weitere Informationen zu einer Liste der Umwandlungs- oder Aufgaben-Rückgabewerte finden Sie unter Listing Object Types.
Um beispielsweise alle Transformationstypen in einem Ordner aufzulisten, geben Sie den folgenden Text bei der Eingabeaufforderung ein:
listobjects -o transformation -f myfolder
pmrep gibt die folgenden Informationen zurück:
stored_procedure reusable sp_sproc1
expression reusable exp1
stored_procedure non-reusable mapping1.sp_nsproc
sequence non-reusable smallmapplet.seqgen_empid
.listobjects completed successfully.
Um alle Transformationen einer gespeicherten Prozedur aufzulisten, geben Sie den folgenden Text bei der Eingabeaufforderung ein:
listobjects -o transformation -t stored_procedure -f myfolder
pmrep gibt die folgenden Informationen zurück:
stored_procedure reusable sp_sproc1
stored_procedure non-reusable mapping1.sp_nsproc
.listobjects completed successfully.
Um alle Sitzungen in einem Ordner aufzulisten, geben Sie den folgenden Text bei der Eingabeaufforderung ein:
listobjects -o session -f myfolder
pmrep gibt die folgenden Informationen zurück:
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.