Содержание

Терминология и сокращения

  • Virtual Card  или VC - ПО "Виртуальная карта".
  • ПО - программное обеспечение.
  • ПК - персональный компьютер.
  • ОС - операционная система.
  • RK - ПО r_keeper_7.
  • Reserv - ПО "Резервирование".
  • FF - режим "быстрое питание" (fast food).
  • Res - режим "ресторан" (restaurant).
  • EO - режим "внешние заказы" (external orders).
  • CRM - ПО RKEEPER.CRM (CardSystem).
  • RkOrder - клиентская часть на базе клиента VC (не путать с приложением "Rk-Order" для Ipad (IOS) работающим через IpadServer).
  • IIS (7) - штатный веб-сервер в составе ОС Windows 7 и выше.
  • XSP - простой веб-сервер (XSP mono.webserver) часто идущий в поставке веб-ПО производства компании "ЮСИЭС".

Вводная информация

  • Виртуальная карта - представляет собой запись в базе данных R-keeper.CRM связанную с конкретным номером мобильного телефона и предоставляющую возможность однозначной аутентификации пользователя.
  • Виртуальная карта - является своего рода идентификатором гостя, регистрируется в его профиле в "Списке карт" и является по своей сути картой и по этому, может выполнять все функции карты (назначение скидки, бонуса и прочее).

Данное ПО является дополнением, расширяющим возможности  объектов автоматизированных программными продуктами:

  • ПО "R-Keeper v6" + ПО "R-Keeper.CRM". (не рекоммендуется, т.к. проект RK6 закрыт и обновлений по нему не будет).
  • ПО "R-Keeper v7" + ПО "R-Keeper.CRM" (рекоммендуется).
  • ПО "Reserv" и некоторыми другими.
В целом, предлагаемая технология предоставляет, с помощью собственного мобильного устройства (смартфон, Ipod, планшет), возможность регистрироваться в системе CRM и использовать полученную "виртуальную карту" для:
  • назначения в заказ скидок и начисления бонуса;
  • просмотра гостем текущего состояния заказа (предчека);
  • отправки произвольных и предустановленных сообщений официанту;
  • просмотра и корректировки личных данных в личном кабинете;
  • возможности стать участником акции "Пирамида" ("пригласи друга");
  • бронирования столика в ресторане на нужную дату и время;
  • cоздания заказа с использованием предложенного меню;
  • возможности формировать и передавать на кассу RK "внешние" заказы.
  • возможности участия в голосовании/оценивании/комментировании качества обслуживания и прочего.

Так же в системе:

  • задействована рассылка сервисных СМС используемых для подтверждения тех или иных операций (настраивается со стороны CRM и связке с оператором связи);
  • настраивается и используется отображение, печать и распознавание специальных QR-кодов;

Важно! Оплата заказа с телефона на данный момент (01.12.2015) пока не реализована! Функционал находится на стадии разработки.

  • Заход на страницу "виртуальной карты" происходит через обычный броузер, как мобильных, так и настольных платформ.

Для идентификации гостя в системе используется виртуальная карта и номер мобильного телефона. При входе в приложение происходит создание новой или проверка уже существующей виртуальной карты в R-Keeper CRM и на мобильный телефон гостя отправляется код доступа.

Важно! Номер виртуальной карты и номер мобильного телефона должны быть уникальны в целях безопасности!

Примечание: пользовательская документация по продукту находится на фтп: ftp://ftp.ucs.ru/books/r-keeper_crm_virtual_card.pdf. Перед началом работы рекомендуется ознакомиться.

Режимы работы

На данный момент, реализовано три режима работы виртуальной карты:
  1. "Fastfood" - Работа с виртуальной картой в режиме "быстрого питания".
  2. "Restaurant" - Работа с виртуальной картой в режиме "концептуального ресторана".
  3. "ExternalOrder" - Работа с виртуальной картой в режиме "внешних заказов".

Примечание: В каждом из представленных режимов имеется разный набор функционала и возможностей. Так же используется тесное взаимодействие виртуальной карты с другими (сопутствующими) программными продуктами компании "ЮСИЭС", которые могут быть установлены и использоваться на автоматизируемом объекте.

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

Дистрибутив, модули ПО

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

  1. Серверной (VCSRV).
  2. Клиентской (VC).
  • Обе части, как правило, разворачиваются на ПК имеющим выход в интернет и внешний IP-адрес для возможности доступа к VC не только из ЛВС, но и из вне.
  • И сервер и клиент требуют наличия на ПК установленного и настроенного веб-сервера. Рекомендованы к установке:
  1. Веб-сервер - XSP Mono.webserver (идет в составе дистрибутива ПО "Виртуальная карта").
  2. Веб-сервер - IIS v7-7.5 (идет в составе ОС Windows 7 и выше, но по умолчанию, не включен и настроен). 

Примечание: IIS v6 предназначенный для работы с Windows XP - не тестировался.

Дополнительно:

  1. Другие веб-серверы (если присутствует опыт по их установке и поддержке).

Важно! Для более полной информации по веб-серверам рекоммендуется ознакомиться также со статьей:

http://support.ucs.ru/ru/node/8673.

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

  • клиентской частью VC;
  • сервером авторизации карт CRM (в обязательном порядке);
  • кассовым сервером RK (в обязательном порядке);
  • сервером резервирования (если задействован);
  • сервером учета результатов голосования (если задействован);
  • и другими модулями: например, для режима работы с внешними заказами, реализована дополнительная клиентская часть - RkOrder (работает через броузер (Не путать с RK-Order для Ipad, работающим через IpadServer). 

Cхема взаимодействия

Блок-схема взаимосвязи модулей

Оборудование

  1. Для установки веб-сервера, а так же серверной и клиентской частей ПО "Виртуальная карта" требуется стандартный ПК офисной конфигурации с предустановленной ОС Windows 7 или выше и выходом в ЛВС и internet и имеющим внешний IP. 
  1. Клиентская часть VC оптимизированна для запуска через броузеры мобильных устройств полноценно поддерживающих работу с HTML 5.
  • Изначально тестировалось на устройствах Apple Ipod (Iphone) модели - 4, 5 с камерой 5 мегапикселей (качественная камера нужна для корректного распознавания QR-кодов формируемых при некоторых действиях в ПО "Виртуальная карта"). 
  • Не рекоммендуется: Модель IPOD 5 (32 Гб) с камерой 1.2 мегапикселя, так как он оснащен только фронтальной камерой и она очень неудобна в использовании.
  • Можно использовать и другие устройства и платформы поддерживающие полнофункциональную работу с HTML 5 имеющие сравнительно качественную камеру.
  • На мобильных устройствах тестировалось на следующих интернет-броузерах (как наиболее полно поддерживающих HTML5.): 

    • Google Chrome версии 34 и новее для Android-устройств. 
    • Safari для iOs версии 6 и новее.

Примечание: клиентская часть VC может быть запущена и на настольных ПК, но надо учитывать что экранные формы и интерфейс VC оптимизированы для отображения на экранах мобильных устройств.

Системные требования

Для работы с "виртуальной картой" на объекте в обязательном порядке заранее должно быть установлено, настроено и пролицензировано следующее ПО:
  1. RK7 (рекоммендуется) или RK6.
  2. CRM 5.08 и выше
  3. Net.Fraimwork v.3.5 и выше.
  4. Веб-сервер (IIS (7), XSP (1.7 - 2.10 или выше) или другой).
  5. MSSQL Express 2012 и выше.
Дополнительное ПО, которое может быть настроено и задействовано при работе виртуальной карты:
  1. ПО "Резервирование".
  2. ПО "RkMobWaiter".
  3. СУБД Firebird 2.5 или выше - для сервера оценок (mrsrv).

Версии

Рекоммендуется использовать самые актуальные версии с фтп взятые на момент установки ПО.

  • Минимальные требования:
  1. RK7 – с 7.5.2.210 и выше.
  2. RK6 – Менеджер - 6.96 и касса - 6.106 и выше..
  3. CRM –  5.07.02 и выше.
  4. MS SQL 2012 и выше.
  5. Net.Fraimwork 3.5 и выше.
  6. Веб-сервер IIS (7) или  XSP 1.7 и выше.

Дополнительно:

  1. TMS2 (для RK6) – 5.82 и выше.
  2. TMS7(для RK7) – 2.3.12 и выше.
  3. Сервер резервирования - 2.0.1 и выше.
  4. СУБД Firebird 2.5 и выше (для сервера оценок - mrsrv)

Установка компонентов VC 

  1. Скопировать актуальный архив дистрибутива с фтп, например отсюда - ftp://ftp.ucs.ru/VirtualCard/vc_4_2_09.zip. Распаковать в отдельный каталог, например - D:\RK7\VirtualCard (если установка проводится на ПК где уже установлен RK7).
  • Примерное содержимое каталога \VirtualCard после распаковки архива дистрибутива:
\mrsrv      - каталог сервера голосований
\ServLic    - каталог с утилитой лицензирования
\vc         - клиентская часть виртуальной карты
\vcsrv_RK6  - полная сборка серверной части виртуальной карты для работы с RK6
\vcsrv_RK7  - полная сборка серверной части виртуальной карты для работы с RK7
  • Клиентская часть (\VC) отвечает за регистрацию по телефону(содержит главные формы приложения, которые видит клиент при регистрации по телефону), серверная часть (\vcsrv) отвечает за связь с серверами РК7, R-Keeper CRM, резервированием и оператором сотовой связи и пр.
  1. Определиться с используемым веб-сервером. Если IIS (рекоммендуется) - см. пункты 2.1.х. Если XSP - см.пункты 2.2.х.

Диспетчер веб-сервисов IIS

1. Если для поддержки серверной и клиентской части будет использоваться IIS необходимо в ОС Windows активировать его компоненты. Подробная информация здесь - http://support.ucs.ru/ru/node/8649.

2. Запустить диспетчер служб IIS ([Панель управления] \ [Все элементы панели управления] \ [Администрирование] и в нем добавить клиентскую и серверную части для сайта.

  • Для этого необходимо прописать путь к сборке сервера и задать по отдельному порту как серверу (vcsrv) так и клиенту (vc). Пример:
  • Добавление серверной части. Добавить сайт, например VC_SERVER. В качестве физического пути прописать путь к конечному каталогу \vcsrv\. Чем короче будет путь тем лучше, например - D:\RK7\VirtualCard\vcsrv (или как на скриншоте).
  • Присвоить порт, например - 8087.
  • Пул приложений редактировать не обязательно.

Рис. - Добавление веб-сайта для серверной части

3. Добавить клиентскую часть vc.

  • Добавить сайт, например VC_CLIENT.
  • В качестве физического пути прописать путь к конечному каталогу \vc\site\vc\. Например, - D:\RK7\VirtualCard\vc\site\vc
  • Присвоить порт, например - 8011. 
  • Пул приложений редактировать не обязательно.

 

Рис. - Добавление веб-сайта для клиентской части

  • Дополнительно: на машинах с 64-битными ОС разрешить поддержку 32-битных приложений. Настраивается это в свойствах соответствующего пула приложений. Правой клавишей на соответсвующем пуле выбрать пункт "Дополнительные параметры...". Произвести данную настройку для пула и клиента и сервера.
  • При изменении содержимого в каталоге клиентской или серверной части (редактирование ini-файлов, замена dll) необходимо перезапустить пулы приложений (или весь веб-сервис).

Рис. - Дополнительные параметры пула для клиентской части

Рис. - Дополнительные параметры пула для серверной части

Важно! В обязательном порядке добавить каталоги с содержимым ПО "Виртуальная карта" в исключения антивируса, брэндмауэров, файерволов и прочих приложений безопасности ОС Windows.

XSP Mono.webserver

1. Если будет использоваться XSP, в этом случае, необходимо будет поставить отдельный экземпляр XSP для поддержки сервера vcsrv и отдельный экземпляр для поддержки клиентской части vc.

  • По-умолчанию, в дистрибутиве XSP содержится только в каталоге клиентской части \vc радом с каталогом \site.
  • К XSP относятся следующие компоненты:
\xsp       - содержит сам моно веб-сервер и его компоненты;
start.bat  - файл параметров и запуска сервера;
web.config - дополнительный конфигурационный файл сервера.

2. Реорганизовать (не обязательно) каталоги серверной и клиентских (если их несколько) частей.

Важно! Большинство каталогов (например - \VirtualCard, VC_ExtOrd и прочие) в предложенном варианте созданы вручную!

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

Рис. - Один из вариантов организации каталогов модулей для разных режимов работы VC

 - краткое пояснение:

->\VirtualCard  - корневой каталог ПО;
--> \VC_ExtOrd   - содержит экземпляры клиентских частей VC настроенные для режима работы "ExternalOrders";
---> \VC_EO      - каталог клиента VC для режима "ExternalOrders" для мобильных платформ;
----> \site      - содержимое сайта клиентской части;
----> \xsp       - экземпляр моно-сервера для запуска данного экземпляра клиента VC_EO
---> \VC_RkOrder - каталог клиента VC для ExternalOrders для настольных платформ;
----> \site      - содержимое сайта клиентской части;
----> \xsp       - экземпляр моно-сервера для запуска данного экземпляра клиента VC_EO
--> \VC_FF       - каталог клиента VC для режима "Fastfood" для мобильных платформ,
                  содержит и \site и \xsp по аналогии с вышеописанными клиентскими частями;
--> \VC_Rest     - каталог клиента VC для режима "Restaurant" для мобильных платформ,
                  содержит и \site и \xsp по аналогии с вышеописанными клиентскими частями;

Рис. - Организация каталогов сервера

  • \vcsrv - серверный каталог организуется аналогично клиентским. То есть, со своим экземпляром сервера XSP и содержимым сайта в отдельном каталоге (в примере, это \vcsrv\site\vcsrv).

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

  • По сути, минимальный состав ПО будет состоять всего из двух сайтов: сервера vcsrv и клиента vc (настроенного на нужный режим работы).  А для их запуска потребуется по отдельному xsp моно-серверу.

3. Настроить параметры запуска экземпляра XSP для сервера vcsrv.

  • Отредактировать содержимое файла start.bat (при помощи него будет запускаться экземпляр веб-сервера):
@echo off 
cd /D .\site\vcsrv\         - указать верный путь до конечного содержимого каталога \vcsrv;
start %~dp0\xsp\Mono.WebServer.XSP.exe --address 0.0.0.0 --port 8084 --root . --applications /:. 
                            - указать значение порта, на котором будет запущен XSP.
  • Так же, если в дальнейшем планируется запускать XSP в виде службы необходимо, дополнительно отредактировать строки в конфигурационном файле - Mono.WebServer.XSP.exe.config:
    <add key="ServerParameters" value="--verbose --address 0.0.0.0 --port 8084 --root D:/ --applications /:.//RK7/VirtualCard/vcsrv/site/vcsrv"/"/>

 - указать путь к содержимому веб-компонентов vcsrv и значение (должно быть уникальным) порта для запуска.

4. Дополнительно, рекоммендуется создать и вывести на рабочий стол в каталог \VirtualCard ярлык для файла start.bat для удобства запуска экземпляра сервера.

5. Те же действия (3.2.3-3.2.4) проделать для экземпляра сервера клиента VC.

Установка и запуск XSP службой

Для установки веб-серверов XSP в виде служб придется выполнить ряд дополнительных действий:

  • Скачать с фтп утилиту:  ftp://ftp.ucs.ru/r-keeper/WebMonitor_v4/util/InstallUtil.exe и поместить в каталог \XSP.

  • Задать параметры в файле Mono.WebServer.XSP.exe.config каталога сервера xsp (описано выше - см.пункт 2.2.3).

  • Выполнить в командной строке команду (запустив ее от имени администратора):

<InstallUtil path>\InstallUtil.exe <xsp server path>\Mono.WebServer.XSP.exe
  • В появившемся диалоговом окне ввести полное имя пользователя в формате <Computer name>\<user name> и пароль (В список служб ОС Windows будет установлена соответствующая служба).

  • Запустить службу в окне служб в администрировании.

Для удаления службы:

  • Выполнить в командной строке команду:

<InstallUtil path>\InstallUtil.exe <xsp server path>\Mono.WebServer.XSP.exe -U

Важно! На некоторых редакциях ОС описанных действий недостаточно для запуска XSP в качестве службы (например, есть обсуждение подобной проблемы - http://tracker.ucs.ru:8080/redmine/issues/31943). В таком случае, крайне рекоммендуется перейти на IIS.

Лицензирование

  • Начиная с версии ПО "Виртуальная карта" v4.0.05 и выше используется механизм лицензирования.
  • Для работы потребуется прописать в настройках ПО программный лицензионный ключ, который необходимо получить (на запускаемый объект) через портал: www.l.ucs.ru.
  • Дополнительно, необходимо учитывать, что во время своей работы, ПО "Виртуальная карта" будет периодически (минимум один раз в три дня) выходить в интернет и связываться с порталом l.ucs.ru для сверки данных своей лицензии.
  • Наличие физического ключа не требуется.
Подробно:
  1. На сайте www.l.ucs.ru запросить на запускаемый объект и оплатить мастер-лицензию "Virtual Card".
  2. Дождаться одобрения и появления ее в списке "Мастер-лицензий".

Рис. - Заказ мастер-лицензии на l.ucs.ru

  1. Запустить из дистрибутива VC утилиту - \ServLic\ServLic.exe. При ее старте будет сразу сформирован файл - wap.lic.
  2. Вписать полный код объекта (ресторана).
  3. Нажать "Create New" (если делается первый раз) или "Generate" (если необходимо перегенирировать лицензию) - отобразиться  код запроса.
  4. С полученным кодом запроса пройти на сайт l.ucs.ru, найти объект, и обычным образом сгенерировать лицензию на Virtual Card используя полученный код запроса.
  • Т.е. после подтверждения мастер-лицензии создать новую лицензию(сублицензию), указав дату окончания лицензии и кол-во лицензий.
  • В поле запроса лицензии на сайте скопировать строку из текстового поля в группе "License request" приложения ServLic.exe:

Рис. - Генерация кода запроса

  • Для получения информации о лицензии можно нажать кнопку "Call".
Важно! Кнопку "Create New" нажимать только для генерации нового запроса лицензии, т.к. при повторном нажатии сведения о текущей лицензии удаляются! При нажатии кнопки "Create New" происходит перезапись существующей лицензии и будет сгенерирован новый запрос лицензии, который потребует перегенерирования лицензии на сайте l.ucs.ru! 
  1. Сформированный ранее файл wap.lic перенести в каталог \vcsrv\DB
  2. В том же каталоге запустить утилиту vclic.exe. Она удалит файл wap.lic и вместо него создаст файл - ucss.db, который в дальнейшем будет использован при проверке лицензии.
  • Таким образом, если будет утеряна ucss.db сформированная ранее и пролицензированная на l.ucs.ru, для генерации новой, придется удалить с l.ucs.ru предыдущую рабочую лицензию .  Средствами нашего отдела лицензирования. И только затем генерировать новую - по данным нового запроса и файла из Servlic.exe.
  • Отсюда вытекает еще один вывод: что при обновлении ПО Виртуальная карта файл ucss.db должен быть не затронут!
  • А так же формируя другой экземпляр или при переносе на другой ПК, этот файл так же должен быть использован в сборке, иначе придется удалять и генерировать новую лицензию для VC на l.ucs.ru.
Примечание: во время работы Виртуальная карта периодически (при каждом перезапуске или смене даты) отправляет запрос на проверку актуальности на адрес l.ucs.ru:60606. Максимальное время автономной работы - 72 часа. В праздничные дни это время увеличивается.
 
Важно! Для связи с RK.CRM, дополнительно, потребуется программный код лицензии для внешних подключений "GlobalType". Его необходимо запросить и получить заранее, связавшись с отделом лицензирования компании "ЮСИЭС". Код потребуется указать в cs5.ini (см.соответствующий раздел ниже).

Настройка серверной части VC

Серверная часть ПО "Виртуальная карта" содержит массу конфигурационных и системных файлов для связи с различными (как производства "ЮСИЭС", так и сторонними) програмными комплексами.

Ниже приведена таблица некоторых (ключевых) системных и конфигурационных файлов сервера и их краткое описание.

Таблица - Перечень некотороых (ключевых) системных файлов входящих в состав vcsrv
№ п.п. Расположение и название файла Описание
1 \vcsrv\settings.ini Содержит общие настройки сервера vcsrv.
2 \vcsrv\ips.ini Содержит настройки взаимодействия сервера vcsrv с RK7.
3 \vcsrv\bin\ips.dll, ips2.dll, ips3.dll, vcsrv.dll, rk7xml.dll Системные библиотеки которые, в частности, отвечают за связь кассовым сервером RK7.
4 \vcsrv\bin\icas.dll Задействована для связи vcsrv с кассовым сервером в случае работы с бронированием.
5 \vcsrv\bin\icas.ini  Содержит параметры связи сервера vcsrv с касссовым сервером.
6 \vcsrv\reserv.ini Содержит дополнительные настройки для связи с сервером бронирования rsvserv.
7 gater.dll, gater.ini Связь с vcsrv с rsvserv.
8 smsconsult.dll, smsconsult.ini Задействованы при отсылке sms-уведомлений при проблемах с лицензией через sms-провайдера - MobiService.
  • Дальнейшая установка предполагает правку конфигурационных файлов из состава vcsrv и настройки в самих приложениях с которыми производится интеграция виртуальной карты.

Общие настройки

  • Откорректировать конфигурационный файл основных настроек сервера vcsrv - settings.ini:

settings.ini (каталог \vcsrv\)

[VERSION]
RK=7               - Указать версию RK с которым настраивается. 6 - для RK6. 7 - для RK7 (по умолчанию);

[LICENSE]                  - Раздел настроек отправки сервисных sms-сообщений при проблемах с лицензией;
SmsSender=USC              - Указать имя отправителя (не более 11 символов, латиница);
SmsReceiver=+70000000000   - Указать номер телефона получателя сервисных sms-уведомлений;
ExpDays=5                  - Количество дней, в течение которых будут отправляться sms об окончании срока лицензии (по-умолчанию 14 дней);

[AUTH]
SessionTimeOut=120         - Указать время активности сессии (в минутах) при работе в клиенте vc. По-умолчанию 30 минут;
SMSDuration=10             - Время активности кода sms (в секундах). По-умолчанию 180 секунд;

[LOGGING]
LogFileMaxSize=1000000     - Размер файла лога в байтах;
LogLevel=4                 - Уровень логирования;

[SERVICE]
Lang=rus                   - Язык системы по-умолчанию;

smsconsult.ini (каталог \vcsrv)

Сервер vcsrv при проблемах с лицензией может отправлять сервисные sms-уведомления на указанный телефон. SMS-оператор к использованию предлагается тот же, что и в настройках конфигуратора RK.CRM - "MobiService". 

  1. Отредактировать конфигурационный файл smsconsult.ini:
[MAIN]
Link=http://service.smsconsult.ru
Login=usc 
Password=пароль

Примечание: Login и Psw предоставляются оператором. Можно использовать те же, что и в CRM.

  1. Отредактировать конфигурационный \vcsrv\settings.ini раздел [License] - см. предыдущий раздел.

Настройка взаимодействия с RK.CRM

Виртуальная карта вплотную взаимодействует с ПО R-keeper.CRM. Необходимо настроить связь и выполнить некоторые дополнительные настройки для работы VC с CRM.

Редактор карт - Cards_Editor.exe и Конфигуратор - Configurator.exe

  1. В Редакторое карт: [Файл] - [Классификаторы ПО] - добавить классификатор ПО для виртуальной карты и задать ему код.
  • По необходимости, привязать к классификатору типы счетов, например для акции "Пригласи друга", которая работает в паре с Виртуальной картой.
  1. Настроить связь с sms-оператором для sms-рассылки. Для этого, запустить конфигуратор и выполнить настройки для приложения "Карточная система" на вкладке SMS.
  • В качестве провайдера может выступать любой провайдер, поддержанный на данный момент. Список провайдеров смотрите здесь http://support.ucs.ru/ru/node/8630#header-14.
  • Если предлагаемый оператор не устраивает, для использования другого, потребуется разработка новой библиотеки поддержки протокола нового оператора. 
  • Дополнительно, следует обратить внимание на поля: "Текст sms-сообщения при регистрации в карточной системе". Пример текста показан на рисунке ниже.

Рис. - Настройки сервера для отправки смс в конфигураторе

  1. В редакторе карт необходимо добавить тип адреса "Адрес доставки" и прописать его ID (посмотреть в базе) в файле cs5.ini.

Рис. - Добавление типа адреса в CRM

Рис. - Выяснение ID типа адреса, при помощи SQL Managment Studio. Просмотр таблицы CARD_ADDRESS_TYPES

  1. Настроить параметры акции "Пирамида" ("Пригласи друга") - если планируется к использованию.

Примечание: Подробная информация по настройке акции "пирамида" для RK7+Rk.CRM находится здесь - ftp://ftp.ucs.ru/books/r-keeper_crm_virtual_card.pdf (раздел 3.2.21.20 указанного руководства пользователя).

  • Если коротко, то в Редакторе карт должна быть настроена акция "Пирамида [csa_Pyramid.dll]" и она же выбрана в конфигураторе в качестве акции "Для регистрации друга":

   

Рис. - Настройки в конфигураторе для работы акции "Пирамида"

cs5.ini (каталог \vcsrv\)

Конфигурационный файл cs5.ini из состава сервера vcsrv содержит настройки связи сервера виртульной карты с RK.CRM.

  1. Необходимо указать/настроить параметры связи с RK.CRM в \vcsrv\cs5.ini. Пример:
[CS5]
;--- IP-адрес машины, где установлен сервер авторизации карт
IP=198.154.196.215
;--- порт сервера авторизации карт R-Keeper CRM
Port=9191
;--- тайаут соединения
TimeOut=60
;--- код классификатора ПО из редактора карт из п.5.3.1.1
TerminalType=1
;--- код лицензии для внешних подключений к R-Keeper CRM. Должен быть получен заранее через отдел лицензирования компании "ЮСИЭС".
GlobalType=FQvTNcT0258HHc9C9akF

[CONTACTS]
;---- по справочнику типов контактов
;; идентификаторы необходимо посмотреть в базе
;--- идентификатор Страны (таблица CARD_COUNTRIES)
CountryId=1
;--- идентификатор города (таблица CARD_CITIES)
CityId=10000000000001
; Id типа контактов: e-mail (таблица CARD_CONTACT_TYPES)
EmailTypeId=251
; Id типа контактов: телефон (таблица CARD_CONTACT_TYPES) 
PhoneTypeId=250
; id типа адреса доставки (таблица СARD_ADDRESS_TYPES)
DeliveryAddressTypeId=251

[TRANSACTIONS]
AccountTransactionsRowsNumber=100
CardTransactionsRowsNumber=100
Currency=руб.
AccountClass=1
DebitPriority=1,2
HasCredit=
  • Значения кодов или ID выясняют, как правило, через SQL Managment Studio открывая соответствующие таблицы базы RK.CRM.

Настройка взаимодействия с RK7

  1. В Менеджерской RK7 cоздать и подвязать на кассовый сервер xml-интерфейс (как физический, так и логический) который будет задействован для связи с сервером vcsrv. 

Рис. - Подвязка xml-интерфейса

  1. В свойствах интерфейса на кассовом сервере задать уникальное значение порта ("Port"), которое затем будет указано в ips.ini (см.ниже, параметр - "MidIP").
  2. Отредактировать из состава сервера (vcsrv) конфигурационный файл - \vcsrv\ips.ini, который содержит параметры необходимые для корректной работы сервера vcsrv с RK7.

ips.ini (каталог \vcsrv)

[RK7]
;--- указать код кассовой станции от имени которой будет работать
StationCode=1
;--- указать значение поля [код] логического интерфейса используемого для связи с R-Keeper.CRM (справочник [сервис] - [интерфейсы])
InterfaceCode=1
;--- указать значение поля [код] работника-кассира для выполнения некоторых действий в VC (должен быть создан в менеджерской РК7)
CashierCode=3565
;--- для связи с кассовым сервером RK7 обязательно должны быть заданы MidIP(IP-адрес машины) и MidPwd
MidIP=192.168.100.103:17771 
;--- MidPwd = CryptKey в свойствах XML-интерфейса из п.5.1.1, если задан. 
MidPwd=
;--- код виртуального стола (должен быть создан в менеджерской РК7)
VirtualTable=212
;--- код виртуального официанта (должен быть создан в менеджерской РК7)
VirtualWaiter=3565
;--- код макета пречека (из менеджерской РК7 - Документы и макеты)
BillPreviewCode=1002204
;--- идентификатор селектора, с которого начинается дерево меню
DefaultSelectorIdent=11048
;--- каталог для сохранения xml с заказами (должен быть доступен из кассы)
;--- ссылки типа \\198.154.196.35\extsave не проходят по критериям безопасности IIS
OrderXMLPath=D:\tmp\
;--- каталог для заказов, не прошедших оплату на кассе из-за ошибок системы
OrdersWithErrors=D:\tmp
;--- время устаревания закачанных с RK данных (в секундах)
UpdateTime=60

;----------------- Сообщения официантам ------------------
;--- отправлять всем официантам, обслуживающим стол (1-Да, 0-Нет)
SendToAll=1
;--- код официанта, который всегда получит сообщение, если не задан промокод ;
DefaultWaiterCode=3565
;--- время активности сообщений для официанта (в секундах)
WaiterMessageTimeToLive=3600

;------------------ Cлужебный раздел ---------------------
[SERVICE]
;--- язык интерфейса
Lang=RUS
;--- размер файла лога в байтах
LogFileMaxSize=1000000
;--- уровень логирования
LogLevel=4

[ORDERS]
;------------------ Коды заказов --------------------------
;--- минимально значение
LastOrderCodeMinValue=1000
;--- максимальное значение
LastOrderCodeMaxValue=9999
;--- последнее значение (НЕ РЕДАКТИРОВАТЬ)
;--- последний сохраненный заказ
LastOrderCode=1026

Дерево меню 

Для работы с меню через кабинет виртуальной карты в рамках RK7 потребуется организация отдельного меню.

  1. В справочнике [Дерево меню] создать трехуровневое меню (3 уровня до блюда).

Примечание: дерево меню организуется практически так же как это делается и при настройке ПО "Rk-Order" - http://support.ucs.ru/ru/node/5208#header-10.

Типы заказов (для режима работы - External Orders)

  1. Проверить наличие типов заказа ("Общий", "С собой", "С доставкой"). Если их нет - создать. Связать их с используемой категорией заказа.

Типы расширенных свойств (для режима работы - External Orders)

При работе в режиме ExternalOrders с возможностью оплачивать заказы необходимо завести в RK7 несколько валют, но перед этим - необходимо создать несколько типов расширенных свойств для валют.

  1. Создать типы расширенных свойств:

Рис. - Создание и настройка типа расширенных свойств для валют - ExtPaymentName

Рис. - Создание и настройка расширенных свойств для валют - ForDelivery

Рис. - Создание и настройка расширенных свойств для валют - Promised

  • Отдельно, создать расширенное свойство "ForVCard":

Рис. - Создание и настройка расширенного свойства ForVCard

  • Прописать у кассовой станции значение «1» для данного расширенного свойства:

Рис. - Привязка расширенного свойства ForVCard к кассе
  1. Добавить еще несколько типов расширенных свойств.
  • [name0409] – [список типов] – [Валюты] – [Валюта]   // для названия валюты на английском

Рис. - Добавление расширенного типа свойств валют - name0409

  • [name0419] – [список типов] – [Валюты] – [Валюта]   //  для названия валюты на русском

Рис. - Добавление расширенного типа свойств валют - name0419

Путь к каталогу с картинками иконок

  • [imagePath] – [список типов] – [GUI] - [Страница селектора]   //  для иконок групп меню.

Важно! В свойствах страницы селектора вписать только название картинки, сами картинки складывать в папку \vcsrv\ico\.

Рис. - Добавление расширенного типа свойств - ImagePath

Картинки блюд

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

  • Картинки для блюд должны находиться в клиентской части VC, а именно, в каталоге \vc\images\dishes\,
  • Название файла картинки необходимо прописывать в свойстве блюда «Файл с большой картинкой»

Важно! для отображения свойства [Файл с большой картинкой] необходимо открыть: [Все] - [Установочные] - [Путь к каталогу с картинками] и включить параметр [Все] - [Использование опций] - [Самообслуживание/Интернет Заказы].

Рис. - Привязка изображения к блюду

Валюты (для режима работы - External Orders)

  1. Добавить валюты для отображения при формировании заказа в режиме "EO" и настроить для них расширенные свойства:

Рис. - Создание валют и настройка свойств ("Оплата карточкой курьеру")

Рис. - Создание валют и настройка свойств ("Оплата наличными курьеру")

Рис. -  Создание валют и настройка свойств ("Оплата через Asist")

 

!!!!!!!!!!!!!!!!!!!!!!!!!

 

Настройка взаимодействия с RK6

!!!!!!!!!!!!!!!!!!!!Рассмотрено в отдельной статье - 

Настройка связи с Cистемой Резервирования (бронирования) - Reserv

Как уже писалось выше, для работы системы резервирования в составе виртуальной карты, если она задействована,  данная система должна быть предварительно настроена, связана с RK,  запущена и нормально функционировать на объекте. 

Примечание: информация по установке, настройке системы резервирования - http://support.ucs.ru/ru/node/7240.

Менеджерская RK7 - rk7man.exe и настройка vcsrv

В менеджерской RK7 для связи VC с системой должен быть прописан ряд параметров:

  1. Убедиться что на кассовом сервере подключен XML-интерфейс для системы бронирования - http://support.ucs.ru/ru/node/7240#header-14.
  • Параметры порта xml-интерфейса задействованного на кассовом сервере прописать в конфигурационном файле \vcsrv\bin\icas.ini (см.ниже).

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

icas.ini (каталог \vcsrv\bin )

  1. Отредактировать из состава сервера (vcsrv) конфигурационный файл - \vcsrv\bin\icas.ini.
[Options]
LogLevel=3
Server=192.168.100.103:17771 - адрес mid-сервера и порта xml-интерфейса подвешенного на сервере для работы с сервером бронирования

reserv.ini (каталог \vcsrv\)

  1. Отредактировать файл reserv.ini - прописать код работника (хостес) и пароль из менеджерской РК7. 
[RESERV]
user=3565
pswd=356

Примечание: работник (хостес) должен обладать правом резервирования/бронирования столов.

gater.ini (каталог \vcsrv\bin\)

  1. Отредактировать файл gater.in - прописать параметры связи с сервером резервирования (rsvserv):
[Options]
LogLevel = 3
LinkDll = Rtcp
/Language=ENG

[RTcp]
Client1 = GATER89xxx
Server1 = 192.168.100.205
Port1 = 7777

Примечание: параметры подключения те же, что и в настройках (раздел [RTcp] в reserv.ini) клиентского приложения (\Hostess\Reserv.exe) из состава ПО "Резервирование".

Настройка связи с TMS (RkMobWaiter)

  • При работе с виртуальной картой, некоторые операции (например считывание QR-кода с телефона клиента, - для привязки клиента к заказу, или при работе с акцией "Пирамида") могут выполняться официантами при помощи ПО "Мобильный официант" (RkMobWaiter), если таковое установлено и используется в заведении.
  • Т.е. при необходимости, - отображенный на экране мобильного устройства гостя QR-код - считывается камерой мобильного устройства официанта (работника заведения) непосредственно из интерфейса ПО "RkMobWaiter".

В таком случае, необходимо что бы была настроена связь модуля TMS с модулем Farcards настроенным на связь с RK.CRM. Со стороны TMS для связи с Farcards используется RtcpGate.dll. Параметры связи указываются в конфигурационном файле TMS7.ini (если речь о TMS RK7).

  1. Для связи TMS с RK.CRM отредактировать раздел [RTGI] в конфигурационном файле TMS7.INI:

TMS7.INI

[RTGI] - раздел настроек связи с ПДС
Interface=1            - значение кода интерфейса CRM подвешенного на кассовом сервере RK7
Addr=172.22.3.71:3356  - адрес и порт farcards настроенного на связь с CRM
Cashier=555            - код кассира
  1. В mwnsettings7.xml проверить что в секуии  <RK7> есть параметры DiscCardRegime="0" и Plustek="0". Пример:
...
<RK7 EditDraft="1" UseCodeNameChoice="0" UseCodeByDefault="0" UseHorzOrientation="0" 
StepByStepNewOrder="0" FastFoodScanNumber="0" FastFoodDigNumber="4" HideDefModifiers="1" BigMenu="0" NewDishNewString="1"
OrderComplete="1" Suggestions="1" CanSpeakSuggestions="1" DiscCardRegime="0" Plustek="0"/>
...

Установка, настройка сервера учета результатов голосования (каталог \mrsrv) - mrsrv.exe

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

  • самого сервера - mrsrv.exe и его системных и конфигурационных файлов (находятся в каталоге \mrsrv\mrsrv);
  • базы сервера - msgrdr.fdb (на базе СУБД Firebird);
  • утлилиты просмотра оценочной статистики - MsgReader.exe и ее компонентов
  1. Установить СУБД Firebird стандартным образом (если он не установлен).
  2. Скачать и установить Firebird ODBC драйвер. Например отсюда - http://www.firebirdsql.org/en/odbc-driver/ - Firebird_ODBC_2.0.3.154_Win32.exe (для x86).
  3. Далее, необходимо создать источник (alias) ODBC:
  • Открыть [Панель управления] - [Администрирование] - [Источники данных] Data Sources (ODBC);

Примечание : Если используется ОС Win x64, то для конфигурирования 32-разрядного драйвера необходимо запускать %systemdrive%\Windows\SysWoW64\odbcad32.exe, т.к. по умолчанию запускается конфигурирование 64-разрядных драйверов: %systemdrive%\Windows\System32\odbcad32.exe;

  1. Перейти на закладку [System DSN] - нажать кнопку "Add" - выбрать драйвер firebird/interbase driver.
  2. Прописать и сохранить параметры драйвера. Пример для Firebird ODBC представлен на рисунке ниже:

Рис. - Настройка к базе Firebird через ODBC

Важно! Даже если используется ОС x64 необходимо устанавливать Firebird 32-bit, Firebird ODBC driver 32-bit.

mrsrv.ini (каталог \mrsrv\mrsrv)

  1. Перейти в каталог с сервером оценок \mrsrv\mrsrv и откорректировать его конфигурационный файл mrsrv.ini.
[MAIN]          - основной раздел;
Ip=172.22.4.79  - указать внешний адрес ПК на котором работает сам сервер;
Port=5678       - указать уникальный порт для связи с ним;

[DB]            - раздел подключения к базе данных;
DSN=MSG_READER  - указать имя системного источника данных DSN (настроенного ранее в ODBC драйвере);
UserId=SYSDBA   - указать пользователя системного источника данных DSN (настроенного ранее в ODBC драйвере);
PWD=masterkey   - указать пароль системного источника данных DSN (настроенного ранее в ODBC драйвере);

[OPTIONS]       - раздел дополнительных настроек;
Lang=ENG        - локализация сообщений.
  1. Запуск сервера осуществляется простым стартом - mrsrv.exe. Работает в виде настольного приложения:

Примечание: дополнительных параметров/ключей запуска не предусмотрено.

mrsrv.ini (каталог \vcsrv)

  1. Настроит подключение сервера виртуальной карты к серверу голосований. Отредактировать конфигурационный файл из состава сервера виртуальной карты \vcsrv\mrsrv.ini:
[MRSRV]
IP=172.22.4.79  - указать адрес сервера голосований;
ServPort=5678   - порт сервера голосований;
TimeOut=60      - таймаут ожидания.

Клиентское приложение - MsgReader.exe

Для просмотра записей в базе используется клиентское приложение - MsgReader.exe.  Содержится в каталоге \mrsrv\MsgReader. Ниже представлено примерное содержимое каталога:

\Log           - каталог логирования;
MsgReader.exe  - клиентское приложение;
settings.dat   - файл настроек;
nlog.config    - системный файл;
NLog.dll       - системная dll.
  1. Вывести ярлык приложения на рабочий стол.
  2. Запустить, войти в меню настроек - откорректировать DSN, имя и пароль при необходимости:

Рис. - Вход и настройка подключения приложения MsgReader.exe

Настройка клиентской части VC

  • Заход в броузере в личный кабинет виртуальной карты происходит через клиентскую часть программного комплекса.
  • Основные параметры и настройки для клиентской части прописываются в конфигурационном файле - \site\vc\App_Data\settings.xml.

Примечание: при редактировании, необходимо соблюдать структуру xml-файла, т.к. при ее нарушении, все настройки или их часть работать не будет.

Настройка разных режимов работы

settings.xml (каталог \site\vc\App_Data)

  1. Отредактировать конфигурационный файл \site\vc\App_Data\settings.xml. Пример:
  <?xml version="1.0" standalone="yes" ?>
- <Settings>
- <!-- Включение/выключение демо-режима (в демо-режиме используются фиксированные локальные данные)  -->
  <Param Name="DemoMode" Value="0" />
- <!-- Адрес источника данных   -->
  <Param Name="DataSrc" Addr="http://172.22.4.81:8282/default.aspx" />
- <!-- Язык интерфейса
Value="ENG" Английский
Value="RUS" Русский   -->
  <Param Name="DefaultLanguage" Value="RUS" />
- <!-- Режим работы. Возможные значения: Restaurant, Fastfood, ExternalOrder   -->
  <Param Name="Mode" Value="ExternalOrder" />
- <!--
Value="0" Всегда требовать авторизацию
Value="1" Если пользователь уже зарегистирован в системе, то он перенаправляется сразу к странице с qr-кодом, минуя этап авторизации   -->
  <Param Name="GoToQrCode" Value="1" />
- <!-- Включить/выключить функционал "Пригласить друга"   -->
  <Param Name="InviteFriend" Value="0" />
- <!-- Включить/выключить функционал "У меня уже есть пароль"   -->
  <Param Name="UseHavePWD" Value="0" />
- <!-- Включить/выключить функционал бронирования   -->
  <Param Name="UseBooking" Value="0" />
- <!-- Включить/выключить функционал "Журнал заказов"   -->
  <Param Name="UseOrdersJournal" Value="1" />
- <!-- Включить/выключить функционал "История заказов"   -->
  <Param Name="UseOrdersHistory" Value="1" />
- <!-- Включить/выключить функционал "Профиль"   -->
  <Param Name="UseProfile" Value="1" />
- <!-- Включить/выключить функционал "О приложении"   -->
  <Param Name="UseAbout" Value="1" />
- <!-- Включить/выключить функционал оплаты через Asist   -->
  <Param Name="UseAsist" Value="1" />
- <!-- Включить/выключить функционал оплаты   -->
  <Param Name="CardUsing" Value="1" />
- <!-- Максимальное число гостей   -->
  <Param Name="MaxGuests" Value="7" />
- <!-- Расписание работы заведения (учитывается при бронировании)   -->
- <Shedule>
  <Sunday Intervals="0:00-2:00 11:00-22:00" />
  <Monday Intervals="11:00-22:15" />
  <Tuesday Intervals="11:00-20:00" />
  <Wednesday Intervals="17:00-23:00" />
  <Thursday Intervals="11:00-22:00" />
  <Friday Intervals="20:45-23:59" />
  <Saturday Intervals="0:00-4:00 11:00-23:59" />
  </Shedule>
- <!-- Qr-код в истории заказов   -->
  <Param Name="QrCodeInHistory" Value="1" />
- <!-- Время жизни зафиксированного заказа (указывается в минутах)   -->
  <Param Name="FixedOrderLifeTime" Value="120" />
- <!-- Страна и город, заданные по-умолчанию  -->
  <Param Name="DefaultCountry" Id="1" Country="Russia" />
  <Param Name="DefaultCity" Id="1" City="Moscow" />
- <!-- <Param Name="DefaultCity" Id="10000000000001" City="Moscow"/>  -->
- <!-- Возможная задержка доставки (мин.)   -->
  <Param Name="DeliveryDelay" Value="60" />
- <OrderMsgTemplates>
  <Msg info="CallTheWaiter" img="ico/icon_order_service.png" />
  <Msg info="Calculate" img="ico/icon_order_check.png" />
  </OrderMsgTemplates>
- <CommonMsgTemplates>
  <Msg info="CallTheWaiter" img="ico/icon_order_service.png" />
  </CommonMsgTemplates>
- <WaiterMsgTemplates>
  <Msg info="PleaseCalculate" img="ico/icon_order_service.png" />
  </WaiterMsgTemplates>
  </Settings>

- где, обязательно прописать IP и порт подключения клиента VC к серверу vcsrv и один из трех предложенных режимов работы виртуальной карты: Fastfood, Restaurant или ExternalOrder (см.выше, настройки выделены цветом).

  • Остальные параметры, так же необходимо просмотреть и выставить требуемые значения.

Вставка функционала VC в оригинальный сайт заказчика. Использование <iFrame>.

Надо понимать, что клинетская часть VC это по сути обычный сайт, который может быть использован в предлагаемом (оригинальном) виде, либо переделан, создан заново или встроен в другой сайт html-программистами (разработчиками) самого заказчика.

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

Особенности реализации стандартной сборки VC:

 

    1. Оптимизирована для работы на мобильных устройствах (экранные формы сайта/кабинета, шрифты и прочее);
    2. Используемый дизайн разработан компанией ЮСИЭС, в то время как он может быть и авторским;
    3. Вход на сайт обычно осуществляется путем ввода адреса ссылки клиентской части VC в броузере, или данная ссылка может быть интегрированна в какой-нибудь элемент/баннер находящийся на оригинальном сайте заказчика. Т.е. гость для начала должен зайти на сайт заведения и там активировать ссылку.
    • Реализация возможности входа в кабинет VC обычно лежит на плечах специалистов поддерживающих функционирование сайта заведения. С нашей стороны обычно предоставляется только информация по адресной ссылке.
    • Если по каким-то сображениям, стандартный вариант реализации клиентской части VC не устраивает , сайт клиентской части VC можно встроить (как уже отмечалось выше) в оригинальный сайт заведения используя при этом стандартные возможности языка программирования HTML.

    В качестве примера встраивания VC в оригинальный сайт заказчика к статье прикреплена сборка -  vc_rkorder.7z. В данной сборке в Index.html задействовано использование тэга <iFrame> языка HTML позволяющего создать внутри оригинального сайта контейнер с сылкой на содержимое другой веб-страницы (т.е. страницы VC).

    Процесс встраивания или работы с языком программирования относится к разработке, а не поддержке. Т.е. данные действия должны выполняться специалистами в области веб-программирования.

    HTML - iFrame

    Относительно предлагаемого разработчиками компании "ЮСИЭС" использования тэга <iFrame> в соответствующей технической документации по HTML или в интернете можно найти массу информации предназначенной для веб-разработчиков. В частности, например - http://www.exlab.net/html/frames.html.

    Тестовая сборка - vc_rkorder.7z

    VC-RkOrder - не путать с ПО "Rk-Order" ("Электронное меню") это тестовая сборка, оптимизированная для запуска на обычных настольных ПК. Фактически является примером или шаблоном организации собственного сайта VC.

    • Настраивается точно так же как и клиентская часть VC. См.соответствующие разделы данной документации. 
    • Архив этой сборки для тестов прикреплен здесь же - vc_rkorder.7z (см.вложения).

    Ниже приведен пример вставки функционала VC с помощью тэга "iFrame" в Index.html оригинального сайта:

    <!DOCTYPE html>
    <html>
    <head>
        <title>Rk-Order</title>
        <meta charset="UTF-8">
    <link rel="stylesheet" type="text/css" href="styles/index.css" />
    </head>
    
    <body>
    
    <center>
    
    <table class="titleTbl">
        <tr>
    <td valign="middle">
    <!--<div style="font-family: Arial; color: #7b3f18; font-size: 12px; margin-bottom: 7px;">Rus | Eng</div>-->
    <div style="float: left;"><a href="/"><img src="images/flag_eng.png" style="width:48px; height:40px;" alt=""/></a></div>
    <div style="float: left; font-family: Arial; color: #7b3f18; font-size: 12px; margin-top: 10px;"> | </div>
    <div style="float: left; margin-left: 0px;"><a href="/"><img src="images/flag_rus.png" style="width:48px; height:40px;" alt=""/></a></div>
    <div style="clear: both;"></div>
    </td>
            <td align="center">
    
    <div style="float: left; margin-left: 73px;"><a href="/"><img alt="" src="images/soc_vkontakte.png" style="width:25px; height:25px;"/></a></div>
            <div style="float: left; margin-left: 7px;"><a href="/"><img alt="" src="images/soc_odnoklassniki.png" style="width:25px; height:25px;"/></a></div>
    <div style="float: left; margin-left: 7px;"><a href="/"><img alt="" src="images/soc_facebook.png" style="width:25px; height:25px;"/></a></div>
    <div style="float: left; margin-left: 7px;"><a href="/"><img alt="" src="images/soc_twitter.png" style="width:25px; height:25px;"/></a></div>
    <div style="float: left; margin-left: 7px;"><a href="/"><img alt="" src="images/soc_google.png" style="width:25px; height:25px;"/></a></div>
    <div style="float: left; margin-left: 7px;"><a href="/"><img alt="" src="images/soc_instagram.png" style="width:25px; height:25px;"/></a></div>
    <div style="clear: both;"></div>
    
    </td>    
    
    <td>
    
    <table align="right" style="margin-right: 55px; padding:0; border-spacing:0; height: 47px;">
                <tr>
    <td style="cursor: auto; cursor: pointer;">
    
                        <div style="margin-top: 5px; width: 203px; height: 47px; background-image: url('images/city_select_full.png'); background-repeat: no-repeat; background-position: left top;">
                        <!--1-->
                        </div>
    
    </td>
    <td><a href="/"><img src="images/null.gif" alt="" width="15" height="1"></a></td>
    <td><img src="images/lk.png" alt="personal cabinet"></td>
    <td><img src="images/null.gif" alt="" style="width:15px; height:1px;"></td>
    
    <td>
                        <div style="margin-top: 7px;">
                            <a href="/default.aspx?&amp;row=1">
                                <img alt="" src="images/layout_select_grid.png" onMouseOver="this.src='images/layout_select.png';" onMouseOut="this.src='images/layout_select_grid.png';">
                            </a>
                        </div>
                    </td>
                </tr>
    </table>
    
    </td>      
        </tr>
    </table>     
    
    <table class="headerTbl">
        <tr><td align="center">
            <iframe id="frame1" style="width: 1036px; height:210px; margin-top: 10px;" src="start.html"></iframe>
        </td></tr>
    </table>    
    <table class="menuTbl">
        <tr><td align="center">
            <iframe id="frame2" frameborder="0" style="width: 1036px; margin-top: 10px;" src=""></iframe>
        </td></tr>
    </table>    
    
    <table id="bottom_bar" class="bottombarTbl">
        <tbody><tr><td>
            <table style="padding:0; border-spacing:0; border:0; width:100%; background: url(images/footer_bkg.jpg) repeat-x center top; height: 69px;">
                <tbody><tr><td align="center">
                    <table style="width:1000px; border:0; padding:0; border-spacing:0;"><tbody><tr>
                        <td><div class="phone_bottom">8 800 000 080</div></td>
                        <td align="right"><div class="copyright" style="text-shadow: 1px 1px 10px #706f6f;">Copyright © 2008-2015 UCS Corporated. All rights reserved.</div></td>
                    </tr></tbody></table>
                </td></tr></tbody>
            </table>
        </td></tr></tbody>
    </table>       
    
    </center>                            
    </body>
    </html>
     - где:
      <iframe id="frame1" style="width: 1036px; height:210px; margin-top: 10px;" src="start.html"></iframe>

    - ссылается на стартовую страницу самой карты.

    Примечание: данный файл содержится в тестовой сборке - vc_rkorder.7z (см.вложения).

    Запуск

    1. Запустить (перезапустить) все веб-сервера.
    2. Зайти на страницу сайта, например -  http://localhost:8011/ (или указав IP и порт клиентской части), ввести номер телефона и получив код авторизации, авторизваться в системе.

    Рис. - Окно авторизации

    Примечание: подробно работа расписана в пользовательской документации которую, можно скачать по адресу - ftp://ftp.ucs.ru/books/r-keeper_crm_virtual_card.pdf.

    Ошибки и способы их устранения

     При вводе номера телефона система долго обрабатывает запрос, а после выводит сообщение "Нет связи с сервером".

    Решение. Причин может быть несколько - либо клиентская часть виртуальной карты не видит серверную часть, либо серверная часть не может соединиться с кассовым сервером RK7 или сервером авторизации карт R-Keeper CRM.

    В любом случае необходимо проверить формируется ли ips.log в папке Log сервера виртуальной карты. Если лог не формируется, то проблема с правами и разрешениями на обработку и запись у сервера виртуальной карты.

    Проверьте в настройках пула Удостоверение. Если выбрано LocalService, замените на значение LocalSystem и перезагрузите пул.

    ВложениеРазмер
    vc_rkorder.7z39.39 МБ