Convert financial perspectives

post https://{host}/riskmodeler/v1/analyses/{id}/map-perspective

Generates a new analysis based on an existing analysis by converting the financial perspective used in the original analysis to a new financial perspective. This is known as financial service mapping.

Financial service mapping serves three distinct business scenarios depending on the mapping option (mapPerspectiveOption) specified.

If INCLUDE_DOWNSTREAM is specified, the service maps the sourcePerspective to the newPerspective and copies the mapping to all downstream perspectives except reinsurance gross (RG) and reinsurance net (RN). The downstream perspectives (except RG and RN) return same results as the specified newPerspective.
If DELETE_OTHER is specified, the service maps the sourcePerspective to the newPerspective and deletes records for all perspectives other than the newPerspective including the sourcePerspective. All perspectives other than the specified newPerspective return a value of 0.
If SELECT_OTHER is specified, the service maps the sourcePerspective to newPerspective. All other downstream and upstream perspectives are unchanged.

Once the MAP_PERSPECTIVE job is complete, the operation adds an result with a new ID and name to the the RDM. If the optional analysisName body parameter is not specified, the name of the new analysis result appends the string _PERSP to the name of the base analysis.

🍐
Permissions
To perform this operation, a principal must belong to a group that has been assigned the appropriate role-based permissions. The table identifies the roles with permission to perform this operation.
Underwriter Technical Underwriter Risk Analyst Portfolio Manager Cat Modeler
YES YES YES YES YES
To learn more about role-based permissions in Risk Modeler, see Groups and Roles.

Underwriter	Technical Underwriter	Risk Analyst	Portfolio Manager	Cat Modeler
YES	YES	YES	YES	YES

Financial perspectives

Financial perspectives are understood to be upstream or downstream of one another. Upstream perspectives are higher in the table than downstream perspectives.

Financial perspectives are identified by a two-character string.

GU Ground Up Loss
GS Ground Up Specified Loss
G2 Ground Up Loss - Secondary Peril
G1 Ground Up Loss - Primary Peril
CL Client Loss
UC Underlying Coverage
OL Over Limit Loss
OI Other Insurer’s Loss
GR Gross Loss
FA Faculative Reinsurance Loss
SS Surplus Share Treaty Loss
QS Quota Share Treaty Loss
WX Working Excess Treaty Loss
RL New Loss Pre Cat
RP Net Loss Post Cat
RC Net Loss Post Corporate Cat
RG Reinsurance Gross Loss
RN Reinsurance New Loss

The client can call the Get perspectives by analysis service to retrieve the list of financial perspectives.

Path Params

int32

required

≥ 1

ID of the base analysis.

Body Params

analysisName

string

length between 0 and 64

The name for the analysis with converted rates and/or losses. Valid characters: 0-9, A-Z, a-z, _ (underscore), - (hyphen), and '' '' (blank space). String cannot start or end with a hyphen (-), colon (:), or blank space and cannot include multiple consecutive hyphens (--).

sourcePerspective

string

required

Two character string for financial perspective in base analysis.

newPerspective

string

required

Two character string for financial perspective in new analysis.

mapPerspectiveOption

string

required

Option for mapping financial perspectives.

If INCLUDE_DOWNSTREAM, maps sourcePerspective to newPerspective and copies mapping to all downstream perspectives except RG and RN. Downstream perspectives (except RG and RN) return same results as the specified newPerspective.
If DELETE_OTHER, maps sourcePerspective to newPerspective and deletes records for all perspectives other than newPerspective including sourcePerspective. All perspectives other than the newPerspective return a value of 0.
If SELECT_OTHER, maps the sourcePerspective to newPerspective. All other downstream and upstream perspectives are unchanged.

Responses

`MAP_PERSPECTIVE` job was added to the workflow engine queue for processing. Returns a URL in the `Location` header that enables you to track the status of the job e.g. `/{host}/v1/workflows/100000`. Send periodic HTTP GET requests to the URL for the job status. See Workflow Engine.

xxxxxxxxxx
curl --request POST \
     --url https://api-euw1.rms.com/riskmodeler/v1/analyses/id/map-perspective \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "mapPerspectiveOption": "INCLUDE_DOWNSTREAM"
}
'

🍐Permissions

Financial perspectives

202Accepted: A MAP_PERSPECTIVE job was added to the workflow engine queue for processing. Returns a URL in the Location header that enables you to track the status of the job e.g. /{host}/v1/workflows/100000. Send periodic HTTP GET requests to the URL for the job status. See Workflow Engine.

400Bad Request: Please check that you are provided all required values.

403Forbidden: Access to this resource is denied or not authorized to perform the "Financial Re-Mapping" action.

🍐
Permissions

`MAP_PERSPECTIVE` job was added to the workflow engine queue for processing. Returns a URL in the `Location` header that enables you to track the status of the job e.g. `/{host}/v1/workflows/100000`. Send periodic HTTP GET requests to the URL for the job status. See Workflow Engine.