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
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.
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.
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 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.
Browsing the Database Components
Sobald die DbLib/SVNDbLib zur Liste der verfügbaren dateibasierten Bibliotheken hinzugefügt wurde, stehen die Komponenten in der Datenbank im Components-Panel zum Durchsuchen zur Verfügung. Obwohl nur eine einzelne DbLib/SVNDbLib-Datei hinzugefügt wird, wird jede Tabelle in der verknüpften Datenbank so dargestellt, als wäre sie eine eigene Bibliothek.
Beachten Sie, dass bei einer Zieldatenbank, die mit mehreren Excel-Tabellendateien erstellt wurde (*.xls), aufgrund von ODBC-Treiberbeschränkungen die Anzahl der verbindbaren Tabellenblätter auf 64 begrenzt ist.
Die obere Dropdown-Liste im Panel wird mit Einträgen der folgenden Form gefüllt:
-
<LibraryName>.DbLib - <TableName> oder <LibraryName>.SVNDbLib - <TableName> ----wenn Ihre Datenbank Tabellen enthält
-
<LibraryName>.DbLib - <SheetName>$ oder <LibraryName>.SVNDbLib - <SheetName>$ ----wenn Ihre Datenbank aus Tabellenblättern in einer Excel-Tabelle besteht.
Beispiel einer geladenen DbLib mit drei Tabellen, einer weiteren mit einer Tabelle und einer SVNDbLib mit einer Tabelle.
Jeder Komponenteneintrag im Panel entspricht einem Datensatz in der jeweiligen Tabelle der Datenbank. Tatsächlich verhält sich das Components -Panel beim Durchsuchen geladener Datenbankbibliotheken wie ein direkter Datenbankbrowser. Symbol- und Modellinformationen werden aus den zugrunde liegenden Symbol- und Modellbibliotheken übernommen, auf die die entsprechenden Felder der Datenbank verweisen (in Verbindung mit den definierten Suchpfaden/-orten).
Durchsuchen von Komponenten in einer externen Datenbank, die über eine Datenbankbibliothek verknüpft ist.
Standardmäßig werden im Bereich der Komponentenliste des Panels nur die Felder Part Number und Library Ref angezeigt. Um weitere Felder in der Datenbanktabelle „sichtbar“ zu machen, klicken Sie mit der rechten Maustaste in den Bereich und wählen im Kontextmenü Select Columns. Dadurch erhalten Sie Zugriff auf den Dialog Select Columns dialog, in dem Sie die Anzeige beliebiger zusätzlicher Felder in dieser Tabelle aktivieren können.
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.
Das Dialogfeld File-based Libraries Search ermöglicht eine detailliertere Suche. Es wird geöffnet, indem Sie im Components panel auf die Schaltfläche
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).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:
-
Im Bereich Scope setzen Sie Search in auf Components und wählen Libraries on path aus.
-
Im Bereich Path setzen Sie den Path so, dass er auf den Ordner verweist, der das Bibliotheksdokument enthält, das Sie durchsuchen möchten.
-
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
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.
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
ComponentType
Zusammenfassung
Gibt alle Komponenten zurück, deren Eigenschaft Component Type der Abfrage entspricht.
Syntax
ComponentType = ComponentType_String
ComponentType_String muss einer der Strings aus der folgenden Liste sein:
-
'Graphical'
-
'Jumper'
-
'Mechanical'
-
'Net Tie'
-
'Net Tie (In BOM)'
-
'Standard'
-
'Standard (No BOM)'
Beispielverwendung
ComponentType = 'Graphical'
Gibt alle Komponenten zurück, deren Component Type Graphical ist.
ComponentType = 'Standard'
Gibt alle Komponenten zurück, deren Component Type Standard ist.
Hinweise
-
Stellen Sie sicher, dass der Suchbereich mithilfe des Feldes Components Search in im Dialog File Libraries Search dialog auf eingestellt ist.
-
Bei der Suche nach Komponenten werden alle SchLib- und IntLib-Bibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads.
-
Alle Ergebnisse werden in der Liste Query Results wieder im Components panel aufgeführt.
-
Die einfachen Anführungszeichen (') am Anfang und Ende von ComponentType_String sind zwingend erforderlich.
Designator
Zusammenfassung
Gibt alle Komponenten zurück, deren Eigenschaft Designator der Abfrage entspricht.
Syntax
Designator : String
Beispielverwendung
Designator = 'U2'
Gibt alle Komponenten zurück, deren Eigenschaft Designator U2 ist.
Designator Like '*Channel*'
Gibt alle Komponenten zurück, deren Eigenschaft Designator Channel enthält.
Designator <> 'C*'
Gibt alle Komponenten zurück, außer denen, deren Eigenschaft Designator mit C beginnt.
Hinweise
-
Stellen Sie sicher, dass der Suchbereich mithilfe des Feldes Components Search in im Dialog File Libraries Search dialog auf eingestellt ist.
-
Bei der Suche nach Komponenten werden alle SchLib- und IntLib-Bibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads.
-
Alle Ergebnisse werden in der Liste Query Results im Components panel aufgeführt.
HasModel
Zusammenfassung
Gibt jede Komponente zurück, die mit einem Domänenmodell verknüpft ist (oder darauf verweist), dessen Eigenschaften der Abfrage entsprechen.
Jede Komponente kann mit Modellen der Typen Footprint, Simulation, PCB3D, Ibis und Signal Integrity verknüpft sein. Es ist möglich, eine Komponente mit mehr als einem Modell desselben Typs zu verknüpfen, aber nur ein Modell jedes Typs kann als Current Model einer Komponente ausgewählt werden.
Syntax
HasModel(ModelType : String,ModelName : String,CurrentModelOnly : Boolean) : Boolean/Boolean_String
Der String ModelType gibt die Eigenschaft Type eines verknüpften Modells an und muss einer der Strings aus der folgenden Liste sein:
-
'PCB3DLIB' - verwenden Sie diesen String, um ein verknüpftes Modell anzusprechen, dessen Eigenschaft Type PCB3D ist.
-
'PCBLIB' - verwenden Sie diesen String, um ein verknüpftes Modell anzusprechen, dessen Eigenschaft Type Footprint ist.
-
'IBIS' - verwenden Sie diesen String, um ein verknüpftes Modell anzusprechen, dessen Eigenschaft Type Ibis Model ist.
-
'SI' - verwenden Sie diesen String, um ein verknüpftes Modell anzusprechen, dessen Eigenschaft Type Signal Integrity ist.
-
'SIM' - verwenden Sie diesen String, um ein verknüpftes Modell anzusprechen, dessen Eigenschaft Type Simulation ist.
Der String ModelName gibt die Eigenschaft Name eines verknüpften Modells an.
Der Parameter CurrentModelOnly gibt an, ob das verknüpfte Modell ein Current Model jeder Komponente sein muss oder nicht. Wenn dieser Wert False ist, muss das verknüpfte Modell kein Current Model sein (kann es aber dennoch sein); wenn dieser Wert True ist, muss das verknüpfte Modell ein Current Model sein.
Beispielverwendung
HasModel('PCBLIB','SOIC14',False)
HasModel('PCBLIB','SOIC14',False) = True
HasModel('PCBLIB','SOIC14',False) = 'True'
Gibt alle Komponenten zurück, die mit einem Footprint-Modell verknüpft sind, dessen Eigenschaft Name SOIC14 ist; dieses Modell muss nicht das Current Footprint Model jeder Komponente sein (kann es aber sein).
HasModel('PCBLIB','DIP14',True)
HasModel('PCBLIB','DIP14',True) = True
HasModel('PCBLIB','DIP14',True) = 'True'
Gibt alle Komponenten zurück, die mit einem Footprint-Modell verknüpft sind, dessen Eigenschaft Name DIP14 ist; dieses Modell muss das Current Footprint Model der Komponente sein.
HasModel('SI','RES1',False)
HasModel('SI','RES1',False) = True
HasModel('SI','RES1',False) = 'True'
Gibt alle Komponenten zurück, die mit einem Signal-Integrity-Modell verknüpft sind, dessen Eigenschaft Name RES1 ist; dieses Modell muss nicht das Current Signal Integrity Model jeder Komponente sein (kann es aber sein).
HasModel('SIM','RESISTOR',True)
HasModel('SIM','RESISTOR',True) = True
HasModel('SIM','RESISTOR',True) = 'True'
Gibt alle Komponenten zurück, die mit einem Simulationsmodell verknüpft sind, dessen Eigenschaft Name RESISTOR ist; dieses Modell muss das Current Simulation Model der Komponente sein.
Hinweise
-
Stellen Sie sicher, dass der Suchbereich mithilfe des Feldes Components Search in im Dialog File Libraries Search dialog auf eingestellt ist.
-
Bei der Suche nach Komponenten werden alle SchLib- und IntLib-Bibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads.
-
Alle Ergebnisse werden in der Liste Query Results im Components panel aufgeführt.
HasModelParameter
Zusammenfassung
Gibt jede Komponente zurück, die mit einem Domänenmodell verknüpft ist (oder darauf verweist), das ein Parameterobjekt enthält, dessen Eigenschaften Parameter Name und Value der Abfrage entsprechen.
Jede Komponente kann mit Modellen der Typen Footprint, Simulation, PCB3D, Ibis und Signal Integrity verknüpft sein. Es ist möglich, eine Komponente mit mehr als einem Modell desselben Typs zu verknüpfen, aber nur ein Modell jedes Typs kann als Current Model einer Komponente ausgewählt werden.
Syntax
HasModelParameter(Parameter Name : String,Value : String,CurrentModelOnly : Boolean) : Boolean/Boolean_String
Der Parameter CurrentModelOnly gibt an, ob das verknüpfte Modell (das einen passenden Parameter enthält) ein Current Model jeder Komponente sein muss oder nicht. Wenn dieser Wert False ist, muss das verknüpfte Modell kein Current Model sein (kann es aber dennoch sein); wenn dieser Wert True ist, muss das verknüpfte Modell ein Current Model sein.
Beispielverwendung
HasModelParameter('Inductance A','1mH',False)
HasModelParameter('Inductance A','1mH',False) = True
HasModelParameter('Inductance A','1mH',False) = 'True'
Gibt alle Komponenten zurück, die mit einem Modell verknüpft sind, das ein Parameterobjekt enthält, dessen Eigenschaft Parameter Name Inductance A ist und dessen Eigenschaft Value 1mH ist. Dieses Modell muss kein Current Model jeder Komponente sein (kann es aber sein).
HasModelParameter('Coupling Factor','0.999',True)
HasModelParameter('Coupling Factor','0.999',True) = True
HasModelParameter('Coupling Factor','0.999',True) = 'True'
Gibt alle Komponenten zurück, die mit einem Modell verknüpft sind, das ein Parameterobjekt enthält, dessen Eigenschaft Parameter Name Coupling Factor ist und dessen Eigenschaft Value 0.999 ist. Dieses Modell muss ein Current Model der Komponente sein.
Hinweise
-
Stellen Sie sicher, dass der Suchbereich mithilfe des Feldes Components Search in im Dialog File Libraries Search dialog auf eingestellt ist.
-
Bei der Suche nach Komponenten werden alle SchLib- und IntLib-Bibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads.
-
Alle Ergebnisse werden in der Liste Query Results im Components panel aufgeführt.
LibReference
Zusammenfassung
Gibt alle Komponenten zurück, deren Eigenschaft Library Reference der Abfrage entspricht.
Syntax
LibReference : String
Beispielverwendung
LibReference = 'LM833'
Gibt alle Komponenten zurück, deren Eigenschaft Library Reference LM833 ist.
LibReference Like 'C*'
Gibt alle Komponenten zurück, deren Eigenschaft Library Reference mit C beginnt.
Hinweise
-
Stellen Sie sicher, dass der Suchbereich mithilfe des Feldes Components Search in im Dialog File Libraries Search dialog auf eingestellt ist.
-
Bei der Suche nach Komponenten werden alle SchLib- und IntLib-Bibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads.
-
Alle Ergebnisse werden in der Liste Query Results im Components panel aufgeführt.
PartCount
Zusammenfassung
Gibt alle Komponenten zurück, deren Eigenschaft Part Count der Abfrage entspricht.
Syntax
PartCount : Number
Beispielverwendung
PartCount = 2
Gibt alle Komponenten zurück, deren Part Count 2 ist.
PartCount > 4
Gibt alle Komponenten zurück, deren Part Count größer als 4 ist (d. h. alle mehrteiligen Komponenten mit mehr als vier Unterteilen).
Hinweise
-
Stellen Sie sicher, dass der Suchbereich mithilfe des Feldes Components Search in im Dialog File Libraries Search dialog auf eingestellt ist.
-
Bei der Suche nach Komponenten werden alle SchLib- und IntLib-Bibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads.
-
Alle Ergebnisse werden in der Query ResultsAuflistung im Components panel angezeigt.
PinCount
Zusammenfassung
Gibt alle Komponenten zurück, deren Eigenschaft Pin Count der Abfrage entspricht.
Syntax
PinCount : Number
Beispielverwendung
PinCount = 2
Gibt alle Komponenten zurück, deren Pin Count 2 ist.
PinCount > 14
Gibt alle Komponenten zurück, deren Pin Count größer als 14 ist.
Hinweise
-
Stellen Sie sicher, dass der Suchbereich mithilfe des Feldes Components im Dialog Search inFile Libraries Search dialog festgelegt ist.
-
Bei der Suche nach Komponenten werden alle SchLib- und IntLib-Bibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads.
-
Alle Ergebnisse werden in der Query ResultsAuflistung im Components panel angezeigt.
Alle
Description
Zusammenfassung
Gibt alle Komponenten oder Footprints zurück, deren Eigenschaft Description der Abfrage entspricht.
Syntax
Description : String
Beispielverwendung
Description = 'TTL-RS232 DRIVER'
Gibt alle Komponenten oder Footprints zurück, deren Eigenschaft Description TTL-RS232 DRIVER ist.
Description Like '*RS485*'
Gibt alle Komponenten oder Footprints zurück, deren Eigenschaft Description RS485 enthält.
Hinweise
-
Die zurückgegebenen Objekte – Komponenten oder Footprints – hängen vom gewählten Bereich ab, der über das Feld Search in im Dialog File Libraries Search dialog definiert wird.
-
Alle Ergebnisse werden in der Query ResultsAuflistung im Components panel angezeigt.
HasParameter
Zusammenfassung
Gibt alle Komponenten zurück, die ein Parameterobjekt enthalten, dessen Eigenschaften Parameter Name und Value der Abfrage entsprechen.
Syntax
HasParameter(Parameter Name : String,Value : String) : Boolean/Boolean_String
Beispielverwendung
HasParameter('Comment','1K')
HasParameter('Comment','1K') = True
HasParameter('Comment','1K') = 'True'
Gibt alle Komponenten zurück, die ein Parameterobjekt enthalten, dessen Eigenschaft Parameter Name Comment ist und dessen Eigenschaft Value 1K ist.
Hinweise
-
Die zurückgegebenen Objekte – Komponenten oder Footprints – hängen vom gewählten Bereich ab, der über das Feld Search in im Dialog File Libraries Search dialog definiert wird.
-
Alle Ergebnisse werden in der Query ResultsAuflistung im Components panel angezeigt.
LibraryName
Zusammenfassung
Gibt alle Komponenten oder Footprints zurück, deren Name der übergeordneten Bibliothek der Abfrage entspricht.
Syntax
LibraryName : String
Beispielverwendung
LibraryName = 'Miscellaneous Devices.SchLib'
Gibt alle Komponenten zurück, deren übergeordnete Bibliothek Miscellaneous Devices.SchLib ist.
LibraryName Like 'Miscellaneous*.IntLib'
Gibt alle Komponenten oder Footprints zurück, deren Name der übergeordneten Bibliothek mit Miscellaneous beginnt und mit .IntLib endet.
LibraryName Like '*Vishay*'
Gibt alle Komponenten zurück, deren Name der übergeordneten Bibliothek Vishay enthält.
Hinweise
-
Die zurückgegebenen Objekte – Komponenten oder Footprints – hängen vom gewählten Bereich ab, der über das Feld Search in im Dialog File Libraries Search dialog definiert wird.
-
Bei der Suche nach Komponenten werden alle SchLib-, IntLib- und DbLib-Bibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads. Bei der Suche nach Footprints werden alle PcbLib- und IntLib-Bibliotheken durchsucht.
-
Alle Ergebnisse werden in der Query ResultsAuflistung im Components panel angezeigt.
LibraryPath
Zusammenfassung
Gibt alle Komponenten oder Footprints zurück, die sich in der als Teil der Abfrage angegebenen Bibliothek befinden.
Syntax
LibraryPath : String
Beispielverwendung
LibraryPath = 'C:\Documents\Altium\Library\MyExampleLibrary.SchLib'
Gibt alle Komponenten zurück, deren übergeordnete Bibliothek MyExampleLibrary.SchLib ist und bei denen sich diese Bibliothek im Ordner C:\Documents\Altium\Library befindet.
LibraryPath Like ' C:\Documents\Altium\Library\Miscellaneous*.IntLib'
Gibt alle Komponenten oder Footprints zurück, deren Name der übergeordneten Bibliothek mit Miscellaneous beginnt und mit .IntLib endet und bei denen sich diese Bibliothek im Ordner C:\Documents\Altium\Library befindet.
LibraryPath = 'C:\Test Projects\Example DBLib\VishayCapacitor.DBLib'
Gibt alle Komponenten zurück, deren übergeordnete Bibliothek VishayCapacitor.DBLib ist und bei denen sich diese Bibliothek im Ordner C:\Test Projects\Example DBLib befindet.
Hinweise
-
Die zurückgegebenen Objekte – Komponenten oder Footprints – hängen vom gewählten Bereich ab, der über das Feld Search in im Dialog File Libraries Search dialog definiert wird.
-
Bei der Suche nach Komponenten werden alle SchLib-, IntLib- und DbLib-Bibliotheken durchsucht, die entlang des definierten Bibliothekspfads verfügbar sind. Bei der Suche nach Footprints werden alle PcbLib- und IntLib-Bibliotheken durchsucht.
-
Alle Ergebnisse werden in der Query ResultsAuflistung im Components panel angezeigt.
Name
Zusammenfassung
Gibt alle Komponenten oder Footprints zurück, deren Name der Abfrage entspricht.
Syntax
Name : String
Beispielverwendung
Name = 'Res1'
Gibt alle Komponenten oder Footprints zurück, deren Name Res1 ist.
Name Like 'DIP*'
Gibt alle Komponenten oder Footprints zurück, deren Name mit DIP beginnt.
Name Like '*33*'
Gibt alle Komponenten oder Footprints zurück, deren Name 33 enthält.
Hinweise
-
Die zurückgegebenen Objekte – Komponenten oder Footprints – hängen vom gewählten Bereich ab, der über das Feld Search in im Dialog File Libraries Search dialog definiert wird.
-
Bei der Suche nach Komponenten werden alle SchLib- und IntLib-Bibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads. Bei der Suche nach Footprints werden alle PcbLib- und IntLib-Bibliotheken durchsucht.
-
Alle Ergebnisse werden in der Query ResultsAuflistung, zurück im Components panel, angezeigt.
-
Der Name einer Schaltplankomponente wird mit ihrer Eigenschaft Design Item ID abgeglichen, und der Name eines PCB-Footprints wird mit seiner Eigenschaft Footprint abgeglichen.
SourceLibraryName
Zusammenfassung
Gibt alle Komponenten oder Footprints zurück, deren Name der übergeordneten Quellbibliothek der Abfrage entspricht.
Syntax
SourceLibraryName : String
Beispielverwendung
SourceLibraryName = 'Miscellaneous Devices.SchLib'
Gibt alle Komponenten zurück, deren übergeordnete Quellbibliothek Miscellaneous Devices.SchLib ist.
SourceLibraryName = 'Miscellaneous Devices.PcbLib '
Gibt alle Footprints zurück, deren übergeordnete Quellbibliothek Miscellaneous Devices.PcbLib ist.
Hinweise
-
Die zurückgegebenen Objekte – Komponenten oder Footprints – hängen vom gewählten Bereich ab, der über das Feld Search in im Dialog File Libraries Search dialog definiert wird.
-
Bei der Suche nach Komponenten werden nur Quell-Schaltplanbibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads. Bei der Suche nach Footprints werden nur PCB-Bibliotheken durchsucht.
-
Alle Ergebnisse werden in der Query ResultsAuflistung im Components panel angezeigt.
SourceLibraryPath
Zusammenfassung
Gibt alle Komponenten oder Footprints zurück, die sich in der als Teil der Abfrage angegebenen Quellbibliothek befinden.
Syntax
SourceLibraryPath : String
Beispielverwendung
SourceLibraryPath = ' C:\Documents\Altium\Library\MyExampleLibrary.SchLib'
Gibt alle Komponenten zurück, deren übergeordnete Quellbibliothek MyExampleLibrary.SchLib ist und bei denen sich diese Bibliothek im Ordner C:\Documents\Altium\Library befindet.
SourceLibraryPath = ' C:\Documents\Altium\Library\Miscellaneous Devices.PcbLib'
Gibt alle Footprints zurück, deren übergeordnete Quellbibliothek Miscellaneous Devices.PcbLib ist und bei denen sich diese Bibliothek im Ordner C:\Documents\Altium\Library befindet.
SourceLibraryPath Like ' C:\Documents\Altium\Library\*'
Gibt alle Komponenten oder Footprints zurück, deren übergeordnete Quellbibliothek sich im Ordner C:\Documents\Altium\Library befindet.
Hinweise
-
Die zurückgegebenen Objekte – Komponenten oder Footprints – hängen vom gewählten Bereich ab, der über das Feld Search in im Dialog File Libraries Search dialog definiert wird.
-
Bei der Suche nach Komponenten werden nur Schaltplanbibliotheken durchsucht, die entlang des definierten Bibliothekspfads verfügbar sind. Bei der Suche nach Footprints werden nur PCB-Bibliotheken durchsucht.
-
Alle Ergebnisse werden in der Query ResultsAuflistung im Components panel angezeigt.
Footprints
Height
Zusammenfassung
Gibt alle Footprints zurück, deren Eigenschaft Height der Abfrage entspricht.
Syntax
Height : Number
Number folgt den Maßeinheiten, die aktuell für die Bibliothek verwendet werden – entweder Imperial (mil; 1 mil = 0,001 Zoll) oder metrisch (mm; 1 mm = 0,001 Meter).
Beispielverwendung
Height = 300
Gibt alle Footprints zurück, die eine Eigenschaft Height haben, die den aktuellen Maßeinheiten entsprechend gleich 300 ist.
Height >= 5.08
Gibt alle Footprints zurück, die eine Eigenschaft Height haben, die größer oder gleich 5.08 aktuellen Maßeinheiten ist.
Height <> 550
Gibt alle Footprints zurück, die eine Eigenschaft Height haben, die not gleich 550 aktuellen Maßeinheiten ist.
Hinweise
-
Stellen Sie sicher, dass der Suchbereich mithilfe des Feldes Components im Dialog Search inFile Libraries Search dialog auf festgelegt ist.
-
Bei der Suche nach Footprints werden alle PcbLib- und IntLib-Bibliotheken durchsucht – verfügbare Bibliotheken oder solche entlang eines definierten Suchpfads.
-
Alle Ergebnisse werden in der Query ResultsAuflistung im Components panel angezeigt.
PadCount
Zusammenfassung
Gibt alle Footprints zurück, deren Eigenschaft Pad Count der Abfrage entspricht.
Syntax
PadCount : Number
Beispielverwendung
PadCount = 2
Gibt alle Footprints zurück, deren Pad Count 2 ist.
PadCount > 14
Gibt alle Footprints zurück, deren Pad Count größer als 14 ist.
Hinweise
-
Stellen Sie sicher, dass der Suchbereich im Search in-Feld des Dialogs File Libraries Search dialog auf Components festgelegt ist.
-
Bei der Suche nach Footprints werden alle PcbLib- und IntLib-Bibliotheken – verfügbare oder entlang eines definierten Suchpfads – durchsucht.
-
Alle Ergebnisse werden in der Query ResultsListe im Components panel aufgeführt.