Search This Blog

10/12/2009

Troubleshooting Tip - Editor window crashes after changing from multiple monitor to single monitor setup

Found an unusual problem this morning, and managed to help someone in our office resolve it without a support call to KSC. This is related to working with two-monitor setup, and temporarily changing to a single monitor. It will not affect the majority of users most of the time.

SpecsIntact doesn't seem to recognize the change to the monitor setup quite right for dialog boxes that were previously closed in the secondary monitor. It remembers the position the dialog box was last closed, and if that was in the secondary monitor (which now no longer exists), the dialog box is just "out there" somewhere. It appears as though the editor window is locked up, because the dialog box is off the screen and is a modal dialog box, meaning control is not allowed back to the editor window until a selection is made. Trying to end the task with Ctrl+Al+Del gives a message saying the system is waiting for a response from the user. Even after ending the task, restarting SI, updating to latest version - it still does the same thing. In our case we were trying to use the RID (Reference Identifier) button. We also made sure the display properties were set correctly, having the secondary monitor inactive.

Solution: Imagine there is a dialog box you can't see, and you need to somehow move it. Sorry, telekinetic powers don't seem to work with computers. The workaround I used is Alt, Space, M (to invoke the dialog box's move command in the application menu), hitting any arrow key at least once to grab the title bar. At this point it is possible to freely move the dialog box with the mouse to the active monitor, then choose a reference or blank tags, and close dialog box (IMPORTANT: Don't just hit cancel, or you will have to start the process over). Now SpecsIntact remembers that this dialog box was closed in the main monitor.

9/30/2009

SI Tip of the Day - light gray for deletions improves readability of SpecsIntact sections

UPDATE: If your project requirements include UFC 1-300-09N, Don't try this for anything you submit to the Government for review (because it conflicts with UFC 1-300-09N - but many projects may only UFC 1-300-02, which has less specifics on revision format). But whatever the case, you & your designers might really like it for internal use. Just remember to change it back before publishing design submittals.

This is a one-time change, even though it is done in the editor window. Open any section, click Format menu, Font, choose tag name Deletion, foreground color Light Gray (or Gray if you like). You can also change header and note to Gray (or Cyan if you are using Gray for deletions).

Here is the cool part - deletions now recede so it is much easier to pick out the retained text and new text at a glance, while still having the benefits of seeing in context the other options that may exist.

These settings are stored in C:\Documents and Settings\<username>\Application Data\SpecsIntact\INI_Files\SECTION.INI, so you could easily have two copies of it saved somewhere to make switching back & forth much easier. Sometime when I get a chance, I might try to write a simple DOS batch program or Python script that makes this as easy as clicking a button.


Click thumbnail below to view an example:

9/10/2009

SI Tip of the Day - don't forget to reset revision format

If you have updated to the new version of SpecsIntact that was recently released, just a quick reminder -
 
Time to re-customize font settings for revision marks per UFC 1-300-09N Design Procedures 10-4.3 on page 71 of pdf:

10-4.3 Specifications or RFP Development.

Provide edited, red-lined specification sections, showing deletions from and additions to the master guide specification sections. Red-line other parts of the RFP when required by the contract. When using SpecsIntact, deletions should be shown in bold print and lined out. Additions should be shown in bold print, italicized, and underlined. This special editing feature will have to be reset each time SpecsIntact program is updated. To do this, open a job; go into a section and select “Format.”
I'll have to pass along a feature request that the program could be taught to either (a) remember the user's settings (preferred), or (b) at least have default settings that correlate with UFC required formatting -- instead of requiring us to remember to change it back every time we upgrade!
 

9/03/2009

SI Tip of the Day x 2 -- 1: Using a shared supplemental reference list -- 2: Update to SI 4.4!

This tip applies to working in an office where multiple users work with SpecsIntact.
 
Avoid reinventing the wheel by benefitting from each other's efforts to increase the library of supplemental references:
 
[X:]\SISGML\Masters\UFGS <-- UFGS masters are here.
create new folder:
[X:]\SISGML\Masters\[Office]\SUPP.REF <-- move the SUPP.REF file here, and change users' SI setup options file locations to use this folder. (This folder can also be added to the SI Masters so user can also share customized specifications for topics not currently covered in the UFGS.)
(In examples above, assume X:\ is a mapped drive letter for a shared network folder. Insert firm name or other name for office master folder in place of [Office]. Because drive letter are mapped, users can still use local installation of SpecsIntact. This can help some for those who use a docked laptop at the office and undock and take it with them at other times. SyncToy is the other main piece to that puzzle that I am currently using.)
The one pitfall we found with the shared Supplemental Reference List concept was that some recent changes had been overwritten by the program - simple solution: Mark the file read-only whenever you are not editing it. Also when changes are made, saving a backup copy here: X:\SISGML\Masters\[Office]\Supplemental Ref backups.
 
Then I added this little note at the top of the SUPP.REF file to remind us all (including myself) how this plan works:
<HLS>¡ ¡ ¡ IMPORTANT ! ! !
 
To avoid loss of data in this shared file, we have developed a simple procedure that must be followed when editing this file.
 
1. Copy the SUPP.REF file into the \Supplemental Ref backups subfolder. (Double-click here if you do not already have the office master folder open).
 
2. Rename the backup file using the same date format as the others in the backup folder 4-digit year, 2-digit month, 2-digit day, using today's date.
 
3. Go back up to the previous folder.
 
4. Right-click the SUPP.REF file and temporarily uncheck the Read only checkbox.
 
5. Execute any previous revisions, and then edit the file. Be sure to turn tags on. To preserve tagging structure, it is often easiest to copy an existing reference and then edit. Revisions view can be used to mark what you are changing.
 
6. Save and close, THEN BE SURE TO CHANGE THE FILE BACK TO READ-ONLY!!!
 

Keep in mind that the dates of issue should be checked periodically. In the UMRL the Government checks their list. But in our supplemental list, NO ONE is checking to keep it up to date unless we do it.</HLS>
So far so good!
 
----
 
Side note - Kudos to the SI Development team for getting so many updates into the new version 4.4! The greater awareness of presence of tailoring options and common selections across sections will be of great value. Sometime I would really like to be able to still have revision marks when using tailoring. Most agencies require it, so it diminishes our ability to take advantage of tailoring. Very nice job overall though, and thanks for listening to all the feedback!

8/28/2009

SI Tip of the Day - More hot-keys

Here are a few more hot-keys that are often handy:

Alt+S Tags view (toggle)
Alt+R Revisions view (toggle)
Alt+N Notes view (toggle)
Shift+F8 Revision tracking (toggle)

CTRL+F Find text (to find next, use F3. Side note: If you have text selected, it will put that text into the Find dialog box. Very useful if you have just added a supplemental reference, and you want to go back to the text you were editing.)

Ctrl+B Find brackets (to find next, also use F3, if you use pause after each change)

CTRL+I Find tags (useful for location TAI options if you are marking deletions)

Alt+Z Zoom in
Alt+Y Zoom back out

Alt+G Display only English units
Alt+M Display only metric units
Alt+B Display both

For the ones you use repeatedly, it is well worth taking a moment to let those sink in. Keys on the keyboard are always right where you expect them, unlike your mouse pointer which roams all over the place.

There are many many more. Those are just my favorites for today. As you browse through menus to find commands, if you look to the right, you will see all the hot-keys. For commands that don't have an assigned hot-key, you may be able to use Alt and follow the underscored items in menus. Thus Alt, T, V runs the Validate command.

8/27/2009

SI Tip of the Day - Global search [& replace]

To do a global text search of a SpecsIntact project (with optional replace feature), right-click a project in the tree, and click Search/Replace Job... This is especially useful if, for example, you are halfway through editing for a project, and then you receive directions from on high that the abbreviations of reviewing agencies must be changed. (In case you are wondering based on previous entry, no this is not being slammed for inventing new abbreviations for LEED. Different project. Changing AE to D per a new project requirement).
REDLINING REPLACEMENT TEXT
A nice little feature in the "Enter Search Text" dialog box is the "[x] Mark revisions" checkbox. This is good for making sure the revisions make sense in context. Once I wrote a spec for vinyl windows based on an aluminum windows spec. Short version is, I noticed it called for vinyl fasteners! So it is good to check behind our automated friend the computer.
IS THERE A WAY TO SKIP TEXT IN EDITOR'S NOTES? - YES!
Here's one more little tip - if you are searching for something like "AE" that is contained in the editor's notes in nearly all SpecsIntact sections, the results window yields less than desirable functionality - because now you have to open nearly every section and use Ctrl+F to find in many cases something that isn't even in the actual section text. SOLUTION: Make a single-file PDF using the Print/Publish dialog box. Be sure to go to the Options tab and uncheck "[_] Notes" and maybe also "[_] Revisions". Then in Adobe Acrobat (I use Pro), use Ctrl+Shift+F to find all, then type in AE, [x] whole word only - it will help you find them much more quickly.

8/25/2009

SI Tip of the Day - Tag submittals carefully!

What a fun welcome to work this morning! SpecsIntact was crashing every time our Specs Coordinator tried to run the submittal register for a large project we are working on. There are 115 spec sections in this volume, so it took a considerable process of elimination to see just which section(s) were the culprit. To narrow it down, she and another specifier tried running the register on the first half of the volume. No crash! So they knew the offending section(s) had to be somewhere in the second half of the book. Guess what - it crashed when running the second half - so now they worked from the other direction - adding more and more sections to the mix, until when they eventually added 26 56 00 EXTERIOR LIGHTING it crashed again. As a final test, they ran a register with all the sections EXCEPT 26 56 00. No crash!

Here's where I came in. What was causing this mysterious behavior, and how could we correct it in time to get a complete submittal register to the printing company in time, including the exterior lighting submittals? I set to work with a clean section from the UFGS master in a sandbox SpecsIntact project folder, editing only the submittals Article... interesting little discovery:


The consultant had used <SUB> tags around a whole paragraph in one of the submittals! I think there must be a character limit for a submittal description, and we were majorly exceeding it. Like Buster in the movie Groundhog Day, we were trying to make it eat the whole cow, instead of bite sized pieces! Unfortunately, there was no warning or opportunity to do the Heimlich maneuver - maybe SpecsIntact's cholesterol was a little high or something because it seemed to have suffered an immediate heart attack. Software coroners, thankfully, unlike coroners for humans, have some more chances to analyze what happened and try to get it right.


After deleting the <SUB> tags around this paragraph, touching up the reviewer designations, and reassuring SpecsIntact that it would all be ok, I ran a complete submittal register without crashing! :-)

Chris