Ansicht
Dokumentation

C148_IDENTS_GET_FOR_SUB_ - EHS: Liste von Identifikatoren anhand der Ident.auflistung ermitteln

BAL Application Log Documentation   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Baustein ermittelt gemäß der übergebenen Identifikationsauflistungsart die N höchstpositionierten (N übergeben) Identifikatoren und gibt sie in einer Tabelle zurück, wobei pro Position gemäß der ID-Auflistung IDLCNT Records (siehe Tabelle TCG25) zurückgegeben werden. Ist für eine Position der Identifikationsauflistungsart nichts definiert bzw. existieren keine Identifikatoren, die dem Kriterium genügen, so wird ein leerer Identifikator für diese Position zurückgegeben.

Eine Identifikationsauflistungsart kann entweder durch den Parameter I_IDLID angegeben werden, oder durch direkte Definition im Parameter I_IDLIST_TAB. Im letzten Fall muß für I_IDLID ein initialer (oder kein) Wert übergeben werden.

Ist I_POSITIONS_WANTED initial, so werden alle im Customizing für diese Identifikationsauflistung definierten Positionen zurückgegeben.

Erweiterung
Es wurde die Funktionalität gewünscht, nicht eine RCGIDENT-Tabelle, sondern eine der Struktur RCGRIIOT zurückzugeben. Daher wurde die Schnittstelle um eine ebensolche Tabelle und einen Import-Parameter zur Angabe der gewünschten Ergebnisform hinzugefügt (siehe Parameterdoku zu I_RESULT_FORM).

Beispiel

TCG25 enthalte folgendes:

IDLPOS	IDLPRIO	IDTYPE	IDCAT	IDLCNT
1	1	NUM	CAS	2
2	1	NAM	SYN	3
2	2	NAM	IUPAC	1
3	1	NUM	EINECS	1
4	2	NUM	EEC	2

Dies bedeutet, daß an erster Position (bis zu) zwei CAS-Nummern gesucht werden. An zweiter Position möchte man entweder (bis zu) 3 Synonyme oder, falls es keine gibt, einen IUPAC-Namen. An dritter Position soll eine EINECS-Nummer (oder nichts, falls nicht gefunden) stehen. An vierter Position ist nun keine Prio 1 definiert, also zieht die 2, d.h. zwei EEC-Nummern.

ESTRI enthalte folgendes:

IDTYPE	IDCAT	IDENT
NUM	CAS	123-999-99-0
NUM	CAS	000-000-00-0
NUM	EEC	22-33-11-0
NAM	IUPAC	Aceton

Anfrage sei: C14Z_IDENTIFICATORS_GET
,,,,,,I_POSITIONS_WANTED ,,= 5
,,,,,,E_POSITIONS_RETURNED ,,= a
,,,,,,E_MAX_RECORDS_PER_POSITION ,,= b
,,,,,,E_IDTAB ,,= tab

Danach gilt:

tab =

POS	COUNTER	IDENT
1	1	123-999-99-0
1	2	000-000-00-0
2	1	Aceton
3	1
4	1	22-33-11-0

a = 4

b = 2

das heißt, es wurden vier Positionen mit jeweils maximal zwei 'Unterpositionen' belegt.

Hinweise

1. Es wird nach dem Feld ORD des Identifikators priorisiert. Das heißt, bei gleicher 'Qualifikation' zweier Identifikatoren für eine Position wird der mit der niedrigeren Ordnungszahl bevorzugt.
2. Man kann im Customizing (TCG25) auch bestimmen, daß der für eine bestimmte Position gewünschte Identifikator aus einer bestimmten Liste stammen muß (Feld SLSTID). Auch dies wird vom Algorithmus berücksichtigt, d.h. wenn ein Identifikator zwar ansonsten paßt, aber nicht aus eben dieser Liste stammt (was beim Identifikator im Dialog gepflegt wird), dann wird er als nicht passend behandelt.
3. Dem Baustein kann mittels X_KEYTAB auch eine ganze Menge von Stoffen übergeben werden, zu denen Identifikatoren ermittelt werden sollen. In diesem Fall dürfen allerdings die Parameter E_POSITIONS_RETURNED und E_MAX_RECORDS_PER_POSITION nicht ausgewertet werden, da sie keine sinnvollen Daten enthalten! Genau eines der beiden Datenobjekte I_RECN und X_KEYTAB[] muß beim Aufruf initial sein!

Weiterführende Informationen

-

Parameter

E_ESTRITAB
E_IDTAB
E_IDTITLE_TAB
E_MAX_RECORDS_PER_POSITION
E_POSITIONS_RETURNED
I_AENNR
I_ALL_ORDS_WANTED
I_FLG_ESTRI_SELECT
I_FLG_ESTRL_SELECT
I_FLG_IDTITLE_ACC_TO_IDENTS
I_FLG_SKIP_AUTH_CHECKS
I_IDLID
I_IDLIST_TAB
I_IDSUFFIX_WANTED
I_IDTITLE_WANTED
I_LANGU
I_OBJTYPE
I_POSITIONS_WANTED
I_RECN
I_RESULT_FORM
I_SEL_CRIT
I_VALDAT
X_KEYTAB

Ausnahmen

ILLEGAL_INPUT

Funktionsgruppe

C148

Fill RESBD Structure from EBP Component Structure   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 7049 Date: 20240523 Time: 123524     sap01-206 ( 94 ms )