KatanaPIM Sync Log in Magento 2
Begrijp hoe synchronisatie werkt in KatanaPIM Connect. Leer het verschil tussen Full en Incremental sync, en wanneer je welke moet gebruiken.
Overzicht
KatanaPIM Connect synchroniseert data in twee stadia:
- Import uit PIM - Haal data op uit KatanaPIM API naar tussentabellen
- Aanmaken in Magento - Verwerk tussendata om Magento entiteiten aan te maken/bij te werken
Deze twee-stadia aanpak laat je geïmporteerde data reviewen voordat je Magento producten aanmaakt.
Sync Types
Full Update
Een volledige synchronisatie van alle entiteiten uit KatanaPIM.
Wat het doet:
- Haalt ALLE producten, categorieën, attributen en assets op uit PIM
- Vergelijkt met bestaande data via hash-vergelijking
- Markeert items als "Needs Update" wanneer wijzigingen worden gedetecteerd
- Kan optioneel Magento reindex triggeren na voltooiing
Wanneer gebruiken:
- Initiële setup en eerste import
- Na grote wijzigingen in PIM
- Wekelijks/dagelijks gepland onderhoud
- Wanneer incremental sync gaten heeft
Uitvoeren via CLI:
# Volledige sync van alles
bin/magento katana:import:full
# Sync alleen specifieke entity types
bin/magento katana:import:full --attributes
bin/magento katana:import:full --categories
bin/magento katana:import:full --products
bin/magento katana:import:full --assets
Incremental Update
Een delta-synchronisatie die alleen gewijzigde items verwerkt.
Wat het doet:
- Haalt alleen items op die zijn gewijzigd sinds laatste sync
- Veel sneller dan full update
- Lagere serverbelasting
- Ideaal voor frequente updates
Wanneer gebruiken:
- Regelmatige geplande updates (elke paar uur)
- Na individuele productwijzigingen in PIM
- Om Magento gesynchroniseerd te houden gedurende de dag
Uitvoeren via CLI:
bin/magento katana:import:incremental
Sync Volgorde
Entiteiten moeten in deze volgorde worden gesynchroniseerd:
- Attributen - Eerst vereist voor product data mapping
- Categorieën - Optioneel, nodig als je PIM categorieën gebruikt
- Producten - Hoofd productdata
- Assets - Product afbeeldingen en video's (vereist producten)
Het Full Update commando handelt deze volgorde automatisch af.
Wat Wordt Gesynchroniseerd
Producten
| PIM Data | Magento Veld |
|---|---|
| Productnaam | name (gemapped attribuut) |
| Beschrijving | description (gemapped attribuut) |
| SKU | sku |
| GTIN | gtin (gemapped attribuut) |
| Prijsdata | price, special_price, cost |
| Categorie toewijzingen | category_ids |
| Attribuutwaarden | Custom attributen |
Categorieën
| PIM Data | Magento Veld |
|---|---|
| Categorienaam | name |
| URL key | url_key |
| Ouder/kind hiërarchie | path, level |
| Positie | position |
Attributen
| PIM Data | Magento Veld |
|---|---|
| Attribuutcode | attribute_code (katanapim_ prefix) |
| Attribuutlabel | frontend_label |
| Attribuuttype | frontend_input |
| Opties | attribute options |
Assets
| PIM Data | Magento Veld |
|---|---|
| Afbeelding URL | Product galerij |
| Afbeelding volgorde | position |
| Video URL | Product video |
| Alt tekst | label |
Hash Vergelijking
De module gebruikt hash-vergelijking om wijzigingen te detecteren:
- Wanneer data wordt geïmporteerd uit PIM, wordt een hash berekend
- Wanneer Magento entiteit wordt aangemaakt/bijgewerkt, wordt een andere hash berekend
- Als hashes verschillen, wordt het item gemarkeerd als "Needs Update"
- Overeenkomende hashes betekenen dat geen update nodig is
Dit voorkomt onnodige Magento saves en verbetert performance.
De "Needs Update" Vlag
In alle grids zie je een "Needs Update" kolom:
| Waarde | Betekenis |
|---|---|
| Yes | PIM data verschilt van Magento - update aanbevolen |
| No | Data is gesynchroniseerd - geen actie nodig |
Items gemarkeerd als "Needs Update" worden verwerkt tijdens de volgende sync als automatisering is ingeschakeld.
De "Skipped" Vlag
Markeer items als "Skipped" om ze uit te sluiten van synchronisatie:
- Geskipte items worden genegeerd tijdens auto-sync
- Handig voor producten die je niet in Magento wilt
- Kan worden in/uitgeschakeld via massa-actie
Automatisering Flow
Wanneer automatisering is ingeschakeld:
- Cron triggert op basis van geconfigureerde frequentie
- Incremental/Full Update haalt data op uit PIM
- Auto-create (indien ingeschakeld) maakt nieuwe Magento entiteiten aan
- Bestaande items met "Needs Update" worden bijgewerkt
- Sync Log registreert de resultaten
Handmatig vs Automatisch Aanmaken
Automatisch (via cron):
- Schakel "Auto create new products" in bij Automation instellingen
- Nieuwe producten worden automatisch aangemaakt tijdens sync
- Minder controle, meer gemak
Handmatig (via grid):
- Laat auto-create uitgeschakeld
- Review eerst geïmporteerde producten in grid
- Selecteer items en gebruik "Update/Create Magento Products" massa-actie
- Meer controle over wat wordt aangemaakt
Performance Tips
- Gebruik Incremental voor frequente updates (elk uur)
- Gebruik Full voor periodiek onderhoud (dagelijks/wekelijks)
- Pas batch sizes aan als je timeouts ervaart
- Schakel reindex uit in productie - voer handmatig uit na sync
- Gebruik CLI voor grote imports - voorkomt browser timeouts
Meer Hulp Nodig?
Documentatie:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team