Automatisering voor Magento 2 met KatanaPIM

Stel automatische synchronisatie in tussen KatanaPIM en Magento met behulp van cron jobs. Deze handleiding behandelt het inschakelen van automatisering, het configureren van schema's en het afstemmen van de prestaties.

Overzicht

KatanaPIM Connect automatiseert catalogussynchronisatie met twee cron jobs:

Cron Job	Doel	Standaard Schema
Volledige Data Sync	Haalt alle data op uit de KatanaPIM API en detecteert wijzigingen	Elke 8 uur
Incrementele Sync	Synchroniseert openstaande wijzigingen naar Magento	Elke 5 minuten

Deze tweefasige aanpak scheidt het ophalen van data van de Magento-verwerking. De Volledige Data Sync haalt data op en vergelijkt deze, terwijl de Incrementele Sync de daadwerkelijke Magento catalogus-updates afhandelt.

Vereisten

Zorg voordat je automatisering inschakelt dat:

De module is ingeschakeld (Katana PIM → Configuration → General)
API-gegevens zijn geconfigureerd en getest
Store taalkoppeling is ingesteld
Attribuutkoppeling is volledig (Katana PIM → Attributes)
Magento cron draait (bin/magento cron:run of systeem crontab)

Stap 1: Automatisering Inschakelen

Ga naar Stores → Configuration → Katana PIM → Automation
Zet Enable Automation op Yes

Dit is de hoofdschakelaar. Wanneer uitgeschakeld, slaan alle cron jobs hun uitvoering over. CLI-commando's werken altijd, ongeacht deze instelling.

Stap 2: Auto-Aanmaken Configureren

Deze instellingen bepalen of cron jobs nieuwe entiteiten mogen aanmaken of alleen bestaande mogen bijwerken.

Instelling	Omschrijving	Aanbeveling
Auto create new products	Sta cron toe om nieuwe Magento producten aan te maken vanuit PIM	Zie hieronder
Auto create new categories	Sta cron toe om nieuwe Magento categorieën aan te maken vanuit PIM	Zie hieronder

Voorzichtige Aanpak (Aanbevolen bij Eerste Opzet)

Zet beide op No. Nieuwe producten en categorieën uit PIM verschijnen in de Katana PIM grids, maar worden niet aangemaakt in Magento totdat je de sync handmatig start via massaacties of CLI. Dit geeft je volledige controle over wat er in je catalogus komt.

Volledig Geautomatiseerde Aanpak

Zet beide op Yes voor volledig geautomatiseerd catalogusbeheer. Elk nieuw product of elke nieuwe categorie die wordt toegevoegd in KatanaPIM verschijnt automatisch in Magento na de volgende synchronisatiecyclus.

Tip: Begin met de voorzichtige aanpak. Zodra je hebt geverifieerd dat de sync correct werkt en je attribuutkoppelingen compleet zijn, kun je overschakelen naar volledig geautomatiseerd.

Stap 3: Synchronisatieschema's Instellen

Volledige Data Sync

Haalt alle data op uit de KatanaPIM API (attributen, categorieën, producten, assets) en slaat deze op in lokale tabellen. Data wordt vergeleken met een hash en gemarkeerd als needs_update wanneer wijzigingen worden gedetecteerd.

Beschikbare frequenties:

Schema	Cron Expressie	Geschikt Voor
Elke 4 uur	`16 /4 * *`	Catalogi die frequent wijzigen
Elke 6 uur	`4 /6 * *`	Actieve catalogi met regelmatige updates
Elke 8 uur	`33 /8 * *`	Standaard — goede balans voor de meeste winkels
Dagelijks	`0 4 * * *`	Stabiele catalogi met weinig dagelijkse wijzigingen
Wekelijks	`0 4 * * MON`	Catalogi die in batches worden bijgewerkt
Nooit	—	Wanneer alleen handmatige/CLI sync wordt gebruikt

Incrementele Sync

Haalt alleen gewijzigde data op uit de KatanaPIM API (sinds de laatste sync) en verwerkt alle openstaande updates naar Magento. Dit maakt of werkt Magento attributen, categorieën, producten en assets bij.

Schema	Cron Expressie	Geschikt Voor
Elke 5 minuten	`/5 * * *`	Standaard — bijna real-time updates
Elke 15 minuten	`/15 * * *`	Gemiddelde updatefrequentie
Elk uur	`0 * * * *`	Lagere serverbelasting
Elke 4 uur	`16 /4 * *`	Grote catalogi met batch-achtige updates
Nooit	—	Wanneer alleen handmatige/CLI sync wordt gebruikt

Aanbevolen Combinaties

Scenario	Volledige Sync	Incrementele Sync
Kleine catalogus (< 5.000 SKU's)	Elke 8 uur	Elke 5 minuten
Middelgrote catalogus (5.000-50.000 SKU's)	Dagelijks	Elke 15 minuten
Grote catalogus (50.000+ SKU's)	Dagelijks of Wekelijks	Elke 15-60 minuten
Weinig PIM-updates	Wekelijks	Elke 4 uur

Stap 4: Verwerkingslimieten Configureren

Verwerkingslimieten voorkomen dat cron jobs te veel resources verbruiken. Deze worden geconfigureerd onder Stores → Configuration → Katana PIM → General → Limits → Cron Limits.

Instelling	Standaard	Omschrijving
Max Products per Cron	100	Producten verwerkt per incrementele cron run
Max Categories per Cron	100	Categorieën verwerkt per incrementele cron run
Max Attributes per Cron	100	Attributen verwerkt per incrementele cron run
Max Assets per Cron	100	Assets verwerkt per incrementele cron run

Stel in op 0 voor onbeperkte verwerking (niet aanbevolen voor cron).

Hoe Limieten Werken

Als 500 producten openstaande updates hebben en de limiet is 100:

Run 1: verwerkt producten 1-100
Run 2: verwerkt producten 101-200
Run 3: verwerkt producten 201-300
...enzovoort

Met een incrementeel schema van 5 minuten zijn alle 500 producten binnen ongeveer 25 minuten gesynchroniseerd.

Tips voor Afstemming

Verhoog limieten als cron runs snel klaar zijn en je snellere sync wilt
Verlaag limieten als cron jobs overlappen, time-outs veroorzaken of de frontend-prestaties beïnvloeden
Monitor var/log/katanapim-cron.log om te zien hoe lang elke run duurt

Stap 5: Onderhoud Configureren

Onder de sectie Maintenance:

Instelling	Standaard	Omschrijving
Sync Log Retention (days)	30	Verwijder automatisch sync log-entries ouder dan dit aantal dagen. Stel in op 0 om alle logs te bewaren.

De opschoning draait dagelijks automatisch om 3:00 uur 's nachts.

Controleer of Automatisering Werkt

Controleer Sync Log

Ga naar Katana PIM → Sync Log om recente synchronisatie-activiteit te bekijken, inclusief:

Sync type (Full/Incremental)
Aangemaakte, bijgewerkte en verwijderde items
Opgetreden fouten
Uitvoeringstijd

Controleer Cron Logbestand

Bekijk var/log/katanapim-cron.log voor gedetailleerde timing- en verwerkingsinformatie.

Cron Handmatig Uitvoeren

Om te testen of cron werkt:

bin/magento cron:run --group=katanapim

Automatisering Combineren met Handmatige Sync

Automatisering en handmatige acties werken naast elkaar:

Methode	Wanneer Gebruiken
Cron (geautomatiseerd)	Dagelijkse synchronisatie
Admin grid acties	Specifieke producten of categorieën op verzoek synchroniseren
CLI commando's	Initiële imports, grote batchverwerking, troubleshooting

CLI-commando's negeren automatiseringsinstellingen en draaien altijd, ongeacht de Enable Automation schakelaar.

Handige CLI Commando's

# Volledige sync (ophalen + verwerken) — geen entiteitslimieten
bin/magento katana:import:full

# Incrementele sync — respecteert geconfigureerde limieten
bin/magento katana:import:incremental

# Volledige sync voor alleen specifieke entiteiten
bin/magento katana:import:full --products
bin/magento katana:import:full --categories --attributes

# Ophalen van API zonder te synchroniseren naar Magento (troubleshooting)
bin/magento katana:import:full --only-api

# Lokale data synchroniseren naar Magento zonder op te halen van API
bin/magento katana:import:incremental --skip-api

Probleemoplossing

Cron Jobs Draaien Niet

Controleer of Magento cron actief is: bin/magento cron:run --group=katanapim
Controleer de cron schedule tabel (zie bovenstaande query)
Controleer of Enable Automation op Yes staat
Controleer of de module is ingeschakeld in de General configuratie

Synchronisatie Lijkt Traag

Controleer verwerkingslimieten — verhoog als runs snel klaar zijn
Controleer var/log/katanapim-cron.log voor een tijdsverdeling
Overweeg batchgroottes aan te passen onder General → Limits
Gebruik voor grote initiële imports CLI in plaats van cron

Producten Verschijnen Niet in Magento

Controleer of Auto create new products op Yes staat
Controleer het product in het Katana PIM → Products grid op fouten of skip-vlaggen
Zorg dat attribuutkoppeling compleet is
Voer een volledige sync uit om alle wijzigingen te detecteren: bin/magento katana:import:full

Cron Jobs Overlappen

Verlaag verwerkingslimieten (Max per Cron instellingen)
Vergroot het interval van de incrementele sync
Controleer serverresources (CPU, geheugen)

Meer Hulp Nodig?

Documentatie:

Alle Help Artikelen - Compleet documentatie overzicht

Support:

Contact Opnemen - Hulp van ons team

KatanaPIM