Welcome to Rosetta Core Tutorial

This page will guide you through the features available in Rosetta Core via a selection of use cases.

Tutorial 1

This tutorial covers signing into RosettaCore, creating a workspace and making a series of changes. The tutorial will guide you through a small refactor procedure that changes the location of TradeDate and remaps the FpML synonyms.

You will learn how to use the editor to navigate the CDM, use the content assist, auto-completion, ingest FpML files and inspect the CDM instance document.

Sign in to RosettaCore

To sign into RosettaCore, you can simply press the Rosetta button on the CDM Portal.

../_images/2019-08-09-16-10-44.png

Note

You will only see the Rosetta link if you are part of the beta.

Alternatively, sign in directly using https://ui.rosetta-technology.io with the same credentials as you use for the CDM Portal.

Create new Tutorial workspace

When you sign in for the first time, you will be asked to create a workspace. Create a workspace called Tutorial, select the latest CDM version and give a description of ISDA CDM Tutorial.

../_images/2020-07-15-16-43-46.png

Note

RosettaCore is takes a few seconds to set things up. Please be patient.

Once the workspace is created you are presented with the main screen.

../_images/2020-07-15-16-45-53.png

Ingest FpML data document and view as CDM

To ingest an FpML XML document, click on the Ingestion icon on the App Toolbar. This will bring up a panel to the bottom of the screen.

../_images/ingestion_FpML.png

Download this FpML file & drag and drop to the Ingestion panel. This will automatically convert the FpML file to CDM.

Note

If the ingestion does not happen automatically - the model changes may still be processing. Once ready, press the arrow on the Ingestion panel.

../_images/2020-07-16-15-17-31.png

There are three panels:

  • INGESTION
    • The FpML document to upload and ingest.
  • INPUT
    • The FpML document displayed in a tree view. You can view the XML by hitting the view as code button.
  • CDM
    • The CDM document displayed in a tree view. You can view the JSON by hitting the view as code button.
  • DIAGNOSTICS
    • Diagnostics of the ingestion.

When viewing as code, the screen should look like this:

../_images/2020-07-16-15-25-04.png
note:Notice that there is a green indicator that shows that we ran successfully and the Ingestion is up to date with the model.

On the second panel (INPUT), navigate to tradeDate by clicking in order:

  1. dataDocument
  2. trade
  3. tradeHeader
../_images/2020-07-16-15-30-00.png

To see where the tradeDate maps to in the CDM, click on the date (2018-01-29). You will see the CDM panel open with the correct attribute selected.

../_images/2020-07-16-15-31-32.png

Create dateOfTrade attribute on Contract

Scroll down to tradeDate and create a new attribute called dateOfTrade as follows

dateOfTrade date (1..1)
../_images/2020-07-16-15-55-45.png

Remove synonym on Contract -> tradeDate -> date and view Ingestion

Hover over TradeDate whilst pressing the control key (or the command key on mac). This will show the description of the model element.

../_images/2020-07-16-15-48-28.png

To follow links from Contract to tradeDate, left-click whilst pressing the control key (or the command key on mac). This will navigate you to the Trade Date class.

We want to remove the synonym from the date attribute here and move them to the new dateOfTrade attribute.

Delete the selected line below

../_images/2020-07-16-15-53-12.png

A few seconds after removing the line, RosettaCore will generate new mapping code based on the newly updated CDM in the workspace.

note:Notice the orange indicator showing that there is an update available to ingestion.

Once ready, the arrow on the Ingestion panel will be re-activated and you can re-load the FpML document.

../_images/2020-07-16-15-42-42.png

The red items show that trade date is no longer mapped to the CDM as we removed the synonyms.

Add synonym to Contract -> dateOfTrade and view Ingestion

Now we want to add a synonym to the new dateOfTrade attribute we added.

Click on the back button in the Editor Toolbar a few times to take you back to Contract.

Add in the new synonym:

[synonym FpML_5_10 value "tradeDate" path "tradeHeader"]
../_images/2020-07-16-16-01-34.png

Re-run the ingestion as we did before and check to see where the date is mapped to.

../_images/2020-07-16-16-00-23.png

We have successfully moved the trade date in the CDM.

Search for usages of Contract -> tradeDate

To find all places in the model where the old tradeDate is used, right click on the attribute and select Peek and then Peek References.

../_images/2020-07-16-16-07-17.png

This will show you all the places in the CDM where it is used.

../_images/2020-07-16-16-06-02.png

Pressing the links on the right hand side will show you the places it is used in the model.

Sign out

To finish the session, sign out using the menu on the top right of the screen.

../_images/2020-07-16-16-08-35.png