Das vollständige Schema finden Sie unter items_in_v1_1.xsd.

Im folgenden gehen wir auf die wichtigsten Elemente des Schemas ein. Beim Lesen hilft es sich die untenstehende Beispieldatei vor Augen zu halten.

Dieses Element ist das Wurzelement und taucht genau einmal in einem items_in-Job auf. Es enthält wiederum ein oder mehrere Item-Elemente.

Innerhalb einer Artikelliste müssen die Attribute ItemNo und VariantNo eindeutig („unique“) sein. Es darf also kein Artikel doppelt in der Liste vorkommen und auch kein Artikelnummer bei einer Variante erneut auftauchen.

Werte der ExecutionLevel Bitmask

• 0 : Führen eines detaillierten Debug-Logs. Wird derzeit imm er gemacht und kann nicht abgeschaltet werden.
• 1 : Daten in die Schnittstellentabellen einfügen
• 2 : Aufruf der Importprozedur (im_ImportItemData_Ad)
• 4 : Aufruf einer individuellen Prozedur nach der Importprozedur¹⁾

Dieses Element dient der Übergabe eines Artikels inkl. Eigenschaften sowie eventueller Artikelvarianten samt deren Eigenschaften.

Eine spezielle Eigenschaft (im „Property“-Element, s.u.), die - sofern der Artikel Varianten hat - unbedingt zum Artikel übergeben werden muss, ist die Property „Variantenmerkmale“. Das dStore-Merkmal „VariantenMerkmale“ (ID=17) ist zum Artikel hinterlegt und besagt, durch welches Merkmal sich die Varianten des Artikels unterscheiden. Es handelt sich um eine mit dem Trenner „¶“ getrennte Liste von CharacteristicIDs.

Hier die möglichen Werte für den „ItemStatus“:

Dieses Element dient der Übergabe von Artikelvarianten eines Artikels, sowie deren Eigenschaften.

Properties müssen nicht übergeben werden. Dies ist z.B. sinnvoll, wenn eine Variante entfernt werden soll.

Hier die möglichen Werte für den „VariantStatus“:

Dieses Element dient dem Import von Eigenschaften zu Artikeln und Artikelvarianten.

Damit die Property importiert werden kann, muss über ein Mapping eine Zuordung zu einem dStore-Merkmal konfiguriert sein. Die Einrichtung des Mappings geschieht über ApplicationSettings und ist in items_in_configuration beschrieben.

Merkmale zu denen kein Mapping existiert werden ignoriert ohne das es zu einem Fehler kommt.

Das Merkmal „Produktbezeichnung (DE)“ (ID=7) sollte für den Artikel und die Variante mit einer für den Endkunden lesbaren Artikel(kurz)bezeichnung gefüllt sein (z.B. „T-Shirt Fancy“). Für die Variante sollte dort an den für den Artikel übergebenen Wert die Größe bzw. Länge angehängt sein (z.B.„ T-Shirt Fancy schwarz / XL“). Diese Beschreibung wird dann z.B. im Warenkorb oder in Status-Mails verwendet.

items_in_sample_FullList.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!--Revision: $Revision: 8971 $ - xml_SmartGate-->
<!-- Dies ist eine vollständige Artikelliste (FullList). Das bedeutet, alles was nicht
    in dieser Liste ist wird im Artikelstamm deaktiviert. -->
<ListOfItems xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://resources.dstore.de/xsd/xml_SmartGate/items_in_v1_1.xsd"
    ListType="FullList"
    CreationDate="1183721060">
    <Item ItemNo="123456" UniqueCategoryName="m1200" ItemDescription="Example Product ABC" ItemStatus="New">  
        <!-- Zuerst die Eigenschaften des Artikels -->
        <Property Characteristic="Bezeichnung">Example Product ABC</Property>
        <Property Characteristic="Artikelbeschreibung" LongText="yes"><![CDATA[Dies ist
ein <B>längerer</B> Text
über mehrere
Zeilen.]]></Property>
        <!-- Hier werden die CharacteristicIDs des dStore angegeben, aus denen die Varianten
            dieses Artikels bestehen (¶-Trenner separierte Liste) -->
        <Property Characteristic="Variantenmerkmale">16¶18</Property>
        <!-- Jetzt kommen die Varianten des Artikels -->
        <Variant VariantNo="12345-612" VariantDescription="S / black" VariantStatus="New">
            <!-- Jetzt die Eigenschaften der ersten Variante -->
            <Property Characteristic="Bezeichnung">Example Product ABC S / black</Property>
            <Property Characteristic="Groesse">S</Property>
            <Property Characteristic="Farbe">black</Property>
            <Property Characteristic="Verfuegbarkeit">Lieferbar</Property>
            <Property Characteristic="Gesamtbestand">19</Property>
            <Property Characteristic="VK_Preis">12.00</Property>
        </Variant>      
        <Variant VariantNo="12345-613" VariantDescription="L / black" VariantStatus="New">
            <!-- Jetzt die Eigenschaften der zweiten Variante -->
            <Property Characteristic="Bezeichnung">Example Product ABC L / black</Property>
            <Property Characteristic="Groesse">L</Property>
            <Property Characteristic="Farbe">black</Property>
            <Property Characteristic="Verfuegbarkeit">Nicht lieferbar</Property>
            <Property Characteristic="Gesamtbestand">0</Property>
            <Property Characteristic="VK_Preis">12.30</Property>
        </Variant>
    </Item>
    <!-- Dieser Artikel hat keine Varianten -->
    <Item ItemNo="123123" UniqueCategoryName="m1202" ItemDescription="Example Product Blubb" ItemStatus="New">  
        <Property Characteristic="Bezeichnung">Example Product Blubb</Property>
        <Property Characteristic="Artikelbeschreibung" LongText="yes"><![CDATA[Dies ist
ein <B>längerer</B> Text
über mehrere
Zeilen.]]></Property>
        <Property Characteristic="Verfuegbarkeit">Lieferbar</Property>
        <Property Characteristic="Gesamtbestand">12</Property>
        <Property Characteristic="VK_Preis">14.30</Property>
     </Item>
</ListOfItems>