Într-unul dintre proiectele noastre, crearea site-ului Bitrix a fost sarcina de a descărca catalogul de mărfuri într-un sistem de management nu din 1C, ci dintr-un program de contabilitate rară. Acest program ar putea genera xml-fișiere cu orice structură necesară. Prin urmare, pentru descărcarea în Bitrix, sa decis crearea unui fișier în formatul CommerceML 2.021, pe care standardul Bitrix îl introduce în blocul de informații.
Acest articol va descrie în detaliu structura fișierului descărcat și a nodurilor sale. Descrierea este incompletă, dar este suficientă pentru aproape orice proiect de creare a unui magazin online. În special, vor fi luate în considerare numai proprietăți precum LINE, NUMBER și LIST, precum și mai multe proprietăți.
Structura generală a dosarului
DateForming este completat în format YYYY-MM-DDTCH: mm: SS,
unde r este anul,
M-luni,
D este ziua,
T este un separator,
H - ore,
m - minute,
C este secunde.
<Ид>573cd49a-339f-4596-9526-dae569251cd4 - identificatorul directorului, este generat la întâmplare o dată și apoi folosit pentru fiecare încărcare. Puteți utiliza identificatorul prezentat în acest exemplu.
Acest nod descrie toate proprietățile bunurilor.
La începutul nodului, sunt afișate proprietățile serviciului:
CML2_ACTIVE - activitatea produsului, proprietatea serviciului, ia valori adevărate sau false.
CML2_SORT este un câmp numeric care poate fi utilizat pentru sortarea mărfurilor. De exemplu, dacă produsul 1 are această valoare de 30 și produsul 2 are o valoare de 10, atunci sunt afișate mai întâi mărfurile 2, apoi elementul 1.
CML2_ACTIVE_FROM, CML2_ACTIVE_TO - câmpurile de serviciu, de regulă, nu se aplică bunurilor din magazinul online.
CML2_PREVIEW_TEXT - câmpul pentru o scurtă descriere a mărfurilor
CML2_DETAIL_TEXT - câmp pentru descrierea detaliată a produsului. Mai multe detalii vor fi descrise în nodul "Pachetul de Oferte".
CML2_PREVIEW_PICTURE - o fotografie mică a mărfurilor, este afișată în paginile grupurilor de produse.
CML2_PICTURES - fotografii suplimentare ale mărfurilor. Imaginea principală a produsului este prezentată în descrierea produsului, așa cum va fi discutată ulterior.
META_TITLE, META_KEYWORDS, META_DESCRIPTION - proprietăți pentru SEO (titlul ferestrei browserului, cuvinte cheie și descriere).
Toate proprietățile de serviciu trebuie luate ca atare și plasate la începutul nodului Proprietăți.
Apoi, nodul descrie proprietățile personalizate.
Principalele tipuri de proprietăți sunt:
Proprietate de tip STRING
<Ид>CML2_ARTICLE - un identificator de proprietate, o valoare unică arbitrară.
Caractere valide: numere, caractere latine, subliniere, liniuțe. Înregistrează-te.
<Наименование>articol - Numele proprietății este afișat pe cartea produsului.
Caractere valide: orice. Înregistrează-te.
<Множественное>fals - parametrul specifică faptul că proprietatea poate avea mai multe valori. Vedeți exemplele din proprietatea OFERTE.
<БитриксСортировка>500 - ordinea poziției proprietății în filtru (dacă proprietatea este afișată în filtru).
<БитриксКод>CML2_ARTICLE - caracterele caracterului proprietății sunt egale cu valoarea nodului <ИД>.
<БитриксТипСвойства>S - tipul de proprietate, în acest exemplu este un șir S.
Toate celelalte noduri trebuie luate ca atare.
Proprietate de tip Numar
<Ид>SHIRINA_SHKAFA - un identificator de proprietate, o valoare unică arbitrară.
Caractere valide: numere, caractere latine, subliniere, liniuțe. Înregistrează-te.
<Наименование>Lățimea dulapului, mm - Numele proprietății este afișat pe cartea produsului.
Caractere valide: orice. Înregistrează-te.
<Множественное>fals - parametrul specifică faptul că proprietatea poate avea mai multe valori.
<БитриксСортировка>500 - ordinea poziției proprietății în filtru (dacă proprietatea este afișată în filtru).
<БитриксКод>SHIRINA_SHKAFA - caracterele caracterului proprietății sunt egale cu valoarea nodului <ИД>.
<БитриксТипСвойства>N - tipul de proprietate, în acest exemplu este un număr N.
Toate celelalte noduri trebuie luate ca atare.
Afișați proprietatea
<Ид>CML2_MANUFACTURER - un identificator de proprietate, o valoare unică arbitrară.
Caractere valide: numere, caractere latine, subliniere, liniuțe. Înregistrează-te.
<Наименование>producător - Numele proprietății este afișat pe cartea produsului.
Caractere valide: orice. Înregistrează-te.
<Множественное>fals - parametrul specifică faptul că proprietatea poate avea mai multe valori. Vedeți exemplele din proprietatea OFERTE.
<БитриксКод>CML2_MANUFACTURER - caracterele caracterului proprietății sunt egale cu valoarea nodului <ИД>.
<БитриксТипСвойства>L - tipul de proprietate, în acest exemplu este o listă L.
<БитриксСортировка>500 - ordinea poziției proprietății în filtru (dacă proprietatea este afișată în filtru).
Toate celelalte noduri trebuie luate ca atare.
Nod Opțiuni Valori proprietate de tip Listă
O proprietate de tip LIST conține valori predefinite în nod <ВариантыЗначений>. Fiecare valoare este stocată în nodul său <Вариант> în interiorul nodului <ВариантыЗначений>.
<Ид>de brand-1 - identificatorul valorii proprietății, o valoare unică arbitrară.
Caractere valide: numere, caractere latine, subliniere, liniuțe. Înregistrează-te.
<Значение>inve - chiar înțelesul. Caractere valide: orice. Înregistrează-te.
<ПоУмолчанию>fals - un semn că această valoare va fi setată implicit pentru bunuri, dacă nu a fost specificată nicio altă valoare.
<Сортировка>500 - codul de sortare al valorii din interiorul listei. Lăsați ca atare.
Nod Element Properties
Acest nod specifică dacă există o proprietate care să apară în filtrul bunurilor.
Specifică ID-ul proprietății al nodului <Ид> și în nod <УмныйФильтр> este setat la true.
Acest nod afișează proprietățile grupurilor de produse. În cadrul oricărui proiect serios, vor fi utilizate cel puțin 3 proprietăți de servicii pentru SEO: UF_TITLE, UF_KEYWORDS, UF_DESCRIPTION, luați ca atare.
Acest nod descrie structura ierarhică a grupurilor de mărfuri și a grupurilor în sine.
Ierarhia este definită după cum urmează:
<Ид>pisica-2 - identificator de grup, valoare unică arbitrară.
Caractere valide: numere, caractere latine, subliniere, liniuțe. Înregistrează-te.
<Наименование>dulapuri - numele grupului. Valoare arbitrară.
<БитриксСортировка>120 - ordinea sortare a grupului atunci când este afișat pe site.
<БитриксАктивность>adevărat - un semn că grupul va fi afișat pe site.
<БитриксКартинка>123_files / Inve_Madrid_70_k.jpg - imagine mică a grupului de produse. În acest exemplu, fișierul de import se numește 123.xml, astfel încât imaginile să fie stocate în directorul 123_files, care ar trebui să fie în același director ca fișierul 123.xml.
<БитриксКартинкаДетальная>123_files / Inve_Madrid_r_iNVE_70.jpg - imagine mare a grupului de produse.
Nodul Valori de proprietate specifică proprietățile grupurilor de mărfuri. Fiecare proprietate este în propriul nod Values Properties.
<Ид>UF_TITLE - ID-ul proprietății care a fost specificat anterior în descrierea proprietății.
<Значение>Dulapuri de baie - valoarea proprietății.
Oferte pachet
La începutul nodului, este descrisă configurația blocului de informații, cărora catalogul va fi descărcat.
<ИдКлассификатора>573cd49a-339f-4596-9526-dae569251cd4 - în aceste noduri, este specificat ID-ul care a fost specificat la începutul nodului clasificatorului.
<Наименование>Catalogul principal al produselor - un nume de director de serviciu arbitrar, care este vizibil numai în secțiunea de administrare a site-ului.
<БитриксПодписи> - Acest nod descrie semnăturile comenzilor din partea administrativă.
<ТипыЦен> - în acest nod descrie tipurile de prețuri utilizate pe site. Fiecare tip de preț este plasat în propriul nod Tip Preț:
- <Ид>BASE - identificator de preț, valoare unică arbitrară.
Caractere valide: numere, caractere latine, subliniere, liniuțe. Înregistrează-te. - <Наименование>cu amănuntul - numele tipului de preț.
După nodul Tipuri de prețuri, se trece nodul Propunere.
În acest nod se descriu bunurile în sine. Fiecare produs este plasat în propriul Propunere de nod.
<Ид>produs-3 - identificator de produs, valoare unică arbitrară.
Caractere valide: numere, caractere latine, subliniere, liniuțe. Înregistrează-te.
<Наименование>Dulap de oglindă Runo Iris 60 verde - denumirea mărfii. Valoare arbitrară.
<БитриксТеги> - Nodul de serviciu, ca regulă, nu este utilizat, luați-l așa cum este, lăsați-l gol.
<Группы><Ид>pisica-2 - legarea mărfurilor la grupul de mărfuri, în nod <Ид>pisica-2 Identificatorul grupului creat anterior este cat-2.
<Картинка>123_files / Inve_Madrid_70_k.jpg - Imaginea principală mare a produsului este afișată pe cartela produsului.
Mai departe, în nodul Valorile proprietăților, sunt setate valorile proprietăților mărfurilor descrise anterior.
Apoi, după nodul Valorile Valorii, este urmat nodul de stabilire a prețurilor. Fiecare preț este în prețul propriu.
Completați descrierea cantității nodului de mărfuri.
<Количество>0 - se stabilește soldul bunurilor din depozit.