Searching for Components in Database & File-based Libraries

Altium Training

Altium Essentials: Schematic Capture

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

Verwalten verfügbarer datenbank- und dateibasierter Bibliotheken

In Altium Designer können Komponenten aus datenbank- und dateibasierten Bibliotheken nur aus Bibliotheken platziert werden, die aktuell verfügbar sind. Dazu gehören:

  • Libraries in the current project – wenn eine Bibliothek Teil des Projekts ist, sind ihre Komponenten innerhalb dieses Projekts automatisch zum Platzieren verfügbar.

  • Installed libraries – diese Bibliotheken wurden in Altium Designer installiert; ihre Komponenten stehen in jedem geöffneten Projekt zur Verfügung.

  • Libraries on a defined search path – es ist auch möglich, einen Suchpfad zu einem Ordner mit mehreren Bibliotheken zu definieren. Da bei jedem Auswählen einer neuen Komponente in einem Panel alle Dateien im Suchpfad durchsucht werden, wird dieser Ansatz nur für kleine Bibliotheken mit einfachen Modelldefinitionen empfohlen, z. B. Simulationsmodelle. Für komplexe Modelle, etwa Footprints mit 3D-Modellen, werden Suchpfade nicht empfohlen.

Zum Verwalten verfügbarer datenbank- und dateibasierter Bibliotheken können Sie den Dialog Libraries Preferences verwenden. Sie öffnen ihn, indem Sie oben im Components-Panel auf die Schaltfläche Components panel menu klicken und im Menü Libraries Preferences auswählen.

Der Dialog Libraries Preferences verfügt über drei Registerkarten. Alle auf diesen Registerkarten definierten Bibliotheken und Modellstandorte werden zusammengeführt und bilden Ihre Liste verfügbarer Bibliotheken. Wenn eine Aktion ausgeführt wird, die eine Modellsuche erfordert, z. B. die Übertragung des Designs vom Schaltplan zum PCB-Layout, werden die Bibliotheken in der Reihenfolge der Registerkarten durchsucht und innerhalb jeder Registerkarte in der Reihenfolge, in der die Bibliotheken/Modelle aufgeführt sind. Sobald das richtige Modell gefunden wurde, wird der Suchvorgang beendet. 

Projektbibliotheken

Bibliotheken, die Teil des aktiven Projekts sind, werden auf der Registerkarte Project des Dialogs Libraries Preferences aufgeführt, wenn dieses Projekt in der Software das aktive Projekt ist. Der Vorteil von Projektbibliotheken besteht darin, dass die Modelle/Bibliotheken automatisch verfügbar werden, sobald das Projekt geöffnet wird. Der Nachteil ist, dass Modelle/Bibliotheken leicht vergessen werden können, wenn sie nicht in derselben Projektordnerstruktur wie die Designdateien gespeichert sind und die Projektdateien verschoben werden.

Die Registerkarte Project  enthält eine Liste der im aktuellen Projekt verfügbaren Bibliotheken.
Die Registerkarte Project enthält eine Liste der im aktuellen Projekt verfügbaren Bibliotheken.

Jede Bibliothek kann eine Projektbibliothek sein; sie muss nicht im Projektordner gespeichert sein. Um Bibliotheken in das Projekt aufzunehmen, klicken Sie im Projects Panel mit der rechten Maustaste auf den Projektnamen und wählen den Befehl Add Existing to Project.

Installierte Bibliotheken

Bibliotheken und Modelle, die in Ihrer Softwareinstallation verfügbar gemacht wurden, werden als installierte Bibliotheken bezeichnet. Diese sind auf der Registerkarte Installed des Dialogs Libraries Preferences aufgeführt.

Diese Liste ist eine Umgebungseinstellung. Alle Bibliotheken, die dieser Liste hinzugefügt werden, stehen für alle Projekte zur Verfügung, und die Liste bleibt über Designsitzungen hinweg erhalten. Projektbibliotheken können dieser Liste hinzugefügt werden, sind jedoch anfangs nicht Teil davon.

Installierte Bibliotheken können mit einem absoluten Pfad oder mit einem Pfad relativ zur Einstellung Library Path Relative To aufgeführt werden. Der Vorteil eines relativen Pfads besteht darin, dass Sie damit eine gemeinsame Teilumgebung über mehrere PCs hinweg erstellen können, sodass sich die Designdateien leicht zwischen ihnen verschieben lassen. Außerdem können installierte Bibliotheken vorübergehend deaktiviert werden, indem das Kontrollkästchen Activated deaktiviert wird, anstatt sie zu entfernen.

Nur Activated-Bibliotheken sind über das Components Panel zugänglich.

Die Registerkarte Installed listet die Bibliotheken auf, die in dieser Installation von Altium Designer verfügbar gemacht wurden.
Die Registerkarte Installed listet die Bibliotheken auf, die in dieser Installation von Altium Designer verfügbar gemacht wurden.

Wenn Sie mit einem Altium 365 Workspace verbunden sind, wird Ihnen außerdem eine Zusammenfassung des Zustands Ihrer Workspace-Bibliothek angezeigt. Diese zeigt auf einen Blick die Anzahl der vollständig fehlerfreien Komponenten und die Anzahl der Komponenten mit mindestens einem Problem. Klicken Sie auf das Steuerelement See Details, um die Seite Components  der Browseroberfläche des Workspace in Ihrem Standard-Webbrowser zu öffnen.

Wenn Sie mit einem Altium 365 Workspace verbunden sind, können Sie eine aktuell im Rasterbereich des Dialogs ausgewählte installierte Bibliothek in den Workspace importieren, indem Sie in der ganz rechten Spalte auf Import klicken. Daraufhin wird der Library Importer in seinem einfachen Modus mit der ausgewählten Bibliothek geöffnet.

Suchpfad

Die Registerkarte Search Path zeigt eine Liste von Bibliotheken an, die anhand der auf der Registerkarte Search Paths tab of the Project Options dialog definierten Pfadeinstellungen gefunden wurden; diese öffnen Sie durch Klicken auf die Schaltfläche Paths. Jeder Suchpfad definiert einen Ordner und kann Unterordner einschließen, wenn die Option Recursive aktiviert ist (verfügbar auf der Registerkarte Search Paths des Dialogs Project Options , nachdem ein Pfad hinzugefügt wurde). Alle Modell- und Bibliotheksdateien, die im Suchpfad gefunden werden, stehen zur Verfügung. Suchpfade werden mit dem Projekt gespeichert.

Klicken Sie auf die Schaltfläche Refresh , um die Liste anhand der neuesten Suchpfade zu aktualisieren (definiert auf der Registerkarte Search Paths des Dialogs Project Options ).

Die Registerkarte Search Path listet die Bibliotheken auf, die in den definierten Suchpfaden gefunden wurden.
Die Registerkarte Search Path listet die Bibliotheken auf, die in den definierten Suchpfaden gefunden wurden.

Die Registerkarte Search Paths des Dialogs Project Options ist verfügbar, wenn die Option UI.ProjectOptions.SearchPaths im Dialog Advanced Settings dialog aktiviert ist.

Das Abrufen von Modellen über Suchpfade kann langsam sein, wenn sich in den Suchpfadordnern eine große Anzahl von Dateien befindet. Aus diesem Grund wird empfohlen, diesen Ansatz nicht für PCB-Bibliotheken zu verwenden, da diese große Dateien mit vielen Footprints sein können. Die Funktion wurde entwickelt, um eine Möglichkeit zur Referenzierung verfügbarer Simulations- und Signalintegritätsmodelle bereitzustellen.

Obwohl die Software Flexibilität und Kontrolle über bestimmte Modell-/Bibliotheksstandorte bietet, muss für jeden Modelltyp die richtige Dateierweiterung verwendet werden. Ein Footprint wird beispielsweise nur gefunden, wenn er sich in einer Datei mit der Erweiterung .Lib oder .PcbLib befindet. Ebenso wird ein SPICE-*.SUBCKT nur gefunden, wenn es sich in einer Datei  .ckt befindet, und ein SPICE-*.MODEL nur, wenn es sich in einer Datei .mdl befindet. Wenn eine Modellsuche keine Übereinstimmung ergibt, erscheint im Panel Messages eine Fehlermeldung. 

Lokales Caching von Symbolen und Modellen, die von SVN-Datenbankbibliotheken verwendet werden

Wenn eine SVNDbLib-Datei zur Liste der verfügbaren Bibliotheken hinzugefügt wird, werden die Symbol- und Modellbibliotheken im Repository in einem temporären Ordner auf dem lokalen Rechner des Designers zwischengespeichert. Wenn eine Aktion in der Software die Verwendung eines Schaltplansymbols oder Modells erfordert, wird dieses Symbol/Modell aus dem lokalen Cache abgerufen.

Automatische Cache-Aktualisierung

Die Bibliotheken im Cache werden automatisch mit dem neuesten Stand aus dem Versionsverwaltungs-Repository aktualisiert, wenn innerhalb der Software eine der folgenden Aktionen ausgeführt wird:

  • Platzieren einer Komponente aus einer installierten SVNDbLib-Datei (aus dem Components panel).

  • Durchführen einer Designübertragung (d. h. Aktualisieren des PCB).

  • Verwenden des Befehls Tools » Update From Libraries im Schaltplaneditor.

  • Verwenden des Befehls Tools » Update From PCB Libraries im PCe PCB-Editor.

Obwohl die Aktualisierung automatisch erfolgt, kann sie über die Option Do not check files more often than xx minutes auf der Seite Data Management - SVN Libraries page des Dialogs Preferences gesteuert werden. Diese Option stellt im Wesentlichen einen „Aktualisierungstimer“ für den lokalen Cache bereit. Wenn die angegebene Zeit seit der letzten Aktualisierung des Cache verstrichen ist, wird der Cache automatisch aktualisiert, sobald eine der aufgeführten Aktionen ausgeführt wird. Wird eine Aktion innerhalb dieses Zeitraums ausgeführt, wird der aktuelle Inhalt des Cache verwendet, der gegenüber dem Inhalt im Repository veraltet sein kann.

Manuelles Erzwingen einer Cache-Aktualisierung

Es kann Situationen geben, in denen Sie eine Aktualisierung des lokalen Cache erzwingen möchten, um sicherzustellen, dass Sie über die aktuellsten Bibliotheken verfügen, die derzeit im Source-Control-Repository gespeichert sind. Zum Beispiel, wenn Sie die Übertragung des Designs vom Schaltplan auf die PCB vorbereiten.

Sie können eine Aktualisierung des Cache manuell mit einer der folgenden Methoden erzwingen:

  • Über einen der Refresh Befehle im Rechtsklick-Menü des Components panel.
  • Durch Deinstallieren und erneutes Installieren der SVNDbLib-Datei in der Liste der verfügbaren Bibliotheken.
Bei jedem Neustart von Altium Designer wird der lokale Cache automatisch mit den neuesten im SVN-Repository gespeicherten Bibliotheken aktualisiert.

Suche nach Komponenten in Datenbank- und dateibasierten Bibliotheken

Um das Auffinden einer Komponente in dateibasierten (sowohl installierten als auch derzeit nicht installierten) und Datenbankbibliotheken zu erleichtern, enthält Altium Designer eine Bibliothekssuchfunktion.

Die Suche nach einer Komponente in Datenbank- und dateibasierten Bibliotheken ist über das Feld SearchComponents panelEnter möglich. Geben Sie eine Zeichenfolge ein und drücken Sie Enter, um die aktuelle Bibliothek nach dieser Zeichenfolge an beliebiger Stelle innerhalb der sichtbaren Komponentenparameter zu durchsuchen.

Sie können eine Suche direkt im Components panel durchführen.Sie können eine Suche direkt im Components panel durchführen.

Das Dialogfeld File-based Libraries Search ermöglicht eine detailliertere Suche. Es wird geöffnet, indem Sie im Components panel auf die Schaltfläche Components panel menu klicken und im Menü File-based Libraries Search auswählen. Die obere Hälfte des Dialogfelds dient dazu festzulegen, whatwonachwhat Sie suchen; die untere Hälfte dient dazu festzulegen, wherewowhere gesucht werden soll.

Suchen Sie über installierte Bibliotheken hinweg (Available libraries) oder in Bibliotheken auf der Festplatte (Libraries on path).Suchen Sie über installierte Bibliotheken hinweg (Available libraries) oder in Bibliotheken auf der Festplatte (Libraries on path).Der Suchvorgang lässt sich wie folgt zusammenfassen:

  • Die Suche wird durchgeführt, indem FiltersFilterFilters definiert werden, die auf alle Bibliotheken angewendet werden, die gemäß den aktuellen Such-ScopeBereichsScope-Einstellungen durchsucht werden können.

  • Der ScopeBereichScope umfasst den Typ der zu durchsuchenden Bibliotheken. Es kann jeweils nur ein Typ durchsucht werden.

  • Um die Suche nach Datenbankkomponenten zu aktivieren, setzen Sie das Feld Search in auf Database Components und wählen Sie die gewünschte TableTabelleTable aus. Beachten Sie, dass sich die verfügbaren Fields in der obigen Dropdown-Liste ändern, sodass sie die in der gewählten Tabelle verfügbaren Spaltenüberschriften widerspiegeln. Die übrigen Optionen im Dialogfeld werden ausgegraut, da sie bei der Suche in Datenbankbibliotheken nicht relevant sind.

  • Der ScopeBereichScope legt fest, welche Bibliotheken durchsucht werden: entweder die Bibliotheken, auf die die Software derzeit Zugriff hat (Available librariesverfügbare BibliothekenAvailable libraries), oder alle Bibliotheken innerhalb eines Ordners (Libraries on pathPfadLibraries on path).

  • Beim Durchsuchen von Bibliotheken auf einem Pfad ist das Ziel ein bestimmter Ordner und kann auch Include SubdirectoriesUnterverzeichnisse einschließenInclude Subdirectories.

  • Sie können auch innerhalb der Suchergebnisse suchen, indem Sie ScopeScopeScope auf Refine last searchQuery ResultsRefine last search setzen.

  • Klicken Sie auf Clear, um die eingegebenen Suchparameter zu löschen.

Festlegen des Suchfilters

Der Bereich Filters wird verwendet, um Textzeichenfolgen zu definieren, die bei der Suche angewendet werden sollen. Es gibt drei zu konfigurierende Bereiche:

  • Field – dies ist das Attribut der Komponente, das durchsucht werden soll. Es kann jedes Komponenten- oder Footprint-Attribut sein, einschließlich Name, Beschreibung, Kommentar, Footprint oder eines beliebigen Parameters, der einer Komponente hinzugefügt wurde. Wählen Sie ein verfügbares Feld aus der Dropdown-Liste oder geben Sie ein Feld in das Textfeld ein.

  • Operator – legt fest, wie eine Übereinstimmung bestimmt wird. Dies kann der Fall sein, wenn der Wert equalsenthältequals, containsnicht enthältcontains, starts withgleich iststarts with oder ends withungleich istends with. Beachten Sie, dass equals eine exakte Zeichenfolgenübereinstimmung erfordern und daher nur verwendet werden sollten, wenn Sie sicher sind, dass die Suchzeichenfolge korrekt und vollständig ist.

  • Value – die Zeichen, nach denen im gewählten FieldFeldField gesucht werden soll, abgeglichen gemäß dem gewählten OperatorOperatorOperator. Wählen Sie einen verfügbaren Wert aus der Dropdown-Liste oder geben Sie einen Wert in das Textfeld ein.

Standardmäßig gibt es drei Filtereinschränkungen; mit dem Steuerelement Add Row können Sie bis zu sieben zusätzliche Zeilen hinzufügen, sodass insgesamt 10 Zeilen möglich sind. Die zuletzt hinzugefügte Zeile mit Filtereinschränkungen kann mit Remove Row entfernt werden. Nicht verwendete Zeilen können entfernt werden.

Festlegen des Bereichs

Es gibt im Wesentlichen zwei Ansätze für die Suche:

  • Derzeit verfügbare Bibliotheken – dies ist die Liste der Bibliotheken, die in der Dropdown-Liste oben im Components panel angezeigt wird.

  • Bibliotheken, die in einem bestimmten Ordner gespeichert sind, zusammen mit Unterverzeichnissen, wenn die Option aktiviert ist.

Die Suche gibt alle Elemente des im Dropdown-Menü Search in ausgewählten Suchtyps (ComponentsComponentsComponents/FootprintsFootprintsFootprints/3D ModelsSymbols3D Models/Database ComponentsModelsDatabase Components) zurück, die in allen Bibliotheken gefunden werden, die unter den definierten ScopeBereichScope fallen:

  • Available libraries - aktivieren, um nach angegebenen Modelltypen nur innerhalb verfügbarer Bibliotheken zu suchen.
  • Libraries on path - aktivieren, um nach angegebenen Modelltypen innerhalb verfügbarer Bibliotheken in einem oder mehreren angegebenen Ordnern zu suchen. Im Bereich Path des Dialogfelds, der mit der ausgewählten Bereichsoption Libraries on path verfügbar wird, können Sie den Pfad festlegen, Unterverzeichnisse einbeziehen und die Dateimaske der Bibliothek angeben, um die Suchkriterien zu spezifizieren und einzugrenzen:
    • Path - bearbeiten Sie dieses Feld, um den Ordner festzulegen, in dem nach Bibliotheken gesucht werden kann, oder klicken Sie auf das Durchsuchen-Symbol am Ende des Felds, um einen Ordner auszuwählen.
    • Include Subdirectories - aktivieren, wenn Sie nach Bibliotheken im angegebenen Pfad und dessen Unterpfaden suchen möchten.
    • File Mask - geben Sie die Dateimaskenzeichenfolge ein oder wählen Sie eine der vorhandenen Dateimasken aus der Dropdown-Liste. Die Suche wird auf Treffer gefiltert, die der Zeichenfolge entsprechen. Sie können das Platzhalterzeichen * (beliebiges Zeichen) in der Zeichenfolge verwenden. Geben Sie zum Beispiel * ein, um alle Dateien zu durchsuchen, und geben Sie M ein, um alle Dateien zu durchsuchen, die mit dem Buchstaben M beginnen.

Aktivieren Sie Refine last search, um Suchkriterien anhand der Liste der Query Results aus der vorherigen Suche weiter zu verfeinern. Wenn Sie beispielsweise nach PCB-Footprints mit einem auf DIP basierenden Namen gesucht haben und nur diejenigen Footprints zurückgeben möchten, deren definierte Höhe kleiner als 100 mil ist, aktivieren Sie diese Option. Geben Sie den neuen Abfrageausdruck ein und klicken Sie dann auf Search. Die Teilmenge der vorherigen Abfrageergebnisse wird als neue Liste Query Results im Components panel angezeigt.

Wenn Sie beispielsweise eine Komponente finden möchten, von der Sie annehmen, dass sie sich in einer Bibliothek innerhalb bestimmter Ordner auf der Festplatte befindet, und diese Bibliothek derzeit nicht in Available File-based Libraries aufgeführt ist, definieren Sie die Suche wie folgt:

  1. Im Bereich Scope setzen Sie Search in auf Components und wählen Libraries on path aus.
  2. Im Bereich Path setzen Sie den Path so, dass er auf den Ordner verweist, der das Bibliotheksdokument enthält, das Sie durchsuchen möchten.
  3. Klicken Sie auf Search. Die Ergebnisse werden während der Suche im Components panel angezeigt.

Sie können Komponenten nur aus in Altium Designer installierten Bibliotheken platzieren. Wenn Sie versuchen, eine Komponente aus einer Bibliothek zu platzieren, die derzeit nicht installiert ist, müssen Sie deren Installation bestätigen.

Erweiterter Suchmodus

Die Bibliothekssuche wird tatsächlich mithilfe von Abfragen durchgeführt. Wechseln Sie im Dialogfeld File-based Libraries Search in den Modus Advanced, um die Abfrage zu prüfen. 

Im Modus Advanced des Dialogfelds können Sie auch eigene Abfragen mithilfe der Schlüsselwörter der Abfragesprache erstellen, um eine abfragebasierte Suche durchzuführen. Weitere Informationen zu verfügbaren Schlüsselwörtern der Abfragesprache finden Sie im folgenden Abschnitt.

Verwenden Sie die folgenden zusätzlichen Steuerelemente, wenn der Modus Advanced ausgewählt ist:

  • Helper - klicken Sie hier, um das Dialogfeld Query Helper zu öffnen und mit vordefinierten Bibliotheks- und Systemfunktionen einfach eine Bibliothekssuchabfrage zu erstellen. Sie können auch die Schaltflächen History und Favorites verwenden, um eine kürzlich verwendete oder vordefinierte Bibliotheksabfrage auszuwählen.

  • History - klicken Sie hier, um das Dialogfeld Expression Manager zu öffnen und einen der zuvor verwendeten Abfrageausdrücke für die Bibliothekssuche auszuwählen. Sie können auch die Schaltfläche Favorites verwenden, um eine vordefinierte Abfrage für eine angegebene Bibliothekssuche zu verwenden.

  • Favorites - klicken Sie hier, um das Dialogfeld Expression Manager zu öffnen und einen Ihrer bevorzugten Abfrageausdrücke für eine Bibliothekssuche auszuwählen. Sie können auch die Liste Favorites ändern, indem Sie Ausdrücke aus der Liste History entfernen, umbenennen oder kopieren.

Bei der Suche unter Database Components ermöglicht der Modus Advanced die Durchführung einer SQL-Abfragesuche. Diese Suchstufe bietet eine „feine“ Suche auf Basis eines angegebenen Abfrageausdrucks, bei der Sie eine SQL-Abfrage direkt in den Abfrageeditorbereich des Dialogfelds eingeben können.

Klicken Sie auf Advanced , um Zugriff auf eine leistungsstarke SQL-basierte Abfragesuche zu erhalten. Klicken Sie erneut auf Advanced , um zur einfachen Suche zurückzukehren.

Komponenten- & Bibliotheks-Abfragefunktionen

Komponenten- und Bibliotheks-Abfragefunktionen im Dialogfeld Query Helper
Komponenten- und Bibliotheks-Abfragefunktionen im Dialogfeld Query Helper

Den Schaltplan- und PCB-Editoren von Altium Designer liegt eine leistungsstarke Abfrage-Engine zugrunde. Durch Eingabe von Abfragen in diese Engine können Sie den Geltungsbereich exakt auf die Objekte eingrenzen, die Sie benötigen.

Eine Abfrage ist eine Zeichenfolge, die Sie mit bestimmten Schlüsselwörtern und einer bestimmten Syntax eingeben und die die gewünschten Objekte zurückgibt. Es stehen viele Schlüsselwörter zur Verfügung, mit denen Sie Objekte nach Typ, Eigenschaften oder beidem gezielt auswählen können.

Für einen detaillierten Überblick über die Verwendung der Abfragesprache siehe Arbeiten mit der Abfragesprache.

Die folgenden Abschnitte beschreiben die Schlüsselwörter der Abfragesprache, die bei der Suche nach datenbank- und dateibasierten Komponenten in Altium Designer verfügbar sind. Hilfe zu einem bestimmten Abfrage-Schlüsselwort finden Sie in den folgenden aufklappbaren Abschnitten, oder markieren Sie ein beliebiges Schlüsselwort (bzw. klicken Sie hinein) – im Query Helper.

Um auf die Abfragefunktionen für Komponenten und Bibliotheken zuzugreifen, klicken Sie auf die Schaltfläche Helper, die sich im Dialog File-based Libraries Search dialog befindet.

Komponenten

Alle

Footprints

AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Legacy Documentation

Altium Designer documentation is no longer versioned. If you need to access documentation for older versions of Altium Designer, visit the Legacy Documentation section of the Other Installers page.

Inhalt