Ansicht
Dokumentation
/SAPAPO/OM_ORDER_MODIFY - Ändern von Auftragsattributen
CL_GUI_FRONTEND_SERVICES - Frontend Services Vendor Master (General Section)Diese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Dieser Funktionsbaustein erlaubt Änderungen an Aufträgen, die im liveCache bereits vorhanden sind. Es können nur solche Änderung vorgenommen werden, für die keine Neuterminierung des Auftragsnetzes durch den liveCache-Scheduler erforderlich sind.
Der ORDER_MODIFY bearbeitet grundsätzlich keine Bestandsaufträge (Stock Orders) und SPP-Aufträge (Spare Parts Planning).
Die Aufgaben des ORDER_MODIFY lassen sich im wesentlichen in drei Kategorien einteilen:
- Rückmelden von Aktivitäten
- Ändern von Auftragseigenschaften
- Hinzufügen oder Löschen von I/O-Knoten
1. Rückmelden von Aktivitäten
Die in der Importtabelle IT_ACT aufgelisteten Aktivitäten werden mit den angegebenen Zeiten im liveCache rückgemeldet.
2. Ändern von Auftragseigenschaften
Über die Tabellen IT_ORDER, IT_MODE, IT_CAPREQ, IT_INPUT, IT_OUTPUT und IT_ORDKEY können Attribute eines Auftrags im liveCache geändert werden. Dies ist i.d.R. nur für solche Auftragsattribute möglich, die auf die im liveCache programmierte Anwendungslogik des APO (Scheduler, Pegging) keinen Einfluß haben, also Felder, die nur im liveCache gespeichert und unverändert wieder ausgelesen werden sollen.
Die oben genannten Änderungstabellen ("Attributstabellen") haben den Zeilentyp
- Schlüsselfelder des Objekts
- Neue Feldwerte (Komponenten NEW_
, wobei der Name einer Komponente des liveCache-Objektes ist)
- Zugehörige Änderungsmethoden (Komponenten CHANGE_
)
Siehe Beispiel unten.
Gültige Änderungsmethoden sind beim ORDER_MODIFY:
- gc_do_nothing (initial): Das Attribut soll nicht geändert werden.
- gc_change: Das Attribut soll auf den in der zugehörigen Komponente NEW_
angegebenen Wert geändert werden
- gc_add (nur für Mengenfelder am I/O-Knoten): Die angegebene Menge soll auf die vorhandene Menge addiert werden
Die über die IT_ORDKEY übergebenen ORDKEY-Datensätze werden im liveCache per SQL auf die angegebenen Werte geändert. Achtung: Die ORDKEY-Datensätze werden nur für diejenigen Aufträge geändert, für die auch ein Datensatz in der Änderungstabelle IT_ORDER vorhanden ist. Soll für einen Auftrag nur ein ORDKEY-Datensatz geändert werden, muß in der IT_ORDER ein Eintrag mit der GUID des Auftrags erstellt werden, in dem alle Änderungsmethoden und neuen Feldwerte initial bleiben müssen.
3. Hinzufügen oder Löschen von I/O-Knoten
Die in den Tabellen IT_NEW_INPUTS und IT_NEW_OUTPUTS enthaltenen I/O-Knoten werden zu einem Auftrag hinzugefügt, etwaige zugehörige Merkmale können über die Tabellen IT_CHARACT_REQS und IT_CHARACT_VALS angegeben werden.
Seit APO 4.1 können mit dem ORDER_MODIFY auch vorhandene I/O-Knoten gelöscht werden. Zu diesem Zweck muß ein "Löschsatz" in der Attributstabelle IT_INPUTS oder IT_OUTPUTS erstellt werden, in dem der Schlüssel des zu löschenden Input- oder Output-Knotens angegeben wird sowie die Methode gc_delete.
I/O-Knoten von Lieferplaneinteilungen können nicht gelöscht werden.
Exporttabellen
ET_CHANGED_ORDERS: GUIDs der Aufträge, die durch den ORDER_MODIFY geändert wurden
ET_DELETED_FIX_PEGGING: Fixierte Peggingkanten, die durch das Löschen von I/O-Knoten oder das Ändern der I/O-Knoten-Mengen gelöscht wurden
Beispiel
Um das Attribut PRIORITY eines Auftrags zu ändern, muß folgender Änderungssatz in die IT_ORDER geschrieben werden:
- ORDERID = GUID des zu ändernden Auftrags
- NEW_PRIORITY = Neuer Wert für das Attribut PRIORITY
- CHANGE_PRIORITY = gc_change (PRIORITY soll geändert werden)
Hinweise
Der ORDER_MODIFY verarbeitet alle vorzunehmenden Änderungen nach der Toporder des zu ändernden Objektes. Tritt ein Fehler auf, werden alle Änderungen für Objekte des betroffenen Toporders zurückgerollt und die Verarbeitung mit der nächsten Toporder fortgesetzt. Die am häufigsten auftretenden Fehler sind:
34 = om_invalid_method: Ungültige Methode, gültig sind nur die oben aufgelisteten Methoden
40 = om_invalid_order: Ein Auftrag mit der angegebenen GUID existiert im liveCache nicht
129: Bestandsaufträge dürfen nicht mit ORDER_MODIFY geändert werden
200 = om_not_yet_implemented: Die Änderung eines Attributs ist im liveCache noch nicht implementiert.
266 = om_order_is_already_confirmed: Das Objekt, dessen Attribute geändert werden sollen, gehört zu einem Auftrag, der bereits rückgemeldet ist. Um seine Attribute trotzdem zu ändern, muß als Methode gc_change_actual, gc_add_actual oder gc_delete_actual angegeben werden (Achtung: Die Änderung von Attributen an rückgemeldeten Aufträgen kann zu unerwünschten Seiteneffekten führen, solche Änderungen sollten nur von erfahrenen und befugten Personen vorgenommen werden).
342 = om_spp_not_allowed: SPP-Aufträge dürfen nicht mit ORDER_MODIFY geändert werden.
Weiterführende Informationen
Parameter
ET_CHANGED_ORDERSET_DELETED_FIX_PEGGING
ET_RC
IS_ATP_INFO
IS_GEN_PARAMS
IT_ACT
IT_CAPREQ
IT_CHARACT_REQS
IT_CHARACT_VALS
IT_INPUTS
IT_MODE
IT_NEW_INPUTS
IT_NEW_OUTPUTS
IT_ORDERS
IT_ORDKEY
IT_OUTPUTS
IT_POSITIONS
IV_SIMSESSION
IV_USE_IO_SHLF_LIFE
Ausnahmen
LC_APPL_ERRORLC_COM_ERROR
LC_CONNECT_FAILED
Funktionsgruppe
APO/SAPLOM_PLANNINGBAL_S_LOG - Application Log: Log header data rdisp/max_wprun_time - Maximum work process run time
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 8433 Date: 20240425 Time: 113130 sap01-206 ( 119 ms )
