О сервисе
Рекомендации по подключению и использованию сервиса
О сервисе
Сервис предназначен для дополнения страниц сайта-подписчика (заказчика) текстами описаний лекарственных средств (ЛС) и других товаров аптечного ассортимента (ТАА). Разработчик сайта-подписчика реализует проксирование своих пользователей к РЛС® Авроре и предоставляет информацию на страницах своего сайта. Но при этом он не разрабатывает собственные структуры хранения и процедуры обновления информации по описаниям ЛС. Пользователь сайта-подписчика получает информацию о лекарственных средствах и других ТАА, за актуальность и достоверность которой отвечает РЛС® Аврора. Но он не отправляет запросов к РЛС® Авроре, поэтому для него и поисковых систем сохраняется иллюзия принадлежности контента сайту-подписчику.
При запросе пользователя сайт-подписчик в ответ генерирует страницу по собственному макету и, запросив метод РЛС® Авроры api/library_solid_description?desc_id=XXXXX, вставляет полученный текст описания в страницу. Информация, предоставляемая сервисом по одному и тому же запросу, может со временем изменяться, актуализироваться и дополняться.
Для того чтобы получить ссылку для вызова API и посмотреть, как будет выглядеть страница описания на сайте-подписчике, введите запрос в поисковой строке:
Рекомендации по подключению и использованию сервиса
Предварительно необходимо привязать страницы сайта-подписчика к ссылкам на описания. Например, чтобы получить текст описания препарата АнвиМакс® по адресу https://www.rlsnet.ru/prep_index_id_566839.htm на сайте rlsnet.ru, необходимо в базе данных сайта rlsnet.ru иметь таблицу соответствий, в которой параметру prep_index_id=566839 соответствует код описания desc_id=65583. В процессе построения страницы АнвиМакс® сайт rlsnet.ru отправляет вызов http://rlsaurora10.azurewebsites.net/api/library_solid_description?desc_id=65583 и вставляет результаты в текст собственной страницы.
Сайт-подписчик должен хранить таблицу соответствий страниц и кодов описаний. Установить такое соответствие можно тремя способами:
-
скачать полный список доступных описаний методом api/library_solid_description (без параметров), а затем вручную проставить соответствие позиций пользовательской
номенклатуры ссылкам desc_id из этого списка. В процессе привязки нужно ориентироваться на атрибуты препарата:
- prep_full — название, лекформа и дозировка препарата;
- packing_short — товарная упаковка препарата;
- firms — производитель/упаковщик;
- desc_id — ссылка на текст описания.
-
воспользоваться сервисом РЛС® Гармонизация и последовательно запись за записью привязать пользовательскую номенклатуру
к номенклатуре РЛС® Авроры, после чего воспользоваться полем desc_id из номенклатурной записи. Этот подход отличается от работы с полным списком использованием поискового
метода api/inventory_brief?pos=Анвимакс&firm=Фармвилар. Метод возвращает набор позиций, взвешенных по релевантности поисковому запросу, что в большой мере облегчает ручной поиск по спискам.
Кроме того, полученная таким способом номенклатура обладает полезными атрибутами и может быть дополнена разнообразными классификациями, оперативными данными для товарного учета.
-
выполнить поиск и привязку описаний, задав искомые позиции в файле в формате MS Excel.
В списке позиций, необходимо указать уникальный код строки (ОБЯЗАТЕЛЬНО В ПЕРВОЙ КОЛОНКЕ!), торговое название, лекарственную форму, дозировку, упаковку, количество,
штрихкод и прочие атрибуты, как можно более точно описывающие номенклатурную позицию. Атрибуты, малозначимые для точной идентификации позиций (цены, даты и др.),
указывать не нужно. Кроме того, не следует использовать списки длиннее 25000 позиций и шире 10 колонок,
а также передавать файлы, содержащие более трех листов.
Сервис library_solid_desc предоставляет четыре веб-метода для доступа к списку ссылок и текстам описаний. API-cпецификации методов представлены в разделе #library_solid_description:
- http://rlsaurora10.azurewebsites.net/api/library_solid_description — архивный файл с полным списком доступных препаратов со ссылками на описания;
- http://rlsaurora10.azurewebsites.net/api/library_solid_description?look=АнвиМакс — поиск по начальным символам названия препарата;
- http://rlsaurora10.azurewebsites.net/api/library_solid_description?desc_id=65583 — текст описания в HTML-формате для размещения на сайте заказчика;
- http://rlsaurora10.azurewebsites.net/api/library_solid_description?desc_id=65583&pics_on=1 — текст описания в HTML-формате с изображением препаратов для размещения на сайте заказчика.
Важно! Описания, предоставляемые сервисом library_solid_desc, представляют собой сплошной HTML-текст, не структурированы по полям и не предназначены для интеграции в информационные системы. Преобразовать этот текст под иной формат отображения будет затруднительно. Это снимает с подписчика задачу по формированию страницы из полей, классификаций и номенклатурных атрибутов, но предоставляет меньшую гибкость по сравнению с другим подходом.
Для интеграции в МИС и кастомизации внешнего вида текстов описаний необходимо использовать другие сервисы: library_description — описания препаратов, library_as_description — описания действующих веществ. Здесь информация представлена в виде отдельных полей, ее можно загрузить большими массивами данных в локальную базу данных сайта. При этом придется самостоятельно решить задачу по хранению, периодическому обновлению информации и генерации страниц сайта.