Export Eulanda Article to Shopify
Zuletzt geändert: 14.03.2026 05:56

Export-EulandaArticleToShopify #

ÜBERSICHT #

Exportiert EULANDA-Artikel als Shopify-Produkte (inkl. Bilder aus DMS).

SYNTAX #

Export-EulandaArticleToShopify [-Shop] <string> [-Token] <string> [-ApiVersion] <string> [[-Udl]
    <string>] [[-ArticleNo] <string[]>] [[-BreadcrumbPath] <string[]>] [[-BreadcrumbRoot] <string>]
    [-SyncCollections] [[-ImageFormats] <string[]>] [[-ImageCachePath] <string>] [-SkipImages]
    [[-AdoptExisting] <bool>] [-UseShopExportDate] [-SetShopExportDate] [<CommonParameters>]

BESCHREIBUNG #

Orchestrierungsfunktion, die für eine oder mehrere Artikelnummern folgende Schritte ausführt:

  1. Artikel per Export-ArticleXml aus EULANDA exportieren
  2. XML parsen und Felder mappen (ARTNUMMER -> SKU, IDENT -> title, LANGTEXT -> body_html, VKBRUTTO -> price, GEWICHT -> weight, GTIN -> barcode)
  3. Produkt in Shopify anlegen oder aktualisieren (Set-ShopifyProduct)
  4. Bilder aus DMS laden und hochladen (Set-ShopifyProductImage)

Die DMS-Bilddateien werden pro Artikel über Get-DmsFolderArticle ermittelt und mit der Namenskonvention {ArtNr}-1.{Format}, {ArtNr}-2.{Format} etc. gesucht. Die Suchreihenfolge der Bildformate ist über -ImageFormats konfigurierbar.

Optional können Artikel statt über -ArticleNo auch über -BreadcrumbPath per Merkmalbaum-Pfad selektiert werden. Mit -SyncCollections werden die Merkmalbaum-Zuordnungen als Shopify Custom Collections angelegt und die Produkte den passenden Collections zugewiesen.

Collection-Mechanismus: Der EULANDA-Merkmalbaum wird flach unter einem Hauptmerkmal (z.B. ‘\Shop’) angelegt. Jeder Knoten direkt darunter wird eine eigene Shopify Custom Collection. Shopify unterstützt keine hierarchischen Collections. Der Sonderfall ‘Startseite’ erhält das Handle ‘frontpage’ (Shopify Featured Collection für die Homepage). Die Storefront-Navigation (Menüs) muss einmalig manuell im Shopify-Admin eingerichtet werden (Inhalte > Menüs > Hauptmenü).

PARAMETER #

-Shop #

Type: string

Shopify-Shop-Domain, z.B. ‘mein-shop.myshopify.com’.

-Token #

Type: string

Admin API Access Token (shpat_…) der Custom App.

-ApiVersion #

Type: string

API-Version, z.B. ‘2025-01’.

-Conn #

Geöffnete ADO-Connection zur EULANDA-Datenbank.

-Udl #

Type: string

Alternativ: Pfad zur UDL-Datei. Wird verwendet, wenn kein Conn übergeben wird.

-ArticleNo #

Type: string[]

Eine oder mehrere Artikelnummern (ArtNummer), die exportiert werden sollen. Optional, wenn -BreadcrumbPath angegeben ist.

-BreadcrumbPath #

Type: string[]

Ein oder mehrere Merkmalbaum-Pfade zur Artikel-Selektion, z.B. ‘\Shop’. Alle Artikel unter den angegebenen Pfaden werden exportiert. Alternative zu -ArticleNo.

-BreadcrumbRoot #

Type: string
Default: '\Shop'

Wurzel-Knoten für den Breadcrumb-Export im XML. Standard: ‘\Shop’.

-SyncCollections #

Type: switch

Wenn gesetzt, werden Merkmalbaum-Zuordnungen als Shopify Custom Collections angelegt und Produkte den passenden Collections zugewiesen.

-ImageFormats #

Type: string[]
Default: @('jpg'

Reihenfolge der Bildformate für die DMS-Suche. Das erste gefundene Format wird verwendet. Standard: @(‘jpg’, ‘png’) — JPEG hat Priorität, PNG als Fallback.

-AdoptExisting #

Type: bool
Default: $true

Wenn gesetzt, werden bestehende Shopify-Produkte ohne eulanda.source-Metafield übernommen (aktualisiert und markiert). Ohne diesen Switch werden fremde Produkte (ohne eulanda.source-Metafield) übersprungen. Standard: aktiviert (abwärtskompatibel).

-ImageCachePath #

Type: string

Pfad zur JSON-Cache-Datei für hash-basierte Bildsynchronisation. Wenn angegeben, werden nur geänderte/neue Bilder hochgeladen und im DMS gelöschte Bilder aus Shopify entfernt (Smart-Sync). Wenn leer, werden alle Bilder bei jedem Lauf hochgeladen (bisheriges Verhalten).

-SkipImages #

Type: switch

Wenn gesetzt, werden keine Bilder hochgeladen.

AUSGABEN #

pscustomobject[]

BEISPIELE #

# Drei Artikel exportieren
Export-EulandaArticleToShopify -Shop 'mein-shop.myshopify.com' `
  -Token 'shpat_abc123' -ApiVersion '2025-01' `
  -Udl 'C:\EulandaXtools\Eulanda_1.udl' `
  -ArticleNo @('1100', '2100', '3100')

# Einzelner Artikel ohne Bilder
Export-EulandaArticleToShopify -Shop $shop -Token $token `
  -ApiVersion '2025-01' -Conn $conn -ArticleNo '1100' -SkipImages

# Alle Artikel unter \Shop per Breadcrumb mit Collection-Sync
Export-EulandaArticleToShopify -Shop $shop -Token $token `
  -ApiVersion '2025-01' -Conn $conn `
  -BreadcrumbPath @('\Shop') -SyncCollections

# PNG bevorzugt statt JPEG
Export-EulandaArticleToShopify -Shop $shop -Token $token `
  -ApiVersion '2025-01' -Conn $conn -ArticleNo '1100' `
  -ImageFormats @('png', 'jpg')