Component Database to Workspace Data Synchronization
W skrócie
- Dowiedz się, jak utworzyć konfigurację synchronizacji z wykorzystaniem bibliotek bazodanowych, baz danych, arkuszy kalkulacyjnych lub plików CSV.
- Poznaj sposoby mapowania parametrów i wybranych części oraz określania, które zmiany parametrów powodują utworzenie nowych rewizji komponentów.
- Dowiedz się, jak uruchamiać synchronizację ręcznie lub planować aktualizacje niezależnie od klienta Altium Designer.
Biblioteki komponentów bazodanowych, które pobierają parametry komponentów z nadrzędnej bazy danych, można synchronizować z tą bazą po przeniesieniu biblioteki do przestrzeni roboczej Altium 365 lub przestrzeni roboczej Enterprise Server.
Przy użyciu funkcji Components Synchronization w Altium Designer, zgodnie z opisem poniżej, dane z wybranej tabeli nadrzędnej bazy danych służą do utworzenia w pełni skonfigurowanego profilu synchronizacji z określonymi mapowaniami, który można uruchamiać na żądanie lub według harmonogramu. Dzięki temu aktualizacje danych w nadrzędnej bazie danych są przenoszone do odpowiadających im parametrów komponentów w połączonej przestrzeni roboczej.
Funkcja ta pozwala firmom, które centralnie zarządzają danymi komponentów w bazie danych systemu firmowego, korzystać z zalet przestrzeni roboczej przy jednoczesnym zachowaniu synchronizacji z systemem firmowym (PLM, PDM, ERP itp.) — lub po prostu ze współdzieloną bazą danych albo plikiem CSV. W trybie automatycznej synchronizacji zadanie w Harmonogramie zadań systemu Windows aktualizuje dane w przestrzeni roboczej na podstawie bazy danych niezależnie od aplikacji projektowej Altium Designer.
Informacje o importowaniu bibliotek bazodanowych do przestrzeni roboczej zawiera sekcja Importowanie istniejących bibliotek do połączonej przestrzeni roboczej.
Tworzenie konfiguracji synchronizacji komponentów
Synchronizację bazy danych z przestrzenią roboczą ustanawia się przez utworzenie i skonfigurowanie dokumentu Components Synchronization Configuration (*.CmpSync) w Altium Designer. Po połączeniu z przestrzenią roboczą utwórz nowy dokument za pomocą polecenia menu File » New » Components Synchronization Configuration.
Dodaj żądane nadrzędne źródło danych do konfiguracji synchronizacji za pomocą przycisku
lub przeciągając odpowiednie pliki i upuszczając je w obszarze Data Sources interfejsu. Konfiguracja obsługuje następujące źródła danych parametrów komponentów:
-
Pliki bibliotek bazodanowych (
*.dBLib) — zawierające połączenie z nadrzędną bazą danych. -
Pliki baz danych Access (
*.mdb,*.accdb) -
Arkusze kalkulacyjne Excel (
*.xlsx) -
Pliki CSV (
*.csv) -
Inne źródła danych, takie jak interfejsy serwerowe zgodne z OLE DB (w tym bazy danych PostgreSQL), za pośrednictwem właściwego dla nich ciągu połączenia.
W poniższym przykładzie do konfiguracji dodano bibliotekę bazodanową komponentów diod Zener — warto zauważyć, że ta biblioteka dBLib została wcześniej przeniesiona do przestrzeni roboczej. Źródłowa baza danych biblioteki (Semi_8.mdb) zawiera tabele DiodeGP i Zeners, przy czym dla tej drugiej włączono synchronizację.
Wybierz tabelę danych (lub tabele) do synchronizacji w panelu Properties. Wybrana tabela jest następnie wykorzystywana jako źródło danych parametrycznych, które wypełnia listę Components Preview. System spróbuje określić typ komponentu (rezystor, kondensator itp.) na podstawie danych parametrów, a następnie zastosować w konfiguracji ten Component Type i odpowiadający mu Component Template — w razie potrzeby ustawienia te można wybrać ręcznie. Wybierz pozycję tabeli w obszarze Data Sources, aby zobaczyć bieżącą konfigurację w panelu Properties.
W tym przykładzie rozpoznano typ komponentu (Zeners) i zastosowano jego szablon komponentu. Szablon określa następnie docelowy folder w przestrzeni roboczej, schemat nazewnictwa komponentów oraz stosowaną definicję cyklu życia. Wpisy komponentów są dopasowywane do wpisów źródłowej bazy danych za pomocą unikatowego identyfikatora określonego w pozycji Key Parameter w panelu Properties — w tym przypadku użyto Part Number, choć równie skuteczne byłyby Name lub nawet Description.
Synchronizacja
Po zakończeniu konfiguracji synchronizacji zapisz dokument konfiguracji i zsynchronizuj komponenty biblioteczne w przestrzeni roboczej z bazą danych za pomocą przycisku
lub skonfiguruj synchronizację według harmonogramu
W poniższym przykładzie w źródłowej/nadrzędnej bazie danych zaktualizowano parametr opisu dla dwóch wpisów komponentów. Zmiany te można zobaczyć po kliknięciu przycisku odświeżania w interfejsie konfiguracji — jest to opcjonalne i nie wpływa na synchronizację zaktualizowanych danych.
Kolejna synchronizacja zaktualizuje parametry komponentów w przestrzeni roboczej na podstawie bieżących danych w polach bazy danych. Zmianę tę można zobaczyć w panelach Components i Explorer. Odśwież ich widoki odpowiednio klawiszem F5 lub przyciskiem
.
Jak widać w panelu Explorer, dla dwóch zaktualizowanych komponentów utworzono nowe rewizje. Ustawienia Parameter Mapping w konfiguracji synchronizacji określają, aktualizacja których parametrów na podstawie nadrzędnej bazy danych powoduje utworzenie nowych rewizji komponentów.
Mapowanie parametrów
Ustawienia synchronizowanych parametrów są dostępne w obszarze Parameter Mapping panelu Properties, który zawiera tabelę powiązań między docelowymi parametrami przestrzeni roboczej a parametrami (polami) źródłowej bazy danych. Dostępne są również ustawienia typu przesyłanego parametru (tekstowego lub uwzględniającego jednostki) oraz opcje sterowania tworzeniem nowych rewizji po aktualizacji parametrów.
W kontekście mapowania parametrów kolumny tabeli reprezentują parametry docelowe w przestrzeni roboczej (Parameter) oraz pola źródłowej/nadrzędnej bazy danych (Column) — tak jak dane kolumn widoczne w tabeli Components Review głównego interfejsu konfiguracji. Parametry można wykluczać z synchronizacji (pomijać) lub mapować na inne dostępne parametry. Można edytować nazwy parametrów, a także dodawać, edytować i usuwać zestawy parametrów. Podstawowe parametry komponentu (ID, Name, Description) można mapować ponownie, ale poza tym są one dostępne tylko do odczytu.
Powyższy obraz przedstawia trzy stany mapowania parametrów w panelu Properties. Po lewej pokazano stan bez zastosowanego szablonu komponentu, pośrodku — wynik wskazania szablonu, a po prawej — zmodyfikowane mapowanie parametrów i ustawienia tworzenia rewizji.
-
Obraz po lewej: domyślnie, gdy nie zastosowano szablonu, parametry są mapowane jeden do jednego między nadrzędną bazą danych a komponentami w przestrzeni roboczej. Parametr
ID, ustawiony tutaj na<Auto>, odpowiada za automatyczne utworzenie (w razie potrzeby) parametruRevision IDw przestrzeni roboczej, który jest powiązany z bieżącym ustawieniem Revision Naming Scheme elementu — w sekcji Advanced panelu. Zwróć również uwagę, że poleCommentbazy danych jest automatycznie mapowane na parametrNameprzestrzeni roboczej. -
Obraz środkowy: po zastosowaniu szablonu komponentu (tutaj
Zeners) pola parametrów bazy danych są mapowane na odpowiadające im parametry szablonu. System automatycznie rozpoznaje typowe mapowania parametrów, takie jak w tym przypadku mapowaniePin CountnaPins(parametr szablonu). Parametry, które nie są zdefiniowane w szablonie, są mapowane jeden do jednego — w tym przykładzie jest to dziewięć parametrów na dole listy. -
Obraz po prawej: część parametrów bazy danych została wykluczona z konfiguracji synchronizacji przez ustawienie trybu ich kolumn na
<Skip>. ParametrPackageReferencezostał zmapowany na poleFootprintnadrzędnej bazy danych. Opcja Revision została wyłączona dla parametrówVZ(Max),VZ(Min)iZZ(Max), co oznacza, że zmiana ich wartości w nadrzędnej bazie danych nie spowoduje utworzenia nowej rewizji w przestrzeni roboczej podczas synchronizacji — zmieniona wartość zostanie jednak standardowo przeniesiona do komponentu w przestrzeni roboczej.
Mapowanie wybranych części
Dokument konfiguracji synchronizacji komponentów pozwala definiować i synchronizować informacje o wybranych częściach. Ustawienia synchronizowanych parametrów są dostępne w obszarze Part Choices Mapping panelu Properties. Użyj przycisków u dołu tego obszaru, aby dodawać i usuwać pary parametrów wybranych części (Manufacturer / Part Number), oraz opcji menu rozwijanego, aby zdefiniować mapowanie. Po zdefiniowaniu mapowań odpowiednie parametry pojawiają się w kolumnach Part Choice n w obszarze tabeli dokumentu.
Panel właściwości
Gdy aktywnym dokumentem jest dokument konfiguracji synchronizacji komponentów (*.CmpSync), panel Properties prezentuje opcje konfiguracji. Poniższe rozwijane sekcje zawierają informacje o dostępnych opcjach i elementach sterujących.
Tabela typów komponentów
Powyższy obraz przedstawia trzy stany mapowania parametrów w panelu Properties. Po lewej pokazano stan bez zastosowanego szablonu komponentu, pośrodku — wynik wskazania szablonu, a po prawej — zmodyfikowane mapowanie parametrów i ustawienia tworzenia rewizji.
-
Reset to Default – służy do cofania wszystkich wprowadzonych zmian.
-
General
-
Component Type – wyświetla rozpoznany typ komponentu.
-
Component Template – wyświetla rozpoznany szablon komponentu, który określa docelowy folder w przestrzeni roboczej, schemat nazewnictwa komponentów i zastosowaną definicję cyklu życia.
-
Key Parameter – wyświetla kluczowy parametr dopasowany do wpisu w źródłowej bazie danych za pomocą unikatowego identyfikatora.
-
-
Advanced
-
Folder – docelowy folder w przestrzeni roboczej, w którym znajduje się komponent.
-
Revision Naming Scheme – schemat nazewnictwa używany dla rewizji obiektu w przestrzeni roboczej, określony przez zastosowany szablon lub wybrany z menu rozwijanego danego wpisu. Dostępne będą wyłącznie schematy włączone w systemie.
-
Lifecycle Definition – system cyklu życia używany dla obiektu, określony przez zastosowany szablon lub wybrany z menu rozwijanego danego wpisu. Dostępne będą wyłącznie definicje włączone w systemie.
-
Preserve lifecycle state – włącz tę opcję, aby zachować bieżące stany cyklu życia rewizji komponentów. Gdy opcja jest włączona, nowe rewizje komponentów tworzone podczas synchronizacji komponentów automatycznie otrzymują stan cyklu życia poprzedniej rewizji. Ta funkcja jest dostępna dla użytkowników z przypisanym uprawnieniem operacyjnym Allow to skip lifecycle state change for new revisions (dowiedz się więcej o ustawianiu globalnych uprawnień do operacji w przestrzeni roboczej).
-
-
Parameter Mapping – zawiera tabelę powiązań między docelowymi parametrami przestrzeni roboczej a parametrami (polami) źródłowej bazy danych. Dostępne są również ustawienia Type przesyłanego parametru (tekstowego lub uwzględniającego jednostki) oraz opcje sterowania tworzeniem nowych rewizji po aktualizacji parametrów. W kontekście mapowania parametrów kolumny tabeli reprezentują parametry docelowe w przestrzeni roboczej (Parameter) oraz pola źródłowej/nadrzędnej bazy danych (Column).
-
Add – służy do dodawania kolejnego parametru.
-
– służy do usuwania wskazanego parametru.
-
-
Part Choices Mapping – udostępnia elementy sterujące, za pomocą których można definiować pary parametrów wybranych części (Manufacturer / Part Number) na potrzeby synchronizacji informacji o wybranych częściach. Użyj opcji menu rozwijanego, aby zdefiniować mapowanie.
-
Add – służy do dodawania kolejnej pary parametrów wybranych części.
-
– służy do usuwania wskazanej pary parametrów wybranych części.
-
Uwzględnianie tabel
Table Inclusion – wyświetla listę tabel bazy danych, które można zaznaczyć do synchronizacji w panelu Properties. Są one następnie dostępne jako parametryczne źródło danych, które wypełnia listę Components Preview w menu Component Synchronization Configuration.
Zaplanowana synchronizacja
Zapisane konfiguracje synchronizacji można skonfigurować do automatycznego przetwarzania danych z bazy danych na komponenty w przestrzeni roboczej za pomocą okna dialogowego Auto Synchronization Schedule, otwieranego przyciskiem
w głównym interfejsie.
Synchronizację zgodną z bieżącym profilem konfiguracji można zaplanować na określoną godzinę każdego dnia, na określoną godzinę w wybrane dni tygodnia lub na moment logowania do systemu Windows. Można również wyłączyć synchronizację, gdy użytkownik nie jest zalogowany. Po zatwierdzeniu ustawień przyciskiem
konfiguracja zostanie dodana jako zadanie cykliczne w Windows Task Scheduler. Aby usunąć istniejący harmonogram synchronizacji, wybierz ustawienie No automatic synchronization.
Synchronizację danych z bazy danych do komponentów można również uruchomić z wiersza poleceń za pomocą aplikacji ComponentSync.Executor.exe, znajdującej się w folderze \System w katalogu instalacyjnym oprogramowania. Składnia polecenia to ComponentSync.Executor.exe [configuration file name]. Typowy przykład:
C:\Program Files\Altium\AD<Solution/Version>\System\ComponentSync.Executor.exe C:\Users\Public\Documents\Altium\CmpSync\MySyncConfig.CmpSync








