Modifying Symbols & Footprints

Neben der Pflege der Inhalte innerhalb der Datenbank selbst besteht auch die Anforderung, die referenzierten Symbole und Modelle bei Bedarf zu pflegen. Dazu gehören Änderungen an den Schaltplansymbolen und den Footprint-Modellen. Und bei einer Standard-Datenbankbibliothek (DbLib) auch die Definitionen in Simulationsmodelldateien.

Beide Arten von Datenbankbibliotheken – Standard und versionsverwaltet – bieten die Möglichkeit, auf das referenzierte Symbol und das Footprint-Modell zur Bearbeitung zuzugreifen, direkt aus der Hauptansicht des DbLib-/SVNDbLib-Dokuments, wenn dieses als aktives Dokument geöffnet ist. In den folgenden Abschnitten wird erläutert, wie dies erfolgt, was bei Verwendung einer SVNDbLib etwas aufwendiger, aber auch leistungsfähiger ist.

Bei Verwendung einer DbLib

Um die referenzierte Symbol-/Footprint-Modellbibliotheksdatei einer Komponente zur Bearbeitung zu öffnen, klicken Sie mit der rechten Maustaste auf den Eintrag der Komponente im Table Browser und wählen dann den entsprechenden Befehl – entweder Open Symbol oder Open Footprint – aus dem Kontextmenü. Die betreffende Bibliotheksdatei wird geöffnet und das Symbol/der Footprint wird als aktives Element im Arbeitsbereich angezeigt, sodass Sie Ihre Änderungen vornehmen können.

Nachdem die erforderlichen Änderungen vorgenommen wurden, speichern Sie die Bibliotheksdatei.

Beispiel für den Zugriff auf das referenzierte Symbol einer Datenbankkomponente direkt innerhalb der DbLib.

Bei Verwendung einer SVNDbLib

Wie erwähnt, ist die Möglichkeit, auf die von Datenbankkomponenten referenzierten Symbole und Modelle zuzugreifen und diese zu bearbeiten, wenn über eine SVNDbLib-Datei darauf zugegriffen wird, etwas komplexer, aber auch leistungsfähiger. Änderungen werden an lokalen Arbeitskopien der im SVN-Repository gespeicherten Bibliotheken vorgenommen.

Festlegen eines lokalen Arbeitsbereichs

Um Änderungen an Komponentensymbolen und Footprint-Modellen vorzunehmen, müssen Sie die Dateien aus dem Repository in ein lokales Arbeitsverzeichnis auschecken. Geben Sie das gewünschte Verzeichnis auf der Seite Data Management - SVN Libraries page des Dialogs Preferences an. Ein Standardspeicherort für den Arbeitsordner ist definiert – \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder. Ändern Sie diesen bei Bedarf, indem Sie entweder auf die Schaltfläche  klicken, um zu einem vorhandenen Ordner zu navigieren, oder indem Sie direkt einen Pfad zum Ordner eingeben.

Festlegen eines lokalen Arbeitsverzeichnisses.

Um schnell alle Symbol- und Footprint-Modellbibliotheken aus dem Repository in den angegebenen lokalen Arbeitsordner auszuchecken, führen Sie den Befehl Check Out All Working Folders im Hauptmenü Tools des SVNDatabaseLib Editors aus. Die ausgecheckten Ordner sind diejenigen, die im Bereich Models Location auf der Registerkarte SVN Repository des Dialogs Database Library Options dialog angegeben sind.

Ein Beispiel für die Symbole und Footprints – im SVN-Repository gespeichert und als Teil von Database Library Options angegeben – die in einen lokalen Arbeitsordner ausgecheckt wurden.

Änderungen vornehmen

Sobald die Symbol- und Footprint-Modellbibliotheken in Ihren festgelegten lokalen Arbeitsordner ausgecheckt wurden, können Sie bei Bedarf Änderungen vornehmen. Dazu gehören Änderungen an der lokalen Kopie der Schaltplansymbole und Footprint-Modelle und anschließend das Einchecken dieser Änderungen zurück in das SVN-Repository.

Wie bei einer DbLib stehen die folgenden Methoden zum Zugriff auf ein Symbol/Modell zur Bearbeitung zur Verfügung:

• Innerhalb des SVNDbLib-Dokuments klicken Sie mit der rechten Maustaste auf den Eintrag der Komponente im Table Browser und wählen dann den entsprechenden Befehl – entweder Open Symbol oder Open Footprint – aus dem Kontextmenü.

• Wenn die SVNDbLib zur Liste der verfügbaren dateibasierten Bibliotheken hinzugefügt wird, können Sie Bearbeitungsbefehle direkt über das Components panel aufrufen. Wählen Sie den gewünschten Komponenteneintrag aus und verwenden Sie dann den Befehl Edit Symbol (im Kontextmenü per Rechtsklick für den Bereich Components ) bzw. den Befehl Edit Footprint (im Kontextmenü per Rechtsklick für den Bereich Models ).
• Verwenden Sie den Befehl File » Open des Bibliothekseditors, um zur benötigten Bibliothek (in Ihrem lokalen Arbeitsordner) zu navigieren und sie zu öffnen.
• Ziehen Sie die Bibliotheksdatei (in Ihrem lokalen Arbeitsordner) per Drag-and-drop direkt aus dem Windows Explorer in Altium Designer.

Speichern Sie in jedem Fall nach den erforderlichen Änderungen die Bibliotheksdatei.

Die Hauptschnittstelle zwischen den in den lokalen Arbeitsordner ausgecheckten Ordnern und Dateien und dem Repository selbst ist jedoch das Storage Manager panel. Wenn die SVNDbLib-Datei das aktive Dokument ist, wird das Storage Manager mit den in den lokalen Arbeitsordner ausgecheckten Symbol- und Modellordnern gefüllt. Die genau aufgelisteten Ordner sind diejenigen, die im Bereich Model Locations auf der Registerkarte SVN Repository des Dialogs Database Library Options angegeben sind.

Das Storage Manager zeigt den lokalen Arbeitsordner an – vorausgesetzt, die SVNDbLib-Datei ist das aktive Dokument in Altium Designer.

Um eine Bibliotheksdatei zur Bearbeitung zu öffnen, klicken Sie mit der rechten Maustaste auf ihren Eintrag im Bereich All Files des Panels und wählen Open aus dem daraufhin angezeigten Kontextmenü. Nehmen Sie die erforderlichen Änderungen vor und speichern Sie die Datei wie gewohnt mit dem Standardbefehl Save des zugehörigen Editors.

Änderungen in das Repository einchecken

Panel page: Storage Manager

Obwohl es verschiedene Möglichkeiten gibt, eine Bibliothek zur Bearbeitung zu öffnen, kann das Einchecken vorgenommener Änderungen – aus within Altium Designer – nur über das Storage Manager panel erfolgen.

Eines der wichtigsten Dinge, die Sie bei der Verwendung des Storage Manager beachten sollten, ist das Aktualisieren des Status der Verknüpfung zwischen den lokalen Arbeitsordnern/-dateien (die im Panel angezeigt werden) und den entsprechenden Ordnern/Dateien im Versionsverwaltungs-Repository. Für eine einzeln ausgewählte Bibliothek erfolgt dies mit dem Befehl Refresh, der im Rechtsklickmenü im Bereich All Files des Panels verfügbar ist. Um den Status eines gesamten Ordners schnell zu aktualisieren, verwenden Sie die Tastenkombination Ctrl+F5.

Statuseinträge, die für die Arbeit mit den lokalen Bibliotheken von Symbolen und Modellen relevant sind:

Symbol	Status	Beschreibung
	No modification	Die lokale Kopie der Bibliothek ist identisch mit der im Repository. Sie können die Datei öffnen und Änderungen vornehmen.
	Out of date	Die lokale Kopie der Datei (im Arbeitsordner) ist älter als ihr Gegenstück im Repository und daher nicht aktuell. Sie müssen die neueste Version der Datei aus dem Repository abrufen – und damit Ihre eigene lokale Arbeitskopie aktualisieren –, bevor Sie Ihre eigenen Änderungen vornehmen und einchecken können. Verwenden Sie den Befehl Update (im Kontextmenü per Rechtsklick), um die neueste Datei aus dem Repository abzurufen.
	Modified	Die lokale Kopie der Datei wurde in Altium Designer geändert und im Arbeitsordner gespeichert. Um Ihre lokalen Änderungen in das Repository zu übertragen, klicken Sie mit der rechten Maustaste auf den Dateieintrag und wählen den Befehl Commit aus dem Kontextmenü. Sobald die Datei in das Repository eingecheckt wurde, kehrt der Status zu No modification zurück.
	Conflict	Die Datei wurde von einem anderen Altium Designer-Benutzer eingecheckt, bevor Sie Ihre eigene bearbeitete und gespeicherte Version dieser Datei eingecheckt haben. Verwenden Sie den Befehl Update oder Resolve , um festzulegen, welche Version der Datei zur neuesten Revision im Repository wird.
	Locked	Die Datei wurde von Ihnen selbst oder von einem anderen Benutzer gesperrt. Eine gesperrte Datei kann von einem anderen Benutzer nicht auf eine neue Revision im Repository aktualisiert werden (es sei denn, die Sperre wird erzwungen aufgehoben). Dieser Zustand kann zusammen mit anderen Symbolen auftreten, etwa denen für Modified  oder No Modification , wenn diese Statusbedingungen ebenfalls zutreffen.

Physischer Vergleich von Revisionen

Ein physischer Vergleich kann zwischen beliebigen zwei Revisionen desselben Symbols (Modellbibliothek) durchgeführt werden. Dadurch können Sie die vorgenommenen Änderungen zwischen aufeinanderfolgenden oder nicht aufeinanderfolgenden Revisionen der Datei auf klare, visuelle Weise erkennen.

Im Storage Manager panel wird der Vergleich im Bereich VCS Revisions unten im Panel durchgeführt.

Das Storage Manager Panel zeigt zwei Ansichten für den Verlauf einer ausgewählten Datei, mit separaten Bereichen für die VCS-Revisions und die Local History.

Ein Vergleich kann zwischen beliebigen zwei Revisionen durchgeführt werden. Wählen Sie mit der Windows-Ctrl+clickAuswahltechnik die zwei Revisionen der Bibliothek aus, die Sie im VCS RevisionsBereich des Panels vergleichen möchten, klicken Sie mit der rechten Maustaste, und wählen Sie Compare.

Sobald der Compare Befehl aufgerufen wird, werden die zwei ausgewählten Dokumentrevisionen nebeneinander im Workspace geöffnet, der grafische Vergleich wird durchgeführt, und alle zwischen den beiden erkannten Unterschiede werden im Differences panel aufgelistet.

Grafischer Vergleich direkt im Designbereich des Bibliothekseditors.