eDocuments-Schema

Aanmaken van een eDocuments-schema

Om een nieuw eDocuments-schema in Business Central aan te maken, volgt u de volgende 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.
Selecteer het Schematype. Kies XML voor XML-uitvoer of JSON voor JSON-uitvoer.
U kunt het schema nu naar uw wensen configureren.

Info

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

Update Schema-regels

Eerst worden nieuwe Data Types gedefinieerd. Deze nieuw aangemaakte Data Types 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.

Schematype

Het veld Schematype bepaalt of het schema wordt gebruikt voor XML- of JSON-uitvoer. Het veld is beschikbaar in de schemalijst en op de schemapagina.

Wanneer het schematype wordt gewijzigd, wordt de pagina automatisch bijgewerkt. XML-specifieke onderdelen worden verborgen voor JSON-schema's, terwijl JSON-specifieke velden en acties beschikbaar worden.

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

Standaardschemaregels maken

De actie voor het maken van standaard schemaknooppunten ondersteunt zowel XML- als JSON-schema's.

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

Als er al standaardregels voor een JSON-schema bestaan, kan het systeem vragen of de bestaande regels moeten worden verwijderd en opnieuw opgebouwd. Als u deze bevestiging weigert, blijven de bestaande schemaregels ongewijzigd.

JSON-schemaregels configureren

JSON-schemaregels 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 met aanhalingstekens geschreven.
Number	De waarde wordt zonder aanhalingstekens geschreven. Als de waarde niet als getal kan worden gelezen, wordt 0 uitgevoerd.
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 gebruikt voor structuren zoals factuurregels, belastingen, toeslagen en kortingen, betalingsvervaldagen, factuurreferenties, aanvullende artikeleigenschappen, contacten, bankrekeningen, derden en ontvangstreferenties.

Voor arraystructuren kan eDocuments de array-items herhalen op basis van de ingestelde gegevensmapping. Als er geen mapping voor een array is ingesteld, wordt één array-item gemaakt.

Optionele JSON-knooppunten en eigenschappen worden overgeslagen wanneer er geen waarde of standaardwaarde beschikbaar is en de minimale voorkomens op 0 is ingesteld.

JSON-veldinformatie

Voor JSON-schemaregels toont de actie Informatie een beschrijving van het geselecteerde JSON-veld op basis van de B2Brouter API-specificatie. Dit helpt beheerders te begrijpen welk veld zij configureren zonder de schemapagina te verlaten.

Schema-gegevenszoekfunctie

De Schema-gegevenszoekfunctie 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 vermeldingen 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-gegevenszoekfunctie

Om de Schema-gegevenszoekfunctie binnen een eDocuments-schema te gebruiken, volgt u de volgende stappen:

Open via de zoekfunctie de vermelding „Simova Apps eDocuments - Schema“.
Kies het gewenste schema uit de lijst.
De Schema-gegevenszoekfunctie 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 vermeldingen, inclusief hun onderliggende elementen. Zo kunt u gericht naar bepaalde datastructuren binnen het schema zoeken.

Info

De zoekfunctie maakt onderscheid tussen hoofdletters en kleine letters.
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 dynamisch de in het eDocuments-schema opgenomen schema-gegevens 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-gegevenszoekfunctie:

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

Zoekopdracht resetten

Om de zoekopdracht 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 vermeldingen onbeperkt.