index > Visual Studio Team System - Architects > Best Practices for Collaborating on Diagrams

Best Practices for Collaborating on Diagrams


Has anybody developed any good practices for sharing an SDM diagram with people who don't happen to have access Visual Studio for filling details?

For instance, I am working on the architecture for a solution, and I've built an SDM diagram that shows the high-level design of the entire solution. I'd like to have a network engineer fill in the specific details of machine names, etc., for the various environments to which the solution will be deployed (development, testing, production, etc.), but I cannot count on my engineers having Visual Studio.

If I could export to Visio, that'd be cool; the engineers all have Visio. Even if I couldn't do a full round-trip back into Visual Studio, it would still save me a lot of work to let them edit a Visio diagram with the details.

Not as cool, but still usefuly probably, would be a transform to InfoPath, where the details could be collected.

Anybody have any ideas? Thanks!



Kenneth LeFebvre
kenlefeb

Hi,

I have exactly the same problem. As I undestand Microsoft is planning to make VS as a common tool for everybody who are involved in Software development process, from Project manager to engineer who deploys and maintains solutions. But I don't think it will be happend soon. So I though about a synchronization between SDM and Visio. I prety much sure it will be grate to have such possibiity. I have done a small and necessary step for that, I have a directive processor for SDM, which could be used to do a transformations. But that is all what I have for a now. I hope Microsoft provide some answer here, let's see.

Evgeny

Evgeny Popov

I'm afraid they'll severely limit their market acceptance for enterprise architecture, if they require Visual Studio for the mere viewing of these models... To be sure, there is a healthy .NET presence within my organization, but it is not the only, or even, primary application platform, so people who are not .NET developers (like my network engineers) are not going to be approved to spend money on Visual Studio, just so they can view and/or edit my models.

What's more likely to happen is that I will be told to use some other tool to do my architectural work, and the power of Visual Studio's SDM and DSL tools will be totally lost at my company. I really hope they are more open-minded to playing well in a multi-vendor environment. :)




Kenneth LeFebvre
kenlefeb
I've moved this thread over to the Team System Architects forum where more of the Team Architect guys hang out and you're likely to get a better answer.


Gareth Jones - Developer - DSL Tools & Software Factories Platform [MSFT]
GarethJ - MSFT
That's cool... makes sense to me!


Kenneth LeFebvre
kenlefeb

Thank you, Kenneth and Evgeny. This is valuable feedback. I've forwarded your input to the product team for an answer.




Esther Fan | User Education | Visual Studio Team Edition for Software Architects
Esther Fan MSFT

Esther Fan MSFT wrote:

Thank you, Kenneth and Evgeny. This is valuable feedback. I've forwarded your input to the product team for an answer.

Thanks, Esther! I'm looking forward to their response. Since I always have Visual Studio on my machines, it's not such a big deal to me, to use it for diagramming, but it's just not practical to expect everyone who needs to manipulate these diagrams to use Visual Studio.

As I said before, I'd be happy to be able to export to Visio, but even then, I'd be doing a lot of extra work that (in an ideal world) I shouldn't need to do. Some of the diagrams, in my current process, I don't actually create myself, but using Visual Studio I would need to create manually from Visio drawings done by the other teams. Some of the diagrams I normally create, but accept modifications from other teams, so I would be exporting to Visio for collaboration, and then manually updating the Visual Studio diagrams from the returned and edited Visio diagrams. I'm willing to do all that exporting, for the sake of using Visual Studio, but at some point in the future I think you really should support that scenario, too... :)




Kenneth LeFebvre
kenlefeb

Ken and Evgeny,

Phil Lee - MSFT

For my purposes, I don't care so much about all the additional metadata as I care about having editable shapes in Visio. Visio is the standard tool, in our organization, that all of our infrastructure diagrams are created in. The Infrastructure Engineers that I need to share my diagams with all have Visio, but almost none of them have Visual Studio.

If the metadata can be exported, too, as additional properties on the shapes, that would be really cool, as I'll be able to give my IE's some macros (in Visio) to expose those properties in any generated documentation from those diagrams, but that's a lower priority for me personally, since it's not my responsibility to maintain that level of detail in the diagrams! (If I were able to provide some macros to generate documentation from the metadata, I would make a lot of friends amongst the IE's to be sure, but all I'm required to deliver to them is the basic Visio diagram!)

As you investigate the possibilities, I would be very willing to provide whatever feedback and assistance you might want. Feel free to contact me, directly, any time.

Thanks,

Ken
kenneth *at* lefebvre.us
ken.lefebvre *at* nationalcity.com




Kenneth LeFebvre
kenlefeb

Here's the topic about how to "export" diagrams to other documents by copying all the diagram items:

http://msdn2.microsoft.com/en-us/library/ms181801.aspx




Esther Fan | User Education | Visual Studio Team Edition for Software Architects
Esther Fan MSFT

Ken,

Phil Lee - MSFT

No, there really isn't a need to send the Visio shapes back to Visual Studio. I'd say it's about fifty-fifty, the number of diagrams we create in Visual Studio that are actually hooked up to real code. At least half of my Visual Studio diagrams are created in spike solutions that are set up just to create the diagrams. Too many of our development projects are enhancements to existing, legacy code that doesn't lend itself too well to diagramming more than just static class diagrams.

Thanks!

Ken

P.S. I did have a list of other questions/suggestions/issues with Team that I put together some time ago, but I recently moved offices and haven't been able to do the thorough search it'll take to find that list (or else I'll just have to try to remember it and reconstruct it). Once I do, I'll forward it to you... :)




Kenneth LeFebvre
kenlefeb
reply 12

You can use google to search for other answers

 

More Articles

Systems Distributed Designer - ASP.NETWebService > ASP.NETWebA...
VS.Net 2005 RC Application Diagram problem with SoapExtensions in...
Distributed System template
Visio for enterprise architects freezes on database stencil selec...
IIS constraints
Reverse Engineering C# projects
WinFx and Application Designer
IIS version
biztalk server 2006 server administration
permisson error trying to implement an webservice
Welcome to Bokebb   New Update   Joins the collection  
 

New Articles

calling policy from orchestration.
Settings and Contraints Editor : Search …
Application Diagram
Updated MSDN content for VS Team Edition…
How to specify Project generation from S…
SDM and WebProject
Biztalk?
Systems Distributed Designer - ASP.NETWe…
Web services via class library - how to …
Implicit constraints, Pre-defined constr…
Hot to fix "A reference to document…
SDM Directory resource
error adding wsdl to a webservice
SDM: Flow and Extends questions
Modeling .Net Remoting or DCOM

Hot Articles

Anyone using VISIO for Enterprise Archit…
Complete material about n-tier and objec…
Correct values for Platform property in …
Visio Enterprise Architect 2003 - Suppor…
WinFx and Application Designer
MSDN Webcast: Visual Studio 2005 Team Sy…
Is this feasable?
New System definition using SDM SDK
Extending Application Designer
Mobile Distributed Application in Applic…
Application Diagram doesn't like ATLAS?
Reverse Engineering - Views
Team Suite not working -- Beta 2
How to specify custom constraints?
Cannot open certain files in VEA 2005 su…

Recommend Articles

Provider Endpoint on Application Use ver…
Looking for a sample LLD
IIS version
Filing bugs or suggestions on Microsoft …
Issue installing Visio for Enterprise Ar…
Reengineering Migrated Applications
Satellite Assembly
Visio Enterprise Architect 2003 - Suppor…
About Interpreter Pattern
Custom SDM Application System
where do newbies ask questions?
Resources: Team Edition for Software Arc…
[LDD] Import IIS settings does not impor…
Default implementation language for dist…
Welcome...!!!