Versionskontrolle
IMPORTANT
Substance 3D Designer-Version 14.0.0 aktualisiert die Perforce-Unterstützung auf Python 3.
Stellen Sie sicher, dass Ihre anderen Skripte und die Umgebung zur Versionskontrolle entsprechend angepasst sind.
Designer bietet eine Python-Integration des Versionskontrollsystems Perforce (P4).
Die Integration fügt dem Kontextmenü von Paketen im Explorer ein benutzerdefiniertes Untermenü “Versionskontrolle” sowie benutzerdefinierte Symbole hinzu, die dem Paketstatus in P4 entsprechen.
Vorbereiten von P4
Notieren Sie sich in P4V den Namen und Pfad des Arbeitsbereichs, wie unten gezeigt:
![Informationen zum P4V-Arbeitsbereich][image0]{modal="regular"}
Öffnen Sie dieses Skript in einem Texteditor oder einer IDE, der sich in der Installation von Designer befindet: ‘tools/version_control/perforce.py’.
Bearbeiten Sie in Zeile 19 den Pfad zum Speicherort der ausführbaren Datei von ‘p4’ auf Ihrem System.
Im folgenden Beispiel lautet dieser Pfad “c:/Program Files/Perforce/p4.exe”.
**```
Editable variables
cPerforceP4AbsPath = os.path.abspath("c:/Program Files/Perforce/p4.exe")
cVerbose = False
2) Wechseln Sie zu “Projekte”, wählen Sie die Zielprojektdatei "[" aus ](/de/docs/substance-3d-designer/using/pipeline-and-project-configuration/project-configuration-files-sbsprj) und wechseln Sie zur Registerkarte “Versionskontrolle”.
3) Aktivieren Sie “Versionskontrolle aktiviert”.
4) Füllen Sie diese Informationen im Abschnitt “Arbeitsbereich” aus:
- **Name:** Geben Sie den Arbeitsbereichsnamen ein, den Sie zuvor von P4V abgerufen haben.
- **Pfad:** Geben Sie den ‘Workspace-Pfad’ ein, den Sie zuvor von P4V abgerufen haben![P4-Setup in Designer: Arbeitsbereich][image2]{modal="regular"}### Einrichten von AktionenDie Aktionen sind im Kontextmenü eines Pakets im Explorer verfügbar. Es gibt vordefinierte Aktionen, die mit den meisten Konzepten des Versionskontroll-Tools übereinstimmen:* Alle Aktionsbezeichnungen können nach Bedarf geändert werden.
* Alle Aktionen benötigen ein Skript, damit sie gültig sind.Sie können Folgendes verwenden:* Ein Skript *pro* Aktion
* Ein Skript für *alle* AktionenEin Starterskript für alle Aktionen ist in der Installation von Designer verfügbar: ‘*tools/version\_control/perforce.py*’.:alert: IMPORTANTUm verfügbar zu sein, muss das Paket unter dem 'Workspace-Pfad' gespeichert werden (z. B. unter '*f:/Dev/perforce*').1) Klicken Sie in der Gruppe “**Aktionen**” auf die Schaltfläche “…”. Schaltfläche der Aktion **Hinzufügen**
2) Wählen Sie bei der Installation von Designer das folgende Skript aus: *Tools/version\_control/perforce.py*
3) Das Skript sollte automatisch für alle anderen Aktionen eingerichtet werden.![P4-Setup in Designer: actions][image3]{modal="regular"}### Benutzerdefinierte Aktionen einrichtenDa alle Versionskontrollwerkzeuge unterschiedlich sind und viele Funktionen enthalten, ermöglichen wir dem Benutzer, benutzerdefinierte Aktionen hinzuzufügen.1) Auf “Element hinzufügen” klicken
2) Geben Sie die Beschriftung der neuen Aktion ein und legen Sie ihren Skriptpfad fest.### Einrichten des Skriptinterpreters1) Klicken Sie im Abschnitt “Interpreter” auf “Element hinzufügen”.
2) Legen Sie eine Skriptdateierweiterung oder ein Suffix sowie den Pfad zur ausführbaren Interpreterdatei fest.
3) Bearbeiten Sie das Skript perforce.py, um den Speicherort der Binärdatei ‘p4’ zu aktualisieren.![P4-Setup in Designer: Interpreter][image4]{modal="regular"}## Verwendung der Versionskontrolle1) Neues Paket erstellen
2) Speichern Sie das Paket im Verzeichnis “Workspace-Pfad”
3) Klicken Sie auf RMB im Paket: Sie haben jetzt Zugriff auf das Untermenü “Versionskontrolle”.
4) Je nach Status der Paketdatei im Arbeitsbereich stehen mehrere Aktionen zur Verfügung:
- **Hinzufügen:** Markieren Sie die Dateien als “ToAdd”.
- **Senden:** Senden Sie die ausgewählten Pakete. Mit dieser Aktion wird ein Dialogfeld zum Festlegen einer Änderungsnachricht angezeigt (siehe unten).
- **Zurücksetzen:** Stellen Sie die Änderungen wieder her. Diese Aktion zeigt ein Dialogfeld zum Auswählen der Dateien an, die zurückgesetzt werden sollen (siehe unten)
- **Auschecken:** Auschecken der Datei aus dem Depot
- **Letzte Version abrufen:** Abrufen der neuesten Version aus dem Depot
- **Status aktualisieren:** Status der Paketdatei aktualisieren
![ Dialogfeld "Senden"][image5]{modal="regular"}
![ Dialogfeld "Zurücksetzen" ][image6]{modal="regular"}:info: NOTEAlle Aktionen unterstützen Mehrfachauswahl.Bei P4- und anderen Versionskontrolltools, die schreibgeschützte Dateiberechtigungen verwenden, um Änderungen einzuschränken, muss der Benutzer das Paket zuerst auschecken, bevor er es ändert.Schreibgeschützte Paketdateien können in SD nicht geändert werden.Das Paket verfügt je nach Status über die folgenden Symbole:![Paketsymbol: Aktuell][image7]Aktuell![Paketsymbol: Ausgecheckt][image8]Ausgecheckt![Paketsymbol: Hinzugefügt][image9]Zum Hinzufügen markiert![Paketsymbol: Nicht im Depot][image10]Nicht im LagerBeachten Sie, dass ein Paket, das nicht auf dem neuesten Stand ist, mit einem Warnzeichen gekennzeichnet ist.## AktionsskripteDer Befehl, der von jeder Aktion ausgeführt wird, wird folgendermaßen erstellt:my\_script ***WorkspaceName WorkspacePath ActionName\[ActionArgs]*****Arbeitsbereichsname:** Name des Arbeitsbereichs**WorkspacePath:** den Pfad des Stammverzeichnisses des Arbeitsbereichs**ActionName:** Name der Aktion:* *Hinzufügen:* für die Aktion “Hinzufügen”
* *Auschecken:* für die Aktion “Auschecken”
* *Senden:* für die Aktion “Senden”
* *Zurücksetzen:* für die Aktion “Zurücksetzen”
* *get\_last\_version:* für die Aktion “Letzte Version abrufen”
* *get\_status:* für die Aktion “Status abrufen”Die Beschriftung wird in den Projekteinstellungen eingerichtet, wobei das Zeichen ’ ’ durch das Zeichen ‘\_’ ersetzt wird - z. B.: “Meine Aktion” => “Meine\_Aktion”.**ActionArgs:** Argumente der Aktion:* *-desc*: Eine Beschreibungszeichenfolge, die von der Aktion “Senden” verwendet wird
* *-Dateien:* Eine Dateiliste
* *-files\_list:* Eine Textdatei, die eine Liste von Dateien pro Zeile enthält**get\_status**: Gibt einen Wert zurück, der vom Status der angegebenen Datei abhängt:* 0: Nicht definierter Status
* 1: nicht im Lager
* 2: Vorherige Version (nicht aktuell)
* 3: neueste Version (auf dem neuesten Stand)
* 4: ausgecheckt
* 5: zur Addition markiert
* sonstige Maßnahmen:
- 0: Erfolg
- andere: Fehler**
+-----------------------------------+
| Target Insertion |
+--------------------------+--------+
| recommendation-more-help | |
+--------------------------+--------+
---
+----------------------------------+
| Toc |
+----------------------------------+
| substance-3d-designer-help-guide |
+----------------------------------+
---
+-------------+
| Doc Actions |
+-------------+
| |
+-------------+
+----------+
| Mini Toc |
+----------+
| |
+----------+
+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Metadata |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| last-update | 2026-09-11T15:08:33.000Z |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| git-commit-file | a7ec95c953b45c1e8b64eaaed771f58a728ff1d5 |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| cloud | Experience Cloud |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| solution | Substance 3D Designer, Substance 3D |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| usetq | true |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| landing-page-name | substance-3d |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| landing-page-breadcrumb-title | Substance 3D |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| type | Documentation |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| mini-toc-levels | 2 |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| git-repo | https\://github.com/AdobeDocs/substance-3d-designer.de-DE |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| index | true |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| temp-push | yes |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| source-git-commit | 16eb8a173e984f842c820f3b8f0c3e140040bdfa |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| workflow-type | tm\+mt |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| source-wordcount | 873 |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| ht-degree | 0% |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| git-filename | https\://github.com/AdobeDocs/substance-3d-designer.de-DE/help/interface/preferences-window/version-control/version-control.md |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| user-guide-title | |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| breadcrumb-title | |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| user-guide-description | |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| nudge | true |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| helpx\_url | https\://helpx.adobe.com/de/substance-3d-designer/interface/preferences-window/version-control.html |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | Konfigurieren Sie die Versionskontrolleinstellungen in den Substance 3D Designer-Voreinstellungen, um sie mit Git und anderen Systemen zu integrieren. |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| helpx\_creative\_field | |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| helpx\_description | Designer > Interface > Preferences window > Version control |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| helpx\_experience\_level | |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| helpx\_learn\_topic | |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| helpx\_tags | |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| title | Versionskontrolle \| Adobe Substance 3D Designer |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| coveo-content-type | Documentation |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| landing-page-description | Konfigurieren Sie die Versionskontrolleinstellungen in den Substance 3D Designer-Voreinstellungen, um sie mit Git und anderen Systemen zu integrieren. |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| git-commit | a7ec95c953b45c1e8b64eaaed771f58a728ff1d5 |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| pipeline\_filename | help/interface/preferences-window/version-control/version-control.md |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| git-edit | https\://github.com/AdobeDocs/substance-3d-designer.de-DE/blob/main/help/interface/preferences-window/version-control/version-control.md |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| git-issue | https\://github.com/AdobeDocs/substance-3d-designer.de-DE/issues/new?body=File%3A%20help/interface/preferences-window/version-control/version-control.md |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| toc | substance-3d-designer-help-guide |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| product | Substance 3D Designer, Substance 3D |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| coveo-solution | Substance 3D Designer |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| json-ld | { "@context": "https\://schema.org", "@type": "HowTo", "@id": |
| | "https\://experienceleague.adobe.com/de/docs/substance-3d-designer/using/workspace/preferences/version-control#/schema", "url": |
| | "https\://experienceleague.adobe.com/de/docs/substance-3d-designer/using/workspace/preferences/version-control", "headline": "Versionskontrolle \| |
| | Adobe Substance 3D Designer", "description": "Konfigurieren Sie die Versionskontrolleinstellungen in den Substance 3D Designer-Voreinstellungen, um |
| | sie mit Git und anderen Systemen zu integrieren.", "inLanguage": "de", "dateCreated": "2026-09-11", "datePublished": "2026-09-11", |
| | "dateModified": "2026-09-11", "publisher": { "@type": "Organization", "name": "Adobe", "url": "https\://experienceleague.adobe.com" }, |
| | "about": \[ { "@type": "SoftwareApplication", "name": "Substance 3D Designer" }, { "@type": "SoftwareApplication", |
| | "name": "Substance 3D" } ], "keywords": \[ "Substance 3D Designer", "Substance 3D" ], "mainEntityOfPage": { "@type": "WebPage", |
| | "@id": "https\://experienceleague.adobe.com/de/docs/substance-3d-designer/using/workspace/preferences/version-control", "url": |
| | "https\://experienceleague.adobe.com/de/docs/substance-3d-designer/using/workspace/preferences/version-control", "name": "Versionskontrolle \| Adobe |
| | Substance 3D Designer", "description": "Konfigurieren Sie die Versionskontrolleinstellungen in den Substance 3D Designer-Voreinstellungen, um sie |
| | mit Git und anderen Systemen zu integrieren." } } |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
| html-lang | de |
+-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
[image0]: https://main--exlm-prod--adobe-experience-league.aem.page/media_11fc5b5376c89d88a79ec111cb9437c8386e1fc20.jpg#width=1011&height=256 "Informationen zum P4V-Arbeitsbereich"
[image1]: https://main--exlm-prod--adobe-experience-league.aem.page/media_10e70b74df0248011995fea250fc11f8375947715.jpg#width=1026&height=877 "Registerkarte \"Versionskontrolle\" in den Projekteinstellungen"
[image2]: https://main--exlm-prod--adobe-experience-league.aem.page/media_171bc28b1c4dc7a7a4de2af1f91bc0844263d7edd.jpg#width=1026&height=351 "P4-Einrichtung in Designer: Arbeitsbereich"
[image3]: https://main--exlm-prod--adobe-experience-league.aem.page/media_1291634db0acf425bb5ca29dec0b951bcf9dccac5.jpg#width=1026&height=375 "P4 setup in Designer: Aktionen"
[image4]: https://main--exlm-prod--adobe-experience-league.aem.page/media_1c9dd3c23ddf98a4d81fbda845744e373b4e921a9.jpg#width=1026&height=275 "P4-Setup in Designer: Interpreter"
[image5]: https://main--exlm-prod--adobe-experience-league.aem.page/media_1a8206342ed5d32be0f5b4654ba44485a143c45de.jpg#width=1066&height=662 "Dialogfeld \"Senden\""
[image6]: https://main--exlm-prod--adobe-experience-league.aem.page/media_1831575cbcdfa11d190b3f10f755c77a57d9dc904.jpg#width=1066&height=662 "Dialogfeld \"Zurücksetzen\""
[image7]: https://main--exlm-prod--adobe-experience-league.aem.page/media_19a8665debee135b076c10cb066a4b08b3a84a62a.png#width=54&height=55 "Paketsymbol: Aktuell"
[image8]: https://main--exlm-prod--adobe-experience-league.aem.page/media_1fdf82c541fc7bddf9db58fb55708cec5a5e2ca21.png#width=54&height=54 "Paketsymbol: Ausgecheckt"
[image9]: https://main--exlm-prod--adobe-experience-league.aem.page/media_1b05afb02184b224dd0ad66aa94e11802f536477b.png#width=54&height=54 "Paketsymbol: Hinzugefügt"
[image10]: https://main--exlm-prod--adobe-experience-league.aem.page/media_16d4e286db864d4c8e4de7c24b6d9402655c19268.png#width=54&height=54 "Paketsymbol: Nicht im Depot"