Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

 In First Page Posts, Skybuffer Academy

1. Начало работы

1.1     О документе

Это руководство по инсталляции для конечного пользователя является отправной точкой для технической реализации решения «Простые коммуникации» от компании Скайбуфер.

1.2     Введение

Дополнение к SAP «Простые коммуникации» от компании Скайбуфер предоставляет универсальную структуру электронной почты и гибкую среду разработки для бизнес-процессов потоков операций и общения вида «электронное сообщение – SAP».

«Простые коммуникации» обеспечивают:

  • Полностью конфигурируемую обработку входящих электронных сообщений для выполнения действий над элементами потоков операций и для создания комментариев к бизнес-объекту;
  • Поддержку основанных на событиях и основанных на решениях элементов потоков операций;
  • Удобные API-интерфейсы для отправки электронных писем, создания тела электронного сообщения из шаблона HTML, преобразования данных в тело электронной почты, генерирования кнопок действий, проверки состояния элементов потоков операций, выполнения действий элементов потоков операций, т.д;
  • Мультиязычность на основе настроек пользователя, в том числе с использованием мультиязычных шаблонов;
  • Встроенную защиту от подмены адреса отправителя, благодаря использованию информации MIME входящего письма;
  • Отсылку письма как одному получателю, так и перечню получателей, в том числе с вложениями в письмо.

Дополнение «Простые коммуникации» интегрировано в систему ERP, то есть его функционал применим к любому потоку операций SAP и любому процессу коммуникации между бизнес-пользователями и системой SAP и позволяет

  • ускорить процессы согласования документации
  • нивелировать потери производительности, вызванные невозможностью принять своевременные решения
  • использовать опыт общения пользователя с системой SAP
  • принимать решения офлайн
  • сохранять в системе SAP комментарии бизнес-пользователей без необходимости использовать SAP GUI, NWBC или SAP Fiori

1.3     Глоссарий

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

Элемент потока операций – деловая активность, отдельный шаг потока операций.

Бизнес-пользователь – лицо, имеющее полномочия использовать дополнение, процесс или систему.

Утверждающее лицо – лицо, ответственное за принятие решения о предлагаемом действии

Бизнес-объект / объект GOS – объект в многоуровневом программном приложении, который работает в соответствии с уровнями доступа к данным и бизнес-логикой.

Дополнение «Простые коммуникации» от компании Скайбуфер – SAP сертифицированное решение «Простые коммуникации», разработанное ООО «Скайбуфер»

BADI – бизнес-дополнение SAP, которое позволяет вставлять собственный код и управлять обработкой данных.

1.4     Дополнение к SAP «Простые коммуникации» от компании Скайбуфер

1.4.1     Основной функционал

ID приложения: /SKYBFR/YCA1

Дополнениек SAP «Простые коммуникации» предоставляет универсальный интерфейс прикладного программирования для бизнес-процессов потоков операций

Дополнение к SAP «Простые коммуникации» от компании Скайбуфер обеспечивает:

  • Полностью конфигурируемую обработку входящих электронных сообщений для выполнения действий над элементами потоков операций и для создания комментариев к бизнес-объекту;
  • Поддержку основанных на событиях и основанных на решениях элементов потоков операций;
  • Удобные API-интерфейсы для отправки электронных писем, создания тела электронного сообщения из шаблона HTML, преобразования данных в тело электронной почты, генерирования кнопок действий, проверки состояния элементов потоков операций, выполнения действий элементов потоков операций, т.д;
  • Включенные в пакет exit классы элементов потока операций и основные шаблоны электронных сообщений

 

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

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Полное описание функций решения «Простые коммуникации» доступно в документальном перечне функциональных возможностей.

1.4.2     Дополнение «Простые коммуникации» от Скайбуфер

Дополнение к SAP от компании Скайбуфер включает в себя следующие пакеты:

  • /SKYBFR/YLM1 – компонент управления лицензией компании Скайбуфер. Лицензирование и его условия определяются в пункте «Лицензия» руководства по внедрению приложения «Простые коммуникации». Лицензия привязана к номеру инсталляции SAP и дате окончания подписки.
  • /SKYBFR/YCA1 – Дополнение «Простые коммуникации» от компании Скайбуфер. Ядро.
  • /SKYBFR/YCA1_ERP – Дополнение «Простые коммуникации» от компании Скайбуфер. ERP API
  • /SKYBFR/YCA1_ERP_RIK – Дополнение «Простые коммуникации» от компании Скайбуфер. Вспомогательные ABAP классы пакета ускоренного внедрения.
  • /SKYBFR/YCA1_WF – Дополнение «Простые коммуникации» от компании Скайбуфер. Интерфейс прикладного программирования потоков операций
  • /SKYBFR/YCA1_WF_RIK – Дополнение «Простые коммуникации» от компании Скайбуфер. Вспомогательные ABAP классы пакета ускоренного внедрения для потоков опреций

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

Все программные и словарные объекты располагаются в области имен / SKYBFR /, поэтому они предоставляются «как есть», не нуждаются в настройке и не могут быть изменены Клиентом.

1.4.3     Интерфейс дополнения «Простые коммуникации»

Дополнение «Простые коммуникации» предоставляет API, который состоит из классов ABAP и объектов словаря. Наиболее важными из них являются:

  • /SKYBFR/CL_YCA1_CORE_UTILS – «Простые коммуникации»: Утилиты ядра. Предоставляет основные методы обработки электронных писем (работа с содержимым электронной почты, вложениями, получателями);
  • /SKYBFR/CL_YCA1_CORE_VERSION – «Простые коммуникации»: Информация о версии. Содержит номер и имя версии, ID приложения, название и описание приложения;
  • /SKYBFR/CL_YCA1_WF_MAIL_INBND – «Простые коммуникации»: Обработка входящего потока операций. Выполняет обработку входящих электронных сообщений. Полностью автоматизирован и настраивается. Не нуждается в адаптации;
  • /SKYBFR/CL_YCA1_ERP_UTILS – «Простые коммуникации»: Утилиты ECC и S/4. Класс утилит предназначен для обработки вложений в объекты BUS-объектов, генерации журналов.

1.4.3.1       Элемент потока операций, основанный на решении

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

Например, когда бизнес-объект сохраняется, запускается поток операций, и система SAP отправляет на адрес получателя электронное сообщение с активными кнопками «Утвердить» и «Отклонить». Когда получатель нажимает кнопку «Утвердить» или «Отклонить», автоматически генерируемое сообщение электронной почты отправляется в систему SAP, и соответствующее действие выполняется для элемента потока операций. Затем поток операций совершает это действие с бизнес-объектом.

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

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

1.4.3.2   Уведомления в потоке операций и сохранение комментариев по GOS-объектам

Необходимо просто сообщить бизнес-пользователям и получить от них комментарии по электронной почте.

Например, когда бизнес-объект изменен, запускается процесс потока операций, и система SAP отправляет получателям электронное сообщение с данными документа и кнопкой «Отправить комментарий». Когда один из получателей нажимает кнопку «Отправить комментарий», автоматически создается электронное письмо, которое отправляется в систему SAP, а комментарий добавляется как вложение к бизнес-объекту.

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

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

1.4.3.3       Разработка заказных решений по электронным сообщениям и потоку операций

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

Решение «Простые коммуникации» от компании Скайбуфер предоставляет удобный API для таких случаев.

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

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

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

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

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

2.  Обоснование решения

2.1     Альтернативное решение

Альтернатива решению компании Скайбуфер — это индивидуальная разработка для каждого бизнес-процесса, будь то поток операций или другое взаимодействие с приложениями SAP.

2.2     Управление и стратегия в области ИТ

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

Решение является нейтральным к программному обеспечению почтовых клиентов и работает с почтовыми клиентами:

  • В диалоговом режиме
  • В десктопной версии
  • В мобильной версии
  • LotusNotes.

Решение позволяет повторно использовать программные объекты и ускорить разработку сценариев использования приложений SAP.

Дополнение к SAP «Простые коммуникации» от компании «Скайбуфер» также может использоваться в качестве основы для моделирования любого вида общения с / из SAP.

2.3     Архитектурный подход

Решение содержит новый технический компонент, который может быть повторно использован для будущих пользовательских разработок в простых сценариях общения с системой SAP NetWeaver.

2.4     Совокупная стоимость владения

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

Основные задачи обработки входящих и исходящих вызовов решаются «из коробки».

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

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

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

 

3. Архитектура решения

3.1 Системный контекст

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

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Дополнение к SAP от компании Скайбуфер интегрировано в систему SAP и использует стандартный компонент SAP Connect для приема и отправки электронных сообщений через существующий корпоративный почтовый сервер Клиента. Таким образом, все корпоративные политики безопасности, касающиеся сегмента электронной почты, полностью совместимы с решением компании Скайбуфер.

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

3.2 Интеграция. Обзор

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Дополнение от компании Скайбуфер интегрировано в систему SAP как набор программных объектов и необходимых объектов ABAP-словаря. Оно не может работать независимо, оно полностью контролируемо. Оно работает как Exit-классы для обработки входящей электронной почты или потока операций, или его методы вызываются из пользовательской разработки.

Все вызовы из приложения компании Скайбуфер инициируются объектами программ управления.

3.3 Функциональность. Обзор

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Как видно из функциональной диаграммы, дополнение к SAP от компании Скайбуфер состоит из нескольких классов. Объекты словаря, приведенные ниже, не отображаются, поскольку они не работают как функциональные блоки. Шаблоны HTML не отображаются, поскольку они могут быть настроены, созданы, удалены, изменены или даже не использованы. Класс утилит предоставляет несколько полезных методов для управления потоками операций или элементами потоков операций, форматирования и отправки электронных писем и выполнения других действий, связанных с потоками операций и электронными сообщениями. Информация о версии может использоваться для проверки установленной версии дополнения от компании Скайбуфер. Классы Exit предоставляются в качестве примеров реализации и могут быть использованы в качестве лучшей практики для Клиента для создания своего конкретного класса. Класс обработки входящей электронной почты предоставляет интерфейс для обработки входящей электронной почты.

4. Безопасность

4.1. Архитектура безопасности

Дополнение к SAP от компании Скайбуфер использует функциональные возможности следующих блоков SAP NetWeaver без каких-либо корректировок и модификаций:

– SAP Connect (входящие и исходящие сообщения электронной почты) плюс внешняя электронная переписка, интегрированная с SAP Connect через стандартные подходы к электронной коммуникации SAP

– Стандартные тексты SAP

– SAP потоки операций

– SAP ArchiveLink

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

Дополнение от компании Скайбуфер не требует никаких дополнительных подключений RFC, никакой специальной настройки учетных записей электронной почты. Не используются никакие веб-службы; внешние веб-службы не поставляются в составе приложения от компании Скайбуфер.

Руководство по внедрению SAP позволяет настроить отправку пользователю статуса обработки входящей электронной почты до стольки раз, сколько это предусмотрено в настройке. Это означает возможность индивидуальной настройки для конкретного уникального идентификатора действия, согласно которой дополнение от компании «Скайбуфер» будет обрабатывать только первое электронное сообщение, поступающее в SAP, а затем учитывать, что уникальный идентификатор действия уже был использован. Такой вид архитектуры безопасности SAP полностью зависит от архитектуры безопасности стандартных функций SAP и модели безопасности почтового сервиса электронной почты (в настоящей время в основном от внутренней архитектуры Office 365) и помогает избежать риска нарушения безопасности в среде SAP.

4.2     Безопасность инфраструктуры

Дополнение от Скайбуфер использует инфрструктуру корпоративной почты Клиента со всеми существующими инструментами безопасности. Оно работает на основе системы SAP, и учитывает все имеющиеся средства безопасности SAP. См. Раздел 3.1 «Архитектура решения»

4.3     Безопасность приложения

4.3.1     Развертывание приложения

В настоящее время дополнение от Скайбуфер может быть установлено как обычное дополнение (Add-On) через транзакцию SAINT.

В качестве плана отката, дополнение может быть полностью удалено из системы стандартными средствами.

4.3.2     Версии

Дополнение «Простые коммуникации» содержит атрибуты версии внутри пакета / SKYBFR / YCA1. Установленную версию, идентификатор, имя и его описание можно проверить в любое время. Компания Скайбуфер публикует план развития дополнения «Простые коммуникации» на официальном веб-сайте и регулярно обновляет его. Компания Скайбуфер учитывает все индивидуальные требования Клиента, разрабатывая новые версии дополнения.

4.3.3     Информация, используемая в дополнении

Дополнение «Простые коммуникации» работает со следующими видами данных в режиме создания / обновления:

– данные элементов потоков операций SAP (контейнеры, статусы).

– ArchiveLink тексты для транзакционных (бизнес) объектов SAP.

– Дополнительные данные, которые могут быть обновлены дополнением «Простые коммуникации» в соответствии с реализацией BADI (BADI включен в решение в пространстве имен /SKYBFR/, реализация может быть выполнена в конкретном пространстве имен Z или Y).

Дополнение «Простые коммуникации» работает со следующими видами данных в режиме создания / обновления: – данные элементов потоков операций SAP (контейнеры, статусы). – ArchiveLink тексты для транзакционных (бизнес) объектов SAP. – Дополнительные данные, которые могут быть обновлены дополнением «Простые коммуникации» от компании Скайбуфер в соответствии с реализацией BADI (BADI включен в решение в пространстве /SKYBFR/, реализация может быть выполнена в конкретном пространстве имен Z или Y).

Кроме того, дополнение «Простые коммуникации» способно считывать данные из:

– Основная запись пользователя (адрес электронной почты).

– Основные данные персонала (инфо-тип 0105 подтип 010 и инфо-тип 0105 подтип 001), для получения идентификатора пользователя по табельному номеру, а также информации об адресе электронной почты.

– Получение табельного номера через стандартные правила ABAP SAP.

4.4     Аутентификация конечного пользователя

Дополнение к SAP от Скайбуфер использует стандартную модель аутентификации SAP из NetWeaver для контроля доступа бизнес-пользователей к данным, управляемым дополнением «Простые коммуникации».

Кроме того, при обработке входящих сообщений дополнение от Скайбуфер использует основные данные SAP в соответствии с конфигурацией порядка анализа адреса оправителя из руководства по внедрению для дополнения от Скайбуфер (транзакция SPRO):

– US (идентификатор пользователя).

– P (Мастер персонала).

В этом случае, когда приходит входящее электронное сообщение от SAP Connect, дополнение от компании Скайбуфер получает адрес электронной почты отправителя и выполняет поиск объекта основных данных SAP (идентификатор пользователя или номер персонала) с использованием адреса электронной почты отправителя. В случае, если идентификатор пользователя определен, электронное сообщение принимается дополнением от Скайбуфер. Также, возможно проанализировать данные MIME для входящих писем через реализацию BADI для дополнения от компании Скайбуфер. Скайбуфер может обеспечить выборочную реализацию BADI для обработки данных MIME электронной почты в следующих версиях решения.

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

4.5     Роли и авторизации

Надстройка компании Скайбуфер работает как в потоке операций, так и при обработке входящей электронной почты, поэтому использует роли и авторизации, определенные для обработки потока операций и обработки входящих сообщений клиентами (идентификатор пользователя WF-BATCH, например, обработка входящих писем – идентификатор пользователя для SAP Connect).

Для формирования исходящих писем учитываются права доступа текущего пользователя SAP.

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

5. Реализация

5.1     Дополнение к SAP «Простые коммуникации» от компании Скайбуфер

5.1.1     Основные технические характеристики

Дополнение к SAP «Простые коммуникации» от компании Скайбуфер разработано в следующих пакетах:

  • /SKYBFR/YCA1
  • /SKYBFR/YCA1_ERP
  • /SKYBFR/YCA1_ERP_RIK
  • /SKYBFR/YCA1_WF
  • /SKYBFR/YCA1_WF_RIK

Кроме того, дополнение «Простые коммуникации» использует /SKYBFR/YLM1 пакет, содержащий компоненты управления лицензиями компании Скайбуфер.

Существует несколько HTML-шаблонов, включенных в стандартные тексты SO10 в качестве частей дополнения к SAP от Скайбуфер.

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

5.1.2     Основные методы

5.1.2.1       GET_HTML_BUTTONS

Создает кнопки действий, сохраняет их в систему и возвращает HTML-фрагмент с кодом кнопок в нем.

get_html_buttons( 
*    iv_email               =
*    iv_wiid                =
*    is_gosobject           =
*    iv_decikey1            =
*    iv_decikey2            =
*    iv_event1              =
*    iv_event2              =
*    iv_action1             =
*    iv_action2             =
*    iv_text1               =
*    iv_text2               =
*    iv_templatename        =
*    iv_template            =
*    it_buttonactions       =
*    iv_container_via_email =
*    iv_container_comment   =
).

Этот метод довольно гибкий. Вы можете задать такие параметры метода как «объект», «действие», «шаблон» и «контейнер» в разных комбинациях для разных случаев.

Входящие электронные сообщения

Здесь Вы можете указать адрес электронной почты для обработки входящих сообщений, сгенерированных нажатием кнопки в параметре iv_email. Если Вы этого не сделаете, дополнение к SAP «Простые коммуникации» будет использовать настройку или конфигурацию SO50 для определения входящего адреса

Объект

Если Вы хотите создать кнопки действий для элемента потока операций (в случае задачи, основанной на решении), Вы должны указать идентификатор элемента потока операций в значение iv_wiid, также рекомендуется заполнить is_gosobject и указать бизнес-объект и ключ (если нет, адд-он попытается распознать его из идентификатора элемента потока операций). Это создаст кнопки действий. И после того, как пользователь нажмет эти кнопки и отправит сгенерированное электронное письмо, система автоматически перейдет к нему и выполнит нужное действие для элемента потока операций.

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

Примечание. Is_gosobject является обязательным параметром в методе get_html_buttons для событийных задач

Действие

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

Если одновременно имеют место одна или две кнопки действий, Вы можете использовать параметры iv_decikey *, iv_event *, iv_action *, iv_text *. Если необходимо иметь больше кнопок, заполните таблицу it_buttonactions.

Если Ваш элемент потока операций является решением пользователя, предоставьте ключи решения в параметре iv_decikey * (обычно это значения «0001», «0002», …).

Если Ваш элемент потока операций основан на событиях, укажите имена событий в iv_event * (их можно найти в результатах элемента потока операций, это технические названия событий).

В обоих случаях Вы должны заполнить параметр iv_action *. Это значение будет использоваться как имя действия в системе, в то время как действие будет обрабатываться.

Текст, который пользователь увидит на кнопках, должен быть помещен в параметр iv_text *. Если этот параметр не заполнен, будет использовано значение из iv_action *.

Шаблон

Вы можете назначить собственное имя шаблона HTML, которое будет использоваться для генерации фрагмента кнопок, в противном случае будет использоваться имя текста SO10 из общей конфигурации приложения; если их нет, будет использован шаблон с именем / SKYBFR / BUTTONS_EMAIL_TEMPLATE.

Этот шаблон должен содержать теги для заполнения значениями (n – номер кнопки, 1,2, …, любое число):

%URLn% или <!–%URLn%–> — для ссылки “mailto”, которая будет содержать уникальный идентификатор кнопки

%ACTIONn% или <!–%ACTIONn%–> — для текста, который увидит пользователь.

Контейнер

Для кнопок действий Вы можете установить либо на уровне потока операций, либо на уровне элемента потока операций элемент «Контейнер» для заполнения комментариями пользователя (параметр метода iv_container_comment, элемент «Контейнер» должен быть SOLI и многострочный) и флаг «решение по электронной почте» (параметр метода iv_container_via_email, элемент «Контейнер» должен быть CHAR1). Вы должны передать значение в виде строки со следующими данными, разделенными пробелами: имя контейнера, место для контейнера (элементы потока операций для уровня элементов потока операций, по умолчанию; или поток операций для уровня потока операций) и значение контейнера (по умолчанию «по электронной почте»).

Пример кода

Вот примеры кода, которые показывают, как использовать этот метод.

Данный код создает фрагмент HTML с двумя кнопками принятия решения для элемента потока операций управления пользователя с кнопками 0001 и 0002 принятия решений. Действия и тексты кнопок – «Утвердить» и «Отклонить». Кроме того, элементы контейнера для флага «по электронной почте» и комментарии пользователя устанавливаются как EV_DECISION_BY_EMAIL и EV_COMMENT на уровне потока операций. Флаг «по электронной почте» будет установлен как X, если действие выполняется из электронной почты. Использован шаблоном по умолчанию:

lv_buttons = get_html_buttons(
  iv_wiid                = ls_wi_header-wi_id
  is_gosobject           = ls_gosobject
  iv_decikey1            = '0001'
  iv_decikey2            = '0002'
  iv_action1             = 'Approve'
  iv_action2             = 'Reject'
  iv_container_via_email = 'EV_DECISION_BY_EMAIL WF X'
  iv_container_comment   = 'EV_COMMENT WF' ).

Следующий код похож на предыдущий, но предназначен для элемента потока операций, основанного на действии. Он использует события RELEASED и SIGNIFICANTLYCHANGED. И он использует уровень элемента «контейнер» по умолчанию, события сохраняются на уровне элемента потока операций:

lv_buttons = get_html_buttons(
  iv_wiid                = ls_wi_header-wi_id
  is_gosobject           = ls_gosobject
  iv_event1              = 'RELEASED'
  iv_event2              = 'SIGNIFICANTLYCHANGED' 
  iv_action1             = 'Approve'
  iv_action2             = 'Reject'
  iv_container_via_email = 'EV_DECISION_BY_EMAIL' 
  iv_container_comment   = 'EV_COMMENT' ).

Следующий пример кода создает только одну кнопку для комментария пользователя или вложения (в зависимости от настроек приложения). Имя действия – «Подписать». Текст на кнопке – «Подписать документ». И шаблон HTML-фрагмента – это / SKYBFR / BTNSIGN_EMAIL_TEMPLATE вместо стандартного:

lv_buttons = get_html_buttons(
  is_gosobject           = ls_gosobject
  iv_action1             = 'Sign'
  iv_text1               = 'Sign On Document'
  iv_templatename        = '/SKYBFR/BTNSIGN_EMAIL_TEMPLATE' ).

5.1.2.2       CONVERT_VALUES_TO_HTML

Это очень мощный метод преобразования содержания тела электронной почты в удобочитаемую форму. Он преобразует набор различных значений в фрагмент HTML. Может быть полностью настроен с помощью шаблонов. Данный метод возвращает строковое значение с фрагментом HTML в нем

convert_values_to_html(
*  EXPORTING
*    iv_sectiontemplate       =
*    iv_sectiontemplatename   =
*    iv_header                =
*    iv_headertemplate        =
*    iv_headertemplatename    =
*    iv_string                =
*    iv_stringtemplate        =
*    iv_stringtemplatename    =
*    it_values                =
*    iv_valuestemplate        =
*    iv_valuestemplatename    =
*    iv_valuesrowtemplate     =
*    iv_valuesrowtemplatename =
*    it_data                  =
*    iv_datatemplateisfull    = ABAP_FALSE
*    iv_datatemplate          =
*    iv_datatemplatename      =
*    iv_datarowtemplate       =
*    iv_datarowtemplatename   =
*    iv_dataheadtemplate      =
*    iv_dataheadtemplatename  =
*    iv_datacelltemplate      =
*    iv_datacelltemplatename  =
).

Как Вы можете видеть, все параметры являются необязательными. Этот метод может получить их в любых комбинациях и подготовить фрагмент HTML, содержащий заголовок, текстовую строку, пары Имя-Значение и таблицы данных, или некоторые из них в таком порядке. Он также может использовать настраиваемые шаблоны, если Вы не хотите использовать стандартный для раздела шаблон (весь фрагмент) или для любого из элементов элементы. Кроме того, Вы можете найти шаблоны по умолчанию в самом начале кода этого метода и понять их логику. Каждый шаблон может быть представлен как текстовая строка с HTML-кодом в ней или как имя текста SO10, в этом случае метод будет читать этот текст сам и использовать его в качестве шаблона. Если некоторые или все шаблоны не представлены, метод будет использовать стандартные шаблоны.

Раздел

Раздел — это и есть фрагментом HTML. Разделами можно последовательно наполнять тело электронного письма.

Вы можете настроить шаблон раздела, указав его как значение строки шаблона в iv_sectiontemplate или как имя текста SO10 в iv_sectiontemplatename. Он довольно схож с одной из частей HTML-страницы, которая может быть помещена между тегами <BODY> </ BODY>. Вы можете объединить любое количество разделов и поместить их в основной шаблон электронного сообщения в качестве тела электронного сообщения. Он должен содержать тег %CONTENT% или <!-%CONTENT%->, где будут размещены все остальные элементы раздела (заголовок, текстовая строка, пары имя-значение и таблица данных).

Заголовок

Это текстовая строка в самом начале фрагмента HTML. Как правило, это имя или название фрагмента, или просто текст с более крупным шрифтом для привлечения внимание. Укажите значение в параметре iv_header. Вы можете настроить этот шаблон, указав его как значение строки шаблона в iv_headertemplate или как имя шаблона из текста SO10 в iv_headertemplatename. Если Вы используете шаблон по умолчанию для раздела, он должен быть <TR> <TD> … </ TD> <TR> фрагментом HTML. Он должен содержать тег %CONTENT% или <!-%CONTENT%->, где будет размещено Ваше строковое значение.

Текстовая строка

Это просто текстовая строка, которая может использоваться для предоставления некоторой информации пользователю в виде простого текста. Вы можете использовать, например, теги </BR> в своем строковом значении, чтобы разделить его на абзацы. Передайте значение в параметре iv_string. Вы можете настроить его шаблон, указав его как значение строки шаблона в iv_stringtemplate или как имя текста SO10 в iv_stringtemplatename. Если Вы используете для раздела шаблон по умолчанию, он должен быть <TR> <TD> … </ TD> <TR> фрагментом HTML. Он должен содержать тег %CONTENT% или <! -%CONTENT%->, где должно быть размещено значение строки.

Пары «имя-значение»

Пары «имя-значение» представляют из себя несколько строк с именем и значением в каждой строке. Имеет смысл, когда нужно предоставить несколько элементов в удобочитаемой форме. Укажите имена и значения в таблице it_values. Вы можете настроить шаблон, указав их как строковое значение шаблона или как имя текста шаблона SO10 для всего блока «имя-значение» в iv_valuestemplate или iv_valuestemplatename и один ряд этого блока в iv_valuesrowtemplate или iv_valuesrowtemplatename. Если Вы используете для раздела шаблон по умолчанию, шаблон блока должен быть <TR> <TD> … </ TD> <TR> фрагментом HTML. Он должен содержать тег %CONTENT% или <!-% CONTENT% ->, где должны быть размещены строки имя-значение. Шаблон строки представляет одну строку этого блока и обычно представляет фрагмент <TR> … </ TR> и должен содержать%NAME% или тег <! -%NAME-> для имени и %CONTENT% или <!-%CONTENT%-> для значения.

Таблица данных

Таблица данных представляет из себя любую таблицу с данными. Эта таблица обычно формируется с заголовком. Укажите данные в it_data.

Эта часть имеет широкую функциональность.

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

Вы можете передать шаблон ячейки заголовка в iv_dataheadtemplate или iv_dataheadtemplatename и шаблон ячейки данных в iv_datacelltemplate или iv_datacelltemplatename, и этот метод сформирует таблицу с Вашими форматами. Это фрагменты <TH> .. </ TH> и <TD> .. </ TD>, и они должны содержать тег %CONTENT% или <!-%CONTENT%->, где будет помещено значение.

Кроме того, Вы можете передать весь шаблон таблицы в iv_datatemplate или iv_datatemplatename с предопределенными заголовками столбцов или даже без них и всеми шаблонами строки в iv_datarowtemplate или iv_datarowtemplatename. В этом случае Вы должны заполнить iv_datatemplateisfull = ABAP_TRUE, и шаблон строки должен содержать тег %CONTENTn% или <!-% CONTENTn%-> для каждого значения ячейки столбца (n = 1,2, …, его номер столбца, поле таблицы номер).

5.1.2.3       INJECT_HTML_CONTENT

Вставляет одну текстовую строку в другую, используя указанный тег в качестве точки для вставки.

inject_html_content(
*    iv_contname = 'CONTENT'
    iv_content  =
    iv_template =).

Полезен для заполнения HTML-шаблонов фрагментами или значениями. Вы должны поместить имя тега контента в iv_contname. По умолчанию используется CONTENT. Это означает, что в HTML-шаблоне будет вестись поиск %CONTENT% или <!-%CONTENT%->. Значение контента iv_content будет помещено в шаблон HTML вместо указанного тега. Сам HTML-шаблон должен быть помещен в значение iv_template. Метод возвращает шаблон HTML со значением контента, вставленным в позицию указанного тега.

Пример кода

В данном коде показан пример, в котором тег %DETAILS% заменяется значения lv_details и тег %BUTTONS% заменяется значением lv_buttons в HTML фрагменте lt_template. Код выглядит следующим образом:

lv_template = inject_html_content(
  iv_contname = 'DETAILS'
  iv_content  = lv_details
  iv_template = lv_template ).
lv_template = inject_html_content(
  iv_contname = 'BUTTONS'
  iv_content  = lv_buttons
  iv_template = lv_template ).

5.1.2.4       PREPARE_FINAL_RECIPIENTS

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

prepare_final_recipients(
  EXPORTING
    iv_wfd_id  =
    iv_task_id =
  CHANGING
    ct_actors  =
    ct_return  =
).

Вам следует указать идентификатор потока операций в iv_wfd_id и идентификатор задачи в iv_task_id, метод будет использовать их для определения настроек, и в соответствии с ними он изменит данную таблицу ct_actors. Кроме того, он добавляет сообщения об ошибках в таблицу ct_return, если таковые встречаются.

Пример кода

Этот пример кода заменяет или дополняет таблицу lt_actors заместителями в соответствии с настройками для задачи ls_wi_attributes-wi_rh_task потока операций и идентификатора задачи ls_wi_header-wi_rh_task. Если возникают какие-либо ошибки, они собираются в таблице lt_return:

prepare_final_recipients(
  EXPORTING
    iv_wfd_id  = ls_wi_attributes-wi_rh_task
    iv_task_id = ls_wi_header-wi_rh_task
  CHANGING
    ct_actors  = lt_actors
    ct_return  = lt_return ).

5.1.2.5       CONVERT_RECIPIENTS

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

convert_recipients(
  EXPORTING
    it_recipients =
*    iv_objorder   =
*  IMPORTING
*    et_recipients =
  CHANGING
    ct_emails     =
    ct_return     =
).

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

Вы можете установить порядок поиска, указав значение для параметра iv_objorder. Если этого не делать, будет использоваться значение из настроек приложения; если и это не настроено, будет использоваться значение по умолчанию. Существуют некоторые вариации этого значения: «US P» (по умолчанию), «P US», «US» или «P», где US означает запись пользователя (SU01 t-code), а P означает запись персонала (инфо-тип 0105 10 подтипа).

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

Список адресов электронной почты с полными именами будет собран в таблице ct_emails. Дубликаты будут удалены оттуда.

Пример кода

В этом примере список получателей lt_actors будет преобразован в список электронных адресов lt_emails с помощью настроек приложения для порядка поиска (или значения по умолчанию). Ошибки, если таковые будут иметь место, будут собраны в таблице lr_return.

convert_recipients(
  EXPORTING it_recipients = lt_actors
  CHANGING  ct_emails     = lt_emails
            ct_return     = lt_return ).

5.1.2.6       SEND_EMAIL

Этот метод формирует запрос на электронное сообщение и отправляет его в SAP Connect для исходящей обработки. Он имеет полезную функциональность для упрощения процесса отправки электронного сообщения. Он может использовать разные параметры для предоставления Получателей. Кроме того, этот метод может получить шаблон электронного сообщения и поместить в него содержимое электронного сообщения, если необходимо.

send_email(
  EXPORTING
*    it_recipients   =
*    it_emails       =
*    iv_email        =
    iv_content      =
    iv_subject      =
*    iv_templatename =
*  IMPORTING
*    et_return       =
).

Вы можете указать список получателей в таблице it_recipients и / или список адресов электронной почты в таблице it_emails и / или один адрес электронной почты в значении iv_email. При наличии, список получателей будет преобразован в адреса электронной почты. Все эти адреса электронной почты будут объединены в один список, и электронное письмо будет отправлено всем пользователям. Содержание электронного сообщения должно передаваться в значении iv_content как текстовая строка в формате HTML. Вы должны указать тему электронного сообщения в строчном значении iv_subject. Кроме того, Вы можете указать имя HTML-шаблона в значении iv_templatename, которое является именем текста SO10. В этом случае iv_content должен быть не полным телом электронного сообщения HTML, а просто фрагментом, который будет введен в шаблон вместо тега %CONTENT% или <!-%CONTENT%->. В случае возникновения каких-либо ошибок при подготовке запроса на отправку они будут собраны в таблице et_return.

Пример кода

Этот пример кода отправит электронное сообщение на адрес <fs_email> -email с lv_content в качестве тела электронного сообщения и значением lv_suject в качестве темы электронного сообщения. Ошибки, если таковые произойдут, будут собраны в таблице lt_return.

send_email(
  EXPORTING iv_email        = <fs_email>-email
            iv_content      = lv_content 
            iv_subject      = lv_subject
  IMPORTING et_return       = lt_return ).

 

5.1.3     Структура классов

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Как Вы видите из данной диаграммы, основным классом явлется /SKYBFR/CL_YCA1_CORE_UTILS, данный класс наследуется классом /SKYBFR/CL_YCA1_ERP_UTILS, который, в свою очередь, наследуется классами /SKYBFR/CL_YCA1_WF_UTILS и /SKYBFR/CL_YCA1_MAIL_BONE.

/SKYBFR/CL_YCA1_WF_UTILS наследуется классами /SKYBFR/CL_YCA1_WF_EXIT_BONE, /SKYBFR/CL_YCA1_WF_MAIL_INBND, /SKYBFR/CL_YCA1_WF_REMINDER и /SKYBFR/CL_YCA1_WF_ERROR_NOTIF.

Как /SKYBFR/CL_YCA1_MAIL_BONE, так и /SKYBFR/CL_YCA1_WF_EXIT_BONE имеют собственные подклассы в пакете ускоренного внедрения (RIK).
RIK представляет из себя пакет дополнительных ABAP классов «из коробки» для нижеперечисленных объектов:

  • /SKYBFR/CL_YCA1_…_DMS «Простые коммуникации»: Ускоренное внедрение. Документ
  • /SKYBFR/CL_YCA1_…_EQUI «Простые коммуникации»: Ускоренное внедрение. Оборудование
  • /SKYBFR/CL_YCA1_…_FI_FA «Простые коммуникации»: Ускоренное внедрение. Основные средства
  • /SKYBFR/CL_YCA1_…_MM_CO «Простые коммуникации»: Ускоренное внедрение. Контракт
  • /SKYBFR/CL_YCA1_…_MM_GR «Простые коммуникации»: Ускоренное внедрение. Движение материалов
  • /SKYBFR/CL_YCA1_…_MM_IV «Простые коммуникации»: Ускоренное внедрение. Счет-фактура
  • /SKYBFR/CL_YCA1_…_MM_MAT «Простые коммуникации»: Ускоренное внедрение. Материал
  • /SKYBFR/CL_YCA1_…_MM_PO «Простые коммуникации»: Ускоренное внедрение. Заказ на закупку
  • /SKYBFR/CL_YCA1_…_MM_PR «Простые коммуникации»: Ускоренное внедрение. Заявка на закупку
  • /SKYBFR/CL_YCA1_…_MM_RFQ «Простые коммуникации»: Ускоренное внедрение. Запрос ценового предложения
  • /SKYBFR/CL_YCA1_…_PM_GN «Простые коммуникации»: Ускоренное внедрение. Общее уведомление
  • /SKYBFR/CL_YCA1_…_PM_MN «Простые коммуникации»: Ускоренное внедрение. Уведомление ТОРО
  • /SKYBFR/CL_YCA1_…_PM_MO «Простые коммуникации»: Ускоренное внедрение. Заказ ТОРО
  • /SKYBFR/CL_YCA1_…_QM_QN «Простые коммуникации»: Ускоренное внедрение. Партия контроля качества
  • /SKYBFR/CL_YCA1_…_SD_SO «Простые коммуникации»: Ускоренное внедрение. Сбытовой заказ

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

В соответствии с этим процессом могут быть реализованы следующие события элементов потока операций:

  • AFTER_CREATE
  • AFTER_EXECUTION
  • AFTER_ASYNC_INVOKE
  • AFTER_RULE_EXEC
  • BEFORE_CREATE
  • BEFORE_EXECUTION
  • BEFORE_REMOVE
  • STATE_CHANGED
  • AFTER_ACTION
  • BEFORE_ACTION

В пользовательском EXIT классе потока операций необходимо переопределить соответствующий метод.

В EXIT классах потока операций раздел макросов содержит отдельную include-команду потока операций <CNTN02>, для некоторых случаев раздел макросов пользовательского класса должен содержать дополнительную include-команду <CNTN03>

 

5.1.4     Внедрение

5.1.4.1       Общие условия

– Дополнение к SAP «Простые коммуникации» устанавлено и настроено в соответствии с Руководством по установке и обслуживанию;

– Лицензионный ключ действителен;

– Входящая электронная почта настроена (t-код: SO50). (Входящий класс / SKYBFR / CL_YCA1_WF_MAIL_INBND должен быть назначен по умолчанию);

5.1.4.2       Внедрение класса генерации пользовательских уведомлений (например, деблокирование заказа на закупку)

5.1.4.2.1       Переопределение класса BONE

Унаследуйте класс /SKYBFR/CL_YCA1_ERP_MAIL_BONE в Ваш новый пользовательский класс (например, ZCL_YCA1_ERP_MAIL_BONE). /SKYBFR/CL_YCA1_ERP_MAIL_BONE должен быть определен как супер класс. Это будет Ваш основной класс генерации электронных сообщений, он будет отвечать за единый стиль всех Ваших сообщений.

5.1.4.2.2       Создание копии класса уведомлений RIK

Создайте копию класса ERP RIK. Например, скопируйте класс /SKYBFR/CL_YCA1_ERP_MAIL_MM_PO в ZCL_YCA1_ERP_MAIL_MM_PO.

Установите пользовательский BONE в качестве суперкласса (в данном примере ZCL_YCA1_ERP_MAIL_BONE)

Если объект отсутствует в списке классов, предоставляемых «из коробки», то есть готовыми и настроенными, выберите наиболее подходящий класс, который будет использоваться в качестве шаблона

5.1.4.2.3       Подготовка электронного сообщения

Основным методом генерации электронного сообщения является PREPARE_MAIL (/ SKYBFR / CL_YCA1_ERP_MAIL_BONE), который может быть переопределен в пользовательском методе. Метод подготовки электронного сообщения состоит из нескольких простых частей. В общем случае этот метод возвращает стандартные шаблоны в соответствии с потоком процесса текущего объекта. Если стандартный шаблон, представленный в методе GET_TEMPLATES, не подходит, его можно определить в методе GET_HTML_TEMPLATE. Если дизайн шаблона устраивает, дополнительная разработка не требуется. Следующим шагом будет добавление элемента шаблона

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)
Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Вы можете переопределить следующие методы, чтобы использовать Ваш корпоративный стиль электронной почты:

  • GET_FOOTER – Подпись
  • GET_HEADER – Строки заголовка и подзаголовка
  • GET_SECTIONS – Содержание электронного сообщения.
  • GET_TEMPLATE – Имя шаблона и сам шаблон

Метод PREPARE_EMAIL позволяет создавать электронное сообщение, которое настроено в соответствии с любыми бизнес-требованиями

5.1.4.3       Внедрение пользовательского Exit класса потока операций (например, деблокирование заказа на закупку)

5.1.4.3.1       Условия:
  • Есть поток операций для деблокирования заказа на закупку;
  • Есть как минимум одна задача, основанная на решении, в потоке операций;
5.1.4.3.2       Создание пользовательского класса потока операций Exit Bone

Необходимо скопировать пользовательские Exit классы потока операций из /SKYBFR/CL_YCA1_WF_BONE, в данном примере /SKYBFR/CL_YCA1_WF_EXIT_BONE должен быть скопирован в ZCL_YCA1_WF_EXIT_BONE с переопределением некоторых методов, указанных выше.

5.1.4.3.3       Создание пользовательского Exit класса потока операций

Необходимо скопировать пользовательский Exit класс потока операций из  /SKYBFR/CL_YCA1_WF_<OBJ>, в данном примере /SKYBFR/CL_YCA1_WF_EXIT_MM_PO должен быть скопирован в ZCL_YCA1_WF_EXIT_MM_PO. Пользовательский Bone класс должен быть указан как супер класс для ZCL_YCA1_WF_EXIT_MM_PO с переопределением методов GET_BUTTONS и GET_SECTIONS, если необходимо.

5.1.4.3.4       Назначение программного выхода для задачи

Для всех задач, требующих обработки событий дополнением «Простые коммуникации», настраиваемый класс устанавливается на предыдущем шаге как выход из программы для элемента потока операций:

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)
5.1.4.3.5       Переопределение методов событий

В классе /SKYBFR/CL_YCA1_WF_EXIT_BONE переопределите методы, унаследованные из /SKYBFR/CL_YCA1_WF_EXIT и примените логику создания простых уведомлений и их отправки соответствующим участникам процесса.

Методы событий должны быть реализованы в соответствии с требованиями, описанными ниже.

Структура метода события выглядит следующим образом:

  1. Проверка номера элемента потока операций, чтобы убедиться, что метод работает для требуемого элемента, и разделение логики для разных задач
Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

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

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

3. Чтение списка участников процесса, которые должны быть включены в обмен сообщениями и установлены как участники:

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

4. Вызов метода PREPARE_MAIL чтобы получить сообщение, сформированное с использованием ранее созданного класса (в данном примере ZCL_YCA1_ERP_MAIL_MM_PO). Затем отправка созданного сообщения путем вызова метода SEND_EMAIL.

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

ПРИМЕЧАНИЕ. Все методы, доступные в супер классах, также доступны непосредственно в унаследованных классах: в любом … WF_EXIT_ <CUSTOM_N> классе методы из / SKYBFR / CL_YCA1_CORE_UTILS, / SKYBFR / CL_YCA1_ERP_UTILS, / SKYBFR / CL_YCA1_WF_UTILS могут быть вызваны напрямую.

5.1.4.3.6       Создание пользовательского HTML-шаблона в MJML Framework

В качестве альтернативы прямому созданию HTML-шаблона можно использовать среду MJML, а затем код должен быть преобразован в HTML (доступен в среде MJML – MJML framework)

Например, исходный шаблон, созданный в коде интерфейса MJML, может выглядеть так, как показано ниже:

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Предпросмотр:

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Преобразование кода MJML в инструмент HTML:

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

HTML должен быть сохранен в файле текстового формата Reach (* .rtf) и загружен как стандартный текст (t-код: SO10)

ПРИМЕЧАНИЕ. Для HTML-шаблонов есть готовое решение. Оно настраивается в узле настройки: Руководство по внедрению SAP по настройке ®  «Простые коммуникации» от Скайбуфер для потока операций ®  Настройки конфигурации ® Общие настройки конфигурации. Доступны следующие шаблоны:

  • HTML-шаблоны кнопок действий
  • Шаблон электронного сообщения с отклоненным действием
  • Общий шаблон электронного сообщения
  • Шаблон электронного сообщения с подтвержденным действием
  • Общий шаблон напоминания

Предопределенные шаблоны могут быть изменены в соответствии с требованиями бизнеса.

5.1.4.4       Обработка входящих электронных сообщений

5.1.4.4.1       Условия:
  • Входящие электронные сообщения настроены в SO50 T-code. (Входящий класс YCA1 / SKYBFR / CL_YCA1_WF_MAIL_INBND должен быть назначен по умолчанию);
5.1.4.4.2       Сообщение для принятия решений (с UUID) для потока операций

Входящий класс / SKYBFR / CL_YCA1_WF_MAIL_INBND используется для обработки входящих сообщений.

Он поддерживает элементы потока операций на основе событий и решений.

Обработка входящих сообщений может быть настроена в узле IMG в соответствии с Основным руководством:

Руководство по внедрению и настройке систем SAP ®  «Простые коммуникации» от Скайбуфер для потока операций ® Настройки конфигурации ®  Общие настройки конфигурации

Реализация BADI по определению комментария доступна через настройку узла:

Руководство по внедрению и настройке систем SAP ®  «Простые коммуникации» от Скайбуфер для потока операций ®  Обработка BADI-запросов в обратном направлении ® Определение комментариев  ® BADI: Реализация определения компонентов

BAdI доступный в готовом решении: /SKYBFR/YCA1_WF_COMM_CAPT_SMPL

По умолчанию, /SKYBFR/CL_YCA1_WF_COMCAP_SMPL предоставляется с дополнением. Вы можете скопировать реализацию BAdI и использовать ее как шаблон. BADI делает комментарии гибкими для Клиента. Он позволяет использовать обработку комментариев, отличные от стандартной логики обработки, и сохранять их в любом месте или для использования в любых других целях.

Входные параметры:

– Идентификатор объекта BOR;

– Действие по принятию решения;

– Текст комментария.

Примечание: Может применяться стратегия безопасности

5.1.4.4.3       Информационное сообщение (не поток операций)

Входящий объект электронного сообщения может быть определен и обработан в соответствии с требованиями бизнеса. Логика должна быть реализована посредством настройки узла:

Руководство по внедрению и настройке систем SAP ®  «Простые коммуникации» от Скайбуфер для потока операций ®  BADI для обработки входящих сообщений  ® Возможное преобразование в объект BUS ®  BADI: При условии преобразования в объект BUS, конфигурация «из коробки»

Существует предопределенная логика, реализованная «из коробки»:

Пример реализации BAdI: / SKYBFR / YCA1_WF_SUBJ_TO_O_SMPL

Примечание: Может применяться стратегия безопасности

5.1.4.4.4       Стратегия безопасности

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

Руководство по внедрению и настройке систем SAP ®  «Простые коммуникации» от Скайбуфер для потока операций ® Настройки конфигурации ® Бизнес-объект и поток операций / Индивидуальные настройки задачи

Класс и метод применения концепции безопасности должны быть установлены для каждого бизнес-объекта

В готовом виде предоставляются 2 стратегии:

  • Класс /SKYBFR/CL_YCA1_WF_SUBOBJ_SMPL метод CHECK_SENDER_ALLOW_ANY
  • Класс /SKYBFR/CL_YCA1_WF_SUBOBJ_SMPL метод CHECK_SENDER_BY_SO10_LIST

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

CHECK_SENDER_BY_SO10_LISTАдрес отправителя проверяется и разрешается только в том случае, если он включен в белый список. Белый список должен быть создан как стандартный текст и загружен в SO10. Белый список должен быть установлен в качестве дополнительного параметра для настройки бизнес объекта в Индивидуальных пользовательских настройках бизнес объектов и потоков операций / задач. Опции для установки записей белого списка:

Стандартный белый список: /SKYBFR/CHECK_SENDER_DEFAULT_LIST

5.1.4.5       Напоминание

Это напоминание с возможностью эскалации управляющему (начальнику). Уведомление электронной почты содержит все необходимые данные для объектов действий в виде аккордеона с возможностью принятия действий для каждого объекта. Название отчета / SKYBFR / YCA1_WF_REMINDER. Его можно планировать в соответствии с Основным руководством. Для разных процессов и разных задач в одном и том же потоке операций может быть определена конкретная логика для обработки напоминаний или применяемого шаблона.

Вы можете найти установочные образцы:

Класс /SKYBFR/CL_YCA1_WF_REMINDER:

  • Метод FILL_ACCORDION (для электронных сообщений о принятии решений)
  • Метод FILL_ACCORDION_MANAGER (для сообщений об эскалации, которые отправляются менеджерам)

Оба метода могут использоваться в качестве шаблонов для пользовательской реализации.

Структура методов:

  1. Получить «аккордеонный» шаблон с использованием метода GET_HTML_TEMPLATE (стандартный текст / SKYBFR / DEFAULT_ACCORDION_TEMPLATE определяется в методе по умолчанию;
  2. Заполнить шаблон следующими параметрами:

ИМЯ (нижний колонтитул – идентификатор элемента потока операций; пожалуйста, используйте что-то, относящееся к Вашему бизнес-кейсу, например «Заявка на закупку № 500019»,

СОДЕРЖАНИЕ (тело «аккордеона»). Здесь можно иметь заголовок и таблицу данных для определенного бизнес-объекта, обрабатываемого элементом потока операций

Правило эскалации напоминания должно быть задано в узле настроек:

Руководство по внедрению и настройке систем SAP ®  «Простые коммуникации» от Скайбуфер для потока операций ® Настройки конфигурации ®  Общие настройки конфигурации

Параметр: Эскалация напоминания

Вы можете указать правило для эскалации в процессе напоминания. Контейнер правила должен быть таким же, как и для правила 168.

5.1.4.6       Уведомление об ошибках

Уведомление в ИТ-отдел.

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

Отчет / SKYBFR / YCA1_WF_ERRORS_NOTIFY. Его можно планировать в соответствии с Основным руководством.

Вы можете найти готовый образец:

Класс / SKYBFR / CL_YCA1_WF_ERROR_NOTIF:

– Метод FILL_ACCORDION

Структура методов следующая:

  1. Получить шаблон в виде аккордеона с использованием метода GET_HTML_TEMPLATE (стандартный текст / SKYBFR / DEFAULT_ACCORDION_TEMPLATE определяется в методе по умолчанию);
  2. Заполнить шаблон следующими параметрами:

ИМЯ (нижний колонтитул в виде аккордеона в примере – это идентификатор элемента потока операций; пожалуйста, используйте что-то, относящееся к вашему бизнес-кейсу, например «Заявка  на закупку № 500019»,

СОДЕРЖАНИЕ (тело «аккордеона»). Здесь можно иметь заголовок и таблицу данных для определенного бизнес-объекта, обрабатываемого элементом потока операций

Список рассылки (t-код: SO15 / SO23) будет использоваться для отправки уведомлений об ошибках. Обычно сотрудники отдела ИТ или поддержки включены в список рассылки.

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

Руководство по внедрению и настройке систем SAP ®  «Простые коммуникации» от Скайбуфер для потока операций ® Настройки конфигурации ®  Настройки уведомлений об ошибках для потока операций

 

5.2     SAP Translation Hub. ABAP интеграция

Функциональность мультиязычности дополнения к SAP «Простые коммуникации» позволяет использовать любой язык, который требуется.

5.2.1     Условия

Убедитесь, что Вы соответствуете всем условиям сервиса Translation Hub на SAP Cloud Platform, в системе ABAP и в Cloud Connector.

5.2.2     Cloud Connector

Настройте субаккаунт в SAP Cloud Connector для Вашего S-пользователя, чтобы можно было напрямую подключать SAP Cloud и Вашу систему ABAP

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Настройте отображение системы Cloud To On-Premise для соединения RFC. Там предоставляется доступ к функциональным модулям с префиксом LXE_, как показано ниже.

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

5.2.3     SAP Cloud Platform

Создайте пункт назначения в сервисе Translation Hub. Его имя будет выглядеть как STH_ <S-user>, как показано ниже (считается устаревшим с 23.03.2018)

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Для новой версии Translation Hub это имя должно выглядеть как STH_ <S-user> _ <System ID> _ <Client Number>, чтобы иметь возможность использовать несколько систем ABAP для перевода.

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Проверьте, доступна ли Ваша система ABAP из Cloud.

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

5.2.4     Базовая система ABAP

Система ABAP должна быть системой Unicode. Вы можете проверить это в SAP Logon GUI в меню System -> Status

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Функциональные модули, необходимые для RFC-вызовов, должны быть в системе (если нет, имплементируйте ноту SAP 2349776

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Создайте технического пользователя (его имя указано в Translation Hub Destination) типа Communications Data и назначьте требуемую авторизацию для этой роли. Проверьте соответствие этой авторизации документации Translation Hub.

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)
Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)
Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Используйте транзакцию LXE_MASTER для создания списка объектов для перевода.

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Внесите описание списка объектов и добавьте объекты для перевода в него. Используйте тип объекта LIMU REPT для текстовых элементов ABAP. Для имен классов Вы должны добавить символы «=», чтобы имя было длиной в 30 символов, а затем добавить «CP» в конце. Также, Вы можете включать любые другие объекты, такие как Data Elements, для их перевода.

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Сохраните и сгенерируйте список объектов.

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Подождите, пока статус не изменится на X-Generation Complete

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Теперь Вы можете использовать этот список объектов для перевода в Translation Hub.

 

5.2.5     Создание проекта ABAP в SAP Translation Hub

Запустите сервис Translation Hub и создайте проект ABAP

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Начиная с 23 марта 2018 года появляется поле для выбора пункта назначения в Вашу систему ABAP, как описано ниже:

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)
Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Попробуйте выбрать список объектов (используйте поиск)

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Итак, теперь Вы можете выбрать список объектов из Вашей системы ABAP, перевести его, переработать, если необходимо, и отправить его обратно в Вашу систему переведенным на выбранные языки.

5.2.6     Опыт и рекомендации по мультиязычной реализации ABAP

Всегда используйте английский как язык по умолчанию для любой разработки ABAP.

Избегайте использования текстовых констант в Вашем коде. Вместо этого используйте текстовые элементы

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Если возможно, выходные поля экрана или поля печати не должны фиксироваться по ширине, чтобы соответствовать любой длине текста, поскольку он может меняться в зависимости от языка. Пул текстовых элементов инициализируется каждый раз, когда создается программный объект (запущен отчет или создается экземпляр класса). Он инициализируется на текущем языке сеанса пользователя. Поэтому, если Вам нужно использовать текстовые элементы на другом языке, отличном от текущего (например, для подготовки писем для разных получателей), используйте инструкцию SET LANGUAGE для этого. Если пул текстовых элементов не переключен успешно, он возвращает ненулевое значение SY-SUBRC, в этом случае используйте значение языка по умолчанию

Руководство пользователя по инсталляции дополнения SAP «Простые коммуникации» (версия 3.1 от 8 июня 2018)

Вы должны использовать этот фрагмент кода в каждом отчете или классе отдельно. Поскольку это переключает только текущий пул текстовых элементов и не изменяет ни один пул в супер классе или вызываемом отчете, Вам необходимо переключать его внутри каждого используемого Вами объекта программы. Чтобы сбросить текстовый пул на текущий язык сеанса пользователя, просто используйте инструкцию SET LANGUAGE SY-LANGU.

 

 

5.3     Область имен

Дополнение к SAP «Простые коммуникации» полностью разрабатывается в области имен /SKYBFR/.

 

 

5.4     Технические условия

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

  • 1855577
  • 2265639
  • 2335111
  • 2398986

6. Постобработка

Большинство методов приложения компании Скайбуфер возвращают таблицу, содержащую все системные сообщения и ошибки. Кроме того, входящая обработка предоставляет список ошибок в табличной форме в электронном сообщении обратной связи. Таким образом, каждая отдельная ошибка электронных сообщений и потоков операций может быть взята и проанализирована. Отчет ABAP по устранению неполадок, который перезапускает обработку входящих сообщений для выбранного электронного письма, предоставляется в составе дополнения к SAP «Простые коммуникации» от Скайбуфер. / SKYBFR / YCA1_WF_SOIN_RESTART можно использовать для перезапуска входящей обработки любого электронного сообщения или набора электронных сообщений. Он основан на идентификаторе запроса на отправку (GUID), который может быть взят из транзакции SOIN для определенного входящего объекта электронной почты. Кроме того, он может использовать любой входящий класс обработки в системе для обработки электронной почты.

 

Recent Posts

Leave a Comment

Start typing and press Enter to search