Scpope

In diesem Foliensatz geht es ausschließlich um die Standard Features des Managed Szenarios. Die folgenden Aspekte sollen gelernt werden:

• Validierungen
• Ableitungen
• Actions
• Nummernvergabe
• Draft Verarbeitung
• Dynamische Features

Aktionen

Es können eigenen Aktionen hinzugefügt werden. Dazu muss man alle Objekte anpassen

• Behavior - Aktion definieren
• Implementierung - Aktion ausprogrammieren
• CDS - Aktion auf der Oberfläche sichtbar machen

Arten von Aktionen

Unterscheidung zwischen

• Aktionen - Ändern die Daten
• Factory Aktionen erzeugen Instanzen
• Funktionen - nur lesender Zugriff auf die Daten

Maximal eine Struktur als Importing Parameter und als Returning Parameter. Es können auch Objekte übergeben werden.

Aktion Stornieren - Behavior

Die Aktion CANCEL ist ohne Parameter und Rückgabe. Also einfach hinschreiben: action cancel;

projection implementation in class zbp_c_tasks unique;
strict ( 2 );

define behavior for zc_tasks //alias <alias_name>
{
  use create;
  use update;
  use delete;

  use action copy;
  use action close;
  action cancel ;

  field ( readonly ) Author,
                     ChangedAt,
                     CreatedAt;

Aktion Stornieren - Implementierung

CLASS lhc_zc_tasks IMPLEMENTATION.

  METHOD cancel.
    MODIFY ENTITIES OF zc_tasks IN LOCAL MODE
      ENTITY zc_tasks
     UPDATE FIELDS ( status )
     WITH VALUE #( FOR key IN keys ( %tky = key-%tky
                                     status = 'CANCELED' ) ).


  ENDMETHOD.

ENDCLASS.

Validations

  validation validateProjectManager on save { create; 
                                              update; 
                                              field ProjectManager ;}

  METHOD validateassignee.

    SELECT DISTINCT status
      FROM zbc_status_text
      INTO TABLE @DATA(status_texts).

    READ ENTITIES OF zi_jb5_tasks IN LOCAL MODE
      ENTITY zi_jb5_tasks
        FIELDS ( assignee ) "the field to validate
        WITH CORRESPONDING #( keys )
      RESULT DATA(tasks).


    LOOP AT tasks INTO DATA(task) .
      IF NOT line_exists( status_texts[ status = task-status ] ).


        APPEND VALUE #( %tky = task-%tky ) TO failed-zi_jb5_tasks.

        APPEND VALUE #( %tky = task-%tky
                        %msg = NEW zbc_rap_message( 
                           msgv1 = |Status "{ task-status }" invalid|
                           textid = zbc_rap_message=>validation_failed
                           severity = if_abap_behv_message=>severity-error )
                        %element-status = if_abap_behv=>mk-on
                      ) TO reported-zi_jb5_tasks.


      ENDIF.
    ENDLOOP.
  ENDMETHOD.

Aufbau von Messages

Video zu Messages
new_message_with_text

APPEND VALUE #(  %tky = key-%tky ) TO failed-travel.
      APPEND VALUE #(  %tky                 = key-%tky
                       %state_area          = 'sampleValidation'
                        %msg              = new_message_with_text( 
                              text     = 'ein Text'
                              severity  = if_abap_behv_message=>severity-error )
                       %element-sample_field  = if_abap_behv=>mk-on ) TO reported-travel.
  ENDMETHOD.

new_message

APPEND VALUE #(  %tky = key-%tky ) TO failed-travel.
      APPEND VALUE #(  %tky                 = key-%tky
                       %state_area          = 'sampleValidation'
                        %msg              = new_message( 
														id = 'bla'
														number = '123'
														v1 = |Der Wert { <bla>-blub } ist falsch|
														severity = if_abap_behv_message=>severity-error
                                                    )
                       %element-sample_field  = if_abap_behv=>mk-on ) TO reported-travel.
  ENDMETHOD.

Feature Control

Alle Eigenschaften in der Behavior Definition können dynamisch gesteuert werden. Beispielsweise die Verfügbarkeit von Aktionen.

Definition im Behavior

Dazu muss zunächst in der Behavior die Aktion als Kontrolliert gekennzeichnet werden:

action (features: instance) cancel result [1] $self;

Implementierung mit ABAP

Und dann erfolgt die Entscheidung, ob das Feature angezeigt wird oder nicht in der Implementierung des Behavior Handlers im ABAP.

METHOD get_features. 


ENDMETHOD. 

Virtual Elements - Im ABAP ermittelte Felder

Read-Only Felder, die im ABAP per Klasse gefüllt werden.

Im CDS View

@ObjectModel.virtualElement: true
@ObjectModel.virtualElementCalculatedBy: 'ABAP:ZCL_BC_VIRTUAL_ELE'
'' as VirtualFieldName,

In der ABAP Klasse

ZCL_BC_VIRTUAL_ELE

INTERFACES: if_sadl_exit_calc_element_read.

Optional: Methode GET_CALCULATION_INFO vor dem SELECT

Falls für Berechnungen andere Felder benötigt werden, kann man in GET_CALCULATION_INFO die Liste der Felder zurückgegeben. Diese werden dann aus der DB-Tabelle selektiert.

Nummernvergabe - Übersicht

Optionen für die Nummernvergabe

• Manuelle Nummernvergabe über die Dateneingabe. Validierung beim Speichern auf Schlüsselfelder.
• Automatische Nummernvergabe mit UUIDs - keine Implementierung notwendig
• Selbst programmierte Nummernvergabe:
  • EARLY NUMBERING - Vor der Darstellung des neuen Datensatzes auf der Oberfläche
  • LATE NUMBERING - Späte Nummernvergabe kurz vor dem Speichern des Datensatzes

Programmierte Nummernvergabe

Frühe Nummernvergabe

• Im Kopf der Verhaltensdefinition: early numbering
• Implementierung der Methode FOR_NUMBERING der Handlerklasse

Späte Nummernvergabe - Behavior Definition

• late numbering einstellen
• Feld Projekt ist Pflichtfeld für die Anlage
• Feld TaskKey ist gegen Eingab gesperrt

managed implementation in class zbp_i_tasks unique;
strict ( 2 );

define behavior for zi_tasks 
late numbering                           //<===
persistent table zbc_tasks
lock master
authorization master ( instance )
{
  create;
  update;
  delete;
  association _Comments { create; }
  field ( readonly ) TaskKey;            //<===
  field ( mandatory : create ) Project;  //<===
  field ( mandatory ) Summary;
  mapping for zbc_tasks