Handbuch als PDF speichern oder drucken  


XML Builder


Daten im XML-Format (oder JSON) über frei konfigurierbare Schemata exportieren.

Handbuch


Erstellungsdatum: 2026/05/21
Die aktuelle Version dieses Handbuchs finden Sie unter:

https://www.navax.app/help.php?AppID=NCXML&L=de


☰ Inhaltsverzeichnis



Allgemein

  • XML Builder
    XML Builder erweitert Microsoft Dynamics 365 Business Central um frei konfigurierbare XML-Schemata. Die Schemata können dann verwendet werden, um Daten in eine Datei zu exportieren oder um Daten über eine API abzurufen...

Einrichtung

  • XML Builder Einrichtung
    Auf der Seite XML Builder Einrichtung werden die allgemeinen Einstellungen und Vorgaben für den XML Builder festgelegt...

Arbeiten mit der App

  • XML Builder Schemata
    Weitere Informationen folgen in Kürze...
  • Schemazeilen
    Weitere Informationen folgen in Kürze...
  • Root-Zeileneinstellungen
    Weitere Informationen folgen in Kürze...
  • Tabelleneinstellungen
    Weitere Informationen folgen in Kürze...
  • Feldeinstellungen
    Weitere Informationen folgen in Kürze...
  • Variablen
    Weitere Informationen folgen in Kürze...
  • Bedingungen
    Weitere Informationen folgen in Kürze...
  • Berechnungen
    Weitere Informationen folgen in Kürze...
  • Downloadbereich
    Im Downloadbereich finden Sie eine Auswahl an Schemata, die Sie herunterladen und verwenden können...
  • Kopieren, Exportieren & Importieren

Informationen für Entwickler

  • API
    Dateien können mit dem XML Builder auch von extern über eine API erstellt werden. Die erstellte Datei wird dabei im Base64-Format zurückgeliefert. Damit ein Schema in der API sichtbar ist bzw. die Datei über die API erstellt werden kann, muss das Feld API-Zugriff zulassen für das XML-Schema gesetzt sein...

Anhang

  • NAVAX Lizenzverwaltung
    Die Seite NAVAX Lizenzverwaltung (in älteren Versionen NAVAX Lizenzübersicht oder NCEX Lizenzübersicht) zeigt den aktuellen Lizenzstatus der NAVAX-Erweiterungen an...
  • Installationshinweise
  • Versionshinweise

Docs  /  App  /  XML Builder  /  Allgemein
 XML Builder

XML Builder erweitert Microsoft Dynamics 365 Business Central um frei konfigurierbare XML-Schemata. Die Schemata können dann verwendet werden, um Daten in eine Datei zu exportieren oder um Daten über eine API abzurufen.

Navigation

XML Builder kann über die Suche von jeder Rolle aus aufgerufen werden. Die Suchbegriffe "xmlbuilder", "nvxxml", "ncxml" und "navax" werden auch von "Wie möchten Sie weiter verfahren" erkannt.

Hinweis

Der XML Builder wurde mit dem Präfix NCXML bzw. NVXXML entwickelt. NCXML bzw. NVXXML steht für NAVAX Consulting bzw. NAVAX XML Builder.

Berechtigungssätze

Für den XML Builder stehen folgende Berechtigungssätze zur Verfügung:
NameBeschreibung
NVXXMLXML Builder Diese Berechtigungen benötigen Sie, um den XML Builder zu benutzen.
NVXXML, SETUPXML Builder einr. Diese Berechtigungen benötigen Sie, um den XML Builder einzurichten.
NVXXML, APIXML Builder API Wenn Dateien auch über die API erstellt werden sollen, muss dieser Berechtigungssatz der Microsoft Entra-Anwendung oder, bei einer On-Premises Installation, dem API-Benutzer hinzugefügt werden. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, API.

Installationshinweise

Weitere Informationen dazu finden Sie unter Anhang, Installationshinweise.

Docs  /  App  /  XML Builder  /  Einrichtung
 XML Builder Einrichtung

Auf der Seite XML Builder Einrichtung werden die allgemeinen Einstellungen und Vorgaben für den XML Builder festgelegt.

Allgemein, Felder
API-Zugriff deaktivierenGibt an, ob der API-Zugriff deaktiviert werden soll. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, API.

Setup, Aktionen

System, Aktionen

  • NAVAX Lizenzverwaltung

    Öffnet die NAVAX Lizenzverwaltung, die den aktuellen Lizenzstatus der NAVAX-Erweiterungen anzeigt. Weitere Informationen dazu finden Sie unter Anhang, NAVAX Lizenzverwaltung.

Docs  /  App  /  XML Builder  /  Arbeiten mit der App
 XML Builder Schemata

Weitere Informationen folgen in Kürze.

Docs  /  App  /  XML Builder  /  Arbeiten mit der App
 Schemazeilen

Weitere Informationen folgen in Kürze.

Docs  /  App  /  XML Builder  /  Arbeiten mit der App
 Root-Zeileneinstellungen

Weitere Informationen folgen in Kürze.

Docs  /  App  /  XML Builder  /  Arbeiten mit der App
 Tabelleneinstellungen

Weitere Informationen folgen in Kürze.

Docs  /  App  /  XML Builder  /  Arbeiten mit der App
 Feldeinstellungen

Weitere Informationen folgen in Kürze.

Docs  /  App  /  XML Builder  /  Arbeiten mit der App
 Variablen

Weitere Informationen folgen in Kürze.

Docs  /  App  /  XML Builder  /  Arbeiten mit der App
 Bedingungen

Weitere Informationen folgen in Kürze.

Docs  /  App  /  XML Builder  /  Arbeiten mit der App
 Berechnungen

Weitere Informationen folgen in Kürze.

Docs  /  App  /  XML Builder  /  Arbeiten mit der App
 Downloadbereich

Im Downloadbereich finden Sie eine Auswahl an Schemata, die Sie herunterladen und verwenden können.

Hinweis

Das nachfolgende Beispiel zeigt den XML Builder Downloadbereich der NAVAX-Erweiterung E-Document - ebInterface.
Über die Aktion Herunterladen kann ein Schema heruntergeladen und angelegt werden.

Felder
CodeZeigt den Code des Schemas an.
BeschreibungZeigt die Beschreibung des Schemas an.
InformationenZeigt Informationen zum Schema an.
Zip-DateiZeigt an, ob mehrere Schemata in einer Zip-Datei zusammengefasst sind.
NeuZeigt an, ob das Schema erst vor Kurzem zum Downloadbereich hinzugefügt wurde.
Korrigiert amZeigt das letzte Änderungsdatum des Schemas an.

Aktionen

  • Herunterladen

    Über diese Aktion kann das Schema heruntergeladen und angelegt werden. Dabei wird die Import-Seite geöffnet, wo weitere Einstellungen vorgenommen werden können.

Docs  /  App  /  XML Builder  /  Arbeiten mit der App
 Kopieren, Exportieren & Importieren

Hinweis

Die nachfolgenden Beispiele zeigen die XML Builder Schemata der NAVAX-Erweiterung E-Document - ebInterface.

Kopieren

Über diese Aktion kann eine Kopie des Schemas erstellt werden.

  • Kopieren von
    CodeZeigt den Code des vorhandenen Schemas an, von dem kopiert werden soll.
    BeschreibungZeigt die Beschreibung des vorhandenen Schemas an.

    Kopieren nach
    CodeGibt den Code für das neue Schema an.
    Code bereits vorhandenGibt an, ob bereits ein Schema mit dem Code vorhanden ist. Für das Ersetzen eines Schemas ist eine zusätzliche Bestätigung erforderlich.
    BeschreibungGibt eine Beschreibung für das neue Schema an.

Exportieren

Über diese Aktion kann ein Schema in eine Datei, oder mehrere ausgewählte Schemata in eine Zip-Datei exportiert werden.

  • Exportieren von
    CodeZeigt den Code des zu exportierenden Schemas an.
    BeschreibungZeigt die Beschreibung des zu exportierenden Schemas an.
    Ausgewählte SchemataZeigt die Anzahl der ausgewählten Schemata an. Das Feld wird nur angezeigt, wenn Schemata in eine Zip-Datei exportiert werden.

    Exportieren nach
    DateinameGibt den Namen für die Datei an.

    Hinweis

    XML Builder Schemadateien haben die Dateierweiterung .ncxmls. NCXMLS steht für NAVAX Consulting XML Builder Schema.

Importieren

Über diese Aktion kann ein Schema aus einer Datei, oder mehrere Schemata aus einer Zip-Datei importiert werden.

  • Importieren von

    FortschrittZeigt den Fortschritt beim Importieren aus einer Zip-Datei an. Das Feld wird nur angezeigt, wenn Schemata aus einer Zip-Datei importiert werden.
    BeschreibungZeigt die Beschreibung des zu importierenden Schemas an.

    Importieren nach
    CodeGibt den Code für das neue Schema an.
    Code bereits vorhandenGibt an, ob bereits ein Schema mit dem Code vorhanden ist. Für das Ersetzen eines Schemas ist eine zusätzliche Bestätigung erforderlich.
    Alle mit angegebenem Code importierenGibt an, ob alle Schemata, bei denen ein Code angegeben ist, automatisch mit diesem Code importiert werden sollen, wenn noch kein Schema mit diesem Code vorhanden ist. Das Feld wird nur angezeigt, wenn Schemata aus einer Zip-Datei importiert werden.

Docs  /  App  /  XML Builder  /  Informationen für Entwickler
 API

Dateien können mit dem XML Builder auch von extern über eine API erstellt werden. Die erstellte Datei wird dabei im Base64-Format zurückgeliefert. Damit ein Schema in der API sichtbar ist bzw. die Datei über die API erstellt werden kann, muss das Feld API-Zugriff zulassen für das XML-Schema gesetzt sein. Weitere Informationen dazu finden Sie unter Arbeiten mit der App, XML Builder Schemata.

Hinweis

Falls notwendig können Sie den API-Zugriff auch jederzeit in der XML Builder Einrichtung komplett deaktivieren. Weitere Informationen dazu finden Sie unter Einrichtung, XML Builder Einrichtung.

Endpoint

Um über die API auf den XML Builder zuzugreifen, verwenden Sie die folgenden Informationen:
Publishernavax
GroupxmlBuilder
Versionv2.0
EndpointxmlSchemas

Liste der XML-Schemata

Über ein GET-Request kann eine Liste aller XML-Schemata abgerufen werden, bei denen ein API-Zugriff zugelassen ist. Aufbau der URL https://api.businesscentral.dynamics.com/v2.0/{tenant}/{environment}/api/navax/xmlBuilder/v2.0/companies({id})/xmlSchemas Beispiel https://api.businesscentral.dynamics.com/v2.0/0e12x34c-e5le-678x-c912-34567890e12l/NAVAXAppsSandbox/api/navax/xmlBuilder/v2.0/companies(c2d9d41e-19ab-ec11-bb8f-000d3a231900)/xmlSchemas Ergebnis 
{
    "@odata.context": "https://api.businesscentral.dynamics.com/v2.0/0e12x34c-e5le-678x-c912-34567890e12l/NAVAXAppsSandbox/api/navax/xmlBuilder/v2.0/$metadata#companies(c2d9d41e-19ab-ec11-bb8f-000d3a231900)/xmlSchemas",
    "value": [
        {
            "@odata.etag": "W/\"JzE5OzMxMDQ5Njc5Nzc5MjgyNzY5NDIxOzAwOyc=\"",
            "code": "CUST",
            "description": "Debitoren inkl. Posten",
            "comments": "API Test",
            "filter": "{ \"No.\": \"Code\", \"Salesperson Code\": \"Code\" }"
        },
        {
            "@odata.etag": "W/\"JzE3Ozc2NTU2NDM4NTIxNjcwNjE3MTswMDsn\"",
            "code": "SINV",
            "description": "Verkaufsrechnung",
            "comments": "API Test",
            "filter": "{ \"No.\": \"Code\" }"
        }
    ]
}

Datei erstellen und abrufen

Über ein POST-Request kann die Datei für ein Schema erstellt und abgerufen werden. Die erstellte Datei wird dabei im Base64-Format zurückgeliefert. Aufbau der URL https://api.businesscentral.dynamics.com/v2.0/{tenant}/{environment}/api/navax/xmlBuilder/v2.0/companies({id})/xmlSchemas('{code}')/Microsoft.NAV.GetFileAsBase64 Beispiel https://api.businesscentral.dynamics.com/v2.0/0e12x34c-e5le-678x-c912-34567890e12l/NAVAXAppsSandbox/api/navax/xmlBuilder/v2.0/companies(c2d9d41e-19ab-ec11-bb8f-000d3a231900)/xmlSchemas('TEST')/Microsoft.NAV.GetFileAsBase64 Ergebnis 
{
    "@odata.context": "https://api.businesscentral.dynamics.com/v2.0/0e12x34c-e5le-678x-c912-34567890e12l/NAVAXAppsSandbox/api/navax/xmlBuilder/v2.0/$metadata#Edm.String",
    "value": "UEsDBBQAAAAIADo7h1xFpqSDDAUAAFgZAAAYAAAAeGwvd29ya3NoZWV0cy9zaGVldDEueG1...gAAAAAA=="
}

Filter setzen

TODO

Berechtigungssatz

Für die API steht folgender Berechtigungssatz zur Verfügung:
NVXXML, APIXML Builder API Damit Dateien über die API erstellt werden können, muss dieser Berechtigungssatz der Microsoft Entra-Anwendung oder, bei einer On-Premises Installation, dem API-Benutzer hinzugefügt werden.

Docs  /  App  /  XML Builder  /  Anhang
 NAVAX Lizenzverwaltung

Die Seite NAVAX Lizenzverwaltung (in älteren Versionen "NAVAX Lizenzübersicht" oder "NCEX Lizenzübersicht") zeigt den aktuellen Lizenzstatus der NAVAX-Erweiterungen an.

Felder
NameZeigt den Namen der Erweiterung an.
LizenzstatusZeigt den aktuellen Lizenzstatus der Erweiterung an.
Seriennr.Zeigt die Seriennr. der Erweiterung an.
VersionZeigt die aktuell installierte Version der Erweiterung an.

Testversion

Eine NAVAX-Erweiterung kann nach der Installation 30 Tage lang kostenlos getestet bzw. genutzt werden. Danach kann die Erweiterung nur mehr mit einer gültigen Lizenz verwendet werden.

Lizenz beantragen

Die Lizenz kann über die Aktion Aktueller Status beantragt bzw. überprüft werden. Dabei wird eine neue Seite geöffnet. Das nachfolgende Beispiel zeigt die NAVAX-Erweiterung Excel Report Builder. Füllen Sie die Felder auf der Seite aus und klicken Sie anschließend auf Lizenzanfrage senden. Beachten Sie, dass der Lizenzierungsprozess einige Zeit dauern kann. In den nächsten Tagen erhalten Sie eine E-Mail mit weiteren Informationen.

Hinweis

Für die Lizenzierung, den Aufruf der Onlinehilfe und das Ausführen einiger Aktionen muss der Zugriff auf https://www.navax.app erlaubt sein.

Public IP von www.navax.app für die Freischaltung an der Firewall:
94.136.22.236, Port: TCP/443

Prüfung der Verbindung zu https://www.navax.app mittels PS:
Test-NetConnection navax.app -port 443
(PS muss mit dem M-Tier Service-User ausgeführt werden)

CRL-Server
Zusätzlich müssen für die Zertifikatsprüfung auch folgende CRL-Server erreichbar sein:
https://certificates.godaddy.com/*
http://crl.godaddy.com/*
oder deren IP: 192.124.249.36

Lizenz aktivieren/aktualisieren

Sobald die Lizenzierung abgeschlossen ist, erhalten Sie eine E-Mail und die Lizenz kann über die Aktion Lizenz aktualisieren aktiviert werden. Die Lizenz ist mandantenunabhängig. Es spielt also keine Rolle in welchem Mandanten die Aktion aufgerufen wird.

Hinweis

  • Die Lizenz muss einmal im Jahr über die Aktion Lizenz aktualisieren aktualisiert werden.
  • Die Aktualisierung ist erst innerhalb der letzten 30 Tage vor Ablauf der Lizenz (oder danach) möglich bzw. notwendig. Innerhalb der letzten 30 Tage vor Ablauf der Lizenz werden Hinweise angezeigt.
  • Ist die Automatische Lizenzverlängerung aktiviert, wird die Aktion Lizenz aktualisieren automatisch aufgerufen, bevor die Lizenz abläuft. Dabei werden alle Lizenzen, für die die automatische Lizenzverlängerung aktiviert ist, geprüft und bei Bedarf aktualisiert. Ist die automatische Verlängerung nicht erfolgreich, werden innerhalb der letzten 15 Tage vor Ablauf der Lizenz werden Hinweise angezeigt. Beachten Sie, dass die Einstellung erst aktiv ist, nachdem die Lizenz aktiviert wurde.

AGB & EULA

Weitere Informationen dazu finden Sie unter https://www.navax.app/EULA.php?L=de

Datenschutz

Weitere Informationen dazu finden Sie unter https://www.navax.app/privacyStatement.php?L=de

Bewertung abgeben

Über diese Aktion kann für die Erweiterung die Bewertungen-Seite der Microsoft AppSource geöffnet werden. Wir würden uns sehr freuen, wenn Sie hier Ihre Bewertung abgeben und uns über Ihre Erfahrungen mit der Erweiterung berichten.

Docs  /  App  /  XML Builder  /  Anhang
 Installationshinweise

Veröffentlichen und Installieren der Erweiterung


Alle notwendigen Schritte werden hier beschrieben:
[Microsoft Learn] Business Central - Publishing and Installing an Extension

Abhängigkeiten

  • NAVAX Extension Base

    ID: 2f4cb42d-6e2a-4708-a5e2-3ec5f32f20e9 Weitere Informationen dazu finden Sie unter [Docs] NAVAX Extension Base

On-Premises

Folgende Granules werden bei einer On-Premises Installation benötigt:
  • 70714860 NAVAX XML Builder
  • 1010860 NAVAX Extension Base

Externe Adressen

  • https://www.navax.app

    Für die Lizenzierung, den Aufruf der Onlinehilfe und das Ausführen einiger Aktionen muss der Zugriff auf https://www.navax.app erlaubt sein.

    Public IP von www.navax.app für die Freischaltung an der Firewall:
    94.136.22.236, Port: TCP/443

    Prüfung der Verbindung zu https://www.navax.app mittels PS:
    Test-NetConnection navax.app -port 443
    (PS muss mit dem M-Tier Service-User ausgeführt werden)

    CRL-Server
    Zusätzlich müssen für die Zertifikatsprüfung auch folgende CRL-Server erreichbar sein:
    https://certificates.godaddy.com/*
    http://crl.godaddy.com/*
    oder deren IP: 192.124.249.36

Docs  /  App  /  XML Builder  /  Anhang
 Versionshinweise

Möchten Sie wissen, was sich in der Erweiterung geändert hat?
Nachfolgend finden Sie eine Übersicht über die neuen Funktionen und Änderungen, die in den Updates vorgenommen wurden.

Version 26.1.0.0

  • Ursprungsversion

  Handbuch als PDF speichern oder drucken  
DE|EN Impressum