Obsługa pozyskiwania danych z Altium On-Prem Enterprise Server

Altium umożliwia organizacji skopiowanie potrzebnej zawartości ze źródłowego Workspace i dostarczenie jej do drugiego, docelowego Workspace – proces ten nazywa się po prostu Workspace Data Acquisition.

Poprzez pozyskanie zawartości projektowej, własność trafia jednoznacznie w ręce zespołu docelowego Workspace, który może swobodnie wprowadzać modyfikacje i utrzymywać zawartość – w swoim Workspace – zgodnie z dalszymi potrzebami. A dzięki zachowaniu powiązania między pozyskanymi danymi a ich pierwotnym źródłem możliwa jest inteligentna obsługa danych, w tym powiadamianie, gdy źródło skopiowanej zawartości zostanie zaktualizowane. Przykładowo, jeśli w przyszłości zostanie wprowadzona zmiana w rewizji elementu projektowego w źródłowym Workspace, docelowy Workspace ma możliwość zaktualizowania się do tej rewizji, ponownie synchronizując się – obrazowo mówiąc – z „statkiem-matką”. I niezależnie od tego, czy w docelowym Workspace wykonano dodatkowe wydania danego elementu, zawsze istnieje możliwość powrotu do wcześniejszej rewizji ze źródłowego Workspace – wszystko dzięki utrzymaniu łącza do pierwotnego źródła elementu, czyli Origin.

Pozyskiwanie danych – przegląd koncepcyjny

Poniższy obraz przedstawia ogólny, graficzny opis koncepcji pozyskiwania danych. Zasady pozyskiwania danych są takie same niezależnie od typu pozyskiwanych danych.

Koncepcja pozyskiwania danych Workspace.

Zwróć uwagę, że Workspace, który ma otrzymać dane (docelowy Workspace), musi mieć możliwość połączenia ze źródłowym Workspace. Oznacza to, że Enterprise Server nie może pełnić roli źródła danych zawartości dla Workspace w Altium 365, ponieważ ten drugi nie może połączyć się z pierwszym – który znajduje się w lokalnej sieci LAN/WAN i nie jest wystawiony do internetu.

W praktyce oznacza to, że dane Content Cart mogą być przenoszone pomiędzy Workspace w Altium 365, pomiędzy Workspace w Enterprise Server , a także z Workspace w Altium 365 do Workspace w Enterprise Server. W tych przypadkach Workspace odbierający/docelowy może „widzieć” i łączyć się ze źródłowym Workspace, natomiast docelowy Workspace w Altium 365 nie może widzieć ani połączyć się z Workspace znajdującym się w zamkniętej sieci lokalnej.

Podsumowanie pozyskiwania danych pomiędzy Workspace:

ŹRÓDŁO		CEL	OBSŁUGIWANE
Altium 365 Workspace	→	Altium Enterprise Server Workspace
Altium Enterprise Server Workspace	→	Altium Enterprise Server Workspace
Altium Enterprise Server Workspace	→	Altium 365 Workspace
Altium 365 Workspace	→	Altium 365 Workspace

Elementy, które można pozyskać

Następujące typy elementów (Item) można pozyskać ze źródłowego Workspace do docelowego Workspace, korzystając z funkcji Data Acquisition:

• 3D Model
• Altium Designer Preferences
• Component (w tym powiązane Part Choices)
• Component Template
• Datasheet
• Footprint
• Managed Schematic Sheet
• Output Job
• Schematic Template
• Script
• Simulation Model
• Symbol

Rzeczy, które warto wziąć pod uwagę podczas pozyskiwania danych:

• Pozyskiwana jest tylko wybrana rewizja elementu (Item) ze źródła, a nie wszystkie rewizje, które mogą istnieć dla tego elementu. W domyślnym widoku panelu Explorer będzie to najnowsza (bieżąca) rewizja elementu, chyba że jawnie wybierzesz niższą (starszą) rewizję – odznacz opcję Show only latest w menu , aby wyświetlić wszystkie dostępne rewizje elementu.
• Podczas pozyskiwania rewizji źródłowego elementu Component lub Managed Schematic Sheet, pozyskane zostaną również wszystkie powiązane elementy podrzędne:
  • Component Item – odpowiednie rewizje następujących powiązanych obiektów podrzędnych: Symbol Item, Footprint Item(s), 3D Model Item(s), Simulation Model Item, Component Template Item, Datasheet Item(s), powiązania Part Choice.

Zwróć uwagę, że parametr Component Type nie jest przenoszony podczas procesu pozyskiwania, więc przeniesione komponenty będą widoczne w docelowej lokalizacji Uncategorized zarówno w panelu Components panel w Altium Designer, jak i na stronie Components page w Workspace. Możesz zastosować żądany Component Type do pojedynczego lub wielu wpisów komponentów, używając operacji Change Component Type operation w panelu Explorer w Altium Designer.

• Managed Sheet Item – odpowiednie rewizje następujących powiązanych obiektów podrzędnych: Component Item(s), Symbol Item(s), Footprint Item(s), 3D Model Item(s), Simulation Model Item(s), Component Template Item(s), Datasheet Item(s), Schematic Template Item.

• Cykl życia pozyskanej rewizji elementu ze źródła przyjmie stan początkowy (na przykład Draft), zgodnie z przypisaną definicją cyklu życia dla elementu docelowego. Cała historia cyklu życia dla rewizji elementu źródłowego zostanie zignorowana.
• Jeśli element podrzędny wybranego źródłowego elementu Component/Managed Schematic Sheet z jakiegokolwiek powodu nie może zostać pozyskany, wówczas pozyskiwanie tego wybranego elementu Component/Managed Schematic Sheet nie będzie kontynuowane.

Interfejs użytkownika pozyskiwania

Related page: Korzystanie z Content Cart

Pozyskiwanie odbywa się za pomocą okna dialogowego Content Cart, do którego uzyskuje się dostęp z panelu Explorer panel. Podczas przeglądania źródłowego Workspace, z którego chcesz pobrać dane, kliknij prawym przyciskiem myszy rewizję elementu (Item Revision), 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 (co załaduje koszyk najnowszą rewizją wszystkich elementów w tym folderze).

Okno dialogowe Content Cart – centrum dowodzenia do pozyskiwania danych ze źródłowego Workspace.

Użyj Content Cart, aby pozyskać całą potrzebną zawartość danych. Proces pozyskiwania elementów danych ze źródłowego Workspace można podsumować następującymi krokami:

1. Aktualnie aktywny Workspace jest automatycznie określany jako źródłowy Workspace.
   1. Możesz zmienić aktywny Workspace widoczny w widoku panelu Explorer – a tym samym bieżące źródło danych – z menu wyboru Workspace dostępnego w lewym górnym rogu panelu.
   2. Dostępne Workspace to te, z którymi wcześniej nawiązano połączenie i/lub które są obecnie dostępne (połączone), jak pokazano w sekcji Known Servers na stronie Data Management – Servers page w oknie dialogowym Preferences.
   3. Zwróć uwagę, że chociaż Altium Content Vault jest również dostępny jako źródło, jego bezpośrednie użycie do pozyskiwania danych jest wycofywane na rzecz panelu Manufacturer Parts Search panel – do którego zostaniesz przekierowany, jeśli Content Vault zostanie wybrany jako źródło. Panel Manufacturer Parts Search oferuje zaawansowane możliwości wyszukiwania rzeczywistych części poprzez usługę Altium Parts Provider Service, a w tle wykorzystuje Altium Content Vault jako źródło danych modeli komponentów. Znalezione komponenty, które mają wspierające dane modeli, mogą zostać Acquired for use in your designs.
2. Użyj listy rozwijanej nazwy docelowego Workspace (podświetlonej na niebiesko), aby wybrać alternatywny docelowy Workspace z listy, która jest wypełniana aktualnie połączonymi Workspace – wybierz opcję Server Administration, aby włączyć/wyłączyć połączenia Workspace.

3. Oryginalna rewizja elementu jest wyświetlana w głównej siatce. Do koszyka można dodać dowolną liczbę dodatkowych rewizji elementów. Aby to zrobić, kliknij kontrolkę Add More Items w prawym górnym rogu okna dialogowego i wybierz pozycję Select, aby otworzyć okno dialogowe Choose Item (będące wariantem panelu Explorer). Stąd możesz przeglądać źródłowy Workspace w poszukiwaniu kolejnych elementów, dodając je pojedynczo lub wsadowo, korzystając ze standardowych narzędzi wielokrotnego zaznaczania.

   Alternatywnie wybierz pozycję Add manually, aby otworzyć okno Add new items dialog. To okno umożliwia wklejenie zewnętrznej listy wymaganych elementów (jeden element na linię), które następnie mogą zostać wyszukane w źródłowym Workspace przy użyciu wybranego kryterium wyszukiwania (GUID, Item ID, Name lub MPN). Zaznacz i usuń rewizje elementów z listy (kliknij przycisk ), jeśli zdecydujesz, że jednak nie mają zostać pozyskane.

4. Kliknij kontrolkę Change Settings w prawym dolnym rogu okna dialogowego Content Cart, aby otworzyć okno Content Cart Structure dialog. Stąd możesz zdefiniować domyślne opcje dla każdego z typów elementów danych obsługiwanych przez funkcję pozyskiwania. Obejmuje to wskazanie domyślnego folderu w docelowym Workspace, a także domyślnej definicji cyklu życia (Lifecycle Definition), schematów nazewnictwa elementów i rewizji oraz indeksu początkowego. Masz też możliwość dodania notatki, która może dostarczyć innym przydatnych informacji o pozyskaniu podczas przeglądania pozyskanej zawartości.
5. Po wybraniu żądanych elementów źródłowych kliknij przycisk , który przygotowuje docelowy Workspace do pozyskania. Spowoduje to automatyczne sprawdzenie statusu wybranych rewizji elementów (na wypadek, gdy były już wcześniej pozyskane), powiązań nadrzędny–podrzędny, a następnie zaproponuje wymagane działanie – które dla nowych pozyskań będzie Transfer new revision and item. Podczas tej fazy przygotowania stosowane są domyślne opcje pozyskiwania (zob. punkt 3 powyżej), jednak w razie potrzeby można zmodyfikować właściwości poszczególnych elementów docelowych. Aby to zrobić, wybierz element z listy i kliknij przycisk .
6. Po zakończeniu przygotowań kliknij przycisk , aby uruchomić proces pozyskiwania. Pojawi się początkowe okno dialogowe potwierdzenia – kliknij Yes, aby kontynuować transfer zawartości między źródłowym i docelowym Workspace. Drugie okno dialogowe potwierdzenia potwierdzi wynik pozyskania.

Pozyskane dane wskazują na swoje pierwotne źródło. Te informacje o powiązaniu przodka można zobaczyć, zmieniając widok aspektu dla docelowej rewizji Item na widok aspektu Origin. Informacje są dostępne tylko wtedy, gdy Workspace Origin (źródłowy) jest dostępny i połączony – patrz punkt 1 powyżej.

Mechanika pozyskiwania

Dla osób, które chciałyby poznać mechanizmy transferu danych stojące za procesem Data Acquisition, poniższa sekcja dostarcza więcej informacji o podstawowym przebiegu procedury stosowanej przez tę funkcję oraz o typowych scenariuszach spotykanych podczas zarządzania pozyskiwaniem danych.

Podstawowy przebieg procedury

Poniższy obraz przygląda się bliżej mechanice pozyskiwania danych ze źródłowego Workspace. Ilustruje przebieg procedury, której celem jest zasadniczo skopiowanie wybranej rewizji źródłowego elementu między wskazanymi źródłowym i docelowym Workspace.

Mechanika pozyskiwania danych ze źródłowego Workspace i przenoszenia ich do docelowego Workspace.

Jak widać, procedura sprowadza się zasadniczo do trzech odrębnych etapów, zapewniających transfer danych między Workspace przy zachowaniu ich integralności:

1. Download – wybrana rewizja źródłowego elementu (w źródłowym Workspace) jest najpierw pobierana.
2. Modify & Retarget – dane są automatycznie modyfikowane tak, aby odpowiadały zdefiniowanym lokalnym preferencjom (lokalnym dla docelowego Workspace), przy jednoczesnym niezawodnym zachowaniu pozyskanej wartości.
3. Release – dane są wydawane do docelowego Workspace (w tym przypadku do nowej rewizji istniejącego docelowego Item). Docelowa rewizja zachowuje łącze do swojego pochodzenia, wskaźnik do rewizji źródłowego Item będącej jej przodkiem.

Zarządzanie pozyskanymi danymi

W poprzedniej sekcji pokazano podstawowy przebieg pozyskiwania. Aby skutecznie zarządzać pozyskiwaniem danych, śledzona jest względna historia zarówno elementów źródłowych, jak i pozyskanych, tak aby odpowiednie działania pozyskiwania były dostępne dla projektanta poprzez interfejs zarządzania pozyskiwaniem.

Poniższe sekcje omawiają ogólne scenariusze spotykane podczas zarządzania pozyskiwaniem danych. W każdym przypadku stan pozyskanych danych – w odniesieniu do docelowego Item i ewentualnych rewizji – jest porównywany z oryginalnym źródłowym Item i jego rewizjami.

Całkowicie nowe pozyskanie

W tym scenariuszu żadna rewizja źródłowego Item nie została wcześniej pozyskana. Rewizja źródłowego Item ma zostać pozyskana do początkowej rewizji nowego docelowego Item. Nowy docelowy Item i rewizja są tworzone w ramach konfiguracji pozyskiwania.

Scenariusz 1 – pozyskiwanie danych do początkowej rewizji nowego docelowego Item.

Pozyskanie późniejszej rewizji

W tym scenariuszu rewizja źródłowego Item została wcześniej pozyskana. Źródłowy Item został następnie zmodyfikowany, co spowodowało udostępnienie późniejszej rewizji. W takim przypadku zostanie utworzona nowa rewizja istniejącego docelowego Item, aby pozyskać późniejszą rewizję źródłowego Item.

W praktyce więc, nawet jeśli najnowsza rewizja mogła zostać pozyskana do innego folderu Cart w docelowym Workspace, system importuje nową rewizję do istniejącego Component Item. Ten komponent ma teraz dostępną nową rewizję, która zostanie wykryta automatycznie po otwarciu projektu używającego tego komponentu – co będzie wskazane przez status Out of date w panelu Properties panel, Item Manager lub dokumencie ActiveBOM document.

Scenariusz 2 – pozyskanie późniejszej rewizji wcześniej pozyskanego źródłowego Item.

Already Exists

W tym scenariuszu najnowsza rewizja źródłowego Item została już pozyskana – nie ma nic więcej do pozyskania.

Scenariusz 3 – żądana rewizja źródłowego Item została już pozyskana, nic do zrobienia.