Working with the Query Language

Altium Training

Altium Essentials: PCB Global Editing and List Panel

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

W skrócie

Zarządzanie setkami obiektów projektu pojedynczo może spowalniać aktualizowanie schematów i płytek PCB. Ten artykuł przedstawia język zapytań w Altium Designer i wyjaśnia, jak używać zapytań logicznych do wyszukiwania, wyróżniania, zaznaczania i edytowania określonych grup obiektów. Omawia zakres filtrowania, tworzenie zapytań za pomocą narzędzi Query Helper i Query Builder, opcje wyświetlania oraz sposoby ponownego wykorzystywania zapytań. Na tej stronie znajdziesz również wykazy operatorów wyrażeń logicznych w zapytaniach oraz globalnych systemowych funkcji zapytań. Czytaj dalej, aby zyskać większą kontrolę nad obiektami projektu i sprawniej wprowadzać powtarzalne zmiany.

- Dowiedz się, jak zapytania pozwalają wyszukiwać określone obiekty i jak zakres filtrowania określa, które dokumenty i obiekty są przeszukiwane.
- Poznaj sposoby tworzenia i sprawdzania wyrażeń zapytań oraz sterowania zaznaczaniem, powiększaniem i maskowaniem wyników.
- Dowiedz się, jak stosować i usuwać filtry, ponownie wykorzystywać ulubione i ostatnio używane zapytania oraz używać nawiasów, aby zwiększyć czytelność wyrażeń.
Zagłęb się w temat dzięki AI:

Czym jest zapytanie?

Prawdopodobnie największym wyzwaniem podczas pracy nad złożonym projektem elektronicznym jest zarządzanie dużą liczbą obiektów projektu. Od komponentów, etykiet sieci i ciągów tekstowych na arkuszach schematu po setki komponentów i ścieżek tworzących połączenia na płytce PCB — potrzebujesz możliwości dostępu do tych obiektów, ich przeglądania i edytowania. Podobnie jak w większości aplikacji systemu Windows, możesz kliknąć obiekt dwukrotnie i edytować jego właściwości. To dobre rozwiązanie w przypadku pojedynczego obiektu, ale nie wtedy, gdy trzeba edytować ponad 300 oznaczeń komponentów lub zmienić wszystkie przelotki na płytce PCB. Przy tego rodzaju zmianach potrzebujesz dostępu do wielu obiektów jednocześnie. 

Podstawą działania edytorów schematów i PCB w Altium Designer jest zaawansowany silnik zapytań. Wprowadzając do niego zapytania, możesz filtrować obiekty, aby znaleźć i edytować dokładnie te, których potrzebujesz.

Zaawansowany system filtrowania i edycji danych w Altium Designer pozwala wskazać oprogramowaniu określony zestaw obiektów do zwrócenia. Instrukcja ta jest wprowadzana w postaci zapytania. Zapytanie to ciąg tekstowy zawierający określone słowa kluczowe i zgodny z określoną składnią, który zwraca wskazane obiekty. To, co z nimi zrobisz, zależy od Ciebie. Możesz je na przykład wyróżnić i przyciemnić wszystkie pozostałe obiekty albo przeglądać lub sortować ich właściwości i modyfikować określone atrybuty wspólne dla wszystkich tych obiektów.

Zapytania można stosować w wielu miejscach, ale głównym centrum sterowania są Filter panele pokazane na poniższych ilustracjach. Naciśnij F12, aby wyświetlić lub ukryć panel Filter .

Panele PCB Filter i SCH Filter z zapytaniamiPanele PCB Filter i SCH Filter z zapytaniami

Panele PCBLIB Filter i SCHLIB Filter z zapytaniami
Panele PCBLIB Filter i SCHLIB Filter z zapytaniami

Elementy sterujące w panelu służą do określania, do których obiektów zostanie zastosowane zapytanie oraz jak mają być traktowane obiekty spełniające jego warunki, a także te, które ich nie spełniają.

Język zapytań jest również używany w oknie dialogowym PCB Rules and Constraints Editor do definiowania zakresów reguł projektowych (więcej informacji można znaleźć na stronie Definiowanie reguł projektowych PCB, określanie ich zakresu i zarządzanie nimi). Należy pamiętać, że zbiór obiektów objętych regułą projektową zależy nie tylko od zapytania, ale także od typu reguły (na przykład reguła Width obejmuje wyłącznie ścieżki, reguła Routing Via Style — wyłącznie przelotki itd.), dlatego wyniki podświetlania lub określania zakresu obiektów przy użyciu tego samego wyrażenia zapytania w panelu Filter i w zakresie reguły mogą się różnić.

Gdzie są wyniki zapytania?

Po zapisaniu zapytania w panelu Filter jak uzyskać dostęp do zwróconych przez nie obiektów? W środowisku Altium Designer istnieją dwa sposoby uzyskiwania dostępu do obiektów i ich edycji.

  • Graficznie — po zastosowaniu filtru domyślnie maskowane są wszystkie obiekty, które nie spełniają warunków zapytania (są przygaszane i nie można ich edytować), a dostępne pozostają tylko obiekty spełniające te warunki. Ten tryb doskonale nadaje się do lokalizowania i przeglądania obiektów w obszarze roboczym. Ponieważ zamaskowanych obiektów nie można edytować, polecenia takie jak Ctrl+A (zaznacz wszystko) dotyczą wyłącznie obiektów zwróconych przez zapytanie.

  • List panel — panel List (Shift+F12) przedstawia dane projektu w widoku przypominającym arkusz kalkulacyjny. Domyślnie wyświetla wszystkie obiekty projektu, ale po zastosowaniu filtra pokazuje tylko obiekty zwrócone przez zapytanie. Panel List oferuje standardowe funkcje sortowania i zaznaczania znane z arkuszy kalkulacyjnych, umożliwiając bezpośrednią edycję jednej lub wielu komórek. 

Panele PCB List i SCH List  wyświetlają wyniki zapytań PSB/SCH z poprzedniej sekcji.Panele PCB List i SCH List  wyświetlają wyniki zapytań PSB/SCH z poprzedniej sekcji.

Opcje wyróżniania

Po każdym zastosowaniu zapytania (lub użyciu funkcji filtrowania danych w inny sposób) każdy obiekt w dokumencie docelowym zostaje uwzględniony w wynikach tego filtrowania. Jednak sposób późniejszego wyświetlania obiektów należących do wyników oraz obiektów, które do nich nie należą, zależy od opcji wyróżniania wybranych w panelu Filter . Dostępne są trzy różne opcje wyróżniania, całkowicie od siebie niezależne, więc można wybrać jedną, dwie lub wszystkie.

Powiększenie

Jeśli podczas stosowania zapytania włączona jest opcja Zoom , widok dokumentu docelowego zostaje zaktualizowany tak, aby pokazywał obszar zajmowany przez wszystkie obiekty należące do wyników. To, czy pozostałe obiekty zostaną wyświetlone w zaktualizowanym widoku, zależy od ich położenia względem tego obszaru. Każdy z nich może więc być widoczny w całości, częściowo lub wcale. 

Ta opcja jest często wybierana w połączeniu z jedną lub obiema pozostałymi opcjami. Jeśli opcja Mask nie została włączona, obiekty nienależące do wyników nadal będą wyświetlane w widoku graficznym, o ile znajdują się w jego nowych granicach. Na pierwszy rzut oka wybranie wyłącznie tej opcji może wydawać się bezcelowe, ale czasami warto zaktualizować widok graficzny tak, aby obejmował określone obiekty, bez zmiany stanu zaznaczenia ani maskowania któregokolwiek z obiektów dokumentu.

Zaznaczanie

Gdy opcja Select jest włączona, wszystkie obiekty należące do wyników są zaznaczone, a wszystkie pozostałe — niezaznaczone. Zaznaczone obiekty są wyświetlane w sposób bardziej wyróżniający się niż obiekty niezaznaczone.

Jeśli podczas stosowania bieżącego zapytania wybrana jest opcja Zaznaczanie, wszystkie obiekty należące do zbioru wyników zostają zaznaczone, natomiast wszystkie pozostałe obiekty (nienależące do zbioru wyników) tracą zaznaczenie. Tę opcję wybiera się zazwyczaj tuż przed rozpoczęciem edycji globalnej, ponieważ aktualizowane są wtedy właściwości tylko tych obiektów, które są aktualnie zaznaczone. Opcja Zaznaczanie może jednak przydać się również w innych sytuacjach, na przykład podczas przenoszenia, kopiowania lub usuwania określonych obiektów.

Maskowanie

Opcja wyróżniania Mask określa nowy stan maskowania obiektów w dokumencie docelowym. Po jej wybraniu wszystkie obiekty należące do wyników zostają zamaskowane, natomiast wszystkie pozostałe obiekty pozostają niezamaskowane. Główną cechą zamaskowanych obiektów jest brak możliwości edycji ich samych oraz ich właściwości. (Zamaskowane obiekty są wyświetlane w widoku listy jako przygaszone, ale pojawiają się w nim tylko wtedy, gdy w panelu List jest aktualnie wybrana opcja all objects .) Główną cechą zamaskowanych obiektów jest brak możliwości edycji obiektu i jego właściwości.

Kreator zapytań

Edytor PCB zawiera dedykowane okno dialogowe Query Builder. Umożliwia ono tworzenie złożonych zapytań przez wybieranie warunków z list rozwijanych. Zaletą narzędzia Query Builder jest możliwość tworzenia zapytań obejmujących różne rodzaje obiektów.

Okno dialogowe „Tworzenie zapytania” (część funkcji „Kreator zapytań”) pomaga osobom z mniejszym doświadczeniem w definiowaniu zapytań — automatycznie generuje zapytanie odpowiadające warunkom określonym przez projektanta.

Lewa część tego okna dialogowego zawiera elementy sterujące, które pomagają projektantowi określić, jakie właściwości muszą mieć obiekty dokumentu, aby zostały zwrócone przez zapytanie wygenerowane w tym oknie. Po określeniu lub edycji każdego warunku treść odpowiedniego zapytania jest aktualizowana i wyświetlana w prawej części okna dialogowego. Po zamknięciu tego okna przyciskiem OK (lub Zastosuj) powiązane zapytanie zostaje zastosowane albo jego treść zostaje skopiowana z powrotem do panelu Filtr (w zależności od sposobu otwarcia tego okna).

Okno dialogowe Query Builder można otworzyć z następujących miejsc (jak pokazano na poniższej ilustracji):

  • W panelu PCB Filter kliknij przycisk Query Builder , aby utworzyć zapytanie i wczytać jego treść do panelu.
  • W oknie dialogowym Edytor reguł i ograniczeń PCB kliknij przycisk Builder , aby utworzyć zapytanie określające, do których obiektów ma zastosowanie dana reguła. 

Gdy okno dialogowe Query Builder zostanie otwarte z poziomu okna PCB Rules and Constraints Editor, wyświetli opcje odpowiednie tylko dla danego rodzaju reguły.

Poniższa ilustracja przedstawia okno dialogowe Query Builder używane do tworzenia zapytania obejmującego zarówno pola lutownicze, jak i przelotki w sieci 5V.

Okno dialogowe Query Builder
Okno dialogowe Query Builder

  • W razie potrzeby dodaj kolejne warunki, aby zawęzić docelowy zbiór obiektów projektu. Warunki można łączyć operatorami AND lub OR. Domyślnym operatorem logicznym jest AND.
  • Aby zmienić operator logiczny między warunkami, kliknij wpis AND lub OR w kolumnie Condition Type/Operator , a następnie wybierz wymagany operator. Podgląd zapytania zostanie odpowiednio zaktualizowany.
  • Okno dialogowe Query Builder (Building Query from Board ) zapewnia prostszy sposób tworzenia zapytań z użyciem kontekstowo dobranych typów i wartości warunków, dzięki czemu można korzystać wyłącznie z odpowiednich „elementów składowych”. Do zaawansowanego tworzenia zapytań z pełnym określaniem słów kluczowych i składni operatorów służy okno dialogowe Kreator zapytań.
  • Dowolny warunek w ciągu zapytania można zmienić w każdej chwili, klikając jego wpis w kolumnie Condition Type/Operator , a następnie wybierając wymagany nowy warunek z dostępnych pozycji listy rozwijanej. Podgląd zapytania zostanie odpowiednio zaktualizowany.
  • Użyj skrótów klawiaturowych Ctrl+Up Arrow i Ctrl+Down Arrow , aby przesunąć wybrany wpis warunku w górę lub w dół struktury. 
  • Użyj skrótów klawiaturowych Ctrl+Right Arrow i Ctrl+Left Arrow , aby zwiększyć lub zmniejszyć wcięcie w wybranym miejscu struktury (dodać/usunąć nawiasy).

Kreator zapytań

Kolejnym krokiem w rozwijaniu umiejętności pisania zapytań jest korzystanie z okna dialogowego Query Helper. Okno dialogowe Query Helper zawiera pole Query , w którym można wpisać żądane zapytanie, korzystając również z przycisków składni poniżej pola Query (np. And, Or, <, Not,  Like itd.), a także z pełnej listy wszystkich słów kluczowych zapytań w polu Categories .

Okno dialogowe „Kreator zapytań” pomaga projektantom, którzy chcą definiować własne zapytania. Każde słowo kluczowe na liście ma krótki opis, a dostęp do pomocy online można uzyskać, naciskając klawisz F1, gdy dane słowo kluczowe jest zaznaczone. Spowoduje to otwarcie okna dialogowego biblioteki dokumentacji Altium Designer, które zawiera szczegółowe informacje o tym, jakie obiekty w dokumencie są zwracane przez zaznaczone słowo kluczowe, jak go używać, oraz co najmniej jeden przykład jego zastosowania.

Okno dialogowe można otworzyć na następujące sposoby:

  • Kliknij przycisk Helper w panelu Filter .

PCB Filter dostęp z panelu 

SCH Filter dostęp z panelu

Przycisk Helper jest dostępny po kliknięciu Advanced w oknie dialogowym File-based Libraries Search.

File-based Libraries Search dostęp z okna dialogowegoFile-based Libraries Search dostęp z okna dialogowego

Użyj sekcji Query u góry okna dialogowego, aby utworzyć wyrażenie zapytania przy użyciu dostępnych funkcji. W polu tekstowym można przejrzeć i dodatkowo edytować wyrażenie wyszukiwania. Aby je edytować, wpisuj tekst bezpośrednio w tym polu. Aby wyszukać konkretne słowa kluczowe do dodania, zacznij pisać. Podczas wpisywania w oknie dialogowym będzie wyświetlane menu rozwijane z dostępnymi słowami kluczowymi pasującymi do dotychczas wpisanego tekstu. Kliknij słowo kluczowe, aby automatycznie uzupełnić wpis. Jeśli żądane słowo kluczowe jest zaznaczone, naciśnięcie Enter również automatycznie uzupełni wpis.

Przejrzyj Categories dostępnych słów kluczowych, aby znaleźć potrzebne. Użyj pola Mask, jeśli nie znasz dokładnego słowa kluczowego. Na przykład w Query Helper edytora schematów wpisanie *har w polu Mask spowoduje znalezienie słów kluczowych odnoszących się konkretnie do wiązek, jak pokazano na poniższej ilustracji. Pamiętaj, że pole Mask działa zarówno w odniesieniu do pola słowa kluczowego Name , jak i pola Description , więc może być najszybszym sposobem znalezienia potencjalnych słów kluczowych.

Jeśli naciśniesz F1, gdy słowo kluczowe jest zaznaczone lub kursor znajduje się w obrębie wpisanego słowa kluczowego, otworzy się dokumentacja tego słowa kluczowego. Jest to najcenniejsze źródło informacji o podstawowym działaniu poszczególnych słów kluczowych zapytań.

Kliknij dwukrotnie słowo kluczowe w tabeli, aby dodać je do zapytania w bieżącej pozycji kursora.

Środkowy obszar okna dialogowego zawiera przyciski składni udostępniające szereg operatorów do tworzenia wyrażeń. Więcej informacji o funkcji poszczególnych przycisków składni znajdziesz poniżej w sekcji Operatory logiczne wyrażeń zapytań. Użyj przycisku Check Syntax (w lewym dolnym rogu okna dialogowego), aby sprawdzić poprawność składni wyrażenia.

Historia zapytań

Każde nowe zapytanie wprowadzone i zastosowane w panelu filtrowania (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) zostanie dodane do listy historii zapytań. Kliknij przycisk History w panelu, aby uzyskać dostęp do tej listy. Otworzy się okno dialogowe Expression Manager z aktywną kartą History .

Karta Historia w oknie dialogowym Expression Manager zawiera listę wcześniej używanych wyrażeń zapytań. Tutaj pokazano przykładową historię zapytań dla schematu. Najedź kursorem na ilustrację, aby zobaczyć podobną przykładową listę dla PCB.Karta Historia w oknie dialogowym Expression Manager zawiera listę wcześniej używanych wyrażeń zapytań. Tutaj pokazano przykładową historię zapytań dla schematu. Najedź kursorem na ilustrację, aby zobaczyć podobną przykładową listę dla PCB.

Aby użyć zapytania z historii, zaznacz jego wpis i kliknij przycisk Apply Expression lub kliknij dwukrotnie bezpośrednio ten wpis. Okno dialogowe zostanie zamknięte, a wyrażenie zapytania zostanie wczytane do środkowego obszaru odpowiedniego panelu filtrowania.

Zapytanie z historii można dodać do listy ulubionych zapytań, zaznaczając jego wpis i klikając przycisk Add To Favorites. Użyj przycisku Clear History, jeśli chcesz wyczyścić listę historii.

Maksymalnie dziewięć ostatnio używanych wyrażeń zapytań z listy będzie dostępnych w podmenu History menu kontekstowego panelu filtrowania.

Należy pamiętać, że zawartość listy History jest wspólna dla paneli filtrowania w danej domenie projektowej i dostępna z każdego z nich (SCH Filter / SCHLIB Filter w domenie edycji schematów; PCB Filter / PCBLIB Filter w domenie edycji PCB). Niektóre wyrażenia zapytań mogą nie zwracać wyników w edytorze schematów, zwłaszcza jeśli utworzono je z myślą o obiektach dostępnych wyłącznie w edytorze bibliotek schematowych.

Ulubione zapytania

Każde zdefiniowane zapytanie można dodać do listy ulubionych zapytań na dwa sposoby:

  • Kliknij przycisk Add To Favorites lub kliknij prawym przyciskiem myszy w głównym obszarze Query Expression i wybierz polecenie Add to Favorites z menu kontekstowego, aby dodać wyrażenie zapytania aktualnie zdefiniowane w środkowym obszarze aktywnego panelu filtrowania.
  • Wybierz wpis zapytania z historii na karcie History okna dialogowego Expression Manager, a następnie kliknij przycisk Add To Favorites.

Ulubione wyrażenia zapytań są przechowywane na karcie Favorites okna dialogowego Expression Manager, która służy również do zarządzania nimi. Dostęp do niej można uzyskać za pomocą przycisku Favorites w panelu filtrowania (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) lub klikając prawym przyciskiem myszy w głównym obszarze Query Expression panelu filtrowania i wybierając polecenie Organize Favorites z menu kontekstowego. Z obszaru projektowego można otworzyć to okno dialogowe za pomocą skrótu klawiaturowego Y, a następnie wybierając Organize Favorites z podręcznego menu filtrowania.

Listę ulubionych zapytań można otworzyć z panelu filtrowania edytora lub z obszaru projektowego za pomocą podręcznego menu filtrowania.Listę ulubionych zapytań można otworzyć z panelu filtrowania edytora lub z obszaru projektowego za pomocą podręcznego menu filtrowania.

Po dodaniu wyrażenia zapytania do listy Favorites zostaje mu przypisana unikatowa nazwa. Domyślnie przypisywana jest nazwa ogólna — Favorite_n — gdzie n to kolejny dostępny, nieużywany numer. Nazwę wpisu można zmienić w dowolnym momencie, korzystając z jednej z następujących metod:

  • Wybierz wpis zapytania, a następnie kliknij przycisk Rename.
  • Wybierz wpis zapytania, a następnie wybierz polecenie Edytuj z menu otwieranego prawym przyciskiem myszy.
  • Wybierz wpis zapytania, a następnie kliknij ponownie w polu Name.

W każdym przypadku wpisz żądaną nową nazwę, a następnie kliknij poza polem Name, aby zatwierdzić zmianę.

Aby edytować ulubione wyrażenie zapytania, wybierz jego wpis na liście, a następnie kliknij przycisk Edit (lub kliknij prawym przyciskiem myszy i wybierz Edit z menu kontekstowego). Otworzy się okno dialogowe Edit Favorite. Użyj go, aby zmodyfikować nazwę ulubionego zapytania, zmienić samo wyrażenie, a także określić sposób obsługi obiektów projektu (zarówno tych, które spełniają kryteria filtra, jak i tych, które ich nie spełniają).

Zmodyfikuj istniejące ulubione zapytanie za pomocą okna dialogowego Edit Favorite, pokazanego tutaj dla schematów (po lewej) i PCB (po prawej).Zmodyfikuj istniejące ulubione zapytanie za pomocą okna dialogowego Edit Favorite, pokazanego tutaj dla schematów (po lewej) i PCB (po prawej).

Aby usunąć zapytanie z listy Favorites , wybierz jego wpis na liście, a następnie kliknij przycisk Remove lub wybierz polecenie Remove z menu otwieranego prawym przyciskiem myszy. Pojawi się okno dialogowe z prośbą o potwierdzenie usunięcia.

Należy pamiętać, że zawartość listy Favorites  jest wspólna dla paneli filtrowania w danej domenie projektowej i dostępna z każdego z nich (SCH Filter / SCHLIB Filter w domenie edycji schematów; PCB Filter / PCBLIB Filter w domenie edycji PCB). Niektóre wyrażenia zapytań mogą nie zwracać wyników w edytorze schematów, zwłaszcza jeśli utworzono je z myślą o obiektach dostępnych wyłącznie w edytorze bibliotek schematowych.

Korzystanie z ulubionych zapytań

Z ulubionych zapytań można korzystać na trzy sposoby:

  1. Na karcie Favorites okna dialogowego Expression Manager — wybierz wpis zapytania, a następnie kliknij przycisk Apply Expression lub kliknij dwukrotnie jego wpis. Okno dialogowe zostanie zamknięte, a wyrażenie zapytania zostanie wczytane do środkowego obszaru odpowiedniego panelu filtrowania.

  2. W górnej części menu panelu filtrowania otwieranego prawym przyciskiem myszy (dostępnych jest maksymalnie dziesięć wyrażeń zapytań ostatnio dodanych do listy Favorites ).

  3. W podręcznym menu filtrowania obszaru projektowego (naciśnij Y) — w górnej części menu wyświetlanych jest maksymalnie dziesięć ulubionych wyrażeń zapytań. Wybrane wyrażenie zapytania zostanie wczytane do środkowego obszaru odpowiedniego panelu filtrowania.

Możesz również zdefiniować skrót klawiaturowy dla ulubionego zapytania, dostosowując menu Filter. Więcej informacji na temat dostosowywania środowiska Altium Designer znajdziesz w sekcji Konfigurowanie i dostosowywanie Altium Designer.

Korzystanie z gotowych przykładów

Zarówno edytor schematów, jak i edytor PCB zawierają zestaw gotowych przykładowych zapytań. Przykłady te są dostępne w menu filtrowania, które można otworzyć, klikając prawym przyciskiem myszy w obszarze wyrażenia w panelu filtrowania lub używając skrótu klawiaturowego Y w obszarze projektowym. Najedź kursorem na Examples, aby wyświetlić podmenu.

Po wybraniu pozycji w podmenu zostanie zastosowane zapytanie odpowiadające danemu filtrowi. Aby zobaczyć właściwe zapytanie kryjące się za jednym z przykładów, po jego zastosowaniu sprawdź listę History . Listę tę można również otworzyć w podręcznym menu filtrowania.

Aby wyczyścić filtrowanie, naciśnij Shift+C w obszarze projektowym lub kliknij prawym przyciskiem myszy w obszarze projektowym i wybierz polecenie Clear Filter z menu kontekstowego.

Narzędzia do tworzenia zapytań

Być może najłatwiejszym sposobem napisania zapytania jest zlecenie tego Altium Designer! Możesz to zrobić za pomocą okna dialogowego Find Similar Objects  lub okna dialogowego Query Builder .

Okno dialogowe Znajdź podobne obiekty

Gdy korzystasz z okna dialogowego Znajdź podobne obiekty, generuje ono zapytanie służące do wyszukania wymaganych obiektów. Jeśli opcja Create Expression jest włączona, zapytanie to zostanie wyświetlone w panelu Filter . To doskonały sposób na poznanie różnych słów kluczowych zapytań.

Okno dialogowe Find Similar Objects otwiera się po kliknięciu prawym przyciskiem myszy dowolnego niezamaskowanego obiektu w dokumencie projektu i wybraniu Find Similar Objects z menu kontekstowego.

Ilustracja po lewej: wersja PCB; ilustracja po prawej: wersja SCHIlustracja po lewej: wersja PCB; ilustracja po prawej: wersja SCH

To okno dialogowe umożliwia wyszukiwanie obiektów podobnych do obiektu klikniętego prawym przyciskiem myszy, a następnie określenie, które atrybuty obiektu muszą być takie same (lub różne), aby obiekt spełniał kryteria wyszukiwania. Załóżmy, że chcesz zmienić wszystkie pola lutownicze GND w projekcie. Możesz kliknąć prawym przyciskiem myszy jedno z takich pól, wybrać Find Similar Objects, a następnie zmienić wartość pola Net z Any (ustawienie domyślne) na Same. Wszystkie pola lutownicze GND zostaną zaznaczone po kliknięciu Apply w oknie dialogowym. Jeśli opcja Create Expression jest włączona, w panelu Filter pojawi się następujące zapytanie: (ObjectKind = 'Pad') And (Net = 'GND').

Przykładowo na schemacie można ustawić tę samą wartość właściwości Color dla wszystkich obiektów zasilania w dokumencie, które mają określoną wartość właściwości Text (np. „GND”). Z kolei na PCB można ustawić tę samą wartość właściwości Hole Size dla wszystkich przelotek w dokumencie, które mają określoną wartość właściwości Via Diameter.

Więcej informacji na temat korzystania z okna dialogowego Find Similar Objects można znaleźć w sekcji Korzystanie z narzędzi wyszukiwania podobnych obiektów.

Opcja Clear Existing

Włącz opcję Clear Existing , aby przed rozpoczęciem wyszukiwania usunąć istniejące zaznaczenie lub maskę edycji. Wyłącz tę opcję, jeśli wykonujesz kolejne wyszukiwania i chcesz, aby ich wyniki się kumulowały.

Pasek narzędzi filtrowania

Pasek Filter Toolbar jest dostępny dla dokumentów PCB i umożliwia maskowanie wszystkich obiektów w dokumencie z wyjątkiem tych, które mają określoną właściwość lub należą do określonego komponentu. Pole znajdujące się na prawym końcu paska narzędzi służy do określania treści zapytania. Możesz wpisać zapytanie w polu lub skorzystać z listy rozwijanej, aby wybrać jedno z ostatnich zapytań (znajdujących się na liście History ). Podczas stosowania zapytań z paska Filter Toolbar nie można określić używanych opcji. W każdym przypadku poprzednie zapytanie jest usuwane, a do bieżącego zapytania stosowane są opcje maskowania i powiększania. Aby korzystać z opcji zapytania, użyj panelu Filter , okna dialogowego Query Builder, okna dialogowego Query Helper lub okna dialogowego Find Similar Objects .

  • Jeśli na płytce nie poprowadzono jeszcze ścieżek, po zastosowaniu filtra widoczne staną się połączenia logiczne powiązane z wybraną siecią. Jeśli ścieżki są już poprowadzone, po zastosowaniu filtra widoczne staną się ścieżki należące do wybranej sieci.
  • Po zastosowaniu maskowania wszystkie obiekty poza zakresem filtra będą niedostępne do zaznaczania i edycji. Stopień maskowania można ręcznie dostosować za pomocą suwaka Masked Objects dostępnego w sekcji Mask and Dim Settings na karcie View Options panelu View Configuration.
  • Istniejący (i zastosowany) filtr można w dowolnym momencie ręcznie usunąć za pomocą skrótu klawiaturowego Shift+C lub klikając przycisk na pasku narzędzi Filter .

Operatory logicznych wyrażeń zapytań

Poniżej znajduje się zestawienie operatorów, których można używać podczas definiowania wyrażeń logicznych w języku zapytań.

Operatory arytmetyczne

Operator Opis Przykład
+ Operator dodawania NetPinCount + NetViaCount
- Operator odejmowania ArcStopAngle - ArcStartAngle
* Operator mnożenia PadXSize_BottomLayer * PadYSize_BottomLayer
/ Operator dzielenia HoleDiameter / ViaDiameter
Div Operator dzielenia całkowitego Color Div 65536
>Oblicza wynik dzielenia Color przez 65536 z odrzuceniem części ułamkowej wyniku
Mod Operator reszty z dzielenia Color Mod 256
Oblicza resztę z dzielenia Color przez 256, bez wyznaczania części ułamkowej wyniku

Operatory logiczne

Operator Opis Przykład
And Operator logiczny AND IsPad And OnMultiLayer
Aby obiekt został zwrócony, musi być polem lutowniczym i znajdować się na warstwie Multi-Layer
&& Operator logiczny AND
(niższy priorytet)
IsPad && OnMultiLayer
Aby obiekt został zwrócony, musi być polem lutowniczym i znajdować się na warstwie Multi-Layer
Or Operator logiczny OR IsPad Or IsVia
Aby obiekt został zwrócony, musi być polem lutowniczym lub przelotką
|| Operator logiczny OR
(niższy priorytet)
IsPad || IsVia
Aby obiekt został zwrócony, musi być polem lutowniczym lub przelotką
Xor Operator logiczny alternatywy wykluczającej XOR OnMultiLayer Xor (HoleDiameter <> 0)
Aby obiekt został zwrócony, musi znajdować się na warstwie Multi-Layer i mieć wartość Hole Diameter równą zero albo nie
znajdować się na warstwie Multi-Layer i mieć wartość Hole Diameter różną od zera.
Not Operator logiczny NOT Not OnMultiLayer
Aby obiekt został zwrócony, nie może znajdować się na warstwie Multi-Layer

Podczas używania operatora Not w wyrażeniach zapytań w edytorze PCB w celu wykluczenia obiektów podstawowych określonego typu należy pamiętać, że obiekty te nie zostaną wykluczone, jeśli należą do obiektów grupowych, a samo wyrażenie nie wyklucza również tych obiektów grupowych. Na przykład wyrażenie zapytania Not IsPad zwraca wszystkie obiekty z wyjątkiem swobodnych pól lutowniczych, ale zwraca też komponenty, które mogą zawierać pola lutownicze, więc pola lutownicze w komponentach zostaną zwrócone przez to wyrażenie. Pola lutownicze mogą również należeć do sieci, które w edytorze PCB także są traktowane jako obiekty grupowe. Aby wykluczyć wszystkie pola lutownicze, należy użyć wyrażenia zapytania Not IsPad And Not IsComponent And Not IsNet.

Operatory porównania

Operator Opis Przykład
< Operator „mniejsze niż” HoleDiameter < 40
Aby obiekt został zwrócony, musi mieć wartość Hole Diameter mniejszą niż 40
<= Operator „mniejsze lub równe” HoleDiameter <= 40
Aby obiekt został zwrócony, musi mieć wartość Hole Diameter mniejszą lub równą 40
>= Operator „większe lub równe” HoleDiameter >= 40
Aby obiekt został zwrócony, musi mieć wartość Hole Diameter większą lub równą 40
> Operator „większe niż” HoleDiameter > 40
Aby obiekt został zwrócony, musi mieć wartość Hole Diameter większą niż 40
<> Operator „różne od” HoleDiameter <> 40
Aby obiekt został zwrócony, musi mieć wartość Hole Diameter różną od 40
= Operator „równe” HoleDiameter = 40
Aby obiekt został zwrócony, musi mieć wartość Hole Diameter równą 40
Between...And... Operator przedziału domkniętego HoleDiameter Between 30 And 50
Aby obiekt został zwrócony, musi mieć wartość Hole Diameter większą lub równą 30 oraz
mniejszą lub równą 50.
Like Operator Like Name Like 'ADDR?*'
Zwraca obiekty, dla których ciąg tekstowy powiązany z właściwością Name zaczyna się od ADDR i
zawiera co najmniej jeden dodatkowy znak

Symbole wieloznaczne

Znaki wieloznaczne umożliwiają podawanie ciągów znaków, które nie są w pełni określone. Znaki te są zwykle używane w połączeniu z innymi znakami, co pozwala tworzyć częściowo określone ciągi znaków. Kilka wyjątkowych słów kluczowych może przyjmować parametry tekstowe, które nie są w pełni określone, jednak w większości przypadków ciągi znaków mogą zawierać znaki wieloznaczne tylko wtedy, gdy są porównywane za pomocą operatora Like.

Operator Opis Przykład
? Może zastępować pojedynczy znak dowolnego typu Footprint Like 'DIP1?'
Zwraca obiekty, których właściwość Footprint ma wartość DIP10, DIP12, DIP14 itd.
* Może zastępować dowolną liczbę znaków, z których każdy może być dowolnego typu Footprint Like 'SIP*'
Zwraca obiekty, których właściwość Footprint ma wartość SIP1, SIP12, SIP216 itd. (Zwracane są również wszystkie obiekty, których właściwość Footprint ma wartość SIP, ponieważ '*' może również zastępować no znaków).

Ciągi logiczne

Operator Opis Przykład
True Potwierdza znaczenie słowa kluczowego IsPad = True
Aby obiekt został zwrócony, musi być polem lutowniczym
False Neguje znaczenie słowa kluczowego IsVia = False
Aby obiekt został zwrócony, nie może być przelotką

Nawiasy okrągłe i kolejność wykonywania działań

Warto zapoznać się z kolejnością wykonywania działań obowiązującą dla operatorów używanych w logicznych wyrażeniach zapytań. Bez tej wiedzy wyrażenie może nie wskazywać wymaganych obiektów.

Nawiasy okrągłe mają najwyższy priorytet w hierarchii zdefiniowanej dla poszczególnych operatorów, która określa sposób interpretowania zapytań przez oprogramowanie (gdy użytkownik nie podał nawiasów okrągłych). Kolejność ta, od najwyższego do najniższego priorytetu, jest następująca:

  1. Nawiasy okrągłe ()
  2. Not
  3. ^, *, /, Div, Mod, And
  4. +, -, Or, Xor
  5. =, <>, <, >, <=, >=
  6. &&, ||
Ta kolejność wykonywania działań jest podobna do stosowanej w językach typu Pascal. Niejednoznaczności są rozstrzygane od lewej do prawej. Wyrażenia w nawiasach okrągłych są obliczane od najbardziej wewnętrznych do najbardziej zewnętrznych, a działania o tym samym priorytecie — od lewej do prawej.
Zdecydowanie zaleca się stosowanie nawiasów okrągłych zawsze, gdy istnieje choćby najmniejsze ryzyko nieprawidłowej interpretacji zapytania. Częste używanie nawiasów okrągłych eliminuje wątpliwości i ułatwia innym odczytywanie utworzonych zapytań.

Globalne systemowe funkcje zapytań

Globalne systemowe funkcje zapytań wyświetlane w oknie dialogowym Query Helper
Globalne systemowe funkcje zapytań wyświetlane w oknie dialogowym Query Helper

W tej sekcji szczegółowo opisano słowa kluczowe języka zapytań dostępne w dokumentach schematów, PCB i bibliotek w Altium Designer. Aby uzyskać pomoc dotyczącą konkretnego słowa kluczowego zapytania, skorzystaj z poniższych rozwijanych sekcji lub zaznacz dowolne słowo kluczowe (albo kliknij w jego obrębie) — w Query Helper, panelu Filter lub polu Query reguły projektowej PCB — i naciśnij F1, aby od razu przejść do odpowiedniej sekcji.

Szczegółowe informacje o słowach kluczowych języka zapytań dostępnych w poszczególnych edytorach i narzędziach Altium Designer można znaleźć na następujących stronach:

Funkcje arytmetyczne

Funkcje trygonometryczne

Funkcje wykładnicze i logarytmiczne

Funkcje agregujące

Funkcje systemowe

AI-LocalizedTłumaczenie SI
Jeśli znajdziesz błąd, zaznacz tekst/obraz i naciśnij Ctrl + Enter aby wysłać nam wiadomość.
Nav
Contents
Dostępność funkcji

Dostępne funkcje zależą od tego, z którego rozwiązania Altium korzystasz – Altium Develop, Altium Agile Teams, Altium Agile Enterprise lub Altium Designer (w ramach aktywnej subskrypcji terminowej).

Jeśli opisana funkcja nie jest widoczna w Twoim oprogramowaniu, skontaktuj się z działem sprzedaży Altium, aby dowiedzieć się więcej.

Starsza dokumentacja

Dokumentacja Altium Designer nie jest już wersjonowana. Jeśli potrzebujesz dostępu do dokumentacji dla starszych wersji Altium Designer, odwiedź sekcję Starsza dokumentacja na stronie Inne instalatory.

Contents