DUPLICATE_OBJECT

Verwenden Sie die Script-Funktion DUPLICATE_OBJECT, um ein Duplikat eines Objekts zu erstellen.

Wichtig!

• Ein Laufzeitfehler tritt auf, wenn Sie eine :ON_ERROR-Anweisung mit dem Parameter ABEND verwenden, aber das Objekt oder der Ordner nicht vorhanden ist. Falls der Ordner nicht vorhanden ist, verbleibt das Objekt in seinem ursprünglichen Ordner. Weitere Informationen finden Sie unter:ON_ERROR.
• Sie benötigen Schreibzugriff (W) auf das Objekt und den Zielordner, da andernfalls ein Laufzeitfehler auftritt. Weitere Informationen finden Sie unter Automation Engine-Berechtigungen gewähren.
• Diese Script-Funktion schreibt alle offenen Transaktionen des Scripts in die AE-Datenbank. Weitere Informationen finden Sie unter Script-Verarbeitung.

Syntax

DUPLICATE_OBJECT (Object Name,Template,[Folder])

Parameter

• DUPLICATE_OBJECT
  Dupliziert ein Objekt in einen Ordner
• Objektname
  Name des Zielobjekts
  Format:Script-Literal oder Script-Variable
• Vorlage
  Name des Quellobjekts, das dupliziert werden sollte.
  Format: Script-Literal oder Script-Variable
• (Optional) Ordner
  Pfad des Ordners, in den Sie das Objekt kopieren möchten.
  Format: Script-Literal oder Script-Variable

Rückgabewerte

Die Skriptfunktion gibt die folgenden Werte zurück:

• 0
  Das Objekt wurde erfolgreich dupliziert.
• 20645
  Dieses Objekt ist nicht vorhanden.
• 20657
  Der Zielordner ist nicht vorhanden.

Beispiel

Im folgenden Beispiel wird das Script-Objekt SCRI.SOURCE dupliziert und TARGET genannt.

: SET   &target_object# = "SCRI.TARGET_&$PHYS_DATE_YYYY_MM_DD_p#_&$_PHYS_TIME_HHMMSS#"

: SET   &retcode# = DUPLICATE_OBJECT(&target_object#,SCRI.SOURCE,"\DUPLICATE_OBJECT\TEST")

: PRINT   &retcode#

Das duplizierte Objekt heißt nun „SCRI.TARGET_2023_10_17_155414“:

Siehe auch: