eDocuments-Schema
Création d'un eDocuments-Schema
Pour créer un nouveau eDocuments-Schema dans Business Central, procédez comme suit :
- Ouvrez Microsoft Dynamics 365 Business Central.
- Cliquez sur l'icône de recherche (loupe) dans le Centre de rôles.
- Saisissez „eDocuments-Schema“ dans le champ de recherche.
- Sélectionnez l'action Nouveau.
- Un eDocuments-Schema vide sera créé.
- Sélectionnez le type de schéma. Choisissez XML pour une sortie XML ou JSON pour une sortie JSON.
- 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 les lignes de mise à jour du 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 maintenir la correspondance des valeurs existantes inchangée, tout en mettant à jour uniquement la structure des lignes de schéma.
Type de schéma
Le champ Type de schéma indique si le schéma est utilisé pour une sortie XML ou JSON. Le champ est disponible dans la liste des schémas et sur la page du schéma.
Lorsque le type de schéma est modifié, la page se met automatiquement à jour. 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 Use UBL est masquée. Les champs du profil d'envoi liés à JSON sont préparés avec les valeurs par défaut requises pour la sortie B2Brouter. Le Transport Type Code est défini sur peppol et le Document Type Code sur xml.ubl.invoice.bis3. Ces champs ne peuvent pas être modifiés en mode JSON.
Création de lignes de schéma par défaut
L'action de création de nœuds de schéma par défaut prend en charge les schémas XML et JSON.
- Pour les schémas XML, l'action crée les lignes de schéma XML par défaut.
- Pour les schémas JSON, l'action crée les lignes de schéma JSON par défaut.
Si des lignes de schéma JSON par défaut existent déjà, 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 restent inchangées.
Configuration des lignes de schéma JSON
Les lignes de schéma JSON contiennent le champ JSON Value Type. Ce champ détermine la manière dont la valeur est écrite dans la sortie JSON :
| JSON Value Type | 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, la sortie utilise 0. |
| Boolean | La valeur est écrite sous la forme true ou false sans guillemets. Les valeurs telles que true, 1, yes et ja sont traitées comme true. |
Les schémas JSON peuvent contenir des objets imbriqués et des tableaux. Cela est utilisé pour des structures telles que les lignes de facture, les taxes, les frais et remises, les échéances de paiement, les références de facture, les propriétés d'article supplémentaires, les contacts, les comptes bancaires, les tiers et les références de reçu.
Pour les structures de tableau, eDocuments peut répéter les entrées du tableau selon le 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 facultatifs sont ignorés lorsqu'aucune valeur ou valeur par défaut n'est disponible et que l'occurrence minimale est définie sur 0.
Informations sur les champs JSON
Pour les lignes de schéma JSON, l'action Information affiche une description du champ JSON sélectionné sur la base de la spécification de l'API B2Brouter. Cela aide les administrateurs à comprendre le champ qu'ils configurent sans quitter la page du schéma.
Recherche de données de schéma
La recherche de données de schéma est une fonction 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 de 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 :
- Ouvrez l'entrée « Simova Apps eDocuments - Schema » via la recherche.
- Sélectionnez le schéma souhaité dans la liste.
- La recherche de données de schéma se trouve dans la section « Général ».
- Veuillez noter que la recherche est sensible à la casse.
- Saisissez le terme de recherche souhaité et appuyez sur Entrée pour démarrer la recherche.
- 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 fait la distinction entre les majuscules et les minuscules.
- La recherche est limitée aux données 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 résultats 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 vous suffit de supprimer le texte saisi dans le champ de recherche. Le système mettra alors automatiquement à jour l'affichage et affichera toutes les entrées disponibles sans restriction.