Met de KingQueryTool kunnen vier verschillende KING XML-bestanden gegenereerd worden:
- KING_ARTIKELEN XML
- KING_DEBITEUREN XML
- KING_ORDERS XML
- KING_DIRECTELEVERINGEN XML
Vereisten voor het genereren van een KING XML
Om automatisch een KING XML te genereren vanuit de KingQueryTool, zijn slechts twee dingen nodig:
- Kennis van SQL
- Basiskennis van de structuur van de gewenste KING XML
Structuur van de SQL-query
Voor een correcte generatie van een KING XML-bestand, moet het eerste veld van de SQL-query altijd starten met het juiste kenmerkende veld:
- KING_ARTIKELEN XML →
ART_NUMMER - KING_DEBITEUREN XML →
NAW_NUMMER - KING_ORDERS XML →
ORK_ORDERNUMMER - KING_DIRECTELEVERINGEN XML →
DLK_ONTVANGSTNUMMER
Hieronder gaan we dieper in op de KING_ARTIKELEN XML.
Voor meer informatie over de ondersteunde KING XML-bestanden, zie de officiële documentatie:
- Eisen aan het XML-bestand met artikelen
- Eisen aan het XML-bestand met NAW-gegevens
- Eisen aan het XML-bestand met orders
- Eisen aan het XML-bestand met directe leveringen
Gebruik van een KING_ARTIKELEN XML voor Onderhoudsacties
Met een gegenereerde KING_ARTIKELEN XML kun je rechtstreeks vanuit je King-administratie grootschalige onderhoudsacties uitvoeren—zelfs acties die niet via de standaard onderhoudsfunctie van King mogelijk zijn.
Praktisch voorbeeld: Staffels instellen op basis van webbestelgrootte
Stel, je wilt op basis van een bepaalde webbestelgrootte (x) een specifieke staffel (kortingstabel) hanteren voor je artikelen. De nieuwe staffels zijn al aangemaakt, maar moeten nog gekoppeld worden op basis van de webbestelgrootte.
Ga als volgt te werk:
Voer de volgende SQL-query uit in de KingQueryTool om een KING_ARTIKELEN XML te genereren:
SELECT
ArtCode AS ART_NUMMER,
CASE
WHEN ArtWebBestelGrootte = 10
THEN 105
END AS ART_STAFFELTABEL
FROM
KingSystem.tabArtikel
WHERE
ArtWebBestelGrootte = 10;
Na het uitvoeren van deze query wordt er automatisch een XML-bestand gegenereerd in de volgende map:
📂 C:\ProgramData\ADJUST-IT\KingQueryTool\temp
De gegenereerde XML krijgt de naam:
📄 king_art_export.xml
Belangrijke controlepunten
✅ Tijdstempel controleren
Controleer altijd of de laatst gewijzigde tijd van het bestand overeenkomt met het moment waarop je de SQL-query hebt uitgevoerd.
⚠️ Let op bij fouten!
Bij een SQL-fout of een query die niet voldoet aan de vereisten voor een KING_ARTIKELEN XML, blijft het bestaande bestand gewoon in de map staan. Dit betekent dat je mogelijk een oud bestand bekijkt in plaats van de nieuwste export.
Voorbeeld van het gegenereerde KING_ARTIKELEN XML-bestand
Na het uitvoeren van de SQL-query, wordt een XML-bestand gegenereerd. Dit bestand kan er als volgt uitzien:
<?xml version="1.0" encoding="iso-8859-1"?>
<KING_ARTIKELEN xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ARTIKELEN>
<ARTIKEL>
<ART_NUMMER>Artikelnummer1</ART_NUMMER>
<ART_STAFFELTABEL>105</ART_STAFFELTABEL>
</ARTIKEL>
<ARTIKEL>
<ART_NUMMER> Artikelnummer2</ART_NUMMER>
<ART_STAFFELTABEL>105</ART_STAFFELTABEL>
</ARTIKEL>
<ARTIKEL>
<ART_NUMMER> Artikelnummer3</ART_NUMMER>
<ART_STAFFELTABEL>105</ART_STAFFELTABEL>
</ARTIKEL>
<ARTIKEL>
<ART_NUMMER> Artikelnummer4</ART_NUMMER>
<ART_STAFFELTABEL>105</ART_STAFFELTABEL>
</ARTIKEL>
<ARTIKEL>
<ART_NUMMER> Artikelnummer5</ART_NUMMER>
<ART_STAFFELTABEL>105</ART_STAFFELTABEL>
</ARTIKEL>
</ARTIKELEN>
</KING_ARTIKELEN>
KING_ARTIKELEN XML importeren in King
Wil je de gegenereerde KING_ARTIKELEN XML verwerken in je King-administratie? Volg dan onderstaande stappen:
1. Ga naar de importfunctie in King
📌 Navigatiepad in King:
Diversen → Importeren → Importeren artikelen → Importeren XML-bestand met artikelen
2. Maak een nieuwe importlay-out aan
Maak een nieuwe importlay-out aan, zoals in het onderstaande voorbeeld.
🔹 Vrij instelbare velden:
- Omschrijving → Kies een herkenbare naam voor de importlay-out.
- Bestandsnaam → Selecteer het juiste XML-bestand (king_art_export.xml).
- Foutieve records opslaan? → Optioneel, afhankelijk van je voorkeur.
⚠️ Aanbevolen instelling:
Het uitvinken van de optie “Gegevens toevoegen” wordt aangeraden. Hiermee voorkom je dat per ongeluk nieuwe artikelen worden aangemaakt die niet in de database horen.
🔹 Tip voor een efficiënte import:
Laat alle velden aangevinkt en bepaal via je SQL-query en de gegenereerde XML welke gegevens daadwerkelijk geüpdatet worden.
3. Controleer het importresultaat
Na een succesvolle import krijg je een bevestigingsscherm te zien met een overzicht van de geïmporteerde artikelen.
Importeren van andere KING XML-bestanden
De overige KING XML-bestanden kunnen op een vergelijkbare manier gegenereerd en ingelezen worden. De specificaties van deze bestanden zijn eerder gegeven.
Navigatie per XML-bestand in King:
📌 Debiteuren
Diversen → Importeren → Importeren debiteuren
📌 Orders
Diversen → Importeren → Importeren orders
📌 Directe leveringen
Diversen → Importeren → Importeren directe leveringen
De importlay-out instellingen voor deze bestanden komen grotendeels overeen met die van artikelen. Het enige verschil is dat er andere velden aan- of uitgezet moeten worden.
🚀 Aanbevolen werkwijze:
Laat alle velden aangevinkt en bepaal via SQL en XML welke gegevens daadwerkelijk gewijzigd worden. Dit voorkomt onnodige aanpassingen in de administratie.
