Skybuffer Somple Communication Add-On in its application version includes all Framework features apart from the Application component features. Below you can see both the feature lists grouped accordingly.

S/4HANA AND SAP ECC FEATURE LIST OF /SKYBFR/YCA1 APPLICATION

SAP Workflow Package of YCA1 Simple Communication SAP Add-on is designed to provide a universal emailing framework for business workflows and email-to-SAP type of communication.

This solution offers

  • Notifications allowing asynchronous (offline) decision-making without having to log in ​SAP system​;
  • Applicability for any business object in SAP system​;
  • Multilingual support with SAP Translation HUB integration​;
  • Immediate indication of problem-solving in SAP system​;
  • Reminders collecting decision requests in one e-mail in the accordion view;​
  • Simple implementation thanks to numerous mail templates and ABAP classes templates;​
  • Processing of user’s message text and attached files;
  • Sending simple informative messages and notifications​.

Here are the key features of /SKYBFR/YCA1 Workflow Package​ for S/4HANA and SAP ECC systems:

4302 :: CONVERT DECISION ACTIONS INTO HTML BUTTONS

Converts work item decision actions or events into an HTML fragment with nice buttons in it.

It can also look like Sign On or Send a Comment button without a work item action. In this case, it just creates a Note on Business Object.

Buttons template is fully configurable.

There can be any number of buttons in the template, and this method can be used with any custom template.

It can look like this in the email body:

Or like this:

These default buttons templates are provided as part of the product.

4303 :: ACCEPT (CONVERT) P-PERSON; S-POSITION; US-USER AND INT-EMAIL AS A POSSIBLE DECISION EMAIL RECIPIENT

API email sending method accepts a person, a position, a user name, a single email or an email list as email recipients.

You can use all those options in any combination, all of them will be handled and used as overall recipients list for email delivering.

4306 :: GENERATE AND STORE DECISION UUID, WORK ITEM, ACTION/EVENT AND DESCRIPTION IN SAP

As decision actions are converted into buttons, unique decision identifications are generated for proper work items, decision actions/events and action texts and are stored in the system.

It ensures that each created action email carries unique decision identifications and they can only be performed in proper work items.

4307 :: UNIFIED INBOUND EMAIL PROCESSOR. CREATE GOS COMMENT

Creates a business object comment provided by the business user with a decision action.

When the business user clicks a decision button in the email, they can enter some comment about the decision taken. That comment will be attached to the business object on which the action is performed.

Comments creation is a configurable option.

4308 :: UNIFIED PROCESSOR FOR INBOUND EMAIL. CAPTURE WORK ITEM DECISION

There are SAP standard decision work item types supported by solutions:

  • Decision tasks (with decision keys)
  • Event-driven tasks (that are completed with event generation following the user’s decision)

This version of Skybuffer Simple Communication add-on enables to distinguish the type of the workflow task and the process received by the email business user decision in a fully automated way.

4309 :: UNIFIED PROCESSOR FOR INBOUND EMAIL. SEND FEEDBACK ON DECISION PROCESSING TO BUSINESS USER

Sends feedback on decision processing to the business user.

When a decision action is performed, the feedback email is sent to the business user. If action processing is successful, an “accepted” email is sent to the user. It contains the business user’s name and the business object type description and number.

If processing fails, a “declined” email is sent. It also contains some text or an error table describing the reason for declining.

The templates for “Accepted” and “Declined” messages are fully configurable.

A template with a notification of the accepted decision looks as shown below:

The next one is for the case when SAP declines decision email from the business user:

Default “accepted” and “declined” email templates are provided as part of the product.

4310, 4314 :: ALL OPTIONS ARE CONFIGURABLE VIA SAP CUSTOMIZING IMPLEMENTATION GUIDE (SPRO)

All options can be configured via IMG node action:

Moreover, each template can be customized or created via Standard Text (SO10 t-code).

4311 :: SAMPLE WORK ITEM EXIT CLASS IMPLEMENTATION

Shows How to Use the Add-On.

It can be inherited into a custom class. It needs just one method to be redefined and customized to suit a specific business case.

For a test case, you can inherit a sample class and only change the workflow task numbers and the inbound processing email address. It works with both event-based and decision-based work items and sends an email to the workflow initiator asking to make their decision, that is, to approve or to reject. It uses default email template.

An action email can look like this:

Sample class and default email template are provided as part of the product.

4349 :: INBOUND ACTIONS PROCESSING IN CASE THERE IS NO WORK ITEM (UUID TABLE EXTENSION TO BUS AND BUS-KEY VALUES)

A new option is available:  to process actions in incoming emails, no assignment to Work Item is necessary (BUS and BUS-KEY can be used)

4378 :: UPDATE VERSION OF HTML TEMPLATES FOR APPROVAL EMAIL, ACCEPTED DECISION, REJECTED DECISION

HTML templates are updated: usability is optimized, flexibility is increased

4379 :: UNIFIED INBOUND EMAIL PROCESSOR. RESTART INBOUND EMAIL PROCESSING (TROUBLESHOOTING ABAP REPORT)

Restarts inbound processing for a selected email.

You can use /SKYBFR/SOIN_RESTART report to restart inbound processing of any email. You should only get Send Request ID (GUID) in SOIN t-code and use it in that report.

Paste email GIUD into the report and re-process inbound email from the business user.

/SKYBFR/SOIN_RESTART report is provided as part of the product.

4404 :: FILL IN AN ELEMENT OF WORK FLOW (HEADER LEVEL) CONTAINER WITH CUSTOMIZED VALUE THAT WORK ITEM IS COMPLETED VIA EMAIL

It can be useful to have some value in the workflow or the work item container that indicates completion via email but not via SAP GUI.

Skybuffer Simple Communication add-on is able to add that value into the workflow or the work item container. You can set the element name to store that value, value itself (‘X’ is default) and a level to store (work item, default, or workflow).

This option is fully configurable.

4405 :: EMAIL RECOGNITION ORDER SPRO PARAMETER FOR THE WORKFLOW AGENT

To cover different ways of email address actualization for users that are involved in communication and decision making using YCA functionality, as well as the way of how HR related object for inbound emails is allocated, Email Recognition Order can be set in SPRO:

US – email address from Communication section if SAP USER ID (SU03 transaction)

P – Subtype 0010 of 105 Infotype of HR Master Data (PA30 t-code).

Possible values:

US, P, US P, P US.

4407 :: UNLIMITED NUMBER OF ACTION BUTTONS IN ONE BUTTONS BLOCK. NEW TEMPLATE

The area for buttons in the email template may now include an unlimited number of buttons.

This option is fully configurable.

4411 :: TRANSFER DECISION TEXT FROM INBOUND EMAIL BODY INTO THE WORK FLOW OR WORK ITEM CONTAINER ELEMENT

It can be useful to have a decision comment in the workflow or the work item container that could show the user’s notes provided together with the decision.

Skybuffer Simple Communication add-on is able to add those notes directly as they go from the action email into the workflow or the work item container. You can set the element name to store those notes and a level to store (work item, it’s default, or workflow).

This option is fully configurable.

4423 :: SPRO CONTROL PARAMETER TO RESTRICT UUID USAGE TO LIMITED NUMBER OF TIMES

A limit to the number of attempts to use UUID for Inbound Emails Processing can be set in SPRO:

4427 :: PROVIDE BUSINESS USERS WITH CONTROL TO SWITCH OFF FEEDBACK EMAIL FROM SAP

User parameters can be set individually for each staff member to determine the character of the feedback email notification sent:

4389 :: WORKFLOW API :: BUSINESS ADD-IN (BADI) TO CONTROL INBOUND EMAILS TEXT CAPTURING IN SAP

When the Inbound Email text is extracted from the email body, it becomes possible to capture the text by implemented BADI with BUS Filtering and insert it into the custom specific place in SAP

In other words, a customer has a possibility to grab the email text and put it in any place  for their own purpose.

4433 :: WORKFLOW API :: CALL ‘SGOS_NOTE_CREATE’ ONLY WHEN WI STATUS IS UPDATED SUCCESSFULLY

The text from the email body is saved as GOS-object note in SAP only after the decision is accepted by the inbound email processor and the work item status is updated successfully. If the decision is declined by YCA1, the email message is not saved as GOS-object note.

4450, 4650 :: WORKFLOW API :: OUTSTANDING WORK ITEMS REMINDER REPORT INCLUDING SAP IMPLEMENTATION GUIDE CONFIGURATION (WITH AND WITHOUT DECISION BUTTONS) :: ADJUSTMENT FOR ESCALATION PROCESS

The Reminder feature allows the customer to automatically send notification emails to current approvers in case of the action delay. A notification email contains all the necessary for the action objects in the accordion view with a possibility to take action for each object. It is important flexibility-wise for the approver to have one place (one email) to make actions for all work items.

Another important functionality is to send a reminder message with escalation according to the specific rule of determining an appropriate escalation person. All the hierarchy of the escalation can be involved in the reminder process.

Reminder and Escalation periods are defined separately in order to achieve maximum flexibility.

Reminder can be configured via IMG-activity (SPRO t-code):

The Reminder feature is also considered a substitute feature, so the importing parameter ZAGENTS_ELEMENT is envisaged as a Reminder parameter.

This option is fully configurable.

4452 :: WORKFLOW API :: CHECK COMMENT CONTENT BEFORE INSERTING GOS ATTACHMENT

If a comment contains only empty lines, YCA1 Simple Communication add-on will check it and will not insert such comment as GOS Object note.

4459 :: WORKFLOW API :: SUPPORT ALL EVENT TYPES IN EVENT_RAISED METHOD OF SAMPLE EXIT CLASS WITH SEPARATE METHODS FOR EACH OF THEM

YCA1 Simple Communication add-on contains a sample for Workflow Exit Class. The method EVENT_RAISED supports all the possible EVENTS for Work Item SAP Workflow. The main purpose is to collect all the possible events in the exit class to provide the Customer with full technical information about Work Items events and  make it possible to use any of them in  a business task.

As a test case, please, open code and check: /SKYBFR/CL_YCA1_WF_EXIT -> if_swf_ifs_workitem_exit~event_raised

4460 :: WORKFLOW API :: CONSIDER SAP WORKFLOW SUBSTITUTES (ADDITIONAL AGENTS) WHEN SENDING DECISION EMAILS (OUTBOUND WORKFLOW OR TRANSNATIONAL OBJECTS EMAILS)

YCA1 Simple Communication add-on supports Substitute as part of the Workflow API. This Workflow API is consumed by another part of the YCA1.

This option is fully configurable.

There are 3 options:

  1. If there isn’t a row for Workflow, Substitute is deactivated;
  2. Row with selected OnlySubst: Substitute is involved in the process instead of being replaced. As a result, Substitute only will be an Actor.
  3. Row with unselected OnlySubst: Substitute is involved in the process together with Substitutable. As a result, both Substitute and Substitutable will be Actors.

4737 :: WORKFLOW API :: BADI AND SAMPLE CLASS IMPLEMENTATION TO PROCESS BUS-OBJECT RELATED EMAILS WITH ATTACHMENTS

BADI point is available to implement the custom logic for incoming email processing, email subject/body/attachments can be used according to the business requirements.

Out-of-the-box sample is provided as part of the product.

4758 :: WORKFLOW API :: BADI SAMPLE TO PROCESS BUS-OBJECT RELATED EMAILS (OUT-OF-THE-BOX)

This functionality allows processing incoming emails according to the custom settings (out-of-the-Box solution).

Customization is processed via IMG node BADI: Subject to BUS Object Conversion Configuration:

For each key word (which should be recognized in the subject of the email) an object type should be set; additionally, a security strategy can be set.

For each object type, settings can be set differently, any combination of parameters:

  1. Add body of incoming email in form of comment (Note, Remark)
  2. Add body of incoming email as attached file
  3. Add attachments of incoming email as attached files

4761 :: WORKFLOW API :: ATTACHMENTS AND EMAIL TEXT TO GOS-OBJECTS FROM INBOUND EMAILS ACCORDING TO SECURITY STRATEGY

This functionality allows collecting all the related information, which comes via email from various sources (vendors, customers, other participants involved in the business process) in accordance with the existing concept and security strategy.

Customization can be processed via IMG Node.

Custom Security Strategy can be applied (Security Strategy Samples are provided).

Out-of-the-box security strategy samples are provided as part of the product.

4765 :: NEW REPORT TO CHANGE VALUES IN TABLE /SKYBFR/YCA1D_UA

To provide technical availability for entries correction in the table ‘UUID Tags for Work Item Action Email Buttons’ (/SKYBFR/YCA1D_UA), new report is offered.

This report can be used in such emergency cases when values from custom Workflow are incorrectly added into the table ‘UUID Tags for Work Item Action Email Buttons’ (/SKYBFR/YCA1D_UA) and there is no available option for Workflow to restart after the inconsistencies are detected and corrected.

4789 :: WORKFLOW ERRORS NOTIFICATION REPORT (FOR BACKGROUND SCHEDULING)

The add-on solution covers processing of the crashed work items. It makes it possible to define the required workflow ID, the task ID and the required work item status for which notification should be triggered. It allows the IT department to be timely informed and to undertake repairing actions.

4813 :: OPERATIONAL OBJECTS VIA EMAIL :: ADD SUPPORT OF ALPHA-NUMERIC ABAP BUSINESS OBJECTS

An incoming email subject can now be analyzed to find BUS-object type and number according to the key word and the number of the document (for instance email with “PO 12345678” text in subject can be processed as related to an appropriate BUS-object)

4829 :: DECISION WORKFLOW EMAILS :: CONFIGURABLE SECURITY STRATEGY FOR INCOMING DECISION EMAILS SENDER CHECK (MATCH TO WORK ITEM AGENTS, MATCH TO SO10 WHITELIST OF EMAILS/DOMAINS, ALL EMAILS ARE ACCEPTABLE AND ETC.)

Processing of incoming decision workflow emails can be configured according to the business requirements.

Customization can be processed via IMG Node:

Parameters given below can be set individually for each object type/workflow/task:

  1. Add body of incoming email in form of comment (Note, Remark)
  2. Add body of incoming email as attached file
  3. Add attachments of incoming email as attached files

Incoming emails Security Strategy can be adjusted individually for each object type/workflow/task.

Out-of-the-box security strategy samples are provided as part of the product.

4859 ::  YCA1 AND WORKFLOW LOG INTERFACE FOR SLG1

Application log /SKYBFR/OBJ_WF_LOG can be implemented for each Workflow in Exit Class.

In this case all the messages in workflow can be recorded. Log can be filtered by Business object and External ID which is equal to document number.

In case of errors, message history can be reviewed for proper and fast reason finding (info/warning/error messages are recorded):

Out-of-the-box samples of application log implementation are provided as part of the product.

4982 :: SUPPORT CUSTOM CLASSES IN /SKYBFR/YCA1_WF_SOIN_RESTART

New functionality is available for feature 4379 :: Unified Inbound Email Processor. Restart Inbound Email Processing (Troubleshooting ABAP Report).

Now you can choose a class for inbound processing restarting.

4217 :: Integration with /SKYBFR/YCA1 ERP (ELECTRONIC COMMUNICATION FRAMEWORK ERP)

User story

Management wants to approve trip reports before posting to finance and reimbursement. Integration with Simple Communication from Skybuffer is the best way to cover requirements.

Implementation

EXIT class for SAP Workflow, Inbound class and e-mail template with decision buttons are part of the solution.

DEVELOPMENT FRAMEWORK FEATURE LIST OF /SKYBFR/YCA1 APPLICATION

SAP Core of YCA1 Simple Communication Add-on is designed to provide emailing framework.

The solution offers a convenient API set to

  • Process incoming emails;
  • Create and send outgoing emails;
  • Create emails in HTML templates allowing their correct displaying in different email clients (MS Outlook, Gmail, Lotus Notes, etc.)
  • Make advantage of the embedded mechanisms and create headings, text passages, name-value lists, tables with any data format;
  • Support user templates mechanisms for all the elements listed above;
  • Use a functionality to fill in any user templates;
  • Allow reading templates from standard SO10 texts;
  • Effect multilingual support based on user settings including multilingual templates usage;
  • Make advantage of the embedded protection against IP spoofing (using the MIME information in the incoming email);
  • Identify the sender, mail body and all attachments by a single method-calling;
  • Send an email both to one recipient and to a number of recipients, as well as mails with attached files;
  • Make use of all the above-listed advantages allowing significant speeding-up of SAP add-ons development as well the development of utilities to create, send out and process the incoming emails.

4298 :: CONVERT SAP TABLE/STRUCTURE TO HTML

Converts an input table into an HTML fragment.

It can handle any structure of that table, it uses data element descriptions as column headers and puts in columns all the data contained in the table.

You can use it to provide some tabular data to the business user.

It can look like this in the email body:

Configurable style option will be delivered in the next product version.

All such options as header, string value, parameter set, and table can be used together in any combination to create a solid nice email body segment in just a single API call.

4299 :: CONVERT SINGLE VARIABLE VALUE INTO HTML

Converts a single string into an HTML fragment that can be used as a part of the email body content.

It can be formatted as a header or as a regular text.

You can use it to create email segments headers and content texts like user instructions, comments, descriptions and so on.

It can look like this in the email body:

Configurable style option will be delivered in the next product version.

4300 :: CONVERT A SET OF PARAMETER-VALUE PAIRS INTO HTML

Converts a name-value pair list into an HTML fragment.

It builds a list of provided parameter names and their values.

You can use it to provide some structured information to business user.

It can look like this in the email body:

Configurable style option will be delivered in the next product version.

4301 :: INJECT HTML CODE INTO SO10 EMAIL TEMPLATE USING HTML COMMENTS AS PLACE HOLDERS

This provided API method injects any HTML or string fragment into a template.

For example, an HTML template can be stored as SO10 texts and then the content can be just injected into that template into an appropriate place.

Templates with masks can look like this:

Default email template is provided as part of the product.

4304 :: CAPTURE /SKYBFR/YCA1 ADD-ON VERSION IN THE ADD-ON PACKAGE

Add-On version is captured in the /SKYBFR/YCA1 package, so you can check the installed version, ID, the name and its description anytime.

4305 :: LICENSING DEPENDING ON INSTALLATION NUMBER, SOLUTION ID AND EXPIRY DATE

The product is licensed per each SAP system (installation number) and has a limited performance period until the subscription expiry date.

4428 :: CORE :: ENHANCE SECURITY FOR INBOUND EMAILS BASED ON EMAIL MIME ANALYSIS

See Feature 4560.

4429 :: CORE :: CUSTOMIZABLE TEMPLATES FOR CONVERT_VALUES_TO_HTML

To make the feature flexible, various approaches are supported:

  1. Compile email content using Sections approach;
  2. Compile email content using logical parts approach:
  • header,
  • string,
  • name-value pairs,
  • table,
  • table row,
  • table header,
  • table cell.

YCA add-on provides a set of the templates out-of-the-box as the best practice sample.

4457 :: CORE :: INBOUND ATTACHMENTS SUPPORT

YCA1 Simple Communication add-on supports attachments for inbound e-mails.

A customer can attach files in a reply email with action buttons. Attachments in this case will be saved as GOS object attachments.

Besides, the whole email body can be saved as GOS object attachment.

This option is fully configurable.

4560 :: COMPARE SENDER EMAIL (MAIL FROM) AND FROM EMAIL BASED ON EMAIL TRACE (IF IT IS ACTIVATED IN SAP NW) AND GET FROM EMAIL AS THE MAIN ONE IN CASE MAIL FROM AND FROM ARE DIFFERENT

To avoid any forgery of the original decision email, the sender is determined by Email Trace of the SAP NetWeaver. A prerequisite for the feature is to activate Email Trace in SAP NetWeaver.

4703 :: ARCHIVING MECHANISM FOR TABLE OF BUTTONS UUID /SKYBFR/YCA1D_UA

For entries in the table for UUID Tags for work item action email buttons, timestamp is available, so archiving may be set according to the retention time specific for a particular client. For links with work items, its status can be used as a criterion for archiving.