Database Library Migration Tools

Oprogramowanie Altium Design Software umożliwia umieszczanie komponentów bezpośrednio z firmowej bazy danych poprzez utworzenie i użycie biblioteki bazodanowej. Typ użytej biblioteki bazodanowej zależy od tego, w jaki sposób chcesz zarządzać źródłowymi bibliotekami symboli i modeli. Jeśli biblioteki mają być przechowywane w lokalizacji na dysku twardym lub dysku sieciowym, wystarczy użyć Database Library (DbLib). Jeśli natomiast chcesz objąć biblioteki kontrolą wersji przy użyciu repozytorium Subversion, użyjesz SVN Database Library (SVNDbLib).

Niezależnie od typu użytej biblioteki bazodanowej, podstawowa zasada działania tej funkcji w każdym przypadku pozostaje taka sama — możliwość umieszczania elementów bezpośrednio z podłączonej zewnętrznej bazy danych. Aby ta zaawansowana funkcja była jak najbardziej dostępna, udostępniono narzędzia pozwalające szybko przenieść istniejące biblioteki do struktury biblioteki bazodanowej. Narzędzia te umożliwiają migrację z:

• Z biblioteki zintegrowanej do Database Library (DbLib lub SVNDbLib).
• Z Database Library (DbLib lub SVNDbLib) do biblioteki zintegrowanej.
• Z źródłowych bibliotek schematów/PCB do SVN Database Library.
• Z Database Library do SVN Database Library.
• Z OrCAD Component Information System (CIS) do Database Library (DbLib).

Poniższe sekcje przyglądają się bliżej temu, jak te migracje są wykonywane w oprogramowaniu.

Tworzenie Database Library z biblioteki zintegrowanej

Biblioteki zintegrowane są z natury rzeczy z założenia bezpieczne. Dodatkowo cechują się idealną przenośnością dla projektów opuszczających siedzibę firmy. Jeśli projekt ma pozostać na miejscu i/lub chcesz, aby komponenty Altium Design były ściśle powiązane z firmową bazą danych, wówczas Database Libraries są idealnym wyborem. Oprogramowanie umożliwia szybkie przekształcenie firmowych bibliotek zintegrowanych do struktury Database Library (DbLib) lub SVN Database Library (SVNDbLib). Do konwersji można dołączyć wiele bibliotek zintegrowanych, przy czym każda z nich zostanie dodana jako osobna tabela w docelowej bazie danych.

Konwersja do DbLib

Utworzenie standardowej biblioteki bazodanowej (DbLib) z biblioteki zintegrowanej (IntLib) odbywa się przy użyciu Integrated Library to Database Library Translator Wizard. Kreator w praktyce dekompiluje wskazane biblioteki zintegrowane, a każda biblioteka służy do zbudowania osobnej tabeli w wybranej docelowej bazie danych, wraz z informacjami o parametrach i modelach wyodrębnionymi z zawartych w niej komponentów. Następnie używany jest wskazany plik biblioteki bazodanowej, aby zapewnić połączenie z tą bazą danych.

Wprowadzenie jednej lub wielu źródłowych bibliotek zintegrowanych do struktury biblioteki bazodanowej jest procesem uproszczonym, realizowanym przy użyciu Integrated Library to Database Library Translator Wizard.

Proces obejmuje następujące kroki:

1. Utwórz nowy lub otwórz istniejący plik biblioteki bazodanowej (*.DbLib). Zwykle używa się istniejącego pliku DbLib podczas konwersji jednej lub wielu bibliotek zintegrowanych do istniejącej bazy Access, z którą ten plik DbLib jest aktualnie połączony.
2. Mając otwarty plik Database Library (*.DbLib) jako aktywny dokument, wybierz polecenie Tools » Import From Integrated Libraries z głównego menu, aby uzyskać dostęp do Integrated Library to Database Library Translator Wizard.

3. Użyj początkowej strony Specify your Database details kreatora, aby wskazać docelową bazę danych — nową bazę Access lub istniejącą. Jeśli tworzysz nową bazę danych, kliknij symbol folderu po prawej stronie pola Database Location, aby otworzyć standardowe okno dialogowe Open . W tym oknie określ, gdzie i pod jaką nazwą ma zostać utworzona nowa baza danych. Wybrana nazwa/ścieżka zostanie wpisana do pola Database Location.

   

   Jeśli kreator został uruchomiony z istniejącego pliku DbLib, opcja Existing Access Database będzie domyślnie zaznaczona a pole Database Location będzie wstępnie wypełnione bazą danych, z którą łączy się ten plik DbLib.

4. Użyj kolejnej strony Specify your Target Database Library kreatora, aby wskazać docelowy plik biblioteki bazodanowej. Podaj ścieżkę i nazwę nowego pliku DbLib, który ma zostać utworzony, albo wskaż i otwórz istniejący plik. Zwykle używa się istniejącego pliku DbLib podczas konwersji jednej lub wielu bibliotek zintegrowanych do istniejącej bazy Access, z którą plik DbLib jest aktualnie połączony. Domyślnie aktywny plik DbLib zostanie wstępnie wpisany w to pole.

   

   Jeśli użyjesz istniejącego pliku DbLib i zmienisz docelową bazę danych, po zakończeniu pracy kreatora plik DbLib zostanie połączony z nową docelową bazą danych.

5. Użyj następnej strony Locate the Integrated Libraries to Import kreatora, aby wskazać biblioteki zintegrowane, które chcesz przekonwertować. Użyj przycisku Add, aby otworzyć okno dialogowe Select Source Integrated Libraries, w którym możesz przejść do i wybrać wymagane biblioteki. Składowe biblioteki symboli schematowych i modeli (jeśli istnieją) zostaną wyodrębnione i zapisane w lokalizacji wskazanej w polu Destination Folder. Użyj przycisków Remove  oraz Clear , aby usunąć z listy lub skasować wybraną bibliotekę.

   

   Domyślnie Destination Folder będzie wskazywać podfolder — Libraries — znajdujący się poniżej folderu zawierającego plik DbLib (wskazany na poprzedniej stronie kreatora).

6. Po wybraniu źródłowych bibliotek zintegrowanych kliknij Next, aby rozpocząć konwersję. Zostanie wyświetlony pasek postępu wraz z informacją o aktualnie tłumaczonej bibliotece. Po zakończeniu konwersji kliknij Finish na ostatniej stronie kreatora, aby uaktywnić wskazany plik DbLib w głównym oknie projektowym (jeśli nie jest już aktywny).

   

   Każda biblioteka zintegrowana uwzględniona w konwersji spowoduje utworzenie osobnej tabeli w bazie danych, nazwanej tak jak biblioteka zintegrowana. W przypadku istniejącej bazy danych, jeśli tabela o tej samej nazwie co biblioteka zintegrowana już istnieje, informacje z tej biblioteki zostaną dopisane do istniejącej tabeli.

Plik DbLib po zakończeniu procesu translacji.

Po zakończeniu procesu translacji możesz następnie przejść do źródłowych bibliotek schematowych i usunąć z symboli wszystkie informacje o parametrach i modelach. Następnie możesz wprowadzić wymagane drobne zmiany konfiguracyjne w mapowaniach pól w dokumencie DbLib, aby odwoływały się do odpowiednich kolumn bazy danych, zgodnie z potrzebą. Więcej informacji znajdziesz w sekcji Mapping Database Fields to Design Parameters na stronie Creating & Defining the Database Library.

Konwersja do SVNDbLib

Utworzenie biblioteki bazodanowej z kontrolą wersji (SVNDbLib) z biblioteki zintegrowanej (IntLib) odbywa się przy użyciu SVN Database Library Conversion Wizard. Kreator w praktyce dekompiluje wskazane biblioteki zintegrowane, przy czym każda biblioteka służy do zbudowania osobnej tabeli w nowej docelowej bazie danych, wraz z informacjami o parametrach i modelach wyodrębnionymi z zawartych w niej komponentów. Następnie tworzony jest wskazany plik SVNDbLib, który służy do zapewnienia połączenia z tą bazą danych. Składowe biblioteki schematowe i PCB są rozdzielane i commitowane do wskazanych katalogów w wybranym repozytorium kontroli wersji SVN, do których odwołuje się plik SVNDbLib.

Wprowadzenie jednej lub wielu źródłowych bibliotek zintegrowanych do struktury biblioteki bazodanowej SVN jest procesem uproszczonym, realizowanym przy użyciu SVN Database Library Conversion Wizard.

Proces obejmuje następujące kroki:

1. Uzyskaj dostęp do SVN Database Library Conversion Wizard. Można to zrobić poprzez:

• Wybranie polecenia Tools » SVN Database Library Maker z głównego menu edytora biblioteki schematowej, edytora biblioteki PCB lub edytora biblioteki bazodanowej.
• W panelu Projects panel kliknięcie prawym przyciskiem myszy wpisu biblioteki projektu (SchLib, PcbLib lub IntLib), a następnie wybranie polecenia SVN Database Library Maker z menu kontekstowego.

2. Użyj strony Libraries to Convert, aby wskazać biblioteki zintegrowane, które chcesz przekonwertować. Lista będzie początkowo wstępnie wypełniona jedną lub kilkoma bibliotekami (aktywną biblioteką lub wszystkimi bibliotekami projektu dodanymi do projektu — w zależności od użytej metody dostępu). Usuń je z listy przed wybraniem bibliotek zintegrowanych, które chcesz przekonwertować. Użyj przycisku Add, aby otworzyć okno dialogowe Library Files, w którym możesz przejść do i wybrać wymagane biblioteki zintegrowane.

3. Użyj strony Options , aby zdefiniować opcje związane z konwersją, w tym sposób podziału bibliotek źródłowych, w jakich katalogach którego repozytorium mają być przechowywane, oraz katalog wyjściowy dla pliku SVNDbLib. Dla biblioteki schematowej dostępne są także dwie opcje umożliwiające usunięcie informacji o parametrach i/lub modelach z każdego składowego komponentu, pozostawiając jedynie „goły” symbol.

   Repozytorium SVN i jego struktura folderów muszą być zdefiniowane wcześniej. Jedynie je wskazujesz oraz foldery w jego strukturze, do których mają zostać zapisane rozdzielone pliki bibliotek. Repozytorium i foldery nie są tworzone „w locie”.
4. Po wybraniu źródłowych bibliotek zintegrowanych i ustawieniu wymaganych opcji konwersji kliknij Next , aby rozpocząć konwersję. Zostanie wyświetlony pasek postępu wraz z informacją o aktualnie konwertowanej bibliotece. Proces konwersji obejmuje:
   1. Wyodrębnienie bibliotek źródłowych z dostarczonych bibliotek zintegrowanych.
   2. Podzielenie bibliotek schematowych i PCB na pojedyncze pliki bibliotek symboli/footprintów.
   3. Zatwierdzenie (commit) podzielonych bibliotek symboli i footprintów do repozytorium w określonych katalogach bazowych.
   4. Kreator wyodrębnia wyłącznie informacje o odwołaniach do modeli footprintów. Powiązane modele symulacyjne są obsługiwane dla biblioteki bazy danych z kontrolą wersji (SVNDbLib), jednak przechowywanie plików modeli symulacyjnych w repozytorium Subversion nie jest obsługiwane. Tam, gdzie takie łącza istnieją, zostaną dodane jako parametry.
   5. Zbudowanie osobnej tabeli bazy danych w wygenerowanej bazie Access (która przyjmuje tę samą nazwę, co określona dla SVNDbLib) dla każdej konwertowanej biblioteki zintegrowanej, wraz z informacjami o parametrach i modelach wyodrębnionymi z zawartych w niej komponentów. Każda tabela jest nazywana przy użyciu nazwy biblioteki zintegrowanej z sufiksem _IntLib (np. Capacitor - Ceramic_IntLib).
   6. Utworzenie wskazanego pliku SVNDbLib i połączenie z bazą danych oraz repozytorium.
5. Po zakończeniu konwersji kliknij Finish , aby zamknąć Kreatora i ustawić plik SVNDbLib jako aktywny dokument.

Plik SVNDbLib wynikowy po zakończeniu procesu konwersji.

Tworzenie biblioteki zintegrowanej z biblioteki bazy danych

Biblioteki bazodanowe są idealnym wyborem, jeśli chcesz, aby komponenty Altium Design były ściśle powiązane z firmową bazą danych. Jeśli projekt musi opuścić siedzibę firmy lub jeśli wolisz, aby projektanci pracowali na bezpiecznych bibliotekach zintegrowanych, można to łatwo osiągnąć. Oprogramowanie umożliwia kompilację biblioteki zintegrowanej bezpośrednio z biblioteki bazy danych — zarówno standardowej biblioteki bazy danych (DbLib), jak i biblioteki bazy danych SVN z kontrolą wersji (SVNDbLib). Dzięki temu bibliotekarze CAD mogą nadal używać bibliotek bazodanowych, podczas gdy projektanci korzystają z regularnie odtwarzanych bibliotek zintegrowanych, pracując niejako w trybie „offline”.

Konwersja jest wykonywana przy użyciu Offline Integrated Library Maker. Proces jest realizowany osobno dla każdej tabeli bazy danych, z pełną kontrolą nad tym, które tabele w bazie są brane pod uwagę. W procesie konwersji uwzględniane są komponenty schematowe, PCB, PCB3D oraz modele symulacyjne. Dla każdej uwzględnionej tabeli zostanie wygenerowana osobna biblioteka zintegrowana. Tabele te są tłumaczone na indywidualne biblioteki zintegrowane, które następnie są dodawane do Installed Libraries.

Konwertuj biblioteki bazodanowe (DbLib lub SVNDbLib) na „offline” biblioteki zintegrowane przy użyciu Offline Integrated Library Maker.

Proces obejmuje następujące kroki:

1. Mając otwarty jako aktywny dokument plik Database Library (*.DbLib) lub plik SVN Database Library (*.SVNDbLib), który chcesz skonwertować, wybierz polecenie Tools » Offline Integrated Library Maker z menu głównego, aby uzyskać dostęp do Offline Integrated Library Maker.

2. Użyj strony Library to Convert, aby wskazać DbLib lub SVNDbLib do przetworzenia. Aktywna biblioteka, z której uruchomiono Offline Integrated Library Maker , zostanie domyślnie wskazana jako biblioteka do konwersji. W razie potrzeby możesz swobodnie przeglądać i wybrać inną bibliotekę bazodanową.

   

3. Użyj strony Options, aby określić, które tabele w podłączonej bazie danych mają zostać uwzględnione w konwersji. Domyślnie uwzględniane są wszystkie tabele. Aby wykluczyć tabelę, upewnij się, że powiązana z nią opcja Convert jest wyłączona. Ta strona umożliwia również wskazanie katalogu wyjściowego, w którym będą przechowywane wygenerowane biblioteki zintegrowane. Wpisz ścieżkę do tego katalogu bazowego bezpośrednio lub kliknij ikonę po prawej stronie pola, aby otworzyć okno dialogowe, w którym możesz przejść do wymaganego katalogu i go wybrać. Wygenerowany wynik (biblioteka zintegrowana) dla każdej uwzględnionej tabeli bazy danych zostanie zapisany w osobnym podfolderze w określonym katalogu wyjściowym, nazwanym zgodnie z nazwą tabeli.

   

4. Po wybraniu biblioteki bazodanowej i ustawieniu wymaganych opcji konwersji kliknij Next , aby rozpocząć konwersję. Zostanie wyświetlony pasek postępu wraz z informacją o aktualnie konwertowanej tabeli bazy danych. Pamiętaj, że proces konwersji jest wykonywany dla każdej tabeli bazy danych, którą wskazałeś do konwersji. Poniżej przedstawiono zasadniczy podział tego procesu:
   1. Tworzony jest pakiet biblioteki zintegrowanej (*.LibPkg) i otwierany w panelu Projects panel. Pakiet jest nazywany zgodnie z nazwą tabeli. Dla tabeli o nazwie Capacitor - Ceramic da to na przykład Capacitor - Ceramic.LibPkg.
   2. Tworzony jest dokument biblioteki schematowej i dodawany do LibPkg. Schemat jest ponownie nazywany zgodnie z nazwą tabeli (np. Capacitor - Ceramic.SchLib).
   3. Następnie rozpatrywany jest każdy rekord w tabeli i budowany jest odpowiedni komponent Altium Design. W tym celu pobierany jest wskazany symbol schematowy z odpowiedniej biblioteki źródłowej i dodawany jako komponent do nowego dokumentu biblioteki schematowej. Następnie do tego komponentu dodawane są informacje o parametrach i łączach do modeli zdefiniowane w rekordzie.
   4. Wskazane modele footprintów dla rekordu są pobierane i dodawane do dokumentu biblioteki PCB. Dokument ten jest ponownie nazywany zgodnie z nazwą tabeli (np. Capacitor - Ceramic.PcbLib). Następnie dokument biblioteki PCB jest dodawany do LibPkg.
   5. Jeśli biblioteka źródłowa jest typu DbLib i w rekordzie bazy danych zdefiniowano łącza do modeli symulacyjnych, wskazane pliki modeli symulacyjnych są również dodawane do LibPkg. Lokalizacja takich modeli pozostaje niezmieniona. Pełna ścieżka do modelu jest określana jako część odpowiadającego mu łącza modelu.
   6. Następnie LibPkg jest kompilowany w celu utworzenia biblioteki zintegrowanej (np. Capacitor - Ceramic.IntLib), która jest potem dodawana do Installed Libraries oprogramowania.

   

Aktualnie zainstalowane biblioteki można wyświetlić na karcie Installed w oknie dialogowym Available File-based Libraries dialog, do którego można przejść, klikając przycisk w prawym górnym rogu panelu Components panel, a następnie wybierając File-based Libraries Preferences.

Wyniki procesu konwersji — projekty pakietów bibliotek z dokumentami składowymi symboli i modeli footprintów oraz skompilowane IntLiby, które są również dodawane jako zainstalowane biblioteki, a tym samym udostępniane wszystkim projektom PCB.

Tworzenie SVNDbLib z bibliotek źródłowych (SCHLib/PCBLib)

SVN Database Library Conversion Wizard pomaga konwertować biblioteki schematowe, PCB, bazodanowe i zintegrowane na biblioteki bazodanowe SVN. Kreator ten usprawnia proces przekształcania różnych metod zarządzania komponentami w SVN Database Library (*.SVNDBLib). SVN Database Library zachowuje możliwość umieszczania komponentów bezpośrednio z bazy danych i rozszerza tę metodę łączenia tak, aby umożliwić biblioteki z kontrolą źródła — przechowujące symbole schematowe i modele footprintów w repozytorium opartym o Subversion. Łącze do repozytorium i do zewnętrznej bazy danych jest zdefiniowane w pliku SVN Database Library (*.SVNDBLib), będącym rozszerzeniem pliku Database Library (*.DBLib) i często określanym jako Version-Controlled Database Library.

Użyj Kreatora, aby zdefiniować opcje związane z konwersją, w tym sposób dzielenia bibliotek źródłowych, w jakich katalogach którego repozytorium mają być przechowywane oraz katalog wyjściowy dla pliku SVNDBLib.

Musisz wybrać, które biblioteki bazodanowe lub schematowe (*.SchLib), PCB (*.PcbLib) lub zintegrowane (*.IntLib) mają zostać skonwertowane, a następnie zatwierdzone (checked in) do repozytorium SVN. Zostanie również utworzona pojedyncza biblioteka bazy danych SVN.

W tym Kreatorze masz możliwość zdefiniowania połączenia z repozytorium SVN, katalogu bazowego dla symboli i modeli oraz ścieżki do dokumentu biblioteki bazy danych SVN. Domyślnie katalog wyjściowy zostanie ustawiony na ten sam katalog, w którym przechowywana jest biblioteka źródłowa.

Jeśli chcesz, aby wygenerowany plik SVNDBLib i baza danych znajdowały się w tej samej lokalizacji, masz zasadniczo dwie opcje. Pierwsza to ustawienie ścieżki wyjściowej dla SVNDBLib na ten sam katalog, w którym aktualnie znajduje się baza danych. Druga opcja to wygenerowanie SVNDBLib w innym katalogu, a następnie przeniesienie bazy danych do tego katalogu. W takim przypadku musisz pamiętać, aby zmodyfikować połączenie w pliku SVNDBLib tak, by wskazywało bazę danych w nowej lokalizacji, i ponownie się połączyć.

Wprowadzenie jednej lub większej liczby źródłowych bibliotek schematowych i PCB do struktury biblioteki bazy danych SVN jest procesem usprawnionym dzięki SVN Database Library
Conversion Wizard.

Proces obejmuje następujące kroki:

1. Otwórz SVN Database Library Conversion Wizard w jeden z poniższych sposobów:

   • Kliknij Tools » SVN Database Library Maker z poziomu pliku biblioteki schematu (*.SchLib), pliku biblioteki PCB (*.PcbLib), pliku biblioteki zintegrowanej (*.IntLib) lub pliku biblioteki bazodanowej (*.DbLib). Jeśli jednak chcesz uwzględnić w konwersji powiązane modele footprintów podczas uruchamiania Kreatora z biblioteki schematu, musisz wskazać i dodać odpowiednie biblioteki footprintów PCB. Ponadto sama konwersja bibliotek footprintów PCB nie jest typowym scenariuszem, dlatego musisz wskazać i dodać odpowiednie biblioteki komponentów schematu.
   • W panelu Projects kliknij prawym przyciskiem wpis wymaganej biblioteki (*.SchLib, *.PcbLib lub *.IntLib), a następnie wybierz SVN Database Library Maker. Kreator automatycznie załaduje wszystkie biblioteki projektu. To zdecydowanie najprostsza metoda i wymaga, aby źródłowe biblioteki schematu i PCB były dodane do projektu. Często tak właśnie jest, gdy nie użyto bibliotek zintegrowanych.
   Kreator wstępnie wypełnia listę wpisów bibliotek na podstawie miejsca, z którego został uruchomiony; aby zaoszczędzić czas, uruchamiaj Kreatora z odpowiedniego edytora, zgodnie z poniższym opisem.

   

2. Użyj strony Libraries to Convert, aby wybrać biblioteki, które chcesz skonwertować. Wybierz spośród Database Libraries lub Schematic, PCB i Integrated Libraries. Wybrane biblioteki zostaną podzielone na pojedyncze biblioteki komponentów, a następnie zapisane (checked in) w repozytorium SVN. Zostanie utworzona pojedyncza baza danych SVN.

   • Converting a Database Library

     

     Podczas konwersji Database Libraries proces konwersji obejmuje:

     1. Podział bibliotek schematu i PCB, do których odwołują się rekordy komponentów w powiązanej bazie danych, na pojedyncze pliki bibliotek symboli/footprintów.
     2. Zatwierdzenie (commit) podzielonych bibliotek symboli i footprintów do repozytorium, w określonych katalogach bazowych.
     3. Utworzenie wskazanego pliku SVNDBLib i połączenie z bazą danych oraz repozytorium.

   • Converting Schematic, PCB, and Integrated Libraries

     

     Użyj przycisku Add, aby otworzyć standardowe okno dialogowe wyszukiwania i wybrać żądany plik do dodania. Kliknij przycisk Remove , aby usunąć aktualnie zaznaczoną bibliotekę.

     Podczas konwersji Schematic, PCB i Integrated Libraries proces konwersji obejmuje:

     1. Wyodrębnienie bibliotek źródłowych z dostarczonych bibliotek zintegrowanych.
     2. Podział bibliotek schematu i PCB na pojedyncze pliki bibliotek symboli/footprintów.
     3. Zatwierdzenie (commit) podzielonych bibliotek symboli i footprintów do repozytorium w określonych katalogach bazowych.
     4. Kreator wyodrębni wyłącznie informacje o odwołaniach do modeli footprintów. Powiązane modele PCB3D i modele symulacyjne nie są obsługiwane dla SVNDBLib. Tam, gdzie takie powiązania istnieją, zostaną dodane jako parametry.
     5. Zbudowanie osobnej tabeli bazy danych w wygenerowanej bazie Access dla każdej konwertowanej biblioteki schematu i/lub biblioteki zintegrowanej, wraz z informacjami o parametrach i modelach wyodrębnionymi z komponentów. Każda tabela jest nazywana na podstawie nazwy biblioteki schematu z sufiksem _SchLib (np. Mixer_SchLib) i/lub na podstawie nazwy biblioteki zintegrowanej z sufiksem _IntLib (np. AD Differential Amplifier_IntLib).
     6. Utworzenie wskazanego pliku SVNDBLib i połączenie z bazą danych oraz repozytorium.

3. Użyj strony Options, aby zdefiniować opcje związane z konwersją, w tym sposób podziału bibliotek źródłowych, w jakich katalogach którego repozytorium mają zostać zapisane oraz katalog wyjściowy dla pliku SVNDbLib. Dla biblioteki schematu dostępne są także dwie opcje umożliwiające usunięcie informacji o parametrach i/lub modelach z każdego składowego komponentu, pozostawiając jedynie „goły” symbol.

   

   Repozytorium SVN i jego struktura folderów muszą zostać zdefiniowane wcześniej. Wskazujesz jedynie repozytorium oraz foldery w jego strukturze, w których mają zostać zapisane podzielone pliki bibliotek. Repozytorium i foldery nie są tworzone „w locie”.

   SVN Options

   Użyj tego obszaru, aby zdefiniować ustawienia połączenia z repozytorium SVN. 

   Użyj listy rozwijanej Method, aby wybrać metodę połączenia: file (repozytorium oparte na plikach), http (repozytorium w chmurze), https (bezpieczne repozytorium w chmurze), svn lub svn+ssh. 

   Obszar Location  (dostępny tylko, gdy dla Method wybrano file) służy do ustawienia ścieżki lokalizacji repozytorium. Użyj ikony przeglądania folderów, aby wyszukać i wybrać żądaną lokalizację. 

   Obszar Server (dostępny tylko, gdy dla Method wybrano file jako not) służy do ustawienia żądanego serwera.

   Ustaw Server Port na Default lub Non-Default. Jeśli wybrano Non-Default, wprowadź port serwera w polu tekstowym. Musisz także wprowadzić nazwę Repository folder w polu tekstowym.

   Server PortOpcje Repository folder i są dostępne tylko wtedy, gdy wybrane Method to not file. 

   Wskaż bazowy katalog repozytorium dla Symbols i Footprints, klikając ..., aby wyszukać i wybrać odpowiednie foldery dla obu.

   SVN DB Library Options

   Obszar SVN DB Library Options umożliwia określenie ścieżki dokumentu biblioteki bazodanowej SVN. Jeśli obecnie nie istnieje żadna „backendowa” baza Access, zostanie utworzona w tym samym folderze. Użyj ikony przeglądania folderów, aby wyszukać i wybrać ścieżkę.

   Jeśli chcesz, aby wygenerowany plik SVNDBLib i baza danych znajdowały się w tej samej lokalizacji, masz zasadniczo dwie opcje. Pierwsza to ustawienie ścieżki wyjściowej dla SVNDBLib na ten sam katalog, w którym aktualnie znajduje się baza danych. Druga opcja to wygenerowanie SVNDBLib w innym katalogu, a następnie przeniesienie bazy danych do tego katalogu. W takim przypadku musisz pamiętać, aby zmodyfikować połączenie w pliku SVNDBLib tak, by wskazywało bazę danych w nowej lokalizacji, i ponownie się połączyć.

   Library Splitting Options

   Użyj listy rozwijanej, aby wybrać, czy pliki mają być Overwrite Existing Files czy Append Incrementing Number To File Names (aby tworzyć nowo dopisywane pliki podczas dzielenia bibliotek). Gdy wybrano Overwrite Existing Files, wszelkie istniejące pliki w repozytoriach zostaną nadpisane podczas dzielenia bibliotek. Jeśli wybrano Append Incrementing Number To File Names, wszystkie pliki w określonych repozytoriach będą chronione i nie zostaną nadpisane, a nowe biblioteki komponentów o tej samej nazwie otrzymają dopisany sufiks „_#IncrementNumber”.

   Dla biblioteki schematu dostępne są także dwie opcje umożliwiające usunięcie informacji o parametrach i/lub modelach z podzielonych komponentów schematu, pozostawiając jedynie „goły” symbol. Zaznacz Remove All Parameters i/lub Remove All Models. Ponieważ zewnętrzna baza danych już istnieje — powiązana z oryginalnym plikiem DBLib — nie zostanie utworzona nowa. Baza danych pozostanie w swojej bieżącej lokalizacji.

4. Po wybraniu źródłowych bibliotek schematu i PCB oraz ustawieniu wymaganych opcji konwersji kliknij Next , aby przejść do konwersji. Zostanie wyświetlony pasek postępu wraz z informacją o aktualnie konwertowanej bibliotece. Proces konwersji obejmuje:
   1. Podział bibliotek schematu i PCB na pojedyncze pliki bibliotek symboli/footprintów.
   2. Zatwierdzenie (commit) podzielonych bibliotek symboli i footprintów do repozytorium, w określonych katalogach bazowych.
   3. Kreator wyodrębni wyłącznie informacje o odwołaniach do modeli footprintów. Powiązane modele symulacyjne są obsługiwane dla biblioteki bazodanowej z kontrolą wersji (SVNDbLib), jednak przechowywanie plików modeli symulacyjnych w repozytorium Subversion nie jest obsługiwane. Tam, gdzie takie powiązania istnieją, zostaną dodane jako parametry.
   4. Zbudowanie osobnej tabeli bazy danych w wygenerowanej bazie Access (która przyjmuje tę samą nazwę, co wskazana dla SVNDbLib) dla każdej konwertowanej biblioteki schematu, wraz z informacjami o parametrach i modelach wyodrębnionymi z zawartych w niej komponentów. Każda tabela jest nazywana na podstawie nazwy biblioteki schematu z sufiksem _SchLib (np. Capacitor - Ceramic_SchLib).
   5. Utworzenie wskazanego pliku SVNDbLib i połączenie z bazą danych oraz repozytorium.
5. Po zakończeniu konwersji kliknij Finish , aby zamknąć kreatora, i ustaw plik SVNDbLib jako aktywny dokument.

Wynikowy plik SVNDbLib po zakończeniu procesu konwersji.

Konwersja DbLib do SVNDbLib

Być może już korzystasz z możliwości funkcji Database Library po przekonwertowaniu istniejących bibliotek zintegrowanych do struktury DbLib lub po utworzeniu DbLib od podstaw. Rozwijając to podejście, możesz chcieć przenieść źródłowe biblioteki symboli i footprintów pod ochronne i bezpieczne skrzydła repozytorium kontroli wersji. Oprogramowanie udostępnia środki do przeprowadzenia tej migracji z bieżącej standardowej biblioteki bazodanowej (DbLib) do biblioteki bazodanowej z kontrolą wersji (SVNDbLib).

Konwersję wykonuje się za pomocą SVN Database Library Conversion Wizard w zasadzie w taki sam sposób, jak podczas konwersji biblioteki zintegrowanej.

Konwersja istniejącej standardowej biblioteki bazy danych (DbLib) do biblioteki bazy danych z kontrolą wersji (SVNDbLib) to usprawniony proces z użyciem SVN Database
Library Conversion Wizard.

Proces obejmuje następujące kroki:

1. Otwórz istniejącą DbLib do konwersji następnie wybierz Tools » SVN Database Library Maker z menu głównego. Zostanie otwarte okno SVN Database Library Conversion Wizard.
2. Użyj strony Libraries to Convert, aby wskazać źródłową bibliotekę bazy danych, którą chcesz przekonwertować. Opcja Database Libraries będzie już włączona, a powiązane pole wstępnie wypełnione ścieżką do aktywnej biblioteki. Jeśli chcesz przekonwertować inną DbLib, kliknij przycisk  i w wyświetlonym oknie dialogowym wskaż ją.
3. Po kliknięciu Next wybrany plik DbLib jest analizowany i pojawia się okno potwierdzenia informujące, że bazowa baza danych może zostać zmodyfikowana. Kliknij Yes , aby kontynuować.
4. Użyj strony Options , aby zdefiniować opcje związane z konwersją — w tym sposób podziału bibliotek źródłowych, w jakich katalogach którego repozytorium mają być przechowywane oraz katalog wyjściowy dla pliku SVNDbLib. Dla biblioteki schematów dostępne są także dwie opcje pozwalające usunąć informacje o parametrach i/lub modelach z każdego składowego komponentu pozostawiając jedynie „goły” symbol.

5. Po wybraniu źródłowego pliku DbLib i ustawieniu wymaganych opcji konwersji kliknij Next , aby rozpocząć konwersję. Zostanie wyświetlony pasek postępu wraz z informacjami o konwertowanej bibliotece. Proces konwersji obejmuje:
   1. Podział bibliotek schematów i PCB, do których odwołują się rekordy komponentów w powiązanej bazie danych, na pojedyncze pliki bibliotek symboli/footprintów.
   2. Zatwierdzenie (commit) podzielonych bibliotek symboli i footprintów do repozytorium w określonych katalogach bazowych.
   3. Utworzenie wskazanego pliku SVNDbLib i połączenie z bazą danych oraz repozytorium.
6. Po zakończeniu konwersji kliknij Finish , aby zamknąć kreator i ustawić plik SVNDbLib jako aktywny dokument.

Wynikowy plik SVNDbLib po zakończeniu procesu konwersji.

Kilka słów o mapowaniach pól

W wygenerowanym SVNDbLib mapowania zdefiniowane pomiędzy polami w bazie danych a parametrami projektu na karcie Field Mappings pozostają takie, jak pierwotnie zdefiniowano je w DbLib.

Mapowania pól pozostają takie same pomiędzy oryginalnym DbLib a wygenerowanym SVNDbLib.

Istnieją jednak dwa ważne obszary, na które warto zwrócić uwagę:

• Wszelkie zdefiniowane mapowania ścieżek dla symboli i modeli footprintów są ignorowane. SVNDbLib używa wyłącznie zmapowanych pól referencyjnych — [Library Ref] i [Footprint Ref] — do lokalizowania wymaganego symbolu i footprintu w bibliotekach zatwierdzonych w repozytorium. Informacje o ścieżkach zdefiniowane w bazie danych są ignorowane, ponieważ wskazują biblioteki znajdujące się na dysku twardym lub innym nośniku lokalnym/sieciowym.

• Wszelkie zdefiniowane mapowania modeli symulacyjnych również pozostaną zdefiniowane w pliku SVNDbLib. Jednak przechowywanie plików modeli symulacyjnych w repozytorium Subversion nie jest obsługiwane. Chociaż odnośniki do modeli zostaną dodane do instancji komponentu podczas wstawiania, same modele nie zostaną odnalezione.

Bezpośrednia obsługa OrCAD^® CIS

Oprogramowanie, zbudowane na fundamencie systemu bibliotek bazodanowych, zapewnia pełną obsługę połączenia z i wykorzystania istniejących systemów OrCAD Component Information Systems (CIS). Struktura CIS jest zasadniczo konwertowana do struktury Standard Database Library (DbLib) w Altium Designer.

Od OrCAD do Altium Designer — wymagane translacje

Aby umożliwić bezpośrednie wstawianie z zewnętrznej bazy danych (*.mdb, *.xls), wymagane są następujące translacje plików:

• Plik konfiguracji OrCAD CIS (*.dbc), który obsługuje łącze do zewnętrznej bazy danych i zawiera informacje o mapowaniu pól bazy danych na parametry projektu, musi zostać przetłumaczony na plik Database Library w Altium Designer (*.DbLib).

• Odpowiednie pliki bibliotek OrCAD muszą zostać przetłumaczone na pliki bibliotek Altium Designer:
  • Biblioteka OrCAD Capture (*.olb) ---> Biblioteka schematów (*.SchLib).
  • Plik biblioteki OrCAD Max (*.llb) ---> Biblioteka PCB (*.PcbLib).

Automatyczne tworzenie Database Library

Najprostszą i najwydajniejszą metodą utworzenia pliku DbLib oraz źródłowych bibliotek Altium Designer jest użycie Import Wizard (File » Import Wizard). Na drugiej stronie kreatora upewnij się, że jako typ importowanego pliku wybrano pozycję OrCAD CIS Configuration Files and Libraries.

Postępuj zgodnie z kolejnymi stronami kreatora, na których należy wskazać:

• Lokalizację zewnętrznej bazy danych.
• Lokalizację pliku konfiguracji CIS (*.dbc) — pamiętaj, że musi to być format binarny, a nie XML.
• Gdzie i pod jaką nazwą ma zostać utworzony docelowy plik DbLib.
• Biblioteki schematów i/lub PCB OrCAD, do których odwołuje się zewnętrzna baza danych.

Po wskazaniu wymaganych plików i katalogów źródłowych oraz docelowych kliknij Next, aby rozpocząć import. Po zakończeniu importu kliknij Finish , aby zamknąć kreator i ustawić plik DbLib jako aktywny dokument.

Rzeczy, o których warto pamiętać:

• Ścieżka wyszukiwania bibliotek jest automatycznie dodawana do pliku DbLib na karcie Symbol & Model Search Paths w oknie Database Library Options dialog i wskazuje katalog zawierający przetłumaczone pliki bibliotek.
• Informacje o mapowaniu parametrów — w tym zdefiniowany klucz wyszukiwania — są pobierane bezpośrednio z pliku konfiguracji OrCAD CIS.
• Automatycznie ustawiane są dwa wpisy mapowania modeli. Przykładowe nazwy pól bazy danych dla nich oraz przypisane wpisy Design Parameter to:
  • Footprint Name ---> [Orcad Footprint]
  • Symbol Name ---> [Orcad Library]

Wpisy te zapewniają łącze do źródłowego symbolu schematowego dla danego rekordu komponentu w zewnętrznej bazie danych oraz do właściwego modelu footprintu PCB powiązanego z tym komponentem.

• Określ wymagane opcje aktualizacji zmapowanych parametrów. Więcej informacji znajdziesz w sekcji Mapping Database Fields to Design Parameters dokumentu Creating & Defining the Database Library.

Ręczne tworzenie Database Library

1. Utworzenie pliku DbLib przy użyciu Import Wizard to najszybsza metoda, ale nie jedyna. Możesz również utworzyć plik DbLib ręcznie. Aby to zrobić:
2. Utwórz nowy plik DbLib, połącz go z zewnętrzną bazą danych oraz zdefiniuj mapowanie i opcje aktualizacji parametrów zgodnie z potrzebami.
3. Następnie musisz zaimportować biblioteki OrCAD. Można to zrobić, używając Import Wizard do przetłumaczenia plików bibliotek OrCAD (*.olb, *.llb) na biblioteki Altium Designer (*.SchLib, *.PcbLib).

   1. Podczas wyboru typów plików do importu wybierz pozycję OrCAD Designs and Libraries Files.

   2. Pomiń stronę dla Importing OrCAD Designs i przejdź do strony dla Importing OrCAD Libraries. Dodaj wszystkie źródłowe biblioteki OrCAD, do których odwołuje się baza danych.

   3. Pomiń pozostałe kolejne strony dotyczące importu plików projektowych.

   4. Na stronie Output Library Options pozostaw włączoną domyślną opcję Output Libraries as PCB Project.

   5. Na stronie Output Libraries wskaż katalog wyjściowy dla wygenerowanych plików bibliotek.

4. Po zakończeniu importu w wybranym katalogu zostanie utworzony folder o nazwie Imported OrCAD Libraries.PrjPcb. Wygenerowane biblioteki Altium Designer możesz w razie potrzeby przenieść w inne miejsce. Na przykład możesz przenieść biblioteki do folderu o nazwie Libraries, utworzonego w katalogu zawierającym plik DbLib.
5. Gdy masz już biblioteki symboli i footprintów, musisz wrócić do pliku DbLib i skonfigurować ścieżki wyszukiwania bibliotek (na karcie Symbol & Model Search Paths w oknie dialogowym Database Library Options dialog), tak aby wskazywały na folder katalogu, w którym te biblioteki są przechowywane.