Ansicht
Dokumentation

CRM_AV_CHECK_R3_DO_CHECK - CRM Verfügbarkeitsprüfung im APO durchführen

PERFORM Short Reference   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Baustein dient der Verfügbarkeitsprüfung in einem SAP-APO-System (globale Verfügbarkeitsprüfung). Seitens des APO-Systems wird ein Baustein zur Verfügbarkeitsprüfung angeboten, der eine komplexe Schnittstelle besitzt. Mittels des hier dokumentierten Bausteins wird nun von dieser Komplexität abstrahiert, so dass je Position nur das Material und die zu einem Wunschtermin gewollten Mengen übergeben werden müssen. Als Ergebnis erhält man sogenannte Bestätigungen. Diese sind Termine und Mengen, zu denen aus Sicht des APO-Systems die Produktanforderung erfüllt werden kann. Die gesamte APO-Anbindung zerfällt in diverse einzelne Funktionalitäten, die in sich abgeschlossen sind. Die wichtigsten Teile sind:

• CRM_AV_CHECK_APO_ON_OFF: Ein-/Ausschalten der APO-ATP

Hiermit kann in Abhängigkeit von äusseren Bedingungen (Customizing) die ATP-Prüfung im APO zentral eingeschaltet oder ausgeschaltet werden. Ist die ATP-Prüfung ausgeschaltet, erfolgt kein RFC zum APO-System.

• CRM_AV_CHECK_APO_ACTIVE: Prüfung, ob APO-ATP eingeschaltet ist

Fast alle Bausteine der ATP-Prüfung werden nur dann durchlaufen, wenn die ATP-Prüfung eingeschaltet ist. Dieser Baustein liefert den entsprechenden Dienst.

• CRM_AV_CHECK_APO_GET_DESTIN: CRM APO RFC-Destination ermitteln

Dieser Baustein liefert die physische Destination des betreffenden APO-Systems zurück. Sie ist Vorbedingung für die Initialisierung des APO-Systems.

• CRM_AV_CHECK_APO_GET_TECH_PARM: CRM Technische Parameter für APO-Aufruf ermitteln

Das APO-System benötigt einige technische Angaben, wie z.B. die Destination des rufenden Systems. Dieser Baustein ermittelt die notwendigen Angaben, die auch wiederum eine Vorbedingung für die Initialisierung des APO-Systems sind.

• CRM_AV_CHECK_APO_INIT: Initialisierung des APO-Systems

Bevor mit dem APO-System kommuniziert werden kann, muss dieses initialisiert werden. Dieser Baustein verwendet die beiden zuvor genannten Bausteine, um die technischen Einzelheiten zu ermitteln und ruft das APO-System ohne Daten auf. Das ist notwendig, damit festgestellt werden kann, ob und wenn ja mit welcher Komprimierung die künftige Datenübertragung erfolgen kann. Diese kann von der Anwendung zwar nicht beeinflusst werden, aber dieser leere Aufruf bringt einen Performancegewinn, wenn die Datenübertragung komprimiert erfolgt.

• CRM_AV_CHECK_APO_GUID_CONVERT: Konvertieren von GUIDs für Anbindung zum APO-System

Solange das APO-System 22-stellige GUIDs verwendet, müssen die 32-stelligen GUIDs in CRM Online in 22-stellige GUIDs konvertiert werden. Dieser Baustein wird ab einem bestimmten APO-Release nicht mehr erforderlich sein, aber im CRM Online aus Kompatibilitätsgründen verbleiben.

• CRM_ATP_TO_R3_CONVERT_FIELDCAT: Konvertierung von CRM-Begriffen in R/3-Begriffe für KOMGO

Einige Angaben, die das APO-System braucht, können von CRM Online nicht direkt zur Verfügung gestellt werden. Insbesondere zur Lokationsfindung werden die Techniken der regelbasierten ATP-Prüfung benutzt. Die zu definierten Regeln beziehen sich auf die Begriffe des Feldkatalogs. Zur Regeldefinition sind wiederum Konditionen zu definieren. Die Konditionen sind abhängig von Daten wie z.B. Organisationsdaten. Da das APO-System keine CRM-Begriffe kennt, müssen die CRM-Begriffe auf R/3-Begriffe abgebildet werden. Die Tabelle /SAPAPO/KOMGO ist eine Tabelle im APO-System, die die Menge der im APO-System bekannten R/3-Begriffe beschreibt.

• CRM_AV_CHECK_APO_DO_CHECK: CRM-Verfügbarkeitsprüfung im APO-System durchführen

Dieser Baustein führt die eigentliche Verfügbarkeitsprüfung im Sinne einer Gruppenprüfung durch. Details sind weiter unten beschrieben.

• CRM_AV_CHECK_APO_DELTA: APO Deltasätze persistent machen oder verwerfen

Mit diesem Baustein wird dem APO-System folgendes mitgeteilt:

• Wenn der Verkaufsvorgang gesichert wird, dann sollen im APO-System die temporäre Objekte als Bedarfe gesichert werden.

• Wenn der Verkaufsvorgang nicht gesichert wird (d.h. der Benutzer verlässt den Verkaufsvorgang mit PF3, PF4 oder PF12), dann sollen im APO-System die in der laufenden LUW entstandenen temporäre Objekte verworfen werden.

• CRM_AV_CHECK_APO_DELETE_REQ: Löschen von Positionen in Bedarfen

Auf Positionsebene lassen sich die zugehörigen Deltasätze im APO-System löschen.

Vorbedingung:

• Die Produkte müssen im APO-System bekannt sein.

• Es müssen geeignete Organisationsdaten vorliegen (sonst wird keine Lokation gefunden).

Nachbedingung:

• Bestätigungstermine und Mengen oder Ausnahme

Input

• IV_KIND_OF_MSG

Hier wird hinterlegt, ob der Rufer ein Fehlerprotokoll erhalten soll, und falls ja, in welchem Umfang (s. Domänenbeschreibung/Werte). Das Fehlerprotokoll selbst besteht aus einer oder zwei Tabellen, die leer mit übergeben werden müssen, wenn ein Fehlerprotokoll gewünscht wird.

• IV_TEXT_FORMAT

Hier wird hinterlegt, in welchem Textformat (z.B. RTF) der Rufer das Fehlerprotokoll erhalten möchte. Die möglichen Ausprägungen sind in der zugehörigen Domäne (Werte) beschrieben.

• IT_HEADER

Hier wird die Header-GUID und ein Klartext-Identifikator des Beleges des Aufrufers mitgegeben. Für spätere Mehrbelegfähigkeit vorgesehen.

• IT_FIELDCAT

Hier werden ein feststehender Begriff sowie drei mögliche Parameter mitgegeben. Der feststehende Begriff definiert, welcher CRM-Begriff auf welchen R/3-Begriff abgebildet werden soll. Die Parameter enthalten die aktuellen Werte des Geschäftsvorgangs in CRM Online. Derzeit werden nur Organisationsdaten unterstützt. Die feststehenden Begriffe sind (derzeit) hart codiert (vgl. CRM_AV_CHECK_CONVERT_FIELDCAT). Der Begriff ist unter RULE_ID mitzugeben. Der Index ist vorgesehen, falls es zu einem Begriff mehr als vier Parameter gibt.

• IT_ITEM

Hier werden Positionsdaten mitgegeben. Unter ATP_PROFILE muss das relevante Profile mitgegeben werden.

• ACTIVITY_TYP: H=Hinzufügen, V=Ändern, D=Löschen

• PART_DLV: X oder A=Liefervorschlag, B=Volllieferung
  (bestätige alles oder nichts zum gewünschten Termin)

• IT_SCHEDLIN

Zu einer Position werden die gewünschten Mengen zu gewünschten Terminen mitgegeben.

Output

• ET_HEADER

Bezug zum Header.

Unter APO_TR_GUID wird eine APO-Transaktions-GUID zurückgegeben, mit der Rückbezüge zum APO-System hergestellt werden (z.B. Deltasätze persistent machen).

• ET_ITEM

Zu einer Position werden noch Steuerlokationsdaten zurückgegeben.

• ET_SCHEDLIN

Hier werden die Bestätigungseinteilungen zurückgegeben. Der Bezug zur betreffenden Wunscheinteilung ist über die PARENT_SDLN_GUID hergestellt.

Changing

• ET_MSG_SHORTTYPE

Tabelle für die Kurztexte für die Fehlermeldungen.

• ET_MSG_LONGTYPE

Tabelle für die Langtexte der Fehlermeldungen.

Hinweis: Wird das Fehlerprotokoll in vollständigem Umfang gewünscht, dann müssen beide Tabellen deklariert werden. Sind nur die Kurztexte gewünscht, dann genügt die Deklaration der ersten Tabelle.

Ausnahmen

1. APO_SYSTEM_FAILURE

Entspricht BAPI_APOATP_CHECK Exit System_failure beim initialen Aufruf ohne Daten. Deltasätze sind konsistent, daher sind keine Folgeaktivitäten erforderlich (vgl. Nr. 5).

Semantik: Zielsystem nicht gefunden.

1. APO_NOT_AVAILABLE

Entspricht BAPI_APOATP_CHECK communication_failure beim initialen Aufruf ohne Daten.

Semantik: RFC-Verbindung konnte nicht hergestellt werden, Partner nicht erreicht.

1. APO_GET_TECHNICAL_PARMS

Kommt aus CRM_AV_GET_TECHNICAL_PARM

Semantik: Die über Customizing vorgegebenen technischen Parameter wie z.B. log. System konnte nicht gefunden werden.

1. APO-GUID_CONVERT_ERROR

Kommt aus CRM_AV_CHECK_APO_GUID_CONVERT

Semantik: Die 16-stellige CRM-Raw GUID konnte nicht in eine 22-stellige APO-GUID umgewandelt werden. Diesen Fehler kann es nur geben, solange im APO-System 22-stellige GUIDs verwendet werden.

1. APO_SYSTEM_ERROR

Kommt aus BAPI_APOATP_CHECK System_failure während einer aktiven ATP-Prüfung.

Semantik: Das APO-System konnte zwar erreicht werden und eine ATP-Prüfung wurde angefangen. Es hat einen Abbruch mit/ohne Dump etc. gegeben oder der APO-Server ist hart heruntergefahren worden bzw. steht nicht zur Verfügung. Es können bereits (pre-)persistente Deltasätze vorhanden sein, so dass Inkonsistenzen vorhanden sein können.

1. APO_COMMUNICATION_ERROR

Kommt aus BAPI_APOATP_CHECK Exit SYSTEM_FAILURE während eines ATP-Aufrufs mit Daten

Semantik: Die Kommunikation zum APO-System konnte nicht aufgebaut werden, nachdem der initiale Aufruf bereits fehlerfrei erfolgte. Der APO-System steht offenbar nicht zur Verfügung. Dateninkonsistenzen bei Deltasätzen möglich.

1. APO_UNDEF_ERROR

Kommt aus BAPI_APOATP_CHECK Exit OTHERS während einer aktiven ATP-Prüfung

Semantik: Es ist im APO-System ein Fehler aufgetreten, der keinem speziellen RC zugeordnet werden kann. Das ist nur durch Debugging im APO-System zu klären.

1. APO_APPL_PROBLEM

Semantik: Die APO-ATP-Business-Logik hat ein Problem erkannt und die Msg-ID, die Meldungsnr. und den Kurztext an den CRM_AV_APO_DO_CHECK zurückgemeldet.

Achtung Falle: Falls der LiveCache nicht zur Verfügung steht, dann wird ebenfalls ein Business-Logik-Fehler gemeldet.

1. CRM_APO_CONVERT

Kommt aus CRM_AV_CHECK_CONVERT_FIELDCAT.

Semantik: Der Konvertierungsbaustein wurde entweder mit einer nicht dort definierten Regel aufgerufen oder ein CRM-Begriff hat kein entsprechendes R/3-Pendant und konnte daher nicht gemappt werden.

Beispiel

Hinweise

Weiterführende Informationen

Weitere Informationen zum Customizing im SAP APO finden Sie im Einführungsleitfaden des SAP-APO-Systems unter SAP Advanced Planner and Optimizer (SAP APO) -> Globale Verfügbarkeitsprüfung (Globale ATP-Prüfung).

Weitere Informationen zu Einstellungen der Verfügbarkeitsprüfung finden Sie in der SAP-Bibliothek unter SAP Advanced Planner and Optimizer (SAP APO) -> Globale Verfügbarkeitsprüfung (Globale ATP) -> Einstellungen der Globalen ATP).

Parameter

ET_HEADER
ET_ITEM
ET_ITEM_EXTENSION
ET_MSG_LONGTYPE
ET_MSG_SHORTTYPE
ET_REQ_SCHEDLIN_DATE
ET_SCHEDLIN
ET_SUBITEM
ET_SUBITEM_SCHEDLIN
IS_LOGICAL_SWITCH
IT_CFGS_BLOB
IT_CFGS_INST
IT_CFGS_PART_OF
IT_CFGS_REF
IT_CFGS_VALUE
IT_CFGS_VK
IT_FIELDCAT
IT_HEADER
IT_ITEM
IT_SCHEDLIN
IT_SELECTIONDATA
IT_SELECTIONHEAD
IV_KIND_OF_MSG
IV_LINKMASK
IV_LOG
IV_ONLY_SCHEDULING
IV_TEXT_FORMAT

Ausnahmen

APPL_PROBLEM
COMMUNICATION_ERROR
CRM_POS_NO_OVERFLOW
GET_TECHNICAL_PARMS
GUID_CONVERT_ERROR
INVALID_SCENARIO
NOT_AVAILABLE
NOT_CONFIRMED
PROFILE
SYSTEM_ERROR
UNDEFINED_RELEASE
UNDEF_ERROR

Funktionsgruppe

CRM_AV_CHECK_R3

ROGBILLS - Synchronize billing plans   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 14124 Date: 20240523 Time: 125338     sap01-206 ( 212 ms )