Przegląd integracji z Aras

Prev Next

Usprawnij zarządzanie cyklem życia produktu (PLM) oraz ogólne zarządzanie cyklem życia produktu dzięki integracji z Aras

Additional Configuration Required

This connector is a good starting point that implements a core set of the service's most common functions. You should expect to extend it by adding functions for the specific endpoints your workflow requires. Additionally, some configuration may be required in Aras to establish a connection with Tulip. Please review our [connectors](/r230/docs/<span translate=)">connector framework to learn more about how to build and modify connectors in Tulip.

Kontekst

Aras Innovator to kompletne rozwiązanie PLM. Posiada samopisujący się model danych, który pozwala na szerokie dostosowanie do indywidualnych potrzeb. W tym artykule omówimy, jak skonfigurować instancję w celu połączenia za pośrednictwem Tulip. Jeśli szukasz więcej informacji na temat Aras Innovator, odwiedź naszą stronę internetową.

Informacje ogólne

Aras Innovator to aplikacja oparta na IIS, którą można uruchamiać lokalnie lub w chmurze. Jedynym istotnym wymogiem połączenia z instancją za pośrednictwem Tulip jest to, aby serwer akceptował żądania z serwerów Tulip. Na potrzeby tej demonstracji założymy, że serwer jest skonfigurowany na otwarte połączenie.

Konfiguracja

Łącznik

Podczas tworzenia nowego łącznika w sekcji „Host” w oknie „Szczegóły połączenia” należy wskazać adres BASE URL komputera hosta. Należy pamiętać, że dostęp do adresu URL Innovatora uzyskuje się zazwyczaj poprzez [BASE URL]/InnovatorAlias.
image.png

Uwierzytelnianie

Aby uwierzytelnić naszą aplikację Tulip, musimy uzyskać token, który zostanie przesłany wraz ze wszystkimi naszymi funkcjami łącznika. W tym celu stworzymy jedną funkcję łącznika, która będzie przekazywać token odpowiedzi do wszystkich pozostałych. Oto przykładowy kod tej funkcji uwierzytelniającej:
image.png

W tym przypadku wysyłamy żądanie, aby uzyskać token przy użyciu naszej nazwy użytkownika i zaszyfrowanego hasła. W treści żądania umieszczamy wszystkie niezbędne informacje. Więcej informacji na temat uzyskiwania tokenu z Aras Innovator można znaleźć w powiązanym wpisie na blogu firmy Aras:

Wynikiem działania tej funkcji jest zmienna o nazwie access_token. Wszystkie pozostałe funkcje będą miały wejście dla tej zmiennej. Zazwyczaj wywołujemy tę funkcję pobierania tokenu na początku każdego uruchomienia naszej aplikacji. W ten sposób dysponujemy tokenem dla wszystkich pozostałych wywołań.

Korzystanie z funkcji łącznika w aplikacjach

Oto przykładowy wygląd wyzwalacza uruchamianego na początku aplikacji:image.png

Ponieważ zapisujemy wynik naszej pierwszej funkcji do zmiennej, będzie on dostępny we wszystkich naszych przyszłych krokach i funkcjach. Stąd możesz wykonywać dowolne operacje za pośrednictwem naszego API. Zasadniczo zaleca się pobieranie danych z Innovatora i wyświetlanie ich w Tulip, ale nasze API pozwala również na tworzenie danych w Innovatorze za pomocą wywołania REST.

Oto krótki przykład tego, jak moglibyśmy pobrać wszystkie części w naszym systemie. Dysponujemy interfejsem API opartym na OData, który umożliwia elastyczne zapytania na podstawie adresu URL.
image.png

Jak widać, mamy tylko jeden nagłówek żądania, który wykorzystuje naszą zmienną access_token. Ponieważ w tym zapytaniu będziemy pobierać wiele części, wynik zapiszemy jako tablicę, a poniżej zdefiniujemy różne właściwości naszej części. Korzystając z interfejsu API OData, można zażądać dowolnego konkretnego elementu, przekazując dodatkowe dane wejściowe, które pomogą zidentyfikować poszukiwany element.
image.png

W tym przykładzie widać, że dodajemy dodatkowy parametr zapytania, który ustawia filtr. W tym przypadku pobieramy numer elementu konkretnej części w systemie Aras i wprowadzamy go do naszego filtra. W systemie Aras można filtrować według dowolnej właściwości, nawet tych niestandardowych, które zostały zdefiniowane w systemie.

Zapytania mogą być nieco bardziej skomplikowane, jeśli chodzi o przechodzenie przez różne relacje w systemie Aras. Na przykład w domyślnej konfiguracji Innovator mamy relację „jeden do wielu” między częściami a dokumentami. Każda część może mieć wiele dokumentów, a my chcemy wyświetlić wszystkie dokumenty powiązane z daną częścią. Zapytanie wyglądałoby następująco:
image.png

W tym przypadku określamy konkretną część i szukamy wszystkich powiązanych instancji elementu „Part Document” (elementu łączącego część z dokumentem). Następnie rozszerzamy pole related\_id elementu „Part Document”, aby uzyskać dostęp do samego elementu „Document”. Jeśli spojrzysz na wyniki, zobaczysz, że pobieramy odpowiednie informacje z pola related\_id.

Metodę tę można wykorzystać do przeglądania dowolnych relacji w systemie Aras Innovator. Aby uzyskać więcej informacji na temat pełnego wykorzystania potencjału naszego interfejsu API REST, zapoznaj się z oficjalną dokumentacją

Wnioski

Istnieje wiele innych zaawansowanych połączeń, które można nawiązać między Aras Innovator a Tulip. Dostępne jest całe nasze API OData. Dzięki API można zrobić znacznie więcej niż tylko pobierać dane. Można przesyłać dane do Innovatora, a nawet wykonywać takie czynności, jak uruchamianie niestandardowej logiki za pomocą metod lub przeprowadzanie złożonych zapytań poprzez definicje zapytań! Istnieje mnóstwo możliwości, które można wykorzystać, aby w pełni wykorzystać potencjał tego połączenia. Jeśli masz pytania dotyczące Aras Innovator, skontaktuj się z nami na forach społeczności Aras. Jeśli szukasz więcej informacji dotyczących konkretnie naszego interfejsu API, zapoznaj się z dokumentacją tutaj.