Aller au contenu

eDocuments-Schema

Création d'un eDocuments-Schema

Pour créer un nouveau eDocuments-Schema dans Business Central, procédez comme suit :

  1. Ouvrez Microsoft Dynamics 365 Business Central.
  2. Cliquez sur l'icône de recherche (loupe) dans le Centre de rôles.
  3. Saisissez „eDocuments-Schema“ dans le champ de recherche.
  4. Sélectionnez l'action Nouveau.
  5. Un eDocuments-Schema vide sera créé.
  6. Sélectionnez le type de schéma. Choisissez XML pour une sortie XML ou JSON pour une sortie JSON.
  7. Vous pouvez maintenant configurer le schéma selon vos besoins.

Info

Des schémas prédéfinis sont également disponibles et peuvent être importés via l'Assistant de configuration de l'envoi de documents.

Mise à jour des lignes de schéma

Tout d'abord, de nouveaux types de données sont définis. Ces nouveaux types de données peuvent ensuite être intégrés dans le schéma existant via la mise à jour des lignes de schéma. Pendant ce processus, les lignes de schéma existantes sont déplacées pour faire de la place aux nouvelles lignes ajoutées. Cela permet de conserver la correspondance des valeurs existantes tout en mettant à jour uniquement la structure des lignes de schéma.

Type de schéma

Le champ Type de schéma détermine si le schéma est utilisé pour une sortie XML ou JSON. Ce champ est disponible dans la liste des schémas et sur la page de schéma.

Lorsque le type de schéma est modifié, la page se met à jour automatiquement. Les zones spécifiques à XML sont masquées pour les schémas JSON, tandis que les champs et actions spécifiques à JSON deviennent disponibles.

Pour les schémas JSON, la zone Utiliser UBL est masquée. Les champs liés à JSON dans le profil d'envoi sont préremplis avec les valeurs par défaut requises pour la sortie B2Brouter. Le Code de type de transport est défini sur peppol et le Code de type de document sur xml.ubl.invoice.bis3. Ces champs ne peuvent pas être modifiés en mode JSON.

Créer des lignes de schéma standard

L'action de création de nœuds de schéma standard prend en charge les schémas XML et JSON.

  • Pour les schémas XML, l'action crée les lignes standard pour le schéma XML.
  • Pour les schémas JSON, l'action crée les lignes standard pour le schéma JSON.

Si des lignes standard existent déjà pour un schéma JSON, le système peut demander si les lignes existantes doivent être supprimées et recréées. Si vous refusez cette confirmation, les lignes de schéma existantes resteront inchangées.

Configurer les lignes de schéma JSON

Les lignes de schéma JSON contiennent le champ Type de valeur JSON. Ce champ contrôle comment la valeur est écrite dans la sortie JSON :

Type de valeur JSON Comportement dans la sortie JSON
String La valeur est écrite entre guillemets.
Number La valeur est écrite sans guillemets. Si la valeur ne peut pas être lue comme un nombre, 0 est renvoyé.
Boolean La valeur est écrite comme true ou false sans guillemets. Des valeurs comme true, 1, yes et oui sont traitées comme true.

Les schémas JSON peuvent contenir des objets et des tableaux imbriqués. Cela est utilisé, par exemple, pour les lignes de factures, les taxes, les majorations et diminutions, les échéances de paiement, les références de factures, les propriétés supplémentaires des articles, les contacts, les comptes bancaires, les tiers et les références de documents.

Pour les structures de tableau, eDocuments peut répéter les entrées de tableau en fonction du mappage de données configuré. Si aucun mappage n'est configuré pour un tableau, une seule entrée de tableau est créée.

Les nœuds et propriétés JSON optionnels sont ignorés s'il n'y a pas de valeur ou de valeur par défaut et que le nombre minimum est défini sur 0.

Informations sur les champs JSON

Pour les lignes de schéma JSON, l'action Informations affiche une description du champ JSON sélectionné sur la base de la spécification de l'API B2Brouter. Cela permet aux administrateurs de comprendre directement sur la page de schéma quel champ ils configurent.

Recherche de données de schéma

La Recherche de données de schéma est une fonctionnalité au sein de l'eDocuments-Schema. Elle vise à faciliter considérablement la navigation et la recherche de données de schéma spécifiques. En particulier pour des schémas complexes ou volumineux, la recherche est une aide essentielle pour rechercher des entrées de manière ciblée et comprendre leur structure.

Grâce à l'utilisation de la recherche, il est possible de filtrer par le nom ou la valeur des données de schéma individuelles. Lorsqu'un résultat est trouvé, le système affiche également les éléments enfants associés (sous-catégories) pour mieux comprendre les données dans leur contexte structurel.

Utilisation de la recherche de données de schéma

Pour utiliser la recherche de données de schéma au sein d'un eDocuments-Schema, procédez comme suit :

  1. Ouvrez l'entrée « Simova Apps eDocuments - Schema » via la recherche.
  2. Sélectionnez le schéma souhaité dans la liste.
  3. La recherche de données de schéma se trouve dans la section « Général ».
  4. Veuillez noter que la recherche est sensible à la casse.
  5. Saisissez le terme de recherche souhaité et appuyez sur Entrée pour démarrer la recherche.
  6. Les résultats de la recherche affichent toutes les entrées correspondantes, y compris leurs éléments enfants. Vous pouvez ainsi rechercher de manière ciblée des structures de données spécifiques au sein du schéma.

Info

  • La fonction de recherche est sensible à la casse.
  • La recherche est limitée aux données au sein de l'eDocuments-Schema actuellement ouvert.
  • Si aucun résultat n'est affiché, veuillez vérifier l'orthographe ou l'étendue du terme de recherche saisi.

Fonctionnement

La recherche parcourt dynamiquement les données de schéma contenues dans l'eDocuments-Schema en fonction des termes saisis. Elle prend en compte à la fois les identifiants (par exemple, les noms d'éléments) et les valeurs attribuées – si elles existent.

Utilisation de la recherche

Voici comment utiliser la recherche de données de schéma :

Saisissez un terme de recherche. Tous les éléments correspondants, y compris leurs éléments enfants, seront alors affichés. Cela permet une analyse ciblée et facilite le traitement de la structure des données.

Réinitialiser la recherche

Pour réinitialiser la recherche et afficher à nouveau toutes les données de schéma, il suffit de supprimer le texte saisi dans le champ de recherche. Le système met alors automatiquement à jour l'affichage et montre toutes les entrées disponibles sans restriction.