Hi Friends,


While doing the Variant configuration, we may came across scenarios where std. syntax of VC will not be sufficient. For this type of scenarios, we can use Variant functions to achieve the desired functionality.  Variant functions will use Function Modules, here we have to write the code using ABAP.

Overview

Variant functions allow us to integrate the function modules with all types of object dependencies. In the object dependencies we need to use the syntax for calling the function module as well as input and output parameters.

Variant conditions used where standard syntax is not sufficient to map desired functionality. This may be possible in following cases.

  • Complex processing of Char. values
  • Evaluation of database tables that cannot be addressed via reference characteristics.
  • Complex validity checks of allowed char. values.
  • Generation of custom information messages.

Example:

Using variant function to concatenate values of three characteristics into another characteristic.

Chars

Values

Processor

  • Core i7
  • Core i5
  • Core i3

Hard Disk

  • 500 GB
  • 750 GB
  • 1 TB

RAM

  • 2 GB
  • 4 GB
  • 6 GB

Label

Above 3 char selected values should be concatenated and displayed as label.

 

Creation of Variant Function:

T.Code: CU65

For creating variant function we have to provide required input and output parameters for the function module.

/wp-content/uploads/2015/05/1_714502.png

Give Function Name and Description   Click on Characteristics

/wp-content/uploads/2015/05/2_714524.png

Assign required input and output characteristics and save the variant function. In the above example PROCESSOR, HARD_DISK, RAM are input parameters.

Creating Function Module:

Note: For creating Function Modules requires developer access.

Open the variant function in change mode in CU66 T.code and click on Function Module button.

Function builder initial screen will appear system will propose the function module name click on Create button.

/wp-content/uploads/2015/05/3_714525.png

Enter the required details and press save button.

 

Interface of the Function Module

Import Parameters

Parameter Name

Typing

Reference Field

Content

GLOBALS

LIKE

CUOV_00

Global parameters for calling a function. However, the list of fields currently only contains the date.

/wp-content/uploads/2015/05/4_714526.png

Tables

Parameter Name

Typing

Reference Type

Content

QUERY

LIKE

CUOV_01

Table of input parameters and the expected output parameters

MATCH

LIKE

CUOV_01

Table of output parameters

All partial fields except ATCIO must be filled in a MATCH entry (especially format ATFOR)

Structure CUOV_01 comprises the following fields:

  • VARNAM (characteristic name)
  • ATFOR (format of the value)
  • ATWRT (alphanumeric characteristic value in internal format)
  • ATFLV (numeric characteristic value)
  • ATCIO (Indicator: input (I) or output (O) parameter)

  The fields ATFOR, ATWRT, and ATFLV only have values assigned for input parameters.

/wp-content/uploads/2015/05/5_714527.png

Exceptions:

FAIL

This exception shows that the condition represented by the function is not fulfilled.

INTERNAL_ERROR

This exception shows that a runtime error has occurred processing the function.

/wp-content/uploads/2015/05/6_714528.png

Source Code : Used for writing your own logic for the function module using ABAP.

The following help functions are supported for accessing import parameters:

  • CUOV_GET_FUNCTION_ARGUMENT: Read characteristics from the input parameters.
  • CUOV_GET_FUNCTION_ARGUMENT: Transfer value of characteristics to Variant configuration.

/wp-content/uploads/2015/05/7_714529.png

Write the ABAP code and Save and activate the function module.

Press back button, system will display the Change Function transaction.  Change the status to 1 – Released and Save Function.

/wp-content/uploads/2015/05/8_714534.png

Call Variant Function

Write the Procedure and assign it to configuration profile of the material. Below is the procedure for this example.

FUNCTION ZCOMP_LABEL

(PROCESSOR = $ROOT.PROCESSOR,

HARD_DISK = $ROOT.HARD_DISK,

RAM = $ROOT.RAM,

LABEL = $SELF.LABEL)

The characteristics on the left-hand side are characteristics of the function. The characteristics on the right-hand side are characteristics of the PC.

Characteristic LABEL must be referred to with the variable $SELF, because LABEL is a characteristic of the object currently being processed. Otherwise, values cannot be inferred. The default object $ROOT is assumed for the other characteristics.

Testing

As soon as all values assigned to the characteristics of variant function, function module will sets the value for LABEL.

/wp-content/uploads/2015/05/9_714535.png

Note:

When you call a user-defined function module, SAP Variant Configuration no longer has control of possible error situations: the person who writes the function module can use all ABAP language elements, but has sole responsibility for the code.

 

Example code for Function Module

FUNCTION ZCOMP_LABEL.
*”———————————————————————-
*”*”Local Interface:
*”  IMPORTING
*”     REFERENCE(GLOBALS) LIKE  CUOV_00 STRUCTURE  CUOV_00
*”  TABLES
*”      QUERY STRUCTURE  CUOV_01
*”      MATCH STRUCTURE  CUOV_01
*”  EXCEPTIONS
*”      FAIL
*”      INTERNAL_ERROR
*”———————————————————————-

DATA : LV_PROCESSOR TYPE CUOV_01ATWRT,
LV_HARDDISK
TYPE CUOV_01ATWRT,
LV_RAM
TYPE CUOV_01ATWRT,
LV_LABEL
TYPE CUOV_01ATWRT.

REFRESH MATCH.

CALL FUNCTION ‘CUOV_GET_FUNCTION_ARGUMENT’
EXPORTING
ARGUMENT           
= ‘PROCESSOR’
IMPORTING
*   VTYPE               =
SYM_VAL            
= LV_PROCESSOR
*    NUM_VAL             =
*   IO_FLAG             =
TABLES
QUERY              
= QUERY
EXCEPTIONS
ARG_NOT_FOUND      
= 1
OTHERS              = 2
.
IF SYSUBRC <> 0.
* Implement suitable error handling here
ENDIF.

CALL FUNCTION ‘CUOV_GET_FUNCTION_ARGUMENT’
EXPORTING
ARGUMENT           
= ‘HARD_DISK’
IMPORTING
*   VTYPE               =
SYM_VAL            
= LV_HARDDISK
*    NUM_VAL             =
*   IO_FLAG             =
TABLES
QUERY              
= QUERY
EXCEPTIONS
ARG_NOT_FOUND      
= 1
OTHERS              = 2
.
IF SYSUBRC <> 0.
* Implement suitable error handling here
ENDIF.

CALL FUNCTION ‘CUOV_GET_FUNCTION_ARGUMENT’
EXPORTING
ARGUMENT           
= ‘RAM’
IMPORTING
*   VTYPE               =
SYM_VAL            
= LV_RAM
*    NUM_VAL             =
*   IO_FLAG             =
TABLES
QUERY              
= QUERY
EXCEPTIONS
ARG_NOT_FOUND      
= 1
OTHERS              = 2
.
IF SYSUBRC <> 0.
* Implement suitable error handling here
ENDIF.

CONCATENATE LV_PROCESSOR LV_HARDDISK LV_RAM INTO LV_LABEL SEPARATED BY ‘|’.

CALL FUNCTION ‘CUOV_SET_FUNCTION_ARGUMENT’
EXPORTING
ARGUMENT                     
= ‘LABEL’
VTYPE                        
= ‘CHAR’
SYM_VAL                      
LV_LABEL
*   NUM_VAL                       =
TABLES
MATCH                        
= MATCH
EXCEPTIONS
EXISTING_VALUE_REPLACED      
= 1
OTHERS                        = 2
.
IF SYSUBRC <> 0.
* Implement suitable error handling here
ENDIF.
ENDFUNCTION.

To report this post you need to login first.

8 Comments

You must be Logged on to comment or reply to a post.

  1. paul kohl

    Ravi kumar ,

    I just did a quick read and find it very useful, can you tell me even if i have very little knowledge knowledge on ABAP can i build it in sand box? or do you want me to suggest to read few document on ABAP which will help me using this document effectively.

    My request is if you can add some more information on basic ABAP understanding one should develop while building this example will made this document awesome.

    Hope you will agree on it. 🙂

    Thanks

    Pal

    (0) 
  2. Raghu S

    Hi Ravi,

    Thanks for your effort on document its great..!

    I have a query, how to address this when we have series of trasports flowing from DEV – Q – P?

    Chars. are master data, can be present in all three servers, but the if function module we need to create through CU66, then i am confused if its client to cleint creation or to move FM from DEV to Q to P?

    How to address this situation?

    Thanks..!

    (0) 
    1. flavio ciotola

      Hi Raghu,

      Indeed, we have two objects when dealing with variant functions:

      • the variant function itself (CU66)
      • the ABAP function (SE37)

      So, the first is usually tranported by ALE, transaction CUFD – ‘Distribute Variant Functions’, that will generate a ‘VFNMAS’ ALE message. It can then be imported in the other systems in the flow (Q & P) via BD87 (IDocs).

      The second is an ABAP object, usually transferred to the other system with Transport Orders.

      Hope this is helping in some way.

      Thanks and best regards,

      Flavio

      (0) 
  3. Adithya Shekhar

    Very useful document with a simple example, easy to understand for beginners in Variant Functions.

    Just one clarification needed; if I have a scenario, where I need to set two characteristics for output, can this also be done?

    Please let me know.

    Thanks

    Adithya

    (0) 

Leave a Reply