Ansicht
Dokumentation

BAPI_PPR_MAINTAIN - Methode "Partner-Produktauswahlen bearbeiten"

CPI1466 during Backup   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Diese Methode ermöglicht die unabhängige Bearbeitung (erstellen/ändern) der folgenden Objekte der Partner-Produktauswahlen (PPRs):

• Köpfe (Eingabetabelle HeaderData),

• Kopf: Beschreibungen (Eingabetabelle HeaderDescription),

• Kopf: Organisationsdaten (Eingabetabelle HeaderOrganisationalData)

• Positionen (Eingabetabelle ItemData)

• Position: Beschreibungen (Eingabetabelle ItemDescription),

• Position: Geschäftspartnerdaten (Eingabetabelle ItemBusinessPartnerData),

• Position: Produktdaten (Eingabetabelle ItemProductData),

• Position: Zeitstempeldaten (Eingabetabelle ItemTimeStampData)

• Position Regelparameterdaten (Eingabetabelle ItemRuleParameterData).

Alle Eingabeparameter und Eingabetabellen sind optional, außer Erfolgs-/Fehlermeldungsprotokoll Return.

Eine Berechtigungsprüfung findet über das Berechtigungsobjekt CRM_PRP_BP statt. Je nach den im Customizing des CRM-Online-Systems definierten PPR-Arten wird geprüft, welche Aktivitäten (Erstellen und/oder Ändern) erlaubt sind.

Allgemeines

• Jede Zeile der unten genannten Eingabe-Datentabellen muß eine gültige, im CRM Customizing definierte PPR-Art enthalten. Wenn eine oder mehrere falsche PPR-Arten enthalten sind, werden alle Eingabedaten abgelehnt und nichts wird an die Datenbank weitergeleitet.

• Für jede in dieser Methode verwendete PPR-Art muß ein Berechtigungsprofil unter Verwendung des Berechtigungsobjektes CRM_PRP_BP im CRM- System bearbeitet werden. Mögliche Aktivitäten sind 'Erstellen' und/oder 'Ändern'.

• Für jede Zeile der unten genannten Datentabellen müssen die Felder

• Reference_Kind und

• Processing_Mode

ausgefüllt werden.

Für die Referenzart sind die Werte

• 'A' (für Kopfdaten, also Kopf, Kopf: Beschreibung, Kopf: Organisationsdaten und für Positionsdaten),

• 'B' (für Position: Beschreibungen, Position: Geschäftspartnerdaten, Position: Produktdaten und Position: Zeitstempeldaten)

• 'D' für Regelparameterdaten

und für den Bearbeitungsmodus die Werte

• 'A' (Daten erstellen),

• 'B' (Daten ändern) und

• 'D' (Daten löschen)

möglich.

• Wenn PPR-Daten in der Datenbank erstellt werden sollen, so muß

• jede betreffende Zeile der Eingabetabelle einen Wert im Feld Handle zur Identifikation enthalten.

• für jede betreffende Zeile der Eingabetabelle - außer Kopfdaten - das Feld Reference_Handle oder Reference_Guid mit dem Wert des entsprechenden Feldes Handleoder Guid des entsprechenden PPR-Kopfes oder der Position gefüllt werden.

• Sollen existierende PPR-Daten in der Datenbank geändert/gelöscht werden,

• so muß jede betreffende Zeile der Eingabetabelle den Wert des entsprechenden Feldes Guid des entsprechenden Eintrages in der Datenbank im Eingabetabellenfeld Guid enthalten.

• so muß jede betreffende Zeile der Eingabetabelle den Wert des entsprechenden Feldes Guiddes entsprechenden PPR-Kopfes oder der Position im Eingabetabellenfeld Reference_Guid enthalten.

• Sollen existierende PPR-Daten geändert werden, so werden nur die Felder der entsprechenden Eingabedatenzeile gefüllt, deren Werte in der Datenbank geändert werden sollen.

• Falsche Eingabedaten werden im Fehlermeldungsprotokoll Return gemeldet, jedoch werden die Daten trotzdem an die Datenbank gegeben. Daher muß das Fehlermeldungsprotokoll berücksichtigt und geprüft werden, um fehlerhafte Daten zu erkennen. Die fehlerhaften Zeilen müssen korrigiert und nochmals verschickt werden, damit die Daten in der Datenbank korrekt und konsistent sind.

• Bezüglich definierter und erlaubter Eingabedaten, siehe Datenelemente in den ABAP Dictionary-Strukturen BAPIBUS1195_<OBJECT>_COMmit

• PRPADM_H (für PPR-Köpfe),

• PRP_DESCR_H (für PPR-Kopf: Beschreibungen),

• PRP_ORG_H (für PPR-Kopf: Organisationsdaten),

• PRPADM_I (für PPR-Positionen),

• PRP_DESCR_I (für PPR-Positon: Beschreibungen),

• PRP_BUPA_I (für PPR-Position: Geschäftspartner),

• PRP_PROD_I (für PPR-Position: Produkte),

• PRP_TS_I (für PPR-Position: Zeitstempel)

• PRP_PAR_I (für PPR-Regelparameterdaten).

Importparameter

• Für den Parameter CheckMode, sind die Werte 'X' (= Ja oder Wahr) oder ' '(= Nein oder Falsch) möglich. Wenn dieses Kennzeichen gleich 'X' gesetzt ist, werden die Eingabedaten geprüft und enthaltene Fehler an das Fehlerprotokoll (Tabelle Return) weitergegeben; es werden jedoch keine Daten an die Datenbank weitergegeben.

• Sollen PPR-Kopf- oder Positionsdatenbeschreibungen ins System eingegeben werden, so muß die entsprechende Sprache festgelegt werden. Dies ist über den Eingabeparameter Language für einen Sprachschlüssel oder - alternativ - über den Parameter LanguageIso für den ISO-Code eines Sprachschlüssels möglich. Weiter ist die Sprache wichtig, um die Texte der Meldungen des Erfolgs-/Fehlerprotokolls Return in der gewünschten Sprache zu erhalten.

Sind beide Importparameter Languageund LanguageIso nicht festgelegt, so wird dies in einer Nachricht im Erfolgs-/Fehlermeldungsprotokoll gemeldet.

Importtabellen

HeaderData

In dieser Tabelle können die Daten der Partner-Produktauswahl auf Kopfebene eingegeben werden. Hat die angegebene PPR-Art keine interne PPR-ID Erzeugung (definiert im CRM Customizing), so muß eine PPR-ID eingegeben werden, wenn der Verarbeitungsmodus 'A'(erstellen) ist, andernfalls wird eine Meldung ausgegeben und im Fehlerprotokoll Return gespeichert . Die entsprechende Eingabezeile wird ignoriert.

Entweder muß das Feld Guidoder das Feld Handle gefüllt werden, je nach dem Wert des Feldes Processing_Mode.

Das Feld Reference_Kind muss 'A' (Kopfdaten) entsprechen.

Der PPR-Status (Strukturfeld PPR_Status) kann die Werte

• '1' (In Bearbeitung),

• '2' (Aktiv),

• '3' (Zu löschen) oder

• '4' (Zu archivieren und zu löschen) haben.

Statusänderungen sind erlaubt

• von 'In Bearbeitung' nach 'Aktiv',

• von 'In Bearbeitung' oder 'Aktiv' nach 'Zu löschen' oder 'Zu archivieren und zu löschen' und

• von 'Zu löschen' nach 'Zu archivieren und zu löschen'.

Statusänderungen sind nichterlaubt

• von 'Aktiv', 'Zu löschen' oder 'Zu archivieren und zu löschen' nach 'In Bearbeitung' ,

• von 'Zu löschen' or 'Zu archivieren' nach 'Aktiv' und

• von 'Zu archivieren und zu löschen' oder 'Zu archivieren' nach'Aktiv' .

HeaderDescriptionData

Das Feld Reference_Handle muss den Wert des Feldes Handle des anzulegenden PPR-Kopfes enthalten, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

Das Feld Reference_Guid muss den Wert des GUID des betreffenden existierenden PPR-Kopfes enthalten, wenn das Feld Processing_Mode'A' (anlegen), 'B' (ändern) oder 'D' (löschen) entspricht.

Das Feld Reference_Kind muß 'A' (Kopfdaten) entsprechen.

HeaderOrganisationalData

Das Feld Reference_Handle muß den Wert des Feldes Handle des entsprechenden, anzulegenden PPR-Kopfes enthalten, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

Das Feld Reference_Guid muß den Wert des Guids des betreffenden, existierenden PPR-Kopfes enthalten, wenn das Feld Processing_Mode 'A' (anlegen), 'B' (ändern) oder 'D' (löschen) entspricht.

Das Feld Reference_Kind muß 'A' (Kopfdaten) entsprechen.

ItemData

Das Feld Reference_Handle muß den Wert des Feldes Handle des entsprechenden, anzulegenden PPR-Kopfes enthalten, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

Das Feld Reference_Guid muß den Wert des Guid des betreffenden, existierenden PPR-Kopfes enthalten, wenn das Feld Processing_Mode 'A' (anlegen), 'B' (ändern) oder 'D' (löschen) entspricht.

Das Feld Reference_Kind muß 'A' (Kopfdaten) entsprechen.

Die möglichen und erlaubten Positionsarten ('1': 'Kombination aus Geschäftspartnern, Produkten und Zeitstempel' oder '2': 'Referenz anderer PPRs') hängen von den Customizing-Einstellungen der entsprechenden PPR-Art ab und werden in das Strukturfeld Type eingegeben.

ItemDescriptionData

Das Feld Reference_Handle muß den Wert des Feldes Handle der entsprechenden, anzulegenden PPR-Position enthalten, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

Das Feld Reference_Guid muß den Wert des Guid der betreffenden, existierenden PPR-Position enthalten, wenn das Feld Processing_Mode 'A' (anlegen), 'B' (ändern) oder 'D' (löschen) entspricht.

Das Feld Reference_Kind muß 'B' (Positionsdaten) entsprechen.

ItemBusinessPartnerData

Das Feld Reference_Handle muß den Wert des Feldes Handle der betreffenden, anzulegenden PPR-Position enthalten, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

Das Feld Reference_Guid muß den Wert des Guids der entsprechenden, existierenden PPR-Position enthalten, wenn das Feld Processing_Mode 'A' (anstellen), 'B' (ändern) or 'D' (löschen) entspricht.

Das Feld Reference_Kind muß 'B' (Positionsdaten) entsprechen.

Die möglichen Geschäftspartnerreferenzarten (z.B. '1': 'Geschäftspartner ', '2': 'Geschäftspartner-Hierarchy', '88': 'Regel', etc.) hängen von den CRM Customizing-Einstellungen der betreffenden PPR-Arten ab und werden im Strukturfeld Type eingegeben.

ItemProductData

Das Feld Reference_Handle muß den Wert des Feldes Handle der entsprechenden, anzulegenden PPR-Position enthalten, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

Das Feld Referenz_Guid muß den Wert des Guids der entsprechenden, existierenden PPR-Position enthalten, wenn das Feld Processing_Mode 'A' (anlegen), 'B' (ändern) oder 'D' (löschen) entspricht.

Das Feld Reference_Kind muß 'B' (Positionsdaten) entsprechen.

Die möglichen Produktreferenzarten (z. B. '1': 'Produkt', '2': 'Produktkategorie', '88': 'Regel', etc.) hängen von den Customizing- Einstellungen der entsprechenden PPR-Art ab und werden im Strukturfeld Type eingegeben.

ItemTimeStampData

Das Feld Reference_Handle muß den Wert des Feldes Handle der entsprechenden, anzulegenden PPR-Position enthalten, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

Das Feld Reference_Guid muß den Wert des Guids der entsprechenden, anzulegenden PPR-Position enthalten, wenn das Feld Processing_Mode'A' (anlegen), 'B' (ändern) oder 'D' (löschen) entspricht.

Das Feld Reference_Kind muß 'B' (Positionsdaten) entsprechen.

Die möglichen Zeitstempelreferenzarten (z.B. '1': 'Datum: Von / Bis', '2': 'Datum & Zeit: Von / Bis', '88': 'Regel', etc.) hängen von den CRM Customizing-Einstellungen der entsprechenden PPR-Art ab und werden im Strukturfeld Type eingegeben.

ItemRuleParameterData

Mit Hilfe dieser Tabelle können Werte für PPR-Regelparameterobjekte (Definition im CRM-Customizing) eingegeben werden.

• Wenn die Parameter zu einer PPR-Geschäftspartnerregel gehören,

• muß das Feld Reference_Handle den Wert des Feldes Handle des entsprechenden Eintrags für PPR-Position Geschäftspartner enthalten, der die anzulegende Regel definiert, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

• muß das Feld Reference_Guid den Wert des Guid des Eintrags der entsprechenden, existierenden PPR-Position Geschäftspartner enthalten, der die Regel definiert, wenn das Feld Processing_Mode 'A' (anlegen), 'B' (ändern) oder 'D' (löschen) entspricht.

• Eine Eingabezeile für die entsprechende PPR-Geschäftspartnerregel muß in der Eingabetabelle ItemBusinessPartnerData mit dem selben Wert für das Feld Processing_Mode dieser Eingabezeile enthalten sein.

• Wenn die Parameter zu einer PPR Produktregel gehören, muß

• das Feld ZH>Reference_Handle den Wert des Feldes Handle des entsprechenden Produkteintrags der PPR-Position enthalten, der die anzulegende Regel definiert, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

• das Feld Reference_Guid den Wert des Guids des Produkteintrags der entsprechenden, existierenden PPR-Position enthalten, der die Regel definiert, wenn das Feld Processing_Mode 'A', 'B' oder 'D' (löschen) entspricht.

• eine Eingabezeile für die entsprechende PPR-Produktregel in der Eingabetabelle ItemProductData mit dem gleichen Wert für das Feld Processing_Mode dieser Eingabezeile enthalten sein.

• Wenn die Parameter zu einer PPR-Zeitstempelregel gehören, so muß

• das Feld Reference_Handle den Wert des Feldes Handle des Eintrages der entsprechenden PPR-Positionszeitstempel enthalten, der die anzulegende Regel definiert, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

• das Feld Reference_Guid den Wert des Guid des Eintrags des betreffenden, existierenden PPR-Positionszeitstempels enthalten, der die Regel definiert, wenn das Feld Processing_Mode 'A' (anlegen), 'B' (ändern) oder 'D' (löschen) entspricht.

• ein Eingabefeld für die entsprechende PPR-Zeitstempelregel in der Eingabetabelle ItemTimeStampData mit dem selben Wert für das Feld Processing_Mode dieser Eingabezeile enthalten sein.

das Feld Reference_Kind 'D'(Positionsserweiterung) entsprechen.

InputFieldData

Diese Tabelle dient der Definition

• der Felder einer Eingabedatenzeile, die in die Datenbank eingegeben und vom System auf Gültigkeit und Konsistenz geprüft werden müssen, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

• der Felder einer Eingabedatenzeile, die im Hinblick auf aktuelle Werte in der Datenbank geändert/modifiziert werden und deren eingegebene Werte vom System geprüft werden müssen, wenn das Feld Processing_Mode'B' (ändern) oder 'D' (löschen) entspricht.

Eine solche Zeile der InputFieldData muß für jedes Feld eines Objekts (PRPADM_H, PRP_DESCR_H, PRP_ORG_H, PRPADM_I, PRP_DESCR_I, PRP_BUPA_I, PRP_PROD_I, PRP_TS_I und PRP_PAR_I) einer existierenden oder anzulegenden PPR-Kopfposition verfügbar sein, das angelegt/geändert werden soll.

Wenn diese Zeile nicht vom Benutzer als Eingabezeile eingegeben wird, so wird sie automatisch vom System angelegt, jedoch nur für Eingabewerte ungleich null. Wenn etwa der Wert ' ' für das Ausschlußkennzeichen auf PPR-Kopfebene eingegeben werden muß, kann das durch diese Methode nicht erkannt werden, daher muß für diesen Fall eine Eingabezeile vom Benutzer angelegt werden.

• Für die Objekte PRPADM_H, PRP_DESCR_H und PRP_ORG_H, muß

• das Feld Reference_Handle der Eingabezeile für Tabelle InputFieldData den Wert des Feldes Handle des entsprechenden, anzulegenden PPR-Kopfes enthalten, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

• das Feld Reference_Guid einer Eingabezeile der Tabelle InputFieldData den Wert des Guids des betreffenden, existierenden PPR-Kopfes enthalten, wenn das Feld Processing_Mode 'A' (anlegen), 'B' (ändern) oder 'D' (löschen) entspricht.

• Für die Objekte PRPADM_I, PRP_DESCR_I, PRP_BUPA_I, PRP_PROD_I, PRP_TS_I and PRP_PAR_I,

• muß das Feld Reference_Handle einer Eingabezeile für Tabelle InputFieldData den Wert des Feldes Handle der entsprechenden, anzulegenden PPR-Position enthalten, wenn das Feld Processing_Mode 'A' (anlegen) entspricht.

• Das Feld Reference_Guid einer Eingabezeile für Tabelle InputFieldDatamußden Wert des Guids der entsprechenden , existierenden PPR-Position enthalten, wenn das Feld Processing_Mode 'A' (anlegen), 'B' (ändern) oder 'D' (löschen) entspricht.

Das Feld Reference_Kind muß gemäß dem PPR-Objekt gefüllt werden, auf das es verweist:

• 'A' für PPR-Köpfe, Kopf-Beschreibungen und Kopf-Organisationsdaten sowie für PPR-Positionen

• 'B' für PPR-Positionen: Beschreibungen, 'Position: Geschäftspartnerdaten, Position: Produktdaten, Position: Zeitstempeldaten

• 'D' für PPR-Positionserweiterungen: Regelparameter

Das Feld Fieldname muß einen Namen im Rahmen der SAP-internen Strukturen für ein anzulegendes/zu änderndes Feld enthalten, auf das die Strukturen BAPIBUS1195_