« MoreDesc » : différence entre les versions

De Documentations Patas-monkey
Aller à la navigation Aller à la recherche
← Modification précédenteModification suivante →
Liam (discussion | contributions)
Bureaucrates
3 648 modifications
Liam (discussion | contributions)
Bureaucrates
3 648 modifications
Ligne 179 : Ligne 179 :
== MoreNotes ==
== MoreNotes ==


=== Présentation ===
{| class="wikitable" style="width: 100%; border-collapse: collapse;"
 
|-
! colspan="2" style="text-align: center; background-color: #f0f0f0; padding: 10px;" | Présentation et Accès au module MoreNotes
|-
| style="width: 50%; padding: 10px; vertical-align: top;" |
Le module '''MoreNotes''' permet de gérer une '''bibliothèque de notes prédéfinies'''.  
Le module '''MoreNotes''' permet de gérer une '''bibliothèque de notes prédéfinies'''.  
 
Ces notes peuvent être rapidement insérées dans les documents (devis, factures, etc.) pour gagner du temps.
Ces notes s'insèrent rapidement dans les documents (devis, factures, etc.) pour gagner du temps.
 
=== Accès au module MoreNotes ===
'''Accès au module :'''
 
* '''Outils Patas-M > MoreNotes'''
Vous accédez à MoreNotes via :
 
* '''Accueil > Espace MoreDesc''' > Section '''MoreNotes'''
* '''Produits > MoreNotes'''
* '''Produits > MoreNotes'''
 
L'interface propose :
| style="width: 50%; padding: 10px; vertical-align: top;" |
'''Actions principales :'''
* Nouvelle MoreNotes
* Nouvelle MoreNotes
* Liste des MoreNotes
* Liste des MoreNotes
* Import XML
* Import XML
 
==== Nouvelle MoreNotes ====
'''Utilisation :'''
 
* Créer/modifier/supprimer notes
=== Créer une note prédéfinie ===
* Insérer dans documents
 
* Importer en masse (XML)
# Cliquez sur '''Nouvelle MoreNotes''' ou '''+ Ajouter une note'''
# Remplissez les champs :
|-
 
! colspan="2" style="text-align: center; background-color: #e8e8e8; padding: 10px;" | Créer une Nouvelle Note
; Titre : Nom court et mémorable (ex: "Délai de livraison 48h")
|-
; Catégorie : Groupez vos notes par thème (ex: "Livraison", "Paiement", "Légal")
| style="width: 50%; padding: 10px; vertical-align: top;" |
; Contenu : Le texte complet de la note
; État : Marquez comme Actif ou Brouillon
{| style="width: 100%; border: none; margin: 0;"
 
|-
=== Utiliser HTML ===
| style="width: 100%; padding: 10px; vertical-align: top;" |
 
Si '''Description en HTML''' est activé en configuration, vous pouvez saisir du contenu HTML formaté.
''' Formulaire de création '''
 
* '''Titre''' : Nom court (ex: "Délai 48h")
=== Enregistrement ===
* '''Catégorie''' : Thème (ex: "Livraison", "Paiement")
 
* '''Contenu''' : Texte complet
Cliquez sur '''Enregistrer''' pour créer la note. Elle devient aussitôt disponible pour utilisation.
* '''État''' : Actif ou Brouillon
 
==== Liste des MoreNotes ====
''' HTML '''
 
Si activé en config, saisissez du HTML formaté.
=== Affichage de la liste ===
 
''' Enregistrement '''
La page '''Liste des MoreNotes''' affiche toutes vos notes prédéfinies dans un tableau :
Cliquez '''Enregistrer''' - la note est disponible immédiatement.
 
; Titre : Nom de la note
|}
; Catégorie : Regroupement thématique
; État : Actif ou brouillon
| style="width: 50%; padding: 10px; text-align: center;" |
; Actions : Modifier, Supprimer, Dupliquer
[[Fichier:PlaceholderNouvelleNote.png|280px|Formulaire Nouvelle Note]]
 
=== Rechercher une note ===
|-
 
! colspan="2" style="text-align: center; background-color: #e8e8e8; padding: 10px;" | Liste des Notes - Colonnes et Actions
Utilisez le champ '''Recherche''' pour trouver une note par titre ou catégorie.
|-
 
| style="width: 50%; padding: 10px; vertical-align: top;" |
=== Modifier une note ===
 
{| style="width: 100%; border: none; margin: 0;"
# Cliquez sur '''Modifier''' (icône crayon)
|-
# Apportez vos changements
| style="width: 100%; padding: 10px; vertical-align: top;" |
# Enregistrez
 
''' Colonnes du tableau '''
=== Dupliquer une note ===
* '''Titre''' : Nom de la note
 
* '''Catégorie''' : Thème
# Cliquez sur '''Dupliquer'''
* '''État''' : Actif/Brouillon
# Une copie est créée avec le même contenu
* '''Actions''' : Modifier/Supprimer/Dupliquer
# Vous pouvez immédiatement l'éditer pour l'adapter
 
''' Fonctionnalités '''
=== Supprimer une note ===
* Recherche (par titre/catégorie)
 
* Modifier : ✎ Crayon
# Cliquez sur '''Supprimer''' (icône poubelle)
* Dupliquer : Copier pour adapter
# Confirmez la suppression
* Supprimer : 🗑 Poubelle
# La note est définitivement supprimée
 
|}
=== Utiliser une note dans un document ===
 
| style="width: 50%; padding: 10px; text-align: center;" |
Lors de la création ou édition d'un document (Devis, Facture, etc.) :
[[Fichier:PlaceholderListeNotes.png|280px|Liste des MoreNotes]]
 
# Allez dans la section '''Notes''' du document
|-
# Cliquez sur '''Notes prédéfinies''' ou '''MoreNotes'''
! colspan="2" style="text-align: center; background-color: #e8e8e8; padding: 10px;" | Utiliser une Note dans un Document
# Sélectionnez la note que vous souhaitez insérer
|-
# Cliquez sur '''Insérer'''
| style="width: 50%; padding: 10px; vertical-align: top;" |
# La note s'ajoute à votre document
# Vous pouvez la modifier directement si nécessaire
{| style="width: 100%; border: none; margin: 0;"
 
|-
==== Import XML ====
| style="width: 100%; padding: 10px; vertical-align: top;" |
 
=== Fonctionnalité d'import ===
''' Insérer une note prédéfinie '''
 
# Créez/Éditez un document (Devis, Facture, etc.)
L'option '''Import XML''' permet de '''charger en masse plusieurs notes prédéfinies''' depuis un fichier XML.
# Allez à la section '''Notes'''
 
# Cliquez '''Notes prédéfinies''' ou '''MoreNotes'''
Cette fonctionnalité est utile pour :
# Sélectionnez la note
* Migrer des notes depuis un autre système
# Cliquez '''Insérer'''
* Initialiser une nouvelle installation avec des notes standard
# Modifiez directement si besoin
* Sauvegarder et restaurer votre bibliothèque de notes
 
|}
=== Format du fichier XML ===
 
| style="width: 50%; padding: 10px; text-align: center;" |
Le fichier XML doit respecter la structure suivante :
[[Fichier:PlaceholderInserirNote.png|280px|Insertion Note dans Document]]
 
|-
! colspan="2" style="text-align: center; background-color: #e8e8e8; padding: 10px;" | Import XML - Charger des Notes en Masse
|-
| colspan="2" style="padding: 10px; vertical-align: top;" |
{| style="width: 100%; border: none; margin: 0;"
|-
| style="width: 50%; padding: 10px; vertical-align: top;" |
''' Lancer l'import '''
# Cliquez '''Import XML'''
# '''Sélectionner un fichier''' (format XML)
# Cliquez '''Importer'''
# Confirmez le nombre importé
''' Utilisations '''
* Migrer depuis autre système
* Initialiser avec notes standard
* Sauvegarder/Restaurer bibliothèque
| style="width: 50%; padding: 10px; vertical-align: top;" |
''' Format XML requis '''
<nowiki>
<nowiki>
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<morenotes>
<morenotes>
   <note>
   <note>
     <titre>Titre de la note</titre>
     <titre>Titre</titre>
     <categorie>Catégorie</categorie>
     <categorie>Thème</categorie>
     <contenu>Contenu complet de la note</contenu>
     <contenu>Texte complet</contenu>
    <etat>1</etat>
  </note>
  <note>
    <titre>Deuxième note</titre>
    <categorie>Catégorie 2</categorie>
    <contenu>Contenu de la deuxième note</contenu>
     <etat>1</etat>
     <etat>1</etat>
   </note>
   </note>
</morenotes>
</morenotes>
</nowiki>
</nowiki>
 
; titre : Nom de la note (obligatoire)
''' Notes '''
; categorie : Catégorie de la note (optionnel)
* titre & contenu : obligatoires
; contenu : Texte complet de la note (obligatoire)
* categorie & etat : optionnels
; etat : 1 pour Actif, 0 pour Brouillon
* etat : 1=Actif, 0=Brouillon
 
* Doublons : pas remplacés
=== Lancer l'import ===
 
|}
# Cliquez sur '''Import XML'''
# Cliquez sur '''Sélectionner un fichier'''
|}
# Choisissez votre fichier XML
# Cliquez sur '''Importer'''
# Un message confirme le nombre de notes importées
 
=== Résultat de l'import ===
 
* Les notes sont créées avec le statut spécifié dans le XML
* Les notes existantes avec le même titre ne sont '''pas''' remplacées (pour éviter les pertes)
* Vous pouvez vérifier les notes importées dans la '''Liste des MoreNotes'''
 
=== Export et sauvegarde ===
 
Bien que non explicitement documenté, vous pouvez générer un export XML de vos notes prédéfinies pour sauvegarder votre bibliothèque.
 
Contactez votre administrateur si vous avez besoin d'une sauvegarde complète.


= Bonnes pratiques =
= Bonnes pratiques =

Version du 12 juin 2026 à 18:10

MoreDesc n' Notes ajoute la possibilité de compléter ou remplacer la description d'un produit selon un tiers spécifique et un ensemble de documents (devis, commande, facture client et fournisseurs). Le module permet aussi de rajouter rapidement des notes prédéfinies.

Sommaire

Ce guide couvre l'utilisation complète du module MoreDesc'n Notes pour Dolibarr. Vous y trouverez les instructions de configuration, d'utilisation et les bonnes pratiques.

Paramétrage

Accès à la configuration

Accès à la page de configuration

Pour accéder aux paramètres du module MoreDesc :

  1. Allez dans Administration > Modules/Applications > Modules installés
  2. Recherchez MoreDesc
  3. Cliquez sur l'icône Paramètres (ou icône engrenage)

Vous accédez à la page : Configuration du module moreDesc - moredescGeneralSetting

Cette page centralise tous les réglages du module.

Espace MoreDesc - Navigation

Page de configuration du module

Explications des paramètres

Description en HTML

  • Saisissable en HTML (wysiwyg) - Désactivé par défaut
  • Activez pour mise en forme (gras, italique, listes, etc.)

Timer sur les notes publiques

  • Affiche timestamp sur notes publiques - Désactivé par défaut
  • Tracer l'historique des modifications

Timer sur les notes privées

  • Affiche timestamp sur notes privées - Activé par défaut
  • Suivi des dates de création/modification

Désactiver le contrôle Patas-Monkey

  • N'vérifie pas la version en ligne - Désactivé par défaut
  • Utile pour mode offline

Enregistrement : Cliquez sur le bouton Enregistrer en bas de la page pour appliquer les modifications.

MoreDesc

Présentation et Accès au module MoreDesc

La section MoreDesc permet de gérer les descriptions personnalisées des produits.

Chaque description s'adapte selon :

  • Le tiers (client/fournisseur)
  • Le type de document (devis, commande, facture, etc.)

Accès au module :

  • Outils Patas-M > MoreDesc
  • Produits > MoreDesc (fiche)

Actions principales :

  • Liste des Descriptions
  • Nouvelle Description

Depuis fiche produit :

  • Onglet Moredesc
  • Ajouter directement au produit

Onglet MoreDesc sur fiche produit

Liste des Descriptions - Colonnes et Actions

Colonnes du tableau

  • Libellé : Nom du produit
  • Tiers : Client/Fournisseur
  • Ajoute/Remplace : Mode d'application
  • État : Actif/Archivé

Filtrer la liste

  • Recherche (par produit/tiers)
  • Nombre d'résultats (20, 50, 100...)

Actions par description

  • ✎ Modifier : Éditer
  • 🗑 Supprimer : Supprimer
  • ⋯ Dupliquer : Copier
Créer une Nouvelle Description

Formulaire

  • Produit : Sélectionnez
  • Tiers : Client/Fournisseur (opt.)
  • Mode : Ajoute OU Remplace
  • Description : Texte/HTML
  • État : Actif ou Brouillon

Types de documents

  • Devis (Propal)
  • Commande client/fournisseur
  • Facture client/fournisseur
  • Documents génériques

Enregistrement Cliquez Enregistrer pour créer.

MoreDesc depuis Fiche Produit/Service

Voir les descriptions

  1. Allez dans Produits > Liste
  2. Sélectionnez un produit
  3. Cliquez onglet Moredesc

Ajouter depuis fiche

  1. Cliquez + Nouvelle description
  2. Remplissez le formulaire
  3. Enregistrez - directement attaché

Gestion directe

  • ✎ Modifier | 🗑 Supprimer

MoreNotes

Présentation et Accès au module MoreNotes

Le module MoreNotes permet de gérer une bibliothèque de notes prédéfinies.

Ces notes s'insèrent rapidement dans les documents (devis, factures, etc.) pour gagner du temps.

Accès au module :

  • Outils Patas-M > MoreNotes
  • Produits > MoreNotes

Actions principales :

  • Nouvelle MoreNotes
  • Liste des MoreNotes
  • Import XML

Utilisation :

  • Créer/modifier/supprimer notes
  • Insérer dans documents
  • Importer en masse (XML)
Créer une Nouvelle Note

Formulaire de création

  • Titre : Nom court (ex: "Délai 48h")
  • Catégorie : Thème (ex: "Livraison", "Paiement")
  • Contenu : Texte complet
  • État : Actif ou Brouillon

HTML Si activé en config, saisissez du HTML formaté.

Enregistrement Cliquez Enregistrer - la note est disponible immédiatement.

Formulaire Nouvelle Note

Liste des Notes - Colonnes et Actions

Colonnes du tableau

  • Titre : Nom de la note
  • Catégorie : Thème
  • État : Actif/Brouillon
  • Actions : Modifier/Supprimer/Dupliquer

Fonctionnalités

  • Recherche (par titre/catégorie)
  • Modifier : ✎ Crayon
  • Dupliquer : Copier pour adapter
  • Supprimer : 🗑 Poubelle

Liste des MoreNotes

Utiliser une Note dans un Document

Insérer une note prédéfinie

  1. Créez/Éditez un document (Devis, Facture, etc.)
  2. Allez à la section Notes
  3. Cliquez Notes prédéfinies ou MoreNotes
  4. Sélectionnez la note
  5. Cliquez Insérer
  6. Modifiez directement si besoin

Insertion Note dans Document

Import XML - Charger des Notes en Masse

Lancer l'import

  1. Cliquez Import XML
  2. Sélectionner un fichier (format XML)
  3. Cliquez Importer
  4. Confirmez le nombre importé

Utilisations

  • Migrer depuis autre système
  • Initialiser avec notes standard
  • Sauvegarder/Restaurer bibliothèque

Format XML requis <?xml version="1.0" encoding="UTF-8"?> <morenotes> <note> <titre>Titre</titre> <categorie>Thème</categorie> <contenu>Texte complet</contenu> <etat>1</etat> </note> </morenotes>

Notes

  • titre & contenu : obligatoires
  • categorie & etat : optionnels
  • etat : 1=Actif, 0=Brouillon
  • Doublons : pas remplacés

Bonnes pratiques

Descriptions personnalisées

  • Organiser par tiers : Créez des descriptions spécifiques pour vos clients/fournisseurs importants
  • Utiliser le mode "Ajoute" pour enrichir la description générale
  • Tester avant livraison : Générez un PDF pour vérifier l'affichage
  • Archiver les anciennes : Désactivez plutôt que supprimer pour historique

Notes prédéfinies

  • Utiliser des catégories cohérentes : "Livraison", "Paiement", "Légal", etc.
  • Garder les titres courts : Facilitent la recherche et la sélection
  • Mettre à jour régulièrement : Vérifiez que vos CGV et conditions sont à jour
  • Tester l'affichage : Vérifiez la mise en forme dans les documents générés

Dépannage

Les descriptions n'apparaissent pas dans mes documents

  • Vérifiez que la description est Actif (pas en Brouillon)
  • Vérifiez que le Tiers correspond (ou laissez vide pour tous)
  • Vérifiez le Mode : Ajoute/Remplace selon votre attente
  • Régénérez le PDF du document

L'éditeur HTML ne s'affiche pas

  • Allez dans Administration > Paramètres > Configuration MoreDesc
  • Activez Description en HTML
  • Enregistrez

Les notes n'apparaissent pas dans la liste

  • Vérifiez le filtre de recherche (peut masquer les résultats)
  • Vérifiez que la note est Actif et non Brouillon
  • Augmentez le nombre de résultats affichés

Problème d'import XML

  • Vérifiez l'encodage du fichier (UTF-8)
  • Validez la syntaxe XML (pas d'accents mal échappés)
  • Vérifiez que les champs obligatoires (titre, contenu) sont présents
  • Consultez les logs de Dolibarr pour les erreurs détaillées

Contact et support

Pour toute question ou problème :

  • Consultez la section À propos du module
  • Contactez votre administrateur Dolibarr
  • Vérifiez les logs système : Administration > Outils > Journaux
Récupérée de « https://wiki.patas-monkey.com/index.php?title=MoreDesc&oldid=8880 »