Kontakt

Ansicht
Dokumentation

FC_CHAR_PROPERTIES - Eigenschaften von SAP Kons. Merkmals, Existenzcheck

FC_CHAR_PROPERTIES - Eigenschaften von SAP Kons. Merkmals, Existenzcheck

CPI1466 during Backup   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

  1. Verprobung von Merkmalswerten auf Existenz.
  2. Ermittlung von Kurz- und Langtext.
  3. Ermittlung von Attributwerten für Merkmalswerte.
  4. Ermittlung von Merkmalswerten aus komplexer Selektionsbedingung für Merkmal und/oder Attribute.

Eingabeparamter E_FIELDNAME:
Feldname des Merkmals, für das eine der Funktionen ausgeführt werden soll. Zulässig sind alle Merkmale außer den Navigationsattributen. Bei Navigationsattributen (T_FATTR-ATTR_TYPE = FC00_C_ATTR_TYPE-NAV) ist als Feldname (dies gilt auch für alle anderen Parameter dieses Bausteins) T_FPROP-ATTR_ORIG zu benutzen.

Eingabeparameter ET_ATTRIBUTE:
Feldnamen der Attribute, deren Werte pro Merkmalswert ermittelt werden sollen. Sowohl Anzeige- als auch Navigationsattribute sind zulässig.

Eingabeparameter ET_SEL:
Komplexe Selektionsbedingung für

  • das Merkmal und
  • für das unabhängige Merkmal zu diesem Merkmal (falls Klammerung vorliegt);
  • für eines der NAVIGATIONSattribute oder
  • für eines der Felder wie Version, Jahr, Periode, die für die Selektion der Attribute unter Umständen erforderlich sind. Für diese zusätzlichen Selektionsbedingungen darf es nur Einträge der Form SIGN='I' und OPTION='EQ' geben.

Eingabeparameter E_LANGU:
Sollte NUR DANN angegeben werden,

  • wenn Texte gelesen werden sollen UND
  • wenn die Texte in einer Sprache ungleich sy-langu benötigt werden !

Eingabe- und Ausgabeparameter CT_CHAR:

  1. Modus
    CT_CHAR ist bei Aufruf des Bausteins leer.
    Dann werden alle Merkmalswerte für die in ET_SEL gegebene Selektionsbedingung ermittelt (dies funktioniert für alle Merkmale mit Ausnahme derjenigen Felder, die weder Prüftabelle T_FPROP-CHECKTABLE noch Domänenfestwerte T_FPROP-VALEXI haben). CT_CHAR ist bezüglich der Struktur frei definierbar. Es gibt zwei Möglichkeiten:
    1. CT_CHAR enthält explizit die Feldnamen des Merkmals und der unabhängigen Felder.
    2. CT_CHAR enthält ein Feld VALUE, das per TYPE FC_VALUE definiert wird. In diesem Feld stehen konkateniert die Werte der unabhängigen Felder und des abhängigen Feldes E_FIELDNAME.
Wenn CT_CHAR Attribute enthält, dann werden die zugehörigen Werte ermittelt. Es gibt drei Möglichkeiten, Attribute anzufordern:
  1. CT_CHAR enthält Felder, die so heißen wie die Attribute. Die Werte werden unmittelbar in diese Felder eingestellt. Es werden diejenigen Attribute ermittelt, die in ET_ATTRIBUTE aufgelistet werden.
  2. CT_CHAR enthält ein Feld ATTR_VAL. Alle in ET_ATTRIBUTE angeforderten Felder werden konkateniert in ATTR_VAL eingestellt.
  3. CT_CHAR enthält ein Keyfeld ATTRIBUTE und ein Datenfeld ATTR_VAL. Alle in ET_ATTRIBUTE angeforderten Attribute werden ermittelt. Pro Attribut wird ein Satz zurückgeliefert, wobei in ATTRIBUTE der Feldname des Attributs steht und in ATTR_VAL der Wert des Attributs. Diese Option ist hinsichtlich Performance kritischer als die anderen beiden.
  • Modus
    CT_CHAR ist bei Aufruf gefüllt, d.h. es wird eine Menge von Werten für E_FIELDNAME vorgegeben. Die Werte können auf zwei verschiedene Arten angegeben werden:
    1. CT_CHAR enthält explizit die Feldnamen des Merkmals und der unabhängigen Felder.
    2. CT_CHAR enthält ein Feld VALUE, das per TYPE FC_VALUE definiert wird. In diesem Feld stehen konkateniert die Werte der unabhängigen Felder und des abhängigen Feldes E_FIELDNAME.
    Wenn CT_CHAR das Feld EXIST enthält, dann wird überprüft, ob die in CT_CHAR angegebenen Werte existieren, d.h. in der Prüftabelle vorkommen. Wenn der Wert existiert, dann wird das Kennzeichen EXIST gesetzt (vgl. auch Struktur FC00_S_CHPR_EC und Tabelle FC00_T_CHPR_EC).
    Wenn CT_CHAR Attribute enthält, dann werden die zugehörigen Werte ermittelt. Es gibt zwei Möglichkeiten, Attribute anzufordern:
    1. CT_CHAR enthält Felder, die so heißen wie die Attribute. Die Werte werden unmittelbar in diese Felder eingestellt. Es werden diejenigen Attribute ermittelt, die in ET_ATTRIBUTE aufgelistet werden.
    2. CT_CHAR enthält ein Feld ATTR_VAL. Alle in ET_ATTRIBUTE angeforderten Felder werden konkateniert in ATTR_VAL eingestellt.

    Wenn CT_CHAR mindestens eines der beiden Felder TXTSH oder TXTLG enthält, dann werden in diesen Feldern Texte zurückgeliefert (dies ist nur möglich für Merkmale, bei denen T_FPROP-TEXTFLAG gesetzt ist). Wenn ein Kurz- und ein Langtext verfügbar ist, steht dieser jeweils in TXTSH und TXTLG. Ansonsten stehen in beiden Feldern die gleichen Texte. TXTSH sollte per Referenz auf FC_TXT_SH deklariert werden, TXTLG per Referenz auf FC_TXT_LG. Die Textfelder können nicht hinzugelesen werden, wenn Attribute per Keyfeld ATTRIBUTE ausgegeben werden.

    Anmerkungen:

    1. Wenn CT_CHAR mit expliziten Feldnamen des Feldkatalogs definiert werden muß (d.h. explizite Keyfelder anstatt des generischen Feldes VALUE, explizite Feldnamen der Attribute anstatt des generischen Feldes ATTR_VAL), dann sollte der Verantwortliche des Bausteins darüber informiert werden.
    2. Offsichtlich ist es nicht sinnvoll, das Feld EXIST im 1. Modus einfügen zu verwenden, weil es stets auf ='X' gesetzt würde; denn CT_CHAR würde nach Aufruf des Bausteins nur Einträge enthalten, die in der Prüftabelle vorkommen.
    3. Es gibt zwei Mechanismen zur Anforderung von Feldern:
      1. Die Felder EXIST, TXTSH und TXTLG werden angefordert, indem sie in die Tabelle CT_CHAR aufgenommen werden. Kommen sie in CT_CHAR vor, dann werden sie auch gefüllt.
      2. Anders bei den Attributen: Attribute werden nur dann ausgegeben, wenn sie in ET_ATTRIBUTE vorkommen. Kommt ein Attribut in CT_CHAR vor und wird es nicht in ET_ATTRIBUTE angegeben, dann wird es nicht ausgegeben.
    4. Angabe von Navigationsattributen in ET_SEL ist nur im Modus 1 sinnvoll. Die Selektionsbedingung zu den Navigationsattributen schränkt dann die Menge der zurückgelieferten Sätze ein.

    Beispiel

    Hinweise

    Weiterführende Informationen





    Parameter

    CT_CHAR
    ET_ATTRIBUTE
    ET_SEL
    E_DIMEN
    E_FIELDNAME
    E_LANGU
    E_RYEAR

    Ausnahmen

    FIELD_NOT_FOUND

    Funktionsgruppe

    FC21

    PERFORM Short Reference   Fill RESBD Structure from EBP Component Structure  
    Diese Dokumentation steht unter dem Copyright der SAP AG.

    Length: 7506 Date: 20240523 Time: 123709     sap01-206 ( 120 ms )