Post on 05-Mar-2018
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.
GEFEG.Validation.Portal
• 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
GEFEG.Validation.Portal
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
GEFEG mbH - www.gefeg.com
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
GEFEG mbH - www.gefeg.com
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
GEFEG mbH - www.gefeg.com
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
October 2010GEFEG mbH - www.gefeg.com 10
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
GEFEG mbH - www.gefeg.com
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
GEFEG mbH - www.gefeg.com
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
GEFEG mbH - www.gefeg.com
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
GEFEG mbH - www.gefeg.com
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
GEFEG mbH - www.gefeg.com
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
GEFEG mbH - www.gefeg.com
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
October 2010GEFEG mbH - www.gefeg.com 17
Generated from Schema Guideline
User refinements translated into complexTypes which are derived by restriction
Purpose: Validation.
"Profile Schema" – Purpose: Implementation.
Edit Schematron Rules
October 2010GEFEG mbH - www.gefeg.com 18
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
October 2010GEFEG mbH - www.gefeg.com 19
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
GEFEG.Validation.Portal
–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 info@gefeg.com
Internet www.gefeg.com
October 2010GEFEG mbH - www.gefeg.com 23
Contact