Василий Дудник

Создание обработчиков служб доставок. Рекомендации.

Thu, 07 Dec 2017 14:17:03 +0300

"Если труд, то труд такой уж, чтоб и польза была, и честь."
(Луцилий Гай)

Для того чтобы создаваемый обработчик службы доставки был универсальным, мог работать независимо от конкретного сайта, как в публичной части так и в административной, использовал все возможности системы - необходимо чтобы он был создан в соответствии с новой архитектурой (начиная с версии 15.0.0 модуля "Интернет-магазин") механизма служб доставок. Класс обработчика должен являться наследником класса \Bitrix\Sale\Delivery\Services\Base.

На тему создания собственного обработчика служб доставок есть следующая документация:
- кастомизация платежных систем и служб доставок
- пример создания собственной службы доставки

Есть возможность ограничить использование службы доставки по каким - либо параметрам. Например, по максимальному весу или размеру.
Для этого можно воспользоваться стандартными ограничениями, которые могут быть заданы через административный раздел - настройку службы доставки.
Если же необходимо что - то особенное, например, ограничить использование службы доставки в зависимости от фазы луны, то можно создать собственный тип ограничений. О создании таких ограничений можно почитать здесь: пользовательские ограничения.

В системе есть также возможность задавать для службы доставки дополнительные услуги.
Про создание собственного типа дополнительных услуг можно почитать здесь: кастомизация типов дополнительных услуг

При создании службы доставки необходимо учитывать тот факт, что сайт может быть как в кодировке utf-8 так и в кодировке cp-1251.
Если производится обмен данными со службой доставки - необходимо при этом правильно менять кодировку данных при отправлении и получении данных.
Здесь может помочь метод \Bitrix\Main\Text\Encoding::convertEncoding().

В качестве примера служб доставок лучше всего подходят следующие:
\Sale\Handlers\Delivery\SimpleHandler (/bitrix/modules/sale/handlers/delivery/simple/handler.php) простейший пример обработчика.
\Sale\Handlers\Delivery\SpsrHandler (/bitrix/modules/sale/handlers/delivery/spsr/handler.php) вариант посложнее с использованием всех возможностей текущей архитектуры.

Для служб доставок существует механизм автоматического отслеживания идентификаторов отправления (трэкинг-номеров). Пример, как это реализовано для службы доставки СПСР: \Sale\Handlers\Delivery\SpsrTracking

Для запросов к сервису службы доставки рекомендуется использовать встроенный класс \Bitrix\Main\Web\HttpClient вместо сторонних расширений, например curl.
Оптимальный формат обмена - json, так как возможно использовать встроенный класс \Bitrix\Main\Web\Json.

При обмене информацией с сервисами служб доставок зачастую необходимо передавать идентификаторы местоположений. Сопоставление идентификаторов местоположений интернет магазина с идентификаторами местоположений служб доставок - задача нетривиальная. Как пример можно использовать \Sale\Handlers\Delivery\Spsr\Location::mapStepless();

Чтобы не порождать лишних запросов к службе доставки и не замедлять работу сайта желательно при возможности кэшировать информацию полученную от сервисов служб доставок. Однако делать это надо аккуратно во избежание побочных эффектов. Как пример: \Sale\Handlers\Delivery\Spsr\Cache

В случае возникновения ошибок и для отладки желательно иметь возможность записывать события связанные с получением информации от служб доставок в системный журнал. Для этого можно воспользоваться классом \CEventLog.

И конечно же в случае обмена информацией со службой доставки необходимо предусмотреть корректную обработку случаев, когда по каким - то причинам сервер службы доставки недоступен или выдаёт неверный ответ.
Подробнее...

Горячие клавиши

Thu, 26 Apr 2012 18:14:56 +0400

"Жизнь коротка, скорость необходима,
чтобы достичь желаемого в ограниченное
время, которым мы располагаем."
(Соитиро Хонда)

Во время работы с порталами часто возникает необходимость выполнять различные действия, для которых надо переходить из одного раздела в другой, заходить в различные меню, подменю и т.п. мышь под рукой плавится, поверхность стола под мышью дымится... Каждый переход - загрузка страницы, переход в разделы, подразделы, загрузка меню, прицеливание мышью по кнопке или ссылке - забирает драгоценные мгновения складывающиеся в секунды, часы, дни .... что в конечном итоге влияет на сроки сдачи проектов...

В новых версиях продукта начиная с 11.5 стали доступны "горячие клавиши", которые могут помочь выполнять действия без помощи мышки, простым нажатием заранее настроенных сочетаний клавиш.

О том что это за "горячие клавиши" и как их можно использовать в своей работе я сейчас и расскажу.

После установки продукта, или обновления в правом верхнем углу появляется иконка в виде клавиатуры:

Нажав на неё, Вы можете увидеть окно настройки горячих клавиш, доступных Вам на данной странице. На разных страницах состав клавиш может различаться, в зависимости от элементов интерфейса, подгруженных на данной странице. К некоторым из элементов интерфейса можно задать горячие клавиши, к некоторым нет.

По умолчанию задано всего несколько комбинаций, которые Вы (как и любой другой авторизованный пользователь, имеющий доступ к администраторской панели) можете попробовать в действии. Если заданные сочетания Вас не устраивают Вы можете их поменять на те, которые Вам больше нравятся. Задать комбинации, которые подходили бы Всем, мешают как субъективные факторы личных предпочтений, так и объективные, связанные с тем, что в разных операционных системах, разных браузерах могут быть назначены свои горячие клавиши.

Чтобы назначить горячую клавишу необходимо нажать на надпись "не назначена", либо на уже назначенную комбинацию клавиш, например "Ctrl+Alt+O":

После того, как появилась строка ввода нажмите комбинацию клавиш, которую хотите задействовать для данной операции:

Когда Вы закроете окно, Вы сможете использовать данную комбинацию клавиш.

В окне настроек есть возможность освободить комбинацию клавиш. Для этого необходимо нажать на красный крестик справа.

Внизу окна настроек есть три кнопки:

"Закрыть" - закрывает окно;
"По умолчанию" - удаляет все клавиши назначенные пользователем и назначает клавиши по умолчанию;
"Удалить все" - просто удаляет все назначенные горячие клавиши.

Функционал горячих клавиш можно полностью отключить/подключить в настройках "Главного модуля":

При необходимости Вы сами можете добавлять необходимые именно Вам действия, что бы назначить на них горячие клавиши. Делается это в разделе Администрирование -> Настройки продукта -> Горячие клавиши:

Здесь список некоторых заданных действий, для которых пользователь может задать горячие клавиши.
Двойным щелчком мыши можно зайти в каждое из действий и посмотреть для примера как они делаются.

Для того, что бы добавить своё действие необходимо нажать кнопку "Добавить". После этого заполнить форму создания для горячих клавиш:

Необходимо заполнить как минимум два поля: "Наименование", которое будет выводиться у пользователей в окне настроек горячих клавиш и поле "Выполняемый JavaScript код".
"Наименовании класса" можно оставить пустым. Оно необходимо для Вызова функционала горячих клавиш из кода PHP. (Об использовании API Горячих клавиш будет написана дополнительная статья).
"Комментарий" - необходимо заполнить, если требуются дополнительные, более развёрнутые сведения о выполняемом действии.
"Объект для привязки title" - так же как и "Наименование класса" используется для PHP - кода.
"Адрес (URL) где будет работать" Если оставить поле пустым, то действие для привязки к горячим клавишам будет доступно везде, где есть администраторская панель. Если необходимо что бы действие выполнялось на какой - то конкретной странице, или в конкретном разделе то их можно указать в данном поле, например:

====code====

http://127.0.0.1:84/bitrix/admin/hot_keys_list.php 
или 
/bitrix/admin/

=============
После заполнения всех необходимых полей нажимаем кнопку "Сохранить". В окне настроек горячих клавиш можно видеть только что созданное действие:

Остается назначить на это действие комбинацию горячих клавиш, нажав на ссылку "не назначена", закрыть окно настроек и можно проверять нажатием заданных клавиш:

Вы, например, можете назначить по горячей клавише переход в наиболее часто используемый раздел. Что бы перейти в раздел администрирования горячих клавиш код JavaScript будет выглядеть так:

====code====

location.href='/bitrix/admin/hot_keys_list.php';

=============
По умолчанию горячие клавиши можно назначать на действия, выполняемые через основные кнопки "Эрмитажа" и Администраторской панели.

При добавлении в избранное, в окне настроек горячих клавиш появляется добавленный адрес. Для перехода на него можно задать комбинацию клавиш:

При наведении мышки на только что созданный "список пользователей" в меню "Избранное", как и любой другой пункт меню в администраторской панели или "Эрмитаже" на который назначена горячая клавиша появится title с указанием горячей клавиши, которая сюда назначена:

Таким образом, все, что может быть выполнено с помощью JavaScript - кода - можно выполнить простым нажатием сочетания горячих клавиш... а это почти все, что может понадобиться при работе с порталом. Осталось определиться с потребностями, настроить нужные действия и можно делать больше, за ограниченное время, которым мы располагаем.

Подробнее...