Fonction SAP /DSD/BAPI_VL_GETLIST - Select Visit List

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
DATEFROM /DSD/BAPI_VC_VPH-DATEFROM_VP D 8 SY-DATUM X Valid from Date
DATETO /DSD/BAPI_VC_VPH-DATETO_VP D 8 SY-DATUM X End of Validity Period
DIST_CHANNEL /DSD/BAPI_VC_VPH-DIST_CHANNEL C 2 X Distribution Channel
DIVISION /DSD/BAPI_VC_VPH-DIVISION C 2 X Division
MAXROWS /DSD/BAPI_VC_AUX-MAXROW I 4 '50' X Maximum Number of Hits
SALES_ORG /DSD/BAPI_VC_VPH-SALES_ORG C 4 X Sales Organization

Paramètre Reférence Long. Facultatif Description
CUSTOMER_SEL /DSD/BAPI_VC_RA_KUNNR 23 X Customer Number Value Range
DRIVER_SEL /DSD/BAPI_VC_RA_DRIVER1 23 X Driver Value Range
EXTENSIONIN BAPIPAREX 990 X Customer Enhancements for Visit Lists
EXTENSIONOUT BAPIPAREX 990 X Customer Enhancements for Visit Lists
RETURN BAPIRET2 548 X Error Messages
ROUTE_SEL /DSD/BAPI_VC_RA_ROUTE 15 X Route Value Range
VEHICLE_SEL /DSD/BAPI_VC_RA_TRUCK 39 X Vehicle Value Range
VISITGROUP_SEL /DSD/BAPI_VC_RA_AUTH 23 X Visit Plan Group Value Range
VISITLIST_ID_SEL /DSD/BAPI_VC_RA_VLID 23 X Visit List IDs Value Range
VISITLIST_SELECTED /DSD/BAPI_VC_VL 183 X Table with Selected Visit Lists
VISITPLANTYPE_SEL /DSD/BAPI_VC_RA_VPTYP 9 X Visit Plan Types Value Range
VISITPLAN_ID_SEL /DSD/BAPI_VC_RA_VPID 23 X Visit Plan IDs Value Range

Functionality
You can use this method to list visit lists so that you can view orprocess them. There are various import parameters for specifying thecriteria for visit list selection.
You can group visit lists that have an execution date within a specifictime period, or lists that are assigned to the same sales organization.You can also use tables to enter value ranges for your selection (suchas visit plan types, drivers, routes, or customer numbers).
Return messages
Messages are returned in the RETURN parameter. See the parameterdocumentation for the return values and their meanings.

Further information
For more information, see the parameter documentation.

Description
This import parameter contains the valid from date as a selectioncriterion for your selection.
If you enter a date here and there is no date entered in parameterIF_DATE_TO, only visit lists that are due to be executed on thedate you enter are selected.
If you enter a date here and there is another date entered in parameterIF_DATE_TO, all visit lists that have an execution date withinthis validity period are selected.

Description
This import parameter contains the valid to date as a selectioncriterion for your selection.
If you enter a date here and there is no date entered in parameterIF_DATE_FROM, all visit lists that are due to be executed beforeor on the date you enter are selected.
If you enter a date here and there is another date in parameterIF_DATE_FROM, all visit lists that have an execution date withinthis validity period are selected.

Description
This import parameter contains the distribution channel as a selectioncriterion for your selection.
If a distribtion channel is entered, only visit lists that are assignedthis channel are included in the selection.
For information about the meaning of the distribution channel, see therelevant data element documentation: Distribution Channel
.

Description
This import parameter contains the division as a selection criterion foryour selection.
If a division is entered, only visit lists that are assigned thisdivision are included in the selection.
For information about the meaning of the division, see the relevant dataelement documentation: Division.

Description
This import parameter determines the maximum number of visit listsdisplayed, based on your selection criteria. If you do not make anentry, the hit list contains a maximum of 50 visit lists.

Description
This import parameter contains the sales organization as a selectioncriterion for your selection.
If a sales organization is entered, only visit lists that are assignedthis sales organization are included in the selection.
For information about the meaning of the sales organization, see therelevant data element documentation: Sales Organization.

Description
This table contains a value range of cusomter numbers as a selectioncriterion for your selection.
If a value range is entered, only the visit lists that are assigned therelevant customer numbers are included in the selection.

Description
This table contains a value range of drivers as a selection criterionfor your selection.
If a value range is entered, only visit lists that are assigned therelevant drivers are included in the selection.

Description
The ExtensionIn table allows you to enhance the BAPI import parameterswithout making modifications.
Note
This parameter is an import parameter of method VL_GETLIST_SELECT in theBusiness Add-In (BAdI) /DSD/BADI_VC_BAPI. You can use additional fieldsto further restrict the result of the selection.

Description
You can use the ExtensionOut table to enhance the BAPI export parameterswithout making modifications.
This parameter is a change parameter of method VL_GETLIST_SELECT in theBusiness Add-In (BAdI) /DSD/BADI_VC_BAPI. This allows the values ofcustomer fields that are not contained in the export structureVISITLIST_SELECTED to be exported.
INCLUDE BAPI_TABLE OBJECT DOKU ID TX
Error messages are only output if the selection criteria are not filledcorrectly.

Value range
Type,, ID,, Number,, Message
E,, S&,, 026,, Value & in field SIGN can only be I or E
E,, S&,, 027,, Value & in field OPTION is invalid
,, ,, ,, (EQ,NE,GT,GE,LE,LT,BT,NB,CP,NP)

Description
This table contains a value range ofroutes as a selectioncriterion for your selection.
If a value range is entered, only visit lists that are assigned therelevant routes are included in the selection.

Description
This table contains a value range of vehicles as a selection criterionfor your selection.
If a value range is entered, only visit lists that are assigned therelevant vehicles are included in the selection. Trailers are not partof this selection.

Description
This table contains a value range of visit plan groups as a selectioncriterion for your selection.
If a value range is entered, only visit lists that are assigned therelevant visit plan groups are included in the selection.

Description
This table contains a value range of visit list IDs as a selectioncriterion for your selection.
If a value range is entered, only visit lists that have an ID within therelevant value range are included in the selection.

Description
Once the criteria have been defined and the selection made, this tablereturns the list of selected visit lists.

Description
This table contains a value range ofvisit plan types as aselection criterion for your selection.
If a value range is entered, only visit lists that are assigned therelevant visit plan types are included in the selection.

Description
This table contains a value range of visit plan IDs as a selectioncriterion for your selection.
If a value range is entered, the selection only includes visit liststhat the system has created with reference to a visit plan and that havean ID within the relevant range.