EclipseConEurope2012 SOA - Models As Operational Documentation
Upcoming SlideShare
Loading in...5
×
 

EclipseConEurope2012 SOA - Models As Operational Documentation

on

  • 823 vues

At Eclipse Con Europe 2012 in the SOA Symposium track, JWT's EMF model export to structure and information in Document Management Systems is explained and demonstrated for in the case of the EasySOA ...

At Eclipse Con Europe 2012 in the SOA Symposium track, JWT's EMF model export to structure and information in Document Management Systems is explained and demonstrated for in the case of the EasySOA service documentation registry, with JWT workflows producing a basis for SOA operational documentation.

Statistics

Vues

Total Views
823
Views on SlideShare
823
Embed Views
0

Actions

Likes
0
Downloads
5
Comments
0

0 Ajouts 0

No embeds

Accessibilité

Catégories

Détails de l'import

Uploaded via as Adobe PDF

Droits d'utilisation

© Tous droits réservés

Report content

Signalé comme inapproprié Signaler comme inapproprié
Signaler comme inapproprié

Indiquez la raison pour laquelle vous avez signalé cette présentation comme n'étant pas appropriée.

Annuler
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Votre message apparaîtra ici
    Processing...
Poster un commentaire
Modifier votre commentaire

EclipseConEurope2012 SOA - Models As Operational Documentation EclipseConEurope2012 SOA - Models As Operational Documentation Presentation Transcript

  • Models as Operational DocumentationSOA Use Case for EMF to ECMEclipse Con Europe 2012 – SOA Symposium Marc Dutoo (Open Wide, FR) Confidential | Date | Other Information, if necessary © 2002 IBM Corporation
  • About the speakers  Open Wide • Among leading Open Source service providers in France • Solutions for business (Portals, Portals, BI) & integration (SOA, BPM, ESB) • Subsidiaries : hosting, embedded software  Marc Dutoo - SOA, BPM, ECM architect • Head of R&D Dept. at Open Wide • SOA, BPM, ECM expert • co-leads Eclipse SOAs Java Workflow Tooling  With thanks to • Yoann Rodière, Open Wide • EasySOA project partners Nuxeo and EasiFab • JWT Project partnersEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 2
  • Agenda • The problem • The solution • Challenges • Architecture • SOA use case and demoEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 3
  • Problem : with your models, how can you… Internal Communication communication with customer => from model,… communicate around yourmodel ? export… Reference Data Formal knowledge… publish it and make it Embedded in model :available to business actors ? (Models) information, documentation, comments… go from design information Generated from model :(model) about your system, to classifications, ontologies,documenting the developed, image previewsoperated, usable system ? And link with companion Assessment… keep an accessible (Testing, monitoring, ...) informal knowledge,reference all along the life of .doc .odt .ppt .odp .xlsyour system ? .png .svgEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 4
  • This is especially useful in SOA ! SOA is first and foremost document(ation) • Which services are provided where, when, at which conditions • Formal interfaces (beware of death by too few or too many WSDLs) • Its requirements are born of collaboration between usually separate entities with different (if not opposing) concerns Several candidate editors in Eclipse SOA : BPMN2, SCA & Mangrove, Startdust’s… … enter Java Workflow Tooling Versatile Business Process and Workflow Tooling and platform Various views (UML AD, EPC) and model extensions Compatibility (transformations) to other representations (BPMN, Mangrove…) Export to executable workflow formats (Bonita, jPDL…) … Synchronization of documentation with Document Management Systems !Eclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 5
  • Solution: Document Management Systems (DMS) • But exporting it merely to filesystem ?? • Problems : local, classification, (tree) versioning, metadata => Enterprise Content Management (ECM) No loss of information – Rich structure: metadata, relationships, multiple views Consistency – Automatic versioning, – workflows, – custom model Online: sharing, collaborative editing, discussionEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 6
  • Paradigm Fight : File-centric vs. Content-centricFile-centric Content-centric – Simple documents – Abstract entities – Metadata: – Metadata: • Size: 580kb • Comment: “lol awesome” • Last edited by: user33 • Endpoint URL: – Relationships: http://example.org/?wsdl • Folder/File – Relationships: (composition) • High-level: “Service As – Workflows: implementation depends on Service B” • User-defined – Workflows: • Enforced by a policyEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 7
  • Solution : we need a bridge ! Eclipse Document Management System Editor model Business model Eclipse/DMS bridge Eclipse/Filesystem bridge • Consistency ! • Eclipse Resources : not enough XML, ...Eclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 8
  • Solution: Generic Eclipse/DMS bridge requirements • One-way synchronization – Export the editor model to the DMS – Information extracted from the editor model is overwritten in the DMS mapped objects – the editor is the only accepted source for these DMS objects (which should be locked otherwise) and fully controls them – But accept linked DMS objects that come from other sources (such as from DMS document import UI) • DMS-agnostic • Business model-agnostic – It should adapt to any business model on the DMS sideEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 9
  • Solution: From Editor model to DMS Model Eclipse Editor CMIS metamodel metamodel Editor model Wanted model Business-aware transformation Sync (editor- and (generic) business-specific)Eclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 10
  • Solution: from Eclipse to DMS Eclipse CMIS metamodel Editor metamodel DMS DMS model DMS model Editor model Business-aware Synchronization transformation (generic) • CMIS : DMS standard interface – client : Apache Chemistry, (almost) already in Eclipse • Transformation : ATL for EMF to EMF – With several editors, an exponential number of them required => intermediate model (who said Mangrove ?)Eclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 11
  • Solution: overall architecture of JWT DMS Export Editor to CMIS = to be model ATL developed transformation according to Input ATL VM editor & DMS business Editor models model CMIS EMF model Matching strategy Input Synchronizer CMIS DMS Sync filtering strategyEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 12
  • SOA Case Study : EasySOA 101 A unified service registry for all actors of the SOA process, on top of Nuxeo DM Service audit and discovery – From design, source, classpath, web, monitoring… Service documentation – Extracted, manual, collaborative editing SOA sanity check – indicators and validation, from design time to monitoring Testing tools : record / (templatized) replay, SOAPUI Integrated RAD platform : FraSCAti Studio Integrated ESB platform : Talend ESB and Jasmine monitoringEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 13
  • SOA Case Study with JWT and EasySOA • From a workflow to SOA documentation – JWT workflow package => – “Business“ folder with author, source, version, description – as well as JWT workflow files – JWT Activity (process) => “Process” folder with SVG export of the diagram – JWT Action using a WebServiceApplication : – Action => business Service – WebServiceApplication => Endpoint with uploaded WSDL – Comments on all JWT objects goes as documentationEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 14
  • SOA Case Study – showtime !Eclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 15
  • SOA Case Study – showtime !Eclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 16
  • SOA Case Study – showtime !Eclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 17
  • SOA Case Study with JWT and EasySOA • Now… – Architects can browse services and endpoints along the generated business classification – Information about business processes (including image preview) can be published along textual specification documents to end users – Business-time documentation is available to developers, linked to implementations and endpoints they develop • In production… – This documentation model will again have been enriched – by information extracted at development time (source documentation) – but also from staging and SOA assessment time – This aggregated requirements-to-solution documentation of the SOA process will be versioned and locked, as a reference to all actors during the operational lifetimeEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 18
  • Conclusion Produce SOA documentation structure and information in DMS out of SOA models • One-way synchronization of matched & filtered elements • Thanks to ATL model transformation & CMIS DMS standard What’s next – JWT DMS Export : – from ecm_support branch to trunk – More models ? BPMN2, SCA, Stardust… – EasySOA : full SOA requirements model, then 1.0 – Scarbo 2 : SOA-consistent BPM platform based on Eclipse tooling (JWT, SCA) and OW2 runtime (FraSCAti service platform and Bonita workflow engine) – … hopefully for Christmas Eclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 19
  • Thanks for your attention ! Any questions??? …And you, how do you document your services ? Contact : marc.dutoo AT openwide.fr JWT website & wiki: http://www.eclipse.org/jwt EasySOA website : http://www.easysoa.org We thank for his assistance:  Yoann Rodière, Open Wide  EasySOA Project members Nuxeo and EasiFabEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 20
  • BONUSEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 21
  • Problem : what to export ? • The simplest: editor files, image files – For archive, for reference, for description • More advanced: a refined, componentized model extracted from the editor model – Example: an SOA “System” entity • with references to “Systems” it depends on, actors involved, target business requirements... • Each of them may carry – attached documents (editor files, image files, text documents) – meta-data (commercial name, current endpoints, source location, ...) • Browsing a tree of Systems allows for easier, business-focused access to dataEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 22
  • Problem : documenting from Eclipse PNG PNG PNG Eclipse editor model Informal knowledge *.doc *.odt *.html ... P:projectssaveTheWorldv123models_bak2export0023_v2_tmp.rtf Problems : local, classification, (tree) versioning, metadataEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 23
  • Solution: Making synchronization generic CMIS metamodel Eclipse DMS Wanted model Outdated model (Somehow) CMIS callsEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 24
  • Solution: the matching challenge Eclipse CMIS metamodel Editor metamodel DMS DMS model DMS model Editor model Business-aware Synchronization transformation (generic) • CMIS : DMS standard interface – client : Apache Chemistry, (almost) already in Eclipse • Transformation : ATL for EMF to EMF – With several editors, an exponential number of them required => intermediate model (who said Mangrove ?)Eclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 25
  • Solution: the matching challenge • “light” integration to existing editors – We cant change their models, their file format, etc. • How do we match two objects, – one on the editor side and one on the DMS side? – By ID? • editor-generated IDs (DMS-provided IDs could not be stored in the editor) – By path? • Does not allow file move detection • But it is a good fallback method, if we cant provide unique, consistent IDs – With complex queries (non-atomic IDs)? – By another way? We may reference objects that werent generated by the editor! • It depends on the business model – (which may be preexisting and immutable) – The bridge should not assume anything regarding matchingEclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 26
  • Solution: the filtering challenge • Changes can stem not only from the editor, but also from other sources – Web interface users – Other editors with the same bridge – Automatic DMS clients – ... • Fortunately, we dont need to know where these changes came from (three-way synchronization) since we only propagate changes one way • But the bridge still need to know what change should be overwritten, and which one should not • So how to select meaningful, non-overwritable changes?Eclipse Foundation, Inc. | © 2012 by Open Wide - Made available under the EPL v1.0 27