В рамках данной статьи мы рассмотрим первоначальные настройки, которые необходимо осуществить перед началом работы с мобильным приложением.
Мобильное приложение «1С-Рейтинг: Мобильный официант» используется совместно с конфигурацией «1С-Рейтинг: Ресторан», с которой связан посредством периодического обмена данными. Поэтому перед установкой конфигурации «1С-Рейтинг: Мобильный официант» необходимо сделать соответствующие настройки в программе «1С-Рейтинг: Ресторан».

Настройка информационной базы «1С-Рейтинг: Ресторан»

• Справочник Организация ;
• Справочник Склад ;
• Справочник Касса ;
• Справочник Зал ;
• Справочник Модификаторы ;
• Регистры сведений Модификаторы блюд;
• Регистры сведений Предопределенные позиции заказов ;
• Регистры сведений Маршрутизация печати марок ;
• Справочник Виды меню ;
• Справочник Настройка РМК ;
• Справочник Пользователи.

Настройка пользователей

Автоматическая печать марок

• Выполнять печать марок мобильного официанта – включение данной опции позволяет отправлять на печать марки с информацией о приготовлении.

• Пользователь для печати марок мобильного официанта – необходимо выбрать пользователя из справочника Пользователи , от имени которого будут выполняться процедуры печати. Для осуществления печати марок необходимо запускать сеанс от имени указанного пользователя. Для того чтобы выполнение процедур печати марок не замедляло работу пользователей рекомендуется создать отдельного пользователя (например, «Запуск РМК» или «Печать марок») и запускать отдельный сеанс 1С:Предприятия с данным пользователем для выполнения фоновой печати.

• Интервал печати марок мобильного официанта – в данной настройке указывается интервал времени в секундах для вывода на печать. Заполнение данного параметра, является обязательным для осуществления печати марок. Значение этого параметра выбирается исходя из требований конкретной организации, рекомендуемое значение 10 секунд.

Публикация на веб-сервере

• Ввести вручную имя публикации в поле Имя , при этом оно может состоять только из символов латинского алфавита. Данное имя позже будет вводиться в настройки мобильного приложения.
• В поле Веб-сервер указать тип веб-сервера, для которого выполняется публикация.
• В поле Каталог указать путь к каталогу, в котором будут расположены файлы, описывающие виртуальный каталог.
• Перейти на закладку HTTP сервисы и включить настройку Публиковать HTTP сервисы по умолчанию . В табличной части отметить флагом HTTP сервис Data в перечне доступных сервисов.
• Нажать кнопку Опубликовать . После публикации необходимо перезапустить сервер.

Настройка конфигурации «1С Рейтинг: Мобильный официант»

Активация приложения

• Интернет-активация.

• Офлайн-активация.

Интернет-активация

1. Обеспечить доступ мобильного устройства к сети Интернет.
2. Ввести регистрационный номер в окне Активация приложения и нажать кнопку Активировать .

Офлайн-активация

1. Получить регистрационный номер мобильного приложения. Для этого необходимо обратиться к партнерам компании «1С-Рейтинг» в Вашем регионе или непосредственно в компанию «1С-Рейтинг».
2. В окне Активация приложения нажать на ссылку Офлайн-активация приложения .
3. В окне Офлайн-активация приложения ввести регистрационный номер мобильного приложения.
4. Нажать кнопку Получить код приложения . Откроется окно, содержащее код приложения. Данный код необходимо передать в компанию «1С-Рейтинг». В ответ будет выдан Код активации .
5. Код активации вводится в окне Офлайн-активация приложения в соответствующее поле. По нажатию кнопки Активировать выполняется активация мобильного приложения.
6. После успешной активации, мобильное приложение готово к использованию.

Важно!

После переустановки мобильного приложения потребуется повторная активация.

Настройка подключения к информационной базе «1С-Рейтинг: Ресторан»

• Пользователь – пользователь, под которым будет осуществляться работа в «1С-Рейтинг: Мобильный официант». Пользователи мобильного устройства должны быть заранее созданы в информационной базе конфигурации «1С-Рейтинг: Ресторан».
• Пароль – пароль для авторизации пользователя, указывается в настройках пользователя, в конфигурации «1С-Рейтинг: Ресторан».
• Адрес сервера – в этом поле указывается ip-адрес компьютера, на котором запущен веб-сервер.
• Порт – по умолчанию имеет значение 80. Если веб-сервер был настроен на какой-то другой порт, то здесь необходимо указать его номер.
• Имя публикации – имя, указанное при публикации HTTP-сервиса в информационной базе конфигурации «1С-Рейтинг: Ресторан».

Важно!

Имя пользователя и имя публикации необходимо вводить с учетом регистра букв. Если регистр не совпадет, то в авторизации будет отказано.

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


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

Сообщения при подключении

В процессе подключения мобильного приложения к конфигурации «1С-Рейтинг: Ресторан» могут возникнуть следующие сообщения:

1. «Произошла сетевая ошибка»

Данное сообщение может возникать в том случае, если:

• Потерян сигнал сети Wi-Fi.
• Некорректно настроена работа веб-сервера.
• Остановлена работа веб-сервера – необходимо перезапустить веб-сервер.
• Неверно указан адрес веб-сервера и/или порт.

Данное сообщение означает, что у пользователя не включена роль Доступ к объектам мобильного официанта .
3. «The requested URL /REST/hs/Data/Registration was not found on this server.»
Сообщение при авторизации возникает в том случае, если:
Неверное указано имя публикации.
Имя публикации в Мобильном официанте отличается от имени, указанного в конфигураторе Ресторана при настройке публикации (необходимо проверить совпадает ли имя публикации, важен реестр букв).
4. «1C:Enterprise 8 application error. HTTP: Not found»
Данное сообщение возникает, если при настройке публикации был не выбран HTTP-сервис. Необходимо проверить наличие флагов у настройки Публиковать HTTP сервисы по умолчанию и в табличной части у строки Data .

• (3475)

• Tutorial

Здравствуйте, уважаемые.

В данной статье хочу познакомить вас с новым продуктом “FBA Toolkit”, который существенно облегчает процесс разработки корпоративного мобильного приложения на 1С + Android.
“FBA Toolkit” это:
- разработка «нативного» приложения Android в родной IDE на языке Java;
- 1С: Предприятие 8.1 (8.2) в роли источника данных, корпоративной информационной системы.

В первую очередь, фреймворк будет полезен программистам 1С, которые хотели бы заняться разработкой бизнес-приложений под Android, но испытывают трудности с освоением новой для них платформы. Чтобы начать разработку достаточно будет начальных знаний Java. Далее я покажу, как создать рабочий прототип клиент-серверного приложения буквально за пару часов.

Подготавливаем рабочее место

1. Установить и настроить:
- Java SDK + Eclipse + Android SDK;
- Web-сервер (IIS или Apache);
- 1С: Предприятие 8.1 (8.2)

2. Для Eclipse произвести импорт двух библиотечный проектов: ActionBarSherlock и ru_profu1c_fba из хранилища SVN.

3. Установить дистрибутив конфигурации «FBA» и объединить ее с вашим прикладным решением на базе 1С.

Подробно весь процесс предварительной настройки описан в статьях:
Подготовка рабочего места разработчика
Установка дистрибутива конфигурации “FBA”
Объединение конфигурации “FBA” с прикладным решением и публикация на web-сервере

Настройка не должна занять много времени, и скорее всего, часть необходимого ПО у вас уже установлена.

Описание приложения

1. “Вход” - авторизация пользователя при запуске программы.
2. “Список отчетов” – основной экран нашего приложения. Отображается список доступных отчётов с возможностью просмотра и обновления данных из базы 1С.
3. “Настройки программы” – здесь пользователь задает параметры авторизации и адрес сервера 1С, настраивает расписание автоматического обмена с сервером 1С.

В приложении будет реализовано 2 варианта получения данных от сервера 1С:

1. Отчет «Товары на складах». Формируется на сервере и компилируется как HTML документ, в мобильном приложении просто отображается. Самый простой вариант, форма отчета фиксирована и не может быть изменена.
2. Отчет «Финансовые показатели». Здесь исходные данные для отчета получаются в виде таблицы, по которой затем строится отчет. Плюсы данного варианта: произвольная форма вывода отчета, в т.ч. в виде графиков и диаграмм; возможна установка отборов и сортировки.

Создание шаблона мобильного приложения в 1С

Создайте новый элемент в справочнике «Мобильные приложения» с наименованием «Рапорт руководителю» и идентификатором SAMPLE_REPORT_HEAD .

Выделите в списке “Метаданные” группу “Внешние данные” и нажмите кнопку “Добавить” на панели инструментов. Заполните параметры новой таблицы как показано на рисунке:

«Показатель» - тестовое представление показателя отчета, строка (250)
«Значение» - числовое значение показателя, число (15.2)
Имена колонок и самой таблицы здесь, как правило, задаются на русском языке, по ним будет производиться заполнение таблицы данными средствами встроенного языка 1С. Нажмите ОК, таблица будет добавлена в дерево метаданных, для мобильного приложения имена автоматически переводятся в латиницу.

Таким образом, мы подготовили структуру таблицы значений (в терминах 1С) в которой будем передавать данные для отчета «Финансовые показатели». Для второго отчета «Товары на складах» данные будут передаваться как внешний файл.

На закладке «Схема обмена» проверьте, что отмечен флаг «Выгрузка». Флаг «Загрузка» не важен, т.к. мы не собираемся обрабатывать в 1С полученные изменения этой таблицы от мобильного приложения.

Сохраните изменения. Нажмите на кнопку “Шаблон мобильного приложения” на панели инструментов, установите параметры вашего мобильного приложения

«Каталог шаблонов» - путь к каталогу, в котором будут сохранены сгенерированные файлы шаблона мобильного приложения.

На закладке «Основные» укажите имя пакета, это должен быть уникальный идентификатор. Если у вас есть сайт, используйте его для генерации префикса. В этом примере я указал ru.profi1c.samples.report.head

На закладке «Web-сервис» указан IP-адрес 10.0.2.2, по умолчанию это адрес вашего компьютера при доступе с Android-эмулятора. В поля «Имя веб-сервиса» и «Подкаталог приложения» введите данные, которые были указаны при публикации веб-сервиса.

Обратите внимание, что для 1С 8.2, скорее всего, подкаталог приложения у вас будет с дополнительным подкаталогом /ws , т.е demoFba/ws, подробнее см. .
Нажмите Создать , шаблон Android-проекта будет сгенерирован.

Подготовка исходных данных для отчетов в 1С

Если СокрЛП(МобильноеПриложение.Код) = "SAMPLE_REPORT_HEAD" Тогда Если ИмяТаблицы = "РапортРуководителю" Тогда //фиктивные данные отчета СписокТемп = fbaОбщий.ИзСтрокиСРазделителями("Денежные средства,Расчеты с подотчетными лицами,Общая дебиторская задолженность,Остатки товаров,Кредиторская задолженность,Объем продаж"); ГСЧ = Новый ГенераторСлучайныхЧисел(123456789); Для каждого ЭлементСписка Из СписокТемп Цикл НоваяСтрока = ВнешняяТаблица.Добавить(); НоваяСтрока.Показатель = ЭлементСписка.Значение; НоваяСтрока.Значение = ГСЧ.СлучайноеЧисло(0,999999) + Sin(ГСЧ.СлучайноеЧисло(0,999)); КонецЦикла; КонецЕсли; КонецЕсли
В этом примере таблица заполняется фиктивными данными, в реальном приложении здесь можете передавать произвольное количество показателей отчета.
С данными для первого отчета разобрались, осталось подготовить для второго. В этом же модуле fbaПодпискаНаСобытия добавите в процедуру ПодготовитьДвоичныеДанныеДляОтправки следующий код:

ДД = Неопределено; Если СокрЛП(МобильноеПриложение.Код) = "SAMPLE_REPORT_HEAD" Тогда Если Идентификатор = "REPORT_PRODUCTS_IN_STOK" Тогда ИмяФайла = ПолучитьИмяВременногоФайла("html"); Отчет = Отчеты.ТоварыНаСкладах.Создать(); Если Отчет.СохранитьОтчетВHTML(ИмяФайла) Тогда ДД = Новый ДвоичныеДанные(ИмяФайла); УдалитьФайлы(ИмяФайла); КонецЕсли; КонецЕсли; КонецЕсли; Возврат ДД;
Прокомментирую код. Когда мобильное приложение запрашивает произвольные данные (в виде файла) с идентификатором «REPORT_PRODUCTS_IN_STOK», в 1С выполняется отчет и результат его сохраняется во временный файл. Затем этот временный файл считывается как двоичные данные и передается мобильному приложению. Временный файл удаляется.

Как в данном случае генерируется html файл, нам не важно. Вы можете использовать штатный механизм 1С сохранения табличного документа в виде HTML или сформировать HTML вручную. Пример вывода можете посмотреть в конфигурации «FBA демо», отчет «Товары на складах».

С 1С всё, переходим к разработке мобильного приложения на Android.

Проектирование Android – приложения

Запустите Eclipse и выполните импорт проекта: File > Import… В группе Android выберите элемент «Exists Android Code Into Workspace» нажмите Next , укажите путь к каталогу шаблона Android-проекта и нажмите Finish , новый проект будет добавлен в рабочее пространство. Если возникнут сложности см. , процесс описан в картинках.

1. Создаем отчет «Финансовые показатели», источником данных для которого является таблица значений, полученная от 1С. Для этого добавьте новый класс ToChiefReport.java, вот полный исходный код:

Показать

/** * Пример построения отчета по данным из локальной базы sqlite. Источником * данных выступает внешняя таблица «Рапорт руководителю» * */ public class ToChiefReport extends SimpleMapHtmlReport { @Override public int getResIdIcon() { return R.drawable.report_01; } @Override public int getResIdTitle() { return R.string.report_name_to_chief; } @Override public void build(Context context, IReportBuilderResult builderResult) { try { makeReport(context); } catch (SQLException e) { e.printStackTrace(); setHeader1("Упс, отчет не создан!"); } super.build(context, builderResult); } private void makeReport(Context context) throws SQLException { DBHelper helper = new DBHelper(context); // Заголовок отчета и таблицы setHeader2("Финансовые показатели"); setTableHeader("Наименование ", "Сумма, руб."); // Строки таблицы будут в порядке добавления Map mapData = new LinkedHashMap(); // Выборка данных из локальной базы данных sqlite, внешняя таблица // «Рапорт руководителю» ExTableRaportRukovoditelyuDao dao = helper .getDao(ExTableRaportRukovoditelyu.class); List rows = dao.select(); for (ExTableRaportRukovoditelyu row: rows) { mapData.put(row.pokazatel, row.znachenie); } setTableData(mapData); } }
Прокомментирую код. Абстрактный класс SimpleMapHtmlReport, от которого наследуется, предназначен для построения простого HTML отчета с таблицей из двух колонок.
Первые 2 метода getResIdIcon() и getResIdTitle() возвращают иконку и название нашего отчета для отображения в списке. В обработчике события «build» вызывается метод makeReport, в котором наша реализация компиляции отчета.
При построении отчета сначала устанавливается заголовок отчета и таблицы, затем все записи из локальной таблицы sqlite считываются как строки таблицы отчета. И наконец, в методе setTableData() устанавливаем данные для таблицы отчета. Уф, как сложно комментировать очевидные вещи.

Показать

/** * Пример скомпилированного отчета, просто выводит Html файл. В этом примере * данных файл сгенерирован в 1С и передан мобильному клиенту во время обмена * */ public class ProductsInStokReport extends SimpleCompiledHtmlReport { // Имя, под которым сохраняется полученный файл от 1с (см. процедуру обмена // MyExchangeTask) public static final String REPORT_FILE_NAME = "products_in_stok.html"; public ProductsInStokReport(File file) { super(file); } @Override public int getResIdIcon() { return R.drawable.report_02; } @Override public int getResIdTitle() { return R.string.report_name_products_in_stok; } }

Показать

/** * Стандартная процедура обмена дополненная пользовательскими правилами. * Дополнительно получается один скомпилированный файл – отчет. * */ public class MyExchangeTask extends ExchangeTask { // Идентификатор отчета как он задан в 1С private static final String ID_REPORT_PRODUCTS_IN_STOK = "REPORT_PRODUCTS_IN_STOK"; public MyExchangeTask(ExchangeVariant exchangeVariant, WSHelper wsrvHelper, DBOpenHelper dbOpenHelper) { super(exchangeVariant, wsrvHelper, dbOpenHelper); } @Override protected boolean doExecute() throws Exception { // Выполнить шаги обмена по предопределенным правилам boolean success = super.doExecute(); if (success) { // Получить произвольные данные - наш 2-ой отчет onStepInfo("Получаю отчеты…"); String fPath = appSettings.getCacheDir().getAbsolutePath() + "/" + ProductsInStokReport.REPORT_FILE_NAME; File f = wsHelper.getLargeData(ID_REPORT_PRODUCTS_IN_STOK, null, "", fPath); success = (f != null); } return success; } }
Для получения данных отчета используется метод веб-сервиса getLargeData , который в случае успеха сохраняет результат в файл по указанному пути. Обратите внимание на идентификатор ID_REPORT_PRODUCTS_IN_STOK, он должен быть таким же, как в 1С в методе ПодготовитьДвоичныеДанныеДляОтправки.

А) локальную переменную для списка
private ListView list;
б) метод инициализации
private void init() { list = (ListView) findViewById(android.R.id.list); // Создать адаптер для отображения списка отчетов ReportListAdapter adapter = new ReportListAdapter(this,createReportList()); list.setAdapter(adapter); list.setOnItemClickListener(new OnItemClickListener() { @Override public void onItemClick(AdapterView parent, View view, int position, long id) { // Показываем отчет в диалоге по клику на нем IReport report = (IReport) list.getItemAtPosition(position); report.onShow(MainActivity.this); } }); }
и вызов его в onCreate() после установки макета формы
setContentView(R.layout.activity_main); init();
в) метод инициализации списка отчетов
/* * Подготовить список отчетов */ private List createReportList() { List lst = new ArrayList(); // Создать первый отчет, временный каталог где сохранен файл берем из // настроек IReport report = new ProductsInStokReport(new File(getAppSettings() .getCacheDir(), ProductsInStokReport.REPORT_FILE_NAME)); lst.add(report); // Создать и добавить в список прочие отчеты lst.add(new ToChiefReport()); }
г) процедуру запуска обмена по вашим правилам
/* * Запуск обмена по моим правилам. Обратите внимание, что в планировщике * (если установлен) обмен остался по стандартным правилам */ private void startExchangeMyRules(ExchangeVariant variant,boolean cancelable) { // хелпер для вызова методов web-сервиса WSHelper wsHelper = new WSHelper(getExchangeSettings()); MyExchangeTask task = new MyExchangeTask(variant, wsHelper, getHelper()); startExchange(task, cancelable); }
И изменяем вызов процедуры обмена startExchange(ExchangeVariant.FULL, true) в обработчике onOptionsItemSelected на startExchangeMyRules(ExchangeVariant.FULL, true).

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

Укажите имя пользователя: ivanov
И пароль: 123456

Запустите базу 1С и откройте справочник «Мобильные сотрудники». В качестве мобильного устройства укажите предопределённый элемент «Эмулятор устройства», в табличную часть «Мобильные приложения» добавьте приложение «Рапорт руководителю» и установите идентичные имя и пароль пользователя.

Запустите на эмуляторе процедуру обмена (кнопка со стрелочкой «Вверх» на панели справа)

Результат работы обмена выводится в уведомлении:

Нажмите на него для запуска вашего приложения (или для просмотра подробной информации об ошибке, если обмен завершился неудачно).

Проверим, что получилось. Кликните мышкой по отчету в списке:

Показать

Отлично! Отчеты выводятся, можно изменять масштаб по кнопке или жестами.

• диаграмма с использованием Google Chart Tools
• график с использованием jQuery плагина Plot
• вывод PDF-отчета внешним приложением (PdfReport.java)

Показать

Использование HTML для построения отчетов позволяет создавать весьма разнообразные отчеты, в т.ч. и с интерактивными элементами. Например, в одном нашем проекте используется вот такой отчет:

Показать

• для поля «Долг» используется условное цветовое оформление в зависимости от суммы;
• полный список неоплаченных накладных открывается только при нажатии на маркер «Все», по умолчанию отображаются только 4 последних.

На этом все, с другими примерами вы можете ознакомиться на сайте http://profi1c.ru .
В ближайшее время планируется добавить уроки по интерактивным элементам и адаптерам библиотеки FBA, а так же показать как работать с офф-лайн картами mapsforge .

Ложка дегтя

• программа перестает работать по окончании срока демо-лицензии т.е. после 31.12.13;
• при запуске выводится уведомление:

В ближайшее время (не более месяца) будет коммерческая версия, информацию о стоимости и порядке лицензирования добавим на наш сайт.

Спасибо, что дочитали до конца. Готов ответить на ваши вопросы в комментариях как по 1С, так и по Android.

Теги: Добавить метки

Практика разработки мобильного приложения 1С 8.3 (часть 1)

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

Изначально был выбран «неправильный» подход с компилированием приложения и закидыванием его на планшетник вручную. Напомню, что для сборки мобильных приложений используется «Помощник создания мобильного приложения» (MobileAppWizzard ). Затем на одном из форумов было найдено красивое решение с использованием мобильного приложения для разработки. Это приложение входит в комплект установки мобильной платформы. На момент разработки использовалась платформа версии 8.3.3.24. В папке «Android » можно найти файл 1cem.apk. Это и есть мобильное приложение для разработки. Его огромнейший плюс, сэкономивший нам уйму времени — в том, что можно опубликовать мобильное приложение на веб-сервере, а на планшетнике указать путь вида http://[ Адрес веб-сервера ]/[ Имя мобильного приложения ].

На планшетном ПК, в настройках добавленного приложения можно отметить флажок «Обновлять из конфигуратора», и при каждом запуске приложение будет пытаться подключиться к веб-серверу и проверять обновления.

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

Что требовалось:

1. Настроить обмен между центральной базой и мобильным устройством.

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

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

На этапе тестирования использовалась промежуточная база «Управляемое приложение», ввиду того что демо-приложение 1С:Заказы изначально заточено на обмен именно с Управляемым приложением.

Первый блин вышел комом. В прямом смысле. Для обмена с центральной базой был использован v82.ComConnector. Не буду вдаваться в подробности его настройки, об этом есть куча отдельных материалов. Пройдусь только по тем трудностям, с которыми столкнулся.

1. Использование com- объектов на 64-битной серверной ОС. Для решения проблемы была использована обертка COM+ Applications, которая настраивается в Component Services.

2. Удаленный вызов Com с другого сервера. Вызываемый сервер должен иметь роль Application Server, и у него должно быть настроено COM+ Network Access. Кроме того, сервер Apache должен иметь соответствующие права (т. е. запускаться как сервис от имени авторизованного пользователя)

Намучившись с Ком-соединениями, решили переводить рабочую базу на web- сервисы.

О публикации веб-сервисов также написано очень много, но там написано о том, как работает. Как НЕ работает, поделюсь ниже.

Рабочая база развернута на платформе 8.2, мобильное приложение, соответственно, на 8.3.

При публикации вначале приложения 8.3, а затем 8.2. периодически выхватывали глюк «Ошибка формата потока» в веб-клиенте 8.3, либо сообщение об ошибке «различаются версии платформы клиента и сервера». Перепубликация не помогает, равно как и перезапуск Apache. А вот отключение публикации и подключение заново — помогает.

Далее, поймал забавную ошибку при авторизации пользователя (при создании ws Определения). При тестировании на компьютере, авторизация с длинным ФИО проходит легко. При попытке авторизации этого же пользователя с планшетника под управлением Android, авторизация заканчивалась, не начавшись. Экспериментальным путем удалось вычислить, что кириллицей длина логина ограничена 22 символами. При этом сочетание кириллических символов и цифр дало авторизоваться с логином длиной 27 символов. Есть подозрение, что это связано с преобразованием кириллических символов. Так, например, в браузере Firefox строка из Википедии « иво» преобразуется в « ».

Технологически, мобильная платформа 8.3.3 на текущий момент имеет ряд ограничений. Самое ожидаемое, на мой взгляд, нововведение — это поддержка запросов. Но, поскольку произвольные запросы в динамических списках мобильная платформа пока не поддерживает, пришлось «пойти другим путем».

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

1. В форме справочника номенклатуры созданы две таблицы. Первая — динамический список, собственно сам справочник. Фильтр динамического списка настроен так, чтобы выводились только группы. Вторая таблица — собственно остатки и цены. При активизации строки динамического списка, на сервере происходит заполнение таблицы значений, которая затем и выводится во вторую таблицу. При получении цен и остатков использовалась объектная модель. Все эти танцы с бубном были исполнены только потому, что привычного по толстому клиенту метода «при выводе строки» или «при получении данных» нет, и динамически нарисовать цифры в колонке нельзя.

Аналогичный подход использовался и в форме подбора

2. Для вывода строки с текущими ценами отлично подошла ФорматированнаяСтрока.

Ниже — пример кода.

&НаСервереБезКонтекста Функция ОстаткиПриАктивизацииСтрокиНаСервере(ном) НаборЗаписей = РегистрыСведений.ЦеныТоваров.СоздатьНаборЗаписей(); НаборЗаписей.Отбор.Товар.Значение = ном; НаборЗаписей.Отбор.Товар.Использование = Истина; НаборЗаписей.Прочитать(); МассивФорматированныхСтрок = Новый Массив; Для Каждого СтрокаНабора Из НаборЗаписей Цикл МассивФорматированныхСтрок.Добавить(Новый ФорматированнаяСтрока(СтрокаНабора.ВидЦен.Наименование,WebЦвета.Синий)); МассивФорматированныхСтрок.Добавить(Новый ФорматированнаяСтрока(" " + Строка(СтрокаНабора.Цена) + " ")); КонецЦикла; Возврат Новый ФорматированнаяСтрока(МассивФорматированныхСтрок); // Вставить содержимое обработчика. КонецФункции

3. Для загрузки справочников, остатков и цен в мобильное приложение был использован веб-сервис, который на входе получает структуру параметров, а на выходе возвращает хранилище значения. Еще одним неприятным открытием стал вылет обмена при слишком длительной обработке на стороне сервера. Сложилось впечатление, что имеется какой-то таймаут, после которого приложение «считает», что связь прервана (хотя на самом деле все еще идет обработка данных в рабочей базе через ws -соединение), и прекращает обмен с ошибкой.

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

4. Для получения отчетов оставлен тот же подход, что и в конфигурации 1С: Заказы. Вызывается веб-сервис с параметрами, на стороне сервера рабочей базы формируется табличный документ, и затем уже готовый табличный документ возвращается в мобильное приложение.

Предварительные настройки

Перед началом работы на мобильном устройстве необходимо установить корневой сертификат сервиса «1С: Линк».

В настройках мобильного приложения необходимо указать путь к информационной базе, опубликованной через «1С: Линк». Особенностью работы с мобильными приложениями через «1С: Линк» является то, что подключение к веб-сервисам осуществляется по их именам, а не по псевдонимам (алиасам). В некоторых мобильных приложениях (например, «1С: ДО») строка подключения формируется автоматически и не требует указания имени веб-сервиса.

Особенности настройки мобильных приложений

1С: Заказы

• В информационной базе перейдите в раздел "Администрирование", выберите пункт меню "CRM и продажи", поставьте галочку "Разрешить синхронизацию данных с мобильным приложением 1С: Заказы клиентов", нажмите на ссылку "Настройки синхронизации" и добавьте настройку для пользователя.
• Логин: логин пользователя 1С
• Настройка "1С:ЛИНК" включена
• Имя туннеля:<ваш-туннель>
• Настройка "SSL" должна быть включена для работы с ИБ по протоколу HTTPS и выключена для работы по HTTP
• Каталог:<путь веб-приложения>

Мобильный Документооборот

• В настройках информационной базы включите работу с мобильным клиентом.
  Для этого зайдите в информационную базу под пользователем с правами администратора, выберите пункт меню "Настройка и администрирование" - "Настройка программы" - "Обмен данными" и поставьте галочку "Использовать мобильные клиенты"
• Адрес подключения: https://<ваш-туннель>.сайт/<путь веб-приложения>
• Логин: логин пользователя 1С
• Пароль: его пароль

Обратите внимание, что для работы с мобильным приложением у вас должна быть установлена версия 1С: Документооборота 8 не ниже, чем 1.3.1.3 КОРП

1С: УНФ

• В настройках синхронизации мобильного приложения "1С: УНФ" перейдите в раздел "Другой сервис"
• В поле "адрес приложения" укажите (без ru_RU)
• Укажите логин и пароль пользователя информационной базы и нажмите кнопку "Войти".

1С: Монитор ERP

• Логин: логин пользователя 1С
• Пароль: его пароль
• Настройка "1С:ЛИНК" включена
• Имя туннеля:<ваш-туннель>
• Каталог:<путь веб-приложения>

​

Клиент бухгалтерии 1cfresh

Для синхронизации с Бухгалтерией предприятия, опубликованной в 1С: Линк можно воспользоваться мобильным приложением "Клиент бухгалтерии 1cfresh".

• В настройках мобильного приложения "Клиент бухгалтерии 1cfresh" перейдите в раздел "Другой сервис"
• В поле "адрес базы для подключения" укажите https://имя туннеля.link.1c.ru/путь-веб-приложения (без ru_RU)
• Укажите логин и пароль пользователя информационной базы и нажмите кнопку подключиться.

​
​

На примере мобильного приложения «1С:Управление нашей фирмой» (сокращенно УНФ) я хочу показать эволюцию мобильного бизнес-приложения от его возникновения и выхода самой первой версии до сегодняшнего дня. Сейчас у этого приложения более 220 000 скачиваний; приложение бесплатное, но в нем есть платные опции (реализованные через встроенные покупки).

Первая версия мобильной УНФ была сделана на одной из первых версий мобильной платформы «1С:Предприятия» в 2012 году. На тот момент уже существовала клиент-серверная конфигурация «1С:Управление небольшой фирмой» (тогда название было таким), программа для автоматизации деятельности небольшой компании – продажи, закупки, база клиентов и поставщиков, управление складом, производство и т.п.

Как и большинство мобильных приложений, написанных на кросс-платформенной мобильной платформе 1С:Предприятия, мобильный УНФ доступен на iOS, Android и Windows.

Задача была поставлена так: сделать мобильное приложение, поддерживающее часть сценариев работы «большого» УНФ. Приложение должно уметь работать как автономно, так и синхронизировать данные с «большим» УНФ (далее слово «большой» применительно к клиент-серверной версии УНФ я буду писать без кавычек, чтобы не перегружать текст). В случае работы с большим УНФ должны поддерживаться сценарии «мобильных» сотрудников – торгового представителя, сервисного инженера, продавца.

Первая версия была создана за 1 человеко-месяц. При создании мобильного приложения часть объектов метаданных (справочники, документы) была реализована на основе объектов большого УНФ. Но часть функциональности пришлось программировать с нуля, например, процесс обмена данными с большим УНФ. Правда, применительно к обмену данными собственно программировать пришлось немного – мы использовали стандартные механизмы платформы (в частности, планы обмена), сводящие написание кода к минимуму.

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

Особенности мобильной версии

Мобильный УНФ широко использует функциональность мобильного устройства, в частности:

• Встроенную камеру устройства можно использовать для фотографирования товара при заполнении карточки товара, для чтения штрих- и QR-кодов
• Счет на оплату можно отправить клиенту по емейл или через SMS
• Контрагента можно выбрать из адресной книги мобильного устройства
• Если у контрагента задан телефон – можно одним касанием позвонить контрагенту или послать SMS, если задан емейл – отправить письмо, если задан адрес – показать его на карте
• Можно печатать документы на принтерах через WiFi и Bluetooth

Конфигурация мобильного УНФ выглядит достаточно спартански (см. скриншот ниже):

• 8 справочников (в большом УНФ – 273 справочника)
• 7 документов (в большом УНФ – 125)
• 3 журнала документов (в большом УНФ – 24)
• 3 регистра сведений (в большом УНФ – 357)
• 4 регистра накопления (в большом УНФ – 64)

Но, несмотря на такое небольшое количество прикладных объектов, продукт получился достаточно функциональным.

Интересная особенность мобильного УНФ – это то, что им зачастую начинают пользоваться люди, до этого про 1С не слыхавшие (да-да, есть в нашей стране и такие), те, которым понадобилось мобильное приложение для ведения учета их маленького бизнеса (например, домашнего крафтинга). Они просто нашли его поиском в Google Play или AppStore, почитали отзывы – и начали работать.

Автономная работа

Работа в режиме синхронизации с сервером (первые версии)

Синхронизировались с большим УНФ справочники товаров и услуг, контрагентов, и заказы.

Обмен данными мобильного и большого УНФ в первых версиях

Заказы, введенные с мобильных устройств, попадали в большой УНФ, а при синхронизации попадали на мобильные устройства ответственных за заказы. Документы типа поступлений в кассу, реализации товара и т.п., введенные на мобильных устройствах, уезжали в большой УНФ, но не синхронизировались между мобильными устройствами. Вся работа в мобильном приложении в режиме синхронизации велась в основном вокруг заказов – их принятия и исполнения, полноценный учет на мобильном устройстве при этом не велся, для этого нужно было пользоваться большим УНФ на компьютере.

Так было в первых версиях, но впоследствии мы изменили ситуацию и расширили список сценариев использования мобильного УНФ, чтобы сделать работу с ним более удобной для пользователей.

Немного про синхронизацию данных

1. Создать структуру данных в большом УНФ, дублирующую структуру данных мобильного УНФ, и обмениваться данными с мобильным УНФ «один-в-один». При изменении данных в большом УНФ нужно новые/изменённые данные перенести в эту дублирующую структуру, а после обмена данными с мобильным УНФ – сконвертировать данные, пришедшие с мобильного устройства и размещенные в дублирующей структуре, в формат большого УНФ.
2. Обмениваться данными непосредственно со структурами большого УНФ, осуществляя конвертацию данных «на лету» по правилам обмена.

Механизмы обмена данными, реализованные в платформе, берут на себя бОльшую часть работы по формированию пакетов для синхронизации данных, позволяя свести написание кода к минимуму. В процессе обмена используется стандартный механизм платформы 1С:Предприятия – механизм обмена данными ; для каждого мобильного УНФ в большом УНФ создается узел обмена данными, в большом и мобильном УНФ задействуется служба регистрации изменений для отслеживания данных, измененных со времени последней синхронизации и т.д.

Мобильное приложение инициирует обмен данными, с помощью механизмов платформы формирует пакет обмена (содержащий идентификатор мобильного приложения и данные, обновленные на мобильном УНФ со времени последней синхронизации) и пересылает его в большой УНФ. Исходя из информации в стартовом пакете, большой УНФ готовит для мобильного УНФ данные, измененные в большом УНФ со времени последней синхронизации, и упаковывает их в пакеты. Пакеты в формате XDTO - это объекты метаданных 1С, сериализованные в XML; размер каждого пакета – не более 500 объектов.

Мобильный УНФ забирает эти данные пакет за пакетом. После загрузки последнего пакета мобильный УНФ начинает обрабатывать полученные данные – проводить документы, записывать справочники и т.д. В случае разрыва связи поддерживается докачка пакетов; механизм докачки мы написали для УНФ самостоятельно (в платформе его нет), но, поскольку мобильный УНФ поставляется в исходных кодах, разработчики могут посмотреть на реализацию механизма и позаимствовать ее для своих приложений.

Во время первичной синхронизации мобильного УНФ с большим УНФ работать в мобильном УНФ нельзя – появляется модальное окно, показывающее ход процесса. Все последующие синхронизации – фоновые, и не блокируют работу мобильного УНФ.

Полный список объектов, которыми обмениваются мобильный и большой УНФ:

• Справочники:
  • Номенклатура
  • Контрагенты
  • Список пользователей
• Документы:
  • Заказы покупателей
  • Поступление в кассу
  • Расход из кассы
  • Приходная накладная
  • Расходная накладная
  • Производство
• Регистры (но не полностью все цены, а только основные):
  • ЦеныПоставщиков
  • ЦеныТоваров
• Сведения об организации:
  • Наименование
  • Информация о налогообложении

Карточка товара с изображением товара

Эволюция приложения – развиваем сценарии использования

В первых версиях мобильного УНФ сценарий переезда был достаточно прямолинейным – данные, введенные в мобильном УНФ, копировались в базу большого УНФ, и пользователь должен был отныне вести учет на компьютере. Мобильный УНФ в этом случае будет работать в режиме работы с заказами, а вести учет (как на автономной версии мобильного УНФ) на нем уже будет нельзя.

Это, конечно, было не совсем удобно для конечного пользователя – он уже привык вести учет с мобильного устройства, а тут его принудительно заставляют пересесть за клавиатуру компьютера. Не все будут этим довольны.

Поэтому мы расширили список сценариев работы мобильного УНФ. В этом нам помогло появление нашего облачного сервиса http://1cfresh.com , основанного на облачной технологии 1cFresh . Появилась возможность размещать большой УНФ в облаке. Мы расписали три сценария использования мобильного приложения по мере роста бизнеса пользователя:

1. Совсем маленький бизнес. Учет ведется на одном мобильном устройстве.
2. Бизнес растет – появились сотрудники. Можно поставить мобильный УНФ на мобильные устройства сотрудников. При этом нужно уметь обмениваться данными между мобильными устройствами для синхронизации данных; для этого мы решили использовать не обмен через файлы, а задействовать для синхронизации (а заодно и для бэкапа) версию большого УНФ, расположенную в облаке http://1cfresh.com . При включении этого сценария в облаке http://1cfresh.com создается экземпляр большого УНФ, база которого будет использоваться для синхронизации данных между мобильными устройствами. Использование в таком сценарии одного мобильного устройства – бесплатно, за каждое дополнительное устройство мы берем 75 руб/месяц, использовать в этом сценарии можно не больше трех устройств. При этом пользователям мобильных устройств можно задать предопределенные роли – торговый представитель, сервисный инженер, продавец (возможна также детальная настройка ролей); соответствующим образом будет ограничена функциональность мобильного приложения. Можно также работать через веб-клиент или тонкий клиент с большим УНФ, размещенным в облаке, но функциональность облачного УНФ будет урезана до функциональности мобильного УНФ. Но работать непосредственно в облачном УНФ необязательно – вся работа может вестись только с мобильных устройств.
3. Бизнес вырос до размера средней фирмы. В этом случае имеет смысл арендовать в облаке полноценную версию большого УНФ, чтобы получить (через веб-клиент или тонкий клиент) дополнительную функциональность - CRM (в планах – включение CRM в мобильный УНФ, но пока доступен только в большой версии), управление складом, расширенное формирование цен, возможность работы с банками и . В этом случае количество мобильных устройств, работающих с большим УНФ, не ограничено (за каждое устройство взимается дополнительная плата согласно тарифу , как за одно рабочее место; 1 лицензия на УНФ во Фреше или на «коробочный» УНФ дает право бесплатного пользования и 1 мобильным приложением).

Опыт монетизации приложения

Заключение

Нелишним будет напомнить, что на мобильной платформе 1С можно делать приложения, взаимодействующие не только с 1С-серверным backend-ом; протоколы, используемые для обмена данными в мобильных приложениях на платформе 1С – платформенно-независимые (web- и HTTP-сервисы, поддержка XML и JSON и т.п.). Так что если вам нужно быстро и динамично развивать кросс-платформенный (Android, iOS, Windows) мобильный клиент, причем с возможностью офлайн работы без постоянного подключения к Интернет для вашего бизнес-приложения, то мобильная платформа 1С вполне может быть оптимальным выбором для вас.