/
Execution of Vehicle Actions

Execution of Vehicle Actions

This function enables you to control the business processes during vehicle processing. The execution of vehicle actions is defined on the basis of the action grids, or matrices, in which it is defined which action is linked with which vehicle status change. You can always execute actions for a selected vehicle.
You can also create additional vehicle actions that meet branding, country-specific process requirements, or both by enhancing the basis of the matrices.
You can execute vehicle actions in the following ways:

  • Directly for the vehicle
    In the vehicle master record, you can select one of the actions offered. Otherwise, an action is executed using the RFC module.
  • Implicitly on the basis of the VSS order

    Vehicle actions can be triggered by means of order control.

    Note

    In Customizing for VSS, you can define which action the system has to execute when an order of a certain order type is created and deleted or rejected by choosing Order > Order Control > Order Control VMS Extension > Define Table of Criteria for Order Control - VMS Action Determination. For example, the standard system executes action QCUO when a vehicle order (order type 3000) is created and action QDCO when it is deleted.

Integration

Action Control for the Vehicle Management System (VMS), which controls the actions for the VSS vehicle, and order control for Vehicle Sales and Service (VSS) interact in the standard system as follows:
As soon as a vehicle is used in a VSS order, the order control takes over control of the next step such as goods issue or invoice creation.
At the same time, the order control also triggers vehicle actions, which ensure that the system updates the vehicle history accordingly and that the links to various documents generated in the background are saved.
You can change the Customizing settings in such a way that VMS action control influences and also controls the order process.

Recommendation

Due to the complex process modeling, you are advised to do this only if your business processes urgently require so.


So that the vehicle actions can be executed, the following settings must be made:

  • The vehicle actions must be permitted in the action grid in Customizing for VMS by choosing Control Data > Define Action Controls and Define Action Matrices.
  • Vehicle actions that do not appear as actions in the vehicle master and that should be executable only using the VSS order are identified as internal actions in Customizing for VMS under Control Data > Define Actions.
  • The vehicle actions must be made known to VSS by means of control values in Customizing for VSS under Vehicle > Enter Control Value.

Prerequisites

You have defined the following in Customizing for VMS under Control Data:

  • Actions
  • At least one action control
  • Vehicle status
  • One action grid for each action control

Features

  • You can control every action with authorizations (authorization object C_AUTO_VMS). This means, for example, that you can configure VSS in such a way that you, as management, are authorized to perform all actions, but your employees only specific actions.
  • In the vehicle master record, you can only choose those actions that are possible for the current vehicle status in accordance with the action grid. The system does not display the other actions.
  • If the system executes an action, this can result in a change in the status of the vehicle, depending on the definition in Customizing. A primary action influences the primary status, a secondary action the secondary status.
  • In the vehicle master record under VMS Vehicle History, you can track the actions that have already been executed with primary and secondary statuses.
  • A whole host of actions are delivered with the standard system. In Customizing, however, you can change these actions or define and program your own actions.
  • The standard actions can be assigned to the following business processes:
  • Business Add-Ins (BAdIs) are available for the most important actions in the standard SAP system. You can use these BAdIs to adapt the EXECUTE modules for the actions to suit your own specific requirements.

Caution

The execution of interlinking actions in VSS is very critical. For this reason, it is not necessarily advisable to use these actions. Since the VMS itself executes a COMMIT for interlinked actions, the VSS order control no longer controls the COMMIT.
Instead of using interlinking actions, you can write an action whose EXECUTE module performs two actions in one logical processing unit (LUW). Note that not all Business APIs in the standard SAP system can be executed in an LUW. For example, a purchase order with goods receipt cannot be created in an LUW.

For more information about the vehicle actions that can be executed in VSS, see Details for the Vehicle Actions.

Example

Vehicle History

Action

Primary Status

Secondary Status

Create vehicle with internal order

Vehicle created


Order vehicle

Vehicle ordered


Create goods receipt

Vehicle received


Assign customer

Vehicle received

Customer assigned

Create vehicle order

Vehicle received

VSS order created

Change vehicle

Vehicle received

VSS order created