Kontakt

Ansicht
Dokumentation

ISM_API_ISSUE_SEQUENCE_APPEND - API für Anhängen Medienausgabe in Ausgabenfolge

ISM_API_ISSUE_SEQUENCE_APPEND - API für Anhängen Medienausgabe in Ausgabenfolge

CL_GUI_FRONTEND_SERVICES - Frontend Services   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Der Funktionsbaustein ISM_API_ISSUE_SEQUENCE_APPEND hängt an das Ende der Ausgabenfolge eines Medienproduktes eine Medienausgabe an.

Das Anlegen der Medienausgabe selbst kann optional durchgeführt werden. ( Wird eine geplante Medienausgabe in der Ausgabenfolge angehängt, ohne(!) daß die Medienausgabe angelegt wird, so muß das Anlegen der Medienausgabe separat ausgeführt werden (Report RJPMPGEN)).

Wird das Anlegen der Medienausgabe durchgeführt, so wird das Protokoll des Anlegens in den Anwendungslog geschrieben und ist damit in der Pflege der Ausgabenfolge anzeigbar. (wird eine bereits existierende Medienausgabe an die Folge angehängt, so gibt es dafür keinen Anwendungslog.)

Es werden die gleichen Plausibilitäten wie in der Dialogverarbeitung der Ausgabenfolge durchlaufen.

Input-Parameter des Funktionsbausteins:

  • N_ISSUE (optional) : Materialnummer(MATNR) der anzuhängenden Medienausgabe
  • IN_PUBLICATION_DATE (optional): Erscheinungsdatum der Medienausgabe
  • IN_COPYNUMBER (optional): Heftnummer der Medienausgabe
  • IN_PRODUCT: Der Medienausgabe übergeordnetes Medienprodukt
  • IN_TEMPLATE_ISSUE: Vorlagematerial für die Medienausgabe
  • IN_TEMPLATE_VARTYPE: Vorlagevariantentyp für die Medienausgabe
  • IN_XCREATE_ISSUE (optional): Kennzeichen: Medienausgabe anlegen
  • IN_XACTIVATE_PLAN(optional): Kennzeichen: neue Medienausgabe für Anlage auf Datenbank vormerken ("gelbe Ampel")
  • IN_XSET_END_OF_HORIZON(optional): Kenzeichen: Ende des Planungshorizontes auf diese Medienausgabe setzten

Output-Parameer des Funktionsbausteins:

  • OUT_ISSUE : Materialnummer der Medienausgabe, die an die Ausgabenfolge angehängt wurde

Tabellen des Funktionsbausteins:

  • OUT_RETURN : Tabelle mit Meldungen

Konnte das Anhängen der Ausgabe an die Ausgabenfolge erfolgreich durchgeführt werden, so wird die neu an die Ausgabenfolge angehängte Materialnummer in dem Parameter OUT_ISSUE zurückgegeben. (Trat beim Anhängen ein Fehler auf, so ist OUT_ISSUE initial.) Trat ein Fehler beim Anlegen der Medienausgabe auf, so ist OUT_ISSUE ebenfalls gefüllt, wenn die Ausgabe erfolgreich an die Folge angehängt wurde (Die Fehler beim Anlegen der Medienausgabe sind dann in der Fehlertabelle OUT_RETURN protokolliert.)

Besonderheiten bei der Behandlung des Input-Parameters IN_ISSUE:

  • IN_ISSUE kann eine bereits existierende Medienausgabe(außerhalb) der Folge sein.Wird eine bereits existierende Medienausgabe in IN_ISSUE übergeben, so müssen die Eingaben für ISMPUBLDATE und ISMCOPYNR mit den richtigen Werten übereinstimmen.
  • IN_ISSUE kann initial sein und durch einen kundenindividuellen Funktionsbaustein (der in der Ausgabenfolge zur Materialnummernvergabe eingebunden ist) auf eine schon existierende Medienausgabe zeigen.Wird durch den Funktionsbaustein für die kundenindividuelle Vergabe der Materialnummer für die anzuhängende Medienausgabe eine bereits existierende Materialnummer gebildet, dann werden die Werte für ISMPUBLDATE und ISMCOPYNR aus der existierenden Ausgabe übernommen (die Eingabewerte für SMPUBLDATE und ISMCOPYNR sind in diesem Fall nicht aktiv)
  • Interne Nummernvergabe für die Materialnummernvergabe wird nicht unterstützt (Der Funktionsbaustein für die kundenindividuelle Vergabe der Materialnummer wird durchlaufen; dort können zwar kundenindividuell Nummern vergeben werden, aus Sicht des Materialstammes müssen diese Nummer aber als externes Nummernintervall definiert sein. Diese Vorgehensweise erfolgt anlog der Pflege der Ausgabenfolge im Dialog: initiale Materialnummern sind nicht zulässig.)

Explizites/Impizites Füllen von Materialnummer und Heftnummer

  • Materialnummer und Heftnummer der Medienausgabe werden durch die Funktionsbaustein für die kundenindividuelle Vergabe der Materialnummer und der Heftnummer gefüllt, wenn sie nicht in der Schnittstelle übergeben werden.
  • Wird IN_ISSUE oder IN_ISMCOPYNR explizit in der Schnittstelle übergeben, so werden diese Werte (unabhängig von der kundenindividuellen Vorbelegungen für Materialnummer und Heftnummer übernommen.

Beispiel

Hinweise

Weiterführende Informationen





Parameter

IN_COPYNUMBER
IN_ISSUE
IN_PRODUCT
IN_PUBLICATION_DATE
IN_TEMPLATE_ISSUE
IN_TEMPLATE_VARTYPE
IN_XACTIVATE_PLAN
IN_XCREATE_ISSUE
IN_XSET_END_OF_HORIZON
OUT_ISSUE
OUT_RETURN

Ausnahmen

Funktionsgruppe

JPBAPI_ISSUE_SEQUENCE

RFUMSV00 - Advance Return for Tax on Sales/Purchases   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5507 Date: 20240523 Time: 130449     sap01-206 ( 92 ms )