Instrukcja instalacji i obsługi makra Naming w wersji 1.0

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:
[email protected]
24