Sync Proces voor KatanaPIM Connect
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