СБИС Сапёр

Общие сведения

Назначение документа

Документ представляет собой техническое описание порядка установки, настройки и расширения стандартного функционала SBIS for SAP.

Область применения документа

Настоящий документ предназначен для описания технических аспектов внедрения продукта SBIS for SAP. Документ может использоваться для постановки задач техническим специалистам по внедрению и расширению функциональности Системы.

Общее назначение системы

Система предназначена для автоматизации процессов обмена электронными юридически значимыми документами.

Глоссарий

Настоящий раздел содержит полный список сокращений и определений, используемых в документе.

Таблица 2 Глоссарий

Технические документы Файлы, предусмотренные регламентом документооборота, содержащие описание процесса отправки

• Формализованный документ - Структурированный документ (XML-формат)
• Неформализованный документ - Неструктурированный документ (произвольный файл, например, в формате PDF)
• ЭДО - Электронный документооборот
• Документ Документ, полученный от контрагента или направляемый ему, отражающий факты проведения финансовых операций с контрагентом, выполнения каких-либо работ или оказания услуг, поставки каких либо * ТМЦ (например, Счёт-фактура, Накладная Торг-12, Акт приёма/сдачи работ и т.п.)
• ЭП Электронная подпись - реквизит электронного документа, предназначенный для защиты данного электронного документа от подделки, полученный в результате криптографического преобразования информации с использованием закрытого ключа электронной цифровой подписи и позволяющий идентифицировать владельца сертификата ключа подписи, а также установить отсутствие искажения информации в электронном документе

Техническая ЭП ЭП, которая применяется для подписания технических документов (технологических уведомлений) в процессе обмена через ОЭД.

• ИМ, IM Интеграционный модуль (Integration Module) - компонент Системы, отвечающий за обмен сообщениями между SAP-системой Заказчика и ОЭД
• БЕ Код балансовой единицы в системе SAP
• ГФ Группа функций, объект системы SAP
• ФМ Функциональный модуль, объект системы SAP
• БО Бизнес-объект SAP
• СЭ Селекционный экран, экран выбора данных

Общая характеристика продукта

Архитектура системы

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

Рисунок 1 Схема логической и программной архитектуры

SBIS for SAP

Программный компонент, предназначен для интеграции учётной системы SAP ERP с СБИС. Условно SBIS for SAP

SBIS Plugin

Объект для обеспечения функционала личного кабинет СБИС (предназначен для генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7, вывода информационных уведомлений о поступивших документах / заданиях, операций по ручной загрузке и выгрузке документов). Объект устанавливается на рабочих местах пользователей. Интеграция с SAP системой выполнена посредством SAP NET Connector 3, входит в состав компонентов ядра продукта.

Для работы требуется операционная система Windows XP SP3 и выше, а также NET Framework 2.0 или 4.0. Не поддерживается работа с NET Framework 4.0 Client profile.

SBIS SDK

Объект предназначен для обмена данными с API sbis.ru, а также генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7 . Объект устанавливается на рабочих местах пользователей. Интеграция с SAP системой выполнена посредством технологии OLE2, входит в состав компонентов ядра продукта.

Стандартная поставка

В стандарте продукта SBIS for SAP поставляется следующий набор пакетов:

• /SBIS/CORE – родительский пакет, включающий все пакеты ядра системы.
  • /SBIS/ – набор всех ключевых функций продукта;
  • /SBIS/_SAP_<XXX> - разработки, специфичные для версии системы SAP, где <XXX> - номер версии компонентов;
  • /SBIS/GUI - пакет, включающий в себя элементы пользовательского интерфейса;

Совет При внедрении продукта рекомендуется создание корневого пакета разработок ZSBIS, в который должны быть включены пакеты: • ZSBIS_<XXXXX> - специфичные для Заказчика разработки, где <XXXXX> - обозначение Заказчика.

Правила ведения разработки на проекте

Настоящий раздел содержит общие рекомендации к ведению разработки на проектах внедрения.

Именование объектов словаря

Настоящий раздел описывает концепцию наименований объектов словаря на стороне SAP системы.

Таблица 3 Именование объектов словаря Объект репозитария Длина имени Маска Домены 30 /SBIS/DM_[<ff>][_<XXXXXXXX>] Элементы данных 30 /SBIS/ED_[<ff>][_<XXXXXXXX>] Структуры 30 /SBIS/S_[<ff>][_<XXXXXXXX>] Типы таблиц 30 /SBIS/T_[<ff>][_<XXXXXXXX>] Таблицы БД 16 /SBIS/[<ff>][<XXXXXXXX>]

/SBIS/[<ff>][<XXXXXXXX>]T  - для текстовых таблиц 

Ракурсы 16 /SBIS/V_[<ff>][<XXXXXXXX>] Search-Help 30 /SBIS/SH_[<ff>][_<XXXXXXXX>] Объект блокировок 16 /SBIS/[<ff>][<XXXXXXXX>] Группа функций 26 /SBIS/GF_[<ff>][_<XXXXXXXX>] Функциональные Модули 30 /SBIS/FM_ [<ff>][_<XXXXXXXX>] /SBIS/RFC_ [<ff>][_<XXXXXXXX>] Программы, include 40 /SBIS/[<ff>][_<XXXXXXXX>] Пулы модулей 40 /SBIS/[<ff>][_<XXXXXXXX>] Классы 30 /SBIS/CL_[<ff>][_<XXXXXXXX>] Интерфейсы 30 /SBIS/IF_[<ff>][_<XXXXXXXX>] Транзакции 20 /SBIS/[<ff>][<XXXXXXXX>] Smartforms/SAPScript 30 /SBIS/[<ff>][_<XXXXXXXX>] Классы сообщений 20 /SBIS/[<ff>][<XXXXXXXX>] Классы разработок 30 /SBIS/[<ff>][_<XXXXXXXX>] Реализация BAdi (новый/старый) 30/20 /SBIS/[<имя определения BAdi>] Проекты SAP-расширений 8 /SBIS/[<XXXXXXXX>] SET/GET-параметры 20 /SBIS/[<ff>][<XXXXXXXX>] Append – структуры в стандартных таблицах 30 /SBIS/A_[<ff>][_<XXXXXXXX>] Поля в append-структурах стандартных таблиц 15 Z[<XXXXXXXX>] Меню областей 30 /SBIS/[<ff>][_<XXXXXXXX>] Объект полномочий 30 /SBIS/[<ff>][_<XXXXXXXX>]

Для именования остальных объектов репозитария используется маска формирования имени: <ZZ>SBIS_[<ff>]_[<XXXXXXXX>] , где: • <ZZ> - буква Z (или две буквы Z, например, для полей в append - структурах стандартных таблиц) в соответствии с соглашением о пространстве имен для клиента; • <ff> - дополнительный квалификатор функциональности, опускается, в случае если объект принадлежит пакету ZCOMMON; • <XXXXXXXX> - произвольный набор символов, возможно, но не обязательно, как-то отражающий физический или производственный смысл объекта на английском языке. Возможно использование цифр для отражения следующей логики: 1 - создание, 2 - редактирование, 3 – удаление; Объекты, не попадающие под требование, должны именоваться исходя из здравого смысла.

Именование переменных кода

Настоящий раздел описывает систему именования объектов и переменных программ продукта на стороне SAP. Таблица 4 Именование объектов и переменных программ Объект Префикс Class cl_ Parameter p_ Pushbutton pb_ Radio Button rb_ Select Option so_ Table type tt_ Type ty_ Global Constant gc_ Global Field Symbol gfs_ Global Structure gs_ Global Variable gv_ Global Internal Table gt_ Global Range gt_rng_ Global Reference gr_ Local Constant lc_ Local Field Symbol lfs_ Local Structure ls_ Local Variable lv_ Local Internal Table lt_ Local Range lt_rng_ Local Reference lr_ Parameter IMPORTING – Variable iv_ Parameter IMPORTING –Structure is_ Parameter IMPORTING – Internal Table it_ Parameter CHANGING – Variable cv_ Parameter CHANGING – Structure cs_ Parameter CHANGING - Internal Table ct_ Parameter EXPORTING – Variable ev_ Parameter EXPORTING – Structure es_ Parameter EXPORTING - Internal Table et_

Языковая поддержка

Текущая версия системы должна поддерживать (работать без дополнительной настройки) следующие языки: • Русский.

Пользовательский интерфейс и кастомизация

Интерфейсы

ГФ /SBIS/RFC – Набор RFC функций

Общее назначение

Настоящая группа функций обеспечивает работу с SAP из интерфейса личного кабинета СБИС. Соединение осуществляется через SBIS Plugin установленный на рабочем месте пользователя..

ФМ /SBIS/RFC_GET_LIST_DOC – Получение списка документов.

Функциональный модуль предназначен для получения списка пакетов документов для отправки. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Код раздела настроек содержащих параметры необходимые для получения списка документов. IS_FILTER Структура содержащая параметры для ограничения выборки списка документов (период, контрагент, балансовая единица и т.п.) TABLES ET_LIST_DOC Список пакетов документов EXCEPTIONS

ФМ /SBIS/RFC_GET_DOC – Данные отправки

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

Получает из таблицы настроек набор SQL запросов необходимых для построения списка пакетов документов. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Код раздела настроек содержащих параметры необходимые для получения данных документа. IS_DOC_ID Уникальный идентификатор документа EXPORTING ES_DOC Данные заголовка пакета документов ET_ATTACHMENT Данные для формирования электронных документов (вложений в пакет).

ФМ /SBIS/RFC_GET_LIST_PARAM – Получения списка настроек

Функциональный модуль предназначен для получения списка параметров, необходимых другим ФМ для работы. Личный кабинет СБИС предоставляет удобный интерфейс для администрирования параметров. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Параметр для ограничения списка возвращаемых настроек. IV_SUBFOLDER Параметр для ограничения списка возвращаемых настроек. TABLE ET_MAPPING Таблица с настройками

ФМ /SBIS/RFC_GET_PARAM – Получения списка настроек

Функциональный модуль предназначен для получения конкретного параметра из настроечных таблиц. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Параметр для ограничения списка возвращаемых настроек. IV_SUBFOLDER Параметр для ограничения списка возвращаемых настроек. IV_PARAM_NAME Имя параметра для отбора. EXPORTING ES_VALUE Структура со значением параметра

ФМ /SBIS/RFC_DEL_LIST_PARAM – Удаляем список настроек

Функциональный модуль предназначен для удаления настроек, используется при администрировании настроек. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Параметр для ограничения списка удаляемых параметров. IV_SUBFOLDER Параметр для ограничения списка удаляемых параметров.

ФМ /SBIS/RFC_DEL_PARAM – Удаляем параметр

Функциональный модуль предназначен для удаления конкретного параметра, используется при администрировании настроек. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Параметр для ограничения списка удаляемых параметров. IV_SUBFOLDER Параметр для ограничения списка удаляемых параметров. IV_PARAM_NAME Имя удаляемого параметра.

ФМ /SBIS/RFC_ADD_LIST_PARAM – Удаляем список настроек

Функциональный модуль предназначен для добавления настроек, используется при администрировании настроек. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Параметр для ограничения списка удаляемых параметров. IV_SUBFOLDER Параметр для ограничения списка удаляемых параметров.

ФМ /SBIS/RFC_ADD_PARAM – Удаляем параметр

Функциональный модуль предназначен для добавления конкретного параметра, используется при администрировании настроек. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Параметр для ограничения списка удаляемых параметров. IV_SUBFOLDER Параметр для ограничения списка удаляемых параметров. IV_PARAM_NAME Имя удаляемого параметра.