Ansicht
Dokumentation

RCCLBI03 - Klassifizierungsdaten pflegen

CL_GUI_FRONTEND_SERVICES - Frontend Services   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

1. Beschreibung

Das Programm RCCLBI03 ist ein Direct-Input-Report. Es klassifiziert alle Objekte, die in einer Eingabedatei enthalten sind. Das heißt:

,,-Zuordnungen Klasse/Objekt anlegen, ändern, löschen,
,,-Zuordnungen Klasse/Klasse anlegen, ändern, löschen,
,,-Bewertungen von Zuordnungen anlegen, ändern, löschen.

Mit Hilfe dieses Reports können Objekte aller Klassenarten klassifiziert werden. Insbesondere dürfen auch Materialen und Chargen für die Klassenarten 022 bzw. 023 klassifiziert werden.

Die Datei ist je Objekt aufgebaut aus Sätzen für Zuordnungen und deren Bewertungen. Der Report liest zuerst die ganze Datei ein, dann werden die Datensätze Objekt für Objekt verarbeitet. Nachdem alle Sätze zu einem Objekt fehlerfrei prozessiert sind, werden die Klassifizierungsdaten dieses Objekts sofort auf der Datenbank gesichert.

Wenn bei einem Objekt ein Fehler auftritt, werden keine Daten gesichert. Selbst wenn nur ein Bewertungssatz fehlerhaft ist, wird die Zuordnung insgesamt nicht gesichert. Dann werden alle Sätze, die das Objekt betreffen (Zuordnungen und Bewertungen), im Originalformat in eine Fehlerdatei geschrieben. Diese Fehlerdatei kann dann korrigiert und wiederum als Eingabedatei verwendet werden.
Der Report wird nicht abgebrochen, wenn die Sätze eines Objekts fehlerhaft sind.

Um die Dauer der Verarbeitung und den Speicherbedarf zu begrenzen und um die Übersichtlichkeit zu wahren, sollten große Datenmengen auf mehrere Dateien verteilt werden: z.B. getrennt nach Klassenart und Zuordnungstyp.

Die Eingabedatei kann mit dem Report RCCLBISC editiert werden.

2. Eingabeparameter des Reports

Logischer Dateiname

Logischer Name für die Eingabedatei (Standardeinstellung CLASSIFICATION).
Er wird im Customizing angelegt und kann über die F4-Hilfe ausgewählt werden.
Customizing:
Basis -> Systemadministration -> plattformunabhängige Dateinamen -> Dateinamen und Dateipfade mandantenunabhängig pflegen.

Prüfung der Objekte

Sperren:
Das Objekt, das gerade bearbeitet wird, wird für andere Benutzer gesperrt. Es wird überprüft, ob es existiert.

Existenz prüfen:
Das Objekt wird nicht gesperrt, nur die Existenz wird geprüft.

Keine Sperre, keine Prüfung (Standardeinstellung):
Das Objekt wird nicht gesperrt und nicht geprüft.

Ablageort

Die Eingabedatei wird je nach Einstellung von einem Applikationsserver oder vom Präsentationsserver (Frontend) gelesen. Diese Einstellung ist nicht im Customizing vermerkt.

Fehlerdatei

Name der Fehlerdatei im Klartext (Standardeinstellung 'RCCLBI03.error').
Die Datei enthält alle Datensätze, die nicht verarbeitet werden konnten. Geben Sie den Namen allein oder mit dem vollständigen Pfadnamen ein. Wenn kein Pfad angegeben ist, wird die Datei im Home-Verzeichnis (oder Desktop) des Anwenders angelegt.
Die Datei wird auf dem Rechner angelegt, von dem die Eingabedatei gelesen wird: Applikationsserver oder Präsentationsserver.

Gültigkeit

Wenn hier eine Änderungsnummer eingetragen wird, werden alle Objekte der Eingabedatei mit dieser Änderungsnummer klassifiziert. Für Änderungsdienst mit Parametergültigkeit (Effectivity) kann hier das Gültigkeitsdatum mitgegeben werden.
Diese Eingaben sind nur erlaubt, wenn im Customizing der Änderungsdienst für alle Klassenarten eingestellt ist, in denen die Objekte klassifiziert werden.

Die Eingabeparameter können in Varianten gespeichert werden.

3. Format der Eingabedatei

Die Datei enthält zeilenweise Zuordnungssätze (Objekt/Klasse oder Klasse/Klasse) im Format BIKSSK und Bewertungssätze (Bewertungen von Merkmalen) im Format BIAUSP. Jede Zeile wird mit einem Zeilenumbruch beendet.

• Die Bewertungssätze müssen direkt nach dem zugehörigen Zuordnungssatz stehen.

• Die Zuordnungssätze müssen nicht nach Objekten sortiert sein. Dies erfolgt im Report: vor der Bearbeitung wird die Liste der Objekte sortiert nach Zuordnungstyp (zuerst Klasse/Klasse, dann Klasse/Objekt), Klassenart, Objekt, Objekttyp.

• Felder, die initial sein sollen, müssen leer bleiben und dürfen keine Sonderzeichen enthalten, wie z.B. '/'.

Format für eine Zuordnung (BIKSSK)

Feld / Länge(Position)	Wert
STYPE	01 (01)	'1' : Kennzeichen eines Zuordnungssatzes
TCODE	20 (02)	Leer. Das Feld wird nicht mehr verwendet.
		(Früher: 'CL20' oder 'CL22').
MAFID	01 (22)	Zuordnungstyp
		'O' : für Objekt/Klasse - Zuordnungen,
		'K' : für Klasse/Klasse - Zuordnungen.
KLART	03 (23)	Klassenart, in der das Objekt klassifiziert werden soll.
OBJEK	50 (26)	Name des Objekts oder der Klasse.
	Berücksichtigen Sie führende Nullen bei rein numerischen Bezeichnungen
		(z.B. Materialien, Equipments). Prüfen Sie evtl. die Stammdatentabelle (MARA, ...),
		um die das richtige Format zu finden.
CLASS	18 (76)	Klasse, der das Objekt zugeordnet werden soll.
	Klassenname im Klartext, nicht der interne Schlüssel aus der Tabelle KLAH.
STATU	01 (94)	Klassifizierungsstatus:
	Wenn kein Wert eingetragen ist, wird keine Änderung versucht.
STDCL	01 (95)	'X' : kennzeichnet die zugeordnete Klasse als Standardklasse.
XLINE	06 (96)	Leer. Das Feld wird intern verwendet.
OBTAB	30 (102)	Objekttyp (nur bei mafid=O ):
	Wenn in einer Klassenart mehrere Objekttypen erlaubt sind, muss hier
		der Typ aus der Customizingtabelle TCLAO stehen.
		Z.B. 'MARA' bei Klassenart 022/023.
LKENZ	01 (132)	Löschkennzeichen:
	'X' : die Zuordnung wird gelöscht.
		' ' : die Zuordnung wird geändert oder angelegt, falls sie noch nicht existiert.

Format für eine Bewertung (BIAUSP)

Feld / Länge(Position)	Wert
STYPE	01 (01)	'2' : Kennzeichen eines Bewertungssatzes
XLINE	06 (02)	Leer. Das Feld wird intern verwendet.
ATNAM	30 (08)	Der neutrale Merkmalname.
ATWRT	30 (38)	Der neutrale Merkmalwert.
LKENZ	01 (68)	Löschkennzeichen.
	'X' : die Bewertung wird gelöscht.
	' ' : die Bewertung wird geändert oder angelegt, falls sie noch nicht existiert.

Hinweise

Feld STYPE:
Andere Zeichen als die Ziffern 1 oder 2 werden beim Einlesen ignoriert und können als Kommentarzeichen für eine Zeile verwendet werden.

Reihenfolge:
Wenn Sie für für ein Objekt (bezogen auf eine Klassenart) die BIKSSK-Sätze für alle Klassen anlegen, denen das Objekt schon zugeordnet ist oder noch zugeordnet werden soll, dann brauchen die Merkmale nicht nach Klassen getrennt zu werden: in diesem Fall dürfen alle BIKSSK-Sätze und alle BIAUSP-Sätze jeweils in einem Block zusammengefasst werden.

1 .. OBJECT_1 ... CLASS_1,,,,,,,,1 .. OBJECT_1 ... CLASS_1
2 .. CHARACTERISTIC_10   ,,,,,,,,1 .. OBJECT_1 ... CLASS_2
2 .. CHARACTERISTIC_11   ,,,,,,,,1 .. OBJECT_1 ... CLASS_3
1 .. OBJECT_1 ... CLASS_2,,,,>>,,,,2 .. CHARACTERISTIC_10
2 .. CHARACTERISTIC_20   ,,,,,,,,2 .. CHARACTERISTIC_11
2 .. CHARACTERISTIC_21   ,,,,,,,,2 .. CHARACTERISTIC_30
1 .. OBJECT_1 ... CLASS_3,,,,,,,,2 .. CHARACTERISTIC_20
2 .. CHARACTERISTIC_30   ,,,,,,,,2 .. CHARACTERISTIC_21

Zuordnung löschen:
Wenn eine Zuordnung gelöscht wird, werden auch ihre zugehörigen Bewertungen gelöscht. Daher sind für solche Zuordnungen keine BIAUSP-Sätze notwendig, um die Bewertungen zu löschen.

Zuordnung ändern:
Der Klassifizierungstatus soll auf 1 gesetzt werden. Wenn die vorhandene Zuordnung einen Status ungleich 1 hat, wird überprüft, ob ihre Merkmalbewertungen konsistent sind: falls ja, wird der Status auf 1 (freigegeben) gesetzt, sonst auf 5 (gesperrt durch System). Bei dieser Prüfung werden unbewertete Mussmerkmale erkannt.

Merkmalbewertung ändern:
Einwertige Merkmale: Bei Merkmalen, die eine Werteliste besitzen oder vom Typ Zeichenformat oder Datum sind, benötigt man für die alte Bewertung keinen Löschsatz; es reicht ein Satz mit den neuen Wert.
Bei numerischen Werten mit freier Eingabe sind immer zwei Sätze (löschen und hinzufügen) notwendig. Dabei muss im Löschsatz der Merkmalwert in der externen Darstellung angegeben werden (s. Beispiel).
Mehrwertige Merkmale: Um eine Bewertung auszutauschen, muss ein Löschsatz angegeben werden.

Beziehungswissen:
Das Beziehungswissen wird immer ausgeführt, so dass Merkmalbewertungen geändert werden können, obwohl für sie kein BIAUSP-Satz vorhanden ist.
Wenn Beziehungswissen ausgeführt werden soll, das Objektmerkmale enthält oder sich auf Objektmerkmale bezieht, muss der Parameter. Prüfung der Objekte auf 'Existenz prüfen' oder 'Sperren' gesetzt sein.

Beispiel

1                    OZ01MAT_ABC                     CLASS_Z       MARA
2      SIZE                          SMALL
2      LENGTH                        11,00 cm                      X
2      LENGTH                        12,00 cm
2      TYPE                          A
2      DATE1                         04.03.2001
*----------------------------------------------------------------------
1                    O023BATCH_MAT                   CLASS_1       MARA
2      COLOR                         red
2      COLOR                         blue
2      COLOR                         green
2      TYPE                          A
2      TYPE                          B
2      POLLUTION                     0 - 30 %
*----------------------------------------------------------------------
1                    O023BATCH_MAT_________BATCH1    CLASS_1       MCH1
2      COLOR                         red
2      TYPE                          B
2      POLLUTION                     4 %

(Die Positionen sind der Übersichtlichkeit wegen nicht genau eingehalten.)
Das Material MAT_ABC wird in der Klassenart Z01 klassifiziert.
Es wird der Klasse CLASS_Z zugeordnet, die die Merkmale SIZE, LENGTH, und TYPE besitzt. Merkmal DATE1 kann aus einer Klasse vererbt sein, zu deren Hierarchie CLASS_Z gehört. Die Bewertung von Merkmal LENGTH wird von 11,00 auf 12,00 cm geändert.

Das Material BATCH_MAT wird in der Klassenart 023 klassifiziert:
Es wird der Klasse CLASS_1 zugeordnet, die die Merkmale COLOR, TYPE und POLLUTION besitzt. Da in Klassenart 023 ein Material einen Hierarchieknoten darstellt, können die einwertigen Merkmale COLOR und TYPE mehrfach bewertet werden.
Die Charge 'BATCH_MAT BATCH1' erhält Bewertungen aus den Wertebereichen, die durch das zugehörige Material vorgegeben sind. Entnehmen Sie das Format für den Chargennamen der Einstellung im Customizing (Tabelle TCLO, TA O12A) oder - in Form von Beispielen - der Tabelle INOB (Feld OBJEK).
In Klassenart 023 müssen die Bezeichnungen MARA und MCH1 an der Position 'OBTAB' stehen, da in dieser Klassenart verschiedene Objekttypen klassifiziert werden können.

Wichtig:
Mit diesem Report werden Klassifizierungen direkt angelegt. Wenn eine Anwendung in ihrem Stammdatenumfeld prozesstypische Zusammenhänge zwischen verschiedenen Objekttypen (z.B. Material/Charge/Belege/...) herstelt, dann sind diese hier nicht bekannt und werden nicht berücksichtigt ! Daher muss auch der Objektname korrekt formatiert angegeben sein, da hier die Aufbereitung des Anwendungsprogramms fehlt.

4. Fehlermeldungen

Der Report erzeugt dann eine Fehlermeldung, wenn ein Funktionsbaustein einen Ausnahmewert (Exception) zurückgibt, der einen Fehler anzeigt. Eine Fehlermeldung enthält

- eine Überschrift als allgemeine Beschreibung ('Fehler ...'),
- einen Detailtext, der sich aus der Exception ergibt,
- den Funktionsbaustein und seine Exception-Nummer,
- die fehlerhafte Zuordnung,
- die Merkmale, falls ein Bewertungssatz fehlerhaft ist.

Die folgende Liste enthält alle Überschriften und die jeweiligen Funktionsbausteine, aus denen der Fehler resultiert. Die Detailtexte sprechen in der Regel für sich und sind daher nicht aufgeführt:

Fehler beim Lesen der Klassifizierungdaten	(CLAP_DDB_GET_CLASSIFICATION)
Fehler beim Ändern der Klassifizierungdaten	(CLAP_DDB_ UPDATE_CLASSIFICATION)
Fehler beim Löschen der Klassifizierungdaten	(CLAP_DDB_DELETE_CLASSIFICATION)
Fehler beim Löschen der Bewertung		(CTMS_DDB_DEL_VALUE)
Fehler beim Pflegen der Bewertung		(CTMS_DDB_SET_VALUE)
Fehler durch Sperren Klassenart		(CLAP_DDB_SAVE_CLASSIFICATION)
Fehler beim Prüfen Objekt		(OBJECT_CHECK_)

Beispiele:

• Fehler beim Ändern der Klassifizierungsdaten
  Sonstiges
  ( CLAP_DDB_UPDATE_CLASSIFICATION:  exception      24 )
  001  12345678                              CLASS_2

Diese Fehlermeldung kommt bei Materialien (Klassenart 001) vor, wenn eine falsche Bezeichnung (z.B. ohne führende Nullen) angegeben wurde. Wenn die Eingabeparameter keine gesonderte Existenzprüfung des Materials vorsehen, dann findet die Klassifizierung zu diesem Material keine Materialart, was zum Fehler führt.

• Fehler beim Pflegen der Bewertung
  COLOR:  'blu' ist nicht vorhanden
  ( CTMS_DDB_SET_VALUES: exception      9 )
  001  000000000012345678                    CLASS_1
       COLOR,,,,,,blu
       LENGTH,,,,,,11,00 cm

Das Material 000000000012345678 (Klassenart 001) soll mit 'blu' bewertet werden. Das Merkmal COLOR hat den Wert aber nicht in seiner Werteliste.

PERFORM Short Reference   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 23010 Date: 20240531 Time: 061828     sap01-206 ( 221 ms )