Ansicht
Dokumentation

/ISDFPS/API_RE_IPO_CREATE - Infrastrukturplanungsobjekt (IPO) anlegen

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Mit Hilfe des FC: /ISDFPS/API_RE_IPO_CREATE erfolgt das Anlegen eines IPOs mit den in der Schnittstelle übergebenen Werten des FC: /ISDFPS/API_RE_IPO_CREATE. Die übergebenen Werte müssen immer vollständig sein.

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 später 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 BAPI angelegt (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.

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 CREATE 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_CREATE ist konzipiert, um Daten aus einem Fremdsystem zu übernehmen. Ü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. Erstellung der Schnittstellendaten für die BAPI_RE_AO_... aus den Tabellen übergebenen Schnittstellendaten.

2. Ausführung der BAPI_RE_AO_...

3. 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_CREATE 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

Funktionsgruppe

FPS/SAPLREBD_API_IPO

General Material Data   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5608 Date: 20240419 Time: 221921     sap01-206 ( 85 ms )