Konfigurowanie integracji z PLM za pomocą plików XML

  .
  .

    

    1-Level Revision Scheme

    Component Lifecycle

    Components/Inbox/Capacitors

    

    CMPT-00001

    1-Level Revision Scheme

    Component Lifecycle

    

    Components/Inbox/Capacitors

<SourceCriteria>
    <ns2:Attribute>
        <ns2:Key>Business Unit</ns2:Key>
        <ns2:Value>Engineering_RD</ns2:Value>
    </ns2:Attribute>
</SourceCriteria>

<Attributes>

<!-- Pole Name z PLM zostanie przekazane do pola name/comment w Workspace -->
<common:Attribute attributeType="revision">
	<common:Key>name</common:Key>
	<common:Value>${attribute.name}</common:Value>
</common:Attribute>

<!-- Pole Description z PLM zostanie przekazane do pola Description w Workspace na poziomie rewizji -->
<!-- Atrybuty na poziomie rewizji spowodują utworzenie nowej rewizji, jeśli wartość parametru zostanie zmieniona -->
<common:Attribute attributeType="revision">
	<common:Key>Description</common:Key>
	<common:Value>${attribute.description}</common:Value>
</common:Attribute>

<!-- Pole Number z PLM zostanie przekazane do pola PlmPartNumber w Workspace na poziomie rewizji  -->
<!-- Uwaga: można użyć dowolnej nazwy atrybutu -->
<common:Attribute attributeType="revision" primaryKeyOrdinal="1">
	<common:Key>PlmPartNumber</common:Key>
	<common:Value>${attribute.Number}</common:Value>
</common:Attribute>

<common:Attribute attributeType="item">
	<common:Key>DynamicCONTS</common:Key>
	<common:Value>Nie spowoduje aktualizacji rewizji, jeśli zostanie zmienione ${attribute.LastModified}</common:Value>
</common:Attribute>

</Attributes>

Sekcja definiująca mapowanie danych Part Choices znajduje się na końcu przykładowego (lub wygenerowanego) pliku konfiguracyjnego.

<PartChoices>
    <ToAltium sync="true">
    <MfrMappings>
        <MfrMapping>
            <MfrName>MFR1</MfrName>
            <MfrPartNumber>MPN1</MfrPartNumber>
        </MfrMapping>
    </MfrMappings>
    </ToAltium>
</PartChoices>

<MfrMappings>
    <MfrMapping>
        <MfrName>MFR1</MfrName>
        <MfrPartNumber>MPN1</MfrPartNumber>
    </MfrMapping>
    <MfrMapping>
        <MfrName>MFR2</MfrName>
        <MfrPartNumber>MPN2</MfrPartNumber>
    </MfrMapping>
</MfrMappings>

<PartChoices>
    <ToAltium sync="true"/>
</PartChoices>

<PartChoices>
    <ToPlm sync="true"/>
</PartChoices>

<common:Attribute>
    <common:Key>Classification</common:Key>
    <common:Value>102-Capacitor</common:Value>
</common:Attribute>

<common:Attribute>
    <common:ClassificationName>102-Capacitor</common:ClassificationName>
    <common:Key>Capacitance</common:Key>
    <common:Value>${parameter.Value}</common:Value>
</common:Attribute>

<SourceCriteria>
    <ClassificationName>102-Capacitor</ClassificationName>
</SourceCriteria>

<SourceCriteria>
    <common:Attribute>
        <common:ClassificationName>102-Capacitor</common:ClassificationName>
        <common:Key>Capacitance</common:Key>
        <common:Value>10uF</common:Value>
    </common:Attribute>
</SourceCriteria>

<common:Attribute attributeType="revision">
    <common:ClassificationName>102-Capacitor</common:ClassificationName>
    <common:Key>Value</common:Key>
    <common:Value>${attribute.Capacitance}</common:Value>
</common:Attribute>

Wykonywanie synchronizacji komponentów

Synchronizację komponentów (biblioteki) można przeprowadzić ręcznie lub cyklicznie, korzystając z przycisku Sync action przy wpisie instancji PLM na stronie PLM Integration Workspace lub jako zautomatyzowany cykl określony w konfiguracji instancji. Kliknij kontrolkę  powiązaną z instancją PLM, którą chcesz zsynchronizować. Proces synchronizacji przejdzie przez workflow LibSync, zgodnie z ustawieniami zdefiniowanymi w powiązanym pliku konfiguracyjnym.

Kontrolka zmieni się na . Jeśli chcesz zatrzymać proces synchronizacji, kliknij tę kontrolkę. Pojawi się okno potwierdzenia, w którym możesz kliknąć , aby anulować synchronizację – wszystkie już zsynchronizowane komponenty pozostaną, ale dalsza synchronizacja nie będzie kontynuowana.

Synchronizacja komponentów w toku pomiędzy Workspace a wskazaną instancją PLM.

Podczas uruchamiania synchronizacji komponentów, proces LibSync przechodzi przez zdefiniowany workflow, aż do zakończenia lub napotkania błędu. Odśwież przeglądarkę (F5), aby zobaczyć aktualny stan procesu synchronizacji. Aby monitorować lub przeglądać proces LibSync, wybierz kartę Synchronization status i opcję listy Closed – jeśli proces nadal trwa, pojawi się na liście Active. Przycisk , dostępny dla administratorów, umożliwia pobranie szczegółowego rejestru wszystkich wymienionych działań synchronizacyjnych w formacie pliku CSV rozdzielanego przecinkami (Synchronisation status.csv).

Podkarty widoku zawierają następujące informacje:

• Diagram – grafika przedstawiająca workflow procesu, z wyróżnionym aktualnym krokiem (Zakończony lub stan błędu/niepowodzenia).
• Data – podsumowanie informacji o działaniu procesu, w tym sukces lub niepowodzenie poszczególnych kroków oraz link do zarejestrowanego raportu procesu – patrz poniżej.
• History – dziennik czasu głównych zdarzeń synchronizacji Workspace wymienionych w kolejności.

Wyniki procesu LibSync są również dostępne na stronie Process Management (Admin » Processes) w zakładce Browser.

Szczegóły wybranego zdarzenia LibSync wyświetlane w podzakładce Data zawierają link do pliku dziennika systemowego (PLM [data-numer].log) dla tego zdarzenia.

Synchronizacja zaplanowana

Masz również możliwość zaplanowania automatycznej synchronizacji. Aby to zrobić, edytuj instancję PLM (na głównej stronie PLM Integration, kliknij jej nazwę lub powiązany przycisk sterujący), wybierz zakładkę Component Synchronisation i włącz opcję Synchronize PLM Components with server on schedule. Użyj elementów sterujących Synchronize every, aby ustawić harmonogram automatycznej synchronizacji zgodnie z wymaganiami. System jest bardzo elastyczny i pozwala na:

• Ustawienie zaplanowanej synchronizacji co 15/30/45/60/75/90 minut.
• Ustawienie zaplanowanej synchronizacji co x godzin.
• Ustawienie zaplanowanej synchronizacji dziennej, wykonywanej o wyznaczonej godzinie.

Ustalony przez Ciebie harmonogram będzie widoczny na głównej stronie PLM Integration, w kolumnie Sync scheduled.

Konfigurowanie harmonogramu synchronizacji.

Aby ustawić zaplanowaną synchronizację, musisz podać poprawne dane uwierzytelniające użytkownika (dla Twojego systemu PLM). Dane te powinny być już zarejestrowane podczas konfigurowania instancji PLM, ale jeśli nie, kliknij przycisk  i wprowadź swój User name oraz Password w wyświetlonym oknie PLM Credentials. Bez poprawnych danych uwierzytelniających zaplanowana synchronizacja pozostanie w stanie WYŁĄCZONA. Synchronizacja na żądanie również nie będzie możliwa.

Możesz także uruchomić proces synchronizacji na żądanie. Kliknij przycisk  i wybierz tryb synchronizacji, którego potrzebujesz:

• Incremental – w tym trybie only zostaną zsynchronizowane te komponenty, które zostały zmodyfikowane od czasu ostatniej synchronizacji (czyli ich znacznik czasu jest późniejszy niż data ostatniej synchronizacji) i które spełniają kryteria synchronizacji w pliku konfiguracyjnym. Zmiany zostaną odpowiednio przekazane. Jest to tryb domyślny i taki sam tryb jest uruchamiany po kliknięciu przycisku  dla instancji PLM na głównej stronie PLM Integration.
• Full – ten tryb wymusza pełną synchronizację. Wszystkie komponenty spełniające kryteria synchronizacji w pliku konfiguracyjnym zostaną zsynchronizowane, a zmiany odpowiednio przekazane.

Przepływy pracy procesów

Następujące definicje procesów (i powiązane z nimi przepływy pracy) są dostępne przez Workspace, wspierając integrację z PLM:

• Part Requests Temat procesów:
  • Part Request with PLM Part Create – wspiera automatyczne tworzenie komponentu w Twojej instancji PLM, a następnie przekazanie wygenerowanego numeru części z powrotem do komponentu w Workspace. Diagram przepływu pracy pokazano poniżej.

Ważna uwaga: podczas modyfikowania tej przykładowej definicji w celu utworzenia własnej, musisz określić instancję PLM, w której mają być tworzone części. Wybierz encję Create Part in PLM w diagramie przepływu pracy i wybierz instancję PLM z menu rozwijanego powiązanego z polem PLM Instance. Menu to zawiera wszystkie aktualnie zdefiniowane instancje PLM (zgodnie z definicją na stronie PLM Integration interfejsu).

► Zobacz Tworzenie i zarządzanie procesami, aby uzyskać więcej informacji o pracy z przepływami procesów.

• Project Activities Temat procesów:

• Publish to PLM (User selects) – publikacja wydanych wyników zarządzanego projektu do zintegrowanej instancji PLM, gdzie użytkownik może wybrać, które wyniki mają zostać opublikowane. Diagram przepływu pracy pokazano poniżej.

• Project Releaser with Publish – publikacja do zintegrowanej instancji PLM jako dodatkowy etap Project Releaser. Diagram przepływu pracy pokazano poniżej.

• Project Creations Temat procesów:
  • Project with initialise in PLM – wspiera automatyczne tworzenie numerów części w Twojej instancji PLM, a następnie przekazanie ich jako parametrów projektu projektowego Workspace. Diagram przepływu pracy pokazano poniżej.

Dostęp do procesów związanych z PLMPoniższe sekcje pokazują, gdzie uzyskać dostęp do aktywowanych procesów związanych z PLM. Ponieważ przykłady nie mogą być używane bezpośrednio, na potrzeby ilustracji utworzono z nich następujące:

• PR with PLM Part Create – utworzony na podstawie przykładowej definicji procesu: Part Request with PLM Part Create.
• Publish to Company PLM – Choose Data – utworzony na podstawie przykładowej definicji procesu: Publish to PLM (User selects).
• Project Releaser with Publish to Company PLM – utworzony na podstawie przykładowej definicji procesu: Project Releaser with Publish.
• Create Project with PLM Initialise – utworzony na podstawie przykładowej definicji procesu: Project with Initialise in PLM.

Zwróć uwagę, że administratorzy Workspace mogą uruchomić nową instancję dowolnej aktywowanej definicji procesu – bezpośrednio z odpowiedniej zakładki tematu procesów w obszarze Processes interfejsu Workspace – klikając przycisk .

Żądania części

Dostępne z poziomu Altium Designer z panelu Explorer, po przeprowadzeniu wyszukiwania, z poziomu panelu Details w Manufacturer Part Search lub z linku na dole listy komponentów w panelu Components.

Z poziomu interfejsu Workspace, aktywowaną definicję procesu można uruchomić ze strony Part Requests, klikając przycisk  w prawym górnym rogu strony.

Przykład żądania części

Poniższy przykład pokazuje w skrócie utworzenie nowej części w Workspace, a następnie automatyczne utworzenie odpowiadającej jej części w instancji PLM. Wygenerowany numer części jest następnie przekazywany z instancji PLM z powrotem do komponentu w Workspace jako parametr pozycji – co oznacza, że nie ma potrzeby wydawania nowej rewizji komponentu Workspace. W tym przykładzie używana jest definicja procesu Part Request with PLM Part Create – pochodząca z przykładowej definicji Part Request with PLM Part Create.

Podane tutaj informacje będą podobne dla różnych obsługiwanych systemów PLM. Różnić się będzie plik konfiguracyjny, który możesz zmienić, aby dostosować go do potrzeb firmy, a także jeśli zmodyfikowałeś przepływ pracy dla definicji procesu użytej do utworzenia części.

1. Rozpocznij proces żądania części i wypełnij wyświetlony formularz – podając szczegóły początkowego żądania – zgodnie z potrzebami. Na poniższym obrazku żądanie jest składane przez stronę Part Requests interfejsu Workspace i dotyczy pojedynczej części.

2. Nowe żądanie części zostanie wyświetlone jako aktywny proces na stronie Part Requests, z aktualnym stanem widocznym w głównym wpisie oraz w diagramie przepływu pracy.

3. Gdy wymagany użytkownik podejmie się (lub zostanie mu przydzielone) zadania realizacji żądania, ostatecznie tworzy żądaną część (części). Każdy komponent utworzony (i/lub wybrany) w celu realizacji żądania jest dodawany do pola Components zadania. Dodane komponenty zostaną automatycznie utworzone w PLM. Na poniższym obrazku utworzono i dodano pojedynczy komponent – CMP-007-00004. Upewnij się, że pole Next step jest ustawione na Completed i kliknij przycisk .

Możesz zostać poproszony o podanie danych logowania do systemu PLM określonego w przebiegu procesu Zgłoszenia Części.

4. Proces będzie kontynuowany, a wskazany komponent zostanie utworzony w instancji PLM. Po zakończeniu procesu możesz zobaczyć wygenerowany numer części PLM na Data karcie procesów. Upewnij się, że przełączyłeś filtr (lewy górny róg) na widok Closed procesów.

Administratorzy mogą użyć przycisku , aby pobrać szczegółowy rejestr wszystkich wymienionych Zgłoszeń Części w formacie CSV oddzielonym przecinkami.

5. Wróć do Altium Designer, wyszukaj utworzony komponent w panelu Explorer i przełącz widok na jego kartę Preview . W sekcji parametrów zauważysz, że został dodany dodatkowy parametr – PlmPartNumber – którego wartość to numer odpowiadającej mu utworzonej części w PLM.

Zwróć uwagę, że parametr został dodany do komponentu, ale jego rewizja pozostaje bez zmian – nie nastąpiło ponowne wydanie komponentu. Wynika to z faktu, że parametr jest parametrem na poziomie elementu – dodanym bezpośrednio do Elementu Komponentu i dostępnym we wszystkich jego rewizjach.

Aktywności projektowe

Dane projektowe wydane z Altium Designer do Workspace mogą być propagowane do PLM w kontrolowany sposób za pomocą procesów Workspace Publish to PLM. Procesy Workspace definiują interfejs i metodykę publikacji, a określony Szablon Publikacji XML definiuje, w jaki sposób dane plików są przekazywane do docelowego systemu PLM.

Obsługa publikowania folderów dla Windchill PLM

Podczas konfigurowania procesu Publish to PLM dla Windchill^® PLM, możesz również określić (i utworzyć) docelowy folder Windchill dla dokumentów publikowanych z Workspace.

Odpowiednie parametry folderu Windchill są definiowane w pliku Publishing Template XML, który jest stosowany do Twojej integracji Windchill PLM w Workspace. Węzły definicji folderów mają format tagu <pt:Folder>xxx</pt:Folder> – gdzie pt to bieżąca przestrzeń nazw, a xxx to pełna ścieżka folderu – i są umieszczane jako reguła publikacji w sekcji FileDistribution dla każdego typu dokumentu (na przykład dla PCB.zip Fabrication output).

Przykład hierarchii struktury Publishing XML wyglądałby następująco:

<pt:EntityRule id="FAB">
  <pt:FileDistributions>
    <pt:FileDistribution archiveName="PCB.zip">
      <pt:Folder>PRODUCT/Projects/${project.name}/FAB data</pt:Folder>

Ostatnia linia wpisu określa (lub tworzy) docelowy folder publikacji dla PCB.zip Fabrication output ze strukturą folderów Windchill (gdzie nazwa projektu to MyProject):

PRODUCT
  Projects
    MyProject
      FAB data

Zwróć uwagę, że ścieżka folderu zdefiniowana w pliku Publishing XML jest bezwzględna (a nie względna) i może zawierać inne właściwości projektu, takie jak nazwa projektu (${project.name}) czy numer złożenia (${project.PLM_ASSEMBLY_NUMBER}).

Dodatkowo, możliwość create docelowego folderu jest obsługiwana dla usług Windchill REST API 1.3 i nowszych. Dla starszych wersji REST wskazana ścieżka folderu docelowego musi już istnieć i nie może być utworzona.

Standardowy proces publikacji

Po stronie projektowej standardowy proces publikacji do PLM jest dostępny w Altium Designer z podmenu Project » Project Activities dla aktywnego projektu.

Z poziomu interfejsu Workspace aktywne definicje procesów są dostępne z widoku Project Management po kliknięciu przycisku .

Publikowanie za pomocą Project Releaser

Proces publikacji do instancji PLM w ramach Project Releaser jest dostępny w Altium Designer z podmenu Project » Project Releaser dla aktywnego projektu.

Pojawi się Project Releaser, z dodatkowym etapem – 7: Publish to PLM. Dodatkowo, z menu powiązanego z przyciskiem dostępne jest polecenie – Prepare & Release & Publish to PLM – jeśli chcesz uruchomić Project Releaser bez zatrzymywania się na przeglądanie wygenerowanych danych i raportu z wykonania.

Jeśli uruchomisz Project Releaser za pomocą standardowego polecenia Prepare , po przejrzeniu i wydaniu danych pojawi się przycisk na etapie Execution Report. Kliknij go, aby kontynuować bazowy przebieg procesu i opublikować do PLM. Pojawi się okno dialogowe Login Credentials. Wprowadź Username i Password dla swojej instancji PLM oraz wybierz szablon PLM, którego chcesz użyć (pojawi się w formie <PLMInstance>:<PublishingTemplate>).

Jeśli zdecydujesz się użyć polecenia Prepare & Release & Publish to PLM, ostatecznie zostanie wyświetlone bezpośrednio okno dialogowe Login Credentials. Project Releaser nie zatrzyma się na etapie Execution Report i nie pojawi się przycisk .

Kliknij kartę Diagram , aby zobaczyć podstawowy przebieg procesu.

Kliknij przycisk , aby kontynuować proces publikacji zgodnie z tym przebiegiem.

Sprawdź status procesu publikacji do PLM poprzez interfejs Workspace, wybierając widok Activities z poziomu szczegółowego widoku projektu — po otwarciu projektu z widoku Projects. Wybierz opcję widoku Opened, aby zobaczyć status podczas trwania procesu, oraz opcję aktywności Closed, aby uzyskać informacje o statusie po zakończeniu procesu.

Tworzenie projektów

Po stronie projektowej, dostęp z poziomu Altium Designer z głównego podmenu File » New » Project in <workspace>.

Z poziomu interfejsu Workspace, aktywowaną definicję procesu można uzyskać z widoku Projects, klikając przycisk .

Również podczas klonowania projektu, dostępne z menu w widoku Projects.

Przebieg procesu będzie kontynuowany, pojawi się okno dialogowe umożliwiające zdefiniowanie projektu pod względem nazwy, opisu, typu oraz ewentualnego szablonu projektu, który ma być użyty przy jego tworzeniu. Po kliknięciu Start pojawi się okno dialogowe Login Credentials. Wprowadź Username i Password dla swojej instancji PLM oraz wybierz szablon PLM, którego chcesz użyć (pojawi się w formie <PLMInstance>:<PublishingTemplate>). Następnie kliknij Submit , aby kontynuować przebieg procesu.