СБИС Сапёр — различия между версиями
(→ФМ /SBIS/RFC_GET_LIST_DOC – Получение списка документов.) |
(→ФМ /SBIS/RFC_GET_LIST_DOC – Получение списка документов.) |
||
Строка 400: | Строка 400: | ||
{{Шаблон:РазделТаблицыОписанияМетода | {{Шаблон:РазделТаблицыОписанияМетода | ||
| Название=IMPORTING}} | | Название=IMPORTING}} | ||
− | {{Шаблон: | + | {{Шаблон:СтрокаТаблицыОписанияМетода |
| Название=IV_FOLDER || Описание=Код раздела настроек содержащих параметры необходимые для получения списка документов. | | Название=IV_FOLDER || Описание=Код раздела настроек содержащих параметры необходимые для получения списка документов. | ||
}} | }} | ||
− | {{Шаблон: | + | {{Шаблон:СтрокаТаблицыОписанияМетода |
| Название=IS_FILTER || Описание=Структура содержащая параметры для ограничения выборки списка документов (период, контрагент, балансовая единица и т.п. | | Название=IS_FILTER || Описание=Структура содержащая параметры для ограничения выборки списка документов (период, контрагент, балансовая единица и т.п. | ||
}} | }} | ||
{{Шаблон:РазделТаблицыОписанияМетода | {{Шаблон:РазделТаблицыОписанияМетода | ||
| Название=TABLES}} | | Название=TABLES}} | ||
− | {{Шаблон: | + | {{Шаблон:СтрокаТаблицыОписанияМетода |
| Название=ET_LIST_DOC || Описание=Список пакетов документов | | Название=ET_LIST_DOC || Описание=Список пакетов документов | ||
}} | }} |
Версия 13:32, 19 декабря 2015
Содержание
- 1 Общие сведения
- 2 Общая характеристика продукта
- 3 Пользовательский интерфейс и кастомизация
- 3.1 Интерфейсы
- 3.1.1 ГФ /SBIS/RFC – Набор RFC функций
- 3.1.1.1 Общее назначение
- 3.1.1.2 ФМ /SBIS/RFC_GET_LIST_DOC – Получение списка документов.
- 3.1.1.3 ФМ /SBIS/RFC_GET_DOC – Данные отправки
- 3.1.1.4 ФМ /SBIS/RFC_GET_PARAM – Получение списка настроек аддона
- 3.1.1.5 ФМ /SBIS/RFC_DEL_PARAM – Удаление настроек аддона
- 3.1.1.6 ФМ /SBIS/RFC_ADD_PARAM – Добавление настроек аддона
- 3.1.1 ГФ /SBIS/RFC – Набор RFC функций
- 3.1 Интерфейсы
- 4 Алгоритм выгрузки документов из SAP в СБИС для последующей отправки
- 5 Алгоритм загрузки документов в SAP из СБИС
Общие сведения
Назначение документа
Документ представляет собой техническое описание порядка установки, настройки и расширения стандартного функционала 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_ | ||||||||||||
Push Button | pb_ | Radio Button | rb_ | Select Option | so_ | ||||||||
Table type | tt_ | ||||||||||||
Type | ty_ | ||||||||||||
Global Constant | gc_ | Local Constant | lc_ | ||||||||||
Global Field Symbol | gfs_ | Local Field Symbol | lfs_ | ||||||||||
Global Structure | gs_ | Local Structure | ls_ | Importing Structure | is_ | Changing Structure | cs_ | Exporting Structure | es_ | ||||
Global Variable | gv_ | Local Variable | lv_ | Importing Variable | iv_ | Changing Variable | cv_ | Exporting Variable | ev_ | ||||
Global Internal Table | gt_ | Local Internal Table | lt_ | Importing Internal Table | it_ | Changing Internal Table | ct_ | Exporting Internal Table | et_ | ||||
Global Range | gt_rng_ | Local Range | lt_rng_ | ||||||||||
Global Reference | gr_ | Local Reference | lr_ |
Языковая поддержка
Текущая версия системы должна поддерживать (работать без дополнительной настройки) следующие языки: • Русский.
Пользовательский интерфейс и кастомизация
Интерфейсы
ГФ /SBIS/RFC – Набор RFC функций
Общее назначение
Настоящая группа функций обеспечивает работу с SAP из интерфейса личного кабинета СБИС. Соединение осуществляется через SBIS Plugin установленный на рабочем месте пользователя..
ФМ /SBIS/RFC_GET_LIST_DOC – Получение списка документов.
Функциональный модуль предназначен для получения списка пакетов документов для отправки. В таблице ниже представлен локальный интерфейс модуля.
Параметр | Описание |
---|---|
IMPORTING | |
IV_FOLDER | Код раздела настроек содержащих параметры необходимые для получения списка документов. |
IS_FILTER | Структура содержащая параметры для ограничения выборки списка документов (период, контрагент, балансовая единица и т.п. |
TABLES | |
ET_LIST_DOC | Список пакетов документов
ФМ /SBIS/RFC_GET_DOC – Данные отправкиФункциональный модуль предназначен для получения данных необходимых для формирования пакета документов (описание пакета и его вложений). Получает из таблицы настроек набор SQL запросов необходимых для построения списка пакетов документов. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Код раздела настроек содержащих параметры необходимые для получения данных документа. IS_DOC_ID Уникальный идентификатор документа EXPORTING ES_DOC Данные заголовка пакета документов ET_ATTACHMENT Данные для формирования электронных документов (вложений в пакет). ФМ /SBIS/RFC_GET_PARAM – Получение списка настроек аддонаФункциональный модуль предназначен для получения конкретного параметра из настроечных таблиц. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Параметр для ограничения списка возвращаемых настроек. IV_SUBFOLDER Параметр для ограничения списка возвращаемых настроек. IV_PARAM_NAME Имя параметра для отбора. TABLE ET_PARAM Структура со значением параметра ФМ /SBIS/RFC_DEL_PARAM – Удаление настроек аддонаФункциональный модуль предназначен для удаления настроек аддона, используется при администрировании настроек. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание IMPORTING IV_FOLDER Параметр для ограничения списка удаляемых параметров. IV_SUBFOLDER Параметр для ограничения списка удаляемых параметров. IV_PARAM_NAME Имя удаляемого параметра. ФМ /SBIS/RFC_ADD_PARAM – Добавление настроек аддонаФункциональный модуль предназначен для добавления настроек аддона, используется при администрировании настроек. В таблице ниже представлен локальный интерфейс модуля. Параметр Описание TABLE IT_PARAM Список настроек которые надо добавить/обновить. Алгоритм выгрузки документов из SAP в СБИС для последующей отправкиАлгоритм загрузки документов в SAP из СБИС |