Markdown Vditor

Présentation

Dans NocoBase, Markdown Vditor (Markdown Vditor) permet de modifier du contenu Markdown avec l’éditeur Vditor.

Markdown Vditor convient aux contenus nécessitant une expérience d’édition Markdown plus complète, comme le corps des commentaires, le contenu d’une base de connaissances ou la présentation d’une solution.

Si vous avez seulement besoin d’un éditeur Markdown simple, vous pouvez choisir Markdown. Si vous souhaitez une expérience de texte enrichi WYSIWYG, choisissez le texte enrichi.

Cas d’utilisation

Markdown Vditor convient aux scénarios métier suivants :

  • Contenu des commentaires et des discussions
  • Contenu d’une base de connaissances et présentation d’une solution
  • Textes longs avec mise en forme Markdown
  • Contenus nécessitant des fonctions de prévisualisation et d’édition

Création et configuration

Sur la page « Configure fields » de la table de données, cliquez sur « Add field », puis sélectionnez « Markdown Vditor » pour créer un champ Markdown Vditor.

20240512180647

ConfigurationDescription
Field interfaceType d’interface du champ. Markdown Vditor correspond à vditor et détermine la manière dont les données sont saisies et affichées dans la page.
Field display nameNom affiché du champ dans l’interface, par exemple « Contenu du commentaire », « Contenu de la base de connaissances » ou « Présentation de la solution ». Il est recommandé d’utiliser un nom directement compréhensible par les utilisateurs métier.
Field nameNom d’identification du champ, utilisé pour les références internes dans l’API, les champs de relation, les autorisations, les workflows, etc. Il n’est généralement plus modifié après la création, accepte uniquement les lettres, les chiffres et les traits de soulignement, et doit commencer par une lettre.
Field typeType du champ dans la couche de données. Les champs Markdown Vditor utilisent généralement text pour enregistrer le contenu.
Default valueValeur par défaut. Lors de la création d’un enregistrement, cette valeur peut être automatiquement renseignée si l’utilisateur n’a rien saisi.
Validation rulesRègles de validation. Elles permettent de limiter la longueur ou de rendre le champ obligatoire.
DescriptionDescription du champ. Elle peut préciser la signification du champ, les consignes de saisie, la source des données ou la personne responsable de la maintenance.
Attention

Le nom du champ sera utilisé par les blocs de page, les autorisations, les workflows et l’API. Vérifiez son nom avant la création afin d’éviter des coûts de configuration supplémentaires en cas de modification ultérieure.

Caractéristiques du champ

Le comportement par défaut du champ Markdown Vditor est le suivant :

CaractéristiqueDescription
Default Field interfacevditor.
Default Field typetext.
Field type disponibletext.
Composant de pageEn mode édition, l’éditeur MarkdownVditor est utilisé.
FiltrageLes filtres de type texte sont pris en charge, notamment contient, est vide et n’est pas vide.
TriGénéralement non utilisé pour le tri.
ValidationLes validations de texte telles que la longueur et le caractère obligatoire sont prises en charge.

Modification de la configuration

Après la création, cliquez sur « Edit » à droite du champ pour modifier la configuration du champ Markdown Vditor. La modification d’un champ sert principalement à ajuster son affichage et son utilisation dans NocoBase, par exemple en modifiant son nom d’affichage, sa description, sa valeur par défaut, ses règles de validation ou sa configuration spécifique.

Si le champ provient d’une table déjà synchronisée dans la base de données principale, sa modification consiste généralement à effectuer une mise en correspondance des champs : le champ de la base de données est associé à un Field type et à une Field interface de NocoBase.

ConfigurationModifiableDescription
Field display nameOuiModifie le nom affiché du champ dans l’interface sans modifier son nom d’identification.
Field nameNonLe nom d’identification du champ ne peut généralement pas être modifié dans le formulaire d’édition après sa création.
Field interfaceSelon les conditionsLes champs de la base de données principale ou les champs synchronisés peuvent être ajustés lors de la mise en correspondance. Cette modification affecte la manière dont les données sont saisies, affichées et validées sur la page.
Field typeSelon les conditionsLes champs de la base de données principale ou les champs synchronisés peuvent être ajustés lors de la mise en correspondance. Avant toute modification, vérifiez que les données existantes peuvent être utilisées avec le nouveau type.
Default valueOuiModifie la valeur par défaut des nouveaux enregistrements.
Validation rulesOuiModifie les règles de validation du champ.
DescriptionOuiComplète la signification du champ, les consignes de saisie, la source des données ou la personne responsable de la maintenance.
Attention

Changer le Field type ou la Field interface ne revient pas simplement à modifier un nom d’affichage. Cela affecte le mode de stockage du champ, le composant de saisie, les règles de validation, les conditions de filtrage et la manière dont les variables sont utilisées dans les workflows. Si le volume de données existantes est important, vérifiez d’abord que leur format est compatible.

Supprimer un champ

Cliquez sur « Delete » à droite du champ pour supprimer le champ Markdown Vditor. Dans la base de données principale, vous pouvez également sélectionner plusieurs champs et les supprimer en bloc.

Lors de la suppression d’un champ Markdown Vditor créé dans la base de données principale, la colonne réelle correspondante ainsi que les données qu’elle contient sont généralement supprimées de la base de données. Lorsqu’un champ issu d’une synchronisation avec une base de données ou d’une source de données externe est supprimé, l’étendue des effets dépend de la source de données et de l’origine du champ concernées.

Avertissement

La suppression d’un champ peut affecter les blocs de page, les formulaires, les filtres, les autorisations, les workflows, l’API, les importations et exportations, ainsi que les données existantes. Avant de le supprimer, vérifiez qu’il n’est plus utilisé par une configuration métier.

Utilisation dans la configuration des pages

Les champs Markdown Vditor conviennent aux contenus et aux commentaires nécessitant une expérience d’édition. 20260709230930

ScénarioUtilisation
Bloc de formulaireUtiliser Vditor pour modifier du contenu Markdown.
Bloc de détailsAfficher le contenu Markdown rendu.
Bloc de commentairesEnregistrer le contenu du corps d’un commentaire.
WorkflowUtiliser le corps du contenu pour générer des notifications ou des documents.

Liens associés

  • Champs — Découvrir le rôle, la classification et la logique de mise en correspondance des champs
  • Table standard — Créer et gérer des champs dans une table standard
  • Markdown — Enregistrer du contenu Markdown
  • Texte enrichi — Enregistrer du contenu en texte enrichi