> For the complete documentation index, see [llms.txt](https://help.socinformatique.fr/devisoc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.socinformatique.fr/devisoc/bibliotheques/creer-sa-bibliotheque-douvrages-a-partir-de-devisoc-7.0.md).

# Créer sa bibliothèque d'ouvrages à partir de DeviSOC 7.0

{% hint style="info" %}
Le volet ne prend en charge que les bibliothèques au format **DVSX**. Si vos bibliothèques sont encore au format DVS, vous devez les convertir avant de pouvoir les utiliser dans le volet (voir section dédiée ci-dessous).
{% endhint %}

## Configurer vos répertoires de bibliothèques

Plutôt que d'importer chaque bibliothèque manuellement, vous déclarez les répertoires dans lesquels DeviSOC doit rechercher automatiquement les fichiers DVSX.

{% stepper %}
{% step %}

## Ouvrez la configuration

Ouvrez la configuration via le bouton **Paramètres** du volet ou le menu dédié.
{% endstep %}

{% step %}

## Ajoutez un répertoire

Dans l'onglet **Source Directories**, cliquez sur **+** pour ajouter un répertoire (local ou réseau).
{% endstep %}

{% step %}

## Rafraîchissez les bibliothèques

À chaque démarrage ou clic sur **Rafraîchir**, DeviSOC parcourt ces répertoires et intègre automatiquement les fichiers DVSX détectés.

<figure><img src="/files/Z5JjK96xHO231lu4eRzH" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

L'onglet **Libraries** liste toutes les bibliothèques découvertes, regroupées par logiciel source (DeviSOC, Bati CCTP, BatiChiffrage, etc.). Un champ de recherche vous permet de filtrer rapidement.

<figure><img src="/files/bF9znoFAFA9JKcpD2uhD" alt=""><figcaption></figcaption></figure>

## Naviguer dans une bibliothèque

Le menu déroulant en haut du volet liste toutes les bibliothèques disponibles, classées en trois catégories : **Bibliothèques DeviSOC**, **Bibliothèques partenaires** et **Autres bibliothèques**.

Les bibliothèques partenaires et tierces sont signalées par la mention `[lecture seule]` : elles sont consultables mais non modifiables.

Un clic sur une bibliothèque la charge immédiatement dans le volet, sans recharger le projet. Son arborescence complète s'affiche (chapitres, sous-chapitres, lots, articles), dépliable et repliable à la demande.

<figure><img src="/files/BoKS3wmyp0gWl3Y49bnI" alt=""><figcaption></figcaption></figure>

## Consulter et modifier un article

Cliquez sur un article dans l'arborescence pour afficher son détail dans la partie basse du volet :

* **Onglet Description** : texte descriptif mis en forme, tel qu'il apparaîtra dans le projet. Pour les bibliothèques DVSX, le bouton crayon ✏️ ouvre un éditeur de texte complet (gras, italique, couleurs, puces…).
*

```
<figure><img src="/files/ViEoed7BuIefytVW5NxK" alt=""><figcaption></figcaption></figure>
```

```
<figure><img src="/files/X8NDqKOn0kctTMbToxlU" alt=""><figcaption></figcaption></figure>
```

* **Onglet Propriétés** : tableau des métadonnées de l'article. Les champs affichés en bleu sont éditables en ligne (Code, Titre, Statut, Unité, Prix d'achat, Prix de vente, TVA…). Les champs générés automatiquement (Identifiant, dates) ne sont pas modifiables.
*

```
<figure><img src="/files/Ie55cpMMVzLn0uTUhK5m" alt=""><figcaption></figcaption></figure>
```

Vous pouvez également modifier le **titre d'un article directement dans l'arborescence** par double-clic sur le nœud correspondant.

<figure><img src="/files/w08L53uFccbZiVMXKYVw" alt=""><figcaption></figcaption></figure>

Un **clic droit** sur n'importe quel nœud ouvre un menu contextuel proposant : Sélectionner, Copie simple, Copie poussante, Ajouter, Éditer, Supprimer. Ces actions sont réservées aux bibliothèques DVSX.

<figure><img src="/files/o40YbNrhGPzg22fspGON" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Toutes les modifications sont enregistrées automatiquement dans la base de données DVSX dès leur validation. Aucune action de sauvegarde manuelle n'est nécessaire.
{% endhint %}

## Transférer des articles vers un projet

Depuis le volet, vous pouvez intégrer des articles dans votre projet ouvert de deux façons :

* **Copie simple** : insère l'article à l'emplacement courant, de manière indépendante. Les modifications ultérieures de la bibliothèque n'affectent pas la copie dans le projet.

<figure><img src="/files/iZQSQQUxFDnQfVyQ6L6m" alt=""><figcaption></figcaption></figure>

* **Copie poussante ou F6** : transfère l'article et l'ensemble de ses éléments fils en une seule opération. **Cette copie est au moins 10 fois plus rapide** qu'avec l'ancien format DVS.

<figure><img src="/files/M1bSusqOfYNlWX9N7qKs" alt=""><figcaption></figcaption></figure>

À l'inverse, depuis un article de votre projet, vous pouvez demander au logiciel de retrouver automatiquement l'article source dans la bibliothèque, ou de **mettre à jour** l'article avec la version la plus récente de la bibliothèque.

<figure><img src="/files/3FIpPK1Lj6dfpZh224Sw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/URgU0ozXjRcKv9l6874b" alt=""><figcaption></figcaption></figure>

## Accès simultanés

Le format DVSX permet à plusieurs utilisateurs de travailler simultanément sur une même bibliothèque partagée. Un verrou léger est posé sur l'article en cours de modification ; les autres utilisateurs peuvent continuer à naviguer et éditer d'autres articles sans interruption. Un indicateur visuel signale les articles temporairement verrouillés.


---

# 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://help.socinformatique.fr/devisoc/bibliotheques/creer-sa-bibliotheque-douvrages-a-partir-de-devisoc-7.0.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.