6x
006212
2026-07-28

Niestandardowe komponenty

Komponenty użytkownika umożliwiają tworzenie własnych serii komponentów i używanie ich w RFEM 6. Oprócz serii dostępnych w Dlubal Center, można integrować również firmowe logiki obliczeniowe i obliczenia szczegółowe.

Wymagania

Do tworzenia i obliczania komponentów użytkownika wymagane są:

  • Abonament Basic Dlubal API
  • Utworzenie klucza API w Extranecie
  • Zintegrowanie klucza API w RFEM

Tworzenie klucza API w Extranecie

  1. Otworzyć Extranet
  2. Przejść do API i ChmuraAPI IIMoje klucze API
  3. Wybrać Utwórz nowy klucz API
  4. Nadać nazwę i wygenerować klucz
  5. Zapisać

Integracja klucza API w RFEM

  1. Otworzyć RFEM
  2. Otworzyć menu WidokKonsola
  3. Wybrać Python | Dlubal API | gRPC
  4. Wybrać symbol klucza
  5. Wprowadzić klucz API (nazwa + klucz)
  6. Zatwierdzić

Klucz jest zapisywany w pliku config.ini.

Wskazówka

Więcej informacji na temat interfejsu API można znaleźć w artykule API II.

Tworzenie komponentu użytkownika

Wprowadzanie komponentu użytkownika można aktywować w następujący sposób:

  1. Otworzyć okno dialogowe Seria komponentów.
  2. Zaznaczyć opcję Użytkownika.

Spowoduje to odblokowanie wszystkich pól wprowadzania.

Kategorie (metadane)

  • Sposób przypisania (np. przypisanie do obiektu)
  • Producent / nowy producent
  • Normy i wydruk
  • Funkcja / kategoria
  • Materiał

Pliki konfiguracyjne (pliki)

1. Obrazy

  • Dodawanie dowolnych obrazów lub szkiców systemowych
  • Cel: wizualna prezentacja komponentu

2. Struktura parametrów (plik JSON)

  • Grupowanie struktury wprowadzania
  • Definicja przypisania parametrów

Ważne pola:

group
  • Strukturyzacja w oknie dialogowym RFEM
 
  • służą jako nagłówek
 
  • dowolna nazwa
key
  • musi dokładnie odpowiadać parametrowi programu Microsoft Excel
caption
  • nazwa wyświetlana
 
  • dowolna nazwa
symbol, unit
  • definicja wyświetlania
type
  • typ danych do użycia w skryptach (np. float, int, bool, ...)

Można dowolnie dodawać kolejne grupy.

3. Dane parametrów (plik programu Microsoft Excel)

  • Dane definiują strukturę parametrów.
  • Każdy wiersz musi mieć unikalną nazwę.
  • Kolumny są definiowane dowolnie, ale muszą być używane konsekwentnie.

4. Wizualizacja (plik RFEM 6)

  • Umożliwia szczegółową wizualizację w oknie roboczym RFEM
  • Komponent można jednak utworzyć również bez pliku wizualizacji

Skrypty Python (Skrypt po obliczeniach)

Skrypt po obliczeniach steruje obliczeniami komponentu.

Ważne

Podczas używania parametrów w skrypcie Python należy pamiętać, że klucze muszą być zawsze podawane małymi literami i w formacie "snake_case". Sposób zapisu kluczy musi przy tym być zgodny z przypisaniem parametrów użytym w pliku JSON i pliku programu Microsoft Excel.

Funkcja: define_design_checks

  • Definicja kategorii obliczeń
  • Typ = wyświetlanie w RFEM (dowolnie wybieralny)
  • Opis, kategoria i podkategoria dowolnie definiowalne

Funkcja: evaluate_single_check

  • Przekazanie stopni wykorzystania do RFEM

Funkcja: setup_component_series_data()

  • Przeprowadzenie procesu obliczeniowego
  • Odczytywanie parametrów przez properties_parameters
  • Klucz musi być identyczny jak w JSON i programie Microsoft Excel
  • Wymagany jest spójny typ między definicją a ewaluacją

Zapisywanie i ponowne wykorzystanie komponentu w Dlubal Center

Komponent użytkownika można zapisać jako szablon, aby używać go również w innych projektach.

Postępować w następujący sposób:

  1. Kliknąć przycisk Zapisz na dole okna dialogowego Seria komponentów.
  2. Pojawi się okno 'Zapisz serię komponentów' z proponowanym folderem zapisu Dokumenty → Dlubal Software → Component Series.
  3. Określić nazwę pliku, a następnie zatwierdzić przyciskiem Zapisz.

Komponenty użytkownika są dodawane w Dlubal Center w kategorii Serie komponentów. Pod wpisem WłaścicielUżytkownika można tam wybrać odpowiedni komponent i przypisać go do pręta.

Alternatywnie można użyć przycisku Plik einlesen na dole okna dialogowego Seria komponentów, aby wczytać komponent z pliku.

Rozdział nadrzędny

Baza wiedzy