Show TOC

Mapping Function

Context

A function that enriches data by mapping fields of the input function (data set 1) to target fields of the output function. Generic and key figure results are the mapping categories of this function.

Characteristic mapping can only have a 1 to 1 relationship and will not allow mapping of several input fields to a single target field. However, key figure mapping allows n to 1 relationships. The value of input fields is totaled and assigned as an output field value.

Prerequisites

You must provide two functions with data (source data) under the Environment function or a Calculation Unit function. One function is the input function (data set 1), and one function is the output function (data set 2), to which the results are to be transferred using the Mapping Function. In business scenarios, mapping functions are used by customers to map the results from a calculation unit to a business unit, or from a calculation unit to another calculation unit.

Steps

  1. On the Mapping page, under the Properties roadmap step, choose a Mapping Category from the dropdown list.

    • Generic – allows both Characteristic and Key Figure mapping

    • Key Figure Results - only allows Key Figure mapping.

  2. Choose the Map roadmap step

  3. On the Map roadmap page, choose an Input from the list of functions. The characteristics and/or key figures of that function will be entered automatically in the Fields column of the table.

    • If on step 1, Generic was chosen: The system fills the Fields column with characteristics and/or key figures.

    • If on step 1, Key Figure Results was chosen: The system fills the Fields column with key figures of the input function ID only and will not display the characteristics.

  4. On the Map roadmap page, choose a Target Function from the list of Output Function IDs. The characteristics and/or key figures of the chosen function will then be adopted by the Target Fields column of the table, which can then be used for mapping.

  5. To execute mapping, choose a row or field to be mapped, then open the dropdown list for the target field.

  6. Choose the target field that is intended to adopt the value of the input field.

  7. If the changes are meant to be preserved, choose Save.

  8. To generate, choose Generate.

  9. For a preview, choose Test.

Optional Step

To add and remove of lines, choose the Add and/or Remove buttons. To change the column sequence, use the Up and/or Down buttons.

Example of Mapping

Scenario: Key Figure Mapping
Source Data

Contract

Coverage

Product

Channel

Premium

Amount

Legal Cost

20150000

6981

224

92H2

787

1049

755

20150000

6982

224

92H2

411

548

395

20150001

6983

224

92H2

662

882

635

20150002

6984

238

CXHO

1905

2540

1829

20150003

6985

238

CXHO

782

1042

750

20150004

6986

238

CXHO

684

912

657

20150005

6987

238

CXHO

1465

1954

1407

20150006

6988

238

92H2

2870

3826

2755

20150007

6989

238

92H2

2809

3745

2696

20150008

6990

238

92H2

1404

1872

1348

20150009

6990

238

92H2

1221

1628

1172

Mapping Rules

Source Key Figure

Target Key Figure

Premium

Margin

Amount

Principal

Legal Cost

Principal

This mapping example transfers values from Premium to Margin and aggregates the values of Amount and Legal Cost into Principal. In addition, the values of the KFs are aggregated based on the matching characteristics in the target calculation unit. If all characteristics are found in the target, then only the KFs are mapped.

Result

Contract

Coverage

Product

Channel

Principal

Margin

20150000

6981

224

92H2

1805

787

20150000

6982

224

92H2

943

411

20150001

6983

224

92H2

1518

662

20150002

6984

238

CXHO

4369

1905

20150003

6985

238

CXHO

1792

782

20150004

6986

238

CXHO

1568

684

20150005

6987

238

CXHO

3361

1465

20150006

6988

238

92H2

6581

2870

20150007

6989

238

92H2

6441

2809

20150008

6990

238

92H2

3221

1404

20150009

6990

238

92H2

2801

1221

Scenario: Generic Mapping
Source Data

Asset ID

Charge C/C

Product

Channel

Curr

Base Price

Premium

Service

VAT

Legal

ASS001

CC01

PRD01

CH01

KRW

10000

20000

30000

-30000

20000

ASS002

CC02

PRD02

CH02

KRW

20000

0

30000

20000

20000

ASS003

CC03

PRD03

CH02

KRW

40000

20000

30000

40000

20000

Mapping Rules

Source Field

Target Field

Asset ID

" "

Charge C/C

" "

Product

Ins_Product

Channel

Channel

Base Price

Amount

Premium

Amount

Service

Amount

VAT

Misc

Legal

Misc

Result

Ins_Product

Channel

Curr

Amount

Misc

PRD01

CH01

KRW

60000

-10000

PRD02

CH02

KRW

50000

40000

PRD03

CH02

KRW

90000

60000