6x
006212
28.07.2026

Composants personnalisés

Composants personnalisés permettent de créer vos propres séries de composants et de les utiliser dans RFEM 6. En plus des séries fournies dans le Centre Dlubal, vous pouvez ainsi intégrer des logiques de calcul et des vérifications spécifiques à votre entreprise.

Conditions préalables

Pour la création et le calcul de composants personnalisés, les éléments suivants sont nécessaires :

  • Abonnement Basic à la API Dlubal
  • Créer une clé API dans l'Extranet
  • Intégrer la clé API dans RFEM

Créer une clé API dans l'Extranet

  1. Ouvrir l'Extranet
  2. Naviguer vers API & CloudAPI IIMy API Keys
  3. Sélectionner Create new API key
  4. Attribuer un nom et générer la clé
  5. Enregistrer

Intégrer la clé API dans RFEM

  1. Ouvrir RFEM
  2. Ouvrir le menu AffichageConsole
  3. Sélectionner Python | Dlubal API | gRPC
  4. Sélectionner le symbole de clé
  5. Saisir la clé API (Nom + Clé)
  6. Confirmer

La clé est enregistrée dans un fichier config.ini.

Astuce

Pour plus d'informations sur l'interface API, consultez l'article technique API II.

Créer un composant personnalisé

Vous pouvez activer la saisie d'un composant personnalisé comme suit :

  1. Ouvrez la boîte de dialogue Séries de composants.
  2. Cochez l'option Personnalisé.

Tous les champs de saisie sont alors déverrouillés.

Catégories (Métadonnées)

  • Type d'assignation (p. ex. assignation d'objet)
  • Fabricant / Nouveau fabricant
  • Normes et sortie
  • Fonction / Catégorie
  • Matériau

Fichiers de configuration (Fichiers)

1. Images

  • Ajouter des images ou croquis quelconques
  • But : Représentation visuelle du composant

2. Structure des paramètres (fichier JSON)

  • Regroupement de la structure de saisie
  • Définition de l'assignation des paramètres

Champs importants :

group
  • Structuration dans la boîte de dialogue RFEM
 
  • servent de titre
 
  • dénomination libre
key
  • doit correspondre exactement au paramètre Excel
caption
  • Nom affiché
 
  • dénomination libre
symbol, unit
  • Définition de la représentation
type
  • Type de données à utiliser dans les scripts (p. ex. float, int, bool, ...)

D'autres groupes peuvent être ajoutés librement.

3. Données des paramètres (fichier Excel)

  • Les données définissent la structure des paramètres.
  • Chaque ligne doit être nommée de manière unique.
  • Les colonnes sont librement définissables, mais doivent être utilisées de manière cohérente.

4. Visualisation (fichier RFEM 6)

  • Permet la visualisation détaillée dans la fenêtre de travail RFEM
  • Le composant peut également être créé sans fichier de visualisation

Scripts Python (Script après le calcul)

Le Script après le calcul contrôle les vérifications du composant.

Important

Lors de l'utilisation de paramètres dans le script Python, il faut veiller à ce que les keys soient toujours indiquées en minuscules et au format "snake_case". L'orthographe des keys doit correspondre à l'assignation des paramètres utilisée dans le fichier JSON et le fichier Excel.

Fonction : define_design_checks

  • Définition des catégories de vérification
  • Type = Affichage dans RFEM (libre choix)
  • Description, catégorie et sous-catégorie librement définissables

Fonction : evaluate_single_check

  • Transmission des ratios de vérification à RFEM

Fonction : setup_component_series_data()

  • Exécution de la vérification
  • Lecture des paramètres via properties_parameters
  • La clé doit être identique à JSON et Excel
  • Type cohérent requis entre la définition et l'évaluation

Enregistrer et réutiliser le composant dans le Centre Dlubal

Vous pouvez enregistrer un composant personnalisé comme modèle afin de l'utiliser également dans d'autres projets.

Procédez comme suit :

  1. Dans la boîte de dialogue Séries de composants, cliquez en bas sur le bouton Sauvegarde .
  2. La fenêtre 'Enregistrer la série de composants' apparaît avec le dossier d'enregistrement proposé Documents → Dlubal Software → Component Series.
  3. Définissez un nom de fichier, puis validez avec le bouton Enregistrer.

Les composants personnalisés sont ajoutés dans le Centre Dlubal sous la catégorie Séries de composants. Sous l'entrée OwnerPersonnalisé, vous pouvez y sélectionner le composant approprié et l'assigner à une barre.

Vous pouvez également utiliser le bouton Lire le fichier en bas de la boîte de dialogue Séries de composants pour lire le composant à partir d'un fichier.

Chapitre parent

Base de connaissances