6x
006212
2026-07-28

Пользовательские компоненты

Пользовательские компоненты позволяют создавать собственные серии компонентов и использовать их в RFEM 6. В дополнение к сериям, предоставленным в Dlubal Center, таким образом можно интегрировать специфические для компании расчётные логики и проверки отдельных элементов.

Предварительные условия

Для создания и расчёта пользовательских компонентов требуется следующее:

  • Базовая подписка на Dlubal API
  • Создать API-ключ в Экстранете
  • Интегрировать API-ключ в RFEM

Создание API-ключа в Экстранете

  1. Открыть Экстранет
  2. Перейти: API & CloudAPI IIMy API Keys
  3. Выбрать Create new API key
  4. Присвоить имя и сгенерировать ключ
  5. Сохранить

Интегрирование API-ключа в RFEM

  1. Открыть RFEM
  2. Открыть меню ВидКонсоль
  3. Выбрать Python | Dlubal API | gRPC
  4. Выбрать символ ключа
  5. Ввести API-ключ (Имя + Ключ)
  6. Подтвердить

Ключ сохраняется в файле config.ini.

Совет

Дополнительную информацию об интерфейсе API вы найдете в технической статье API II.

Создание пользовательского компонента

Вы можете активировать ввод пользовательского компонента следующим образом:

  1. Откройте диалог Серии компонентов.
  2. Установите флажок Пользовательский.

После этого все поля ввода будут разблокированы.

Категории (Метаданные)

  • Тип назначения (например, назначение объекта)
  • Производитель / Новый производитель
  • Нормы и вывод
  • Функция / Категория
  • Материал

Конфигурационные файлы (Файлы)

1. Изображения

  • Добавление любых изображений или системных эскизов
  • Назначение: визуальное представление компонента

2. Структура параметров (JSON-файл)

  • Группировка структуры ввода
  • Определение назначения параметров

Важные поля:

group
  • Структурирование в диалоге RFEM
 
  • Служат в качестве заголовков
 
  • Свободное именование
key
  • Должен точно соответствовать параметру Excel
caption
  • Отображаемое имя
 
  • Свободное именование
symbol, unit
  • Определение представления
type
  • Тип данных для использования в скриптах (например, float, int, bool, ...)

Другие группы можно добавлять произвольно.

3. Данные параметров (Excel-файл)

  • Данные определяют структуру параметров.
  • Каждая строка должна иметь уникальное имя.
  • Столбцы можно определять свободно, но использовать единообразно.

4. Визуализация (RFEM 6-файл)

  • Обеспечивает детальную визуализацию в рабочем окне RFEM
  • Однако компонент также можно создать без файла визуализации

Python-скрипты (Скрипт после расчёта)

Скрипт после расчёта управляет проверками компонента.

Важный

При использовании параметров в Python-скрипте необходимо учитывать, что ключи (Keys) всегда должны указываться в нижнем регистре и в формате "snake_case". Написание ключей должно соответствовать назначению параметров, используемому в JSON-файле и Excel-файле.

Функция: define_design_checks

  • Определение категорий проверок
  • Тип = Отображение в RFEM (выбирается свободно)
  • Описание, категория и подкатегория определяются свободно

Функция: evaluate_single_check

  • Передача коэффициентов использования в RFEM

Функция: setup_component_series_data()

  • Выполнение расчёта
  • Считывание параметров через properties_parameters
  • Ключ должен быть идентичен JSON и Excel
  • Требуется согласованный тип между определением и оценкой

Сохранение компонента в Dlubal Center и повторное использование

Вы можете сохранить пользовательский компонент в качестве шаблона, чтобы использовать его и в других проектах.

Действуйте следующим образом:

  1. Нажмите в диалоге Серии компонентов внизу на кнопку Сохранить .
  2. Появится окно 'Сохранить серию компонентов' с предложенной папкой для сохранения Документы → Dlubal Software → Component Series.
  3. Задайте имя файла и подтвердите, нажав кнопку Сохранить.

Пользовательские компоненты добавляются в Dlubal Center в категории Серии компонентов. В записи OwnerПользовательский вы можете выбрать там подходящий компонент и назначить его стержню.

В качестве альтернативы используйте кнопку Файл einlesen внизу диалога Серии компонентов, чтобы загрузить компонент из файла.

Исходная глава

Knowledge Base