Ansicht
Dokumentation

/ISDFPS/API_RE_IPO_CHANGE - Infrastrukturplanungsobjekt (IPO) anlegen

BAL_S_LOG - Application Log: Log header data   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Beschreibung CHANGE

Mit Hilfe des FC: /ISDFPS/API_RE_IPO_CHANGE erfolgt ein Abgleich eines im RE-FX als AO gespeicherten IPOs mit den in der Schnittstelle übergebenen Werten des FC: /ISDFPS/API_RE_IPO_CHANGE. Die übergebenen Werte müssen immer vollständig sein. Es dürfen keine Bemessungen oder Ausstattungen fehlen, es sei denn, man will sie löschen.

Die übergebenen Werte müssen konsistent sein. Die Zuordnung der Bemessungen und Ausstattungen zu den entsprechenden Stammobjekten (Mainobjekt, Subobjekt) erfolgt über den #IPO_KEY#. Bei inkonsistenten Zuordnungen kommt es zu fehlerhafter Verarbeitung.

Der in allen Schnittstellentabellen enthaltene IPO_KEY wird auf die ARCH_OBJECT_ID abgebildet.

Über diese ARCH_OBJECT_ID werden die AO im RE-FX identifiziert.

Die Bestandteile des IPOs sind einzelne AO auf maximal 3 Ebenen verteilt (Wurzel # Ebene 1 # Ebene 2)

Das einzelne AO wird mit den im RE-FX zur Verfügung stehenden BAPIs angelegt oder geändert (BAPI_RE_AO_CHANGE und BAPI_RE_AO_CREATE).

Der wichtigste Sachverhalt ist die Abbildung des IPO_KEYs auf die ARCH_OBJECT_ID. Diese wird immer maschinell vorgenommen, da die ARCH_OBJEKT_ID nicht Bestandteil irgendwelcher Schnittstellen ist.

Wurzel: Kürzel AOID: AAAAAAAA Zeichenfolge von maximal 8 Stellen

Ebene 1 Gebäude: Kürzel AOID: AAAAAAAA/IBxxxxyyyy,,

--> Zuordnung zum IPO_KEY: MOBART = IB, MOBFCT = xxxx, MOBCNT = yyyy,,

Ebene 1 Grundstück: Kürzel AOID: AAAAAAAA/IGxxxxyyyy,,

--> Zuordnung zum IPO_KEY: MOBART = IG, MOBFCT = xxxx, MOBCNT = yyyy,,

Ebene 2 Gebäude: Kürzel AOID: AAAAAAAA/IBxxxxyyyy-IRssssvvvv,,

--> Zuordnung zum IPO_KEY: MOBART = IB, MOBFCT = xxxx, MOBCNT = yyyy

SOBART = IR, SOBFCT = ssss, SOBCNT = vvvv,,

Ebene 2 Grundstück: Kürzel AOID: AAAAAAAA/IGxxxxyyyy,,-ISssssvvvv

--> Zuordnung zum IPO_KEY: MOBART = IG, MOBFCT = xxxx, MOBCNT = yyyy,,

SOBART = IS, SOBFCT = ssss, SOBCNT = vvvv,,

Bei den angelegten Objekten ist die AOID nicht mehr änderbar.

Anmerkungen:

Ändert man ein IPO über die Transaktion RE80 und fügt in einer Ebene1 oder 2 ein Gebäude / Grundstück / Raum oder Fläche hinzu und beachtet obige Bildungsregel nicht, dann wird beim CHANGE dieses Objekt nicht gefunden. Ist es nicht Bestandteil der übergebenen Daten, dann kann es nicht gelöscht werden. Ist es Bestandteil der übergebenen Daten, dann wird es neu angelegt.

Ändert sich in den übergebenen Daten das Feld MOBFCT oder SOBFCT von 1 auf 2, dann bewirkt dies das Löschen des Teilbaumes mit dem Bezug auf FCT = 2 und das Neuanlegen eines Telbaumes mit dem Bezug auf FCT = 3.

Bemessungen:

Bemessungen können im Customizing als Summenbemessungen ausgesteuert werden. Dies bewirkt aus der Sicht der Transaktion zur Bearbeitung eines AOs, das diese Bemessungen automatisch hinzugefügt werden. Sie übernehmen dann den summierten Wert ihrer zugeordneten primären Bemessungen.

Sind nun solche Bemessungen Bestandteil der Schnittstellendaten (it_ipo_mainobj_meas oder it_ipo_subobj_meas), so wird der Status dieser Bemessung automatisch auf #manuell# gesetzt und der mitgeliefert Wert (Größe) wird ebenfalls übernommen. Die Summiereigenschaft einer Summenbemessung geht hiermit verloren.

Ausstattungen:

Wie bei Bemessungen können auch Ausstattungen automatisch erzeugt werden. Solche Ausstattungen werden im Customizing mit der Eigenschaft #vorblenden# versehen. Legt man ein AO mit der Transaktion an. Dann sind diese Ausstattungen immer schon vorhanden. Sie können auch nicht gelöscht werden, da sie sofort wieder erzeugt würden.

Bei der Durchführung des CHANGE wird nun wie folgt verfahren:

Sind solche vorgeblendeten Ausstattungen in den Schnittstellendaten (it_ipo_mainobj_char oder it_ipo_subobj_char) enthalten, dann werden sie vor dem Aufruf des BAPI_RE_AO_CREATE gelöscht. Würde man sie nicht löschen, käme es zu einer Überlappung der Zeiträume.

Der API_RE_IPO_CHANGE ist konzipiert, um Daten aus einem Fremdsystem zu übernehmen und abzugleichen. Über entsprechende Abbildungen werden AOs angelegt. Diese generierten AOs dürfen nur eingeschränkt mit der RE80 oder REBDAO verändert werden.

Geändert werden können folgende Felder: #Bez. Archit. Objekt#, #Kurzbezeichnung#,

Bemessungen können hinzufügen oder löschen werden,

Ausstattungen können hinzufügen oder löschen werden.

Im Groben werden folgende Schritte im Programm ausgeführt:

1. Lesen aller Daten zum im RE-FX gespeicherten IPO mit FC: /ISDFPS/API_RE_IPO_DETAIL_GET (Tab READ).

Im Ergebnis stehen alle Daten zum IPO in gleicher Struktur zur Verfügung wie die Eingabedaten des FC: /ISDFPS/API_RE_IPO_CHANGE (Tab IN).

2. Abgleich der jeweiligen Tabellen und Erstellung einer Differenztabelle (Tab CH).

Folgende Fälle sind möglich:

Eintrag in (Tab IN) ist enthalten in (Tab READ), keine Differenzen bei den Wertfeldern --> keine Aktion

Eintrag in (Tab IN) ist enthalten in (Tab READ), Differenzen bei den Wertfeldern --> Eintag aus (Tab IN) wird mit Kennzeichen U = Update nach (Tab CH) übernommen.

Eintrag in (Tab IN) ist NICHT enthalten in (Tab READ) --> Eintrag aus (Tab IN) mit Kennzeichen I = Insert nach Tab CH übernommen

Eintrag in (Tab READ) ist NICHT enthalten in (Tab IN) --> Eintrag aus (Tab IN) mit Kennzeichen D = Delete nach Tab CH übernommen

3. Erstellung der Schnittstellendaten für die BAPI_RE_AO_... aus den Tabellen (Tab CH). Diese enthalten bereits die notwendigen Abgleichkennzeichen I, U, D.

4. Ausführung der BAPI_RE_AO_...

5. Alle Meldungen, die bei der Abarbeitung der BAPI_RE_AO_... in der Tabelle LT_RETURN bereitgestellt werden, werden gesammelt und beim Verlassen des /ISDFPS/API_RE_IPO_CHANGE nach oben übergeben.

Beispiel

Hinweise

Weiterführende Informationen

Parameter

ET_RETURN
ID_FUNCTION_ROOT
ID_OBJECT_ID_ROOT
ID_SHORT_TEXT_ROOT
ID_TEXT_ROOT
IT_IPO_MAINOBJ
IT_IPO_MAINOBJ_CHAR
IT_IPO_MAINOBJ_MEAS
IT_IPO_SUBOBJ
IT_IPO_SUBOBJ_CHAR
IT_IPO_SUBOBJ_MEAS
TEST_RUN

Ausnahmen

EX_ERROR
EX_NO_OBJECT_ID_FOUND
EX_OBJECT_ID_ROOT_EXIST
EX_OBJECT_ID_ROOT_NOT_EXIST

Funktionsgruppe

FPS/SAPLREBD_API_IPO

General Material Data   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 7703 Date: 20240419 Time: 185201     sap01-206 ( 110 ms )