Creating Projects and Documents

Der Ausgangspunkt für jedes in Altium Designer erstellte Design ist ein Projekt. Ein Altium Designer-Projekt fasst eine Reihe von Designdokumenten zusammen, deren Ausgabe letztlich eine einzelne Implementierung dessen definiert, was Sie erstellen möchten. Beispielsweise umfassen die Schaltpläne und die PCB in einem PCB-Projekt den Dateisatz, der zur Herstellung einer Leiterplatte erforderlich ist. Im Gegensatz dazu wird der Dateisatz, den Sie aus einem Kabelbaumprojekt ausgeben, zum Beschaffen und Montieren eines Kabelbaums verwendet, und die logischen Schaltplan- und physischen Montage-Dateien in einem Multi-Board-Projekt liefern den Dateisatz zur Herstellung und Montage eines vollständigen Produkts mit mehreren verbundenen PCBs.

Der Satz an Designdokumenten des Projekts kann aus jeder zugänglichen Quelle zusammengeführt werden, lokal auf dem Rechner oder anderweitig, wobei die Projektdatei sie als einheitliches Design miteinander verknüpft. Die Software verwendet eine dynamische Kompilierung, um ein einheitliches Datenmodell der Projektkomponenten und ihrer Verbindungen zu erstellen und zu verwalten. Dieses Datenmodell kann dann verwendet werden, um Designänderungen zwischen den Designdomänen weiterzugeben – zum Beispiel durch Synchronisierung, um Unterschiede zwischen Dokumenten in den Domänen Schaltplan und PCB aufzulösen.

Die Projektdokumente können in Ihrem Altium Workspace, in Ihrem Versionskontrollsystem oder lokal als Dateien im verfügbaren Netzwerk erstellt und gespeichert werden.

In den folgenden Abschnitten wird beschrieben, wie Sie ein neues Projekt erstellen und einem bestehenden Projekt Designdokumente hinzufügen.

Erstellen eines neuen Projekts mit dem Dialog

Ein neues Projekt kann in Altium Designer über den Dialog Create Project erstellt werden (File » New » Project).

1. Wählen Sie in der Liste Locations den Eintrag für Ihren Workspace aus (er wird mit dem dafür definierten Namen angezeigt) – Sie müssen aktiv mit dem Workspace verbunden sein, damit diese Option in der Liste angezeigt wird. Dies ist der Zielserver, auf dem Ihr neues Workspace-Projekt gespeichert wird.

   Kurz gesagt konzentriert sich das Projektmanagement darauf, Änderungen während des gesamten Designprozesses sicher zu speichern und nachzuverfolgen und das resultierende Design letztlich in die Erstellung eines physischen Produkts zu überführen – beispielsweise einer bestückten PCB zur Verwendung im Endprodukt. Um diese Anforderungen zu erfüllen, bietet Altium Designer eine Reihe von Projektmanagement-Ansätzen mit zunehmendem Grad an Raffinesse und Funktionsumfang, die den Prozess aus Sicht des Designers dennoch vereinfachen. Diese reichen von lokaler dateibasierter Speicherung und Verwaltung über lokale/remote Speicheransätze mit Versionskontrollsystemen (VCS) bis hin zur fortschrittlichen und empfohlenen Form, bei der die Verwaltung der Designdaten auf den Fähigkeiten eines Workspace basiert.

   Ein verbundener Workspace und sein interner VCS-Dienst hosten und verwalten Altium Designer-Projekte und bieten außerdem vereinfachte VCS-Operationen, integrierte Funktionen für die Designzusammenarbeit, erweitertes Teilen von Designdaten, Verlaufserfassung, Lifecycle-Management und vieles mehr. Projekte, die in einen Workspace integriert sind, werden direkt aus Altium Designer aufgerufen, beispielsweise über das Fenster Projects, oder aus dem Workspace selbst über dessen browserbasierte Oberfläche.

   Dank der in die von einem Workspace bereitgestellten Dienste integrierten Intelligenz werden Aufgaben wie VCS-Operationen vereinfacht und automatisiert, und zusätzliche Funktionen für die Designzusammenarbeit wie Benutzerzugriffskontrolle (Freigabe), Kommentare und Verlauf stehen direkt in Altium Designer zur Verfügung. Das Endergebnis ist ein robustes und sicheres Projektspeicherformat an einem Speicherort, der zum zentralen Punkt für kollaboratives Projektdesign werden kann.

   Wenn Sie mit einem Workspace verbunden sind, in dem eine oder mehrere aktive Prozessdefinitionen für das Prozessthema „Project Creations“ vorhanden sind, ist die Möglichkeit, ein neues Projekt über den Dialog gh the Create Project dialog  zu erstellen, nur auf Projekte vom Typ „Local“ und „VCS“ beschränkt. Stattdessen unterliegt die Erstellung Workspace-basierter Projekte der Kontrolle aktiver Prozessdefinitionen. Erfahren Sie mehr über prozessbasierte Projekterstellung.

2. Wählen Sie in der Liste Project Type den Projekttyp aus, den Sie erstellen möchten, und wählen Sie bei Bedarf aus den verfügbaren passenden Vorlagen. Der Eintrag <Empty> erstellt ein leeres Shell-Projekt ohne anfängliche Quelldokumente.

   Erfahren Sie mehr über das Erstellen einer Projektvorlage.

3. Geben Sie einen Project Name und optional eine Projekt-Description ein.

   Der Projektname sollte mit beginnen und kann A-Z, a-z oder 0-9 enthalten. Unterstriche, Bindestriche und Leerzeichen sind zulässig, Letztere jedoch nur in der Mitte des Namens (führende und nachgestellte Leerzeichen werden ignoriert). Sie dürfen die folgenden Wörter nicht verwenden: AUX, COM1-COM9, LPT1-LPT9, CON, NUL und PRN. Außerdem darf der Name die folgenden Zeichen nicht enthalten: \ . / ? % * : | " < >.

Der Dialog Create Project enthält weitere Optionen:

• Aktivieren Sie die Option Version Control (Standard), um dem Projekt alle VCS-Funktionen aufzuerlegen, wie Verlauf und erweiterte Freigabefunktionen. Wenn diese Option deaktiviert ist, wird das Projekt im Workspace gespeichert und mit der lokalen Kopie synchronisiert – ein „gespiegeltes“ Projekt im Format Simple Sync.

  Die Option Version Control ist nur verfügbar, wenn Sie mit einem Altium 365 Workspace verbunden sind. Wenn Sie mit einem Enterprise Server Workspace verbunden sind, ist diese Option faktisch aktiviert.

• Beim Erstellen eines Projekts vom Typ PCB aktivieren Sie die Option Constraint Management , um Design-Constraints für dieses Projekt mit dem Constraint Manager zu verwalten. Wenn die Option deaktiviert ist, wird für dieses Projekt das System der Design Rules verwendet.

  Die Option Constraint Management ist im Dialog Create Project standardmäßig aktiviert, wenn die Option System.ConstraintManager im Dialog Advanced Settings dialog aktiviert ist.

• Wenn Sie mit einem Enterprise Server Workspace verbunden sind, listet das Dropdown-Menü Repository (falls vorhanden) alle Design-Repositories auf, die über den Version Control Service des Workspace verwaltet werden und zur Nutzung für Sie freigegeben wurden. Wählen Sie das Repository aus, in dem das neue Projekt und seine Dateien gespeichert werden sollen – standardmäßig ist ein einzelnes Git-basiertes Repository (Versioned Storage) verfügbar. Wenn ein Repository vom Typ SVN ausgewählt ist, steht zusätzlich eine Option Repository Folder zur Verfügung, mit der ein alternativer Zielordner innerhalb des Repositorys selbst angegeben oder ausgewählt werden kann.

  Das Dropdown-Menü Repository wird nur angezeigt, wenn Sie Ihren Enterprise Server von einer Version oder einem Serverprodukt aktualisiert haben, bei der bzw. dem die Verwendung von SVN-Repositories aktiviert war. Alternativ stellt der Enterprise Server ein einzelnes Git-basiertes Design-Repository für alle Ihre Workspace-Designprojekte bereit; in diesem Fall wird das Dropdown-Menü Repository nicht angezeigt.

  SVN wird im Altium On-Prem Enterprise Server ab Version 7.2 nicht mehr unterstützt. Um die Einschränkungen bei der Verwaltung eines SVN-Projekts zu vermeiden, wird empfohlen, SVN-Projekte in das integrierte Git-Repository des Enterprise Server Workspace zu migrieren. Dies kann vor dem Upgrade des Servers wie hier beschrieben erfolgen.

  Weitere Informationen zur Einstellung von SVN im Altium On-Prem Enterprise Server finden Sie im Knowledge-Base-Artikel SVN Discontinuation with Altium On-Prem Enterprise Server 7.2.1.

• Klicken Sie auf das Steuerelement Advanced, um Ordnerpfade anzugeben.

  • Verwenden Sie das Feld Folder, um anzugeben, wo der Ordner für das Projekt – innerhalb der Ordnerstruktur des Workspace – erstellt werden soll. Der Standardpfad für neue Projekte wird auf der Seite Admin – Settings – Projects der browserbasierten Oberfläche des Workspace festgelegt (standardmäßig ist dies Projects\<ProjectName>). Klicken Sie bei Bedarf auf die Schaltfläche , um zu einem anderen Workspace-Ordner zu navigieren und ihn auszuwählen.

    Wenn der Benutzer, der ein Projekt im verbundenen Workspace erstellt, keine Schreibberechtigung für den Standard-Projektordner hat, erstellt das System automatisch eine benutzerspezifische Personal Folder Struktur zum Speichern des neuen Projekts. Diese erscheint als Ordner der obersten Ebene auf Basis der E-Mail-Adresse des Mitglieds (bei einem Altium 365 Workspace) oder des Benutzernamens (bei einem Enterprise Server Workspace), mit einem Unterordner My Projects, in dem die Projekte dieses Benutzers gespeichert werden. Die Ordnerstruktur/-hierarchie ist nur für den angemeldeten Benutzer und Administratoren verfügbar – sie ist für andere Benutzer nicht sichtbar. Erfahren Sie mehr über Managing Project Creation Permissions (Altium 365 Workspace, Enterprise Server Workspace).

  • Verwenden Sie das Feld Local Storage, um anzugeben, wo die lokale Version des Projekts auf Ihrer Festplatte gespeichert werden soll. Der Standardspeicherort ist auf der Seite System – Default Locations des Dialogs Preferences definiert. Klicken Sie bei Bedarf auf die Schaltfläche , um zu einem anderen Ordnerspeicherort zu navigieren und ihn auszuwählen. Dies ist der „Arbeitsordner“ für das Projekt und das local Git-Repository, in das es eingecheckt wird. Das Projekt wird letztlich bzw. zum Zeitpunkt des Committen in das zentrale Design-Repository im Workspace (Versioned Storage) übertragen, welches das Git-Repository remote ist.

   

• Verwenden Sie den Listenbereich Parameters, um benutzerdefinierte Name/Wert-Parameterpaare hinzuzufügen oder zu entfernen, die dem Projekt zugeordnet und im Workspace gespeichert werden. Verwenden Sie die Schaltfläche , um der Liste ein neues Name/Wert-Parameterpaar hinzuzufügen, oder die Schaltfläche , um ein ausgewähltes Paar zu entfernen. Die Felder Name und Wert erlauben maximal 255 Zeichen. Beim Erstellen eines Workspace-Projekts werden diese Workspace-Projektparameter zusammen mit dem neuen Projekt als projektbezogene Parameter auf Workspace-Seite im Workspace gespeichert.

  Wenn in der Liste Project Type des Dialogs eine Projektvorlage ausgewählt wird, wird der Listenbereich Parameters mit Parametern aus dieser Vorlage geladen. Bei Bedarf können Sie diese Parameter (Namen und/oder Werte) ändern oder entfernen. Beim Erstellen eines Workspace-Projekts wird ein Parameter aus der ausgewählten Vorlage als projektbezogener Parameter auf Design-Seite gespeichert, wenn der Parametername nicht geändert wurde. Andernfalls wird er als projektbezogener Parameter auf Workspace-Seite gespeichert.

  Projektbezogene Parameter auf Workspace-Seite können innerhalb des Workspace bearbeitet werden. Im Gegensatz dazu werden Parameter auf Design-Seite in der Projektdatei (*.PrjPcb) gespeichert und können in Altium Designer bearbeitet werden. Projektbezogene Parameter beider Typen können auf der Registerkarte Parameters des Dialogs Project Options (Project » Project Options) angezeigt werden und können in Altium Designer als Special Strings verwendet werden.

Wenn das Projekt wie erforderlich definiert ist, klicken Sie auf die Schaltfläche . Die neue Projektstruktur wird in den angegebenen lokalen und Workspace-Ordnern erstellt. Das Projekt wird im Bereich Projects panel geöffnet, der den vollständig synchronisierten Zustand zwischen den Dateien im entfernten Design-Repository (im Workspace) und dem lokalen Repository (Arbeitskopie) widerspiegelt – angezeigt durch die zugehörigen Symbole . Wenn es mit deaktivierter Option Version Control erstellt wurde (nur in einem Altium 365 Workspace verfügbar), wird das gespiegelte Projekt im Bereich Projects mit einem zugehörigen Symbol angezeigt.

Das neu erstellte Projekt wurde in das Design-Repository Versioned Storage im Workspace übertragen.

Alternativ wird, wenn dem neuen Projekt not eine Vorlage mit enthaltenen Dokumenten zugewiesen wurde, nur die Projektdatei (*.PrjPcb) und damit lediglich die Struktur des Projekts erstellt. Das Projekt wird dann im Bereich Projects panel geöffnet, wo es als Scheduled for addition angezeigt wird, gekennzeichnet durch das zugehörige Symbol . An diesem Punkt können Sie dem Projekt Dokumente hinzufügen oder die Struktur einfach in ihrem aktuellen Hüllzustand im Workspace speichern. Klicken Sie dazu auf das Steuerelement Save to Server, das dem Projekteintrag im Bereich Projects zugeordnet ist – ebenfalls verfügbar über das Kontextmenü per Rechtsklick und über das Hauptmenü File. Wählen Sie im folgenden Dialog Save to Server dialog Dateien zur Aufnahme aus bzw. ab, fügen Sie optional eine Comment hinzu und bestätigen Sie den Speichervorgang dann mit der Schaltfläche . Sobald das Projekt dem Server hinzugefügt wurde, zeigt der Bereich Projects den vollständig synchronisierten Zustand zwischen den Dateien im Server-Repository und der lokalen Arbeitskopie an, wie durch die Symbole angezeigt.

Kopieren eines Projekts

Um ein Workspace-Projekt innerhalb von Altium Designer zu kopieren, klicken Sie mit der rechten Maustaste auf den Projekteintrag im Bereich Projects und wählen Sie den Befehl Make a copy  aus dem Kontextmenü. Verwenden Sie den Dialog Create Project Copy, um den Project Name festzulegen (standardmäßig ist dies der ursprüngliche Projektname mit dem Suffix - Copy), den Description (dieser ist nicht vorausgefüllt), den Pfad Folder (innerhalb des Workspace) und den Pfad Local Storage (zur Arbeitskopie).

Der Workspace-Folder ist standardmäßig derselbe Ordner, in dem das ursprüngliche Projekt gespeichert ist. Klicken Sie auf , um den Dialog Choose Folder zu öffnen (eine abgespeckte Version des Bereichs Explorer), und den Ordner bei Bedarf zu ändern. Der Local Storage ist standardmäßig auf den Speicherort eingestellt, der auf der Seite System - Default Locations des Dialogs Preferences definiert ist. Klicken Sie auf , um einen Standard-Windows-Dialog zu öffnen, mit dem Sie diesen Speicherort bei Bedarf ändern können.

Kopieren Sie ein Workspace-Projekt innerhalb von Altium Designer.

Hinzufügen und Entfernen eines Designdokuments

Sobald ein Projekt eingerichtet ist, können dem aktiven Projekt Designdokumente hinzugefügt, darin bearbeitet oder daraus entfernt werden. Die einfachste Möglichkeit, einem Projekt neue Designdokumente hinzuzufügen, besteht darin, mit der rechten Maustaste auf den Projektnamen im Bereich Projects zu klicken und im Kontextmenü Add New to Project auszuwählen. Alternativ wählen Sie den erforderlichen Dokumenttyp aus dem Untermenü Project » Add New to Project der Hauptmenüs, um dem aktiven Projekt ein neues Dokument hinzuzufügen.

Fügen Sie einem Projekt einen bestimmten oder einen anderen Dokumenttyp hinzu.

Andere Arten projektbezogener Dokumente können ebenfalls zu einem Projekt hinzugefügt werden, z. B. Textdateien, PDFs, Tabellenkalkulationen usw. Verwenden Sie dazu die Option Add Existing to Project (oder den Befehl Project » Add Existing to Project aus dem Hauptmenü des Editors des aktiven Dokuments) und setzen Sie die Dropdown-Liste File Type im Browserdialog Choose Document to Add auf All Files (*.*), damit auf alle Dateitypen zugegriffen werden kann.

Um ein Dokument aus der Projektstruktur zu entfernen, klicken Sie mit der rechten Maustaste auf seinen Namen im Bereich Projects und wählen Sie die Menüoption Remove from Project oder den Befehl Project » Exclude from Project aus den Hauptmenüs. Sie werden aufgefordert, Folgendes auszuwählen:

• Delete File – um die Quelldatei des Dokuments selbst dauerhaft zu entfernen.

• Exclude from Project – um die Verknüpfung des Projekts zu diesem Dokument zu entfernen (ohne die Quelldatei des Dokuments selbst zu löschen). Wenn es derzeit im Fenster des Design-Editors geöffnet ist, wird es aus seinem übergeordneten Projekt entfernt, bleibt jedoch im Bedienfeld als freies Dokument geöffnet. Wenn es jedoch derzeit nicht im Designbereich geöffnet ist, wird es durch das Entfernen effektiv geschlossen.

  

Entfernen eines Projekts

Bei lokalen Projekten bedeutet das Entfernen eines Projekts, die Dateien von Ihrer Festplatte zu löschen. Öffnen Sie den Projektordner im Windows-Explorer und löschen Sie dessen Inhalt.

Für Workspace-Projekte (und andere Workspace-Inhalte wie Komponenten und freigegebene Daten) steht eine flexible Funktion zum direkten Entfernen innerhalb von Altium Designer im Explorer panel zur Verfügung. Als „Soft Delete“ ausgeführt, bietet der Entfernungsvorgang erweiterte Optionen und Informationen während des Vorgangs, einschließlich relevanter Links zu Quellelementen zur Überprüfung. Im Workspace werden gelöschte Inhalte an einen speziellen Trash Ort verschoben, von wo sie wiederhergestellt oder auf der Seite Trash in der Browseroberfläche des Workspace vollständig entfernt werden können.

Um ein Workspace-Projekt per Soft Delete zu löschen, navigieren Sie im Explorer Bedienfeld zum Projektordner, klicken Sie mit der rechten Maustaste auf dessen Eintrag und wählen Sie im Kontextmenü den Befehl Delete Folder. Bestätigen Sie das Löschen im daraufhin angezeigten Dialog Confirm Delete. Wenn das Projekt freigegebene Daten enthält, wird ein weiterer Bestätigungsdialog geöffnet, der Sie darüber informiert, dass auch diese Daten gelöscht werden. Klicken Sie auf Delete, um fortzufahren.

Soft Delete in Aktion. Hier wird ein Projekt zusammen mit seiner zugehörigen Freigabe gelöscht (wenn aus Freigaben Fertigungspakete erstellt worden wären, würden diese ebenfalls gelöscht).