Functionality This Business Application Programming Interface (BAPI) creates aroute>, based on datatransferred from the ROUTEDATA and EXTENSIONIN parameters. In the structure EXTENSIONIN, transfer the customer fields that are thentransferred to the internal route structure. These fields must alreadybe components of the customer enhancement CI_ROUTE for the EWAROUTEtable. When dealing with data from the ROUTEDATA structure, note the following:
- Key:
If you submit a value in the ROUTE field, this is then interpreted as anexternal key, and a data record with this key is created. If you leavethe field empty, a new data record with an internally assigned key iscreated.
- Mandatory fields
KEYDATE> indicates the date from which the route is valid. PRODUCT_AREA> is theservice area> for the route.The value must exist in Customizing for the service areas.
- Dependency between fields
A dependency exists between the fieldsservice area> andconfirmation category>(PRODUCT_AREA and RESULTYP, PRODUCT_AREA2 and RESULTYP2, PRODUCT_AREA3and RESULTYP3). This dependency is assigned via Customzing. Onlyconfirmation categories that have been specified in Customizing can beassigned to service areas.
- Other Fields
Refer to the respective documentation in the data dictionary for themeanings of other fields.Example This function is, for example, necessary if you have connected anexternal route planning system, in which new routes were generated forfor the first time during route planning. If you now want to upload awaste disposal order for a new route, you must first generate the newroute in the SAP system. Notes Messages are returned in the RETURN parameter. Customer fields aretransferred in the EXTENSION parameter. You can also start this BAPI in test mode. This means that the new datarecord is not posted. To do this, you must set the TESTRUN parameter. The module does not deduct a COMMIT. The posting takes place in UpdateTask. Description Reference structure for BAPI parameter ExtensionIn>(customer-defined structure). The table contains:
- Structure name of BAPI table extension (STRUCTURE)
- Structure contents of BAPI table extension (VALUEPART1)
- ...
- Structure contents of BAPI table extension (VALUEPART4)
Value range Structure name of BAPI table extension (STRUCTURE): BAPI_TE_EWAROUTE Default Description Key (route number) of generated data record. Description Complete structure of generated data record. Description Reference structure for BAPI parameter ExtensionIn>(customer-defined structure). The table contains:
- Structure name of BAPI table extension (STRUCTURE)
- Structure contents of BAPI table extension (VALUEPART1)
- ...
- Structure contents of BAPI table extension (VALUEPART4)
Value range Structure name of BAPI table extension (STRUCTURE): BAPI_TE_EWAROUTE Description Transfer structure for route data, which must be created in the system. For further information on the individual fields within the datastructure, refer to the documentation on data elements in DDIC. Description Module only called in test mode. No posting occurs. Default SPACE Description If errors occur, this structure contains, for example, the followinginformation: Message type (field TYPE) Message code (field CODE) Message text (field MESSAGE) Otherwise, this structure is empty.
|