Document Loader is a tool which allows users to capture information from Word documents and import it into a Cradle project database (PDB). The tool is designed to extract both textual and binary content whilst preserving the hierarchical structure of paragraph headings.
Some issues have been detected when running our Toolsuite applications (Document Loader or Document Publisher), e.g. when running dual monitors, with certain scaling settings etc.
Example of Toolsuite Errors
Sometimes when having more than one monitor connected you may see one of the following error messages.
Solutions
The following solutions can fix the problem without having to remove the monitors.
Scaling
Set the scaling of both monitors to 100%
Restart your machine
Resolution
Set the resolution of both monitors to be the same
Advanced scaling
In Display settings click Advanced scaling settings
Enable Let Windows try to fix apps so they’re not blurry
Restart your machine
High DPI scaling override
Right click on DocPub.exe and choose Properties. Note: if your problem is with Document Loader then just follow the same steps but for DocLoader.exe
In the Compatibility tab select Change high DPI settings
Enable Override high DPI scaling behaviour
Restart your machine
Program DPI
If the above doesn’t work then in the same dialog as High DPI scaling override enable the Use this setting to fix scaling problems…. within the Program DPI section
Optimise for Compatibility
Open Word Options
Select the General tab
In User Interface options ensure the When using multiple displays option is set to whichever option is not currently set
An overview of the Toolsuite Products in Cradle Software
Toolsuite is a set of tools which utilises the applications in Microsoft® Office. These tools will only work on a Windows environment utilising MS Office from 2007 and up.
Supported Versions and Platforms
The Toolsuite supported versions of MS Office are:
2007 32‐bit
2010 32‐bit and 64‐bit
2013 32‐bit and 64‐bit
2016, 32‐bit and 64‐bit
Any of the Click To Run (CTR) Office suite is also supported by Cradle Toolsuite.
This can be on any of the following Windows platforms:
7 32‐bit and 64‐bit
8.1 32‐bit and 64‐bit
10 32‐bit and 64‐bit
Also it can be installed on the following servers:
2008 R2 32‐bit and 64‐bit
2012 64‐bit
2012 R2 64‐bit
2016 64-bit
Tools
The different tools within the suite utilise the following Office applications:
Word
Document Loader for loading documents
Document Loader Screen
Document Publisher for creating and printing of official documents
Spellchecker to check the spelling in item frames
Word/document frames for items e.g. .doc and .docx frames
Document Coverage shows the items covered by a document
Document Compare compares different versions of source documents against each other
Word frame to RTF Frame converter
Excel
Add-in for imports
Excel Add-in
Excel frames for files
Project
Add-in for importing and exporting to a project file
Project frames for files
Visio
Plug-in allows import of pages and symbols as items
Visio frames for files
PowerPoint
Allows WorkBench to print diagrams to RTF and convert the file to PowerPoint presentations.
Installing Toolsuite
For a successful install of Toolsuite, the MS Office needs to be of one version and not mixed versions. For example, if the user has Word/Excel 2007 but Visio/Project 2013, the plug-in or frames for Visio/Project 2013 is not installed. The installer automatically checks for the architecture of Word/Excel as each MS Office version needs different library files installed by Toolsuite. All other MS applications versions are disregarded if a different version to Word and Excel.
Upgrading or changing MS Office
If upgrading or changing your Office then you should always uninstall Toolsuite first. Once Office is upgraded or changed, Toolsuite can be reinstalled to allow the correct library files to be installed.
Uninstall Toolsuite not Cradle
The user doesn’t need to download a separate Toolsuite installer but can find the installer within the main Cradle install folder.
Shows the Toolsuite folder within the main Cradle install folder
During the install the InstallShield will automatically pick the version to install based on the version of Word and Excel that are installed.
Once Toolsuite is installed successfully, you can access the plug-ins by opening the relevant MS application and selecting the Cradle tab. Document Loader, Document Publisher and Spellchecker are opened through WorkBench, Project Manager or the start menu.
The ‘Word frame to RTF‘ frame converter is accessed via a command line utility. This will take Word frames and copy the data into an RTF frame. More information for using the converter can be found by entering c_word2rtf into the Search bar of our Help system or online at https://www.threesl.com/cradle/help.
Both Document Coverage and Compare are used inside WorkBench and are started by selecting one or more Source Documents and selecting the option in a context menu.
For information on binary and other frames types check our help section or search our blog.
Trouble Shooting Issues
If you are having issues with the install of Toolsuite, then try the following:
Ensure the installed MS Office is fully up to date and check compatibility with Toolsuitehere
Ensure your old office keys are no longer in the Registry especially if you are using Click-to-Run versions
Check the Compatibility tab in the Properties for the Toolsuite setup.exe. Select Change settings for all users and uncheck the Compatibility mode checkbox at the top of the dialog. Click the Apply button and OK to close Properties.
Make sure you perform the install with System Administrator privileges not just logged in as an Admin user
If you are having issues after install then try the following:
Make sure you have restarted your machine after the install
Check you have opened your Office and registered it if you need to
Check .Net framework and C++ redistributables are up to date
Make sure your Toolsuite version is the same as your server version
If none of the above trouble shooting works then send an email to support@threesl.com with any logs created, exports and screenshots if possible.
For more information either look for blogs about the individual applications or see our online Help.
Item cross references can be captured through Document Loader in several ways. In this blog we deal with how to set Mapping Cross References in a Table. With all items in one or more tables, the linked items are in a cell using a comma to separate them. These cells will be mapped for the cross references.
Showing Item Per Table and Item Per Row tables
The tables above show information created in a document. The first shows each item in a separate table and the second each item is a single row.
The columns in the second table are;
Key – The Identifying number for the item
Name – The text name being assigned to the item
Description – The text to be captured into the frame of the item
Linked Requirements – The list of Keys (1st column) to which this item is related. It is not necessary for every item to link From/To other items. For example 1.1 links to child item 1.1.1, it is not necessary to link 1.1.1 back to 1.1 in the table.
You can only set one item type to be linked per table.
Table Mapping
Document Loader allows you to map cross references From or To items of different item types. There will be two options for From and To item types for each item type in the schema. This includes Specifications but not Data Definitions or Diagrams. Cross References can be set To and From the document. This is not necessary as each item has a link added back to the document when captured.
The options will show in a list like the example below:
– Xref from <item type> by identity – Xref from <item type> by hierarchical attribute – Xref to <item type> by identity – Xref to <item type> by hierarchical attribute
Mapping Item Per Table Cross References
Load your document and right click on the cell you want to map and select Table Details. When the Table Details UI opens if not already selected, click on Item Per Table. To map the cells, the option is pulled over to the right column to the attribute you require it. The attribute in the right column is selected and then double click on the required option. Map the cells making sure you map one of them to an Identity or hierarchical attribute (Key). Set the cross reference cell by selecting the appropriate option.
For example in the first single table in the first screenshot, the numbers are for the Key attribute of an item. This means using the options with the hierarchical attribute in them.
As the links in the above example are to other items of the same type the option Xref to Requirement by hierarchical attribute is used. This will capture the cross reference from item 1 to 1.1. If I had put the cross reference to item 1 in the cells of the other items, I would have used Xref from Requirement by hierarchical attribute. This would then capture the cross references in the opposite direction of 1.1 from 1.
This shows the mapping of a Item Per Table option
This mapping can be exported and used for other tables within the document and selected through the Copy table mapping drop-down.
Mapping Item Per Row Cross References
Mapping Item Per Row is similar to Item Per table but instead of mapping cells you are mapping columns. As before, right click on the table and select Table Details. As before set the attributes like Key and Name etc, then set the Linked Requirement using the Xref to Requirement by hierarchical attribute option.
This shows Table Details with the Item Per Row mapped
Capturing the information
Once all the paragraphs and tables are mapped with the relevant options, the user can capture the document. The cross references from these cells are created at the end of the capture so that all the items should be in the database.
The end of the Capture Results showing the cross references created
Capturing New Document Versions using Document Loader
You can capture new versions of source documents in the same way as regular documents. Document Loader compares the two versions of your document and identifies any new or modified source statements. You can select which of these revisions to load into your Cradle project database.
Adding a new version of document and Overwite/Merging
When you load the new version of your document, Document Loader adds or updates the appropriate items in your project database. A new set of bookmarks is created around each source statement and linked to the new version of your source document
Please note that Document Loader does not delete items in your project based on deleted paragraphs in your new version.
As long as you have all items baselined in the previous captured document. When making a new version of the document, Document loader will create a draft of the items.
Document Loader relies on an accurate correlation between the source statements in the current version and the new version of your source document. Before loading a new version it is necessary to consider the nature of the modifications in your document.
We advise taking a backup prior to loading a new version.
Your new version will contain minor revisions to requirement statements with new sections and subsections added. These modifications should have been made with Word’s Track Changes enabled.
If however, the new version contains strong modifications, such as restructured sections or entire sections deleted, then it may be necessary to load your document as a new source document instead. You may still update the existing items in your project, provided that your document contains the items’ identities. To do this you must set the Overwrite option to Merge.
The Document Loader dialog is shown below showing a new document version ready to be captured. As you can see the changes are highlighted:
Document Loader Screen
Click here for step by step instructions on capturing new document versions using the Document Loader tool.
Article Updated 04/02/2019 – Updated to include new version with baselined items
Managing the requirements to product of any one supplier.
Any successful project must start by carefully managing its requirements. This follows for every link in the supply chain thus ensuring the full life cycle is efficiently and completely covered. Cradle abilities in Requirements Management and Systems Engineering supports that vital role, retaining the crucial links in managing the product’s development.
Whatever you call the pieces of information you handle, you can create an item type to hold this information. You can categorise and add attributes and details to match your business definitions. You can add frames to hold pictures, drawings, or URLs. No need to bend your process to meet the tool, configure the tool to match your working practice.
Managing the links between suppliers
Cradle can also be used to manage contractual compliance at each level in the supply chain. That is, a customer uses Cradle to define their commercial, technical, environmental, health & safety requirements and publishes them as contractual documents. A supplier can load these documents into Cradle, automatically parse them into their component pieces. They can then develop responses and then generate the completed response document from Cradle. The customer receives the response documents from candidate suppliers and loads them into Cradle, automatically splitting them into their component pieces – e.g. paragraphs – and linking each supplier ‘answer’ to each of their requirements (the questions). See Document Loader. Then Cradle can help to score the suppliers’ responses.
Once a supplier has been chosen, acceptance criteria, validation methods and validations can be added to the requirements and used to manage the supplier’s fulfilment of the contract. A formal response is then produced using Document Publisher.
Whatever the level
The handy thing is that the above applies at every level in the supply chain. A company that is a ‘supplier’ in the above can use the Cradle database that they have produced to be a ‘customer’ to their suppliers, one level down the supply chain.
Here are some small hints and tips for formatting/preparing your documents correctly, which will save you time and energy otherwise expended on laborious cut and paste exercises.
Microsoft® Word Formatting
In order to parse documents, Document Loader uses the hierarchical Word document structure. That is, it will assume that a Heading 1 is of higher importance than a Heading 2. It is important to remember that the document structure is more complex than just making a title by ‘increasing the font size’. Switching views to ‘Outline’ can help you understand how Word see the document. This will assist in preparing your documents for Document Loader to parse.
Document Loader expects each requirement to be in a single paragraph and formatted with an appropriate heading style to indicate its level in the hierarchy.
Document heading styles to indicate level in hierarchy
Requirement text, figures and other information should be positioned directly beneath the heading and formatted using paragraph style Normal or other body text-level style.
Use separate paragraphs for distinct pieces of information, e.g. Assumption text and Requirement text.
Always use paragraph styles rather than text formatting to change the appearance of a paragraph.
Heading styles apply an outline level to your paragraphs, which tell Document Loader about the level of each requirement in the hierarchy
Document Loader prefers pictures and OLE objects to be inserted in line with text. This means the picture is positioned in the text layer of the document, rather than floating on top of the text. In line pictures produce a better document structure.
If you use captions to describe the pictures in your document, make sure that the caption is positioned immediately before or immediately after the picture, and formatted with Word’s caption style.
If your document contains diagrams built with Word’s drawing objects, then you must ensure that all shapes in the diagram are grouped, otherwise Document Loader will parse each shape as a separate image.
If you plan to capture a table with a requirement in each row, then your table must be uniform, that is, no merged cells and have the same number of columns in each row.
As with pictures, if you use captions to describe the tables in your document, make sure that the caption is positioned immediately before or immediately after the table, and formatted with Word’s caption style.
Caption directly above table
For more information on formatting your documents correctly please refer to our online help.
If you are working on a large document and need to save your current position, for example if you need to shut-down your PC for any reason. You can save progress in Document Loader by using a session to save a snapshot. You can then return to the same point at a later time and date. You can then continue to finish your capture or just do a little more and re-save the session to continue again later.
A session stores information about the state of Document Loader at a given point, such as:
A copy of the current document
A copy of the current capture setup definition
Which parts of the document have already been captured
The state of the Document Explorer tree nodes
Any mappings, e.g. table mappings
Any changes made in the Options dialog
Load Session in Document Loader
For further information on how to save progress in Document Loader and Save/Load and Delete sessions in Document Loader please read this post.
Sick of having to start from scratch when working with large documents in Document Loader? Want to save your current progress and return at a later date?
You can use a session to save a snapshot of Document Loader, so you can return to the same point at a later time. Sessions are useful when working with large documents or if you need to shutdown your PC for any reason.
What is a Session?
Sessions store information about the state of Document Loader at a given point, such as:
A copy of the current document
A copy of the current capture setup definition
Which parts of the document have already been captured
The state of the Document Explorer tree nodes
Any mappings, e.g. table mappings
Any changes made in the Options dialog
How can I save a Session?
You can only save a session when working with a new document; not a new version of a document. You can save a session at any time, so long as you have a document open.
To save a session you can either:
Press the Save Session button button from the Toolbar
Select Save Session from the File pulldown menu
Press Ctrl + S (The Status Bar shows the progress of the Save operation)
How can I load/restore a Session?
To load a saved session you can either:
Select Load Session from the File pulldown menu
Press Ctrl + L If you attempt to load a session with a document open you will be prompted to close the current document. The Load Session dialog will be displayed as shown below:
Load Session Dialog
Simply identify the session you wish to load and select it in the list. You can sort on any column by clicking on its column heading; click once for ascending order and again for descending order. Click the OK button to load the selected session.
How can I delete a Session?
To delete a session you need to open the Load Session dialog by either:
Selecting Load Session from the File pulldown menu
Pressing Ctrl+L Select the appropriate session and press the Delete button. Select Yes to confirm the deletion and Cancel to remove the Load Session dialog.
Whatever you are making, whatever service you are delivering, you need a tool that supports your process from end to end. You can’t expect a successful outcome without control of your project’s lifecycle.
Complete End to End Document Processing
Despite living in an electronic world, where the promise was a paperless office, we are often faced with needing to manage documents at a number of points over the duration of the project. This is not surprising, even if we don’t handle hard copy, a document is an tangible object.
Humans relate to the concept of a complete package of information being contained in the document. They generally make good reading if you start at the beginning and read through to the end. Non-fiction documents may be more likely to be read by accessing the index or contents and turning to a page number. Sometimes in an electronic copy there may be a hyper-link to another part of the document. On the whole, however, the format is fixed. You can’t easily re-arrange a document to see its contents from a different perspective, or organise it hierarchically based on a section of your choosing.
Managed and linked requirements, designs, constraints, tests, diagrams and definitions, need to be arranged, searched and traced, to reach our end goal effectively. The ability to see which customer requirements are ultimately verified by a test, or what system requirements are impacted by a customer change to a requirement are invaluable.
Cradle for Your Document Processing
From a document point of view, the triplet of Document Loader, WorkBench and Document Publisher covers the full lifecycle.
Customers often provide their initial requirements in the form of a MS Word document. Document Loader will parse, tag and link this information as it is drawn into Cradle’s database.
WorkBench is the ideal tool to develop and design, record and trace your project.
When the project is at a stage that needs a formatted output, Document Publisher is used.
If your Word document contains cross-reference hyperlinks to other document sections then Document Loader can capture this link as a cross reference in your project database. Typically, a hyperlink might be a reference to a heading, figure or table, implying a loose association between two items. If any hyperlinks are found in your document then this option is enabled by default. Untick this checkbox if you do not want to create such cross references. Use the Link Type dropdown to select a specific link type. It makes sense not to use the same links as you are using for the document hierarchy
Recreate Word internal links as Cradle cross references