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

 API

2026/06/29 • 3 Min. Lesedauer

In diesem Thema

• Endpoint
• Liste der XML-Schemata
• Datei erstellen und abrufen
• Filter setzen
• Berechtigungssatz
• Weitere Informationen

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.

Endpoint

Um über die API auf den XML Builder zuzugreifen, verwenden Sie die folgenden Informationen:

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=\"",
            "type":"General",
            "code": "CUST",
            "description": "Debitoren inkl. Posten",
            "comments": "API Test",
            "filter": "{ \"No.\": \"Code\", \"Salesperson Code\": \"Code\" }"
        },
        {
            "@odata.etag": "W/\"JzE3Ozc2NTU2NDM4NTIxNjcwNjE3MTswMDsn\"",
            "type":"General",
            "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('{type,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('General','CUST')/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

Weitere Informationen folgen in Kürze.

Weitere Informationen

• 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...