Източник на данните при автоматичен импорт. ---------------------------------------------------------------------------------------------------- Кратки указания тук: http://911.bg/_bc2/short-export-requirements.txt Източникът трябва да е оформен в табличен вид, т. е. да има ясно обособени колони и редове. Това може да е: - таблица в база от данни (Table). - изглед в база от данни (View). - процедура в база от данни (Procedure) - заявка в база от данни (Query). - отделен файл с информация в табличен вид, може да е: - Excel (*.xls). - Comma-separated Format (*.csv). - обикновен Text файл (*.txt) с ясно обособени разделители между отделните редове от източника и между отделните стойности по колоните в тях. - допустими са и други формати на файлове след консултация с нас. - допустими са и други категории източници след консултация с нас. Забележка: Препоръчваме при наличност на база данни да осигурите директен достъп до базата. Това ще спести излишна операция по прехвърляне (конвертиране) на данните и ще ускори процеса. Също така, ще елиминира една намеса на оператор, т. е. по малка ангажираност от ваша страна. Нужен е достъп само за четене до определена таблица (Table), изглед (View) или процедура (Procedure). В случай на заявка (Query) достъпът трябва да е до всички елементи в базата, засегнати от заявката. Колоните в източника представляват отделните параметри (характеристики) на офертата. Всеки ред представя отделна оферта и е запълнен със съответните стойности на характеристиките. В случай на файл, първия ред съдържа имената на колоните. При База от Данни протокола на представяне зависи от източника. Забележка: При текстови файлове (*.txt, *.csv) - най-разпространения сепаратор между колоните е (;), допустими са и други, пример табулация или (|) - трябва да се гарантира, че в текстовете по отделните оферти няма да се срещат специални символи, които могат да предизвикат объркване при четене от файла. - за целта специалните символи трябва да бъдат заменени с други последователности. - с цел обратимост е удачно да се следват посочените замени нов ред \n табулация \t точка и запетая (;) \s двойна кавичка (") \q единична кавичка (') \a запетая (,) \c права черта (|) \v наклонена черта (\) \l - всички замени не са задължителни, в общия случай с разделител (;) е достатъчно \n, \s, \q и \l Пример: параметър1;параметър2;параметър3 13;продукт1;продукт 1 6;продукт2;продукт 2/s/n/qпродукт 2.1/q/s/nпродукт 2.2. 12;продукт3;продукт 3333 Интересен е параметър3 на оферта 2. Той представлява следния текст: продукт 2; "продукт 2.1"; продукт 2.2. Забележка: Удачно е в случаите на експорт, той да бъде генериран от WEB-скрипт, URL-адрес, който да може да се извиква динамично и да генерира източника в момента на извикване, като извежда информацията от базата данни. Източника трябва да съдържа цялата необходима информация за всички актуално предоставяни оферти. При описание на полетата, в скоби е дадено ограничение в/у съответното поле. Пример: (50) - означава, че полето е с дължина 50 символа. Не е задължително да се спазват тези размери, но ако текста е по-дълъг, то той ще бъде отрязан. За голяма част от полетата (колоните) има възможност за задаване на стойности по подразбиране. Т.е. има настройката, да се приема дадена стойност за параметър при всички оферти. Те ще бъдат маркирани с флаг: * Ако стойността по даден параметър, за коя да е оферта е непроменена, не подавайте този параметър. За да се избегне неправилно тълкуване на имената на параметрите, отново обръщаме внимание, че те категоризират отделна оферта Задължителни полета (колони): - * Наименование на фирма предоставяща офертата (50) - в повечето случаи фирмата е една и се използва стойност по подразбиране - Име на оферта на български език (100) - * Размер (да съдържа реално число) - * Мерна единица (50) - Цена - уточнява се дали е единична или за количество артикули посочени в "Размер" (реално число) - * Валута (50) - * ДДС - флаг определящ дали ДДС е включено в цената или не (50) - * Продукт (50) - категоризира, определя еднозначно вида стока или услуга, предмет на конкретната оферта пример: компютър, клавиатура, GSM, апартамент, курс по ..., масаж отрицателен пример: монитор <търговса марка> <модел>, интересни оферти, други - * Действие - продава, дава под наем, ... (50) - * Продуктова директория (50) - групиране на офертите на фирмената страница - Полето не се използва при редирект на офертите към външен за системата на 911.bg сайт. Когато няма фирмена страница в системата на 911.bg, няма нужда от това групиране. - * Активност на офертата - флаг определящ дали офертата е активна или е деактивирана (50) - * Промоционалност на офертата - флаг определящ дали офертата е промоционална (50) ПРЕПОРЪЧИТЕЛНО, но незадължително поле (колона) е: - Идентификатор на офертата във Вашата База данни (20) - не е допустимо 2 оферти да имат един и същи идентификатор дори и в различни периоди от време. Незадължителни полета (колони): - Име на оферта на английски език (100) - Име на оферта на немски език (100) - Име на оферта на руски език (100) - Кратко описание на офертата на български език (512) - Кратко описание на офертата на английски език (512) - Кратко описание на офертата на немски език (512) - Кратко описание на офертата на руски език (512) - Подробно описание на офертата на български език (4096) - Подробно описание на офертата на английски език (4096) - Подробно описание на офертата на немски език (4096) - Подробно описание на офертата на руски език (4096) - Малка картинка - ПЪТ ДО КАРТИНКАТА ВЪРХУ ДИСКА ИЛИ URL АДРЕС В INTERNET (255) - Приемани формати са *.JPG, *.JPEG, *.JPE, *.GIF, *.PNG Препоръчителни размери: височина до 200 pix, ширина до 220 pix Ако препоръката не е спазена, картинката ще бъде прeоразмерена. - Голяма картинка - ПЪТ ДО КАРТИНКАТА ВЪРХУ ДИСКА ИЛИ URL АДРЕС В INTERNET (255) - Приемани формати са *.JPG, *.JPEG, *.JPE, *.GIF, *.PNG Препоръчителна големина до 150 KB Или препоръчителни размери: височина до 600 pix, ширина до 800 pix Ако препоръката не е спазена, картинката ще бъде прeоразмерена. - Местоположение на офертата - географско местоположение на предлаганата оферта (50) Има задължителен характер при оферти за недвижими имоти, екскурзии и други подобни. В останалите случаи локализира район, в който се предлага дадената оферта. - Търговска марка - характеризира търговската марка на предлагания продукт (50) - Модел - характеризира модела на предлагания продукт, в зависимост от търговската марка (50) - Web име - име на суб-домейн на офертата в системата на 911.bg (30, букви на латинеца, цифри и тирета започва с буква) - за да сработи механизма трябва записа да бъде уникален. - Web име на Продуктова група - име на суб-домейн на Продуктовата група в системата на 911.bg (30, букви на латинеца, цифри и тирета започва с буква) - за да сработи механизма трябва записа да бъде уникален. Не се използва в случаите, когато не се използва продуктова група! - Картинка на продуктовата група (255) (ПЪТ ДО КАРТИНКАТА ВЪРХУ ДИСКА ИЛИ URL АДРЕС В INTERNET) Приемани формати са *.JPG, *.JPEG, *.JPE, *.GIF, *.PNG Препоръчителни размери: височина до 130 pix, ширина до 130 pix Ако препоръката не е спазена, картинката ще бъде преоразмерена. Не се използва в случаите, когато не се използва продуктова група! - Наличност - налично количество от предлаганата стока (да съдържа цяло число) Полето е предвидено за бъдещи цели, за момента няма приложение в системата на 911.bg. - Контактна информация към оферта - Име (50) - при липса се взимат данни от фирмената информация. - Контактна информация към оферта - телефон (50) - при липса се взимат данни от фирмената информация. - Контактна информация към оферта - e-mail (50) - при липса се взимат данни от фирмената информация. - Външен URL адрес (120) - използва се за линк към външно за системата 911.bg пространство. Към офертите, могат да бъдат задавани и допълнителни характеристики в зависимост от продукта на офертата. Например: недвижим имот има "Площ", "Обзавеждане" и др., докато GSM има "Батерия", "Тегло" и др. Те също се предават като отделни колони. Не са описани, поради факта, че представляват голямо множество.