Ansicht
Dokumentation

/SAPAPO/OM_ORDER_GET - Orders auslesen zu Aktivitäten, Ressourcen, Pegging Areas

/SAPAPO/OM_ORDER_GET - Orders auslesen zu Aktivitäten, Ressourcen, Pegging Areas

ROGBILLS - Synchronize billing plans   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Zu den Ressourcenkeys (UIDs) in IT_RES, den Aktivitäts-Keys (UIDs) in IT_ACT und den Pegging Area Keys (UIDs) in IT_PEGAREA werden in ET_ORDER die zugehörigen Orders ausgegeben. Dabei werden nur solche Orders berücksichtigt, die zu Aktivitäten gehören, die mit dem Zeitintervall [IV_START_TIME, IV_END_TIME] überlappen.

  • Ein Order gilt hierbei als zu einer Ressource zugehörig, wenn er eine Aktivität besitzt, die auf dieser Ressource eingeplant ist. Der Parameter IV_ACT_PLANNED_STATUS_SEL gestattet hierbei die Einschränkung anhand des Planungsstatus der Aktivitäten:
Falls IV_ACT_PLANNED_STATUS_SEL = GC_PLANNED_ONLY, werden nur eingeplante Aktivitäten berücksichtigt.
  • Falls IV_ACT_PLANNED_STATUS_SEL = GC_UNPLANNED_ONLY, werden nur nicht eingeplante Aktivitäten berücksichtigt.

  • Falls IV_ACT_PLANNED_STATUS_SEL = GC_PLAN_STAT_ALL, werden keine Einschränkungen anhand des Planungsstatus vorgenommen.

  • Ein Order gilt hierbei als zu einer Pegging Area zugehörig, wenn er einen I/O-Knoten innerhalb des Zeitintervalls [IV_START_TIME, IV_END_TIME[ besitzt, der zu dieser Pegging Area gehört. Der Parameter IV_PEGAREA_SEL steuert dabei, welche Input/Output-Knoten bei dieser Selektion berücksichtigt werden sollen:
  • Falls IV_PEGAREA_SEL=GC_NO_IO, werden keine I/O-Knoten berücksichtigt, d.h. es werden auch keine Orders selektiert.

  • Falls IV_PEGAREA_SEL=GC_ALL_IO, werden alle I/O-Knoten (Inputs und Outputs) berücksichtigt.

  • Falls IV_PEGAREA_SEL=GC_INPUTS_ONLY, werden nur Inputknoten berücksichtigt.

  • Falls IV_PEGAREA_SEL=GC_OUTPUTS_ONLY, werden nur Outputknoten berücksichtigt.

  • Falls IV_PEGAREA_SEL=GC_MASTER_OUTPUTS_ONLY, werden nur Masteroutputknoten berücksichtigt.

  • Ein Order gilt hierbei als zu einer Aktivität gehörig, wenn die Aktivität Teil dieses Orders ist.

Anhand der in den Tabellen IT_CHARACT_REQ_OUTNODE und IT_CHARACT_VAL_INPNODE optional übergebenen Merkmalsselektionen für Output- bzw. Input-Knoten kann die Menge der über die Pegging Areas selektierten I/O-Knoten und damit der über die Pegging-Areas selektierten Aufträge weiter eingeschränkt werden.

Der Parameter IV_ACT_PLANNING_TYPE_SEL gestattet global die Einschränkung anhand der Planungsart der Aufträge:

  • Falls IV_ACT_PLANNING_TYPE_SEL = GC_PLANNING_TYPE_SNP_ONLY, werden nur Aufträge selektiert, die von SNP aufgelöst wurden.
  • Falls IV_ACT_PLANNING_TYPE_SEL = GC_PLANNING_TYPE_PPDS_ONLY, werden nur Aufträge selektiert, die von PP/DS aufgelöst wurden.
  • Falls IV_ACT_PLANNING_TYPE_SEL = GC_PLANNING_TYPE_ALL, werden keine Einschränkungen anhand der Auflösung vorgenommen.

Falls IV_GET_ALL_PEG_DEPENDANTS = 'X', werden alle Aufträge, die direkt über Pegging-Beziehungen mit den zunächst selektierten Aufträgen zusammenhängen, ebenfalls in ET_ORDER ausgegeben.

Der Parameter IV_IO_SEL steuert, inwieweit in der Tabelle ET_IO Informationen zu den mit den Aufträgen in IT_ORDER verbundenen Input/Output-Knoten zurückgegeben werden sollen:

  • Falls IV_IO_SEL=GC_NO_IO, werden keine I/O-Knoten-Infos in ET_IO geliefert.
  • Falls IV_IO_SEL=GC_ALL_IO, werden alle I/O-Knoten zu den Aufträgen geliefert.
  • Falls IV_IO_SEL=GC_INPUTS_ONLY, werden nur Inputknoten geliefert.
  • Falls IV_IO_SEL=GC_OUTPUTS_ONLY, werden nur Outputknoten geliefert.
  • Falls IV_IO_SEL=GC_MASTER_OUTPUTS_ONLY, werden nur Masteroutputknoten geliefert.

Der Parameter IV_CONSTR_SELECTION steuert, inwieweit in der Tabelle ET_CONSTR Informationen zu Constraints zwischen den Aktivitäten zurückgegeben werden sollen:

  • Falls IV_CONSTR_SELECTION = 0, werden keine Constraint-Infos in ET_CONSTR geliefert.
  • Falls IV_CONSTR_SELECTION = 1, werden nur Constraints zwischen Aktivitäten, deren Aufträge beide in IT_ORDER enthalten sind, in ET_CONSTR geliefert.
  • Falls IV_CONSTR_SELECTION = 2, werden alle Constraints in ET_CONSTR ausgegeben, von denen mindestens eine Aktivität zu einem Auftrag gehört, der in IT_ORDER enthalten ist.

Der Parameter IV_PEG_SELECTION steuert, inwieweit in der Tabelle ET_PEG Informationen zu Peggingbeziehungen zwischen den Aktivitäten zurückgegeben werden sollen:

  • Falls IV_PEG_SELECTION = 0, werden keine Peggings-Infos in ET_PEG geliefert.
  • Falls IV_PEG_SELECTION = 1, werden nur Pegging-Beziehungen zwischen Aktivitäten, deren Aufträge beide in IT_ORDER enthalten sind, in ET_PEG geliefert.
  • Falls IV_PEG_SELECTION = 2, werden alle Pegging-Beziehungen in ET_PEG ausgegeben, von denen mindestens ein Auftrag in IT_ORDER enthalten ist.

Der Parameter IV_ORDER_TYPE steuert, ob nur Aufträge eines bestimmten dort angegebenen Typs berücksichtigt werden sollen. Wenn IV_ORDER_TYPE leer (initial) ist, wird keine Filterung auf bestimmte Ordertypen durchgeführt.

Der Parameter IV_GET_SUBORDERS steuert, ob sich die gesamte Orderselektion (und damit auch die Bestimmung der abhängigen Objekte wie z.B. der I/O-Knoten, Constraints, Peggingbeziehungen etc.) nur auf die Suborderebene beziehen soll:

  • Falls IV_GET_SUBORDERS = GC_FALSE, bezieht sich die Selektion der Orders und der abhängigen Objekte jeweils auf die Toporders.
  • Falls IV_GET_SUBORDERS = GC_TRUE, bezieht sich die Selektion der Orders und der abhängigen Objekte nicht unbedingt auf die Toporderebene, sondern auf die Suborderebene (sofern es überhaupt Suborders gibt). Wenn es allerdings in einem betroffenen Auftrag gar keine Suborderebene gibt, bezieht sich alles natürlich auf die einzig vorhandene (Toporder-)Ebene.

Mit dem Parameter IV_PPM_ACT_GUID läßt sich die Selektion der Orders und der ggf. zu bestimmenden abhängigen Objekte wie z.B. der I/O-Knoten, Constraints, Peggingbeziehungen etc. auf Aktivitäten mit der angegebenen PPM_ACT_GUID einschränken, sofern IV_PPM_ACT_GUID nicht initial ist. Dies bedeutet, daß dann nur Orders selektiert werden, die mindestens eine Aktivität enthalten, bei der PPM_ACT_GUID = IV_PPM_ACT_GUID ist. Außerdem werden nur solche abhängigen Objekte (z.B. I/O-Knoten, Constraints, Peggingbeziehungen etc.) geliefert, die direkt zu Aktivitäten mit der passenden PPM_ACT_GUID gehören.
Beispiel: Ein Order besitzt mehrere Aktivitäten, von denen nur eine die passende PPM_ACT_GUID = IV_PPM_ACT_GUID aufweist. Falls gemäß IV_IO_SEL auch die zugehörigen I/O-Knoten geliefert werden sollen, werden nur die I/O-Knoten der einen Aktivität mit der passenden PPM_ACT_GUID geliefert; die I/O-Knoten der übrigen Aktivitäten werden nicht nach ET_IO übertragen. Das gleiche gilt für die Peggingbeziehungen und die Constraints.
Wenn IV_PPM_ACT_GUID initial ist, wird keine Filterung bzgl. der PPM_ACT_GUID der Aktivitäten durchgeführt.

In ET_RC werden für solche Objekte, für die Fehler bei der Verarbeitung festgestellt wurden, jeweils eigene Fehlercodes zurückgeliefert.

Beispiel

Hinweise

Abzufragende Return-Codes (siehe Tabelle ET_RC):

  • om_invalid_resource: Ungültige Ressource
  • om_invalid_activity: Ungültige Aktivität
  • om_invalid_pegarea: Ungültige Pegarea

Weiterführende Informationen





Parameter

ET_CONSTR
ET_IO
ET_ORDER
ET_PEG
ET_RC
IS_GEN_PARAMS
IT_ACT
IT_CHARACT_REQ_OUTNODE
IT_CHARACT_VAL_INPNODE
IT_PEGAREA
IT_RES
IV_ACT_PLANNED_STATUS_SEL
IV_CONSTR_SELECTION
IV_END_TIME
IV_GET_ALL_PEG_DEPENDANTS
IV_GET_SUBORDERS
IV_IO_SEL
IV_ORDER_TYPE
IV_ORD_PLANNING_TYPE_SEL
IV_PEGAREA_SEL
IV_PEG_SELECTION
IV_RPM_GET_VIRTUAL_INPUTS
IV_SIMSESSION
IV_START_TIME

Ausnahmen

LC_APPL_ERROR
LC_COM_ERROR
LC_CONNECT_FAILED

Funktionsgruppe

APO/SAPLOM_PLANNINGTABLE

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

Length: 11606 Date: 20240425 Time: 185959     sap01-206 ( 148 ms )