In the Organizer, MS Word document are represented with the icon shown to the left. Unlike other document types, when a MS Word documents becomes modified, its icon is not marked as "dirty".
(Windows only)
In Windows, Microsoft Word is integrated with Telelogic Tau and MS Word documents are handled by the Organizer.
Handling of SOMT implementation links is supported.
This chapter contains a user manual to MS Word in Telelogic Tau; the functionality it adds and the new menu.
The implementation works with MS Word 7.0 (MS Office 95) and MS Word 8.0 (MS Office 97) in Windows. It is assumed that you are familiar with MS Word terminology and how to use MS Word. Some experience with MS Word templates and macros is also required when setting up the integrated environment.
Support for MS Word document editing is available in the Organizer. When connecting MS Word to the Organizer, the process SdtWord will be started in the background.
In the Organizer, MS Word documents are identified by the document type "Text Word" when adding new or existing documents.
|
|
In the Organizer, MS Word document are represented with the icon shown to the left. Unlike other document types, when a MS Word documents becomes modified, its icon is not marked as "dirty". |
A new MS Word documents is always named "Document<x>", where <x> is an integer, regardless of what name it was given in the Organizer.
SOMT implementation links in MS Word documents are supported. This gives the possibility to handle link endpoints and follow the links defined for these endpoints.
An MS Word endpoint icon in the Organizer looks the same as a document icon.
In MS Word, endpoints are marked with special character formats. The appearance for endpoints without associated links is underlined, blue text. The appearance for endpoints with associated links is double underlined, bold, blue text.
Endpoints in MS Word documents are represented with bookmarks whose names are of the format "SDT_<x>", where <x> is an integer uniquely identifying the endpoint.
Undo is not available for the link handling commands.
To be able to use MS Word with Telelogic Tau, do as follows:
sdt95.dot (available in <Installation Directory>\bin\wini386\sdt95.dot) into the folder \MSOffice\Winword\Startup. This means that the template becomes global and the Telelogic Tau commands will be available in MS Word all the time.sdt95.dot to your document templates are:AutoClose AutoNew AutoOpenConsult the MS Word documentation on how to copy the macros to your templates.
There is an automatic installation program available in <Installation Directory>\bin\wini386\sdtwordinstall.exe. You can also make a manual installation:
sdt97.dot (available in <Installation Directory>\bin\wini386\sdt97.dot) into a temporary folder.sdt97.dot in MS Word and copy the modules:SDTAutomacros
SDTMisc normal.dot. Make sure there are no conflicts with other automacros in normal.dot. sdt97.dot.sdt97.dot copy into the folder \MSOffice\Winword\Startup. normal.dot to sdt97.dot.You should check that MS Word points at your start-up folder by choosing Tools > Options. In the dialog that appears, select File Locations and check where the file type Startup is pointing. It should point at the directory where you placed sdt95.dot or sdt97.dot.
|
Note: Do not use |
In the Preference Manager, the following parameter should be set:
| Parameter | Value |
|---|---|
|
SDT* WordCommand |
The command that starts MS Word (the default is "Winword.exe"). |
Make sure that the path points to its directory.
This section lists and describes the MS Word menu commands associated with the integration with Telelogic Tau. Both new commands and the affected ordinary (existing) commands are described.
The new commands are accessible from a menu in MS Word called SDT. It contains the following menu choices:
Connects to Telelogic Tau. This is done automatically when starting MS Word.
Disconnects from Telelogic Tau. This is done automatically when exiting MS Word.
Opens or raises the Organizer.
Shows the selected SDT reference in an appropriate editor. This requires that the user has selected the reference text or placed the cursor inside it.
Creates a new endpoint that will be marked with a special character format in the text (see Link Handling) and notified to Telelogic Tau. This command requires that the user has selected the region of text to convert to an endpoint. Endpoints are not allowed to overlap and must consist of at least one character.
Deletes an endpoint. The endpoint text will be converted to plain text and the deletion will be notified to Telelogic Tau. All links associated with the endpoint will be cleared. This command requires that the user has selected or placed the cursor inside the endpoint text.
Follows one of the links associated with an endpoint. This results in displaying the endpoint on the other end of the link in an appropriate editor. If only one link is associated with the endpoint, this link is followed. Otherwise the user is offered to choose between the associated links in a dialog.
This command requires that the user has selected or placed the cursor inside the text of an endpoint marked as having associated links.
Opens the Link Manager and shows the selected endpoint. This requires that the user has selected or placed the cursor inside the endpoint text.
When applying styles and character formats to text containing endpoints, the endpoint character format may be changed and thus it becomes impossible to tell where the endpoints are located. By using this command all endpoints in the active document will have the endpoint character format applied to them.
Furthermore, when deleting text containing endpoint using the keyboard (<Delete>) instead of menu choices, or pasting text with endpoints from other documents, this is not notified to Telelogic Tau. By executing this command, a synchronization with the Link Manager takes place in order for it to have a consistent view of the endpoints in the active document.
Disconnects from Telelogic Tau before exiting.
The new buffer is notified to Telelogic Tau and takes part in the interaction.
The loaded buffer is notified to Telelogic Tau and takes part in the interaction.
The buffer is notified as saved to Telelogic Tau.
The buffer is notified as unloaded to Telelogic Tau.
The endpoint is notified as modified to Telelogic Tau.
|
Note: In MS Word, inserted text take the same character format as the character that precedes it. Added characters in front of the endpoint text will not take the character format of the endpoint text until the endpoint is updated (see Update Endpoints). When the cursor is placed directly after the endpoint text, added characters will not become part of the endpoint text, even though the character format will indicate so. |
All endpoints within the selection will be deleted. See Delete Endpoint.
All endpoints within the selection will be deleted. See Delete Endpoint. Endpoints in the copy of the selection is represented by plain text.
Endpoints in the copy of the selection is represented by plain text.
Endpoints (bookmarks) not already defined in the document, in which the Paste operation is done, will be created. However, the text region is still plain text and the endpoints have to be updated in order to apply the endpoint character format to the new endpoints.
No undo information is recorded for the link handling commands. Consequently, these commands cannot be undone.