Market Practice Design-time Tools for ISO 20022 - GEFEG · PDF fileMarket Practice Design-time Tools for ISO 20022 GEFEG.FX GEFEG.

Market Practice Design-time Tools for ISO 20022

GEFEG.FX

GEFEG.Validation.Portal

About GEFEG

Design-time specialist.

Software and consultancy for analysis, design and documentation of electronic business messages using UML, XML and classic EDI

Actively involved in national and international standard developing organizations

Extensive customer base (750+) in many industries

Global reach (35 countries)

Promoting EDI technologies since 1990

Based in Berlin, Germany

October 2010 2GEFEG mbH - www.gefeg.com

Market Practice Design-time

GEFEG.FX

• Design-time software made especially

for B2B data format specialists.


• Web application to help with trading

partner on-boarding or building a B2B

community.

October 2010GEFEG mbH - www.gefeg.com 3

Deliverables

GEFEG.FX

Schema documentation with context refinements

Mapping documentation

Pure schema, Profile Schema, Validation Schema

Initial XML instances

Schematron validation rules file

Validation

GEFEG mbH - www.gefeg.com


Validation

Publication

Optional form view of instances

October 2010 4

GEFEG.FX - Design-time Tool

To define and explain usages of B2B messages a wide range of tools may be used: a UML tool, an XML tool, a text processor, a spreadsheet and separate sources for code values on top.

One for all: GEFEG.FX combines message design and message explanation functions in one comprehensive tool.

The tool’s specialisation in message design creates exciting benefits like saving time and efforts while increasing message specification quality.

GEFEG mbH - www.gefeg.com October 2010 5

Documentation


Improved overview on the data and better understanding of the planned implementation as a result of marked-up, auto-generated documentation

Documentation production in HTML, RTF(PDF), CHM file formats facilitates the distribution of the working results and final versions.

October 2010 6

Profile Schema File


Production of human readable documentation and machine readable output in the same software eliminates the need to maintain the same data in different tools.

Packed MX Schema for implementation

See also “Validation Schema” further down

October 2010 7

The GEFEG.FX.Manager

The GEFEG.FX.Manager is the entry point to GEFEG.FX.

From here the SWIFT SDK.MX Repository can be imported, which is an XML file containing the ISO 20022 UML classes.

From these UML classes normalised or self-contained ISO 20022 XSD schemas can be generated, enriched by full names and enhanced definitions.

"XML Schemas" can also be imported from XSD files or edited from scratch.

"Mapping projects" are an aid to compare different formats (e.g. FIX Protocol schemas with ISO 20022) and to document the data field relations

The "Test data" section is used for validation of instance files

"Publishing projects" can be used to generate comprehensive, hyperlinked, multi-standards manuals

October 2010 8GEFEG mbH - www.gefeg.com

Another View on ISO 20022 UML


ISO 20022 UML imported from SWIFT MX Repository and displayed in GEFEG.FX.

The UML class representation as an instance-like tree makes it easier to understand the message structures and thereby facilitates communication between IT experts and the business stake-holders. It was designed to replace spreadsheets and text processors in meetings: information collected here is easy to understand, very precise and reusable.

October 2010 9

ISO 20022 UML Guideline


The original model was packed to two messages

Textual annotations by "notes"

Notes are user-definable

Market practice guidelines could also be developed based on UML, but most users prefer to use the XSDs for such.

Guidelines - Native Working Mode of GEFEG.FX


Original model/schema

(paper sheet)

A guideline works like a transparent sheet overlaying a paper sheet.

Customisations are documented independently onto the transparent sheet instead of onto the underlying paper sheet.

Customisation

(both sheets together)

User view (GUI)

Deltas only

(transparent sheet)

Data view

–E

–E

–E

–E

–E

October 2010 11

Schema Guidelines


The advantage of XML over paper: Customisations can automatically re-align with the final schema due to the XML tags.

In case that XML tags or even the type hierarchy were changed from a schema to a later version of a schema (incompatible changes), then the tool helps to manually re-align customisations by drag & drop.

October 2010 12

Schema Guidelines in the GEFEG.FX.Manager


Schema guidelines are annotated with the blue “S” symbol

A schema guideline is like a transparent layer over the original schema. It looks the same (the previous slide was taken from a guideline), but contains customisation information only.

If the base schema is replaced by a later version (e.g. from draft to final) all customisations are retained in the transparent layer and automatically aligned onto the newly updated base schema.

October 2010 13

Refining Schemas: Context Restrictions and Remarks


Only usage of 'ISIN' element is permitted in this context.

Notes in GEFEG.FX provide xsd:documentation with a more detailed structure.

Notes in contexts prevent from maintaining parallel text documents

Notes from base structures are visible also in contexts

October 2010 14

Changes to Cardinality and Field Length


User restricted values and original values are visible next to each other

The tool allows true subset restrictions only

Here, "MaxOccurs" and "MaxLength" were decreased

October 201015

Code (Enumeration Value) Restrictions


In EDI/B2B, enumeration values are normally codes

External code lists, if not present in the schemas, can be bound to simple types and can also be restricted to a value subset.

Here, a currency code list was bound and it was decided to use only two currencies in this context

October 2010 16

Validation Schema


Generated from Schema Guideline

User refinements translated into complexTypes which are derived by restriction

Purpose: Validation.

"Profile Schema" – Purpose: Implementation.

Edit Schematron Rules


Schematron (ISO/IEC 19757-3:2006) is a standardized language for the formal specification of rules.

In GEFEG.FX, such specifications are recorded in a special note type.

An integrated test tool allows such rules to be tested immediately against an XML instance.

Validation Within GEFEG.FX


Test data folders bind data with their specification

Here the data is stored in an SVN repository, hence the green ticks which mean "unchanged, up-to-date"

20

pain.008 – 2– pain.002 Mapping

October 2010GEFEG mbH - www.gefeg.com


–Search… –Load file

Single point of truth for communities

Improving relationship with implementers

Validation not only against schema, but also against context refinements elaborated within GEFEG.FX

Can be enriched with form view

21GEFEG mbH - www.gefeg.com October 2010

Form

It shows the content of a direct debit message

Implemented by XSL-FO

Could be designed with frames and colours

22GEFEG mbH - www.gefeg.com October 2010

GEFEG mbH

Storkower Str. 207

10369 Berlin

Germany

Phone +49-30-979914-0

Email [email protected]

Internet www.gefeg.com


Contact

Market Practice Design-time Tools for ISO 20022 - GEFEG · PDF fileMarket Practice Design-time Tools for ISO 20022 GEFEG.FX GEFEG.

Documents