Struktura i jej opis

Plik parameters.xml ma drzewiastą strukturę i prezentuje wszystkie sekcje oraz parametry i ich wartości wraz z wielojęzycznymi tłumaczeniami ich nazw, opisów i grafik, jakie mogą wystąpić w ofercie. Plik składa się z trzech niezależnych list:

<sections> – zawierającej wszystkie wizualne sekcje, które mogą służyć do grupowania kolejnych parametrów przypisanych to oferowanych towarów,
<parameters> – zawierającej wszystkie parametry przypisane do oferowanych towarów,
<values> – zawierającej wszystkie wartości parametrów przypisanych do oferowanych towarów.

Każda sekcja (węzeł: <section>), parametr (węzeł: <parameter>) czy jego wartość (węzeł: <value>) posiada swój wymagany i unikalny identyfikator (atrybut @id) oraz nazwę (atrybut @name). Dodatkowo parametry i ich wartości mogą mieć zwrócone grafiki wyświetlana na liście (węzeł: <icons><list>) bądź kartach towarów (węzeł: <icons><card>) oraz dodatkowy opis (węzeł: <description>).

Funkcja wielojęzyczna dostępna jest dla każdego atrybutu @name oraz węzłów <description>, <icons><list> i <icons><card>.

Changelog:

IOF 3.0

brak zmian w stosunku do poprzedniej wersji formatu

Przykładowa struktura pliku XML:

<?xml version="1.0" encoding="UTF-8"?>
<parameters file_format="IOF" version="3.0" generated_by="IdoSell" language="pol" generated="2022-02-26 05:11:43" expires="2022-02-27 05:11:43">
    <sections>
        <parameter type="section" id="117" name="Sekcja parametrów 1 ">
            <name xml:lang="eng">
                <![CDATA[Parameter section 1]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[Sekcja parametrów 1 ]]>
            </name>
            <description xml:lang="eng">
                <![CDATA[<p class="old_wiki"><span>Sekcja parametrów 1 (eng) - opis</span></p>]]>
            </description>
            <description xml:lang="pol">
                <![CDATA[<p class="old_wiki"><span>Sekcja parametrów 1 (pol) - opis</span></p>]]>
            </description>
        </parameter>
        <parameter type="section" id="228" name="Sekcja parametrów 2">
            <name xml:lang="eng">
                <![CDATA[Parameter section 2]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[Sekcja parametrów 2]]>
            </name>
            <description xml:lang="eng">
                <![CDATA[<p class="old_wiki"><span>Sekcja parametrów 2 (eng) - </span><span>opis</span></p>]]>
            </description>
            <description xml:lang="pol">
                <![CDATA[<p class="old_wiki">Sekcja parametrów 2 (pol) - opis</p>]]>
            </description>
        </parameter>
    </sections>
    <parameters>
        <parameter type="parameter" id="128" name="Kolor">
            <name xml:lang="eng">
                <![CDATA[Color]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[Kolor]]>
            </name>
            <description xml:lang="pol">
                <![CDATA[Informacja o użytych kolorach]]>
            </description>
            <description xml:lang="eng">
                <![CDATA[Information about used colors]]>
            </description>
            <icons>
                <card xml:lang="pol" url="https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png"/>
                <card xml:lang="eng" url="https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png"/>
                <list xml:lang="pol" url="https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png"/>
                <list xml:lang="eng" url="https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png"/>
            </icons>
        </parameter>
        <parameter type="parameter" id="152" name="Model">
            <name xml:lang="eng">
                <![CDATA[Model]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[Model]]>
            </name>
            <description xml:lang="eng">
                <![CDATA[<p class="old_wiki"><span>Model (eng) - opis</span></p>]]>
            </description>
            <description xml:lang="pol">
                <![CDATA[<p class="old_wiki">Model (pol) - opis</p>]]>
            </description>
        </parameter>
        <parameter type="parameter" id="238" name="Materiał">
            <name xml:lang="eng">
                <![CDATA[Material]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[Materiał]]>
            </name>
            <description xml:lang="pol">
                <![CDATA[główny materiał wykonania]]>
            </description>
        </parameter>
    </parameters>
    <values>
        <value id="239" name="bawełna">
            <name xml:lang="eng">
                <![CDATA[cotton]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[bawełna]]>
            </name>
            <description xml:lang="pol">
                <![CDATA[Bawełna jest materiałem szybkoschnącym, przewiewnym i łatwym w praniu]]>
            </description>
            <description xml:lang="eng">
                <![CDATA[Cotton is a fast drying, breathable and easy to wash material]]>
            </description>
            <icons>
                <card xml:lang="pol" url="https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png"/>
                <card xml:lang="eng" url="https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png"/>
                <list xml:lang="pol" url="https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png"/>
                <list xml:lang="eng" url="https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png"/>
            </icons>
        </value>
        <value id="241" name="poliester">
            <name xml:lang="eng">
                <![CDATA[polyester]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[poliester]]>
            </name>
        </value>
        <value id="332" name="GHM 2022">
            <name xml:lang="eng">
                <![CDATA[GHM 2022]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[GHM 2022]]>
            </name>
        </value>
        <value id="333" name="GHK 1999">
            <name xml:lang="eng">
                <![CDATA[GHK 1999]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[GHK 1999]]>
            </name>
        </value>
        <value id="355" name="niebieski">
            <name xml:lang="eng">
                <![CDATA[blue]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[niebieski]]>
            </name>
        </value>
        <value id="356" name="żółty">
            <name xml:lang="eng">
                <![CDATA[yellow]]>
            </name>
            <name xml:lang="pol">
                <![CDATA[żółty]]>
            </name>
        </value>
    </values>
</parameters>

Zależności między danymi:

parameters.sections.section@id jest ściśle powiązany z product.parameters.parameter@id z atrybutem @type = "section" w pliku full.xml oraz full_change.xml,
parameters.sections.section@name jest ściśle powiązany z product.parameters.parameter@name z atrybutem @type = "section" w pliku full.xml oraz full_change.xml,
parameters.parameters.parameter@id jest ściśle powiązany z product.parameters.parameter@id z atrybutem @type = "parameter" w pliku full.xml oraz full_change.xml,
parameters.parameters.parameter@name jest ściśle powiązany z product.parameters.parameter@name z atrybutem @type = "parameter" w pliku full.xml oraz full_change.xml,
parameters.values.value@id jest ściśle powiązany z product.parameters.parameter@type="parameter".value@id w pliku full.xml oraz full_change.xml,
parameters.values.value@name jest ściśle powiązany z product.parameters.parameter@type="parameter".value@name w pliku full.xml oraz full_change.xml.

Pliki do pobrania

Pobierz przykład pliku XML parameters
Pobierz walidator schematu XSD parameters