Command Reference > Arbeiten mit pmrep-Dateien > Verwenden der Bereitstellungssteuerdatei
  

Verwenden der Bereitstellungssteuerdatei

Eine Bereitstellungssteuerdatei ist eine XML-Datei, die Sie mit den pmrep-Befehlen "DeployFolder" und "DeployDeploymentGroup" verwenden, um einen Ordner oder eine Bereitstellungsgruppe bereitzustellen. Sie können eine Bereitstellungssteuerdatei manuell erstellen, um Parameter für die Bereitstellung anzugeben. Sie können sie aber auch mit dem Kopierassistenten erstellen.
Wenn Sie die Bereitstellungssteuerdatei manuell erstellen, muss sie der depcntl.dtd-Datei entsprechen, die mit dem PowerCenter Client installiert wird. Sie nehmen den Speicherort der depcntl.dtd-Datei in der Bereitstellungssteuerdatei auf.
Sie können in der Bereitstellungssteuerdatei einen Bereitstellungs-Timeout angeben. Der Bereitstellungs-Timeout ist der Zeitraum, den pmrep wartet, um Objektsperren im Target-Repository abzurufen. Standardmäßig wartet pmrep unbegrenzt, bis Sperren abgerufen werden oder Sie brechen die Bereitstellung ab. Wenn Sie eine Bereitstellung abbrechen möchten, während pmrep auf das Abrufen von Sperren wartet, drücken Sie Strg+C.
Im Folgenden sehen Sie ein Beispiel für eine depcntl.dtd-Datei:
<!ELEMENT DEPLOYPARAMS (DEPLOYFOLDER?, DEPLOYGROUP?)>
<!ATTLIST DEPLOYPARAMS
        DEFAULTSERVERNAME    CDATA      #IMPLIED
        COPYPROGRAMINFO      (YES | NO) "YES"
        COPYMAPVARPERVALS    (YES | NO) "NO"
        RETAINMAPVARPERVALS (YES | NO) "NO"
COPYWFLOWVARPERVALS  (YES | NO) "NO"
        COPYWFLOWSESSLOGS    (YES | NO) "NO"
        COPYDEPENDENCY       (YES | NO) "YES"
        LATESTVERSIONONLY    (YES | NO) "NO"
        CHECKIN_COMMENTS     CDATA      #IMPLIED
        DEPLOYTIMEOUT        CDATA      "-1"
        RETAINGENERATEDVAL   (YES | NO) "YES"
        RETAINSERVERNETVALS  (YES | NO) "YES"
        COPYDEPLOYMENTGROUP  (YES | NO) "NO"
OVERRIDESERVER (YES | No) "NO">

<!--criteria specific to deploying folder-->
<!ELEMENT DEPLOYFOLDER (REPLACEFOLDER?, DEPLOYEDFOLDEROWNER?, OVERRIDEFOLDER*)>
<!ATTLIST DEPLOYFOLDER
        NEWFOLDERNAME         CDATA      #IMPLIED>

<!--folder to replace-->
<!ELEMENT REPLACEFOLDER EMPTY>
<!ATTLIST REPLACEFOLDER
        FOLDERNAME            CDATA      #REQUIRED
        RETAINMAPVARPERVALS   (YES | NO) "NO"
        RETAINWFLOWVARPERVALS (YES | NO) "YES"
        RETAINWFLOWSESSLOGS   (YES | NO) "NO"
        MODIFIEDMANUALLY      (YES | NO) "NO"
        RETAINORIGFOLDEROWNER (YES | NO) "NO">

<!--shared folder to override-->
<!ELEMENT OVERRIDEFOLDER EMPTY>
<!ATTLIST OVERRIDEFOLDER
        SOURCEFOLDERNAME    CDATA            #REQUIRED
        SOURCEFOLDERTYPE    (LOCAL | GLOBAL) "LOCAL"
        TARGETFOLDERNAME    CDATA            #REQUIRED
        TARGETFOLDERTYPE    (LOCAL | GLOBAL) "LOCAL"
        MODIFIEDMANUALLY    (YES | NO)     "NO"

<!--criteria specific to deploy deployment group-->
<!ELEMENT DEPLOYGROUP (REPLACEDG?, TARGETDGOWNER?, OVERRIDEFOLDER*, APPLYLABEL?)>
<!ATTLIST DEPLOYGROUP
        CLEARSRCDEPLOYGROUP (YES | NO) "NO">
        NEWDEPLOYGROUPNAME   CDATA  #IMPLIED

<!--labels used to apply on the src objects and deployed objects-->
<!ELEMENT APPLYLABEL EMPTY>
<!ATTLIST APPLYLABEL
        SOURCELABELNAME     CDATA            #IMPLIED
        SOURCEMOVELABEL    (YES | NO)          "NO"
        TARGETLABELNAME     CDATA            #IMPLIED
        TARGETMOVELABEL     (YES | NO)          "NO">

<!-- new owners of deployed folders -->
<!ELEMENT DEPLOYEDFOLDEROWNER EMPTY>
<!ATTLIST DEPLOYEDFOLDEROWNER
        USERNAME         CDATA        #IMPLIED
       SECURITYDOMAIN   CDATA     #IMPLIED
        GROUPNAME        CDATA #IMPLIED>

<!-- to indicate that a deployment group should be replaced-->
<!ELEMENT REPLACEDG EMPTY>
<!ATTLIST REPLACEDG
        DGNAME          CDATA        #REQUIRED
       SECURITYDOMAIN   CDATA     #IMPLIED

<!-- new owner of copied deployment group-->
<!ELEMENT TARGETDGOWNER EMPTY>
<!ATTLIST TARGETDGOWNER
        USERNAME         CDATA        #IMPLIED
       SECURITYDOMAIN   CDATA     #IMPLIED

Bereitstellungs-Steuerdatei-Parameter

In der folgenden Tabelle finden Sie eine Auflistung mit pmrep-Bereitstellungs-Steuerdatei-Parametern:
Element
Attributname
Attributbeschreibung
DEPLOYPARAMS
DEFAULTSERVERNAME
Erforderlich, wenn Sie DeployFolder und DeployDeploymentGroup verwenden und OVERRIDESERVER auf „Ja“ setzen. Der Integrationsdienst ist im Ziel-Repository zur Ausführung bereitgestellter Arbeitsabläufe registriert. Pro Bereitstellung können Sie einen Integrationsdienst angeben.
-
COPYPROGRAMINFO
Optional. Kopiert das mit SAP installierte ABAP-Programm.
-
COPYMAPVARPERVALS
Optional. Kopiert persistente Werte der Zuordnungsvariable basierend auf den für RETAINMAPVARPERVALS festgelegten Werten. Wenn Sie COPYMAPVARPERVALS nicht festlegen oder den zugehörigen Wert auf „Nein“ setzen, werden die Werte für RETAINMAPVARPERVALS ignoriert. Weitere Informationen hierzu finden Sie unter Beibehaltene Zuordnungsvariablen.
-
RETAINMAPVARPERVALS
Optional. Behält persistente Werte der Zuordnungsvariable basierend auf den für COPYMAPVARPERVALS festgelegten Werten im Ziel bei. Wenn Sie COPYMAPVARPERVALS nicht festlegen oder den zugehörigen Wert auf „Nein“ setzen, werden die Werte für RETAINMAPVARPERVALS ignoriert. Weitere Informationen hierzu finden Sie unter Beibehaltene Zuordnungsvariablen.
-
COPYWFLOWVARPERVALS
Optional. Kopiert persistente Werte für die Arbeitsablaufvariable.
-
COPYWFLOWSESSLOGS
Optional. Kopiert Arbeitsablaufprotokolle.
-
COPYDEPENDENCY
Optional. Kopiert Abhängigkeitsinformationen für Objekte in Zuordnungen.
-
COPYDEPLOYMENTGROUP
Optional. Kopiert die Bereitstellungsgruppe zusammen mit den Objekten in der Bereitstellungsgruppe in das Ziel-Repository.
-
VALIDATETARGETREPOSITORY
Optional. Validiert Objekte im Ziel-Repository.
-
LATESTVERSIONONLY
Optional. Kopiert die neueste Version.
-
CHECKIN_COMMENTS
Optional. Überschreibt den Standardkommentar und fügt einen Kommentar im Ziel-Repository beim Kopieren oder Bereitstellen eines Objekts hinzu. Sie müssen LATESTVERSIONONLY auf TRUE festlegen, um dieses Attribut zu verwenden.
-
DEPLOYTIMEOUT
Optional. Zeitraum (in Sekunden), in dem pmrep versucht, Sperren für Objekte im Ziel-Repository abzurufen. Bei einem Wert von 0 schlägt der Kopiervorgang sofort fehl, wenn pmrep keine Sperre erhält. Der Wert -1 weist pmrep an, so lange zu warten, bis die Sperren übermittelt werden oder der Benutzer den Vorgang abbricht. Standardwert ist -1.
-
RETAINGENERATEDVAL
Optional. Speichert den aktuellen Wert für Sequenzgenerator- oder Normalisierungsumwandlungen.
-
RETAINSERVERNETVALS
Optional. Behält Werte, die sich auf das Netzwerk oder den Server beziehen, in Aufgaben bei.
OVERRIDESERVER
Optional. Verwenden Sie dieses Attribut gemeinsam mit DEFAULTSERVERNAME. Wenn Sie den Wert OVERRIDESERVER auf „Yes“ setzen, weist der Bereitstellungsvorgang den Namen des Integrationsdiensts zu, der vom Attribut DEFAULTSERVERNAME zum Ausführen der bereitgestellten Arbeitsabläufe angegeben wird. Wenn der Wert DEFAULTSERVERNAME nicht angegeben ist oder einen ungültigen Namen für den Integrationsdienst aufweist, wird den bereitgestellten Arbeitsabläufen während der Bereitstellung kein Integrationsdienst zugewiesen.
Wenn Sie den Wert OVERRIDESERVER auf „No“ setzen, wird während der Bereitstellung geprüft, ob ein Integrationsdienst basierend auf dem Integrationsdienst in den Quell- und Ziel-Repositorys zu den Arbeitsabläufen zugewiesen werden kann. Wenn derselbe Integrationsdienstname in den Quell- und Ziel-Repositorys angezeigt wird, erfolgt die Zuweisung des Integrationsdienstnamens zu den bereitgestellten Arbeitsabläufen während der Bereitstellung. Andernfalls werden dem Integrationsdienst die bereitgestellten Arbeitsabläufe nicht zugewiesen.
Standardwert ist „No“.
DEPLOYFOLDER
NEWFOLDERNAME
Optional. Erstellt einen Ordner mit diesem Namen.
REPLACEFOLDER
FOLDERNAME
Erforderlich, wenn Sie DEPLOYFOLDER verwenden. Benennt den Ordner, nachdem dieser ersetzt wurde.
-
RETAINMAPVARPERVALS
Optional. Behält persistente Werte für die Zuordnungsvariable im Ziel bei.
-
RETAINWFLOWVARPERVALS
Optional. Behält persistente Werte für Arbeitsablaufvariablen bei.
-
RETAINWFLOWSESSLOGS
Optional. Behält Sitzungsprotokolle des Arbeitsablaufs im Ziel bei.
-
MODIFIEDMANUALLY
Optional. Vergleicht Ordner, wenn Objekte im Zielordner seit der letzten Bereitstellung erstellt oder geändert wurden.
-
RETAINORIGFOLDEROWNER
Optional. Behält den vorhandenen Ordnereigentümer bei. pmrep ignoriert alle im DEPLOYEDFOLDEROWNER-Element bereitgestellten Informationen.
OVERRIDEFOLDER
SOURCEFOLDERNAME
Erforderlich, wenn Sie DeployFolder und DeployDeploymentGroup verwenden.
Bei der Bereitstellung eines Ordners wird der aktuelle Ordner angegeben, auf den die Shortcuts zeigen.
Bei der Bereitstellung einer Bereitstellungsgruppe werden die folgenden Ordner angegeben:
  • - Ein oder mehrere Ordner, auf den bzw. die die Shortcuts zeigen
  • - Ein oder mehrere Ordner mit den Bereitstellungsgruppenobjekten
-
SOURCEFOLDERTYPE
Optional. Bei der Bereitstellung eines Ordners wird der Ordnertyp angegeben, auf den die Shortcuts zeigen. Verwenden Sie lokale oder globale Shortcuts.
-
TARGETFOLDERNAME
Erforderlich. Bei der Bereitstellung eines Ordners wird der Ordner angegeben, auf den die Shortcuts zeigen.
Bei der Bereitstellung einer Bereitstellungsgruppe werden die folgenden Ordner angegeben:
  • - Ein oder mehrere Ordner, auf den bzw. die die Shortcuts zeigen
  • - Ein oder mehrere Ordner mit den Bereitstellungsgruppenobjekten
-
TARGETFOLDERTYPE
Optional. Bei der Bereitstellung eines Ordners wird der Ordnertyp angegeben, auf den die Shortcuts zeigen. Verwenden Sie lokale oder globale Shortcuts.
-
MODIFIEDMANUALLY
Optional. Vergleicht Ordner, wenn Objekte im Zielordner seit der letzten Bereitstellung erstellt oder geändert wurden. Verwenden Sie dieses Attribut nur mit dem DeployDeploymentGroup-Befehl.
DEPLOYGROUP
CLEARSRCDEPLOYGROUP
Erforderlich, wenn Sie DeployDeploymentGroup verwenden. Entfernt nach der Bereitstellung Objekte aus der Quellgruppe.
-
NEWDEPLOYGROUPNAME
Optional. Erstellt eine Bereitstellungsgruppe mit diesem Namen. Wird bei Angabe von REPLACEDG ignoriert. Standardwert ist der Name der Quellbereitstellungsgruppe.
REPLACEDG
DGNAME
Optional. Name der zu ersetzenden Bereitstellungsgruppe.
-
RETAINORIGDGOWNER
Optional. Gibt an, ob der Eigentümer der Bereitstellungsgruppe, die im Ziel-Repository ersetzt wurde, beibehalten werden soll.
TARGETDGOWNER
USERNAME
Optional. Eigentümer der kopierten Bereitstellungsgruppe. Standardwert ist der Eigentümer der Quellbereitstellungsgruppe.
-
SECURITYDOMAIN
Optional. Sicherheitsdomäne der Zielbereitstellungsgruppe.
APPLYLABEL
SOURCELABELNAME
Erforderlich, wenn Sie DeployDeploymentGroup verwenden. Wendet eine Beschriftung auf alle Objekte in der Quellgruppe an.
-
SOURCEMOVELABEL
Optional. Verschiebt die Beschriftung aus einer anderen Version des Objekts in der Quellgruppe in die Bereitstellungsgruppenversion des Objekts. Wenn der Repository Agent feststellt, dass die Beschriftung auf eine andere Version desselben Objekts angewendet wird, können Sie die Beschriftung in die ausgewählte Version des Objekts verschieben.
-
TARGETLABELNAME
Optional. Wendet eine Beschriftung auf alle im Ziel-Repository bereitgestellten Objekte an.
-
TARGETMOVELABEL
Optional. Verschiebt die Beschriftung aus einer anderen Version des Objekts in der Zielgruppe in die Bereitstellungsgruppenversion des Objekts. Wenn der Repository Agent feststellt, dass die Beschriftung auf eine andere Version desselben Objekts angewendet wird, können Sie die Beschriftung in die aktuelle Version des Objekts verschieben.
DEPLOYEDFOLDEROWNER
USERNAME
Erforderlich, wenn Sie DeployFolder und DeployDeploymentGroup verwenden. Eigentümer des bereitgestellten Ordners oder der Bereitstellungsgruppe im Ziel-Repository.
-
SECURITYDOMAIN
Optional. Name der Sicherheitsdomäne, der der Eigentümer des bereitgestellten Ordners oder der Bereitstellungsgruppe angehört.
-
GROUPNAME
Optional. Gruppeneigentümer des bereitgestellten Ordners oder der Bereitstellungsgruppe im Ziel-Repository.

Beibehaltene Zuordnungsvariablen

Beim Bereitstellen eines Ordners oder einer Gruppe können Sie die Werte der beibehaltenen Zuordnungsvariablen aus dem Quell- in das Ziel-Repository kopieren, die Werte aus dem Ziel-Repository beibehalten oder die Werte zurücksetzen.
In der folgenden Tabelle wird die Konfiguration von COPYMAPVARPERVALS und RETAINMAPVARPERVALS zum Kopieren, Beibehalten oder Zurücksetzen der Werte beibehaltener Zuordnungsvariablen beschrieben:
Bereitstellungsverhalten
Konfiguration
Setzen Sie die Werte der beibehaltenen Zuordnungsvariable im Ziel-Repository zurück.
Setzen Sie COPYMAPVARPERVALS auf „Nein“.
Kopiert die Werte der Zuordnungsvariable aus dem Quell- in das Ziel-Repository.
Legen Sie die folgenden Optionen für die Parameterdatei fest:
  • - Setzen Sie COPYMAPVARPERVALS auf „Ja“.
  • - Setzen Sie RETAINMAPVARPERVALS auf „Nein“.
Behält die vorhandenen Werte der beibehaltenen Zuordnungsvariable im Ziel-Repository bei.
Legen Sie die folgenden Optionen für die Parameterdatei fest:
  • - Setzen Sie COPYMAPVARPERVALS auf „Ja“.
  • - Setzen Sie RETAINMAPVARPERVALS auf „Ja“.