Collaboration Web Server

To use eaDocX Collaboration Edition features you will need to install and configure the Collaboration Web Server in your network.

Choose the Web Server for your version of eaDocX:

And then follow the installation instructions:

 

Don't forget, if you are using Floating licences you will also need to create an LSA.

See the Floating Licence user guide for more information

 

Welcome to eaDocX Collaboration Edition

With eaDocX Collaboration Edition you can now

  • publish your eaDocX documents to a website
    • intranet to readers within your organisation
    • extranet to your chosen partners
    • internet to anyone you'd like to collaborate with!
       
  • get your reviewers to contribute online,
    • Use any platform with a suitable web browser: PC, iPad, even a phone!
    • Ask them questions about individual EA packages, diagrams, elements or element attributes
    • Give them choices and let them vote
    • Let them see what everyone else is saying, and join the conversation
       
  • and have all comments from all users added straight into your EA model.
    • In real-time
    • Makes them part of the permanent record

 

 

Try a Live Demo

Free 30 day trial

How does it work?

Getting Started

 

 

See for yourself how easy it is to review, comment and interact using one of our eaDocX collaboration documents online.

New users: just download the trial and use all the features for 30 days

Previous triallists: This version will work even if you have downloaded eaDocX before.

Current customers: We recommend you uninstall any existing eaDocX versions from your rmachine for this trial. Don't worry, all your documents will continue to work with this trial version.

 

This brief video explains the principles of how to set up your document for review, what the author will see, and how the document review data is stored in Enterprise Architect

This is a 5-minute guide to setting up collaboration for the first time with eaDocX Collaboration Edition.

It assumes that you are already familiar with creating great documents with eaDocX – this is just the new bits.

 

To learn more, see this white paper - 7 Steps to Agile Documents.

 

 

 

5 Minute Guide

eaDocX Collaboration Edition

5-minute guide

Version: 1.2

Published: 15th May 2015

Author: This email address is being protected from spambots. You need JavaScript enabled to view it.

Welcome to eaDocX Collaboration Edition!

This document is a 5-minute guide to eaDocX Collaboration Edition.

It assumes that you are already familiar with creating great documents with eaDocX – this is just the new bits.

Please see the Installation Guide for details on how to setup the Collaboration Edition Web Server, and the eaDocX Help on running the eaDocX Document Management Setup (EA | Extensions | eaDocX | Document Management | Setup Document Management). This document assumes you have done that successfully, and are now ready to start collaborating.

1        Create a document

Start by creating an eaDocX document in the normal way.  There are just a few types of eaDocX content which are not reviewable, but if you keep to a relatively simple document, then that should be ok.

2       Add Some Collaborations

This step is optional. You can send out a document for review with no explicit collaborations, and Reviewers will be able to add comments and discuss them.

Collaborations let you ask questions about specific bits of your document: individual elements (Requirements, Use case, Components etc), diagrams, or even steps within scenarios. Collaborations might also ask for votes, or request that a reviewer indicate compliance with any of those aspects of your document.

To create Collaboration Requests:

Look in the eaDocX Preview Pane, and make sure you have checked ‘Show Collaborations’.

Then right-click on any Heading, diagram or table row, and select Collaboration | Add Question, Add Vote Request, Add Compliance Request, and fill-in the details.

There are also options for you to create Comments and Approvals, but these are just there in case you have users who want to send their feedback the old-fashioned way.

Your Reviewers will now see these Collaboration Requests when they open your document.

Note: for vote requests, put each option which you’d like people to vote about on a separate line:

These Collaboration Requests allow you to focus the attention of your reviewers on very specific areas of your document.

3       Create some Reviewers

Collaboration Edition needs to know who is allowed to review your document, so create some people  - EA | Extensions | eaDocX | Document Management | People.

Then, you can associate those people with your document as Reviewers. Open your document, and select Tools | Document Management | Collaboration Details. From there, you can add reviewers. Or, use Tools | Document Management | Document Details.

You will need to setup a password for each user. It is your responsibility to get this password to each user in a secure manner: if you just paste it into an email, along with the URL (see below) then anyone intercepting the mail can access and comment on the document.

(as of Beta 1, there is no facility for Reviewers to set their own password)

If you select  Tools | Document Management | Collaboration Details you should see something like this:

 

Next, save your document as an HTML file, as above. If you have done the setup correctly, then the HTML should be saved in a location which can be seen by the Collaboration Edition Web Application.

NOTE: on most computers, because your Web Server is in an Admin-protected folder, in order to write a file directly from EA/eaDocX, you will have to start EA with Admin privileges. OR, you can create another folder elsewhere on your machine or network, where EA can write to, and from which the Web Server can read your files.

You can now create the email which will tell Reviewers how to find your document.

4       Telling Reviewers

In the page above, select a Reviewer, and choose ‘Copy Reviewer URL to Clipboard’.

You can then create an email, and add this URL to it. Your Reviewer then just clicks on the URL, which opens the Collaboration Edition Web Server, and lets them login using the password which you set.

Your reviewers can now login and create comments, and answer any questions you created in (2)

5       Finally – seeing the feedback

As your reviewers add their comments, answers, votes and compliance statements, you will see it in real-time in your EA model.

Questions, Vote Requests and Compliance requests are saved as children of the eaDocX Document:

 

Comments, answers, votes and compliance statements are version specific, so they are saved as children of the Version:

 

You can also see summaries of the comments, answers etc in the Collaboration view:

 

This will also show exactly which item (Element, diagram, package) in your EA model the feedback was about:

Right-click on these items to find them in the EA model, and you’re in exactly the right place to make any necessary changes to EA.

Job done.

 

Ian Mitchell, May 2015