Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Agile documentation with Confluence and Sparx Enterprise Architect


Published on

A presentation showing how one can create high quality agile software architecture documentation by creating a mashup of Confluence and the Sparx Enterprise Architect UML tool.

The source code for the Sparx EA diagram export tool is now available on github:

Published in: Technology
  • didn't get the context of word Agile in title. The integration between tools is undoubtedly very useful, but it has nothing to do with agile
    Are you sure you want to  Yes  No
    Your message goes here
  • Hi Per, I might be very daft, but is there a transcript of the slides somewhere?
    Are you sure you want to  Yes  No
    Your message goes here
  • @pspilling
    I tried to execute steps given at link

    but got error below:
    C:\Program Files (x86)\Sparx Systems\EA\Java API> mvn install:install-file -DgroupId=org.sparx -DartifactId=eaapi -Dversion=1.0.0 -Dpackaging=jar -Dfile=eaapi.jar
    [INFO] Scanning for projects...
    [INFO] Searching repository for plugin with prefix: 'install'.
    [INFO] org.apache.maven.plugins: checking for updates from central
    [WARNING] repository metadata for: 'org.apache.maven.plugins' could not be retrieved from repository: central due to an error: Error transferring file: Connection timed out: connect
    [INFO] Repository 'central' will be blacklisted
    [WARNING] Unable to get resource 'org.apache.maven.plugins:maven-install-plugin:
    pom:2.2' from repository central ( Error transfer
    ring file: Connection timed out: connect
    [INFO] ------------------------------------------------------------------------
    [INFO] ------------------------------------------------------------------------
    [INFO] Error building POM (may not be this project's POM).
    Project ID: org.apache.maven.plugins:maven-install-plugin

    Reason: POM 'org.apache.maven.plugins:maven-install-plugin' not found in repository: Unable to download the artifact from any repository

    from the specified remote repositories:
    central (
    for project org.apache.maven.plugins:maven-install-plugin
    [INFO] ------------------------------------------------------------------------
    [INFO] For more information, run Maven with the -e switch
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time: 42 seconds
    [INFO] Finished at: Thu Aug 22 16:12:45 BST 2013
    [INFO] Final Memory: 1M/4M
    [INFO] ------------------------------------------------------------------------

    Could you please help me out in resolving the same.
    Are you sure you want to  Yes  No
    Your message goes here
  • I responded earlier to Kevin regarding this by email, but the eatools software is now available on GitHub:
    Are you sure you want to  Yes  No
    Your message goes here
  • I would like to have the eatools download you mention in your presentation. What do I need to do to get it?

    Are you sure you want to  Yes  No
    Your message goes here

Agile documentation with Confluence and Sparx Enterprise Architect

  1. 1. Agile architecture documentation using Confluence and Sparx Enterprise Architect Per Spilling, Objectware JavaZone 2009
  2. 2. Agenda • Why mashup of wiki & UML tool • How • Tips for architecture documentation in Confluence
  3. 3. Typical problems with traditional documentation
  4. 4. Doc 1.0 App 1.0 App 2.0
  5. 5. Foo Bar Foo Bar
  6. 6. Better way UML wiki tool UML model Documentation Repository Repository
  7. 7. The chosen tools UML wiki tool Sparx Enterprise Architect Atlassian Confluence
  8. 8. Exporting from EA
  9. 9. hmm... EARoot/EA1/EA11.png
  10. 10. The solution: Generate diagrams via the EA API
  11. 11. Running the eatools program
  12. 12. The names of the generated files correspond with the model model/domain_model/domain_model.png
  13. 13. The result: “Live” UML diagrams in wiki
  14. 14. Confluence tips & tricks
  15. 15. Examples of useful plugins • Reporting Plugin • Navigation Plugin • Linking Plugin • ImageMap Plugin • Copy Space • Jira Plugin • Label Tools • Graphviz Plugin • Metadata Plugin 2 • Chart plugin
  16. 16. Copy space plugin
  17. 17. Versioning
  18. 18. Dynamic table of contents
  19. 19. .. do this Update the page layout (Confluence admin). See recipe:
  20. 20. Confluence page templates
  21. 21. Dictionary term template
  22. 22. Dictionary term template Navigation Plugin
  23. 23. Dictionary term template Metadata Plugin 2
  24. 24. Dictionary term template Label Tools plugin
  25. 25. Using the template
  26. 26. Creating reports using metadata Metadata Plugin 2: {metadata-report}
  27. 27. Add-page “buttons” Linking Plugin Specify which template to use
  28. 28. Use labels to specify relationships
  29. 29. depends_on_bird-app-003
  30. 30. depends_on_bird-app-003
  31. 31. Project reports with Chart & Metadata Plugin
  32. 32. {chart:type=bar|width=500|height=200|orientation=horizontal} || || Tasks || || Ikke påbegynt | {metadata-matches:Status|root=@parent| pages=@descendents|label=pcom_oppgave}Ikke påbegynt{metadata- matches} | || Påbegynt | {metadata-matches:Status|root=@parent| pages=@descendents|label=pcom_oppgave}Påbegynt{metadata-matches} | || Ferdig | {metadata-matches:Status|root=@parent| pages=@descendents|label=pcom_oppgave}Ferdig{metadata-matches} | {chart}
  33. 33. Graphviz plugin - ex: {spacegraph}
  34. 34. Thank you Java program for generating diagrams will be made available for downloading after the conference