Download zulässiger Werte zu Merkmalen (SAP-Bibliothek - PP - PI-PCS Schnittstelle: Anbindung von Prozeßste)

Download zulässiger Werte zu Merkmalen

Die zulässigen Werte eines Merkmals können mit dem Funktionsbaustein PROC_CHAR_HELPVALUES_GET von einem Steuersystem angefordert werden. Die Initiative zum Download der Merkmalwerte geht vom Steuersystem aus. Der Download wird als synchroner RFC ausgeführt (siehe Grafik).

Grundlage für die Ermittlung der Merkmalwerte sind folgende Einstellungen im Merkmal:

die zulässigen Einzelwerte und Werteintervalle

die zugeordnete Prüftabelle oder Prüffunktion

die zugeordnete Fremdschlüsselbeziehung

Ein im Merkmal zugeordneter Matchcode wird nicht berücksichtigt.

Darüber hinaus kann mit dem genannten Funktionsbaustein die Gültigkeit eines einzelnen Merkmalwertes geprüft werden. In diesem Fall übergibt das Steuersystem den zu prüfenden Wert als Selektionskriterium. Der Wert ist gültig, wenn der Funktionsbaustein den gleichen Wert in der Ergebnistabelle zurückliefert.

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 System R/3 anfordern)
	Werk	Werk

Schnittstellenparameter und Ausnahmen

Folgende Daten werden an der Schnittstelle übergeben (aus Sicht des Funktionsbausteins):

Importparameter:

Name	Format	Länge	Obl.	Beschreibung
PLANT	CHAR	04	X	Werk, in dem die Merkmale für Prozeßvorgaben bzw. -meldungen freigegeben sind
PPPI_CHAR	CHAR	30	X	Name des Merkmals, zu dem erlaubte Werte angefordert werden
MAX_OF_ROWS	INT4	10		Max. Anzahl zu selektierender Werte
DESCRIPTIONONLY	CHAR	01		Kennz.: Nur Strukturbeschreibung ermitteln, keine Werte

Tabellen:

Name	Beschreibung
SELECTION_FOR_HELPVALUES	Selektionskriterien zur Einschränkung des Suchbereichs. Diese werden nicht berücksichtigt, wenn am Merkmal selbst Einzelwerte oder Intervalle definiert sind.
HELPVALUES	Gefundene zulässige Werte mit Text
VALUES_FOR_FIELD	Gefundene zulässige Werte ohne Text
DESCRIPTION_FOR_HELPVALUES	Beschreibung der Struktur der Tabelle HELPVALUES
DETAILED_VALUE_INFORMATION	Detailinformationen zu zulässigen Werten, die als Einzelwerte oder Intervalle am Merkmal selbst definiert sind

Ausnahmen:

Name	Beschreibung
CHARACTERISTIC_NOT_VALID	Merkmal ist ungültig
VALUES_CAN_NOT_BE_ DETERMINED	Zulässige Werte können nicht ermittelt werden.
NO_AUTHORITY	Keine Berechtigung zum Anzeigen von Merkmaldaten

Erläuterungen zu den Schnittstellenparametern

Tabelle SELECTION_FOR_HELPVALUES:

Diese Tabelle füllt das Steuersystem, wenn der Wertebereich eingeschränkt werden soll, aus dem zulässige Werte selektiert werden. Die Tabelle hat folgende Struktur:

Feld	Format	Länge	Beschreibung
SHLPNAME	CHAR	30	Name einer Suchhilfe
SHLPFIELD	CHAR	30	Name eines Suchhilfeparameters
SIGN	CHAR	1	Kennzeichen: I/E (Werte ein/ausschließen)
OPTION	CHAR	2	Selektionsoption, z.B. EQ/BT/CP/... (siehe Dokumentation zum ABAP)
LOW	CHAR	45	Unterer Intervallwert bzw. Einzelwert
HIGH	CHAR	45	Oberer Intervallwert

Tabelle HELPVALUES:

In dieser Tabelle übergibt PP-PI zulässige Merkmalwerte, die nicht als Einzelwerte oder Werteintervall im Merkmal erfaßt sind, sondern anhand der dort hinterlegten Prüftabelle, Prüffunktion oder Fremdschlüsselbeziehung ermittelt wurden. Außerdem werden Zusatzinformationen zu den Werten übergeben wie z.B. der sprachabhängige Kurztext.

Ein im Merkmal zugeordneter Matchcode wird bei der Ermittlung der zulässigen Werte nicht berücksichtigt.

Die Tabelle HELPVALUES hat keine feste Struktur, da je nach Merkmal und Suchhilfe unterschiedliche Informationen übertragen werden. Die Tabellenstruktur wird daher dynamisch in der Tabelle DESCRIPTION_FOR_HELPVALUES übergeben.

Feld	Format	Länge	Beschreibung
HELPVALUES	CHAR	255	Gefundene Merkmalwerte mit Texten (Wertetabelle ohne Struktur)

Tabelle VALUES_FOR_FIELD

Diese Tabelle enthält dieselben Merkmalwerte wie die Tabelle HELPVALUES, allerdings ohne Zusatzinformationen. Die Struktur der Tabelle besteht somit nur aus einem einzigen Feld für den Merkmalwert.

Die Verwendung dieser Tabelle ist unter Performance-Gesichtspunkten günstiger, da der Zugriff auf die Merkmalwerte ohne Strukturdefinition erfolgt.

Feld	Format	Länge	Beschreibung
VALUES	CHAR	255	Gefundene Merkmalwerte ohne Texte (Wertetabelle ohne Struktur)

Tabelle DESCRIPTION_FOR_HELPVALUES

Diese Tabelle beschreibt die Struktur von Einträgen in der Tabelle HELPVALUES. Die Struktur der Tabelle HELPVALUES wird dynamisch übergeben, da je nach Merkmal und Suchhilfe unterschiedliche Informationen übertragen werden.

Die Tabelle DESCRIPTION_FOR_HELPVALUES besteht aus folgenden Feldern:

Feld	Format	Länge	Beschreibung
TABNAME	CHAR	30	Tabellenname
FIELDNAME	CHAR	30	Feldname
LANGU	LANG	1	Sprachenschlüssel
POSITION	NUMC	4	Position des Feldes in der Tabelle
OFFSET	NUMC	6	Offset eines Feldes im Workarea
LENG	NUMC	6	Länge des Feldes (Anzahl der Zeichen)
FIELDTEXT	CHAR	60	Kurzbeschreibung von Repository-Objekten
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 DETAILED_VALUE_INFORMATION

In dieser Tabelle übergibt PP-PI zulässige Werte, die im Merkmal selbst hinterlegt sind (als Einzelwert oder Werteintervall). Die Tabelle hat folgende Struktur:

Feld	Format	Länge	Beschreibung
OPER1	CHAR	10	Operator zum unteren Grenzwert
OPER2	CHAR	10	Operator zum oberen Grenzwert
STRING1	CHAR	30	unterer Grenzwert
STRING2	CHAR	30	oberer Grenzwert
STRING	CHAR	30	zulässiger Eingabewert bei Merkmalen ohne Intervalldefinition
ATSTD	CHAR	1	Kennzeichen: Der betreffende Wert soll als Vorschlagswert erscheinen.