This Question is Answered

1 "correct" answer available (4 pts) 2 "helpful" answers available (2 pts)
3 Replies Last post: Aug 13, 2007 11:39 AM by Kim Carlton  
Kim Carlton   22 posts since
Aug 2, 2007
Currently Being Moderated

Aug 2, 2007 7:45 AM

How we did it (Import over 3000+ artifacts)

Greetings to all,

I thought I would do an initial post here to initiate conversation on Importing large amounts of data into Contour and the pitfalls we uncovered. We are migrating from No Real Traceability to Contour and we are in an blended agile environment. We have several hundred User Stories, Use Cases, Business Rules and other documentation that needs to be moved to Contour. All of these are in MS Word and we wanted to put them into Contour - but not as attachments. We wanted to convert the Word to HTML and stuff it in the Description part of an Reference-type group item (at the time, we did not know how to create our own artifact). Not that it would matter. The whole point here is how to convert over 3000 Word docs to HTML and stuff the HTML into the the Rich Text Editor part of the Contour item.

 

This task screams for VBA macros, doesn't it? It did and that's what we did. We wrote a medium to complex macro to open the files, save as HTML, read the file in as a text file then store the entire file as a string to an Excel cell. The macro then would convert the file to a CSV file in order to be ready for importing. It took a while to get this working, primarily because the author did not have a ton of expertise in VBA but got the job accomplished. We were seeing a couple of oddities such as graphics (of course) did not import right away and we decided at the time, that if the User Story was revisited, we would bring the graphics over at that time.

 

I am interested to know if anyone has done simliar work and, more important, in a dual environment (which we have until we completely cutover to Contour), how you keep up with artifact changes. We use CVS for our versioning. I wanted to do something with CruiseControl but did not have the expertise to do a deep dive nor the time to learn. We ended up doing this manually (and are still doing so).

 

Good luck with your work!

Eric Winquist   83 posts since
Jun 11, 2007
Currently Being Moderated
1. Aug 2, 2007 9:24 AM in response to: Kim Carlton
Re: How we did it (Import over 3000+ artifacts)

 

Great tip with the VBA macro.  If there is a way to attach the code, I'm sure others would benefit, especially the convert to CSV aspect.

 

 

 

As you found, there isn't a way to import graphics within text into the rich text editor.  We've given some thought to how this might be accomplished such as automating the extraction of images, uploading to contour and inserting a image link within the editor but that poses some issues.  We'll continue to research options for this.

 

The synchronizing with CVS is an interesting concept.  We use it internally for code versioning and have considered an integration within Contour - but more for traceability.

 

 

Eric Winquist   83 posts since
Jun 11, 2007
Currently Being Moderated
2. Aug 2, 2007 9:26 AM in response to: Kim Carlton
Re: How we did it (Import over 3000+ artifacts)

 

One more import tip...

 

When importing from CSV (Excel), use the status or another field and set a default value such as "Pending" - or create a new value of "Imported".  We do that internally to test the import, then if it doesn't work we have an easy way to batch delete everything.

 

If you are importing into a new group, the entire group can be deleted as well.

 

 

More Like This

  • Retrieving data ...