Verwendung

Mit Hilfe von Variantenfunktionen können Sie Prüfungen und Herleitungen von Werten auslösen. Sie können Variantenfunktionen zum Beispiel benutzen, um

Wenn Sie Variantenfunktionen einsetzen wollen, müssen Sie diese Funktionen selbst bereitstellen, daher werden sie auch benutzerdefinierte Variantenfunktionen genannt.

Integration

Variantenfunktionen sind als kundenspezifisches Coding zu erstellen, das mit den Schlüsselwörtern FUNCTION und PFUNCTION aus dem Beziehungswissen aufgerufen wird. Dabei werden Merkmale und Merkmalswerte in einer Liste von paarweise aufgeführten Parameternamen und zugehörigen Parameterwerten übergeben. Variantenfunktionen sind Teil der Wissensbasis.

Um Variantenfunktionen in der Variantenkonfiguration des mySAP ERP verwenden zu können, müssen sie in ABAP programmiert werden; zur Verwendung in der Produktkonfiguration mit der Configuration Engine müssen sie jedoch in Java implementiert sein.

Eine Variantenfunktionen müssen Sie in jedem Fall als ABAP-Baustein anlegen, der in seinem Rumpf zumindest die Anforderungen an die Schnittstelle abdeckt. Denn Sie können eine Variantenfunktion nur dann in den Status Freigegeben versetzen, wenn sie sich als ausführbar erweist.

Es gibt keine automatische Übersetzung von ABAP in Java.

Voraussetzungen

Wenn Sie Variantenfunktionen implementieren wollen, sollten Sie über folgende Voraussetzungen verfügen:

Funktionsumfang

Es gibt zwei Typen von Variantenfunktionen, die sich in Definition und Form gleichen. Sie adressieren jedoch unterschiedliche Objekte und bieten daher unterschiedliche Möglichkeiten:

Variantenfunktionen erstellen

Beim Erstellen von Variantenfunktionen für Modelle zur Produktkonfiguration mit der Configuration Engine müssen Sie berücksichtigen, dass die Configuration Engine auf dem Java Transaction Server aufsetzt und dessen Infrastruktur benutzt. Weitere Information hierzu sowie zu den nachfolgend beschriebenen Schritten finden Sie im SAP-Hinweis 870201.

Beispiel

package com.sap.sce.user;

import com.sap.sce.engine.*;

/*

 * Java Class for variant function Z_CABIN_LABEL.

 *

 * This variant function (PFUNCTION) does the following:

 * 1) Read the values of three characteristics:

 *     - ELEVATOR_TYPE (mandatory, using the standard characteristic  *       interface)

 *     - MAX_LOAD (mandatory, using the standard characteristic interface)

 *     - ELEVATOR_OPTIONS (optional, multi-valued, using a method of SCELIB  *       (similar to function group CUPR)

 * 2) Generate a string from the values in 1) and set it as value

 *     for characteristic CABIN_LABEL.

 *

 * Motivation:

 * 1) Since MAX_LOAD is numeric the string label cannot be generated

 *     using classical dependencies.

 * 2) Since ELEVATOR_OPTIONS is multi-valued, its values cannot be passed

 *     via the variant function interface and must be read directly from the

 *     configuration using a read access method (SCELIB).

 *

 * The variant function is activated as follows:

 * 1) Create an equally named variant function in ERP with input  *    characteristics "ELEVATOR_TYPE" and "MAX_LOAD" and output parameter .*    "CABIN_LABEL".

 * 2) Create a procedure with the following code and link it to the  *    config.profile:

 *    pfunction Z_CABIN_LABEL (ELEVATOR_TYPE = $self.ELEVATOR_TYPE,

 *                              MAX_LOAD       = $self.MAX_LOAD,

 *                              CABIN_LABEL    = $self.CABIN_LABEL)

 */

public class Z_CABIN_LABEL implements sce_user_fn

   {

      public boolean execute(fn_args args, Object obj)

      {

            // get the target instance of the PFUNCTION

            ddb_inst inst = args.get_instance();

            // get elevator type from characteristic interface (Input):

            String elevatorType = args.get_value("ELEVATOR_TYPE");

            // get capacity from characteristic interface (Input):

            int capacity = Integer.parseInt(args.get_value("MAX_LOAD"));

            // get elevator options with read method (scelib) from             // configuration:

            String[] elevatorOptions = scelib.get_values(                         inst, "ELEVATOR_OPTIONS");

            // calculate the cabin label

            StringBuffer cabinLabel = new StringBuffer();

            cabinLabel.append(elevatorType);

               if(elevatorOptions.length > 0) {

                  cabinLabel.append("-");

                  for(int i = 0; i < elevatorOptions.length; ++i)

                  cabinLabel.append(elevatorOptions[i]);

            }

            cabinLabel.append(" max load: " + capacity);

            if(cabinLabel.length() > 30)

            throw new IllegalArgumentException(

                        "Z_CABIN_LABEL: maximum length exceeded: "

                        + cabinLabel);

           // set value of cabin label in interface (Output)

            args.set_value("CABIN_LABEL", cabinLabel.toString());

            // NOTE: if you have a multi-valued output parameter or

            // an unknown number of output parameters you can set the             // result values directly in the configuration via             // scelib.set_value:             // EXAMPLE: scelib.set_value(inst, "CABIN_LABEL",             // cabinLabel.toString());

            return true;

      }

   }