Download zulässiger Merkmalwerte

Um zulässige Werte zu einem Merkmal aus dem SAP-System zu lesen, verwenden Sie die Methode GetHelpvalues (Zulässige Merkmale zu einem Prozeßmerkmal lesen) des SAP-Business-Objekts ProcessCharactrstcPI (Prozeßmerkmal) .

Die zulässigen Werte werden anhand der Suchhilfe ermittelt, die dem Merkmal im Customizing zugeordnet ist. Folgende Einstellungen zum Merkmal werden berücksichtigt (siehe Customizing der Prozeßkoordination, unter Merkmale für Prozeßmeldungen definieren und Merkmale für Prozeßvorgaben definieren ):

die zulässigen Einzelwerte oder Werteintervalle

die zugeordnete Prüftabelle oder -funktion

die zugeordnete Fremdschlüsselbeziehung

Ein im Merkmal hinterlegter Matchcode wird nicht berücksichtigt.

Voraussetzungen für die Werteselektion

Die Merkmale müssen zu einer Merkmalgruppe gehören, die für die Verwendung in Prozeßvorgaben oder Prozeßmeldungen freigegeben ist (siehe Customizing der Prozeßkoordination, Merkmalgruppen für Prozeßmeldungen definieren und Merkmalgruppen für Prozeßvorgaben definieren ). Das System prüft die Freigabe in dem Werk, das Sie im Parameter Plant übergeben.

Zu Merkmalen mit Prüffunktionen muß ein Funktionsbaustein für die dialoglose Werteselektion existieren. Der Name dieser Funktion muß aus folgenden Teilen zusammengesetzt sein:

dem Namen der im Merkmal eingetragenen Prüffunktion

der Endung _ND

Ein solcher Funktionsbaustein existiert derzeit zu folgenden im Standard vorgesehenen Prüffunktionen:

COC1_PPPI_CHAR_VALUES (Werteprüfung für Prozeßmerkmale mit Fremdschlüsselbeziehung)

Benötigte Berechtigungen

Berechtigungsobjekt

Feld

Wert

C_PROCCHAR

Merkmalname

Merkmal, dessen Werte Sie lesen wollen

Aktivität

B1 (Zulässige Werte ins Fremdsystem übernehmen)

C_CREX_WRK

Empfängeradresse

RFC-Destination des Fremdsystems

Aktivität

90 (Steuerrezeptdaten aus dem SAP-System anfordern)

Werk

Werk

Die Prüfung erfolgt zu dem Merkmal, dessen Name Sie im Parameter CharacteristicName übergeben.

Selektionskriterien

Als Selektionskriterien für die Merkmalwerte können Sie folgende Parameter übergeben:

Importparameter

Format

Länge

Obl.

Beschreibung

CharacteristicName

CHAR

30

X

Merkmalname

Plant

CHAR

04

X

Werk, in dem die Merkmale für Prozeßvorgaben bzw. Prozeß­meldungen freigegeben sind

MaxRows

INT4

10

Max. Anzahl zu selektierender Werte

DescriptionOnly

CHAR

01

Kennz.: Nur Strukturbeschreibung ermitteln, keine Werte

Tabellenparameter

Beschreibung

Anzahl Einträge

SelectionForHelpvalues

Kriterien für Werteselektion anhand Fremdschlüsselbeziehung, Prüftabelle oder Prüffunktion

Beachten Sie bei der Verwendung des Parameters SelectionForHelpvalues:

Welche Selektionskriterien Sie verwenden können ist abhängig von der Suchhilfe des Merkmals.

Suchhilfen können sich ändern. Ermitteln Sie die Suchhilfeparameter daher immer dynamisch, indem Sie die Methode zunächst mit dem Kennzeichen DescriptionOnly ausführen. Sofern vorhanden übergibt das SAP-System dann im Parameter DescriptionForHelpvalues , Feld FIELDNAME die Suchhilfeparameter, d.h. mögliche Kriterien für die Werteselektion.

Anschließend können Sie die zulässigen Werte lesen, indem Sie die Methode ohne das Kennzeichne DescriptionOnly , aber mit spezifischen Selektionskriterien ausführen.

Die Selektionskriterien werden nicht berücksichtigt, wenn die zulässigen Werte im Merkmal als Einzelwerte oder Werteintervall hinterlegt sind. In diesem Fall werden alle Werte bzw. Intervalle übergeben.

Tabelle SelectionForHelpvalues

Feld

Format

Länge

Beschreibung

SELECT_FLD

CHAR

30

Suchhilfeparameter des Merkmals. Er entspricht, sofern vorhanden, einem Feld der zugehörigen Prüftabelle.

SIGN

CHAR

01

Kennz.: Wert bzw. Wertebereich in die Selektion einbeziehen oder ausschließen.

I      (Wert bzw. Wertebereich in die       Selektion einbeziehen) E     (Wert bzw. Wertebereich aus der       Selektion ausschließen)

OPTION

CHAR

02

Selektionsoperator, der zusammen mit den Feldern LOW und HIGH einen Wertebereich bestimmt

EQ = Gleichheit (= Low) NE = Ungleichheit (<> Low) BT = Zwischen unteren und oberen Wert (Low <= x <= High) NB = Außerhalb unteren und oberen Wert (x < Low und High < x ) CP = Enthält das Suchmuster NP = Enthält das Suchmuster nicht LT = Kleiner als (< Low) LE = Kleiner oder gleich als (<= Low)

GT = Größer als (> Low) GE = Größer oder gleich als (>=Low)

LOW

CHAR

30

Einzelwert oder Untergrenze eines Wertebereichs

HIGH

CHAR

30

Obergrenze des Wertebereichs
Beispiel für die Bewertung der Tabellenfelder:

Sie wollen zulässige Werte zum Merkmal PPPI_BATCH (Charge) ermitteln. Hierzu übergeben Sie folgende Selektionskriterien:

Feld

Wert

SELECT_FLD

MATNR (Feld für Materialnummer in der Prüftabelle)

SIGN

I (Wert in Selektion einbeziehen)

OPTION

EQ (Equal/gleich)

LOW

MAT_4711 (Material)

HIGH

' ' (blank)

Das System selektiert alle zum Material MAT_4711 angelegten Chargen und übergibt sie als zulässige Werte an den Aufrufer.

Rückgabe der zulässigen Merkmalwerte

Die zulässigen Merkmalwerte werden in folgendem Parameter zurückgeliefert:

Tabellenparameter

Beschreibung

Anzahl Einträge

Helpvalues

Zulässige Merkmalwerte,

die anhand der Selektionskri­terien sowie einer im Merkmal hinterlegten Fremdschlüssel­beziehung, Prüftabelle oder Prüffunktion ermittelt wurden

die als Einzelwerte direkt im Merkmal hinterlegt sind und das Format CHAR habe n

1 / Wert

ValuesForField

Selbe Merkmalwerte wie in Tabelle Helpvalues , aber ohne Zusatz­informationen

1 / Wert

DescriptionForHelpvalues

Struktur von Einträgen in der Tabelle Helpvalues

1 / Merkmal

FixValues

Zulässige Werte, die im Merkmal selbst als Einzelwerte oder Werteintervall hinterlegt sind

1 / Wert bzw. Intervall

Tabelle Helpvalues

Feld

Format

Länge

Beschreibung

HELPVALUES

CHAR

255

Zulässige Merkmalwerte,

die anhand der Selektionskriterien sowie einer im Merkmal hinterlegten Fremd­schlüsselbeziehung, Prüftabelle oder Prüffunktion ermittelt wurden

die als Einzelwerte direkt im Merkmal hinterlegt sind und das Format CHAR haben

Die Tabelle Helpvalues hat keine feste Struktur,

da je nach Merkmal und Suchhilfe unterschiedliche Informationen übergeben werden

da sich Suchhilfen ändern können

Die Tabellenstruktur wird daher dynamisch im Parameter DescriptionForHelpvalues übergeben. Greifen Sie immer über diesen Parameter auf die Tabelle zu.

Tabelle ValuesForField

In diesem Parameter übergibt das SAP-System dieselben Merkmalwerte wie in der Tabelle Helpvalues , allerdings ohne jede Zusatzinformation, d.h. ohne Struktur.

Die Verwendung der Tabelle ValuesForField ist aus Performance-Gründen günstiger als die Tabelle Helpvalues , da der Zugriff auf die Merkmalwerte ohne Strukturdefinition erfolgt. Da die Anzahl der Zeilen in den beiden Tabellen übereinstimmt, können Sie die Zeile eines bestimmten Werts in der Tabelle Helpvalues ermitteln und anschließend den Wert aus der Tabelle ValuesForField lesen.

Tabelle DescriptionForHelpvalues

Feld

Format

Länge

Beschreibung

TABNAME

CHAR

30

Name der Datenbanktabelle, zu der das Feld gehört

FIELDNAME

CHAR

30

Namen eines Feldes in Tabelle Helpvalues .

Hier übergebene Felder können Sie in der Tabelle SelectionForHelpvalues als Selektionskriterien bzw. Suchhilfe­parameter verwenden.

LANGU

LANG

01

Schlüssel der Sprache, in der die Texte des zum Feld gehörenden Repository-Objekts (z.B. Datenelement) übergeben werden

POSITION

NUMC

04

Position des Feldes in der Tabelle (z.B. 5 = 5. Tabellenfeld)

OFFSET

NUMC

06

Position des Feldes im Workarea (z.B. 7 = Feld beginnt mit dem 7. Zeichen der Zeile)

LENG

NUMC

06

Länge des Feldes

FIELDTEXT

CHAR

60

Kurzbeschreibung des Repository-Objekts

REPTEXT

CHAR

55

Überschrift

SCRTEXT_S

CHAR

10

Kurzes Schlüsselwort

SCRTEXT_M

CHAR

20

Mittellanges Schlüsselwort

SCRTEXT_L

CHAR

40

Langes Schlüsselwort

Tabelle FixValues

Feld

Format

Länge

Beschreibung

OPERATOR_LOW

CHAR

10

Operator zum unteren Grenzwert:

> (größer) < (kleiner) >= (größer gleich) <= (kleiner gleich)

OPERATOR_HIGH

CHAR

10

Operator zum oberen Grenzwert; zulässige Werte wie im Parameter OPERATOR_LOW

LIMIT_LOW

CHAR

30

Untergrenze des Werteintervalls

LIMIT_HIGH

CHAR

30

Obergrenze des Werteintervalls

FIX_VALUE

CHAR

30

Zulässiger Einzelwert

DEFAULT_FLAG

CHAR

01

Kennz.: Einzelwert ist Vorschlagswert
Beispiel für die Bewertung der Tabellenfelder:

Für ein numerisches Merkmal ist im Customizing folgender Wertebereich definiert: >5.5 - <12.0

In der Tabelle FixValues wird dann folgender Eintrag übergeben:

Feld

Wert

OPERATOR_LOW

>

OPERATOR_HIGH

<

LIMIT_LOW

5.5

LIMIT_HIGH

12.0

FIX_VALUE

5.5

DEFAULT_FLAG

' ' (blank)
Systemnachrichten

Systemnachrichten, die während des Methodenaufrufs auftreten, werden im Parameter Return zurückgegeben.

Exportparameter

Bezugsstruktur

Beschreibung

Return

BAPIRET2

Systemnachrichten zum Methodenaufruf

Folgende Systemnachrichten können auftreten:

Typ

ID

Nummer

Systemnachricht

E

CB

616

Keine Berechtigung zum Anzeigen der zulässigen Werte

E

0C

010

Bitte zulässiges Merkmal eingeben

E

CB1

207

Merkmal & ist nicht angelegt

E

CB

614

Zum Merkmal & sind keine zulässigen Werte definiert

A

CB1

210

Zulässige Werte zum Merkmal & können nicht ermittelt werden

E

CB1

200

Werk & ist nicht angelegt (Bitte geben Sie ein zulässiges Werk ein)

A

CB

251

Keine weitere Verarbeitung möglich (Bitte Verantwortlichen verständigen)

Informationen über die Struktur BAPIRET2 finden Sie in Download von Detaildaten zu Merkmale n , Abschnitt Systemnachrichen.