The ITP/MDK Document Template

The ITP/Model Development Kit can also be configured to use a so-called Document Template. New (model) documents in the ITP/MDK Repository will be based on this Document Template. You can create your own template or you can use the default template Repository.dot that is installed with the ITP/MDK Repository Server.

The Document Template must be configured by the administrator. If no Document Template is configured, the ITP/Model Development Kit will use the default Microsoft Word template to base new (model) documents on. We strongly recommend to set the document template.

The Repository.dot

The Repository.dot is an example Document Template that is installed with the ITP/MDK Repository Server. We suggest that you either configure this template to be the Document Template or create your own Document Template. The Repository.dot contains a styles toolbar with predefined styles.

The Repository.dot styles toolbar

The ITP/Model Development Kit toolbar offers support for the layout of (model) documents. Styles are available to improve readability of ITP model documents and ITP include documents.

The ITP styles toolbar contains the following buttons:

• The ITP Heading button applies the style ITP Heading to the current paragraph or selected paragraphs.The paragraph in a function or procedure declaration that contains the FUNC or PROC keyword is put in the ITP Heading style. This style is in boldface and slightly larger than the ITP Normal style.
• The ITP Normal button applies the style ITP Normal to the current paragraph or selected paragraphs. ITP Normal is the style to be used for almost all ITP Code that you write in your model document. This style is defined with hanging indentation. If a paragraph does not fit on a single line any continuation line will automatically be indented with 2 tabs. Paragraphs defined in this style are kept together on a single page through the use of the 'Keep lines together' and 'Keep with next' options for paragraphs.
  You can also use the Microsoft Word line-break (SHIFT-ENTER) to split long lines. Line-breaks do not break the paragraph and the continuation lines will be indented 2 tabs.
  One can use the Increase Indentation key (CTRL-M) or button () to increase indentation one tab and the Decrease Indentation key (CTRL-SHIFT-M) or button () to decrease indentation one tab.
• The ITP Break button applies the style ITP Break to the current paragraph or selected paragraphs.
  The ITP Break style is used for empty lines that go between sets or lines and just after or before entries and function or procedure declarations. This style does not have the Keep lines together and Keep with next options so Microsoft Word will insert a page break here if necessary.
• The ITP Comment button applies the style ITP Comment to the current paragraph or selected paragraphs.
  This style should be used for comments.
• The ITP Include button applies the style ITP Include to the current paragraph or selected paragraphs.
  This style should be used for the paragraphs containing an __INC() tag.
• The Normal button applies the style Normal to the current paragraph or selected paragraphs.
  The style that is used for the text that has to be printed in the result document.

Of course these styles and the application of the styles is up to your own taste. The styles can be adapted through the normal Microsoft Word functionality and it is also possible to add your own buttons to the styles toolbar. Refer to the Microsoft Word documentation for more information on altering styles and adding buttons to toolbars.

Warning: Microsoft Word's AutoRecovery is not supported

Although a model document is saved to the ITP/MDK Repository when Save is chosen in Microsoft Word, the AutoRecovery follows its own path and doesn't save to the ITP/MDK Repository. We advise you not to rely on it and save your work regularly by hand.
Because the AutoRecovery mechanism is not straightforward it is not supported. A workaround is described in the Known Issues section Word's AutoRecovery is not supported

ITP/Model Development Kit start up problems

The ITP/Model Development Kit is created in Microsoft Word using macros. This means that the macro security setting in Microsoft Word can prevent the ITP/Model Development Kit from starting up. If this occurs you will get an error message. The macros used reside in the ITPMDKServer.dot and are signed by Aia Software. This means that when Aia Software is trusted the macro security setting can remain high.

Adding Aia to the trusted sources

To add Aia to the trusted macro sources you have to open the ITPMDKServer.dot template file. This file is located in the ITP/MDK Repository Client installation folder. Double click on it to open. The following window will appear:

All you have to do is check Always trust macros from this source. Once you have done that the Enable Macros button comes available, click it. Microsoft Word will open. You may close it. After Aia Software has been trusted the ITP/Model Development Kit should start without problems.