Dla produktów platformy EPLAN dostępny jest teraz jednolity i szczególnie wydajny interfejs programowania (API, Application Programming Interface). Za pomocą tego modułu rozszerzającego – EPLAN API – można rozwijać samodzielnie, we współpracy z EPLAN lub innymi partnerami, własne rozwiązania dostosowane do potrzeb klienta. Więcej informacji na temat EPLAN API oraz EADN można znaleźć na stronach internetowych EPLAN w rubryce "Rozwiązania > Integracja > EPLAN Application Developer Network". W poniższym rozdziale zamieszczono informacje na temat różnych nowości w EPLAN API. Do rozwijana własnych zastosowań za pomocą nowej wersji EPLAN API niezbędny jest program .NET Framework 4.7.2 firmy Microsoft.
Wskazówki:
-
"EPLAN API Extension" jest dostępny w ramach naszego EPLAN Application Developer Network (EADN) jako pakiet rozwojowy, a ponadto można go nabyć dla różnych wariantów programu w formie licencji na opcjonalny, płatny moduł rozszerzający.
- Każdemu użytkownikowi API zalecamy wcześniejszą kompilację aplikacji z nową wersją EPLAN API i przetestowanie. Jeżeli używasz jeszcze przestarzałych metod w aplikacji, to podczas kompilacji wyświetli się odpowiednie ostrzeżenie o kompilacji.
Automatyczne skalowanie podczas importu plików DXF
Za pomocą EPLAN API istnieje teraz możliwość automatycznego skalowania plików podczas importu. Dla metody DXFPage jest dostępna w tym celu nowa klasa DrawingLimits.
Nowe możliwości dla punktów montażu
W klasie Mate dostępne są obie nowe klasy GridMate i LineMate, które reprezentują określone .
Odczytaj źródło i cel dla każdej żyły kabla
Za pomocą nowej metody GetSourcesAndTargets w klasie Cable można określać dla kabli informacje dotyczące źródła i celu żył.
Zastąp teksty w projekcie
Za pomocą nowej metody Replace klasy Search można teraz zastępować słowa w projekcie innymi słowami.
Nowa metoda do wstawiania makr okna 3D
W klasie Insert3D dostępny jest nowy wariant metody WindowMacro. W ten sposób można dołączyć miejsce ujęcia przy określonym punkcie montażu innego obiektu.
Ustal wszystkie obiekty określonego typu
Klasa DMObjectsFinder została rozszerzona o nową metodę GetAll. W ten sposób można ustalić wszystkie określonego typu obiektu.
Nowa klasa do tworzenia właściwości zdefiniowanych przez użytkownika w zarządzaniu artykułami
Za pomocą nowej klasy MDUserDefinedPropertyDefinition można tworzyć dla zarządzania artykułami. W tym celu należy zapoznać się również z rozdziałem "Rozszerzenia dla właściwości zdefiniowanych przez użytkownika".
Pozostałe formaty dla akcji "ExportNCData"
Do eksportu danych NC za pomocą akcji ExportNCData dostępne są teraz również "Miedź-NC", "Miedź-DXF" i "Gięcie elementu miedzianego".
Odczytaj nazwy obiektów w aktualnym języku interfejsu
Nowa metoda GetTypeName umożliwia odczyt nazwy typu obiektu w aktualnie ustawionym języku interfejsu.
Nowa metoda do generowania szyn zbiorczych
W klasie BusBar dostępne jest nowe przeładowanie metody Create z prostą możliwością generowania szyn zbiorczych.
Nowa właściwość do odczytu wersji bazy danych w zarządzaniu artykułami
Do odczytu wersji bazy danych w zarządzaniu artykułami dostępna jest w klasie MDPartsDatabase nowa właściwość Version.
Nowe właściwości do odczytu identyfikatorów
Do odczytu identyfikatorów dostępna jest w klasie FunctionDefinitionLibrary nowa właściwość IdentifierSets. W ten sposób można odczytać nazwy zestawów identyfikatorów.
Ponadto w klasie FunctionDefinition dostępna jest nowa właściwość Identifiers, za pomocą której możesz określić wszystkie identyfikatory (dla wszystkich dostępnych norm).
Nowe metody do wyszukiwania i zastępowania warstw
Na platformie EPLAN istnieje teraz możliwość wyszukiwania warstw zdefiniowanych przez użytkownika i zastępowania ich (patrz rozdział "Rozszerzenia w zarządzaniu warstwami"). W klasie GraphicalLayerTable dostępne są w tym celu teraz nowe metody do pracy z zarządzaniem warstwami.
Nowe akcje do rejestrowania / odrejestrowania Add-ons
Do rejestrowania / odrejestrowania Add-ons dostępne są dwie nowe XSettingsRegisterAction i XSettingsUnregisterAction.
Nowa metoda określania punktów montażowych
W klasie SelectionSet można teraz za pomocą nowej metody Mates określać wybrane punkty montażowe w grafice 3D lub w nawigatorze obszaru zabudowy.
Wczytaj katalog za pomocą akcji "projectmanagement"
Akcja projectmanagement została rozszerzona. Za pomocą nowej wartości parametru /TYPE:LOADDIRECTORY oraz parametrów /PROJECTSDIRECTORY i /SCANSUBDIRECTORIES można teraz wykonać funkcję Wczytaj katalog z zarządzania projektem poprzez wywołanie wiersza poleceń, skrypt lub EPLAN API.
Dostęp "ActionCallingContext" w skryptach z akcjami
Jeżeli udostępniasz w skrypcie własną akcję za pomocą atrybutu [DeclareAction], istnieje teraz alternatywna możliwość zastosowania kompletnego ActionCallingContext jako parametru opracowującej metody.
Określ współrzędne wszystkich narożników dla rozmieszczeń artykułów 3D
W klasie Placement3D dostępna jest teraz nowa właściwość Corners. Za pomocą tej właściwości możesz określać bezwzględne i względne współrzędne wszystkich narożników dla rozmieszczenia artykułów 3D.
Utwórz skrzynki makra jako wielolinie
Za pomocą EPLAN API istnieje teraz również możliwość tworzenia skrzynek jako zamkniętych wielolinii. Wielolinie definiowane są za pomocą właściwości LogicalAreaSegments z klasy MacroBox.
Zmień pozycję segmentów w nawigatorze planowania wstępnego
Za pomocą EPLAN API możesz teraz zmieniać pozycję segmentów (węzłów) w strukturze drzewa nawigatora planowania wstępnego. W tym celu w klasie PrePlanningService dostępne są nowe metody MoveUp i MoveDown.
Definiuj wstępnie nazwy plików dla okna dialogowego wyboru pliku
W klasie FileSelectDecisionContext można teraz definiować wstępnie nazwy plików dla okna dialogowego wyboru pliku za pomocą nowej właściwości DefaultFilename.
Aktualizacja rozmieszczeń artykułów w obszarze zabudowy
Do aktualizacji rozmieszczeń artykułów w obszarze zabudowy za pomocą EPLAN API dostępna jest teraz w klasie Placement3DService nowa metoda UpdatePartPlacement.
Klasa "ConnectionPointPosition" uzupełniona o dodatkowe właściwości
Klasa ConnectionPointPosition została uzupełniona o następujące właściwości:
-
SocketSize
-
MinTighteningTorque
-
MaxTighteningTorque
-
StrippingLength
Rozszerzona akcja "XPamsDeviceSelectionAction"
Akcja XPamsDeviceSelectionAction została rozszerzona. Jeżeli dla parametru /PROJECTNAME nie zostaną podane żadne dane, zostanie użyty wybrany teraz projekt. W ramach tej zmiany został dopasowany również parametr /Mode.
- Za pomocą wartości selectDevice wybiera się nowe dla istniejących obiektów. Wszystkie dane wraz z danymi odsyłacza do części są teraz usuwane i przydzielane od nowa zgodnie z wyborem urządzenia.
- Wartość updateDevice aktualizuje tylko dane urządzenia artykułów istniejących obiektów. Numery artykułu i dane odsyłacza do części pozostają przy tym zachowane. Funkcja jest zgodna z nowym punktem menu kontekstowego Aktualizuj dane urządzenia w nawigatorze listy materiałowej.
Określ aktualny wybór w nawigatorze makr
Istnieje teraz możliwość określenia aktualnego wyboru w nawigatorze makr za pomocą EPLAN API. Za pomocą metody Selection z klasy SelectionSet można określać obiekty typu MacroEntry, które reprezentują wybrane makro.
Nowa metoda do korekty tekstów nietłumaczonych
W klasie Translate dostępna jest teraz nowa metoda Correct, za pomocą której możesz usunąć tłumaczenie tekstów właściwości nieprzeznaczonych do tłumaczenia. W oknie dialogowym Ustawienia: Zakres interfejsu użytkownika odpowiada to przyciskowi Korekta (ścieżka menu Opcje > Ustawienia > Projekty > "Nazwa projektu" > Tłumaczenie > Zakres).
Określ aktualny wybór w zarządzaniu warstwami
Za pomocą nowej właściwości Layers z klasy SelectionSet można teraz w nowym dołączonym oknie dialogowym Zarządzanie warstwami określać aktualnie wybraną warstwę.
Eksportowanie przypisania przestrzeni adresowej
Za pomocą nowej metody ExportAddressOverview z klasy PlcService można teraz eksportować CPU. W oknie dialogowym Adresy / Listy przyporządkowań interfejsu użytkownika odpowiada to punktowi menu Eksportuj przypisanie przestrzeni adresowej poniżej przycisku [Dodatki] (ścieżka menu Dane projektu > PLC > Adresy / Listy przyporządkowań).
Powiązanie segmentów z rozmieszczeniami artykułów 3D
W nawigatorze planowania wstępnego można powiązać teraz z rozmieszczeniami artykułów 3D. W EPLAN API działa to za pomocą właściwości PlanningSegment z klasy Function3D.