E-Mail

abap2UI5 has no e-mail control of its own — sending mail is plain ABAP via cl_bcs_message (or cl_bcs on older releases). The UI part is a normal event handler that gathers the form fields and calls the BCS API.

Plain Text Mail

CLASS z2ui5_cl_sample_email DEFINITION PUBLIC.

  PUBLIC SECTION.
    INTERFACES z2ui5_if_app.
    DATA mv_to      TYPE string.
    DATA mv_subject TYPE string.
    DATA mv_body    TYPE string.

ENDCLASS.

CLASS z2ui5_cl_sample_email IMPLEMENTATION.
  METHOD z2ui5_if_app~main.

    CASE abap_true.

      WHEN client->check_on_init( ).
        client->view_display( z2ui5_cl_xml_view=>factory(
            )->page( `Send E-Mail`
                )->simple_form( editable = abap_true
                    )->content( `form`
                        )->label( `To`      )->input( client->_bind_edit( mv_to )
                        )->label( `Subject` )->input( client->_bind_edit( mv_subject )
                        )->label( `Body`    )->text_area( client->_bind_edit( mv_body )
                        )->button(
                            text  = `send`
                            press = client->_event( `SEND` )
            )->stringify( ) ).

      WHEN client->check_on_event( `SEND` ).
        TRY.
            DATA(lo_mail) = cl_bcs_message=>create_persistent( ).
            lo_mail->set_subject( CONV #( mv_subject ) ).
            lo_mail->set_main( cl_bcs_convert=>string_to_soli( mv_body ) ).
            lo_mail->add_recipient( i_address = CONV #( mv_to ) i_address_type = `INT` ).
            lo_mail->send( i_with_error_screen = abap_false ).
            COMMIT WORK.
            client->message_toast_display( `mail queued` ).
          CATCH cx_root INTO DATA(lx).
            client->message_box_display( lx->get_text( ) ).
        ENDTRY.

    ENDCASE.

  ENDMETHOD.
ENDCLASS.

Attachment

Reuse the file upload flow to capture an attachment as base64, then hand it to cl_bcs_message:

DATA(lv_xstring) = cl_web_http_utility=>decode_x_base64( mv_attachment_base64 ).
lo_mail->add_attachment(
    iv_attachment_type    = `PDF`
    iv_attachment_subject = mv_attachment_name
    iv_attachment_size    = CONV #( xstrlen( lv_xstring ) )
    i_attachment_content_hex = cl_bcs_convert=>xstring_to_solix( lv_xstring ) ).

TIP

SAPconnect (SCOT) must be configured for the mail to actually leave the system. If you do not see anything in SOST, that is where to look first.

Compatibility

cl_bcs_message is the modern API. On older releases or in ABAP Cloud check what is released for your platform — the structure of the example stays the same, only the API class changes.