In the previous module, you acquired the skills needed for correcting Validation
Errors Resulting from Unknown Titles.
In this module, we will discover the types of Reference Errors that will initiate the
Validation Log.
Just to recap on what you learned in the previous module, the Validation Log is
generated by the SpecsIntact Editor when tagging mistakes are made.
There are several ways to invoke the Validation, by saving the Section file,
selecting Tools and choosing Validate, or by selecting the Validation command located on
the Editor's Toolbar.
When the Validation is initiated by the save process or by your choosing, the Editor will
validate the document requirements before the file is saved.
The Validation verifies the tagging is correct and that you have followed the
correct format.
If the document fails Validation, the Editor creates a Validation Log and prompts you to
open the Log to assist you in correcting the errors.
We also learned that the Validation Log and Verification Reports have built-in
hyperlinking that will open the Section and place your cursor at the subpart that
contains the error.
Most of the errors are a direct result of redlining the Reference Article to remove
References which is unnecessary and a waste of time, since the software is intelligent to
remove any of the Unused References from the Reference Article when it is processed
through the SI Editor's Process and Print/Publish features.
Please, do not delete an entire Reference Publication from the Reference Article and
let the Reference Reconciliation do its job.
The first validation error we are going to focus on is resolving 'SPT' Cannot Contain
'ORG', 'RID', or 'RTL' errors.
Although this particular Validation Error reflects a number of problems, it is not as
bad as it looks and can be resolved easily by inserting one tag.
More than likely, you will not see this error as often since the release of the
Reference Wizard, and since Revisions are required when editing Jobs for Army, Navy,
and NASA. Since this is a requirement, SpecsIntact selects Revisions by default when
you set up your Job.
Although this is a requirement, you still need to know how to fix these errors.
I have opened section 02 65 00 in order to demonstrate how you would correct the 'SPT'
Cannot Contain 'ORG', 'RID', and 'RTL' mentioned above.
First, we want to Validate the Section by selecting the Validate command on the SI
Editor's Toolbar.
Immediately, a message box will appear stating that the 'Validation errors were
found', so let's go ahead and select 'Yes'.
From the Validation Log, we are going to double-click on 'Subpart: 1.2 REFERENCES'.
As you see, we are located in the Section and our cursor is positioned just before the
beginning tag.
Let's scroll down so the Reference Article is positioned at the top of our window.
As we examine the References listed in the Reference Article, you will see the first one
is American Petroleum Institute (API).
If the References are correct, each Reference Organization should be surrounded
in a set of tags.
Within the tags you will have a set of tags that will surround the Reference
Organization. Underneath the Reference Organizations, you will find a list of
Reference Identifiers and Titles.
The Reference Identifiers are surrounded in a set of tags, whereas the Titles are
surrounded in a set of tags.
When adding References with the Reference Wizard, we really do not have to worry about
the tagging since it's built-in intelligence takes care of the tagging for us.
With that said, you will still need to understand the tagging in the event that you
have to troubleshoot your Section for Validation Log and Verification Errors and/or
Discrepancies. As we look at American Petroleum Institute (API), you will see that
the tags are missing.
In order to insert the tags, let's place our cursor just before the beginning tag
and we're going to highlight, stopping just in front of the next tag for the
Reference Organization that is redlined for ASTM International (ASTM).
Now that we have the entire Reference Organization, along with the corresponding
Reference IDs and Titles highlighted, let's go ahead and select the REF button on the SI
Editor's Tags Bar.
As you see, this has placed the tags in their proper location surrounding all of
the corresponding Reference IDs and Titles that belong to American Petroleum Institute.
In this same Section, I've created another common Reference Validation Error that is
also quite simple to correct when you know what to look for and can easily be avoided by
not redlining the Reference Article.
Let's go ahead and select the Validation command on the Toolbar.
When you see the message letting you know 'Validation errors were found', select 'Yes'
to view the file.
This time, the 'Rules Violation' states the 'Reference has no Organization ('ORG' tags
missing)'. Let's place our cursor over subpart 1.2 REFERENCES and double-click.
As we scroll down, we will come across the Reference that has been redlined and was done
so incorrectly.
In order to correct this, let's highlight the redlined text,
right-click, scroll down and select 'Undelete Redlined
Revisions'. Now let's select the Validate command on the Toolbar.
As you see, the file is now Valid.
Go ahead and select OK.
The only time the Reference Article should be marked up with Revisions is when you are
either adding or updating a Reference, Reference ID, and/or Reference Title.
If the spec editor has marked up the Section correctly, then when the Section is
processed, the Reference Reconciliation process will remove the unused references.
When you compare the markup against the processed files and find that the References
that were meant for deletion are still printing, this means the Reference ID is
still used outside of the Reference Article and requires further investigation and
possible markups.
This completes our lesson on Resolving Reference Validation Errors.
Proceed to the next module in order to learn how to Resolve Validation Errors Resulting
from Missing DEL Tags in Formatted Tables.