SAP Function /DSD/BAPI_VL_GETDETAIL - Get Details on Visit List

Parameter Reference Type Length Default Optional Text
VISITLIST_ID /DSD/BAPI_VC_VL-VISITLIST_ID C 10 Visit List ID
XDESCRIPTION BAPIFLAG-BAPIFLAG C 1 X 'X' = Detailed Information at Header Level
XDISTANCE BAPIFLAG-BAPIFLAG C 1 X 'X' = Determination of Distance
XPLUS BAPIFLAG-BAPIFLAG C 1 X 'X' = Detailed Information at Item Level
XREF_DOCS BAPIFLAG-BAPIFLAG C 1 X 'X' = Additional Reference Documents
XTEXT BAPIFLAG-BAPIFLAG C 1 X 'X' = Additional Texts

Parameter Reference Type Length Text
VLH_DESCRIPTION /DSD/BAPI_VC_DESCRIPTION u 410 Detailed Information at Header Level (Export)
VLH_OUT /DSD/BAPI_VC_VLHOUT u 173 Visit List: Header Data (Export)

Parameter Reference Length Optional Text
DISTANCE /DSD/BAPI_VC_DISTANCE 16 X Distances Determined
EXTENSIONOUT BAPIPAREX 990 X Customer Enhancements for Visit Lists
RETURN BAPIRET2 548 X Confirmations
TEXT_HEADER /DSD/BAPI_VC_VL_STXH 382 X Header Data for Texts (Export)
TEXT_LINES BAPITEXTLI 232 X Additional Texts
VLH_R /DSD/BAPI_VC_VLH_R 12 X Reference Documents at Header Level (Export)
VLP_OUT /DSD/BAPI_VC_VLPOUT 70 X Visit List: Customer Data (Export)
VLP_PLUS /DSD/BAPI_VC_VLP_PLUS 420 X Detailed Information at Item Level (Export)
VLP_R /DSD/BAPI_VC_VLP_R 15 X Reference Documents at Item Level (Export)

Functionality
You can use this method to display additional detailed information on aspecific visit list. The system displays header and customer data forthe selected visit list, and provides additional information that isdisplayed for you to view but is not saved in the relevant visit list.
There are indicators for you to specify which additional data you wantthe system to display. You can display additional data at header level(import parameter XDESCRIPTION) or item level (import parameter XPLUS).You can determine the distance between customers (import parameterXDISTANCE) or view additional reference documents (import parameterXREF_DOCS) and texts at header and item level (import parameter XTEXT).
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 relevant parameter documentation.

Description
If you have set the indicator in the import parameter XDESCRIPTION
, additional detailed information on the visit list is output in thisexport parameter. This can include the names of the driver andco-driver, or a more exact description of the vehicle and route.

Description
This export parameter outputs the visit list header data.
INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX

Description
The import parameter contains the ID of the visit list for which youwant to display detailed information.

Description
If you set the indicator in this import parameter, additional detailedinformation on the visit list is displayed in the export parameterVLH_DESCRIPTION. The information can include the names of thedriver and co-driver, or a more detailed description of the vehicle androute.

Value range
Blank = No additional detailed information is displayed at header level
x = Additional detailed information is displayed at header level

Description
If you set the indicator in this import parameter, the distance to thenext customer is determined at item level and output in the export tableDISTANCE.

Value range
Blank = distance between customers is not determined
x = distance between customers is determined

Description
If you set the indicator in this import parameter, additional detailedinformation on individual customers is displayed in the export tableVLP_PLUS. This can include name and address of contact personswith telephone and fax numbers, or visit times and goods receivingtimes.

Value range
Blank = No additional detailed information is displayed at item level
x = Additional detailed information is displayed at item level

Description
If you set the indicator in this import parameter, additional referencedocuments for the visit list are displayed at header and item level inthe export tables VLH_R and VLP_R.

Value range
Blank = No additional reference documents are displayed for the visitlist
x = Additional reference documents are displayed for the visit list

Description
If you set the indicator in this import parameter, additional texts areoutput for the visit list at header and item level in the export tablesTEXT_HEADER and TEXT_LINES.

Value range
Blank = no additional texts are output for the visit list
x = additional texts are output for the visit list

Description
If you have set the XDISTANCE indicator in the import parameter,the distance to the next customer is determined at item level anddisplayed in this export table.

Description
The ExtensionOut table allows you enhance the BAPI export parameterswithout making modifications.
This parameter is a change parameter of method VL_GETDETAIL_EXPORT inthe Business Add-In (BAdI) /DSD/BADI_VC_BAPI. This allows the values ofcustomer fields to be exported.

Description
INCLUDE BAPI_TABLE OBJECT DOKU ID TX

Value range
Type,, ID,, Number,, Message
E,, /DSD/VC_MESSAGE,, 013,, You do not have authorization for
,, ,, ,, this action
E,, /DSD/VC_MESSAGE,, 100,, Visit list &1 not found
,, ,, ,, in /DSD/VC_VLH

Description
If you have set the indicator in the import parameter XTEXT, theheader data for the texts are output in this export table, for example,the text ID and language key. The export table TEXT_LINEScontains the text lines.

Description
If you have set the indicator in the XTEXT import parameter, thetext lines are output in this export table. The export tableTEXT_HEADER contains the header data for the texts.

Description
If you have set the indicator in the XREF_DOCS import parameter,additional reference documents for the visit list are output at headerlevel in this export table. Reference documents at item level are outputin the export table VLP_R.

Description
This export structure outputs the customer data from the visit list. Aswell as the customer numbers, the list includes the sequence in whichthe customers are visited, travel duration, waiting time, and unloadingpoint.

Description
If you have set the indicator in the import parameter XPLUS,additional detailed information on individual customers is displayed inthis export table. The information can include name and address ofcontact persons with telephone and fax numbers, or visit times and goodsreceiving times.

Description
If you have set the indicator in the import parameter XREF_DOCS,additional reference documents for the visit list are output at itemlevel in this export table. Reference documents at header level areoutput in the export table VLH_R.