> For the complete documentation index, see [llms.txt](https://docs.dietrichs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dietrichs.com/dietrichs-intelligent-documentation/francais/le-systeme-de-variables/fichiers-de-parametres-modifiables/structure-des-fichiers-de-parametres-modifiables-edition-depuis-un-editeur-de-texte-generique.md).

# Structure des fichiers de paramètres modifiables, édition depuis un éditeur de texte générique

La modification des fichiers peut également avoir lieu en dehors du système de programme dans un éditeur de texte générique. Les modifications ne sont pas automatiquement chargées dans la gestion de projet ou la construction. Par conséquent, les procédures suivantes doivent être respectées :

* Pour éditer et modifier le fichier, la fonction concernée dans la gestion de projet ou le bâtiment ne doit pas être utilisée.
* Lorsque la fonction qui utilise le fichier de configuration éditable est appelée, le fichier est également rechargé.
* Les fonctions de gestion standard des paramètres ne doivent être utilisées que si le fichier de paramètres n'est pas ouvert dans un éditeur de texte.\
  Remarque : Malheureusement, il n'est pas toujours possible de déterminer qu'un fichier est actuellement ouvert. Par exemple, Notepad + + ouvre automatiquement une seule copie du fichier.

{% hint style="warning" %}
Les fausses entrées ne peuvent pas être interceptées par le programme car l’édition est libre. Aussi, le fichier peut facilement devenir inutilisable. Par conséquent, seuls les utilisateurs avertis doivent éditer ces fichiers avec un éditeur de texte générique.
{% endhint %}

## Structure et contenu des fichiers de paramètres modifiables

Dans les fichiers de paramètres modifiables, on retrouve des structures et des zones qui peuvent être modifiées dans l’éditeur ainsi que celles qui n’apparaissent pas. Dans beaucoup de ces fichiers, les entrées et commentaires appropriés contiennent des informations sur l'objectif et le contenu du fichier.

Si une référence est donnée en tant que texte sous la forme #123 (Dièze suivi d’un numéro), il s'agit d’une référence au numéro de ligne présente dans le fichier de traduction **Editdsi1.frg**.

Les fichiers sont divisés en zones de données, ce que l'on appelle des sections. Chaque section commence par une entrée entre crochets et se termine par la même entrée, complétée par le mot <mark style="background-color:$primary;">**ENDSEC**</mark> :

<details>

<summary>Exemple</summary>

**`[`***`NOM DE`* *`SECTION`***`]`**

`...`

**`[`***`NOM DE`* *`SECTION`* **`ENDSEC]`**

</details>

Dans la zone de données (section), chaque ligne est constituée d’un Identifiant – le signe d’égalité - valeur. Après cela, un commentaire peut suivre, séparé par une double barre oblique.

<details>

<summary>Exemple</summary>

*`Identifiant`*` ``=`` `*`valeur`*

*`Identifiant`*` ``=`` `*`valeur`***`//`***`Commentaire`*

</details>

## Version de la structure du fichier, \[VERSION]

{% hint style="danger" %}
Possibilités de modification : Ne pas modifier !
{% endhint %}

Sous la section <mark style="background-color:$primary;">**VERSION**</mark>, on retrouve l’identifiant correspondant à la version structurelle du fichier. Le programme a besoin de ces informations afin de traiter le contenu du fichier correctement. Il ne s’agit en aucun cas de la version des données. Cette section ne doit donc pas être modifiée !

<details>

<summary>Exemple</summary>

**`[VERSION]`**

**`Version=1.1`**

**`[VERSION ENDSEC]`**

</details>

## Groupes, \[CATEGORY]

{% hint style="warning" %}
&#x20;Possibilités de modification : Modifier de préférence avec *Gestion de configuration*.
{% endhint %}

La section <mark style="background-color:$primary;">**CATEGORY**</mark> contient les noms et l’ordre des groupes. L’identifiant se termine par un nombre correspondant à son ordre. Le nom du groupe est indiqué après le signe d’égalité :

<details>

<summary>Exemple</summary>

**`[CATEGORY]`**

**`CategoryName1=`***`groupe abc`*

**`CategoryName2=`***`groupe 123`*

**`[CATEGORY ENDSEC]`**

</details>

## Informations sur le fichier, \[FILE INFO]

&#x20;La section <mark style="background-color:$primary;">**FILE INFO**</mark> contient des informations sur le fichier et les données qu’il définit. Voici des informations précieuses sur les données et les règles à appliquer dans le fichier.

Si une référence de texte est donnée sous la forme #123 (Dièze suivi d’un numéro), il s'agit d’une référence au numéro de ligne présente dans le fichier de traduction **Editdsi1.frg**. Les textes réels des FRG (fichiers de traduction) sont affichés dans la boîte de dialogue utilisée pour éditer les fichiers de paramètres modifiables.

Les identifiants <mark style="background-color:$info;">**FileDescription\_1**</mark> à <mark style="background-color:$info;">**FileDescription\_5**</mark> peuvent être attribués (Soit 5 lignes maximum).

<details>

<summary>Exemple</summary>

**`[FILE INFO]`**

**`FileDescription_1=`***`Description du fichier`*

**`FileDescription_2=`***`Ligne 2 -`* *`max. 5 lignes`*

**`FileDescription_3=`***`#123`*

**`[FILE INFO ENDSEC]`**

</details>

## Informations sur les sections, \[SECTION INFORMATION]

{% hint style="warning" %}
Possibilités de modification : Les informations doivent être disponibles pour chaque section ! Observez les notes dans les entrées individuelles !
{% endhint %}

Tous les paramètres du fichier contiennent les mêmes sections. Les informations système sont les mêmes pour toutes ces sections, quel que soit leur réglage. Par conséquent, cette information est enregistrée dans cette section en amont. Les paramètres ne doivent pas nécessairement contenir toutes ces sections, mais ne peuvent contenir que des sections qui ont été définies ici.

La section <mark style="background-color:$primary;">**SECTION INFORMATION**</mark> contient toutes les sections pouvant être utilisées dans les paramètres. Pour chaque section, il y a des textes d'information, la SectionsType et la référence à une image d’aide :

<details>

<summary><mark style="background-color:$info;"><strong>Line1 .. Line5</strong></mark></summary>

Jusqu'à cinq lignes de texte d'explication sur le contenu de la section. Voici de précieux conseils pour l'édition du fichier. Si le texte est une référence sous la forme #123 (Dièze suivi d’un numéro), il s'agit alors d’une référence au numéro de ligne dans **Editdsi1.frg**. Les textes du frg (fichier de langue) sont affichés dans la boîte de dialogue pour l'édition des fichiers de paramètres modifiables.

</details>

<details>

<summary><mark style="background-color:$info;"><strong>SectionType</strong></mark></summary>

Il existe 3 types de section : FILTER, FREE, FIX

* <mark style="background-color:$success;">**FILTER**</mark> : Le mot de passe devant le signe égal décrit une sélection de conceptions (mur, plancher, versant de toit) ou une sélection de Réf. Produit.\
  Les descriptions de sélection suivantes sont possibles :\
  \&#xNAN;*ABC123* ABC123 est le nom complet\
  \&#xNAN;*ABC*\*  Le nom commence par ABC\
  \**ABC*  Le nom se termine par ABC\
  \**ABC*\* ABC est présent quelque part dans le nom.\
  N'importe quel nombre d'entrées peut être fait dans cette section. La fonction parente détermine si toutes les entrées applicables, uniquement la première ou la dernière est utilisée.
* <mark style="background-color:$success;">**FREE**</mark> : L’identifiant avant le signe égal peut être assigné librement. Par exemple, il peut s'agir d’une variable utilisateur.\
  N'importe quel nombre d'entrées peut être fait dans cette section.
* <mark style="background-color:$success;">**FIX**</mark> : Les identifiants avant le signe égal et leur nombre sont corrigés. Dans ces sections, les identifiants possibles sont déjà entrés. Aucun autre supplément ne peut être ajouté. Les identifiants qui ne sont pas utilisés doivent simplement s'arrêter sans valeur assignée.

</details>

<details>

<summary><mark style="background-color:$info;"><strong>ReferenceImagePath</strong></mark></summary>

Référence à une image d’aide. Celle-ci s'affiche dans la boîte de dialogue pour éditer les fichiers de paramètres modifiables.

</details>

&#x20;

<details>

<summary>Exemple</summary>

**`[SECTION INFORMATION]`**

**`[`*****`SECTION A`*****`]`**

**`Line1=`**`Texte pour la section A`

**`Line2=`**`max. 5 lines`

**`Line3=`**`#123`

**`SectionType=FILTER`**

**`ReferenceImagePath=`**`%DHPABB%\GWE___04.bmp`

**`[`*****`SECTION A`*****` ``ENDSEC]`**

**`[`*****`SECTION B`*****`]`**

**`..`**

**`[`*****`SECTION B`*****` ``ENDSEC]`**

**`..`**

**`[SECTION INFORMATION ENDSEC]`**

</details>

## Paramètres, \[DATASET EDITDSI]

&#x20;Les paramètres réels sont définis dans les sections <mark style="background-color:$primary;">**DATASET EDITDSI**</mark>.

* Une telle section est créée pour chaque paramètre. Le nom de la section est toujours le même ; il n'y a donc aucune suite de numéro ou de nom de paramètre.
* L'ordre d'affichage des paramètres correspond à l'ordre dans le fichier.

<details>

<summary>Exemple</summary>

**`[DATASET EDITDSI]`**

**`...`**

**`[DATASET EDITDSI ENDSEC]`**

**`[DATASET EDITDSI]`**

**`...`**

**`[DATASET EDITDSI ENDSEC]`**

</details>

Chacun des paramètres contient d'abord les informations sur le paramètre :

<details>

<summary><mark style="background-color:$info;"><strong>Name</strong></mark></summary>

Nom du paramètre avec lequel il apparaît dans sélection des paramètres. Les noms des paramètres d'un fichier doivent être uniques ; Aucun nom ne peut être attribué deux fois.

</details>

<details>

<summary><mark style="background-color:$info;"><strong>CategoryName</strong></mark></summary>

Groupe auquel le paramètre appartient. Les groupes possibles sont répertoriés dans la section <mark style="background-color:$primary;">**CATEGORY**</mark>.

</details>

<details>

<summary><mark style="background-color:$info;"><strong>ReferenceImagePath</strong></mark></summary>

référence à une image d‘aide. Celle-ci est affichée lors de la sélection des paramètres et peut être très utile pour l'opérateur.

L'affectation de l'image d’aide doit être effectuée dans les paramètres, car les références possibles dans les chemins sont entrées automatiquement ici.

</details>

Ceci est suivi des sections de données réelles. Celles-ci ont été définies précédemment dans la section <mark style="background-color:$primary;">**\[SECTION INFORMATION]**</mark>.

Le commentaire sur le paramètre est enregistré dans la dernière section de ce paramètre : <mark style="background-color:$primary;">**\[DATASET EDITDSI MULTILINE\_STRING]**</mark> Les identifiants <mark style="background-color:$info;">**Line1**</mark> à <mark style="background-color:$info;">**Line5**</mark> permettent de spécifier jusqu’à 5 lignes de texte de commentaire. Ceux-ci sont visibles lors de la *sélection du paramètre* et peuvent être très utiles à l’opérateur. Le commentaire peut être également renseigné depuis *le gestionnaire de paramètres*.

<details>

<summary>Exemple</summary>

**`[DATASET EDITDSI]`**

**`Name=`**` `*`Premier jeu de données`*

**`CategoryName=`***`groupe abc`*

**`ReferenceImagePath=`**`%DHPABB%\DietrichsLogo.png`

**`[`*****`SECTION A`*****`]`**

**`AW*=(WL<12.0[m])`*****`//`*** *`double barre oblique pour les commentaires`*

**`[`*****`SECTION A`*****` ``ENDSEC]`**

**`[`*****`SECTION B`*****`]`**

**`..`**

**`[`*****`SECTION B`*****` ``ENDSEC]`**

**`..`**

**`[DATASET EDITDSI MULTILINE_STRING]`**

**`Line1=`**` `*`Texte de réglage du premier jeu de données`*

**`Line2=`***`max. 5 lines`*

**`[DATASET EDITDSI MULTILINE_STRING ENDSEC]`**

**`[DATASET EDITDSI ENDSEC]`**

</details>

## Bloc de données

Dans la zone de données (section), chaque ligne est constituée d’un Identifiant – le signe d’égalité - valeur. Après cela, un commentaire peut suivre, séparé par une double barre oblique.

<details>

<summary>Exemple</summary>

*`Identifiant`*` ``=`` `*`valeur`*

*`Identifiant`*` ``=`` `*`valeur`***`//`***`Commentaire`*

</details>

Les possibilités et les significations des identifiants et des valeurs dépendent de la fonction qui traite ces données. Dans le fichier, il y a des notes correspondantes dans les sections <mark style="background-color:$primary;">**\[FILE INFO]**</mark> et <mark style="background-color:$primary;">**\[SECTION INFORMATION]**</mark>.

Le commentaire est souvent utilisé pour définir les identifiants prédéterminés. Pour les identifiants prédéterminés ou les variables utilisateur, le commentaire doit également être utilisé pour une description, car il facilite grandement l'édition ultérieure.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dietrichs.com/dietrichs-intelligent-documentation/francais/le-systeme-de-variables/fichiers-de-parametres-modifiables/structure-des-fichiers-de-parametres-modifiables-edition-depuis-un-editeur-de-texte-generique.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.