Ansicht
Dokumentation

/DSD/BAPI_VL_CHANGEFROMDATA - Besuchsliste ändern

/DSD/BAPI_VL_CHANGEFROMDATA - Besuchsliste ändern

ABAP Short Reference   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Mit dieser Methode können Sie folgende Änderungen in einer Besuchsliste vornehmen:

  • Sie können allgemeine Daten auf Kopf- und Positionsebene ändern. Den Besuchsplantyp der Besuchsliste in den Kopfdaten können Sie nicht ändern.
  • Sie können mit der Importstruktur VLP_IN neue Kunden in die Besuchsliste aufnehmen und Kunden aus der Besuchsliste entfernen. Außerdem können Sie weitere Kundendaten, wie beispielsweise die Reihenfolge, ändern. Kundennummern können Sie nicht ändern.
  • Sie können neue Texte zuordnen oder Texte entfernen.
  • Sie können neue Referenzdokumente auf Kopf- und Positionsebene zuordnen oder bereits zugeordnete Referenzdokumente entfernen.

Änderungen, die Sie in einzelnen Feldern vornehmen, werden nur dann vom System berücksichtigt, wenn folgende Voraussetzungen erfüllt sind:

  • Sie haben im Update-Kennzeichen für jede Position der Besuchsliste angegeben, ob die eingetragenen Werte neu (I) oder geändert (U) sind, oder ob die vorhandenen Werte gelöscht werden sollen (D).
  • Sie haben in der jeweiligen Änderungsleiste zum Parameter alle Felder mit einem 'X' markiert, die im entsprechenden Parameter änderungsrelevant sind. Wenn Sie beispielsweise bestimmte Felder in den Kopfdaten ändern wollen (Parameter VLH_IN) müssen Sie diese Felder im Parameter VLPX markieren.

Mit dem Parameter SIMULATION können Sie festlegen, dass die Änderungen nur simulativ durchgeführt werden sollen und die geänderten Daten der Besuchsliste zunächst noch nicht auf die Datenbank geschrieben werden.

Kundenerweiterungen

Um die Tabellen der Besuchsliste um kundeneigene Felder zu erweitern, können Sie folgende BAPI Table Extensions nutzen:

  • Struktur /DSD/BAPI_VC_TE_VLH für weitere Felder auf Kopfebene
  • Struktur /DSD/BAPI_VC_TE_VLHX zur Kennzeichnung der neuen Felder auf Kopfebene
  • Struktur /DSD/BAPI_VC_TE_VLH_R für weitere Felder zu Referenzbelegen auf Kopfebene
    Wird die Tabelle der Referenzbelege um kundeneigene Felder erweitert, so müssen diese Felder auch der Struktur /DSD/VC_DOC hinzugefügt werden.
  • Struktur /DSD/BAPI_VC_TE_VLH_RX zur Kennzeichnung der neuen Felder zu Referenzbelegen auf Kopfebene
  • Struktur /DSD/BAPI_VC_TE_VLP für weitere Felder auf Positionsebene
    Wird die Tabelle der Positionsdaten um kundeneigene Felder erweitert, so müssen diese Felder auch der Struktur /DSD/VC_VL_TREE hinzugefügt werden.
  • Struktur /DSD/BAPI_VC_TE_VLPX zur Kennzeichnung der neuen Felder auf Positionsebene
  • Struktur /DSD/BAPI_VC_TE_VLP_R für weitere Felder zu Referenzbelegen auf Positionsebene
    Wird die Tabelle der Referenzbelege um kundeneigene Felder erweitert, so müssen diese Felder auch der Struktur /DSD/VC_DOC hinzugefügt werden.
  • Struktur /DSD/BAPI_VC_TE_VLP_RX zur Kennzeichnung der neuen Felder zu Referenzbelegen auf Positionsebene

Mit der Tabelle EXTENSIONIN können Sie kundeneigenen Feldern die entsprechenden Werte zuordnen.

Alle an das BAPI übergebenen Daten werden vor ihrer Weiterverarbeitung auf ihre Konsistenz geprüft. Mit der Implementierung der BAdI-Methode VL_CHECK_CONSISTENCY können Sie diese Prüfungen um eigene Prüfungen ergänzen oder kundeneigene Felder in den Besuchslisten-Tabellen auf ihre Konsistenz prüfen.

Rückmeldungen

Meldungen werden im Parameter Return zurückgegeben. In dieser Parameter-Dokumentation finden Sie die Rückgabewerte und deren Bedeutungen.

Beispiel

Hinweise

Es wird das folgende Berechtigungsobjekt mit der Aktivität 02 (Ändern) geprüft: /DSD/VC_VL.

Weiterführende Informationen

Weitere Informationen finden Sie in der Parameterdokumentation.





Parameter

EXTENSIONIN
RETURN
SIMULATION
VISITLIST_ID
VLHX
VLH_IN
VLH_OUT
VLH_RX
VLH_R_IN
VLPX
VLP_IN
VLP_RX
VLP_R_IN
VLTEXT_IN

Ausnahmen

Funktionsgruppe

/SAPLVC_BAPI_VL

CL_GUI_FRONTEND_SERVICES - Frontend Services   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6186 Date: 20240427 Time: 014320     sap01-206 ( 78 ms )