112x
006212
28.07.2026

Composants définis par l’utilisateur

L’option Composants définis par l’utilisateur 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 Dlubal Center, 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 requis :

  • Abonnement Basic à l’API Dlubal
  • Création d’une clé API dans l’Extranet
  • Intégration la clé API dans RFEM

Créer une clé API dans l’Extranet

  1. Ouvrez l’Extranet
  2. Naviguez vers API & Cloud → API II → Mes clés API
  3. Sélectionnez Créer une nouvelle clé API
  4. Donnez un nom et générez la clé
  5. Sauvegardez

Intégrer la clé API dans RFEM

  1. Ouvrez RFEM
  2. Ouvrez le menu Affichage → Console
  3. Sélectionnez Python | Dlubal API | gRPC
  4. Sélectionnez le symbole de clé
  5. Saisissez la clé API (Nom + Clé)
  6. Confirmez

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

Astuce

Pour en savoir plus sur l’interface API, consultez cet article technique.

Créer un composant défini par l’utilisateur

Vous pouvez activer la saisie d’un composant défini par l’utilisateur comme suit :

  1. Ouvrez la boîte de dialogue Séries de composants.
  2. Cochez la case Défini par l’utilisateur.

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

Catégories (Métadonnées)

  • Type d’attribution (ex : attribution 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’attribution 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 catégories peuvent être ajoutées 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, veillez à ce que les clés soient toujours indiquées en minuscules et au format snake_case. L’orthographe des clés doit correspondre à l’attribution 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 Dlubal Center

Vous pouvez enregistrer un composant personnalisé comme modèle type 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 → Series de composants.
  3. Définissez un nom de fichier, puis validez avec le bouton Enregistrer.

Les composants définis par l’utilisateur sont ajoutés dans le Dlubal Center sous la catégorie Séries de composants. Sous l’entrée Propriétaire → Défini par l’utilisateur, 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 importer le composant à partir d’un fichier.

Chapitre parent

Base de connaissances