Ansicht
Dokumentation

/DSD/BAPI_VP_CREATEFROMDATA - Besuchsplan anlegen oder kopieren

BAL_S_LOG - Application Log: Log header data   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Mit dieser Methode können Sie einen Besuchsplan anlegen.

Mit dem Importparameter VPID_FOR_COPY können Sie einen bereits vorhandenen Besuchsplan als Kopiervorlage für den neuen Besuchsplan verwenden. Wenn Sie in diesem Importparameter eine Besuchsplan-ID eingeben, werden alle Kopfdaten und Positionsdaten dieses Besuchsplans in den neuen Besuchsplan übernommen. Die Kopfdaten des neuen Besuchsplans können Sie mit dem Importparameter VPH_IN aktualisieren. Insbesondere müssen Sie hier für den neuen Besuchsplan einen eigenen Gültigkeitszeitraum definieren. Wenn Sie im Parameter VPID_FOR_HRULE ein Template mit einer von der Kopiervorlage abweichenden Terminregel Kopf angeben, wird diese im neuen Besuchsplan ebenfalls entsprechend aktualisiert. Kundendaten hingegen werden aus der Kopiervorlage übernommen und durch weitere Eingaben in anderen Importparametern nicht aktualisiert.

Wenn Sie den neuen Besuchsplan ohne Vorlage erstellen, müssen Sie mindestens die Kopfdaten (VPH_IN) als Importparameter mitgeben. Mit der Reihenfolge, in der Sie die Kunden in den Besuchsplan aufnehmen, legen Sie dabei die Reihenfolge fest, in der die Kunden besucht werden sollen.

Mit den Importparametern VPID_FOR_HRULE und VPID_FOR_CRULE können Sie Terminregeln auf Kopf- und Positionsebene von einem bestehenden Besuchsplan in den neuen Besuchsplan kopieren.

Mit der Importstruktur VPTEXT_IN können Sie dem neuen Besuchsplan Texte auf Kopf- und Positionsebene zuordnen.

Mit dem Parameter SIMULATION können Sie festlegen, dass der neue Besuchsplan nur simulativ erzeugt wird und die Daten zunächst noch nicht auf die Datenbank geschrieben werden.

Die Belegnummer des neu angelegten Besuchsplans wird vom System als Schlüsselfeld des Belegs zurückgegeben.

Kundenerweiterungen

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

• Struktur /DSD/BAPI_VC_TE_VPH für weitere Felder auf Kopfebene

• Struktur /DSD/BAPI_VC_TE_VPP 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_VP_TREE hinzugefügt werden.

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 VP_CHECK_CONSISTENCY können Sie diese Prüfungen um eigene Prüfungen ergänzen oder kundeneigene Felder in den Besuchsplan-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 01 (Anlegen) geprüft: /DSD/VC_VP.

Weiterführende Informationen

Weitere Informationen finden Sie in der Parameterdokumentation.

Parameter

EXTENSIONIN
RETURN
SIMULATION
VISITPLAN_ID
VPH_IN
VPH_OUT
VPID_EXTERN
VPID_FOR_COPY
VPID_FOR_CRULE
VPID_FOR_HRULE
VPP_IN
VPTEXT_IN

Ausnahmen

Funktionsgruppe

/SAPLVC_BAPI_VP

PERFORM Short Reference   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4878 Date: 20240424 Time: 193517     sap01-206 ( 72 ms )