Implementation

Reporting firms can use the DRR output for their reporting implementation along 3 approaches that can be combined: Build, Benchmark and Buy.

  • Build. A firm uses the open-source DRR model components and executable code artefacts to develop its own internal implementation.

    • They develop a run-time execution engine that sits on top of the reporting rules and deploy it on their infrastructure.

    • They integrate the DRR code artefacts into their software lifecycle management.

    • They develop their own translation from their internal data formats.

    • They use the Test Pack for quality assurance, running the input data through their implementation and comparing against the expected output.

  • Benchmark. A firm uses the testing capabilities that are freely available under the Community Edition of the Rosetta Platform supporting the DRR and the CDM more broadly to validate their own reporting implementation.

    • These services are designed in the context of the program to support firms’ testing, proof-of-concept or benchmarking of their own implementations, but not production reporting systems – they can only accommodate limited volume and throughput.

    • These services cover all of the Translate / Report / Project steps and are available both via a web interface or API.

    • The Translate and Project services only cover the formats that have been publicly developed and distributed in the CDM and DRR, not firms’ custom formats.

  • Buy. A firm buys a reporting solution from a third-party vendor. That third-party vendor itself has followed the “Build” approach to develop their commercial product (rather than an internal reporting system) based on the DRR output.

The next 3 sections focus on the Build approach. They detail the artefacts included in the DRR output for each of the Translate, Report and Project steps and how reporting firms can use them to develop their implementation. In each case, details of how reporting firms can use the equivalent Benchmark option in Rosetta for testing purposes are also provided.

Translate

Why

  • To transform an internal messaging format into a CDM transaction event object. This CDM object is required as an input to the DRR reporting rules.

What

Where

  • Synonyms are contained in the CDM distribution in .rosetta format. All synonym files in the distribution are contained in the cdm.mapping.* namespaces and prefixed accordingly.

How

Build

  • Synonyms provide a functional specification for how to perform model-to-model mapping. The semantics of synonyms is documented at: https://docs.rosetta-technology.io/rosetta/rosetta-dsl/rosetta-modelling-component/#mapping-component.

  • Synonyms are distributed in machine-readable format so that implementors can use them as input to code-generate their translation’s executable code (in the same way as the CDM’s executable code is generated).

  • A guide for writing a code generator is at: https://docs.rosetta-technology.io/rosetta/rosetta-dsl/rosetta-code-generators/.

  • Depending on their internal model, implementors have three approaches to build their translation:

    • If they use a public model, they should write their own code generator to generate the translation’s executable code from the machine-readable synonym specification.

    • If they use a custom adaptation of a public model, they should extend that translation’s implementation by either:

    • If they use a fully bespoke model that is not adapted from a public one, they will not be able to use the public synonyms and will need to create their own custom translation implementation.

Benchmark

Report

Why

  • To generate a reportable output object in CDM format based on a CDM transaction event input.

What

  • A report is defined by 3 components: what (report fields), whether (eligibility) and when (timing). The “what” is represented by a CDM data type whose attributes are the reportable fields.

  • Each reportable field is associated with a reporting rule component representing the logic to extract or compute that field from a CDM transaction event object.

  • The DRR distribution contains a library component that takes the name of the report and a CDM transaction event object as input and returns a report object. That library is available as a Java JAR and compiled with Java 11, which is required for use.

Where

  • The report and rule definitions are available as .rosetta files in the DRR distribution. The files are contained in the drr.regulation.* namespaces and prefixed accordingly – e.g. drr.regulation.cftc.rewrite.

  • The distribution also contains a library called rosetta-reports to help execute the DRR rules. As this library is protected by copyright, it is only intended to guide implementors in their own build but should not directly support production systems.

  • Work contemplated (for future stage):

    • Aligning the code generation of DRR rules (reporting rule) onto that of Rosetta functions (func) would facilitate implementors’ build of their own execution engine, by providing a single way of using the CDM’s business logic as executable code.

How

Build (test only)

representing a specific report object, called a Blueprint in Rosetta – e.g. CFTCPart45BlueprintReport.

<dependency>
  <groupId>com.regnosys.drr</groupId>
    <artifactId>rosetta-source</artifactId>
    <version>LATEST</version>
</dependency>
  • The rosetta-reports library, which gives access to the ReportApi Java class required to execute a report, can be added as a code dependency – e.g. using maven:

<dependency>
  <groupId>com.regnosys</groupId>
    <artifactId>rosetta-reports</artifactId>
    <version>LATEST</version>
</dependency>
  • To execute a report for a particular DRR version requires the following steps:

    • Create a new ReportApi with the following parameters:

      • body – the body of the report that this class will generate, e.g. "CFTC"

      • corpusList – a list of corpus for the report that this class generates, e.g. List.of("Part45")

      • name – the name of the report to run, e.g. "CFTCPart45"

      • blueprintClass – the class type of the report to run, e.g. CFTCPart45BlueprintReport.class

      • initialisationGuiceModule – the Guice module used to initialise the report runner. The convention for the CDM is: CdmRuntimeModule.class.

    • Create an input CDM object representing the transaction (always a RosettaModelObject sub-type, e.g. ReportableEvent) by either:

      • converting JSON to Java by using a Jackson Object Mapper (the RosettaObjectMapper utility helps set things up),

      • creating a ReportableEvent by Ingesting Record Keeping FpML or other external models into the CDM,

      • creating a ReportableEvent using Java code, or

      • extracting a ReportableEvent from a CDM native implementation.

    • Run the report based on that input CDM object (inputData), to return either:

      • a structured object, according to the report’s specified data type, or

      • a table, i.e. a set of key-value pairs.

Structured object:

public <T extends RosettaModelObject> T
runStructuredReport(RosettaModelObject inputData)

Table:

public Map<String, String> runTabularReport(RosettaModelObject inputData)

Below is a full example using the “CFTC Part 45” reporting regime:

package com.regnosys.drr.examples;

import drr.regulation.common.ReportableEvent;
import drr.regulation.cftc.rewrite.CFTCPart45TransactionReport;
import drr.regulation.cftc.rewrite.blueprint.CFTCPart45BlueprintReport;
import com.regnosys.rosetta.common.serialisation.RosettaObjectMapper;
import com.regnosys.rosetta.reports.api.ReportApi;
import org.isda.cdm.CdmRuntimeModule;

import java.io.File;
import java.io.IOException;
import java.util.List;

public class ReportApiTest {
  public static void main(String[] args) throws IOException {

  // 1. Create the Report Api

  ReportApi reportApi = new ReportApi(
    "CFTC",
    List.of("Part45"),
    "CFTCPart45",
    CFTCPart45BlueprintReport.class,
    CdmRuntimeModule.class);

  // 2. Deserialise a Reportable Event JSON into Java

  ReportableEvent inputData =
    RosettaObjectMapper.getNewRosettaObjectMapper().readValue(new
      File("FILE-LOCATION-OF-REPORTABLE-EVENT-JSON"), ReportableEvent.class);

  // 3. Run the Api and product a CFTCPart45TransactionReport

  CFTCPart45TransactionReport report =
    reportApi.runStructuredReport(inputData);

  // process the result

  System.out.println(report);
  }
}

Note

A similar code example is planned to be contributed as a demo project into the DRR distribution and will be available to download.

Benchmark

Project

Why

  • To convert a CDM reportable output object into a message that is ready to be sent to a Trade Repository.

What/Where/How

  • This component has not been built yet.