consolut - /DSD/BAPI_VP_CREATEFROMDATA - Besuchsplan anlegen oder kopieren

/DSD/BAPI_VP_CREATEFROMDATA - Besuchsplan anlegen oder kopieren

General Material Data PERFORM 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 Kopiervorlagefü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ültigkeitszeitraumdefinieren. Wenn Sie im Parameter VPID_FOR_HRULE ein Template mit einer von der Kopiervorlage abweichendenTerminregel Kopf angeben, wird diese im neuen Besuchsplan ebenfalls entsprechend aktualisiert. Kundendatenhingegen 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 derPositionsdaten 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üfungenum 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.