10 Implinks and Endpoints
Contents
1. Paste As object with description Resulting objects and diagrams Process Type diagram Service Type diagram A reference symbol is created as well as the referenced diagram with some con tents The keyword async after an opera tion means that it will be transformed us ing a signal interface A gate named G followed by the class name and a signal list named SL followed by the class name is added The keyword sync after an opera tion means that it will be transformed us ing an RPC interface The procedure di agram is created with an additional head ing symbol containing FPAR and RETURNS statements for parameters and return type If no keyword is given signal interface is the default for operations without re turn value and RPC interface is the de fault for operations with return value NOTE Text symbols containing the declarations of the signal list and the re mote procedures must be created by a separate Paste As operation usually in a diagram at a higher level See Text symbol with SDL interface on page 456 below ClassName SLClassName GClassName Process Type ClassName ay Rey EXPORT eS ncketeoe LAttr2 Type Oper2 Exported Procedure Oper2 IFPAR E PITI f RETURNS ReturnType July 2003 Telelogic Tau 4 5 User s Manual 455 Chapter 10 Implinks and Endpoints Paste As object with description Result2. The result of the consistency check is presented as a special view in the drawing area This Consistency view only shows endpoints entities from the two defined groups of documents Endpoints entities from the FROM group are shown in the normal way and endpoints entities from the TO group are shown as Dashed symbols The Consistency view is only showing links going from the FROM group of entities endpoints to the TO group After a link check the links shown are the real links as defined by the user After an entity match the links shown are only temporary links created by the Link Manager to indicate matching entities The link name for such links are Match ing and the link comment is Temporary link By selecting Endpoint or Entity view in Options gt Window the view will return to the selected normal view By pressing the quick button Show Endpoints or Entities the view will return to the previously used view Check Endpoints This menu choice checks if there are endpoints in the Organizer or in the editors that do not exist in the Link Manager or if there are invalid endpoints in the Link Manager This menu choice could be used to re move any inconsistencies between the document endpoints in the sys tem and the information in the Link Manager Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Link Manager The information in the saved files is used for the checking so if there are unsave
3. This section describes the link related commands that are available in the Link submenu in the Tools menu of the Organizer and all SDL suite editors Note None of these commands are possible to Undo The Organizer only supports a subset of the link commands The Link submenu contains the following menu choices e Link gt Create e Link gt Create Endpoint e Link gt Traverse e Link gt Link Manager e Link gt Clear e Link gt Clear Endpoint Link gt Create This menu command creates a link between the object selected in the editor and the object selected in the Entity Dictionary If two such ob jects are selected the Create Link dialog is opened see Figure 139 on page 443 The editor object does not need to have a link endpoint de fined to be able to create a link i e only one of the objects need to be present in the Entity Dictionary It is possible to create a link to itself Note In the Text Editor the selected text must already be a link endpoint It is not possible to create links to text that is not an endpoint If no object is selected in the editor or no endpoint is selected in the Text Editor the menu command is dimmed If no object is selected in the Entity Dictionary or the Entity Dictionary has not been opened a warning dialog is issued see Figure 138 and the Entity Dictionary window is opened or raised When the dialog is closed and the instructions given in it are followed the C
4. Text Fragment as a generic example Note The copied text fragment must either contain no endpoints or exact ly match an existing endpoint in the text If the text fragment con tains both endpoint text and non endpoint text it cannot be used for Paste As Paste As object with description Resulting objects and diagrams name Class symbol Text Fraqment Syntax check is performed on the class o e name Object symbol Text Fraqment Syntax check is performed on the object Sas Text fragment The pasted text is simply a copy of the cop ied text Text Fragment MSC instance MSC message out MSC message in The two message types place the endpoint at different ends of the message line Text Fragment Text Fragment MSC diagram In the Organizer the MSC diagram is add ed in the same way as for the Add New op eration i e the diagram is added as a new root diagram at the current selection The diagram is also opened in the MSC Editor 460 Telelogic Tau 4 5 User s Manual July 2003 Other Edit Commands Other Edit Commands July 2003 Some of the commands in the Edit menu in the editors are affected when operating on objects that have endpoints with connected links Pasting an Object If objects with endpoints are cut or copied the endpoints and any exist ing links to the objects are saved in the clipboard When pasting by using the ordi
5. The class name is also used as return type if an operation does not specify any NEWTYPE ClassName STRUCT Attri operator Attr2 Type Dper1 OPERATORS Oper1 ClassName gt ClassName Oper2 T1 gt ReturnType Oper3 T1 T2 gt ClassName OPERATOR Operi REFERENCED OPERATOR Oper2 REFERENCED OPERATOR Oper3 REFERENCED ENDNEWTYPE ClassName operator Dper2 Operator Oper1 operator Dper3 Operator Oper2 Operator Oper3 ae E IFPAR A iFPAR i P1 TI i PETI i IRETURNS ReturnType i 1 P2 T2 i DAE aA I System diagram In the Organizer the system diagram is added in the same way as for the Add New operation i e the diagram is added as a new root diagram at the current se lection The diagram is also opened in the SDL Editor T_ System ClassName ae System ClassName C class definition The link to the class definition is inserted inside a C comment class ClassName class ClassName public void Operl1 ReturnType Oper2 T1 P1 void Oper3 T1 P1 T2 P2 private Attrl Type Attr2 q July 2003 Telelogic Tau 4 5 User s Manual 457 Chapter 10 Implinks and Endpoints Paste As object with description Resulting objects and diagrams C struct definition The link to the struct definition is insert ed inside a C comment struct ClassName typedef struct Attri Type Attr2 ClassN
6. Link Manager uses the same icons for endpoints as the Entity Dic tionary See Entity Icons on page 436 for more information The icons can have different layouts indicating the state of the associat ed endpoint Normal The normal state of the icon Information is not modified Invalid An endpoint is marked invalid if after a Check Endpoints operation it is not present in the document where it was supposed to be Dirty The endpoint is modified or newly created from an editor but the link file is not yet saved Dashed The endpoint is already displayed on a higher level in the same tree or it belongs to the TO group after a Consistency Check The endpoints are added as new root symbols below the last link tree as they are created The order of the icons can be changed by using the quick buttons Move Down and Move Up Presentation Views and Link Trees The Link Manager has two main methods of displaying endpoints us ing an Endpoint view or an Entity view There is also a Consistency view used for presenting the results after a consistency check has been performed see Consistency Check on page 476 When there is no se lection in the drawing area the name of the currently displayed view is shown in the status bar In Endpoint view a link tree looks like this Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Link Manager Text SIGNAL Oper1 Oper3 T1 Class2 ssy 1 out 1 in Impl
7. Main C Examples demongame M ain spr eS k Figure 158 Selecting the FROM group In the list of Organizer documents and modules one or several docu ments must be selected Selecting deselecting a module will select de select all the documents in that module Selecting deselecting an SDL system will select deselect all documents in that system Individual doc uments in the module system can then be selected deselected without affecting the other documents When all FROM documents are selected the Continue button is used to close the dialog and continue to the next dialog Then the documents in the TO group must be selected The following dialog appears Telelogic Tau 4 5 User s Manual 477 Chapter 10 Implinks and Endpoints 478 Consistency Check Eg Performing a link check Select documents modules representing the TO group Chapter Diagram Structure unconnected Chapter My first SDL system unconnected System DemonGame C Examples demongame DemonGallll Cancel Block GameBlock C Examples demongame G ameBlock Help rocess Game_C Fxamnles demonname Game snr Process Main C Examplessdemongame M ain spr zj Figure 159 Selecting the TO group The list of Organizer documents and modules works in the same way as when selecting the FROM documents When all TO documents are se lected the Check button is used to close the dialog and start the consis tency check operation
8. an implementation link between the copied and pasted objects It is also possible to paste a cut object but in this case no link can be created It is possible to paste the object into an editor different from the one the object was copied from This requires a transformation of the object ac cording to the user s choice Paste As supports the SOMT method which governs the possible trans formations for a particular object See the SOMT Methodology Guide lines starting in chapter 69 in the User s Manual for information and ad vice on when to use a particular transformation Note The normal Paste command in the Edit menu is very different from Paste As A normal paste can only be performed in the same editor as the object was copied from and the pasted object is as far as pos sible an identical copy of the object The Paste As Process The process of using Paste As consists of the following steps 1 Copy or cut an object to the clipboard A single object is selected and copied to the clipboard by using the Copy command in the Edit menu of the editor The Paste As com mand supports the following objects being copied A class symbol in an OM Editor An object symbol in an OM Editor A text fragment in a Text Editor that either contains no end points or exactly matches an endpoint It is thus not possible to use Paste As with copied SDL or MSC sym bols or with Text symbols copied in an OM Editor Tele
9. and a symbol in the Entity Dic tionary is double clicked the text of the symbol is inserted in the parent editor A double click thus corresponds to using the Insert quick button see Insert on page 438 This functionality is not available in the Text Editor s Entity Dictionary Telelogic Tau 4 5 User s Manual 439 Chapter 10 Implinks and Endpoints The Filter Dialog The Filter dialog is opened when the Filter quick button is pressed in the Entity Dictionary window The Filter dialog controls what is to be shown in the Entity Dictionary window Filter Options x Endpoints Select endpoint types that should be hidden fod Start Procedure Start Macro Inlet Stop Procedure Return Macro Outlet State zi Show endpoints with filter m Show M Organizer Structure IV Diagram type names MV Endpoint type names OK Default Cancel Help Figure 137 The Filter dialog e Select endpoint types that should be This option menu controls whether the selected endpoint types should be hidden or shown The possible endpoint types are shown in a multiple selection list in which any number of items can be se lected If the option menu is set to shown only the selected endpoint types are listed in the Entity Dictionary If the option menu is set to hidden the selected endpoint types are hidden and the ones not be ing selected are thereby shown 440 Telelogic Tau 4 5 User s Manual Ju
10. marked as being an endpoint with at least one link i e if the editor object was not al ready an endpoint it will be created If the Entity Dictionary window was opened because of the Create Link command it will stay up until the user explicitly closes it Link gt Create Endpoint This menu command defines the currently selected object as a link end point The endpoint is immediately added to the Entity Dictionary and the Link Manager The object is marked as a link endpoint in the invok ing tool an editor or the Organizer See Visualization of Endpoints and Links on page 430 This command is dimmed if not exactly one object that can be defined as a link endpoint is selected or if the object already is an endpoint This command is also available in the popup menus of all editors and the Organizer Link gt Traverse This menu command traverses an existing link from the currently se lected object This is done by opening the tool where the other link end point is defined an editor or the Organizer and selecting the other end point object This command is dimmed if more than one object is selected or if the selected object has no links defined This command is also available in the popup menus of all editors and the Organizer as Traverse Link Telelogic Tau 4 5 User s Manual July 2003 July 2003 Link Commands in the Tools Menus If there is only one link defined from the object that link is
11. of the system The entities that the Entity Dictionary manage are all the link endpoints defined in the system as well as all diagrams documents and modules found in the Organizer structure The Entity Dictionary is accessible from the SDL suite editors The names in the Entity Dictionary are available for reuse in all texts and graphical objects found in the graphical diagrams However the Text Editor does not support reuse of texts in text documents The Entity Dictionary is also used for creating links between objects and existing endpoints when using the editors Relations to Editor Windows The Entity Dictionary is implemented as a modeless dialog window There is not a single Entity Dictionary window but one window for each type of diagram SDL MSC OM SC HMSC and text All Entity Dictionary windows contain exactly the same information and all the windows are updated when a change is made The reason for having an Entity Dictionary window for each editor type is that operations in the window apply to the object currently selected in the respective editor Since there might be several editor windows showing different dia grams documents there is a need to define the current window This is the editor window that will be associated with the Entity Dictionary and all operations will act on the current window The current window is the editor window where the user last performed a menu command or a mouse click detected by the edit
12. the pasted object In the following descriptions of object transformations we use the two class symbols shown in Figure 144 within the same scope as a generic example Regardless of which class symbol is copied both class sym bols are considered in the transformations Telelogic Tau 4 5 User s Manual 453 Chapter 10 Implinks and Endpoints ClassName Attr2 Type Oper2 P1 71 ReturnType sync Oper3 P1 T1 P2 T2 fasync ClassName Atte Oper Figure 144 Two class symbols in the same scope Note Even if there are more than one class symbol in the scope only the copied symbol will be linked with the pasted object if a link is cre ated Links are not created for the other symbols in the scope Paste As object with description Resulting objects and diagrams Class symbol ClassName The pasted class is simply a copy of the merged class Operi 3 Oper2 P1 T1 gt ReturnType syne Oper3 P1 T1 P2 T2 async Object symbol aClassName ClassName The pasted object contains the merged attributes of the class The object is named a followed by the class name System Type diagram Block Type diagram THA Block diagram ClassName ClassName In these cases only a reference symbol is created not any contents of the diagram ClassName 454 Telelogic Tau 4 5 User s Manual July 2003 The Paste As Command
13. 428 In addition the following concepts are used in the Link Manager e Entity A collection of endpoints with the same type and name in the same scope is called an entity The scope is defined as the file the endpoint resides in If the file is in an Organizer module the scope is the mod ule e Cardinality The number of links associated with an endpoint i e the total num ber of links going to and from the endpoint Link Manager Window The Link Manager s window is shown in Figure 147 The window title contains the name of the loaded link file and is appended by an asterisk if the link file is modified In the window the endpoints in the system are presented graphically us ing icons The links between the endpoints are represented as lines be tween them with an arrow stating the direction of the link The Link Manager can present different views of the endpoint link information these are described in Presentation Views and Link Trees on page 464 Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Link Manager Ef Link Manager demongame File Edit View Tools Help Ej 2 3 will xiz lM 2 nformation from C Examplesidemongame demongame Block Reference GameBlock DemonGame ssy Block Reference DemonBlock DemonGame ssy 2 in Class Class1 ClassDiagram1 som 2 out 1 in Link3 Object Object1 ClassDiagram1 som 1 out Link1 LJ Block Reference Demo
14. Chapter 10 July 2003 Implinks and Endpoints Implementation links and endpoints are important concepts in the SOMT method described in the SOMT Methodology Guidelines starting in chapter 69 in the User s Manual This chapter describes the tool support for implinks and endpoints The following topics are covered Link concepts How endpoints and links are visualized How to create links The Entity Dictionary window Link commands in menus The Paste As command The Link Manager tool Telelogic Tau 4 5 User s Manual 427 Chapter 10 Implinks and Endpoints Link Concepts and Overview 428 The SDL suite supports creating and maintaining links between differ ent objects in a system Such links are used to show relations between objects in different documents Objects that may be linked are e Text fragments in text documents e Graphical objects and symbols in OM SC HMSC SDL and MSC diagrams but not text fragments in such diagrams e Documents in the Organizer structure Implinks The link concept in the SDL suite is designed to support the SOMT method further described in the SOMT Methodology Guidelines start ing in chapter 69 in the User s Manual In SOMT an important relation is that one object can be seen as an implementation of another object For this reason links between objects are often referred to as implemen tation links or implinks For instance a textual object in the require ment analysis m
15. User s Manual July 2003 PATO aa Jor l k July 2003 The Entity Dictionary OM Aggregation OM Generalization SC Transition MSC Message MSC Create MSC Timer Set H MSC Reference HMSC Start HMSC Stop HMSC Connection Text symbols and text fragments Textual Notation The type and name of an entity is shown to the right of the icon For en tities containing a name such as diagram symbols this name is listed For other symbols and text fragments the first 25 characters are shown The cases when a diagram reference symbol a diagram heading or an Organizer document is an endpoint will result in duplication of informa tion in the Entity Dictionary To distinguish between such endpoints and the structure of Organizer documents the following textual nota tions are used e Link endpoints are listed using a plain font face e Documents and other Organizer items that are not endpoints are list ed using an italic font e Endpoints that are diagram reference symbols contain the word Reference after the diagram type e Endpoints that are diagram headings has the word Heading Ad ditional Heading or Extended Heading as the entity type Figure 136 on page 435 shows examples of these textual notations Telelogic Tau 4 5 User s Manual 437 Chapter 10 Implinks and Endpoints 438 l x je a E w 3 Ea e ca uge Operations in the Entity Dictionary The Entity Di
16. again for the same text string as the last per formed search The menu choice is dimmed if a search has not yet been done Consistency Check This menu choice is used for checking the consistency between a group of documents the FROM group and another group of documents the TO group In Entity view there are two types of consistency checks to choose from The following dialog appears Consistency Check x p Pert Continue Cancel entity match entity mate Help Figure 157 The Link Check Entity Match dialog 476 Telelogic Tau 4 5 User s Manual July 2003 The Link Manager July 2003 e Link check Check that all endpoints entities in the FROM group are linked with at least one endpoint entity in the TO group Entity match Check that all entities not endpoints in the FROM group has matching entities not endpoints in the TO group The above dialog is not opened in Endpoint view in which case a link check always is performed First the documents in the FROM group must be selected The follow ing dialog appears Consistency Check Eg Performing a link check Select documents modules representing the FROM group Chapter Diagram Structure unconnected Chapter My first SDL system unconnected System DemonGame C Examples demongame DemonGallll Cancel Block GameBlock C Examples demongame G ameBlock Help rocess Game_C Fxamnles demonname Game snr Process
17. ame void Oper1 ClassName ReturnType Oper2 ClassName T1 P1 void Oper3 ClassName TI Pl T2 P2 IDL module Only the class name is used The link to the module is inserted inside an IDL comment module ClassName module ClassName 1 IDL interface Operations marked with keyword fasync will get the string oneway void inserted before the name of the op eration interface ClassName interface ClassName attribute Attrl1 attribute Type Attr2 oneway void Operl1 ReturnType Oper2 T1 P1 oneway void Oper3 T1 P1 The link to the sequence is inserted in side an ASN 1 comment The link to the interface is inserted inside T2 P2 an IDL comment hi ASN 1 sequence ClassName SEQUENCE ClassName SEQUENCE Attr1 Attr2 Type Pasting an OM Object In a similar way as when pasting an OM class all object symbols of ex actly the same class in the scope are considered It is the combined set of attributes in the object symbols that will be used in the transformation to the pasted object In addition the class that the object is an instance of is also considered if it exists That is it is the combined set of attributes and operations in the class symbols and the objects symbols that will be used in the trans formation 458 Telelogic Tau 4 5 User s Manual July 2003 The Paste As Command In the following d
18. are not moved they will also be deleted Create Link This menu choice creates a link between the highlighted endpoint and the selected endpoint One endpoint is defined with the Highlight Endpoint menu choice the other is defined by the selection The Create Link dialog appears see Figure 139 on page 443 468 Telelogic Tau 4 5 User s Manual July 2003 The Link Manager Link Details This menu choice displays information about the link above the selected endpoint the name the comment and the direction of the link All these attributes can be edited The following dialog appears Link Details x T tare to Link Object Object Class Class1 from Link name flink3 Setect x Link comment This is a comment OK Cancel Figure 151 The Link Details dialog The dialog works in the same way as the Create Link dialog see Figure 139 on page 443 Clear Link This menu choice clears deletes the link above the selected endpoint Only the link will be cleared not the associated endpoints You will be asked to confirm or cancel the deletion July 2003 Telelogic Tau 4 5 User s Manual 469 Chapter 10 Implinks and Endpoints View Menu The View menu contains the following menu choices e Expand e Expand Substructure e Collapse e Options gt Window e Options gt Link e Options gt Endpoint Filter e Set Scale Expand This menu choice expands the endpoint structure
19. ay be implemented as an object class in the system anal ysis and later as a process type in the design model Implinks are the result of a design decision taken during the develop ment of a system Using implinks enables traceability between the dif ferent models and phases so that the usage of a particular object or con cept can be followed from requirements all the way down to code An other important aspect of implinks is that they facilitate consistency checks between the different models Links and Endpoints A link has two endpoints one at each of the objects that are linked to gether Endpoints can be created for objects without creating a link i e endpoints are entities separate from links When a link is created end points are created automatically if they do not already exist It is possi ble to have any number of links connected to an endpoint Endpoints and links can be created from the Organizer and the editors Links are bidirectional i e they can be traversed followed in both di rections Even so a link has a default direction defined when the link is created to indicate the intended direction This means that an end point is either a logical from endpoint or a logical to endpoint Telelogic Tau 4 5 User s Manual July 2003 Link Concepts and Overview A link has a name and optionally a comment The name indicates the type of link e g implementation link and the comment is use
20. ctionary window does not contain a menu bar Operations are available as quick buttons or as popup menus Quick Buttons The following quick buttons are special to Entity Dictionary window Close Close the Entity Dictionary window Create Link Create a link between the endpoint selected in the Entity Dictionary and the object selected in the parent editor The quick button is dimmed if not two such selections are present If the parent editor is a Text Editor the selected text must be an already existing endpoint The Create Link dialog is opened see Figure 139 on page 443 Insert Insert the text in the selected symbol in the Entity Dictionary at the in sertion point in the object selected in the parent editor The quick button is dimmed if not two such selections are present If text is selected in the parent editor s text window this text is instead replaced This button is not available in the Text Editor s Entity Dictionary Replace Replace the text content of the object selected in the parent editor with the text in the selected symbol in the Entity Dictionary The quick but ton is dimmed if not two such selections are present This button is not available in the Text Editor s Entity Dictionary Undo Undo the most recent text operation in the Entity Dictionary Insert Re place Undo The quick button is dimmed if the selection in the parent editor has changed to another object This button is not available
21. d changes in an editor these will not be taken into account in the checking If there are any documents in the Organizer which have not been saved the following dialog appears First the Organizer and all documents in the system are checked The following dialog appears Check Endpoints Eg These previously unknown endpoints were found with the help of the Organizer System DemonGame C Examples demongame DemonGam w with the help of editors Block Reference DemonBlock C Examples demongame Block Reference GameBlock C Examples demongame Object Object C Examples demongame ClassDiagram1 Class Class1 C Examples demongame ClassDiagram1 sc Condition Losing CAF xamnles demonqame D amon ame gt Add Cancel Help Figure 160 The first Check Endpoints dialog In the upper multiple selection list all endpoints that were found in the Organizer but do not exist in the Link Manager are listed In the lower multiple selection list all endpoints that were found in the documents belonging to the system but do not exist in the Link Manager are listed It is possible to select one or more of the endpoints in the lists with the purpose of adding them to the Link Manager e Continue Closes the dialog and continues to the next dialog Any selected endpoints are not added to the Link Manager e Add Adds the selected endpoints to the Link Manager The dialog is not clo
22. d to de scribe the link Link File Information about endpoints and links is stored in a central link file ex tension sli which is referred to from the Organizer s system file This approach makes it easy to get an overview of existing endpoints and links and to make consistency checks The link file is saved when ever the system is saved The link file and its defined links are man aged by a dedicated tool the Link Manager see Tool Support and Op erations on page 432 Information about endpoints are also stored in the individual docu ments However link information is only stored in the link file Local Link File To make it easier to use the endpoint and link features in a multiuser en vironment the concept of a local link file is provided This is a personal link file for one user storing all changes made to endpoint and link in formation compared to the global file the master link file A controlled merge operation is provided to update the master link file with the local link file information These operations are available as services in the Telelogic Tau Public Interface see Link File Services on page 552 in chapter 12 The Telelogic Tau Public Interface July 2003 Telelogic Tau 4 5 User s Manual 429 Chapter 10 Implinks and Endpoints Visualization of Endpoints and Links By default endpoints are marked in a special way in the editors and in the Organizer The markers are slight
23. e 472 Options gt Endpoint Options gt Endpoint on page 473 Filter Filter on page 474 Search Search on page 475 Search Again Search Again on page 476 Show Organizer Show Organizer on page 15 in chapter 1 User Interface and Basic Operations Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Link Manager Keyboard Accelerators In addition to the standard keyboard accelerators described in Key board Accelerators on page 35 in chapter 1 User Interface and Basic Operations the following accelerators can be used in the Link Manag er Reference to corresponding command or Accelerator quick button Ctrl E Show in Editor on page 480 Ctrl 1 Show Organizer on page 15 in chapter 1 User Interface and Basic Operations Del Clear Link on page 469 Arrow up Select the endpoint one step up move the selec tion Shift arrow up Move Up on page 484 Arrow down Select the endpoint one step down move the se lection Shift arrow down Move Down on page 484 Telelogic Tau 4 5 User s Manual 483 Chapter 10 Implinks and Endpoints IN e fe f S fe EL 484 Quick Buttons Except for some of the general Telelogic Tau quick buttons see Gen eral Quick Buttons on page 24 in chapter 1 User Interfac
24. e and Basic Operations the following quick buttons are included the Link Manag er Show Endpoints or Entities Switches between the Endpoint and the Entity views see Options gt Window on page 471 Consistency Check Performs a consistency check operation see Consistency Check on page 476 Highlight Endpoint Highlights the selected endpoint see Highlight Endpoint on page 467 Create Link Creates a link between the highlighted and the selected endpoint see Create Link on page 468 Switch Link Direction Changes the order of the links going to or from the root endpoint see Options gt Link on page 472 Show or Hide Unused Endpoints Toggles between showing and hiding endpoints that are not linked see Filter on page 474 Move Down Moves the selected root endpoint one step down in the Link Manager view Move Up Moves the selected root endpoint one step up in the Link Manager view Telelogic Tau 4 5 User s Manual July 2003 The Link File The Link File The Link Manager maintains a link file that contains a list of all end points and links in the system The link file is a line oriented human readable text file with the default file name extension s1li The file has the following format lt link file gt lt endpoints gt lt links gt lt endpoints gt ENDPOINTS lt endpoint gt lt endpoint gt lt endpoint id gt lt end
25. e ob ject was cut instead of copied this option is dimmed e Link name lt link name gt States the name of the link to create and is only valid if the Create link option is set By default the link name is Implementation Link but this can be changed in the Link Info dialog see below e Paste As Closes the dialog creates an object of the selected type pastes it in the invoking tool the Organizer or an editor and optionally creates a link In graphical editors pressing lt Esc gt cancels the paste 450 Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Paste As Command e Link Info Brings up the Link Info dialog see below where the attributes of the link can be changed before it is created This button is dimmed if the Create link option is dimmed or not set The Link Info Dialog The Link Info dialog is opened when the Link Info button is pressed in the Paste As dialog Link Info x Link name Implementation Link Select ei Link comment This is a comment OK Cancel Figure 143 The Link Info dialog e Link name An editable text field specifying the name type of the link to cre ate The name is preset to Implementation Link The five latest used link names when creating links is available in the Select option menu Selecting a name from this menu inserts the name into the text field The link name text field must not be empty e Link comment A
26. ementation Link Signal interface of process type Class ClassName Klassl som 17 out 1 in not shown 8 out Implementation Link Process Type Reference ClassName Class2 sun 1 in Figure 148 Link tree in Endpoint view To the right of each endpoint icon the following information identify ing the endpoint is displayed depending on the options set in Options gt Endpoint e The endpoint type i e the type of the endpoint object e The name of the endpoint in a plain type face For endpoints con taining a name such as diagram symbols this name is listed For other symbols and text fragments the first 25 characters are shown e The file the endpoint resides in The file name is shown with or without its absolute path depending on the setting in the Organizer e The link cardinality the number of out links followed by the num ber of in links e The number of hidden links if any within parenthesis For each link in a link tree the name of the link is displayed above the endpoint information in bold face The link name display can be switched on or off by the menu choice Options gt Link The link comment if it is used is shown directly below the link name in italics The comment display can be switched on or off by the menu choice Options gt Link In Entity view all endpoints representing the same entity are collected into one symbol and the number of endpoints represented by that entity is prese
27. escriptions of object transformations we use the ob ject symbol shown in Figure 145 as a generic example In addition the object is assumed to be located in the same scope as the two class sym bols shown in Figure 144 on page 454 Object ClassName attri 10 Figure 145 An Object symbol Paste As object with description Resulting objects and diagrams Class symbol The pasted class uses the class name attributes and operations from the copied object and the ob ject s class symbols Attri Attr2 Type Operi Oper2 P1 T1 gt ReturnType syne Oper3 P1 T1 P2 T2 async Object symbol The pasted object uses the name and attributes from the copied ob ject and the object s class symbols but without attribute values Object ClassName ttr1 Attra Block instance diagram Process instance diagram Service instance diagram The pasted diagram becomes an instance diagram indicated in the Organizer Object ClassName Object ClassName System diagram Works in the same way as when pasting an OM class The name of the diagram will be Object ClassName See System diagram on page 457 July 2003 Telelogic Tau 4 5 User s Manual 459 Chapter 10 Implinks and Endpoints Pasting a Text Fragment In the following descriptions of object transformations we use the text fragment
28. in the Text Editor s Entity Dictionary Filter Filter the information listed in the Entity Dictionary See The Filter Di alog on page 440 for more information Show Editor Raise the parent editor window Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Entity Dictionary Popup Menus The following tables lists the available operations in the popup menus of the Entity Dictionary window On the Window Background Appears when no symbol is selected and the menu is invoked in an area not containing any symbols Expand All Expands all collapsed symbols Collapse All Collapses all symbols only root symbols will be shown Collapsed symbols are indicated with a small triangle directly below the symbol Show Editor Raises the parent editor s window On a Document Symbol Appears if an Organizer document symbol is selected or the menu is in voked where a document symbol is selectable Expand Expands a collapsed symbol one level down Expand Substructure Expands the entire substructure of the symbol Collapse Collapses the substructure of the symbol On an Endpoint Symbol Appears if an endpoint symbol is selected or the menu is invoked where an endpoint symbol is selectable Show Definition Brings up an editor window or the Organizer window where the endpoint is selected Double Clicks If there is a selection in the parent editor
29. ing objects and diagrams Process diagram Service diagram The same transformation as for process type and service type but the signal in terface is added as a SIGNALSET state ment in the additional heading symbol NOTE Text symbols containing the declarations of the signal list and the re mote procedures must be created by a separate Paste As operation usually in a diagram at a higher level See Text symbol with SDL interface on page 456 below rr r ClassName ote Process ClassName 1 Vs ISIGNALSET SLClassName L Pate EXPORTEN Attr2 Type Oper2 Exported Procedure Oper2 Text symbol with SDL interface A text symbol is added containing dec larations for the signal list and or remote procedures as described for process type and service type above SIGNAL Oper1 Oper3 T1 T2 SIGNALLIST SLClassName Oper1 Oper3 REMOTE PROCEDURE Oper2 FPAR T1 RETURNS ReturnType 456 Telelogic Tau 4 5 User s Manual July 2003 The Paste As Command Paste As object with description Resulting objects and diagrams Text symbol with NEWTYPE A text symbol is added containing a NEWTYPE definition Operator dia grams are added for all operations with additional heading symbols containing FPAR and RETURNS statements for pa rameters and return type If an operation does not have parameters a parameter is inserted with the class name as type
30. ink earlier This operation is only available through the use of the Link Manag er See Create Link on page 468 Manually by linking together an endpoint and a selected object This operation requires an already existing endpoint selected in the Entity Dictionary and a selected object in an editor The endpoint may have been created manually or as an effect of creating a link earlier The selected object does not have to be an endpoint This operation is available from the editors and the Entity Dictio nary See Link gt Create on page 442 Automatically by copying and pasting an object Paste As This operation does not require any existing endpoints An object is first selected and copied in an editor The object is then pasted in an editor or in the Organizer by using the Paste As menu choice This transforms the object if necessary and automatically creates a link between the copied and pasted object This operation is available from the SDL MSC OM and Text Edi tors and the Organizer and supports the SOMT method See The Paste As Command on page 448 It is not available in the SC HM SC Editor Telelogic Tau 4 5 User s Manual 433 Chapter 10 Implinks and Endpoints The Entity Dictionary 434 The Entity Dictionary Concept The purpose of the Entity Dictionary is to provide easy access to names of entities being used in the system and a possibility to reuse these names in all parts
31. ject If the pasted object is a graphical symbol a floating symbol must be placed with the mouse in the usual way and the paste can be can celled by pressing lt Esc gt If the pasted object is a textual descrip tion or an Organizer document the object is placed at the text cursor or the current selection Edit the pasted object if needed The results of the object transformation may not be complete or ac curate The user may need to change the pasted object to achieve the desired result Telelogic Tau 4 5 User s Manual 449 Chapter 10 Implinks and Endpoints The Paste As Dialog The Paste As dialog is opened when Paste As is selected from the Edit menu Paste Class Class1 as Paste As Link Info Create link from copied object to pasted object Cancel Link name Implementation Link Help Figure 142 The Paste As dialog e Paste lt copied object gt as The option menu contains all possible types of objects that can be created in the current situation in some cases only a single alterna tive is available A default object type is pre selected The possible object types and the default are presented in Transformation Scheme on page 452 e Create link from copied object to pasted object This option controls whether a link is to be created between the cop ied and pasted objects This is by default set and the link will al ways be made from the copied object to the pasted object If th
32. l links connected to the endpoint This command is dimmed if more than one object is selected or if the selected object is not an endpoint If the selected object has no links connected to the endpoint the end point is removed without further user interaction The endpoint is re moved from the Entity Dictionary and the Link Manager The object is no longer marked as a link endpoint in the invoking tool an editor or the Organizer Note In the Text Editor this command can also be used to reduce the ex tent of an already existing endpoint If the selection only indicates a partial range of the endpoint at the start or end of the endpoint a di alog will appear allowing you to choose whether to remove the en tire endpoint or just remove the selected part of the endpoint from the selection If a partial range in the middle of the endpoint text is selected the only possibilities are to remove the entire endpoint or cancel the op eration If the selected object has one or more links connected to the endpoint a warning dialog is opened since the operation of removing a link cannot be undone Telelogic Tau 4 5 User s Manual 447 Chapter 10 Implinks and Endpoints The Paste As Command 448 The command Paste As is available in the Edit menu of the Organizer and in the SDL suite editors except for SC or HMSC diagrams The Paste As command is used to paste a copied object as another ob ject and at the same time create
33. lelogic Tau 4 5 User s Manual 471 Chapter 10 Implinks and Endpoints Options gt Link This menu choice sets options for controlling the appearance of links in the drawing area The following dialog appears Link Options Eg r Show M Name OK M Comment Cancel r Link ae Hel forward first e Figure 153 The Link Options dialog e Show Name Show hide the name of all links e Show Comment Show hide the comment for all links Links reverse first forward first This setting controls whether links going to a root endpoint reverse first or links going from a root endpoint forward first will be dis played first in the link trees 472 Telelogic Tau 4 5 User s Manual July 2003 The Link Manager Options gt Endpoint This menu choice sets options for controlling the appearance of end points in the drawing area The following dialog appears Endpoint Options Eg Show NM File M Cardinality M Not shown links OK Cancel Help Figure 154 The Endpoint Options dialog e Show Type Show hide the type of the endpoints e Show File Show hide the file name or module of the endpoints e Show Cardinality Show hide the cardinality i e the number of links going to and from an endpoint e Show Not shown links Show hide the number of hidden links going to and from an end point July 2003 Telelogic Tau 4 5 User s Manual 473 Chapter 10 Imp
34. links and Endpoints Filter This menu choice is used for filtering out endpoints and or links which will not be shown The filter is set in a modeless dialog i e the Link Manager continues working without waiting for the dialog to be closed If an endpoint is hidden all links associated to it will be hidden If a link is hidden the endpoints associated to it will still be visible The following dialog appears E Filter OP x Filter settings for endpoints ki Select endpoint types that should be hidden hs Class Condition Object Linknnwn oft gt I Hide not linked endpoints Apply Default Done Help Figure 155 The Filter dialog Filter settings for links endpoints documents By using this option menu filtering can be done on endpoint types link names and document file names All filters are active simulta neously i e for the filter to take effect all three filter conditions must be true The multiple selection list in the dialog contains all link names endpoint types or file names in the loaded link file depending on the current setting of the option menu By default nothing is selected e Select lt type of filter gt that should be hidden shown Depending on this option menu choice the selected links end points documents will either be hidden or shown 474 Telelogic Tau 4 5 User s Manual July 2003 The Link Manager Hide not linked endpoints If this option is set all e
35. logic Tau 4 5 User s Manual July 2003 July 2003 The Paste As Command Paste the object using Paste As In the desired editor or the Organizer the Paste As command is se lected from the Edit menu The menu choice is dimmed if More than one object was copied An object different from the list above was copied The copied object cannot be pasted into the tool i e there is no transformation defined for this particular object tool combina tion The possible transformations are listed in Transformation Scheme on page 452 After selecting the menu choice the Paste As dialog is opened See The Paste As Dialog on page 450 Select the type of object to paste the copied object as In the Paste As dialog the possible resulting object types are listed in an option menu The object types listed reflects the transforma tions possible for this particular copy paste situation If the desired object type is not present in the list the user may have to change which object is being copied the editor where the paste is made or for the SDL Editor the type of SDL diagram being pasted into Select the type of link to create if any In the Paste As dialog it is possible to change the default of creating an Implementation Link between the copied and pasted objects See The Link Info Dialog on page 451 If the object was cut in stead of copied no link can be created Place the pasted ob
36. ly 2003 July 2003 The Entity Dictionary Show endpoints with filter This text field is a pattern for matching endpoint names Only end points whose names match the pattern are shown in the Entity Dic tionary The string has the same syntax as a normal UNIX file pat tern and may contain the elements zero or more characters exactly one character and any character within the brack ets An empty text field matches any name i e it is equal to a single Organizer Structure This option controls whether the documents making up the Organiz er structure are shown If not set only endpoints are listed in the En tity Dictionary Diagram type name This option controls whether the diagram type names in the Orga nizer structure are shown If not set only the names of the diagrams are shown in the Entity Dictionary Endpoint type names This option controls whether the endpoint type names are shown If not set only the names of the endpoints are shown in the Entity Dic tionary Default Resets the Filter dialog to its default settings but does not close the dialog The default settings are The endpoint type list contains no selection The endpoint type option menu is set to hidden The endpoint name filter is empty The three Show options are set Telelogic Tau 4 5 User s Manual 441 Chapter 10 Implinks and Endpoints Link Commands in the Too s Menus 442
37. ly different depending on whether or not any links are connected to the endpoint Endpoints in Graphical Editors In the SDL Editor and the SDL suite diagram editors the endpoint marker is a small triangle in the upper left corner of the object s enclos ing rectangle The triangle is filled if the endpoint has any links connect ed to it Block Endpoints 7 5 Endpoint_only With_links Figure 132 Endpoints with and without links For lines in the SDL OM SC and HMSC diagrams the marker appears on the name or signal list associated with the line In SDL diagrams it is also possible to create endpoints on other text elements associated with the line Process1 Process2 Figure 133 Endpoints on lines and text attributes For lines in MSC diagrams messages timers create requests the marker normally appears at the start end of the line 430 Telelogic Tau 4 5 User s Manual July 2003 July 2003 Visualization of Endpoints and Links Message Figure 134 Endpoints on MSC lines You can hide the endpoint markers by changing the option Show Link Endpoints in the Editor Options in the View menu or by setting the ed itor preference ShowLinks to off Note Endpoint markers are never shown when printing a diagram Endpoints in Text Editors In the Text Editor endpoints are shown as underlined text regardless if they have links connected to them or not The endpoint text can be shown as normal
38. n optional comment text to be provided by the user The text in the comment field is initially empty The comment associated with a link can only be viewed and changed later on by using the Link Manager Telelogic Tau 4 5 User s Manual 451 Chapter 10 Implinks and Endpoints Transformation Scheme The table below presents all the possible object type combinations for the copied and pasted object in the Paste As operation The preselected choice shown when the Paste As dialog is opened is shown in bold face in Text Copied Pante as Paste As Basie ns Paste As Paste As object ee inSDL Editor MSC in Text Editor eee Editor Editor nizer Class Class System Type C class System GnOM f Object Block Type C struct Editor Block IDL Module Process Type IDL interface Process ASN 1 se Service Type quence Service Text symbol with NEWTYPE Text symbol with SDL interface Object Class Block instance System nOM f Object Process instance Editor Service instance Text Class Instance Text fragment MSC fragment Object Message Editor Note Not all object types are possible to Paste As in all situations Espe cially in the SDL Editor the available object types depend on which diagram type the Paste As is performed in 452 Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Paste As Command Transformation Details The details of the specific object transforma
39. n page 442 The operations include e Creating and deleting an endpoint e Creating and deleting a link e Traversing a link bringing the other endpoint into view e Opening the Link Manager In the Organizer the available operations in the Tools menu are limited to creating and deleting an endpoint and opening the Link Manager In the editors it is also possible to open the Entity Dictionary from the Window menu The Entity Dictionary lists all endpoints in the system together with the documents making up the Organizer structure It is mainly intended for re use of entity names but also supports creating links See The Entity Dictionary on page 434 The Link Manager shows all endpoints and links in the system It sup ports the following main operations e File operations on the link file e Creating and deleting links e Editing a link s direction name and comment e Performing consistency checks on endpoints and links Telelogic Tau 4 5 User s Manual July 2003 Creating Links It is not possible to create and delete endpoints in the Link Manager For more information about the Link Manager see The Link Manager on page 462 Creating Links There are basically three different ways to create links July 2003 1 Manually by linking together two endpoints This operation requires two already existing endpoints The end points may have been created manually or as an effect of creating a l
40. nBlock DemonGame ssy 2 in v Ld Link2 v Condition Losing DemonGame msc 3 in Object Object1 ClassDiagram1 som 1 out Link3 a Class Class1 ClassDiagram1 som 2 out 1 in Endpoint View Figure 147 The Link Manager window At the top of the drawing area the name of the current link file is pre sented under a Information from heading If several link files are merged they are all listed here until the next Save operation If a local link file is used see Local Link File on page 429 both the master link file read only and the local link file are listed If the information in the Link Manager is not yet saved on line edit ing will be displayed to indicate that endpoints have been created in an editor or in the Organizer The main part of the drawing area displays all endpoints and links as link trees Every endpoint is a root node and the associated links and endpoints are added to that root Link trees can be collapsed and end points and links can be hidden Below the link trees some statistics are presented under a Statistics heading The number of endpoints and links is displayed including the number of hidden endpoints and links as in the following example Statistics 10 endpoints 2 not shown Telelogic Tau 4 5 User s Manual 463 Chapter 10 Implinks and Endpoints 464 4 links 1 not shown Endpoint Icons The
41. nary Paste command an object with an endpoint but without connected links the endpoint is pasted together with the object without further user interaction When pasting objects that also have links connected to their endpoints the following dialog appears Some of the objects in the clipboard had links attached Should new links be established to the pasted objects No Cancel Help Figure 146 The Paste dialog e The Yes button pastes the objects and keeps the links An object hav ing connected links will be pasted with new links created between the pasted object and the objects the original object was linked to e The No button pastes the objects without endpoints and links No pasted objects will have any endpoints or connected links Deleting an Object If you delete an object that has links the link information will be de stroyed and cannot be restored Therefore when you want to cut or clear objects with links a warning dialog will be issued where it is possible to cancel the operation Telelogic Tau 4 5 User s Manual 461 Chapter 10 Implinks and Endpoints The Link Manager 462 The Link Manager manages endpoints and links in a system The Link Manager handles the link file containing information about the end points and links in a system The syntax of the link file is described in The Link File on page 485 For an overview of link concepts see Link Concepts and Overview on page
42. ndpoints which are not linked will be hid den This option is dimmed if filtering is not done on endpoint types e Pressing Default will set all the lists to their default values but the filter is not applied until Apply is pressed Set Scale Issues a dialog where the scale may be set Tools Menu The Tools menu contains the following menu choices e Show Organizer see Show Organizer on page 15 in chapter 1 User Interface and Basic Operations Search e Search Again e Consistency Check e Check Endpoints e Show in Editor Search This menu choice searches for a text string in endpoints or links The searching is based on ASCII character matching All texts related to the endpoints and links are searched i e endpoint types and names link names and comments The search will start from the selected endpoint or from the first end point if nothing is selected The following dialog appears July 2003 Telelogic Tau 4 5 User s Manual 475 Chapter 10 Implinks and Endpoints Search x Search for I Ignore case Consider case Search Cancel Help Figure 156 The Search dialog e Search for The text string to search for If a search already has been done the previous search text is used by default e Ignore Case Consider case Depending on the radio button setting the search will either be case sensitive or not Search Again This menu choice searches
43. nted to the right of the name of the entity preceded by an aster isk Also instead of displaying the filename the endpoint resides in the scope the entity resides in is displayed The scope is either a filena me or a module An example of an endpoint in Entity view ES Class ClassName 2 Module PasteAs2 17 out 1 in not shown 8 out Figure 149 An entity in Entity view Telelogic Tau 4 5 User s Manual 465 Chapter 10 Implinks and Endpoints 466 Link Manager operations on endpoints also apply to entities If there is a difference in the behavior of a menu choice depending on the view this will be pointed out in the descriptions of the operations Double Clicks Double clicking on an icon invokes the menu choice Show in Editor In Entity view if the selected entity corresponds to several endpoints they will be selected one at a time for each double click Menu Bar This section describes the menu bar of the Link Manager window and all the available menu choices The menu bar contains the following menus e File Menu e Edit Menu e View Menu e Tools Menu e Help Menu see Help Menu on page 15 in chapter 1 User Interface and Basic Operations File Menu The File menu contains the following menu choices e New e Open e Merge Save e Save As e Print e Close The menu choices are described in File Menu on page 8 in chapter 1 User Interface and Basic Operations except P
44. oice replaces an endpoint with another endpoint This op eration is useful if an endpoint has become Invalid and the user has found a replacement endpoint that all links should be moved to One endpoint is defined with the Highlight Endpoint menu choice the other endpoint is defined by the selection All links going to or from the replaced endpoint will be updated to go to or from the other endpoint instead If the replaced endpoint was in valid the user is given the option to delete the replaced endpoint Telelogic Tau 4 5 User s Manual 467 Chapter 10 Implinks and Endpoints The following dialog appears Replace Endpoint Eg C Replace selected Block Reference GameBlock Move links going M to M from highlighted Block Reference DemonBlock to selected Block Reference GameBlock Jo Delete replaced and invalid endpoint Replace Cancel Help _Revlace ce He Figure 150 The Replace Endpoint dialog e Replace highlighted lt endpoint gt Replace selected lt endpoint gt Depending on the setting of the radio button either the highlighted or the selected endpoint will be replaced Move links going to from These options are used to select if links going to the replaced end point or links going from the replaced endpoint will be moved Delete replaced and invalid endpoint If the endpoint to be replaced is invalid it can optionally be deleted If any links going to the deleted endpoint
45. or The editor associated with an Entity Dictionary window is known as the parent editor The editor type is reflected in the window title of the En tity Dictionary window thus making it possible to distinguish the dif ferent Entity Dictionary windows and to determine the parent editor that the Entity Dictionary operations will affect Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Entity Dictionary Entity Dictionary Window The Entity Dictionary Window can be opened from all of the editors through the use of the menu choice Entity Dictionary in the Window menu gi Entity Dictionary System DemonGame 1 A e 2 a l l 2 Diagram Structure My first SDL system __ System DemonGame H Block Reference DemonBlock Block Reference GameBlock H Block GameBlock Process Main Process Game Block DemonBiock To Process Demon F Class ClassDiagram1 J object Object1 L Class Class1 Other Documents MSC DemonGame lt gt Condition Losing Instance Head Main Figure 136 The Entity Dictionary window Contents and Structure The window lists all the defined link endpoints following the structure of diagrams and files in the Organizer By default every item in the Or ganizer is repeated and the indentation of items is also repeated All Or ganizer items and link endpoints listed in the window are known as en tities in the Entity Dictionary Telelogic Tau 4 5 User s Man
46. point format gt lt endpoint id gt lt integer gt A unique integer identifying the endpoint in the link file lt endpoint format gt lt format gt lt file name gt lt anchor gt lt name gt lt type gt lt format gt SDL OM MSC TEXT WORD lt file name gt lt string gt Name of the document file lt anchor gt lt string gt A unique string identifying the endpoint in the document If the end point refers to the whole file i e the endpoint is created in the Or ganizer the anchor is set to an empty string lt name gt lt quoted string gt The name of the endpoint in quotes lt type gt lt integer gt Type of document lt links gt LINKS lt link gt lt link gt lt endpoint id gt lt endpoint id gt lt link name gt lt link comment gt lt link name gt lt quoted string gt The name of the link in quotes lt link comment gt lt quoted string gt The link comment in quotes July 2003 Telelogic Tau 4 5 User s Manual 485 Chapter 10 Implinks and Endpoints 486 Telelogic Tau 4 5 User s Manual July 2003
47. r the link endpoints are preserved This com mand is dimmed if more than one object is selected or if the selected object has no links defined Caution Removing a link cannot be undone A dialog showing all links is opened and one or more of the links has to be selected Clear Link Eg No Undo available Select link s to clear Clear To Block Reference DemonBlock To Condition Losing From Object Object1 Cancel 7 Help Figure 141 The Clear Link dialog The links to and from the object are listed in the following form Froml To lt type and name of linked object gt The list of links is a multiple selection list in which one or more links can be selected When a selection is made in the list the Clear button becomes active To remove links select the links in the list and click the Clear button A link is removed from both endpoint objects but the link endpoints themselves are not removed If either of the endpoint objects had only this link defined and no others the mark of the object changes to indi cate that the object is only an endpoint with no links defined For infor mation on how to remove an endpoint see Link gt Clear Endpoint on page 447 below 446 Telelogic Tau 4 5 User s Manual July 2003 July 2003 Link Commands in the Tools Menus Link gt Clear Endpoint This menu command removes the link endpoint from the currently se lected object and subsequently al
48. reate Link di alog is opened Telelogic Tau 4 5 User s Manual July 2003 Link Commands in the Tools Menus To be able to create a link there must be an endpoint selected in the Entity Dictionary Select an endpoint and then press the Create Link button Figure 138 The Create Link warning The Create Link dialog looks like this Create Link x Link Block Reference GameBlock R Class from Link name Implementation Link Select 7 Link comment Create Cancel Figure 139 The Create Link dialog e Link lt editor object gt to from lt entity dictionary object gt The two selected objects are listed at either side of the to from radio buttons The radio buttons control which of the objects that is to be the logical to and from object Link to is the default e Link name The name of the link A name can be entered or edited in the text field or be selected from the associated option menu The five latest July 2003 Telelogic Tau 4 5 User s Manual 443 Chapter 10 Implinks and Endpoints 444 used link names when creating links will be available in the option menu and the name in the text field is preset to the latest used link name A link name must be specified e Link comment An optional comment text to be provided by the user The text box is initially empty e Create Creates a link between the two objects The link will be visible in the Link Manager and the endpoint objects are
49. rint which is described in The Print Dialogs in the SDL Suite and in the Organizer on page 308 in chapter 5 Printing Documents and Diagrams and Merge which is described below Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Link Manager Merge This menu choice opens an existing link file and merges the contents of that file with the information already in the Link Manager It works in a similar way to Open but keeps the current endpoint and link infor mation If two links are equal i e they have the same source and destination endpoints and the same name but they have different link comments the new comment will consist of the old comments separated by a new line character Edit Menu The Edit menu contains the following menu choices e Highlight Endpoint e Replace Endpoint e Create Link e Link Details Clear Link Highlight Endpoint This menu choice highlights an endpoint Highlighting an endpoint is the first step to replace an endpoint or create a link The highlighting is presented as a frame around the highlighted endpoint The first time this menu choice is used the selected endpoint will be highlighted The second time this menu choice is used for the same end point the highlighting will be removed There is at most one highlighted endpoint If another endpoint already was highlighted the highlighting is moved to the selected endpoint Replace Endpoint This menu ch
50. sed until the Continue button is pressed Telelogic Tau 4 5 User s Manual 479 Chapter 10 Implinks and Endpoints 480 Then the endpoints in the Link Manager are checked If any non exist ing endpoints are found they will be marked as Invalid The following dialog appears In the upper multiple selection list all Link Manager endpoints which reside in files that have been deleted are listed In the lower multiple se lection list all Link Manager endpoints that no longer are present in the files they are supposed to be in are listed It is possible to select one or more of the endpoints in the lists with the purpose of deleting them Check Endpoints x These invalid endpoints were found Not existing endpoints and files Condition Winning C Examples demongame D emonGame2 H Not existing endpoints existing files Object Object1 C Examples demongame ClassDiagram1 so a Delete Cancel Help Figure 161 The second Check Endpoints dialog from the Link Manager Closes the dialog and returns to the main window Any selected endpoints are not deleted from the Link Manager Deletes the selected endpoints from the Link Manager The dialog is not closed until the OK button is pressed Show in Editor This menu choice will show the symbol which corresponds to the se lected endpoint in an editor Telelogic Tau 4 5 User s Manual July 2003 The Link Manager In Entity view each enti
51. text by changing the option Show Link Endpoints in the Editor Options in the View menu or by setting the Text Editor pref erence ShowLinks to off In the Emacs editor on UNIX endpoints without links are by default shown as blue underlined text whereas endpoints with links are shown as bold blue underlined text The default font faces can be changed see Type Faces for Endpoints on page 403 in chapter 7 Emacs Integra tion In MS Word in Windows endpoints without links are shown as blue underlined text whereas endpoints with links are shown as bold blue double underlined text Endpoint text is always shown as normal text when printing a text doc ument Telelogic Tau 4 5 User s Manual 431 Chapter 10 Implinks and Endpoints Endpoints in the Organizer In the Organizer the endpoint marker appears in the same way as in the graphical editors i e a triangle in the upper left corner of the document icon MSC Endpoints E Block Endpoints Figure 135 Endpoints in the Organizer The endpoint markers are always shown in the Organizer and they are also shown when printing the Organizer window Tool Support and Operations 432 Operations on endpoints and links are supported in the Organizer the diagram editors the Text Editor and the Link Manager In the editors the possible operations are identical and can be found in the Link submenu of the Tools menu see Link Commands in the Tools Menus o
52. tions are described in the following subsections Please refer to the above table to see which tools that support a particular object transformation Some general transformation details are e The name of a copied symbol can be empty When pasted as an SDL diagram the name EmptyName will be used e In SDL diagrams if the name used for a pasted symbol will be in conflict with an already existing name the pasted name will be the original name suffixed by _ lt number gt For example if Name already exists for a reference symbol in an SDL diagram the pasted symbol will have the name Name_1 The number is incremented until the name is unique e The size of the pasted SDL MSC and OM symbols are the same as when a symbol is manually picked from the editor s symbol menu e The exact layout of generated diagrams may not be depicted cor rectly in the following illustrations Only the upper left part of a di agram is shown Pasting an OM Class An OM class may be represented and defined by several class symbols in the OM diagrams This is the case if more than one class symbol with exactly the same class name is found within the OM scope the diagram itself or the diagrams in the same Organizer module When an OM class is pasted all class symbols defining the class in the scope are considered It is the combined set of attributes and opera tions in the class symbols that will be used in the transformation to
53. traversed as described above If more than one link exists a dialog showing all links is opened and one of the links has to be selected Traverse Link x Traverse Link Cancel Y Help b Select a link to traverse To Block Reference DemonBlock Demona ame ssy To Condition Losing DemonGame msc From Object Object1 unconnected Figure 140 The Traverse Link dialog The dialog presents a list of all links to and from the object in the fol lowing form From To lt type and name of linked object gt lt file name gt The type and name of the linked object follow the same notation as in the Entity Dictionary see Textual Notation on page 437 The file name of the document where the linked object is found contains a path if the file is not in the Organizer s Source Directory e To traverse a link select the link and click the Traverse Link button or double click the link Link gt Link Manager This menu command opens or raises the Link Manager window If ex actly one object is selected and this object is a link endpoint this end point will be selected and made visible in the Link Manager This com mand is never dimmed For more information about the Link Manager see The Link Manager on page 462 Telelogic Tau 4 5 User s Manual 445 Chapter 10 Implinks and Endpoints Link gt Clear This menu command removes one or more links to or from the currently selected object Howeve
54. tree one level down for the selected endpoint If any endpoints one level down are hidden they will still be hidden after this operation Use the Filter menu choice to show or hide endpoints The menu choice is dimmed if e No endpoint is selected e The selected icon is a leaf no children icons e The selected icon is already expanded Expand Substructure This menu choice expands the endpoint structure tree the whole way down for the selected endpoint If there is no selection all endpoint trees will be expanded Collapse This menu choice collapses the selected endpoint i e the sub symbols are not shown after this operation A collapsed endpoint has a small tri angle drawn below the icon to indicate that it is collapsed If there is no selection everything will be collapsed 470 Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Link Manager Options gt Window This menu choice sets options for controlling the appearance of the Link Manager window The following dialog appears Window Options Ea Show M Tool bar OK M Status bar e Figure 152 The Window Options dialog Show Tool Bar e Show Status Bar These options control whether the tool bar and the status bar should be displayed or not e Show endpoints entities By using this radio button Endpoint or Entity view is selected see Presentation Views and Link Trees on page 464 Te
55. ty can represent more than one endpoint In that case the menu choice will be replaced by Show I in Editor Show 2 in Editor etc If there are more than nine endpoints the menu choice Show in Editor will invoke the following dialog where it is possible to select the appro priate endpoint Show in Editor x Show endpoint number Show T T Cancel Help Figure 162 The Show in Editor dialog Telelogic Tau 4 5 User s Manual 481 Popup Menus Chapter 10 Implinks and Endpoints There are two popup menus available in the Link Manager On Endpoints Highlight Endpoint Highlight Endpoint on page 467 Replace Endpoint Replace Endpoint on page 467 Create Link Create Link on page 468 Link Details Link Details on page 469 Clear Link Clear Link on page 469 Expand Expand on page 470 Expand Substructure Expand Substructure on page 470 Collapse Collapse on page 470 Show in Editor Show in Editor on page 480 On the Background Consistency Check Consistency Check on page 476 Check Endpoints Check Endpoints on page 478 Expand Substructure Expand Substructure on page 470 Collapse Collapse on page 470 Options gt Window Options gt Window on page 471 Options gt Link Options gt Link on pag
56. ual 435 Chapter 10 Implinks and Endpoints 436 Below each Organizer item the link endpoints defined in that item are listed with indentation e Below each SDL diagram the symbols marked as link endpoints are listed e Below each MSC diagram the instances messages and other sym bols marked as link endpoints are listed e Below each OM diagram the names of all the classes instances and other symbols marked as link endpoints are listed e Below each text document the text fragments marked as link end points are listed For an Organizer item that contains both sub documents and link end points the endpoints are listed first followed by the sub documents It is possible to hide the Organizer items to display only the link end points see The Filter Dialog on page 440 for more information The information in the Entity Dictionary is updated whenever a link endpoint is created changed or cleared in any of the editors or the Link Manager or when the Organizer structure is modified Entity Icons Each entity has an associated icon that identifies the type of the entity i e the type of the endpoint object Entities that already have an estab lished icon in the Organizer or the Index Viewer use the same icon in the Entity Dictionary with a few exceptions The icons specific to the Entity Dictionary are Diagram Heading Diagram Extended Heading OM Class OM Object OM Association Telelogic Tau 4 5
Download Pdf Manuals
Related Search