Malerzów, 28.04.2013 Instrukcja instalacji i obsługi makra Naming w wersji 1.0 1. Uwagi wstępne Niniejszy dokument jest uproszczoną instrukcją instalacji i obsługi makra Naming w wersji 1.0 dla systemu Windows XP / 7 (w wersji 32 lub 64 bitowej) i aplikacji CATIA V5 w wersji anglojęzycznej. Do poprawnej instalacji i użytkowania niniejszego makra niezbędne jest spełnienie następujących warunków: zainstalowana aplikacja CATIA V5 Release od 16 do 23 (na takich wydaniach makro było testowane, w przypadku wystąpienia jakichkolwiek problemów ze zgodnością zalecany jest kontakt mailowy dane kontaktowe znajdują się na ostatniej stronie). zainstalowany pakiet Microsoft.NET Framework 3.5 lub wyższy, wolne 1,0 MB miejsca na dysku (zalecana lokalizacja C:\). 1
2. Instalacja Rozpoczęcie procesu instalacji odbywa się poprzez rozpakowanie otrzymanego archiwum AB_Naming_DEMO.zip i uruchomienie pliku AB_Naming_DEMO.exe. W wyświetlonym oknie powitalnym wybieramy przycisk Next > aby przejść do okna wyboru ścieżki instalacji: 2
Zalecaną lokalizacją instalacji jest ustawiony domyślnie katalog C:\AB_Designer\AB_Naming. Dokonanie zmiany możliwe jest poprzez wybranie przycisku: Browse. Wybrana w tym miejscu lokalizacja będzie zwana w dalszej części instrukcji katalogiem instalacji. Wybór zatwierdzamy wybierając przycisk Next >. Konieczne może się w tym miejscu okazać dodanie pliku instalacyjnego AB_Naming_DEMO.exe do listy zaufanych aplikacji posiadanego programu antywirusowego, gdyż może on zablokować procedurę instalacyjną. Jeżeli instalacja przebiegła pomyślnie powinno zostać wyświetlone następujące okno: Następnie opuszczamy program instalacyjny poprzez wybór przycisku Finish. W przypadku wystąpienia jakichkolwiek problemów zalecany jest kontakt mailowy (dane kontaktowe znajdują się na ostatniej stronie). Kolejnym krokiem jest uruchomienie aplikacji CATIA. Następnie przechodzimy do okna Macros poprzez: sposób pierwszy: sposób drugi: skrót klawiszowy Alt+F8, menu Tools -> Macro ->Macros 3
W aktualnym oknie wybieramy opcję Macro libraries. Następnie z rozwijanego menu klikamy opcję VBA Projects, potem przycisk Add existing library. Zostanie otwarte okno wyboru: 4
W oknie wskazujemy, znajdujący się w katalogu instalacji (domyślnie C:\AB_Designer\AB_Naming ) plik EXE_Start.catvba i zatwierdzamy klawiszem Open (dla polskiej wersji systemu Windows przycisk Otwórz). Powrócimy tym samym do okna Macro libraries: W bieżącym oknie na liście pod nazwą Current libraries: zatwierdzamy podwójnym kliknięciem ścieżkę nowej biblioteki, która domyślnie przyjmuje nazwę C:\AB_Designer\AB_Naming\EXE_Start.catvba. Po potwierdzeniu powrócimy do okna Macros: Proces instalacji został zakończony. Wybranie przycisku Run uruchomi makro. Ponowny dostęp do powyższego okna Macros jest możliwy na dwa sposoby: poprzez skrót klawiszowy Alt+F8, z menu Tools -> Macro ->Macros Zamykamy okno Macros przyciskiem Close. Kolejnym krokiem instalacji jest dodanie przycisku do paska narzędzi (Toolbar) umożliwiającego szybkie i wygodne uruchomienie makra Naming. 5
Opisany poniżej krok jest opcjonalny i w żaden sposób nie wpływa na funkcjonowanie makra, ma jedynie za zadanie ułatwienie dostępu i przyspieszenie jego uruchomienia. W celu pominięcia tego kroku należy przejść do rozdziału 3. Przed przystąpieniem do tej procedury należy zamknąć w oknie aplikacji CATIA wszelkie podokna (części, złożenia, rysunki itp.). Okno powinno wyglądać następująco: Następnie z górnego menu wybieramy Tools -> Customize powinno pojawić się okno Customize: 6
Przechodzimy na zakładkę Commands z listy Categories wybieramy pozycję Macros, po czym odsłaniamy właściwości przyciskiem Show Properties. Okno rozszerzy się o dodatkowe funkcje: 7
W celu przypisania ikony do makra wybieramy przycisk z dolnej części okna. Po pojawieniu się okna Icons Browser wybieramy ikonę poprzez kliknięcie na nią i zatwierdzamy wybór przyciskiem Close. Po powrocie do okna Customize przechodzimy do zakładki Toolbars: 8
Klikając New otwieramy okno wyboru nazwy nowego paska zadań New Toolbar, gdzie pod pozycją Toolbar Name wpisujemy (przykładowo) nazwę AB Naming i zatwierdzamy przyciskiem OK. Nowy pasek zadań powinien być teraz dostępny w liście Toolbars w oknie Customize: 9
Mając zaznaczoną pozycję AB Naming klikamy przycisk Add commands wyświetlając tym samym listę komend możliwych do użycia: Z listy należy wybrać pozycję ABNaming_START i zatwierdzić przyciskiem OK. Po powrocie do okna Customize zamykamy je przyciskiem Close. Przycisk został dodany do nowego paska zadań. Uruchomienie makra następuje poprzez użycie przycisku ABNaming_START na pasku zadań AB Naming, dostępnego z poziomu każdego modułu aplikacji CATIA, co jest równoznaczne z użyciem przycisku Run w oknie Macros. 10
3. Uruchomienie i opis funkcji Uruchomienie makra spowoduje pojawienie się okna startowego wyboru ścieżki instalacji: Po kliknięciu przycisku Select installation path (wskaż ścieżkę instalacji) makro w celach informacyjnych wyświetli dodatkowe okno, w którym poprosi o zaznaczenie pliku AB_Naming.exe. Po kliknięciu przycisku OK pojawi się okno wyboru: Wybieramy, zgodnie z powyższą informacją, plik o nazwie AB_Naming.exe z katalogu instalacji (domyślnie C:\AB_Designer\AB_Naming ) i zatwierdzamy klawiszem Open (dla polskiej wersji systemu Windows przycisk Otwórz), wracając do okna CATII. Opisaną wyżej procedurę wskazania ścieżki pliku AB_Naming.exe należy przeprowadzić tylko podczas pierwszego uruchomienia makra Naming oraz za każdym razem kiedy tymczasowe pliki aplikacji użytkownika (standardowo C:\Users\Nazwa_użytkownika\ AppData\Local\Temp) zostaną usunięte. Ma to miejsce w przypadku używania wszelakich aplikacji czyszczących rejestr, lokalizacje systemowe lub pliki tymczasowe. Każde następne uruchomienie będzie zaczynało się od poniższego kroku. Uruchomienie makra (przyciskiem ABNaming_START na pasku zadań AB Naming albo przyciskiem Run w oknie Macros) spowoduje otwarcie okna startowego: 11
Przed uruchomieniem makra należy pamiętać, iż najwyższą pozycją w drzewku CATII musi być złożenie CATProduct zawierające co najmniej jeden komponent (CATPart, CATProduct lub Component) gdyż w przeciwnym wypadku wyświetlony zostanie komunikat o błędzie i makro nie uruchomi się. Zalecane jest też zapisanie wszystkich zmian (przy użyciu opcji Save Management). Jeśli spełnione zostały wszystkie potrzebne warunki, po wybraniu przycisku START wyświetlone zostanie okno główne makra: Główne menu można podzielić na trzy zasadnicze obszary: Okno robocze służy do wizualnej kontroli stanu złożenia i wprowadzanych zmian, opisane w podrozdziale 3.1. Zestaw narzędzi menu służące do wprowadzania zmian w nazwach komponentów, opisane ogólnie w podrozdziale 3.2. Menu może pracować w dwóch trybach: Replace / Add Text (zamień / dodaj tekst) opisany w podrozdziale 3.2.1. lub Rename (zmień nazwę) opisany w podrozdziale 3.2.2. Pole wyboru ścieżki zapisu służy do wybrania lokalizacji zapisu zmienionego złożenia oraz zatwierdzenia bądź odrzucenia wprowadzonych zmian. Opisane w podrozdziale 3.3. 12
3.1. Okno robocze Strukturę przykładowego złożenia w drzewku CATII i jego translację do okna roboczego makra przedstawia poniższy diagram: Makro nie wczyta do okna roboczego elementów ukrytych w CATII (funkcją Hide/Show). Od tej reguły jest jeden wyjątek, mianowicie jeżeli dany komponent występuje w złożeniu wielokrotnie i tylko jedna instancja zostanie ukryta, komponent mimo tego zostanie wczytany do okna roboczego. Dodatkowo jeżeli wielokrotnie użyty komponent będzie znajdował się w podzłożeniu, które jest ukryte, to podzłożenie także zostanie wczytane i poddane zmianom. Każdy komponent drzewka CATII jest wyświetlany tylko raz w oknie roboczym i zawiera 3 pozycje: 1. Nazwę pliku (File Name) na dysku wraz z rozszerzeniem. Litery A/C/P przed dwukropkiem na początku wiersza oznaczają odpowiednio Assembly, Component, Part i odnoszą się do rodzaju komponentu. Wyjątek stanowi tutaj Component, gdyż nie tworzy on pliku na dysku. W tym przypadku pierwsza nazwa jest nazwą złożenia, w którym dany Component się znajduje, następnie, po podwójnym dwukropku, wyświetlana jest jego nazwa części (Part Number). 2. Nazwę części (Part Number) z drzewka CATII. Tłumaczenie oryginalnej nazwy anglojęzycznej Part Number jako nazwa części jest uzasadnione spójnością nazewnictwa CATII i makra, oraz faktem, iż Part Number nie musi być wyrażony za pomocą tylko i wyłącznie cyfr ale także za pomocą liter. 13
3. Nazwę instancji (Instance Name). Nazwa instancji jest sprawdzana tylko do kropki, z racji tego iż każda instancja użyta w sesji musi mieć unikatową nazwę. Jeśli nazwy instancji wielokrotnie użytych komponentów różnią się od siebie, wtedy trzecia pozycja jest pomijana w oknie roboczym. Do kontrolowania nazw instancji służy w takim wypadku funkcja Check Instance opisana w następnym podrozdziale. W celu szybkiej, wzrokowej weryfikacji tego, co dzieje się z nazwami komponentów w złożeniu w oknie roboczym wprowadzono prosty system podkreśleń i kolorów, i tak: Podkreślenie i oznaczenie kolorem zielonym oznacza, iż wszystkie nazwy (pliku, części i instancji) są takie same. Oznaczenie kolorem zielonym bez podkreślenia oznacza, iż nazwa pliku i nazwa części są takie same, różna jest tylko nazwa instancji. Podkreślenie i oznaczenie kolorem czerwonym oznacza, iż nazwa pliku i nazwa części są różne, ale jedna z nich (podkreślona) jest taka sama jak nazwa instancji. Oznaczenie kolorem czerwonym bez podkreślenia oznacza, iż wszystkie nazwy (pliku, części i instancji) są różne. 3.2. Zestaw narzędzi W górnej części zestawu widoczne są dwa przyciski: Reset (przywróć) służy do cofania zmian wprowadzonych w oknie roboczym dla wybranego komponentu. Staje się aktywny, kiedy w oknie roboczym zostaną wprowadzone zmiany (elementy podświetlone żółtym kolorem), Check Instance (sprawdź instancję) służy do kontrolowania nazw instancji komponentów użytych wielokrotnie w sesji. Wskazanie odpowiedniej pozycji w oknie roboczym i użycie przycisku wyświetli następujące okno: 14
W oknie wyświetlane są 3 informacje: nazwa pliku (File Name) i nazwa części (Part Number), które są widoczne także w oknie roboczym oraz wszystkie występujące w złożeniu nazwy instancji tego samego, wielokrotnie użytego komponentu. 3.2.1. Replace / Add Text Tryb pozwalający na zamianę podanej frazy inną frazą, lub dodanie nowej frazy do wybranej nazwy pliku, części bądź instancji. Zaczynając od góry widoczne są dwa edytowalne pola: Old: (stary:) należy w nim podać frazę wejściową (starą), która ma zostać zamieniona, New: (nowy:) należy w nim podać frazę wyjściową (nową), która ma zastąpić starą frazę, ew. która ma zostać dodana do starej nazwy. Poniżej edytowalnych pól znajduje się ramka z dwoma opcjami do wyboru: Add at the beginning (dodaj na początku) wybranie tej opcji spowoduje dodanie na początku starej nazwy frazy podanej w oknie New:, Add at the end (dodaj na końcu) wybranie tej opcji spowoduje dodanie na końcu starej nazwy frazy podanej w oknie New:. W przypadku użycia funkcji dodania nowej frazy do starej nazwy pole Old: musi być puste, gdyż w przeciwnym wypadku ramka z opcjami Add at the beginning / Add at the end pozostanie nieaktywna. 15
Po prawej stronie znajduje się ramka z trzema opcjami: File Name (nazwa pliku), Part Number (nazwa części) i Instance Name (nazwa instancji), i służy do wyboru nazwy, która ma zostać poddana zmianom. Podwójne kliknięcie w białe tło ramki spowoduje natychmiastowe zaznaczenie wszystkich trzech pozycji (File Name, Part Number, Instance Name). Poniżej znajdują się dwa zielone przyciski: Select (wybór) pozwala na wybranie w oknie roboczym komponentów, które mają zostać zmienione, All (wszystko) automatycznie podda zmianom wszystkie komponenty znajdujące się aktualnie w oknie roboczym. Przyciski Select i All stają się aktywne, kiedy zostanie zdefiniowany schemat zmian tzn. albo zostaną wypełnione pola Old: i New: albo tylko pole New: i zaznaczona zostanie jedna z opcji poniżej (Add at the beginning / Add at the end) i z ramki po prawej stronie wybrana zostanie przynajmniej jedna nazwa. W wersji demonstracyjnej przycisk All jest zablokowany i pozostaje nieaktywny. Przykład 1 dodanie frazy AB na końcu nazwy pliku, części i instancji dwóch wybranych komponentów. Zaczynamy od wpisania w pole New: frazy AB, następnie zaznaczamy w oknie poniżej Add at the end i w polu po prawej stronie wybieramy wszystkie trzy opcje File Name, Part Number i Instance Name. Następnie wybieramy przycisk Select i zaznaczamy w oknie roboczym dwa dowolne komponenty: 16
Kończymy wybór używając przycisku End selection: Wybrane komponenty zostaną zaznaczone na żółto i w celu kontrolnym przedstawione zostaną ich nazwy wyjściowe (po znakach >:>). Przykład 2 zmiana frazy V001 na V002 w nazwie pliku, części i instancji wszystkich komponentów (tylko dla pełnej wersji makra). 17
Zaczynamy od wpisania w pole Old: frazy V001 a w pole New: V002 potem w oknie po prawej stronie zaznaczamy wszystkie trzy opcje File Name, Part Number i Instance Name. Następnie wybieramy przycisk All: Podobnie jak w przykładzie 1 poddane zmianom komponenty zostaną oznaczone żółtym kolorem oraz pokazane zostaną ich zmienione nazwy. Zaznaczenie dowolnego komponentu i wybranie wcześniej opisanego przycisku Reset spowoduje cofnięcie wprowadzonych zmian. 3.2.2. Rename Tryb pozwalający na zamianę nazw pliku, części i instancji nazwą pliku, części, instancji, bądź dowolną frazą. 18
Zaczynając od góry widoczne jest jedno edytowalne pole New: (nowy:) podany w nim tekst zastąpi wybrane nazwy. Znajdujący się powyżej zielony przycisk Read Node (czytaj pozycję) jest ściśle powiązany z tą funkcją i służy do importowania nazw z okna roboczego do pola New:. Poniżej znajduje się ramka z czterema opcjami do wyboru: Text (tekst) do zmiany wybranych nazw użyta zostanie fraza z pola New: (dowolna bądź odczytana funkcją Read Node), File Name (nazwa pliku) wybrane nazwy zostaną zmienione na nazwę pliku, Part Number (nazwa części) wybrane nazwy zostaną zmienione na nazwę części. Instance Name (nazwa instancji) wybrane nazwy zostaną zmienione na nazwę instancji. Ramka znajdująca się po prawej stronie (z wyborem File Name, Part Number i Instance Name) oraz przyciski Select i All mają identyczne funkcje jak w trybie Replace / Add Text. Przykład 3 odczytanie nazwy pliku dowolnego komponentu i użycie jej do zmiany nazwy instancji tego samego komponentu. Zaczynamy od użycia przycisku Read Node i odczytania nazwy pliku komponentu. Następnie w ramce poniżej okna New: zaznaczamy opcję Text a w ramce po prawej wybieramy Instance Name. Potem wybieramy przycisk Select i zaznaczamy w oknie roboczym ten sam komponent: 19
Podobnie jak w przykładzie 1 i 2 poddany zmianie komponent zostanie podświetlony żółtym kolorem. Z racji tego, iż ta część jest użyta wielokrotnie w złożeniu z różnymi nazwami instancji, nie widzimy w oknie roboczym jej pierwotnej nazwy, widzimy tylko wyjściową (po znakach >:>). Przykład 4 zmiana nazwy pliku, części i instancji na nazwę części we wszystkich komponentach (tylko dla pełnej wersji makra). Zaczynamy od zaznaczenia w dolnej ramce opcji Part Number oraz wybrania wszystkich trzech pozycji File Name, Part Number i Instance Name w ramce po prawej stronie. Następnie wybieramy przycisk All: 20
Zaznaczenie żółtym kolorem informuje, tak jak w poprzednich przykładach, że makro poddało zmianom wszystkie komponenty. Nazwy wyjściowe (po znakach >:>) widoczne są tylko w przypadku, kiedy faktycznie nastąpiła ich zmiana, tzn. kiedy nazwa wejściowa i wyjściowa różnią się od siebie. 3.3. Pole wyboru ścieżki zapisu Wszystkie wprowadzone do tej pory zmiany miały miejsce tylko i wyłącznie w obrębie interfejsu makra i nie miały żadnego wpływu na złożenie otwarte w CATII. Kolejnym i zarazem ostatnim etapem jest zapisanie wprowadzonych zmian. W tym celu należy najpierw określić ścieżkę zapisu. Służy do tego pole Destination Path: (ścieżka docelowa:) z dwoma żółtymi przyciskami: Select Path (wybierz ścieżkę) uruchamia okno wyboru lokalizacji, w której docelowo zostaną zapisane wszystkie zmienione komponenty, Product Path (ścieżka produktu) użycie powoduje automatyczne wybranie lokalizacji edytowanego złożenia jako ścieżki zapisu wszystkie poddane zmianom komponenty zostaną nadpisane. Użyciem zielonego przycisku OK powodujemy zapisanie zmienionych komponentów w wyświetlonej w polu Destination Path: lokalizacji i ponowne wczytanie zmienionego i zapisanego złożenia do okna roboczego makra: 21
Używając czerwonego przycisku EXIT opuszczamy makro bez zapisywania zmian. Znajdujący się w prawym górnym rogu krzyżyk służący standardowo do zamykania okna w tym przypadku restartuje makro i powoduje wyczyszczenie wszystkich wprowadzonych zmian. 4. Personalizacja makra Opisana w tej instrukcji wersja makra jest wersją najbardziej uniwersalną, oferującą funkcje i narzędzia dobrane pod kątem jak najszerszego ich użycia. Istnieje naturalnie możliwość dopasowania ustawień makra Naming, lub wzbogacenia interfejsu o dodatkowe narzędzia i funkcje, w celu zmaksymalizowania funkcjonalności i dostosowania do indywidualnych potrzeb lub wewnętrznych wymogów i baz danych. Poniżej przykład indywidualizacji makra po kątem wymagań klienta: 22
W przypadku jakichkolwiek pytań odnośnie personalizacji makra zalecany jest kontakt mailowy (dane kontaktowe znajdują się na ostatniej stronie). 23
W przypadku jakichkolwiek pytań lub uwag proszę o kontakt na podany poniżej adres. Adres do korespondencji: adrian.burzynski@abdesigner.pl 24