KatanaPIM Attributen Overzicht in Magento 2
Hoe KatanaPIM attributen te mappen naar Magento attributen in KatanaPIM Connect. Correcte attribuut mapping is essentieel voor correcte product data synchronisatie.
Overzicht
Attribuut mapping verbindt PIM attributen met Magento attributen. Er zijn twee niveaus van mapping:
- Kern veld mapping - In configuratie (Naam, Beschrijving, GTIN, etc.)
- Custom attribuut mapping - In de Attributen grid (inline bewerking)
Kern Veld Mapping
Configureer in Stores → Configuration → Katana PIM → Product Data → Attributes.
Deze mappen KatanaPIM attributen naar Magento's ingebouwde productvelden:
| Magento Veld | Wat te Mappen |
|---|---|
| Name | Product titel attribuut uit PIM |
| Short Description | Korte productbeschrijving |
| Description | Volledige productbeschrijving (kan HTML zijn) |
| GTIN | EAN/UPC/ISBN barcode |
| MPN | Manufacturer Part Number |
| Meta Title | SEO paginatitel |
| Meta Description | SEO meta beschrijving |
| Meta Keywords | SEO keywords |
| Attachments | Product documenten/PDFs |
Selecteer het corresponderende KatanaPIM attribuut uit de dropdown voor elk veld.
Custom Attribuut Mapping
Voor alle andere attributen, gebruik de Attributen grid op Katana PIM → Attributes.
Stap 1: Importeer Attributen
- Ga naar Katana PIM → Attributes
- Klik op de Import Attributes knop
- Wacht tot alle PIM attributen zijn geïmporteerd
- De grid toont alle beschikbare KatanaPIM attributen
Stap 2: Map Attributen via Inline Edit
Voor elk attribuut dat je wilt synchroniseren:
- Zoek het attribuut in de grid
- Klik op de Magento Attribute Code cel
- Selecteer een bestaand Magento attribuut OF selecteer "Create New"
- Klik ergens anders om op te slaan
Stap 3: Stel Configureerbare Attributen In
Voor attributen gebruikt in configureerbare producten (zoals Maat, Kleur):
- Zoek het attribuut in de grid
- Klik op de Is Configurable cel
- Zet op Yes
- Klik ergens anders om op te slaan
Configureerbare attributen moeten worden ingesteld voordat configureerbare producten worden aangemaakt.
Stap 4: Skip Ongewenste Attributen
Voor attributen die je niet wilt synchroniseren:
- Selecteer de attributen via checkboxes
- Gebruik massa-actie Mark Attributes as Skipped
Attribuut Types
De module handelt verschillende PIM attribuut types af:
| PIM Type | Magento Type |
|---|---|
| Text | Text Field |
| Textarea | Text Area |
| Select | Dropdown |
| Multiselect | Multiple Select |
| Boolean | Yes/No |
| Date | Date |
| Price | Price |
Bij het aanmaken van nieuwe Magento attributen wordt het correcte type automatisch bepaald.
Automatisch Aangemaakte Attributen
Wanneer je "Create New" selecteert in de mapping, maakt de module een nieuw Magento attribuut aan:
- Attribuutcode:
katanapim_+ originele code - Label: Van PIM attribuutnaam
- Type: Gebaseerd op PIM attribuuttype
- Scope: Global
- Zichtbaar op frontend: Nee (kan later worden gewijzigd)
Je kunt deze attributen wijzigen in Stores → Attributes → Product na aanmaak.
Mappen naar Bestaande Attributen
Om te mappen naar een bestaand Magento attribuut:
- Het attribuut moet eerst bestaan in Magento
- Selecteer het uit de dropdown in de Attributen grid
- Zorg dat attribuuttypes compatibel zijn
Veelvoorkomende bestaande attributen:
brand- Voor fabrikant/merkcolor- Voor kleurvariantensize- Voor maatvariantenweight- Voor verzendgewichtmanufacturer- Voor fabrikantnaam
Attribuut Sets
Geïmporteerde producten gebruiken de Default attribuutset. Om custom attribuutsets te gebruiken:
- Maak attribuutsets aan in Stores → Attribute Sets
- Voeg je gemapte attributen toe aan de sets
- Producten erven attributen van hun toegewezen set
Best Practices
Do's:
- ✅ Map alle essentiële attributen vóór eerste product sync
- ✅ Stel "Is Configurable" vroeg in voor variant-attributen
- ✅ Gebruik bestaande Magento attributen waar mogelijk
- ✅ Skip attributen die je niet nodig hebt om sync tijd te verminderen
- ✅ Review attribuut mapping na PIM wijzigingen
Don'ts:
- ❌ Wijzig mappings nadat producten zijn aangemaakt (veroorzaakt data problemen)
- ❌ Map meerdere PIM attributen naar hetzelfde Magento attribuut
- ❌ Vergeet de configurable vlag voor variant-attributen niet
- ❌ Maak geen dubbele Magento attributen aan
Troubleshooting Mapping Problemen
Attribuut verschijnt niet in dropdown
- Voer Import Attributes uit om de lijst te verversen
- Controleer of het attribuut bestaat in je PIM channel
- Verifieer dat API verbinding werkt
Attribuutwaarden synchroniseren niet
- Bevestig dat het attribuut is gemapped (niet ingesteld op "-- Not Mapped --")
- Controleer of het attribuut is gemarkeerd als "Skipped"
- Verifieer dat het PIM product een waarde heeft voor dat attribuut
- Voor select attributen, zorg dat optiewaarden overeenkomen
Configureerbare producten worden niet aangemaakt
- Verifieer dat "Is Configurable" op Yes staat voor variant-attributen
- Zorg dat ouder/kind relaties bestaan in PIM
- Controleer de Sync Log voor specifieke fouten
Meer Hulp Nodig?
Documentatie:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team