Acquiring Workspace Data Using the Content Cart
W skrócie
- Odkryj, jak dodawać do Content Cart pojedyncze rewizje, wiele elementów lub całe foldery.
- Dowiedz się, jak skonfigurować foldery docelowe, definicje cyklu życia i schematy nazewnictwa przed przeniesieniem danych.
- Poznaj kluczowe kwestie związane z pozyskiwaniem danych, w tym powiązane elementy podrzędne, wcześniej pozyskane rewizje i wymagania dotyczące połączenia z obszarami roboczymi.
Funkcja pozyskiwania danych w przestrzeni roboczej udostępnia wygodne narzędzie służące do kopiowania danych między dwiema przestrzeniami roboczymi (zobacz informacje o zgodności). Narzędziem, które to umożliwia — interfejsem usługi pozyskiwania danych — jest Content Cart. To centrum sterowania, w którym określasz, co ma zostać pobrane ze źródłowej przestrzeni roboczej i przeniesione do wskazanej docelowej przestrzeni roboczej — niezawodny samochód przeprowadzkowy, który „przewozi” wybrane dane między przestrzeniami roboczymi.
Nic nie ilustruje działania funkcji lepiej niż przykład. Aby więc przedstawić szczegóły działania narzędzia Content Cart i jego zastosowania do pozyskiwania danych, w tym artykule omówiono przenoszenie komponentów między następującymi przestrzeniami roboczymi:
-
Source Server — przestrzeń robocza o nazwie
Company Workspace. -
Target Server — druga przestrzeń robocza o nazwie
Secondary Company Workspace.
Dostęp do koszyka
Okno dialogowe Content Cart można otworzyć z poziomu panelu Explorer. Podczas przeglądania źródłowej przestrzeni roboczej, z której chcesz pobrać dane, kliknij prawym przyciskiem myszy rewizję elementu, którą chcesz pozyskać, i wybierz polecenie Operations » Add to Content Cart z menu kontekstowego. Możesz dodać jedną lub więcej zaznaczonych rewizji elementów, a nawet folder elementów. Przy pierwszym otwarciu koszyka zostają do niego dodane rewizje elementów zaznaczone w tym momencie w źródłowej przestrzeni roboczej:
- Jedna określona rewizja elementu.
- Kilka określonych rewizji tego samego elementu.
- Najnowsze rewizje wielu elementów.
- Najnowsze rewizje wszystkich elementów w wybranym folderze (i jego podfolderach). Umożliwia to dodanie do koszyka całego folderu z zachowaniem jego struktury. Aby pozyskać folder (wraz z jego podfolderami), zaznacz go w obszarze Server Folders źródłowej przestrzeni roboczej (w panelu Explorer ), a następnie kliknij prawym przyciskiem myszy i wybierz polecenie Operations » Add to Content Cart z menu kontekstowego.

Przykład uzyskiwania dostępu do Content Cart.
Elementy, które można pozyskać
Za pomocą funkcji pozyskiwania danych można przenosić ze źródłowej do docelowej przestrzeni roboczej następujące typy elementów:
- Model 3D
- Preferencje Altium Designer
- Komponent (wraz z powiązanymi wyborami części)
- Szablon komponentu
- Karta katalogowa
- Obudowa PCB
- Zarządzany arkusz schematu
- Zadanie wyjściowe
- Szablon schematu
- Skrypt
- Model symulacyjny
- Symbol
Ponadto podczas pozyskiwania folderu elementów ze źródłowej przestrzeni roboczej obsługiwane są następujące typy folderów:
- Komponenty
- Folder ogólny
Kwestie do uwzględnienia podczas pozyskiwania danych
Podczas pozyskiwania danych należy uwzględnić następujące kwestie:
- Można pozyskiwać wyłącznie elementy danych mające w źródłowej przestrzeni roboczej stan wydany.
- Pozyskiwana jest tylko wybrana rewizja elementu źródłowego, a nie wszystkie rewizje, które mogą istnieć dla tego elementu.
-
Podczas pozyskiwania rewizji źródłowego elementu typu Komponent lub Zarządzany arkusz schematu pozyskiwane są również wszystkie powiązane elementy podrzędne:
- Component Item — odpowiednie rewizje następujących powiązanych obiektów podrzędnych: element symbolu, elementy obudów PCB, elementy modeli 3D, element modelu symulacyjnego, element szablonu komponentu, elementy kart katalogowych oraz powiązania wyboru części.
Należy pamiętać, że parametr Typ komponentu nie jest przenoszony podczas pozyskiwania danych, więc przeniesione komponenty pojawią się w lokalizacji Uncategorized przestrzeni docelowej zarówno w panelu Components w Altium Designer, jak i na stronie Components przestrzeni roboczej. Żądany typ komponentu można przypisać jednemu lub wielu wpisom komponentów za pomocą operacji Change Component Type w panelu Explorer w Altium Designer.
- Managed Schematic Sheet Item — odpowiednie rewizje następujących powiązanych obiektów podrzędnych: elementy komponentów, elementy symboli, elementy obudów PCB, elementy modeli 3D, elementy modeli symulacyjnych, elementy szablonów komponentów, elementy kart katalogowych oraz element szablonu schematu.
- Cykl życia pozyskanej rewizji elementu źródłowego przyjmie początkowy stan „po wydaniu”, zgodnie z definicją cyklu życia przypisaną do elementu docelowego. Historia cyklu życia rewizji elementu źródłowego zostanie pominięta.
- Jeśli z jakiegokolwiek powodu nie można pozyskać elementu podrzędnego wybranego źródłowego elementu typu Komponent lub Zarządzany arkusz schematu, pozyskiwanie tego komponentu lub zarządzanego arkusza schematu nie zostanie przeprowadzone.
Proces pozyskiwania danych — podsumowanie
Użyj Content Cart, aby pozyskać wszystkie potrzebne dane. Proces pozyskiwania elementów danych z serwera źródłowego jest prosty i można go podsumować w następujących krokach:
-
Jako serwer źródłowy automatycznie wybierany jest aktualnie aktywny serwer, ale można go zmienić na inny podłączony serwer za pomocą menu wyboru dostępnego w lewym górnym rogu panelu Explorer.
-
Użyj menu rozwijanego z nazwą serwera docelowego w koszyku Content Cart (wyróżnionego na niebiesko), aby wybrać inny serwer docelowy z listy aktualnie podłączonych serwerów. Wybierz opcję Server Administration, aby włączyć lub wyłączyć połączenia z serwerami. W przypadku komponentów jako miejsce docelowe można również wskazać zapisany lokalnie plik biblioteki zintegrowanej (IntLib).
-
Początkowa rewizja elementu jest wyświetlana w głównej tabeli. Do koszyka można dodać dowolną liczbę kolejnych rewizji elementów. W tym celu kliknij przycisk Add More Items w prawym górnym rogu okna dialogowego i wybierz pozycję Select, aby otworzyć okno dialogowe Choose Item (będące odmianą panelu Explorer). Możesz w nim przeglądać serwer źródłowy w poszukiwaniu kolejnych elementów i dodawać je pojedynczo lub zbiorczo, korzystając ze standardowych narzędzi zaznaczania wielu pozycji. Możesz też wybrać pozycję Add manually, aby otworzyć okno dialogowe Add new items. To okno umożliwia wklejenie zewnętrznej listy potrzebnych elementów (po jednym elemencie w każdym wierszu), które następnie można wyszukać na serwerze źródłowym według wybranego kryterium wyszukiwania (GUID, Item ID, Name lub MPN). Jeśli uznasz, że niektóre rewizje elementów nie mają jednak zostać pozyskane, zaznacz je i usuń z listy (kliknij przycisk
-
Kliknij element sterujący Change Settings w prawym dolnym rogu okna dialogowego Content Cart, aby otworzyć okno dialogowe Content Cart Structure. W tym miejscu możesz zdefiniować opcje domyślne dla każdego typu elementów danych obsługiwanego przez funkcję pobierania. Obejmuje to określenie domyślnego folderu na serwerze docelowym, a także domyślnej definicji cyklu życia, schematów nazewnictwa elementów i ich rewizji oraz indeksu początkowego. Możesz również dodać notatkę z przydatnymi informacjami o pobieraniu dla innych osób przeglądających pobraną zawartość.
-
Po wybraniu odpowiednich elementów źródłowych kliknij przycisk
. Spowoduje to przygotowanie serwera docelowego do pobierania: sprawdzenie stanu wybranych rewizji elementów (na wypadek, gdyby zostały już wcześniej pobrane), powiązań nadrzędny–podrzędny oraz zaproponowanie wymaganego działania, którym w przypadku pobierania nowych elementów będzie Transfer new revision and item. Chociaż na tym etapie przygotowania stosowane są wcześniej określone domyślne opcje pobierania, w razie potrzeby można indywidualnie zmodyfikować właściwości proponowanych elementów docelowych. W tym celu zaznacz element na liście i kliknij przycisk
.
-
Po zakończeniu przygotowania kliknięcie przycisku
rozpocznie pobieranie. Pojawi się pierwsze okno dialogowe potwierdzenia — kliknij Yes, aby rozpocząć przesyłanie zawartości między serwerem źródłowym a docelowym. Drugie okno dialogowe potwierdzi wynik pobierania — pobrane elementy na serwerze docelowym możesz przeglądać w panelu Explorer.
Pobrane dane zachowują powiązanie z pierwotnym źródłem. Informacje o tym powiązaniu można wyświetlić, przełączając kartę widoku aspektu docelowej rewizji elementu na Origin.
Określanie źródłowej i docelowej przestrzeni roboczej
Dwie przestrzenie robocze uczestniczące w pobieraniu są określane w górnej części okna dialogowego Content Cart. Źródłowa przestrzeń robocza jest ustalana automatycznie na podstawie lokalizacji rewizji elementów wskazanych do pobrania — zazwyczaj jest to przestrzeń robocza, do której jesteś obecnie zalogowany (Company Workspace w tym przykładzie). Jeśli masz połączenie z wieloma przestrzeniami roboczymi, kliknij nazwę docelowej przestrzeni roboczej lub element sterujący
po jej prawej stronie, aby otworzyć listę rozwijaną aktualnie połączonych przestrzeni roboczych. W razie potrzeby wybierz inną przestrzeń roboczą.

Określanie źródłowej i docelowej przestrzeni roboczej uczestniczących w pobieraniu.
Nadawanie nazwy koszykowi
Dane pobierane ze źródłowej przestrzeni roboczej zostaną skopiowane do nowych rewizji elementów w docelowej przestrzeni roboczej. Domyślnie elementy te zostaną umieszczone w określonej, nowo utworzonej strukturze folderów w tej docelowej przestrzeni roboczej. Folder najwyższego poziomu przeznaczony na pobraną zawartość otrzymuje nazwę samego koszyka. Domyślna nazwa ma format Content Cart - <Current Date> - <Current Time> i jest ustalana w momencie otwarcia koszyka. W razie potrzeby można ją zmienić na bardziej opisową, klikając element sterujący Change po prawej stronie nazwy koszyka.
W wyświetlonym oknie dialogowym Content Cart Name Selection wpisz preferowaną nazwę koszyka. Możesz też wybrać folder w docelowej przestrzeni roboczej, do którego ma trafić zawartość koszyka. Może to być istniejący folder lub zupełnie nowy, utworzony na bieżąco. Odszukaj i wybierz istniejący folder dla koszyka w oknie dialogowym Choose Folder, otwieranym po kliknięciu przycisku
na prawym końcu pola Content Cart Name. Możesz też utworzyć nowy folder w strukturze folderów za pomocą poleceń z menu kontekstowego.

Obiektowi Content Cart można nadać dowolną nazwę. Zmień nazwę koszyka (jego zawartość trafi wtedy do folderu najwyższego poziomu o tej nazwie) lub wybierz opcję umieszczenia zawartości koszyka w określonym folderze.
Określanie elementów do pobrania
Główny obszar okna dialogowego Content Cart zawiera „tabelę pobierania” — listę wszystkich rewizji elementów wybranych do pobrania ze źródłowego obszaru roboczego. Do Content Cart można „załadować” dowolną liczbę rewizji elementów danych przeznaczonych do pobrania ze źródłowego obszaru roboczego. Przy pierwszym otwarciu koszyka są do niego ładowane rewizje elementów zaznaczone w źródłowym obszarze roboczym w chwili otwarcia, ale można dodać dowolną liczbę kolejnych elementów. W tym celu kliknij Add More Items w prawym górnym rogu okna dialogowego i wybierz pozycję Select, aby otworzyć okno dialogowe Choose Item (uproszczoną wersję panelu Explorer). W tym oknie możesz przeglądać źródłowy obszar roboczy w poszukiwaniu kolejnych elementów. Pamiętaj, że możesz dodać:
- Jedną konkretną rewizję elementu.
- Kilka konkretnych rewizji tego samego elementu.
- Najnowsze rewizje wielu elementów.
- Najnowsze rewizje wszystkich elementów w wybranym folderze (i jego podfolderach).
Możesz też wybrać pozycję Add manually, aby otworzyć okno dialogowe Add new items. Umożliwia ono wklejenie zewnętrznej listy potrzebnych elementów (po jednym elemencie w wierszu), które następnie można wyszukać w źródłowym obszarze roboczym według wybranego kryterium wyszukiwania (GUID, Item ID, Name lub MPN).

Główna tabela pobierania z listą wszystkich rewizji elementów wybranych do pobrania ze źródłowego obszaru roboczego.
Przygotowanie koszyka
Po wybraniu źródłowych rewizji elementów należy „przygotować do dostarczenia” Content Cart do docelowego obszaru roboczego. W tym celu kliknij przycisk
. Spowoduje to przygotowanie docelowego obszaru roboczego do pobierania — sprawdzenie statusu wybranych rewizji elementów (na wypadek, gdyby zostały już wcześniej pobrane), powiązań nadrzędny–podrzędny oraz zaproponowanie działania do wykonania. Wyniki tego etapu przygotowania są prezentowane w głównej tabeli pobierania.

Przykładowy Content Cart, przygotowany do dostarczenia do docelowego obszaru roboczego.
Dla każdej rewizji elementu objętej pobieraniem sekcja Source tabeli rozwija się, pokazując wszystkie powiązane rewizje elementów podrzędnych oraz, opcjonalnie, folder, w którym znajdują się one w źródłowym obszarze roboczym. Dla każdej rewizji elementu (zarówno nadrzędnego, jak i podrzędnego) w sekcji Target tabeli mogą być wyświetlane następujące informacje:
- Revision ID — pełny identyfikator rewizji elementu w docelowym obszarze roboczym, oparty na schematach nazewnictwa elementów i rewizji zdefiniowanych dla danego typu elementu.
- Folder — folder docelowy w docelowym obszarze roboczym, w którym pobrana rewizja elementu zostanie utworzona/umieszczona.
- Life Cycle — definicja cyklu życia określona dla elementu nadrzędnego.
- Naming Scheme — schemat nazewnictwa rewizji zdefiniowany w celu identyfikowania rewizji elementu nadrzędnego.
- Note — opcjonalna notatka, która może przekazywać innym użytkownikom przydatne informacje o pobieraniu podczas przeglądania pobranej zawartości w obszarze roboczym.
-
Status — bieżący stan rewizji elementu w docelowym obszarze roboczym. Możliwe stany:
-
Not found— rewizja elementu nigdy nie była pobierana. -
Already Exists— rewizja elementu została już wcześniej pobrana.
-
-
Action — działanie wymagane do zsynchronizowania źródłowego i docelowego obszaru roboczego. Możliwe działania:
-
Transfer new revision and item— w przypadku zupełnie nowych pobrań, gdy element nigdy wcześniej nie był pobierany. Innymi słowy: utworzenie elementu danego typu i nowej planowanej rewizji, która pomieści dane źródłowe. -
Transfer new revision of existing item— w przypadku pobierania kolejnej rewizji elementu, którego inna rewizja została już wcześniej pobrana. -
Nothing to do— wybrana rewizja elementu została już wcześniej pobrana.
-
Struktura koszyka
Na etapie przygotowania koszyk korzysta z ustawień domyślnych zdefiniowanych dla każdego typu elementu, który można pobrać. Ustawienia te definiuje się w oknie dialogowym Content Cart Structure, otwieranym po kliknięciu Change Settings w prawym dolnym rogu okna dialogowego Content Cart.

Domyślne ustawienia pobierania definiuje się w oknie dialogowym Content Cart Structure.
Ustawienia te służą do określania właściwości nowo tworzonych rewizji elementów w docelowym obszarze roboczym — tworzonych w stanie planowanym, w gotowości do przyjęcia danych z oryginalnych rewizji elementów w źródłowym obszarze roboczym. Obejmują one domyślny folder w docelowym obszarze roboczym, a także domyślną definicję cyklu życia, schematy nazewnictwa elementów i rewizji oraz indeks początkowy. Definiowana jest również domyślna notatka w formacie Acquired from <SourceWorkspaceName>.
Jeśli chodzi o foldery docelowe w docelowym obszarze roboczym, każdy typ elementu zostanie pobrany do osobnego folderu w obrębie:
- Nadrzędnego folderu najwyższego poziomu, którego nazwa pochodzi od samego Content Cart.
- Istniejącego folderu wskazanego w oknie wyboru Content Cart Name.
Dostosuj te domyślne ustawienia pobierania do schematów stosowanych (i preferowanych!) dla danych typów elementów w docelowym obszarze roboczym. Kliknij komórkę, aby uzyskać dostęp do opcji edycji.
Ustawienia pobierania w oknie dialogowym Content Cart Structure są ogólnymi ustawieniami domyślnymi. W przypadku elementów, które nigdy wcześniej nie były pobierane — gdy element nadrzędny i jego początkowa rewizja są tworzone od nowa (Action ma wartość Transfer new revision and item) — można w razie potrzeby zdefiniować właściwości poszczególnych elementów, uzyskując bardziej szczegółową kontrolę. W tym celu zaznacz rewizję elementu w głównej tabeli pobierania i kliknij przycisk
. Otworzy się okno dialogowe Edit Item, w którym możesz zmodyfikować właściwości elementu zgodnie z potrzebami, zastępując ustawienia domyślne.

Aby uzyskać większą kontrolę, możesz zdefiniować właściwości poszczególnych elementów.
Dostarczenie koszyka
Po zakończeniu przygotowania kliknij przycisk
, aby rozpocząć pobieranie. Pojawi się okno potwierdzenia z informacją, że Content Cart zostanie przeniesiony ze źródłowego do docelowego obszaru roboczego — kliknij Yes, aby kontynuować. Drugie okno potwierdzenia poinformuje o wyniku pobierania, a pobrane elementy będzie można przeglądać w docelowym obszarze roboczym za pomocą panelu Explorer.
Pozyskiwanie danych w formacie IntLib
Możesz również pozyskiwać komponenty z przestrzeni roboczej do biblioteki zintegrowanej (*.IntLib). Podczas umieszczania komponentów z takiej biblioteki zintegrowanej ich powiązania nadal wskazują na komponenty w przestrzeni roboczej. Pozwala to efektywnie korzystać z komponentów firmowej przestrzeni roboczej w trybie offline, a jednocześnie zapewnia zachowanie rzeczywistego powiązania projektu z tymi komponentami w źródłowej przestrzeni roboczej.
Pozyskiwanie danych do biblioteki IntLib
W oknie dialogowym Content Cart proces pozyskiwania danych do biblioteki IntLib przebiega następująco:
-
Kliknij łącze Select target server i wybierz z menu opcję IntLib file.
-
Określ nazwę i lokalizację generowanego pliku IntLib. Domyślnie plik otrzyma nazwę w formacie
Integrated_Library - <Date> - <Time>.IntLibi zostanie wygenerowany w lokalizacji\Users\Public\Documents\Altium\AD<Solution/Version>\Library\ExportCmpLib. W razie potrzeby zmień te ustawienia w oknie dialogowym Save As, dostępnym po kliknięciu łącza Change .
Zaakceptuj domyślny folder docelowy i nazwę pliku lub zmień je zgodnie z potrzebami. -
Jeśli chcesz pozyskać dodatkowe komponenty do tej samej biblioteki IntLib, kliknij łącze Add More Items i wybierz pozycję Select, aby otworzyć okno dialogowe Choose Item (uproszczoną wersję panelu Explorer). W tym oknie możesz przeglądać źródłową przestrzeń roboczą w poszukiwaniu kolejnych elementów. Możesz też wybrać pozycję Add manually, aby otworzyć okno dialogowe Add new items. Umożliwia ono wklejenie zewnętrznej listy potrzebnych elementów (po jednym elemencie w wierszu), które następnie można wyszukać w źródłowej przestrzeni roboczej według wybranego kryterium wyszukiwania (GUID, Item ID, Name lub MPN).
-
Gdy wszystko będzie gotowe, kliknij przycisk
, aby rozpocząć generowanie biblioteki IntLib. Zostanie utworzony tymczasowy pakiet biblioteki zintegrowanej (*.LibPkg), do którego zostaną dodane wygenerowane pliki źródłowe SchLib (z symbolami, parametrami i powiązaniami z modelami) oraz PcbLib (z modelami obudów PCB). Następnie pakiet zostanie skompilowany w celu utworzenia pliku IntLib w określonym folderze. Pomyślne wygenerowanie pliku zostanie potwierdzone w oknie informacyjnym.
Prześlij zawartość koszyka do folderu docelowego, w którym znajdzie się wymagany plik biblioteki zintegrowanej.
Korzystanie z biblioteki IntLib
Po wygenerowaniu bibliotekę IntLib można dodać do dostępnych w oprogramowaniu bibliotek spoza przestrzeni roboczej (na karcie Installed w oknie dialogowym Available File-based Libraries). Będzie ona wtedy dostępna w panelu Components. Umieszczaj komponenty z biblioteki IntLib w projekcie zgodnie z potrzebami. Mimo pracy z komponentami w trybie offline powiązania z oryginalnymi komponentami w przestrzeni roboczej zapewniają ciągłość po powrocie do pracy w trybie online, bezpośrednio z przestrzeni roboczej.
