Wiki source code of Autoprice
Version 33.1 by Alexey Voronov on 2024/09/23 07:23
Hide last authors
3.1 | 1 | = __**Программа для работы с заказами AutoPrice (iTL based)**__ = | |
1.1 | 2 | ||
19.7 | 3 | **~1. **Назначение программы | |
3.1 | 4 | ||
3.2 | 5 | 1.1. Программа AutoPrice предназначена для загрузки через интернет прайс-листа ООО "TD-AUTO" (в дальнейшем "TD-AUTO") и для формирования заказов на основании этого прайс-листа. Программа обеспечивает удобный и быстрый поиск, навигацию, просмотр фото и характеристик товара, а также ведение базы заказов и просмотр состояния их исполнения. | |
3.1 | 6 | ||
3.2 | 7 | 1.2. Поскольку программа работает как отдельное приложение, лишь иногда устанавливая связь с сервером, то появляется возможность работать автономно, независимо от наличия интернета и доступности сайта [www.td-auto.ru]. При этом на скорость и удобство работы не влияет качество канала связи, что недоступно для систем заказов, работающих с сайта. В то же время программа ведет свою базу заказов, с которой можно работать и по внутренней сети, позволяет вести поиск по любым полям, имеет встроенный классификатор, таблицу аналогов, а при наличии интернета подгружает изображения и описания товаров, что не доступно для прайс-листов в Word, Excel и аналогичных программах. | |
8 | |||
9 | 1.3. Программа может активировать дополнительные возможности в работе с прайс-листами, например, прайс-листы нескольких поставщиков, кросс-кодировки между поставщиками, отслеживание и историю цен и наличия, мониторинг и сбор данных с сайтов третьих организаций. По условиям активации этих функций обращайтесь в "TD-AUTO", рассмотрение их использования и условий лицензирования не входит в задачу данного описания. | ||
10 | |||
19.3 | 11 | 1.4. У вас не должно возникнуть проблем при использовании программы на следующих версиях Windows: 98, Me, 2000, XP, 2003, Win7, Win8. Также есть данные о нормальной работе программы из под Wine для Ubuntu/Linux/MacOS (Последняя проверка сентябрь 2024) и из под CrossOver для MacOS/Linux (?). | |
3.2 | 12 | ||
13 | 1.5. Программа распространяется свободно, без каких-либо отчислений или разовых платежей. Программа распространяется "как есть", в соответствии с общепринятыми принципами "AS IS". Разработчики не несут никакой ответственности за любой возможный ущерб, связанный с использованием или неиспользованием программы. Если данный пункт противоречит законодательству вашей страны или вашего региона, то разработчики запрещают вам использовать данную программу. | ||
14 | |||
19.7 | 15 | **2.** Установка и первый запуск программы. | |
3.1 | 16 | ||
21.1 | 17 | 2.1. Поскольку программа первоначально представляет из себя всего 1 exe-файл, то наиболее приемлемым способом распространения мы выбрали Zip-архив. Вам надо создать папку(к которой потом программа сможет иметь доступ от имени пользователя компьютера!!) и извлечь в нее из архива файл AutoPrice.exe. Например это может быть папка "C:\AutoPrice" (для Linux - ...wine/drive_c/autoprice). После разархивации можно вынести ярлык от AutoPrice.exe на рабочий стол - для удобства запуска. | |
3.2 | 18 | ||
21.1 | 19 | 2.2. Во время работы программа создает резервные копии. В MS Windows они обычно хранятся в папке ../Application Data/ITLAutoprice/Backup/ . (в Linux - /home/{имя_пользователя}/.wine/drive_c/users/{имя_пользователя}/Application Data/ITLAutoprice/Backup/ | |
3.2 | 20 | ||
21 | 2.3. В процессе первого запуска AutoPrice.exe, программа предложит определиться с местом хранения данных, которые ей необходимы в процессе работы, рекомендуем выбрать вариант " Использовать папку, из которой была запущена программа ". Если у вас уже были данные (например - перенесены со старого компьютера), то можно указать путь к ним и программа запомнит указанный путь, хотя если вы перенесли данные с другого компьютера, то лучше поместить их в папку установки программы. В дальнейшем путь доступа к данным можно поменять в "Настройках". (см. п.5.1) | ||
19.6 | 22 | После определения места хранения данных, программа проверит наличие в этом месте файла базы данных ("AutoData.mdb" или "AutoData.ddd" или "AutoData.db") и, при его отсутствии, предложит создать. В этом диалоге есть опция "Скрыть расширение MS Access", она определяет расширение файла "AutoData.mdb" - если опция включена (по умолчанию), то программа меняет расширение файла с ".mdb" на ".ddd", только для того, чтобы случайно не открыть и не повредить файл другими программами. Понятно, что расширение файла можно поменять позднее. При создании AutoData.* туда сразу вносится информация о регистрации "TD-AUTO", как поставщика данных. Поэтому Вам останется только нажать "обновить всё" | |
3.2 | 23 | ||
19.3 | 24 | [[image:image-20240920143112-1.png||height="102" width="142"]] | |
19.1 | 25 | ||
26 | и Вы готовы к работе. | ||
27 | |||
22.2 | 28 | **3**. Начало работы. | |
3.1 | 29 | ||
19.1 | 30 | 3.1. Чтобы загрузить самую свежую версию прайс-листа нажмите кнопку "обновить всё" . Программа попытается установить связь с сервером и запросить прайс-лист. | |
3.2 | 31 | В случае неудачи программа сообщит о проблемах со связью и предложит воспользоваться старой версией прайс-листа. В случае успеха, при наличии изменений в прайс-листе, программа обновит его и спросит что делать с предыдущей версией - отправить в архив или просто удалить. | |
3.1 | 32 | ||
3.2 | 33 | 3.2. По умолчанию, программа не знает кто вы, и каковы ваши условия для заказа товара. Поэтому вам предлагается "обезличенный" универсальный прайс-лист, вполне удобный для работы, но без особенностей, которые необходимы для вас. Чтобы начать работать с индивидуальным прайс-листом, необходимо стать "подписчиком". Подписчиком можно стать только, если вы клиент "TD-AUTO". В этом случае ваш менеджер может зарегистрировать вас как подписчика и сообщить вам "pin-код". Нажмите кнопку "Авторизация" и в появившемся диалоге введите этот "pin-код". Программа попытается авторизоваться и получить ключ-шифр для обмена данными с нашим сервером. Помимо шифра программа получает список ваших организаций и адресов доставки, которые необходимы для корректного обмена данными. После авторизации вы должны обновить | |
19.7 | 34 | прайс-лист (см. п.3.1) и система будет готова к работе. Чтобы не вводить пин-код каждый раз при обмене установите галку "запомнить". | |
3.1 | 35 | ||
19.1 | 36 | 3.3. Для просмотра прайс-листа необходимо нажать кнопку "Прайс-лист" . | |
3.2 | 37 | ||
19.1 | 38 | [[image:image-20240920143407-2.png||height="106" width="134"]] | |
39 | |||
40 | На экране появится окно со списком товаров, наличием и вашими ценами. | ||
41 | |||
42 | [[image:image-20240920144140-3.png||height="496" width="1569"]] | ||
43 | |||
3.2 | 44 | 3.3.1. В прайс-листе имеется колонка "Наличие", в которой можно узнать состояние товара на складе. Внешний вид этой колонки зависит, от условий, которые вы согласовали с менеджером. Это может быть [есть/нет], [есть/ожидается через Х дней/нет], [Кол-во доступно] и другие варианты. | |
45 | |||
19.1 | 46 | 3.3.2. В правой части экрана есть закладка "Группы и акции" . | |
47 | |||
48 | [[image:image-20240920144210-4.png||height="162" width="140"]] | ||
49 | |||
50 | С ее помощью можно быстро просмотреть группы, которые могли бы вас заинтересовать в данный момент, например - новинки, сезонный товар, спец.предложения. Естественно, есть там и папка "Все товары", которая отключает фильтрацию групп. | ||
51 | Ниже находится закладка классификатор, | ||
52 | |||
53 | [[image:image-20240920144238-5.png||height="198" width="232"]] | ||
54 | |||
55 | которая позволяет отбирать товар по назначению и применяемости. Фильтрация по классификатору объединяется с фильтром по группам (и по строкам), поэтому, чтобы, например увидеть новинки из класса "запчасти ГАЗ", необходимо выбрать группу "новинки" и класс "запчасти ГАЗ". Для отключения фильтрации по классификатору, необходимо в нем выбрать корневую "папку" - "Все товары". | ||
3.4 | 56 | \\3.3.3. Сразу под заголовками столбцов прайс-листа находится строка фильтрации. | |
19.1 | 57 | ||
58 | [[image:image-20240920144313-6.png||height="176" width="1295"]] | ||
3.2 | 59 | Сюда можно ввести текст, и, нажав Enter, отфильтровать товары по этому тексту. По умолчанию, текст ищется в любой части поля прайс-листа. Например, введя "амор", мы увидим в списке и "Амортизатор" и "Гайка амортизатора". Чтобы убрать фильтрацию по строке, необходимо стереть текст в строке фильтрации и нажать Enter. | |
60 | |||
19.1 | 61 | 3.3.4. В программе можно сортировать и искать товар по любому полю1. Для сортировки необходимо щелкнуть по заголовку нужного столбца, чтобы появилась стрелочка с направлением сортировки. | |
3.2 | 62 | ||
19.1 | 63 | [[image:image-20240920144356-7.png||height="73" width="438"]] | |
3.2 | 64 | ||
19.1 | 65 | Удерживая клавишу Ctrl, можно обеспечить сортировку по нескольким столбцам. | |
66 | Простейший способ вызвать окно поиска - начать набирать искомый текст прямо в необходимом столбце. Окно поиска появится автоматически. Ищется первая строка, начинающаяся с набранного текста. Большие/маленькие буквы - значения не имеет. Если необходим более детальный поиск - вызовите окно поиска нажав "Поиск..." в контекстном меню в прайс-листе или нажав Ctrl+F. | ||
67 | |||
68 | [[image:image-20240920144429-8.png||height="161" width="518"]] | ||
69 | |||
70 | В появившемся окне вы можете указать "Образец", поля для поиска, а также параметры сравнения. | ||
71 | |||
72 | |||
73 | 3.3.5. Программа позволяет открыть, окно "Аналоги", нажав кнопку "Аналоги" | ||
74 | |||
75 | [[image:image-20240920144506-9.png||height="149" width="160"]] | ||
76 | |||
77 | на главной панели или выбрав в контекстном меню пункт "Аналоги". Также можно воспользоваться горячей клавишей "F3". В открывшемся списке можно видеть товары, которые являются аналогами/заменителями для выбранного вами товара. | ||
78 | |||
79 | [[image:image-20240920144534-10.png||height="376" width="818"]] | ||
80 | |||
81 | При работе с заказом, в этом окне можно сразу видеть наличие, цены и корректировать заказываемое кол-во. (см. п.4.1) Чтобы скрыть список аналогов, нажмите кнопку закрыть над ним. | ||
82 | 3.3.6. Программа позволяет просматривать фотографии товаров, причем изображения могут накапливаться в папке-"месте хранения данных", и подкачиваться с интернета только при отсутствии фото и наличии работающего интернета. | ||
83 | |||
84 | [[image:image-20240920144627-11.png||height="306" width="572"]] | ||
85 | |||
86 | Открыть окно с фотографией можно, нажав кнопку "Фото" на главной панели или выбрав в контекстном меню пункт "Фото". | ||
87 | |||
88 | [[image:image-20240920144643-12.png||height="105" width="119"]] | ||
89 | |||
90 | Также можно воспользоваться горячей клавишей "F2". | ||
3.2 | 91 | При двойном щелчке по появившейся фотографии программа попробует подгрузить увеличенную копию фото и/или подробные характеристики товара. | |
92 | |||
19.7 | 93 | **3.3.7.** В Вашем прайс-листе поставщик может установить ограничения по нормам отгрузки, тогда программа добавляет товар в заказ с шагом, равным этой норме. Колонку со значениями норм можно видеть прямо в прайс-листе (колонка "Норма отгр."). При необходимости, выравнивание на норму можно отключить (см. п.5.1), но мы рекомендуем это не делать, т.к. сервер "TD-AUTO", при получении вашего заказа, все равно применит нормы отгрузки, которые установлены для вас в базе данных. Как следствие, вам будет отгружено кол-во, не соответствующее тому, что вы ожидали. | |
3.2 | 94 | ||
19.7 | 95 | **4.** Работа с заказами | |
3.3 | 96 | ||
22.2 | 97 | 4.1.** **Создание нового заказа | |
30.2 | 98 | 4.1.1. Для создания нового заказа необходимо нажать кнопку "Новый заказ" на главной панели | |
99 | |||
100 | [[image:image-20240923095018-7.png||height="105" width="136"]] | ||
101 | |||
102 | или щелкнуть "указателем мыши"по закладке "Создать новый заказ" над прайс-листом. | ||
103 | |||
104 | [[image:image-20240923095047-8.png||height="72" width="739"]] | ||
105 | |||
106 | В прайс-листе появятся колонки "Заказ", "Сумма опт." и "Сумма ваша". В колонке "Заказ" вы можете заполнять необходимое кол-во, а колонки сумм покажут вам сумму данной позиции по 2 ценам. Ниже прайс-листа появится окно заказа, с точно такими же колонками, как и в прайс-листе, в котором видны строки, уже отобранные вами для заказа. В них тоже можно редактировать колонку "заказ". При необходимости удалить позицию надо стереть значение или набрать "0". | ||
107 | |||
108 | [[image:image-20240923095139-9.png||height="174" width="1476"]] | ||
109 | |||
110 | Кроме того существуют альтернативные способы внесения кол-ва в заказ. | ||
111 | |||
112 | |||
19.1 | 113 | а) При нажатии кнопки "Enter" в строке с нужной позицией, появится окно, в котором будет предложено ввести/исправить необходимое кол-во данной позиции, | |
114 | |||
115 | [[image:image-20240920144734-13.png||height="256" width="354"]] | ||
116 | |||
117 | причем редактировать его можно и просто набирая число, и стрелками вверх/вниз. Если позиции не было в заказе, то кол-во заказа может быть сразу заполнено нормой отгрузки, в зависимости от настроек (см. п.5.1). Там же сразу отображается сумма данной позиции и сумма документа с учетом выбранного кол-ва для заказа. | ||
19.7 | 118 | б) Если удерживать в прайс-листе нажатой кнопку Shift и нажимать стрелку Вверх/Вниз | |
3.3 | 119 | позиция будет добавлена в заказ в минимальном количестве и курсор передвинется на соседнюю строку. | |
120 | Редактировать заказ можно и из вспомогательного окна "Аналоги"( смотри п. 3.3.5) | ||
121 | |||
122 | 4.2. Сохранение и отправка заказа. | ||
123 | 4.2.1. В процессе заполнения заказа вы можете его сохранить, чтобы продолжить работу с ним позже, можете добавить его содержимое к ранее сохраненному заказу, или просто выгрузить в Excel и закрыть не сохраняя. Если вы авторизованы (см. п.3.2), то в диалоге сохранения заказа появляется кнопка "Сохранить и сразу отправить", которая позволяет сразу отправить заказ через интернет в TD-AUTO. | ||
124 | |||
125 | |||
19.1 | 126 | [[image:image-20240920144837-14.png||height="395" width="401"]] | |
3.3 | 127 | ||
30.2 | 128 | На форме сохранения необходимо указать организацию для которой отправляется заказ, организацию на которую оформляется заказ, способ оплаты (наличный или безналичный расчет), способ получения товара (самовывоз или доставка по указанному адресу). В случае доставки необходимо выбрать физический адрес из списка. Дата выезда машины со склада так же обязателен к заполнению. Диапазон дат ограничен текущим расписанием доставок на выбранный физ. адрес доставки. При желании можно добавить примечание к заказу. | |
129 | |||
130 | Нажав кнопку сохранить - вы сохраните все текущие изменения содержимого заказа и настройки его отправки. | ||
131 | |||
132 | Нажав кнопку сохранить и сразу отправить - заказ так же сохранится и будет предпринята попытка отправить его поставщику через сервер заказов в Интернет. | ||
133 | |||
134 | При неудачной попытке отправки, заказ будет пытаться отправиться при закрытии или открытии программы. | ||
135 | |||
3.3 | 136 | 4.2.2. Если заказ сохранен, то его можно найти в книге заказов. Если он не отмечен как доставленный адресату, и не отменен/выполнен, то его можно открыть на редактирование. | |
26.2 | 137 | [[image:image-20240923091256-3.png||height="251" width="731"]] | |
3.3 | 138 | ||
139 | |||
140 | 4.3. Книга заказов. | ||
141 | 4.3.1. Для того чтобы открыть книгу заказов, необходимо нажать кнопку "Заказы" на главной панели. ..................................... | ||
142 | |||
26.2 | 143 | [[image:image-20240923091231-2.png||height="311" width="1667"]] | |
3.3 | 144 | ||
26.2 | 145 | 4.3.2. Состояние заказа (по данным заказчика)/(по данным поставщика) | |
3.3 | 146 | ||
26.2 | 147 | Состояние заказа отображается в столбце "Состояние" строки заказа. | |
3.3 | 148 | ||
26.2 | 149 | **В процессе ввода** - в заказ был создан и сохранен без отправки. | |
3.3 | 150 | ||
26.2 | 151 | __//Примечание~://__ если после создания нового заказа вы не нажимали кнопку сохранить, заказ хранится не в базе данных программы а в ini файле в папке программы. В разделе "заказы" он до сохранения не виден. Если вкладку нового не сохраненного заказа закрыть, информация в заказе будет утрачена. | |
3.3 | 152 | ||
26.2 | 153 | **В отправке **- заказ был сохранении отправлен, но успешный обмен с сервером ещё не произошёл. Для отправки всех готовых к отправке заказов можно нажать кнопку "Отправить заказы в отправке" | |
3.3 | 154 | ||
26.2 | 155 | **Отправлен поставщику** - заказ был сохранен и отправлен поставщику для обработки. | |
3.3 | 156 | ||
26.2 | 157 | **Отменен** - заказ был отменен и не будет обработан. | |
3.3 | 158 | ||
26.2 | 159 | ||
3.3 | 160 | ||
27.2 | 161 | 4.3.3. Окно просмотр заказа в книге..................................... | |
26.2 | 162 | [[image:image-20240923091340-4.png||height="279" width="713"]] | |
3.3 | 163 | ||
26.2 | 164 | Содержимое заказа можно увидеть прямо в разделе "Заказы", выбрав этот пункт из контекстного меню при клике ПКМ по строке заказа. | |
3.3 | 165 | ||
26.2 | 166 | [[image:image-20240923091755-5.png||height="598" width="1402"]] | |
3.3 | 167 | ||
27.2 | 168 | Кнопкой "Закрыть" можно скрыть просмотр содержимого заказов. | |
3.3 | 169 | ||
27.2 | 170 | 4.3.4. Переключение заказа. Заказ выполнен/неактуален. | |
171 | |||
26.2 | 172 | Прямо из раздела заказы вы можете переключить его состояние - из редактирования в отправлен ( будет предложено окно сохранения и отправки заказа), или отменить заказ. Это можно сделать через контекстное меню ПКМ по строке заказа или нажав кнопку "Переключить" над содержимым заказа. | |
173 | |||
27.2 | 174 | 4.3.5 Выгрузка в Excel | |
175 | |||
176 | Содержимое заказа можно выгрузить в таблицу Excell: | ||
177 | |||
178 | [[image:image-20240923093400-6.png||height="41" width="138"]] | ||
179 | |||
180 | И отправить поставщику через электронную почту или любым другим доступным способом, если доступ к серверу заказов Автопрайса временно недоступен. | ||
181 | |||
22.2 | 182 | **5.** Сервисные функции | |
3.3 | 183 | ||
184 | 5.1. Настройка параметров. | ||
185 | Мы считаем, что программа оптимально настроена для ее использования. Тем не менее, возможно, вы захотите изменить некоторые настройки. Для этого можно воспользоваться пунктом меню "[?] > [настройка]". Появится диалоговое окно, в котором вы можете изменить некоторые настройки: | ||
186 | |||
19.1 | 187 | [[image:image-20240920144925-15.png||height="435" width="551"]] | |
188 | |||
3.3 | 189 | 5.2. Архивация / Резервное копирование | |
190 | Если программа использует стандартные настройки, то копирование всей папки, в которой она находится, обеспечивает сохранение всех данных относящихся к программе. | ||
191 | |||
192 | 5.3. Поддержка и обновление программы. | ||
22.2 | 193 | Программа автоматически обновляется с нашего сайта. При запуске программы проверяется актуальность файла и при наличии более новой версии происходит его автоматическое обновление. Так же проверяется наличие всех необходимых таблиц и полей в таблицах. При необходимости создаются недостающие. Есть опция отключения автоматического обновления. | |
194 | Запустить поиск обновлений можно и вручную, для этого необходимо выбрать пункт меню "[?] > [Обновить программу]". | ||
3.3 | 195 | ||
22.2 | 196 | [[image:image-20240923091021-1.png||height="213" width="564"]] | |
3.3 | 197 | ||
198 | 5.4. Программирование и подключение из других программ. | ||
199 | AutoPrice предполагает несколько способов взаимодействия с внешними программами: | ||
200 | (a). Using MS Access (работа с базой Access : AutoData.mdb) | ||
3.4 | 201 | Вы можете с использованием других программ подключаться к AutoData.mdb и заполнять книгу заказов и помещать их в "исходящие". Также вы можете считывать состояние заказов и другие данные из базы данных. Для запуска обмена данных с поставщиком через командную строку используйте ключ коммандной строки "-S": Autoprice.exe -S. Структура базы AutoData.mdb см. Приложение 1. | |
3.3 | 202 | (b). Command Scripts (QRY_XXXX.txt ->QRY_XXXX.result) | |
3.4 | 203 | Вы можете загружать и отправлять заказы с помощью текстовых файлов. Файлы эти можно загрузить через пункт меню "Файл-Загрузить заказы...", или передать с помощью командной строки: | |
3.3 | 204 | Autoprice.exe -LC:\Заказы\My_20130808.out - загружает в программу и отправляет заказы из файла: C:\Заказы\My_20130808.out . Отчет об операции My_20130808.result будет помещен в ту же папку. По структуре файл с заказами это ini-файл. Формат файла и формат ответа см. Приложение 2. | |
205 | |||
206 | (c). OLE Server (DDE Server). (Import type library) | ||
207 | (d). Shared memory commands. (Общий поток в памяти) |