SAP ABAP IMG Activity SIMG_LTRM_USEXIT007 (Modify Inter-Zone Movement Duration During Creation of LROUT Table)
Hierarchy
☛ EA-APPL (Software Component) SAP Enterprise Extension PLM, SCM, Financials
   ⤷ LE-TRM (Application Component) Task & Resource Management
     ⤷ LTRM (Package) TRM - Core Package
IMG Activity
ID SIMG_LTRM_USEXIT007 Modify Inter-Zone Movement Duration During Creation of LROUT Table  
Transaction Code S_ALN_01000940   (empty) 
Created on 20020205    
Customizing Attributes SIMG_LTRM_USEXIT007   Modification of inter-zone movement duration during creation of LROUT table 
Customizing Activity SIMG_LTRM_USEXIT007   Modification of inter-zone movement duration during creation of LROUT table 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name LTRM_INTER_DURTN    

Use

This Business Add-In (Add-In) is used in the Task and Resource Management (LE-TRM) component.

This Add-In enables you to pre-calculate more precisely the duration of movements between nodes (in the inter-zonal space). This pre-calculation helps to improve performance of real-time route calculation.

Pre-calculation on the basis of the duration calculated by this Add-In is again needed where there are:

  • Changes of node coordinates
  • Changes of entry or exit attributes of nodes
  • Added nodes or obstacles
  • Deleted nodes or obstacles
  • Added resource types
  • Deleted resource types

To calculate the movement duration, the Add-In refers to the following data:

  • Site (IV_SITE of type LTRM_LOCAT)
  • Table IT_INTER of type LTRTT_IT_INTER with a list of routes.

    This list of routes contains all combinations of paths from all possible source nodes to all possible destination nodes, direct paths and trips with legs via one or more intermediate nodes.

    A record of the table IT_INTER contains the following:

    • Source node (LTRT_SRCND) and destination node (LTRT_DSTND)
    • Table LTRTT_IT_RNODE with a list of legs, defined by intermediate nodes, between the source and destination nodes
      • This table is empty if there is a direct path between the nodes.
      The structure of the table contains field RNODE (LTBN_NODE).

The output parameter is table ET_LROUT with the structure of the database table LROUT containing the following fields:

  • LOCAT site number (LTRM_LOCAT)
  • SRCND source node identification (LTRT_SRCND)
  • DSTND destination node identification (LTRT_DSTND)
  • RSTYP resource type (LTRS_RSTYP)
  • DISTC calculated distance (LTRT_DISTC)
  • DURTN calculated duration (LTRT_DURTN)

Function module LTRT_PHYSND_CHECK calls this Add-In .The Add-In calculates both distance and duration. The function module gets the output table ET_LROUT.

The value of route distance DISTC is the sum of the lengths of all of its legs.

The length of a leg is calculated according to the metrics assigned to its site.

Each record of the table is duplicated for each resource type, with the exception of some routes for certain resource types listed in table LRTEX. The value of duration DURTN is calculated using the resource type velocity from table LRSTY, and the duration of its turns.

If the Add-In returns duration calculations, they are inserted into database table LROUT, instead of the rough calculated values returned by function module LTRT_PHYSICAL_DISTANCE_ADD.

Example

Requirements

Standard settings

Recommendation

Activities

After you call the IMG activity, the system displays a dialog box where you enter a name for the implementation.

If implementations of this Business Add-In have already been created, the system displays them in a dialog box. You then choose one of them by choosing Create, and continue as follows:

  1. In the dialog box, enter a name for the implementation of the Add-In and choose Create.
    The system displays the initial screen for creating Business Add-In implementations.
  2. On this screen, enter a short description for your implementation in the Implementation Short Text field.
  3. If you choose the Interface tab, you will notice that the system has populated the Name of the Implementing Class field automatically, by assigning a class name based on the name of your implementation.
  4. Save your entries and assign the Add-In to a package.
  5. To edit a method, double-click its name.
  6. Enter your implementation code between the method <Interface Name>~<Name of Method>. and endmethod. statements.
  7. Save and activate your code. Navigate back to the Change Implementation screen.
    Note: You can also create an implementation for an Add-In and not activate it until later. If you want to do this, do not perform the following step:
  8. Choose Activate.
    When the application program is executed, the code you created is run through.

Further notes

For more information, refer to the following:

  • LTRT_LROUT_BUILD_TABLE: Main function module for pre-calculation of distances and duration
  • LTRT_PHYSND_CHECK: Building all possible inter-routes with corresponding legs between source and destination
  • LTRT_PHYSICAL_DISTANCE_ADD: Rough inter-duration calculation
  • LNODE: Node coordinates and attributes (call of LTBN_NODES_DETAILS_GET)
  • LRTEX: Route exceptions (use of LTRS_LRTEX_READ)
  • LRSTY: Resource type characteristics (with help of LTRS_LRSTY_READ)
  • LZNDF: Zone characteristics, including metric code (use of LTBN_ZONE_INFO_GET)

Business Attributes
ASAP Roadmap ID 257   Create User Exits 
Mandatory / Optional 3   Nonrequired activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency A   Valid for all countries 
Maintenance Objects
Maintenance object type E   Business Add-In - Definition 
History
Last changed by/on SAP  20020428 
SAP Release Created in 110