It's all about the answers!

Ask a question

Uploading existing requirements documents a few issues


Amy Tennent (133) | asked Jun 04 '12, 11:16 a.m.

Issues

1.       Upload artifact word doc - Open the newly updated doc -  Select “Click here to convert document”

Warnings

Message: Conversion warning: 1
Details: Shape not converted

Diagrams are lost

2.     Documents with embedded images seem to create a sub folder with contents being image files ie. Image1.png – Is there a way to suppress this. These folders cause confusion as users think doc is within.

3.     After uploading and converting my doc, editing and going to Open History – changes show

A lot of incorrect changes related to font – the original doc that was upload had font trebuchet so I am not sure why it shows a change from arial to trebuchet.

Primary Text example -

quot;fontquot;FONT-familyFAMILY: arial, sans-serif; fontFONT-sizeSIZE: 10.0pt; pt">Sterling Commerce, An IBM Company

quot;textquot;TEXT-alignALIGN: justify; justify"> quot;fontquot;FONT-familyFAMILY: trebuchet ms, helvetica, sans-serif; fontFONT-sizeSIZE: 10.0pt; pt">Confidential,quot;fontquot;FONT-familyFAMILY: trebuchet ms, helvetica, sans-serif; fontFONT-sizeSIZE: 10.0pt; pt"> For INTERNAL use only                                                  

4.     Would like confirmation that after converting uploaded doc I can delete the uncoverted version.

5.     For uploading existing docs – unclear between whether or not we should use create artifact or import doc?

One answer



permanent link
William Andreas (136) | answered Jun 04 '12, 1:37 p.m.
JAZZ DEVELOPER
1.  Not all types of drawings/diagrams can be imported (as is documented in the UI for doing the import).  If you think it's a diagram that should be able to be imported, you would need to file a defect and attach the word document (or part of it) that  cannot be imported.

2.  Images, diagrams, drawings and the like need to be stored as separate artifacts (import converts the document to what is essentially HTML and HTML does not support "embedded" images).  If you'd like more control over where the images are put as part of the import (e.g., you want to specify the folder the images are to be put in, or the name of the folder), I'd open an enhancement request.

3.  Editing and then saving any rich text document may result in inconsequential (non-visible) changes to be made to the HTML markup (usually made by the browser) or may happen when the markup is re-normalized after the browser makes it messy. This can include things like simply reordering CSS properties attached to text (where there is no visible change of any sort).  This is a side-effect of using browser-based HTML editing.  We are investigating improved compare functions that hopefully will reduce the number of changes that are shown to only those that are of consequence.

4.  There is no relationship between the original (uncoverted) document and the converted document.  So deleting the unconverted one will not affect the converted one (or any of its parts).

5.  Whether you choose to upload an artifact and then later convert it or you chose to import it directly (which effectively is just a combined upload and convert) is really choosing which workflow works better for you.  The two are functionally identical.  Some people prefer uploading (and saving off as a backup) and then converting.  Some prefer the ability of being able to "bulk upload".  Others prefer the simplicity of doing an import directly without any intermediary objects.

Your answer


Register or to post your answer.


Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.