Ansicht
Dokumentation

EPM_KPI_DEFINITION_GET - Lesen Kennzahl aus Kennzahlenkatalog

CL_GUI_FRONTEND_SERVICES - Frontend Services   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Funktionsbaustein EPM_KPI_DEFINITION_GET dient dazu, den Eintrag einer bestimmten Kennzahl aus dem Kennzahlenkatalog zu lesen. Er wird vorallem benötigt, um die benutzerspezifischen Schrankenwerte der Kennzahl sowie benutzerspezifische Texte, zu ermitteln. Diese Daten werden aus dem Zielsystem der Kennzahl gelesen.

Das Quellsystem, in dem der Kennzahlenwert ermittelt wird, kann einSAP ERP-System, SAP R/3-System, ein Business Warehouse oder eine externes System sein.

Das Zielsystem ist das System, in dem die Kennzahlentabelle gehalten wird. Im Kennzahlenmonitor (Rolle Betriebsleiter im Portal) wird dann der Kennzahlenwert angezeigt.

Der Funktionsbaustein wird im Quellsystem in dem Programmcoding implementiert, das die Ermittlung des Kennzahlenwertes durchführt. Sein Aufruf erfolgt per Remote Function Call . Das Zielsystem (DESTINATION) für den Aufruf des Funktionsbausteins muss aus der Customizingtabelle EPM_TARGET_SYS ermittelt werden.

Der Funktionsbaustein sollte folgendermaßen aufgerufen werden:

Ist die Kennzahl bekannt, so kann der Importparameter I_KPI_ID direkt mitgegeben werden.

Wird der Funktionsbaustein aus einem R/3-Report aufgerufen, so sollten die Importparameter I_EPM_PROGRAM, I_EPM_VARIANT, I_KPI_SOURCE_TYPE und I_KPI_SOURCE mitgegeben werden.

Wird der Funktionsbaustein aus einem BW-Analyseprozess aufgerufen, so sollten die Importparameter I_BW_AN_PROCESS, I_KPI_SOURCE_TYPE und I_KPI_SOURCE mitgegeben werden.

Beispiele

Aufruf des Funktionsbausteins aus R/3 Report:

...

SELECT target_system FROM epm_target_sys INTO lv_target_sys.

ENDSELECT.

SELECT source_system FROM epm_source_sys INTO lv_source_sys.

ENDSELECT.

CALL FUNCTION 'EPM_KPI_DEFINITION_GET' DESTINATION lv_target_sys

  EXPORTING

*   I_KPI_ID                       =

    I_EPM_PROGRAM                  = 'Z_REPORT_SOLL_IST_LEISTUNG'

    I_EPM_VARIANT                  = 'Z_WERK0001'

*   I_BW_AN_PROCESS                =

    I_KPI_SOURCE_TYPE              = 'R3'

    I_KPI_SOURCE                   = lv_source_sys

    I_LANGU                        = sy-langu

    I_UNAME                        = 'USERID'

  IMPORTING

    ES_KPI                         = lt_kpi

  EXCEPTIONS

    NO_KPI_FOUND                   = 1

    MISSING_IMPORT_PARAMETER       = 2

    NO_AUTHORITY_FOR_INSERT        = 3

    OTHERS                         = 4

          .

IF SY-SUBRC <> 0.

  MESSAGE ID SY-MSGID TYPE SY-MSGTY NUMBER SY-MSGNO

          WITH SY-MSGV1 SY-MSGV2 SY-MSGV3 SY-MSGV4.

ENDIF.

Aufruf des Funktionsbausteins aus BW Analyseprozess:

...

SELECT target_system FROM epm_targetsystem INTO lv_target_sys.

ENDSELECT.

SELECT source_system FROM epm_sourcesystem INTO lv_source_sys.

ENDSELECT.

CALL FUNCTION 'EPM_KPI_DEFINITION_GET' DESTINATION lv_target_sys

  EXPORTING

*   I_KPI_ID                       =

*   I_EPM_PROGRAM                  =

*   I_EPM_VARIANT                  =

    I_BW_AN_PROCESS                = 'Z_BW_SOLL_IST'

    I_KPI_SOURCE_TYPE              = 'BW'

    I_KPI_SOURCE                   = lv_source_sys

    I_LANGU                        = sy-langu

    I_UNAME                        = 'USERID'

  IMPORTING

    ES_KPI                         = lt_kpi

  EXCEPTIONS

    NO_KPI_FOUND                   = 1

    MISSING_IMPORT_PARAMETER       = 2

    NO_AUTHORITY_FOR_INSERT        = 3

    OTHERS                         = 4

          .

IF SY-SUBRC <> 0.

  MESSAGE ID SY-MSGID TYPE SY-MSGTY NUMBER SY-MSGNO

          WITH SY-MSGV1 SY-MSGV2 SY-MSGV3 SY-MSGV4.

ENDIF.

Aufruf des Funktionsbausteins aus externem System:

...

CALL FUNCTION 'EPM_KPI_DEFINITION_GET' DESTINATION 'TARGETSYS'

  EXPORTING

    I_KPI_ID                       = 'KPI_SOLL_IST'

*   I_EPM_PROGRAM                  =

*   I_EPM_VARIANT                  =

*   I_BW_AN_PROCESS                =

    I_KPI_SOURCE_TYPE              = 'EXT'

    I_KPI_SOURCE                   = 'SOURCESYS'

    I_LANGU                        = sy-langu

    I_UNAME                        = 'USERID'

  IMPORTING

    ES_KPI                         = lt_kpi

  EXCEPTIONS

    NO_KPI_FOUND                   = 1

    MISSING_IMPORT_PARAMETER       = 2

    NO_AUTHORITY_FOR_INSERT        = 3

    OTHERS                         = 4

          .

IF SY-SUBRC <> 0.

  MESSAGE ID SY-MSGID TYPE SY-MSGTY NUMBER SY-MSGNO

          WITH SY-MSGV1 SY-MSGV2 SY-MSGV3 SY-MSGV4.

ENDIF.

Parameter

ES_KPI
I_BW_AN_PROCESS
I_EPM_PROGRAM
I_EPM_VARIANT
I_KPI_ID
I_KPI_SOURCE
I_KPI_SOURCE_TYPE
I_LANGU
I_UNAME

Ausnahmen

MISSING_IMPORT_PARAMETER
NO_KPI_FOUND

Funktionsgruppe

EPM_KPI

Addresses (Business Address Services)   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 11873 Date: 20240523 Time: 131018     sap01-206 ( 74 ms )