PIM Systems

Akeneo PIM systemet: videogennemgang, datamodel og API eksempler

Omfattende teknisk gennemgang af Akeneo PIM system, herunder datamodel, attributtyper, API-muligheder og implementeringsindsigter fra den virkelige verden.

Udgivet 15. januar 2025
18 min læsning
Sivert Kjøller Bertelsen
Akeneo
Open Source
PIM
Teknisk Gennemgang
API

Platform Oversigt

Akeneo er en fransk-grundlagt PIM-platform, der tilbyder både open-source og enterprise-løsninger. Grundlagt i 2013 og med hovedkontor i Nantes, Frankrig, har Akeneo bygget et stærkt udviklersamfund omkring sin GPL-v3 licensierede Community Edition.

Platformen centrerer sin datamodel omkring produkter og deres hierarki, mens den forbliver fleksibel gennem familier (skabeloner af attributsæt) og varianter. Denne tilgang giver en god balance mellem struktur og fleksibilitet for de fleste produktkataloger.

Nøglefakta

  • Grundlagt: 2013
  • Hovedkontor: Nantes, Frankrig
  • Medarbejdere: 200+
  • Licens: GPL-v3 (Community Edition)
  • API: REST-baseret med OAuth2 autentificering
Akeneo PIM login side interface

Akeneo Login Interface

Akeneo login interface viser det rene, moderne design, der strækker sig gennem hele platformen.

Akeneo Datamodel

Kerneentiteter i Akeneos datamodel med deres relationer og nøgleattributter

EntityVendor NameDescriptionKey AttributesRelationships
Produkt
ProductSalgbar SKU; kan være simpel (ingen varianter) eller variant (barn af en produktmodel)
identifier
family
categories
values
tilhører Familie
kategoriseret i Kategorier
barn af Produktmodel
Produktmodel
Product ModelRepræsenterer en stil/forælder i varianttræet; kan være to-niveauer (model > sub-model > produkt)
code
family_variant
categories
values
har Familievariant
forælder til Produkter
Familie
FamilySkabelon, der grupperer obligatoriske og valgfrie attributter for et produkt
code
attributes
attribute_requirements
indeholder Attributter
bruges af Produkter
Attribut
AttributeDefinerer en enkelt databit (tekst, nummer, boolean, mediefil, referencedata osv.)
code
type
localizable
scopable
grupperet i Attributgrupper
bruges i Familier
Kategori
CategoryKlassificerer produkter i hierarkier, der bruges af kanaler
code
parent
labels
hierarkisk struktur
bruges af Kanaler
Kanal
ChannelEn kombination af sprog, valutaer og kategorietræ, der repræsenterer en handelsdestination
code
locales
currencies
category_tree
bruger Kategorietræ
definerer scope for attributter

Ny til PIM systemer?

Før du dykker ned i Akeneo-specifikke detaljer, kunne du overveje at læse vores omfattende guide til PIM-systemer for at forstå det grundlæggende og nøglekoncepter.

Læs PIM Systemer Guide

Platform Demo & Interface

Se denne omfattende demo, der viser Akeneo PIM og dækker de grundlæggende brugeraktiviteter: finde produkter, berige produkter, merchandising af produkter og publicering af produkter. Optaget på Akeneo CE 6.0 i maj 2022.

"Jeg finder Akeneos UI meget brugervenligt. Interfacet centrerer sig omkring produktlisten, hvilket gør det let at forstå arven til varianter med denne visning. Produktlisten og arven arbejder problemfrit sammen, og hvis du kan tilpasse dette til din datamodel, performer den bemærkelsesværdigt godt."
SB
Sivert Kjøller Bertelsen
PIM Implementeringsekspert

API Implementeringsdetaljer

Autentificering & Sikkerhed

Akeneo bruger OAuth2 autentificering med både password grant og client credentials flows. Access tokens udløber efter 3600 sekunder (1 time), hvilket kræver refresh for langvarige integrationer. API'et understøtter både brugernavn/password autentificering til brugerspecifik adgang og client credentials til system-til-system integration.

Søgning & Filtrering

Søgekapabiliteter implementeres gennem JSON-baserede filterkriterier sendt i request bodies. Systemet understøtter avancerede operatorer per datatype (=, !=, IN, NOT IN, LIKE, NOT LIKE, STARTS WITH, <, <=, >, >=, BETWEEN, EMPTY, NOT EMPTY) og bruger search-after pagination til effektiv håndtering af store resultatsæt. Alle søgninger kan scopes af kanal og lokalitet.

Rate Limiting & Performance

SaaS deployments håndhæver rate limiting med X-Rate-Limit-Limit og X-Rate-Limit-Remaining headers til monitorering. For at undgå at ramme rate limits, implementer et caching mellemlag og undgå at hamre API'et med hurtige successive requests. Self-hosted installationer har ingen indbygget rate limiting. Bulk operationer understøtter flere elementer per PATCH request, med asynkrone job API'er tilgængelige til større imports og exports.

Webhooks & Event Handling

Akeneo giver ikke native webhook support. Integrationsmønstre er afhængige af polling af API'et eller brug af Event Platform (Enterprise Edition) som streamer produktændringsevents til realtidssynkronisering med eksterne systemer.

Dokumentationskvalitet

API dokumentationen på api.akeneo.com er omfattende og udviklervenlig, med interaktive eksempler, kodeeksempler i flere programmeringssprog, detaljerede endpoint beskrivelser og klar fejlrespons dokumentation. En officiel PHP SDK vedligeholdes, med community SDK'er tilgængelige for andre sprog.

Akeneo API dokumentations interface der viser REST endpoints og eksempler

Akeneo API Dokumentation

Akeneos API dokumentation er omfattende og velorganiseret, og giver klare eksempler og endpoint beskrivelser med interaktive testmuligheder.

API Brugseksempel

Eksempel der viser hvordan man søger efter og opdaterer et produkt ved hjælp af Akeneo REST API

bash
# Find et produkt med SKU og opdater attribut ved hjælp af Akeneo API
TOKEN="<client_token>"
BASE="https://demo.akeneo.com/api/rest/v1"

# søg produkt
curl -s -H "Authorization: Bearer $TOKEN" "$BASE/products?search={\"identifier\":[{\"operator\":\"=\",\"value\":\"SKU-12345\"}]}" > product.json

# opdater navn
PRODUCT_CODE=$(jq -r '._embedded.items[0].identifier' product.json)
cat > patch.json <<EOF
{"name": {"en_US": "Nyt produktnavn 2025"}}
EOF
curl -X PATCH -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
     -d @patch.json "$BASE/products/$PRODUCT_CODE"
"Efter at have migreret til og fra Akeneo flere gange, finder jeg API'et intuitivt, selvom produktstrukturer og attribut-ID'er kan være komplekse. Jeg gemmer typisk feltmappinger som beskrivelser af attributtyper, da der ikke eksisterer noget koncept af attributindstillinger i standardinterfacet."
SB
Sivert Kjøller Bertelsen
PIM Implementeringsekspert

Tekniske Specifikationer

Brugerdefineret Entitet Support

Akeneo understøtter brugerdefinerede entiteter gennem Reference Entities (Enterprise Edition), men disse er andenrangsborgere med begrænsede kapabiliteter sammenlignet med Produkter. Reference Entities mangler workflow, fuldstændighedsscore og avancerede valideringsfunktioner tilgængelige for Produkter.

Søgekapabiliteter

REST API'et understøtter omfattende søgning med operatorer inklusive =, !=, IN, NOT IN, LIKE, NOT LIKE, STARTS WITH, <, <=, >, >=, BETWEEN, EMPTY og NOT EMPTY. Search after pagination understøttes for store resultatsæt.

Bulk Operationer

PATCH liste endpoints tillader upsert af op til 100 ressourcer per kald. Asynkrone exports/imports udløses via /api/rest/v1/jobs endpoints for større operationer.

Data Opbevaring

Akeneo gemmer attributværdier som JSON blobs nøglet af attributkode, scope (kanal) og lokalitet. Indeksering håndteres automatisk bag kulisserne, med den primære overvejelse værende hvilke attributter der skal konfigureres som identifier typer.

Begrænsninger & Implementeringsovervejelser

Community Edition Begrænsninger

Community Edition mangler kritiske enterprise funktioner inklusive read-only felter, events funktionalitet og avancerede workflow kapabiliteter. Billedkonfiguration kan være udfordrende og kræver ofte en separat MySQL instans, hvilket gør den egnet kun for virksomheder med betydelige tekniske ressourcer.

Reference Entities som Andenrangsborgere

Reference Entities (Enterprise Edition) har begrænsede kapabiliteter sammenlignet med Produkter, mangler workflow, fuldstændighedsscore og avancerede valideringsfunktioner. Dette skaber inkonsistenser i dataadministrationstilgange på tværs af entitetstyper.

Asset Management Begrænsninger

Indbygget asset management er grundlæggende sammenlignet med dedikerede DAM løsninger. Organisationer med omfattende digitale asset krav har typisk brug for ekstern DAM integration, hvilket tilføjer kompleksitet og omkostninger til den samlede løsning.

Artikel Liste Modelleringsudfordringer

For virksomheder der arbejder med artikellister præsenterer Akeneos Familie-baserede model udfordringer, da attributter bestemmes af Familie hierarki. Når artikellister spænder over flere familier, mapper de ikke direkte til flade strukturer som Excel tabeller.

API Rate Limiting

SaaS deployments håndhæver rate limiting der kan påvirke høj-volumen integrationer. Self-hosted installationer kræver omhyggelig performance tuning og infrastruktur administration for at håndtere store kataloger effektivt.

Deployment Kompleksitet

Self-hosted installationer kræver PHP ekspertise og løbende vedligeholdelse. For kommercielle overvejelser og deployment strategier, se vores omfattende SaaS forhandlingsguide.

Nøglefordele & Styrker

Stærk Nedarvningsmodel med Simpelt UI

Akeneos Familie og Familie Variant system giver kraftfulde arvekapabiliteter mens det opretholder et intuitivt brugerinterface. Produktmodeller kan arve attributter ned til variantprodukter, hvilket reducerer dataindtastning og sikrer konsistens på tværs af produktlinjer.

Open Source Fundament med Begrænsninger

Den GPL-v3 licenserede Community Edition giver kerne-PIM funktionalitet uden licensomkostninger, inklusive den komplette datamodel, REST API og grundlæggende funktioner. Community Edition mangler dog avancerede funktioner som read-only attributter og events, hvilket gør den tilgængelig for virksomheder med tekniske ressourcer men med nogle funktionelle begrænsninger.

Fleksibel Data Arkitektur

Den attributbaserede datamodel med Familier tillader meget fleksible produktstrukturer. Produkter kan have forskellige attributsæt mens de opretholder konsistens inden for produktfamilier, hvilket understøtter diverse katalogkrav.

Artikel Liste Modelleringsudfordringer

For virksomheder der arbejder med artikellister kan Akeneos model præsentere udfordringer, da attributter på en artikel bestemmes af Familie hierarkiet. Når en liste af artikler til et tilbud spænder over flere familier, mapper det ikke direkte til flade strukturer som Excel tabeller, hvilket kræver omhyggelig datamodellering overvejelse.

Udviklervenligt API

REST API'et er omfattende og veldokumenteret, med support til komplekse søgeoperationer, bulk opdateringer og detaljeret fejlhåndtering. API-first tilgangen muliggør sømløse integrationer med eksterne systemer.

Lokalisering & Kanal Support

Indbygget support til flere lokaliteter og kanaler tillader globale virksomheder at håndtere produktinformation på tværs af forskellige markeder og salgskanaler fra en enkelt platform.

Aktivt Fællesskab & Dokumentation

Stærkt udviklerfællesskab med omfattende dokumentation, GitHub repository med aktiv udvikling og omfattende API reference materialer understøtter implementation og tilpasningsindsatser.

Sivert Kjøller Bertelsen

Sivert Kjøller Bertelsen

PIM Implementeringskonsulent • Flere Akeneo implementeringer

"Akeneo rammer en fremragende balance mellem funktionalitet og brugervenlighed. Det produktcentrerede UI design gør det intuitivt for forretningsbrugere, mens det robuste API understøtter komplekse integrationsscenarier. Open-source fundamentet giver enorm værdi, selvom enterprise funktioner er påkrævet for read-only felter og web hooks. For organisationer med tekniske ressourcer tilbyder Akeneo en overbevisende PIM løsning."

Verificeret implementeringserfaringJanuar 2025

Kilder (3)

[1]
Akeneo Official Website
Akeneo(2025)Hjemmeside
[2]
Akeneo PIM Documentation
Akeneo(2025)Dokumentation
[3]
Akeneo REST API Reference
Akeneo(2025)API Dokumentation

Relaterede Artikler

En komplet, trin-for-trin guide til installation af Akeneo Community Edition 5 med Docker og MySQL. Denne vejledning forklarer hver konfigurationsfil og kommando, perfekt for begyndere der vil opsætte deres eget PIM.

Akeneo
Docker
PIM
Læs Artikel

Komplet guide til Product Information Management systemer. Lær hvad PIM er, hvordan det fungerer, vigtige fordele, og hvordan du vælger det rigtige PIM-system til din virksomhed.

PIM
Produktinformation
Guide
Læs Artikel

Mit syn på sammenligning af inriver, akeneo, salsify, pimcore, struct, bluestone, syndigo - inklusive datamodeller, attributtyper, brugerdefineret entitetssupport og API-kapabiliteter. Systemanalyse baseret på min erfaring og leverandørdokumentation.

PIM
Sammenligning
Datamodel
Læs Artikel

Praktisk guide til PIM system udvælgelse med fokus på datamodel test, attribut krav og leverandør-neutral evaluering.

PIM
Udvælgelse
Guide
Læs Artikel