Kontakt

Ansicht
Dokumentation

RNCGET10XML - IS-H: XML-Import erbrachter Leist. von ausgewählten Partnersystemen

RNCGET10XML - IS-H: XML-Import erbrachter Leist. von ausgewählten Partnersystemen

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

Beschreibung

Dieser Report holt von (ausgewählten) Partnersystemen die XML-Daten zu erbrachten Leistungen ab.

Die fehlerhaften Daten können nun im SAP (Transaktion NWCHCR_ERR) nachbearbeitet und nachgebucht oder auch an den Aufrufer (Subsystem) mittels Error-XML-File (E_XML.dat) retourniert werden. Das jeweilige erwünschte Fehlerhandling ist über den Systemparameter E_XML_CH zu hinterlegen (Default = Fehlerhandling über SAP). Wünschen Sie allerdings eine Übertragung des Error-XML-Files, so muß der Parameter explizit auf ON gesetzt werden.

Des weiteren kann über den Systemparameter CASEC_CH gesteuert werden, ob bei der Übertragung von abrechenbaren Leistungen ggfs. bereits endabgerechnete Fälle bei der Leistungsübertragung automatisch auf zwischenabgerechnet umgesetzt werden sollen (Defaultverhalten = keine Umsetzung).

Die Daten müssen im Format lt. DocType-Definition "LeistungsschnittstelleEng40.dtd" in einem File mit der Extention ".dat" vorliegen.

D.h. im XML-Input-File muß (erst ab Release 4.72) vor dem Header eine DocType-Definition angeführt werden

D.h. im XML-Input-File muß (erst ab Release 4.72) vor dem Header eine DocType-Definition angeführt werden .

Bei dieser Beispieldefinition ist die DTD am Applicationserver im Verzeichnis /usr/ hinterlegt. Somit sollten Subsystem und KH eine Vereinbarung treffen, wo die DTD am SAP abgelegt wird, damit das XML-File von den Subsystemen auch auf deren Korrektheit geprüft werden kann. Es kann natürlich auch ein anderer Pfad bzw. anstatt PUBLIC auch SYSTEM angeführt werden, wobei jedoch gewährleistet sein muß, daß der SAP-Parser dann auch Zugriff auf die DTD hat.

Sollte keine DTD im XML-File angegeben sein, so wird die Verarbeitung abgebrochen, da der SAP-Parser in diesem Fall auf einen Fehler aufläuft.

Anmerkung: zu 4.63B braucht die DTD im XML-File nicht angegeben werden, da zu dieser Release nur ein "non-validating-parser" zur Verfügung steht. D.h. die Korrektheit des XML-Inputs (lt. DTD) muß vom Subsystem gewährleistet sein! Es ist auch darauf zu achten, daß bei einer Angabe der diese Leistung entweder bereits vorher im XML-File enthalten ist bzw. bereits früher übermittelt und im IS-H eingebucht wurde.

Sollten mehrere XML-Dokumente innerhalb des übertragenden .dat-Files enthalten sein, so muß darauf geachtet werden, daß nach der </Header> Anweisung und dem nächsten XML-Dokument keine Leerzeile enthalten ist.

Die XML-Daten werden über den Funktionsbaustein ISHCM_CONV_XML_ASCII_API in das entsprechende SAP-API-Format konvertiert. In diesem Funktionsbaustein sind Exits mittels BadI ISHCM_CONV_XML_API vorgesehen, mit denen Sie die Zuordnung der XML-Felder zu den korrespondierenden API-Feldern ändern bzw. erweitern können.

Siehe hierfür die Dokumenation zur Methode set_xml_api_val.

Ist das Kennzeichen 'Testmodus' nicht gesetzt, dann werden die Daten bereits über den entsprechenden BAPI (per Aufruf der einzelnen benötigen APIs) verbucht.

Die Verbindung wird über das SAP-Kommunikationsmodul hergestellt. Für den Transmit der u.U. fehlerhaften XML-Daten ist es notwendig das Script-File für den Datenversand (Put_tab) dementsprechend anzupassen.

Auszug aus Script (wie dies zum Beispiel für den Standard-Datenversand des NTISH.dat aufgebaut ist)

# Env. dir. IS-H datas in SAP-HCM format (file NTISH.dat)

# with Append mode (ISHCM: only '1' possible)

setenv INTERF_NTISH /usr/sap/HCM/outdata/...

setenv INTERA_NTISH 1

#

setenv INTERF_E_XML /usr/sap/HCM/outdata/...

setenv INTERA_E_XML 1

Der Report sollte zyklisch im Hintergrund laufen, um (etwa jeden Abend) die angesammelten Leistungen (eines Tages) in das IS-H zu übernehmen.

SAP-Empfehlungen:

  1. benennen Sie den entsprechenden Hintergrundjob gemäß den ISH-Namenskonventionen wie folgt:

    ISHCM_GET_SERVS_xxx

    Dabei steht 'xxx' für denjenigen Mandant, in welchem der Job eingeplant wurde. Nur in diesem bzw. für diesen Mandant arbeitet er nämlich auch.
  2. fügen Sie vor dem RNCGET10XML als ersten Job-Step das Programm SAPCDERR ein. Dieses übermittelt evtl. noch ausstehende Empfangsquittungen an Partnersysteme. Dadurch werden Komplikationen vermieden.
  3. geben Sie als Wiederholperiode einen "sinnvollen" Wert an. Wir empfehlen allgemein, täglich (etwa um 19:00 Uhr) Leistungen abzuholen.

Voraussetzungen

  1. Das SAP-Kommunikationsmodul muß korrekt installiert sein.
  2. Im Customizing des IS-HCM muß lediglich das System hinterlegt sein, von welchen Systemen Leistungsdaten übernommen werden sollen.
  3. Auch das Format muß beim jeweiligen System stimmen.
  4. Sollten beim Parsen Fehler auftreten, prüfen Sie, ob die Inhalte der XML-Elemente Sonderzeichen (< > & " ' ) enthalten. Ist dies der Fall, ersetzen Sie die Zeichen wie folgt:
Sonderzeichen Entität
< &lt;
> &gt;
& &
" &quot;
' &apos;

Ausgabe

Ein kleines Protokoll, um die Fehlermeldungen des XML-Inputs auszugeben. Sollten Probleme bei der Kommunikation aufgetreten sein, dann wird dies ebenfalls protokolliert.






Fill RESBD Structure from EBP Component Structure   Fill RESBD Structure from EBP Component Structure  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6914 Date: 20240520 Time: 065621     sap01-206 ( 112 ms )