####
Test
####


****
NAME
****


Kernel::GenericInterface::Mapping::Test - GenericInterface test data mapping backend


****************
PUBLIC INTERFACE
****************


new()
=====


usually, you want to create an instance of this
by using Kernel::GenericInterface::Mapping->new();


Map()
=====


perform data mapping

possible config options for value mapping are
- 'ToUpper', turns all characters into upper case
- 'ToLower', turns all characters into lower case
- 'Empty', sets to empty string

if no config option is provided or one that does not match the options above, the original data will be returned


.. code-block:: perl

     my $Result = $MappingObject->Map(
         Data => {               # data payload before mapping
             ...
         },
     );
 
     $Result = {
         Success         => 1,   # 0 or 1
         ErrorMessage    => '',  # in case of error
         Data            => {    # data payload of after mapping
             ...
         },
     };



_ToUpper()
==========


change all characters in values to upper case


.. code-block:: perl

     my $ReturnData = $MappingObject->_ToUpper(
         Data => {                   # data payload before mapping
             'abc' => 'Def,
             'ghi' => 'jkl',
         },
     );
 
     $ReturnData = {                 # data payload after mapping
         'abc' => 'DEF',
         'ghi' => 'JKL',
     };



_ToLower()
==========


change all characters in values to lower case


.. code-block:: perl

     my $ReturnData = $MappingObject->_ToLower(
         Data => {                   # data payload before mapping
             'abc' => 'Def,
             'ghi' => 'JKL',
         },
     );
 
     $ReturnData = {                 # data payload after mapping
         'abc' => 'def',
         'ghi' => 'jkl',
     };



_Empty()
========


set all values to empty string


.. code-block:: perl

     my $ReturnData = $MappingObject->_Empty(
         Data => {                   # data payload before mapping
             'abc' => 'Def,
             'ghi' => 'JKL',
         },
     );
 
     $ReturnData = {                 # data payload after mapping
         'abc' => '',
         'ghi' => '',
     };