|
|
|
|
|
Troubleshooting
Transit provides you with multiple tools that will allow you to troubleshoot any errors or issues that you may encounter while creating your project.
WebWorks Tools for Microsoft Word
Tools are another component of the Transit menu plugin. Aside from providing you with the ability to insert markers and apply conditions, Transit also provides you with a handy tool that will allow you to validate your document. It is a diagnostic tool that allows you to scan your document to validate that conditions are balanced and that shapes, inline shapes, and lists traverse successfully. If there is an issue with the conditions, shapes, or lists in your source document, then Transit will display an error message alerting you that it has encountered an error with the condition, shape, or inline shape.
Validating Conditions
Conditions are unbalanced when they do not have either an opening or closing tag; if any conditions are unbalanced, then the conditions will not be applied to the generated output in Transit. By using the WebWorks Conditions Validation tool, you can verify that your condtions are balanced; when the validation tool traverses your document, it checks to see that the conditions have both an opening and closing tag.
The following is an example of a balanced condition:
{PRIVATE WWMTS PrintOnly} Timing Devices {PRIVATE WWMTE OnlineOnly}
The following is an example of an unbalanced condition:
{PRIVATE WWMTS OnlineOnly} Timing Devices
Sometimes, unbalanced conditons occur when either an opening or closing tag is deleted. If there are any unbalanced conditions in your source document, then you will receive an alert that an error has been detected. When this error dialog box appears, you can opt to navigate to the error, continue the scan or cancel the scan.
To validate conditions:
|
2. |
Go to Tools > Validate Conditions. |
Troubleshooting Unbalanced Conditions
When the Conditions Validation Tool encounters an unbalanced condition, you have three options: navigate to error, continue scan, or cancel scan.
To handle unbalanced conditions:
|
|
Choose navigate to error if you would like the validation tool to show you exactly where the unbalanced condition occurs. |
|
|
Choose continue scan if you would like the validation tool to skip the unbalanced condition and continue traversing the source document. |
|
|
Choose cancel scan to stop the validation tool from finishing the validation process. |
Validating Inline Shapes
Inline shapes are images that are a part of a paragraph, which means that the graphics move inline with the text of the paragraph; for example, embedded graphics are inline shapes.
To validate inline shapes:
|
2. |
Go to Tools > Validate Inline Shapes. |
Troubleshooting Inline Shape Errors
If the diagnostic tool finds a problem with any inline shape in the source document, it will display the following popup error message:
At this point, you can choose to continue with the scan or to cancel the validation process. If you choose Yes to continue, the validation tool will resume traversing the rest of the shapes in the source document; if you choose No to not continue, then the validation process will stop.
When the diagnostic tool traverses the source document, it will warn you if it runs into any problems with your inline shapes. If there is a problem with an image, the image will be highlighted in your document. You can choose to stop the validation process and fix the shape by re-adding the image to the document; however, if the diagnostic tool encounters a problem with an image, and you choose to continue, then the tool will resume traversing through the document until it finds another broken inline shape or completes the validation process.
Validating Shapes
Shapes refer to the images that reference an outside file – such as a Visio image or an Excel file. For example, if you are referencing an image or file in your Microsoft Word document, and you move the referenced image to a new location, the validation tool will return an error.
To validate shapes:
|
2. |
Go to Tools > Validate Shapes. |
Troubleshooting Shape Errors
If the diagnostic tool encounters a problem with any of the shapes in the source document, it will return the following error:
At this point, you can choose to continue with the scan or to cancel the validation process. If you choose to continue, the validation tool will resume traversing the rest of the shapes in the source document; if you do not choose to continue, then the validation process will stop.
When the diagnostic tool traverses the source document, it will alert you if it encounters any problems with your shapes. If there is a problem with a shape, the shape will be highlighted in your document. By highlighting the shape in the source document, the diagnostic tool alerts you that there is an issue with the shape; at this point, you can choose to stop the validation and fix the shape by relinking the shape to the referenced file. If the diagnostic tool encounters a problem with a shape, and you choose to continue, the tool will resume traversing through the document until it encounters another broken shape or completes the validation process.
Reapplying List Templates
In Microsoft Word, there are various ways to create numbered and bulleted lists. By default, Microsoft Word comes with several list templates that you can use to create your lists; however, if any of these list templates are modified or become corrupt, you may need to reapply the original list templates in order to fix the lists in your Microsoft Word document.
To reapply list templates:
|
2. |
Go to Tools > Reapply List Templates. |
