Kontakt

Ansicht
Dokumentation

C1F0_PHRASES_CREATE - EHS: Anlegen von Phrasen

C1F0_PHRASES_CREATE - EHS: Anlegen von Phrasen

CPI1466 during Backup   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Dieser Funktionsbaustein ist Teil der Application Programming Interfaces (APIs) im EH&S für Phrasen. Er dient dem Anlegen von Phrasendaten.

Welche Struktur besitzt die Tabelle mit den Phrasendaten?

X_API_PHR_TAB
   |
   |-- HEAD                    Kopfdaten
   |-- TEXT_TAB
   |       |
   |       |-- HEAD            Positionsdaten
   |       |-- LONGTEXT        Langtext eines Phrasentextes
   |-- REF_TAB                 Referenzdaten
   |-- JOIN_TAB                Daten zur Auswahlmengenzuordnung

Welche Phrase wird angelegt?

Zu welchen Phrasen Daten angelegt werden sollen, wird durch den Eintrag in der Tabelle X_API_PHR_TAB angegeben. Sofern Daten zu einer existierenden Phrase angelegt werden, muß die Phrase durch Angabe ihrer Satznummer (RECN) bestimmt sein. Ist die Satznummer nicht belegt, wird der Phrasenkopf angelegt.

Welche Daten werden zu dem Phrasen angelegt?

Welche Phrasendaten angelegt werden sollen, wird durch die einzelnen Kennzeichen I_FLG_xxx festgelegt. Entsprechend müssen die Daten in der Tabelle X_API_PHR_TAB vorhanden sein.

I_FLG_HEADER X_API_PHR_TAB-HEAD
I_FLG_TEXT X_API_PHR_TAB-TEXT_TAB-HEAD
I_FLG_TEXT_LONGTEXT X_API_PHR_TAB-TEXT_TAB-LONGTEXT
I_FLG_REF X_API_PHR_TAB-REF_TAB
I_FLG_JOIN X_API_PHR_TAB-JOIN_TAB

Ist ein Kennzeichen auf TRUE gesetzt, werden die entsprechenden Daten in der Datenbank angelegt. Die Satznummer eines Datensatzes darf dabei jedoch nicht bereits vorhanden sein. Ist sie bereits vorhanden, wird dieser Satz nicht angelegt.

Wie werden Fehler gemeldet?

Folgende drei Kennzeichen liefern die Information, ob generell Probleme in der Verarbeitung der Daten auftraten:

  • E_FLG_LOCKFAIL
Es ist ein Sperrfehler aufgetreten.
  • E_FLG_WARNING
Es ist eine Warnung aufgetreten.
  • E_FLG_ERROR
Es ist ein Fehler aufgetreten.

Jede Struktur oder Tabelle innerhalb der Tabelle der Phrasendaten besitzt zusätzlich die Felder ERRORMODE, ERRORINFO, ERRORCLASS und ERRORPARAM:

  • ERRORMODE
Dieses Feld enthält die Information, ob der Datensatz in der Verarbeitung einen Fehler oder eine Warnung verursacht hat. Folgende Konstanten sind dazu in der Typgruppe ESPAP definiert:
  • ESPAP_ERRORMODE-NONE ,,kein Fehler aufgetreten

  • ESPAP_ERRORMODE-WARNING ,,Warnung aufgetreten

  • ESPAP_ERRORMODE-ERROR ,,Fehler aufgetreten

  • ERRORINFO
Dieses Feld enthält im Falle eines Fehlers oder einer Warnung eine Zahl, die als Konstante in der Typgruppe ESPPH definiert ist. Diese Zahl unterliegt folgenden Regeln:
  • Zahl < 1000

Die Zahl repräsentiert eine Nachrichtennummer zu einer Nachricht ohne Parameter.
  • 1000 <= Zahl < 2000

Die Zahl minus 1000 repräsentiert eine Nachrichtennummer zu einer Nachricht mit Parametern.
  • Zahl >= 2000

Fehlernummer ohne Bezug zu einer Nachricht.
Die Fehlerbehandlung sollte immer mit den definierten Konstanten aus der Typgruppe ESPPH durchgeführt werden. Damit ist man von der Fehlernummer unabhängig.
Beispiel von Fehlerkonstanten:
  • ESPPH_ERROR-AUTHORITY-NUMBER ,,Berechtigungsfehler

  • ESPPH_ERROR-DUPLICATE_REC-NUMBER ,,Satz existiert bereits

  • ESPPH_WARNING-HEADER_DELETED-NUMBER ,,Kopf ist logisch gelöscht

  • ERRORCLASS
Sofern die Fehlernummer eine Nachricht repräsentiert, wird die Nachrichtenklasse in diesem Feld angegeben. Mit der Fehlernummer ist die Nachrichtenklasse als Konstante in der Typgruppe ESPPH definiert.
  • ERRORPARAM
Dieser Parameter ermöglicht dem API, eine fehlerbezogene Information an den Aufrufer zurückzugeben. Diese Information kann dann z.B. als Parameter einer Nachricht gesetzt werden.

Hinweise

  • Damit beim Anlegen von Phrasendaten (dies können auch mehrere Phrasen sein) nur eine Sperre je Phrasenkatalog abgesetzt wird, muß das Kennzeichen I_FLG_LOCK_CATALOG auf TRUE gesetzt werden. D.h., der Phrasenkatalog wird exklusiv gesperrt.
  • Der Aufrufer des APIs muß die Typgruppe ESPPH eingebunden haben. Dadurch stehen dem Aufrufer die Tabellentypen, Strukturtypen sowie die Konstanten zur Fehlerbehandlung zur Verfügung.

Weiterführende Informationen

  • Typgruppe ESPAP
  • Typgruppe ESPPH




Parameter

E_FLG_ERROR
E_FLG_LOCKFAIL
E_FLG_WARNING
I_ADDINF
I_FLG_CHECK_ONLY
I_FLG_HEADER
I_FLG_JOIN
I_FLG_KEY_DATE_SWITCH_ONLY
I_FLG_KEY_DRAWN
I_FLG_LOCK_CATALOG
I_FLG_REF
I_FLG_TEXT
I_FLG_TEXT_LONGTEXT
I_LSADM
I_VALFR
I_VALTO
X_API_PHR_TAB

Ausnahmen

CONVMODE_SET_FAILED
INTERNAL_ERROR
INTERVAL_ACCESS_ERROR
KEYDATE_OR_CHANGENUMBER_ERROR
NO_OBJECT_SPECIFIED
PARAMETER_ERROR

Funktionsgruppe

C1F0

ABAP Short Reference   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 8025 Date: 20240523 Time: 115923     sap01-206 ( 83 ms )