eDocuments-Schema

Aanmaken van een eDocuments-schema

Om een nieuw eDocuments-schema in Business Central aan te maken, volgt u deze stappen:

Open Microsoft Dynamics 365 Business Central.
Klik in het Rolcentrum op het zoekpictogram (vergrootglas).
Typ „eDocuments-schema“ in het zoekveld.
Kies de actie Nieuw.
Een leeg eDocuments-schema wordt aangemaakt.
Kies het Schema-type. Kies XML voor een XML-uitvoer of JSON voor een JSON-uitvoer.
U kunt het schema nu naar uw wensen configureren.

Info

Er zijn ook vooraf gedefinieerde schema's beschikbaar die via de Document Dispatch Configuratieassistent geïmporteerd kunnen worden.

Update Schema-regels

Eerst worden nieuwe Datatypes gedefinieerd. Deze nieuw aangemaakte Datatypes kunnen vervolgens via Update Schema-regels in het bestaande schema worden overgenomen. Tijdens dit proces worden de bestaande Schema-regels dienovereenkomstig verschoven om ruimte te maken voor de nieuw toegevoegde regels. Hierdoor blijft de bestaande waardetoewijzing onveranderd, terwijl alleen de structuur van de Schema-regels wordt bijgewerkt.

Schema-type

Het veld Schema-type bepaalt of het schema voor een XML- of JSON-uitvoer wordt gebruikt. Het veld is beschikbaar in de schema-lijst en op de schema-pagina.

Wanneer het Schema-type wordt gewijzigd, wordt de pagina automatisch bijgewerkt. XML-specifieke secties worden verborgen bij JSON-schema's, terwijl JSON-specifieke velden en acties beschikbaar worden.

Bij JSON-schema's wordt de sectie Use UBL verborgen. JSON-gerelateerde velden in het verzendprofiel worden vooraf ingevuld met de standaardwaarden die nodig zijn voor de B2Brouter-uitvoer. De Transport Type Code wordt ingesteld op peppol en de Document Type Code op xml.ubl.invoice.bis3. Deze velden kunnen in de JSON-modus niet worden bewerkt.

Standaard schema-regels aanmaken

De actie om standaard schema-knooppunten aan te maken ondersteunt XML- en JSON-schema's.

Bij XML-schema's maakt de actie de standaardregels voor het XML-schema aan.
Bij JSON-schema's maakt de actie de standaardregels voor het JSON-schema aan.

Als er al standaardregels voor een JSON-schema aanwezig zijn, kan het systeem vragen of de bestaande regels moeten worden verwijderd en opnieuw aangemaakt. Als u deze bevestiging weigert, blijven de bestaande Schema-regels onveranderd.

JSON-schema-regels configureren

JSON-schema-regels bevatten het veld JSON Value Type. Dit veld bepaalt hoe de waarde in de JSON-uitvoer wordt geschreven:

JSON Value Type	Gedrag in de JSON-uitvoer
String	De waarde wordt tussen aanhalingstekens geschreven.
Number	De waarde wordt zonder aanhalingstekens geschreven. Als de waarde niet als een getal kan worden gelezen, wordt 0 weergegeven.
Boolean	De waarde wordt als true of false zonder aanhalingstekens geschreven. Waarden zoals true, 1, yes en ja worden als true behandeld.

JSON-schema's kunnen geneste objecten en arrays bevatten. Dit wordt bijvoorbeeld gebruikt voor factuurregels, belastingen, kortingen en toeslagen, betalingsverplichtingen, factuurreferenties, extra artikelattributen, contacten, bankrekeningen, derden en documentreferenties.

Bij array-structuren kan eDocuments de array-invoeren herhalen op basis van de ingestelde datamapping. Als er geen mapping voor een array is ingesteld, wordt er één enkele array-invoer aangemaakt.

Optionele JSON-knooppunten en eigenschappen worden overgeslagen als er geen waarde of standaardwaarde aanwezig is en het minimum aantal op 0 is ingesteld.

JSON-veldinformatie

Bij JSON-schema-regels toont de actie Informatie een beschrijving van het geselecteerde JSON-veld op basis van de B2Brouter-API-specificatie. Hierdoor kunnen beheerders direct op de schema-pagina zien welk veld ze configureren.

Schema-gegevens zoeken

De Schema-gegevens zoeken is een functie binnen het eDocuments-schema. Het is bedoeld om de navigatie en het vinden van specifieke schema-gegevens aanzienlijk te vergemakkelijken. Vooral bij complexe of uitgebreide schema's is de zoekfunctie een essentiële hulp om gericht naar invoeren te zoeken en hun structuur te begrijpen.

Door gebruik te maken van de zoekfunctie kan er gefilterd worden op de naam of de waarde van individuele schema-gegevens. Wanneer er een overeenkomst wordt gevonden, toont het systeem ook de bijbehorende onderliggende elementen (subcategorieën) om de gegevens in de structurele context beter te begrijpen.

Gebruik van de Schema-gegevens-zoekfunctie

Om de Schema-gegevens-zoekfunctie binnen een eDocuments-schema te gebruiken, volgt u deze stappen:

Open via de zoekfunctie de invoer „Simova Apps eDocuments - Schema“.
Kies het gewenste schema uit de lijst.
De Schema-gegevens-zoekfunctie bevindt zich in het gedeelte „Algemeen“.
Houd er rekening mee dat de zoekfunctie hoofdlettergevoelig is.
Voer de gewenste zoekterm in en druk op Enter om de zoekopdracht te starten.
De zoekresultaten tonen alle overeenkomende invoeren, inclusief hun onderliggende elementen. Zo kunt u gericht naar specifieke datastructuren binnen het schema zoeken.

Info

De zoekfunctie is hoofdlettergevoelig.
De zoekopdracht is beperkt tot de gegevens binnen het momenteel geopende eDocuments-schema.
Als er geen resultaten worden weergegeven, controleer dan de spelling of de omvang van de ingevoerde zoekterm.

Werking

De zoekfunctie doorzoekt de in het eDocuments-schema opgenomen schema-gegevens dynamisch op basis van de ingevoerde termen. Hierbij worden zowel identificatoren (bijv. elementnamen) als toegewezen waarden in overweging genomen – voor zover deze aanwezig zijn.

Gebruik van de zoekfunctie

Zo gebruikt u de Schema-gegevens-zoekfunctie:

Voer een zoekterm in. Vervolgens worden alle overeenkomende invoeren, inclusief hun onderliggende elementen, weergegeven. Dit maakt een gerichte analyse mogelijk en vergemakkelijkt de bewerking van de datastructuur.

Zoekfunctie resetten

Om de zoekfunctie te resetten en alle schema-gegevens opnieuw volledig weer te geven, verwijdert u eenvoudig de ingevoerde tekst uit het zoekveld. Het systeem werkt vervolgens automatisch de weergave bij en toont alle beschikbare invoeren zonder beperkingen.