6x
006212
2026-07-28

Componentes Personalizados

Componentes personalizados permitem criar as suas próprias séries de componentes e utilizá-las no RFEM 6. Além das séries disponibilizadas no Centro Dlubal, podem também ser integradas lógicas de dimensionamento específicas da empresa e verificações detalhadas.

Pré-requisitos

Para a criação e o cálculo de componentes personalizados, é necessário o seguinte:

  • Subscrição Basic da Dlubal API
  • Criar chave API no Extranet
  • Integrar chave API no RFEM

Criar chave API no Extranet

  1. Abrir o Extranet
  2. Navegar para API & CloudAPI IIMy API Keys
  3. Selecionar Create new API key
  4. Atribuir um nome e gerar a chave
  5. Guardar

Integrar chave API no RFEM

  1. Abrir o RFEM
  2. Abrir o menu VerConsola
  3. Selecionar Python | Dlubal API | gRPC
  4. Selecionar o símbolo de chave
  5. Introduzir a chave API (Nome + Chave)
  6. Confirmar

A chave é guardada num ficheiro config.ini.

Sugestão

Mais informações sobre a interface API podem ser encontradas no artigo técnico API II.

Criar componente personalizado

Pode ativar a introdução de um componente personalizado da seguinte forma:

  1. Abra o diálogo Séries de componentes.
  2. Ative a opção Personalizado.

Desta forma, todos os campos de introdução são desbloqueados.

Categorias (Metadados)

  • Tipo de atribuição (p. ex., atribuição de objeto)
  • Fabricante / Novo fabricante
  • Normas e saída
  • Função / Categoria
  • Material

Ficheiros de configuração (Ficheiros)

1. Imagens

  • Adicionar imagens quaisquer ou esboços do sistema
  • Objetivo: representação visual do componente

2. Estrutura de parâmetros (Ficheiro JSON)

  • Agrupamento da estrutura de entrada
  • Definição da atribuição de parâmetros

Campos importantes:

group
  • Estruturação no diálogo RFEM
 
  • serve como título
 
  • designação livre
key
  • deve corresponder exatamente ao parâmetro Excel
caption
  • nome de exibição
 
  • designação livre
symbol, unit
  • definição da apresentação
type
  • tipo de dados para utilização nos scripts (p. ex., float, int, bool, ...)

Podem ser adicionados outros grupos conforme necessário.

3. Dados de parâmetros (Ficheiro Excel)

  • Os dados definem a estrutura de parâmetros.
  • Cada linha deve ter um nome exclusivo.
  • As colunas são definíveis livremente, mas devem ser utilizadas de forma consistente.

4. Visualização (Ficheiro RFEM 6)

  • Permite a visualização detalhada na janela de trabalho do RFEM
  • O componente também pode ser criado sem ficheiro de visualização

Scripts Python (Script após o cálculo)

O Script após o cálculo controla as verificações do componente.

Importante

Ao utilizar parâmetros no script Python, note que as Keys devem ser sempre indicadas em minúsculas e no formato "snake_case". A ortografia das Keys deve corresponder à atribuição de parâmetros utilizada no ficheiro JSON e no ficheiro Excel.

Função: define_design_checks

  • Definição das categorias de verificação
  • Tipo = Exibição no RFEM (livremente selecionável)
  • Descrição, categoria e subcategoria livremente definíveis

Função: evaluate_single_check

  • Transferência das utilizações para o RFEM

Função: setup_component_series_data()

  • Execução da verificação
  • Leitura dos parâmetros através de properties_parameters
  • A chave deve ser idêntica à do JSON e Excel
  • É necessário um tipo consistente entre a definição e a avaliação

Guardar e reutilizar o componente no Centro Dlubal

Pode guardar um componente personalizado como modelo para o utilizar também noutros projetos.

Proceda da seguinte forma:

  1. Clique no botão Guardar na parte inferior do diálogo Séries de componentes.
  2. Aparece a janela 'Guardar série de componentes' com a pasta de destino sugerida Documentos → Dlubal Software → Component Series.
  3. Defina um nome de ficheiro e confirme, clicando no botão Guardar.

Os componentes personalizados são adicionados no Centro Dlubal na categoria Séries de componentes. Na entrada ProprietárioPersonalizado, pode selecionar o componente adequado e atribuí-lo a uma barra.

Em alternativa, utilize o botão Ler ficheiro na parte inferior do diálogo Séries de componentes para importar o componente de um ficheiro.

Capítulo principal

Knowledge Base