Home

Objectiver User Manual

1. 61 12 3 Browsing through the web formatted documentation 62 12 4 About documentation contents 62 12 5 Working with diagrams SVG viewer 64 IASEEETUMIML 64 12 5 2 Zooming in and Outs ersin yet ae p ree e P ni een le 64 12 5 3 Finding the diagrams in which a concept appears ss 64 12 5 4 Finding the text documents in which a concept is referenced sss 64 12 5 5 Locating a concept in an index 64 12 5 6 Locating a concept in a diagrammes 64 12 57 Printing a diagram eee ei eee pet n ne e ERES EUER GERM SEO DNE 65 12 5 8 Show informal defs and issues in diagrams eese 65 Report Edition and Publication 66 13 1 About R ports ves eri IO ex rr IE a es YR AP TQ has See RE Ree yes 66 13 2 Basic Operations sce dose eq ere e ardt re Iob Asa ep e RERO Un t Qu ERE d 66 13 3 Report Editor toolbat 3 22 octets rete ee er rv de eh re eee 66 13 4 Adding a document to a report 66 13 4 1 Adding an existing document seen 66 13 4 2 Creating a new document etie aS ARENE ESERIES EEEREN 67 13 5 Handling documents inside the report 67 13 6 Removing document from a report
2. 68 13 7 Publishing reports fesse venh ene REESE men de Que ean esr PITE 68 PART E Generating Requirements Documents 71 14 0 15 0 16 0 Requirements Documents 72 14 1 Creating custom reports by hand 72 14 2 Template based report generation 72 14 2 1 Diagram explanation texts 14 2 2 Creating a diagram report 14 2 3 Creating package report Professional and Enterprise Edition only 74 14 2 4 Generating specific sections of the requirements documentation esses 75 14 2 5 Updating generated reports and documentation 75 14 3 Wizard based report generation 76 14 3 1 Providing content for the Introduction 76 14 3 2 Defining the User Requirements Section 77 14 3 3 Defining the System Requirements section sn 77 14 3 4 Applying the Wizard nn eee re nn eee re teintes 77 Document Generator 78 15 4 About the Document Generator 78 15 2 Activating the generato 2eme Daw od EXE N dese nement Hae ee Sole ee 78 15 3 Applying a template eene erga eet p eT DL Sie kel oh cet Reto MER a 78 15 4 Available Templates eeu n ih aed Rr nn ee EIRTO aque ee P sse ee aE Ss 78 15 4 1 All Agent re
3. FIGURE 53 13 6 13 7 Reports containing OO Text documents By dragging and dropping documents the report editor enables you to redefine the sequence of documents Removing document from a report 1 Select in the report the document you want to remove 2 Open the context menu and select the Remove from report item or click the Remove a document button in the report editor toolbar Publishing reports Unc Objectiver allows you to export reports in different formats RTF Rich Text Format Microsoft Word ODT for OO Text documents from Open Office Note Publishing reports directly in PDF is no longer supported in version 3 0 as they are plenty of PDF converters existing on the market that allow you to convert Word or Open Office documents into PDF To publish a report 68 Objectiver User Manual Respect IT sa Report Edition and Publication 1 Choose File gt Publish Report A dialog box called Report publication options appears Figure 54 2 Select the report document to export by clicking on the corresponding but ton A dialog box containing the list of all existing reports appears Select one of them Report publication options E x Report E Output file C Documents and Settings av Desktopidoc rtf E Output format Rich Text Format rtf _ Use template Ea v Rasterize diagrams 72 dpi 100 dpi 150 dpi 300 dpi 500 dpi _ Output SVG
4. Respect IT sa Objectiver User Manual 77 Document Generator 15 0 Document Generator 15 1 About the Document Generator The document generator allows you to produce new diagrams texts or reports reports are described in Section 13 0 Documents are generated according to a template some templates require parameters you need to type in before generating the document Templates make use of predefined queries on the model 15 2 Activating the generator 15 3 15 4 15 4 1 Choose Tools gt Generator to activate the generator Figure 56 shows a screenshot of the generator Generate Goal model diagram Description Parameters FIGURE 56 Generator Applying a template 1 Choose a template in the combo box 2 If needed give a value to the parameters 3 Click the Generate button The document is created in the selected package see Section 7 3 and can be opened from the Explorer Available Templates Only the second and fourth template are available with the Standard Edition All Agent responsibility diagrams The generator creates a diagram for each agent in the model Each diagram contains the agent and the requirements and expectations for which it is responsible 78 Objectiver User Manual Respect IT sa Document Generator 15 4 2 Flat Glossary text The generator creates a text containing a list of each object in the model in alpha betical order along
5. 9 FIGURE 33 Saving an OO Text document 1 Create a new OO Text document or edit an existing one 2 Work on the OO Text document as usual Respect IT sa Objectiver User Manual 49 Editing texts with Open Office 3 Use the OO Text Save function to tell Objectiver you have finished with the edi tion of your OO Text document see Figure 33 You can quit the OO Text editor if you wish 4 Continue working on your model or on other documents 5 When you are happy with your work click the Objectiver Save Button to save all your work on disk in a ob file including the OO Text files you have pre saved at step 3 If you want to discard the changes you have done on a OO Text document just quit the OO Text editor without using the OO Text Save function The OO Text editor will prompt you to confirm that you want to quit without saving your changes If you forget to save your OO Text documents and just use the Objectiver Save function Objectiver will check whether you still have unsaved OO Text sessions If yes Objectiver will prompt you to save them If you discard your changes they will not be saved in the ob file Note In some OS configurations the pop up window inviting you to save or dis card OO Text sessions might not come up on top of the other displayed windows If you are saving an Objectiver model with some open OO Text sessions and have the feeling that the tool is blocked just move o
6. Creating an attribute 1 Click in the Name field Figure 26 2 Specify the attribute Name e g number 3 Press Return to record your changes A new attribute entry appears in the form its default type is String 4 If needed click in the Type field and change the attribute type A combo box ena bles you to select a type Figure 26 You can choose among different predefined types Boolean Date Formula Integer Longstring Path Real and String or the type can be Undefined You can also create your own type by using the attribute type editor see Section 9 6 Note Attributes for Entities are displayed and editable in diagrams 1 Object is a generic name for Agents Entities Events and N Ary Associations Respect IT sa Objectiver User Manual 41 Concept Property Edition Bed Entity Create a new attribute type FIGURE 26 Instance attribute new attribute 9 5 2 Deleting an attribute 1 Right click on the attribute you want to delete 2 From the context menu choose Delete attribute 9 6 Attribute type editor 9 6 1 Displaying the attribute type editor Choose Tools Attribute type Editor to open it Figure 27 or click the but ton at the right of the Type field see Figure 26 Attribu Defined type z Enumeration Enumeration FIGURE 27 Attribute type editor 9 6 2 Creating a new attribute type 1 Click New 2 Object
7. FIGURE 10 List of existing concepts 6 7 2 2 From the list select the concept you want to insert 3 Click Add or double click the selected concept Auto completion mode Another way to select entries from the list is to type the first few characters of what you are looking for Then when you hit the space bar the items displayed in the list are reduced to those that match your entry More precisely you can type any regular expression With regular expressions you can type wildcard characters providing a powerful pattern matching mechanism The most frequently used wildcards are the following ones 9999 matches any character Example ex nsion matches extension expan sion matches zero or more occurrences of the previous character expression Example matches anything matches zero or more occurrences of the previous character expression matches the end of the concept name Example filet does not match filet mignon You can deactivate the special meaning of these wildcards by deselecting the check box Regular expression You can also deselect the check box Search all words in order to only retrieve those entries whose first characters match those typed in the auto completion line 22 Objectiver User Manual Respect IT sa Diagram Edition 6 7 3 6 8 6 9 For instance to retrieve a concept for which you know the first characters proceed as follows
8. is a root text of a hierarchical structure All other references to the shared goal point to this root text If the option is not selected the shared goal is decomposed when the first occurrence of it is met during traversal and the other become goal references pointing to the first occurrences If the Create a section for each diagram option exists Objectiver attempts to match the goal structure it generates against existing diagrams If a perfect match exists the diagram will be reused during the generation Figure 59 shows the goal structure that will be mapped onto the structure of the doc ument to be generated A section in the requirements document will be created for each root text in the goal tree Respect IT sa Objectiver User Manual 83 Requirements Document Generator Pro and Enterprise Edition only Req Doc Generator xj h introduction choose introduction section parameters User req define gos section structure 2 User req choose goal model visist strategy x User req define goal section structure 9 P Optimal welfare for patients and accompanying people EP Efficient medical fofow up EP Quality ot Welcome Q9 U Efficient medical follow up OF Efficient edministrative follow up U No service congestion Adequate medical assistance if Patiect s allocated bed known Efficient administrative follow up ea UG Quick patient identification O P
9. 5 October 2010 Objectiver User Manual Objectiver 3 0 1 0 Introduction 1 1 1 2 Objectiver is a Requirements Engineering tool supporting the GORE KAOS meth odology designed to help analysts identify formalize requirements and write requirements documents Prerequisites The reader should have a basic knowledge of the GORE KAOS approach The intent of this guide is not to introduce the methodology but to show how to build a GORE KAOS specification with the tool Conventions used in this book The following icons are used throughout this manual to highlight new features and changes with respect to previous versions of the tool Aet is used to highlight new features of the tool U is used to highlight features whose description has been modified wit Piated respect to the previous version of this manual 45 is used to highlight limitations of the current release Q is used for hints and advices Respect IT sa Introduction 1 3 1 0 2 0 Table of contents Introduction ss 1 E r Prerequisites esse nl A ee rt ee ROS ENT ee ee UPS YER tie 1 1 2 Conventions used in this book 1 L3 Tableof cont tss si soumise doe LIRE AEA E SE Heed SUD ime ne actis 2 Overview ss nn 6 2 1 Objectiver components Composants Objectiver 6 22 Filefonat l is
10. Operations like Clone Diagram Copy Paste of concepts between diagrams and the Bring related concepts on packages can be used to move the concepts easily Con cepts can also be merged during this step in order to remove duplicates 110 Objectiver User Manual Respect IT sa Control units PART H Appendices Respect IT sa Objectiver User Manual 111 Appendix A Additional information 20 0 Appendix A Additional information 20 1 Memory usage status Starting with Objectiver the memory status bar is shown in blue color in nor mal conditions If it turns orange or red you are under heavy memory usage condi tions Try clicking the garbage icon to collect as much memory as possible then save your specification You should now quit and restart Objectiver to resume your work in better memory conditions 20 2 System Requirements 20 2 1 Required RAM 512 Mbytes is the minimum recommended RAM size for using the Objectiver 1 Gbytes RAM will be more confortable for large requirements models and docu ments Running Objectiver with less memory might cause disk swapping which will result in a drastic loss of performance 20 22 Java VM Configuration UAjaten The default maximum java VM heap size has been set to 512 MB for running Objectiver To change this value proceed as follows 1 Go the directory in which Objectiver is installed typically Program Files Objectiver3 0 2 Edit the Objectiver 14j file with a te
11. The parameter Package allows you to choose the destination package The parameter Single Link allows you to choose if there should be only one link between each dependent diagrams or if there should all links in the generated diagram 15 4 7 Goal diagram dependency diagram The generator creates a diagram of all goal diagram dependencies The diagram contains all the visible goal diagrams in the specification as well as their dependen cies The parameter Document Name allows you to give a name to the new diagram The parameter Package allows you to choose the destination package The parameter Why Must Be Leaf allows you to create a dependency only if the root text concept of a diagram is a leaf in the other diagram 1 Object is a generic name for Agents Entities Events and N Ary Associations Respect IT sa Objectiver User Manual 79 Document Generator 15 5 Updating the generated documents As described in Section 14 2 5 reports that only contain documents already existing in the model remain up to date if documents composing the report are modified However modifications to the model that have an impact on the generated docu ment such a glossary or a responsibility model will not be reflected automatically in those documents it depends actually on the type of the modification In this release obsolete reports cannot be updated incrementally you need to erase and generate the report again 80 Obje
12. 1 Deselect the check box Search all words 2 Enter the first characters of the concept name If input is locked while typing no characters echoed it means that there is no matching concept 3 Press the space bar or the Enter key to restrict the list only to those concepts the name of which begins with the string you have typed 4 Select one of the remaining concepts from the list or if needed keep typing char acters and pressing the space bar to restrict the list further 5 Click OK once you have selected a concept or press Enter if a single concept is found Notes e A concept may not appear twice in the same diagram Inserting a relationship triggers the insertion of the concepts involved in the rela tion Youcan also add concepts to a diagram by using the explorer see Section 7 5 1 e You can also add concepts to a diagram by using the Copy Paste function To copy some concepts from a diagram to another proceed as follows 1 Select in the diagram the concepts to be copied You can select many concepts by clicking and dragging the mouse or by click ing on individual concepts while the Control key is depressed 2 Copy them Ctrl C 3 Paste them Ctrl V in the other diagram You can insert all connected concepts directly to some concept by right clicking on it in the diagram and selecting Add neighborhood in the context menu Layout The Layout graph buttons enable you to apply a new layout to th
13. not be deleted from the model but they can be moved removed from the diagram and linked to other concepts The preceding rules mean that diagrams in control units the user has not locked are completely frozen If the diagram belongs to a control unit the user has locked he she can control the diagram contents but never change a concept referred in the dia gram if this concept belongs to a control unit he she has not locked The following rules are similar to the previous ones They apply on text documents R8 In a text document belonging to a control unit you haven t locked the text and concept references cannot be edited No concept references can be added deleted from the model removed from the diagram or moved R9 In a text document belonging to a control unit you have locked references to concepts defined in any control unit on which you don t have the lock are read only They cannot be deleted from the model but they can be moved or removed from the document Status of Control units As many users can simultaneously work on different control units of a same project it is important for them to understand at any time which parts of the model they con trol which parts of the model are being edited by other users who has a lock and how users are notified about changes made by the other users The explorer uses colors tips and character styles to provide this kind of informa tion regarding the control units R10 The explor
14. 3 If any attribute or relationship is about to be deleted while changing the concept type Objectiver then prompts you to confirm your request before changing the concept type Locating a concept in the Concept Index 1 Choose Edit gt Find a concept A window pops up see Figure 16 2 Enter the first characters of the concept name The list is restricted to the con cepts beginning with the string you have typed 3 Select a concept and press Return Enter concept name pa 37 Package with all concepts Patient Package with all concepts Other concepts Patient s allocated bed known Package with all concepts Other concepts id Patient s location displayed on request Other Diagrams C7 Patient s location displayed on request Package with all concepts Other concepts D Patient s Location Request Package with all concepts Other concepts 7 Patient s waiting time minimised Package with all concepts Other concepts Patient Id Package with all concepts Other concepts FIGURE 16 Locate a concept Respect IT sa Objectiver User Manual 31 Text Edition 8 0 Text Edition 8 1 About Texts Objectiver text documents TXT documents are typically used to record short notes to explain simple diagrams to keep track of interviews or to record other tex tual materials used during a requirements analysis project provided that those tex tual descriptions do not require a sophisticated layout The Ob
15. 5 6 6 6 Creating HyperText Picture and Documentation Links Objectiver allows you to associate any concept of a diagram to a picture an hyper text or a reference to any Objectiver document This can be made in a two step process first you have to create a concept of type HyperTextLink PictureLink or a DocumentReference in the diagram Then you have to connect the hypertext pic ture or document to the concept of the diagram you want to associate to by creat ing a DocumentationL ink relationship Step 1 Creating concepts of type HyperTextLink or PictureLink in diagrams is done in the same way as concept creation refer to Section 6 6 1 In the concept palette select the HypertextLink or PictureLink concepts from under the Other Concepts Palette Section 7 5 1 explains how to add references to an exist ing Objectiver document into a diagram After creation of the HyperTextLink or PictureLink concept click it in order to fill in the address property in the property editor See Section 8 6 to have an example of the different possibilities In the generated web documentation see Section 12 0 these concepts are hyperlinks to the referenced documents The concepts of type HyperTextLink or PictureLink can also be opened from Objectiver by right clicking the concept and selecting Open in external browser in the context menu Step 2 Creating relationships of type DocumentationLink in diagrams is done in the same way as re
16. 69 Report Edition and Publication Open C Documents and Settings ay Desktop My Documents My Computer My Network Places ae Objectiver i sunw QualitylSO TestCases Add Delete Alias folderTest Set File Name doc rtf Files of Type Rich Text Format rtf v Select output file Cancel FIGURE 55 Output file selection P Q Hint Once you have open the generated document in Word save it in a doc format This will significantly reduce the size of the file E d Q Hint Prefer the emf format to the gif format in order to produce light weight documents Limitation in this release 3 0 you can only use the ODT output format to publish your report if your report contains OO Text documents If you need to pro duce an RTF document in such cases just edit the published OO Text document and save it in RTF Reports containing OO Text documents published with the RTF output format do not include the OO Text documents 70 Objectiver User Manual Respect IT sa Report Edition and Publication PART E Generating Requirements Documents Respect IT sa Objectiver User Manual 71 Requirements Documents 14 0 Requirements Documents 14 1 14 2 Once a requirements model has been created a requirements document can be gen erated by Objectiver There re three different ways to derive a requirements docu ment from a mode
17. 7 6 Deleting Mems ue usu Bee ese ake ig DS OR UN are odi ve de Aer SA WES PU 29 7 6 1 Deleting a concept from the model ss 29 7 6 2 Deleting document i e reps ee eee een e ete de pinea dep 30 7 7 Renaming documents and concepts 30 7 8 Modifying the type of a concept 31 7 9 Locating a concept in the Concept Index 31 Text Edition 32 Bul VCADOUET ERIS nos LTD 32 8 2 Basic Operations oe ses ee rome bee Dana eure ie HI Mu Susilo vero ae eed e mee wae ae 32 8 3 Working with character styles 32 8 3 1 Defining a new character style ss 33 8 3 2 Applying a style to a paragraph or to a sequence of characters 33 8 3 3 Defining styles for concept and document references 233 8 4 Creating concepts and adding references to them 34 8 5 Finding missing concept reference 35 8 6 Hypertextand Picture Link 2 552228 eue ert mon eatin ts ead Hobe yo dle Maw awed eb RS 35 Concept Property Edition 39 91 About the Property Editor ssl ee eere ae e ed Ge eed de pe RR E 39 9 2 Displaying the Property Editor 39 9 3 Displaying a c
18. Edit in the context menu 2 You then have the possibility to either retry or cancel the file opening operation or reset the lock if nobody is still editing the project So click Reset the lock if this one results of a crash of Objectiver 3 Click Yes to confirm your choice If a user was editing this file Objectiver warns him her that lock is being seized by somebody else To edit a copy of a locked project file 1 Choose File gt Save Project As A file dialog window pops up and prompts you to enter a filename 2 Right click Concept Index and select Control Unit Edit Respect IT sa Objectiver User Manual 9 Project level Operations 3 4 3 5 3 6 3 7 3 8 You can also reopen a project you recently opened as follows 1 Choose File Reopen 2 Select the project file name you want to open from the list that appears Note With the MS Windows Environment the Objectiver installer associates the ob file extension with Objectiver When double clicking an Ob file Objectiver starts up and loads the project file Saving a project Choose File gt Save Project If the project already exists on file Objectiver converts the model to XML and saves it to the current project file Otherwise a file dialog window pops up and prompts you to enter a filename Backup files When saving your document Objectiver keeps a backup of several previously saved states of the file Backup file names consist of the
19. OO Text document where you want to insert a reference to a concept that you want to create at the same time 2 Type the name of the concept as a string and select the string 3 Right click and select Objectiver Create Concept Agent to create an agent Objectiver Create Concept gt Goal to create a goal and so on A new concept with the name you type is created in the model and a reference to it replaces the string you typed in the OO Text document The new concept is created in the folder of the OO Text document If there is already a concept with the same name in that folder Objectiver pops up an error message Concept already exists Click OK and change the concept name Respect IT sa Objectiver User Manual 53 Editing texts with Open Office a Bus Maan vE g 9 fad default z Times New Roman x 12 x B 7 T 6 27 oid Bee let 4 1 y bo OEE i EM rh aient 14 yay hy tosa i Pagel 1_ Default French France _ INSRT STD amp ma LU til Ail Stakeholder Role in the organisation 1 2 Interview summary 1 2 1 Main facts Goall ho uwecoTme09 G e img 9 Et aw 3 FIGURE 38 The OO Text document with the reference inserted 11 7 Searching for a concept reference in an OO Text document A concept in an OO text document can be located in two ways From the property editor 1 Select the concept in the explorer 2 In the property editor click
20. Objectiver User Manual 15 PART B Basic Modelling functions Respect IT sa Diagram Edition 6 0 Diagram Edition 6 1 About diagrams A diagram is a type of Objectiver document Diagrams are used to represent graphi cally the concepts and the relationships existing between them Diagrams are views on the model composed by the analysts the concept and relationship representa tions appearing in a diagram are indeed references to the concepts and relation ships existing in the model Some diagram operations concern the view only for instance moving a concept from one position to another in a diagram other opera tions impact both the views and the underlying model for instance renaming a con cept This also explains why there are 2 delete operations a first one for removing a con cept reference from a diagram without removing it from the underlying model and another one for removing a concept from the model and consequently from all the diagrams in which it appears see Section 6 10 New concepts can be created in the model and a reference inserted in a diagram using the concept palette References to existing concepts can also be added to any diagram This section details specific operations related to diagram handling 6 2 Basic Operations Refer to Section 4 0 to learn how to create open clone delete or rename a diagram 6 3 Diagram Editor toolbar Figure 8 shows the diagram editor toolbar The toolbar provides
21. When the lists are empty a file dialog window pops up and prompts you to enter a filename A file with the opk extension is created Note When you Right click a package and click Bring Related Concepts the same Wizard pops up to enable you to include or exlude concepts To import a package 1 Right click a package and click Import Package 2 Select the directory where your package file resides 3 Double click the file corresponding to your package Opening a document Section 4 3 explains how to open an existing document by using a dialog box A document can also be opened as follows 1 In the explorer find the document you want to open 2 Double click on it Objectiver opens the document in a new window Adding items The following operations suppose that the document in which you want to insert a concept is currently open 28 Objectiver User Manual Respect IT sa Exploring the model 7 5 1 7 5 2 7 6 7 6 1 Adding a concept or document reference to a diagram 1 Select the diagram window you want to edit 2 In the explorer locate the concept you want to insert 3 For this step you can either Alt click the concept in the explorer Reference to this concept is added in the diagram Or Drag the concept in the explorer and Drop it where you want to add a reference to it in the diagram Or Copy the concept in the explorer by using the context menu or Ctrl C and Paste
22. a reference to it via the context menu or Ctrl V If you select several concepts in the explorer they all will be copied and pasted at the same time in the diagram and finally 4 Move the added concept reference to the position you want If you want to move the reference outside the diagram area shown on screen drag the reference toward the target area to cause the window to scroll in that direction Note When you add a concept reference to a diagram all relationships that connect this concept to other concepts already present in the diagram are shown Adding a concept or document reference to a text document 1 Place the cursor in the text document at the position where you want to add a concept reference 2 In the explorer locate the concept for which you want to insert a reference Select one or several concepts in the explorer 3 You now have the choice between the following options Alt click the concept in the explorer Objectiver then adds a reference to the selected concept in the text document at the cursor position Or Drag the concept in the explorer and Drop it where you want to add the refer ence in the text Or Copy the concept in the explorer by using the context menu or Ctrl C and Paste a reference to it via the context menu or Ctrl V where you want to add the reference in the text Deleting items Deleting a concept from the model In order to delete one or more concept s from the mod
23. be installed and con figured to work with your browser To install the plug in refer to the Adobe web site http www adobe com svg and follow the instructions to download the plug in Adobe SVG Viewer 3 0 About documentation contents The documentation window is divided in several frames see Figure 49 an index of documents grouped by package Clicking on any item will display the corresponding document a concept index grouped by package and a list of concepts by type Clicking on a concept name updates the Concept Specification frame which shows information associated with the concept a concept specification frame where you can get all details about the concept currently selected as well as the list of diagrams and text documents where the concept appears e a graphical frame used to display the Objectiver diagrams Concepts in the dia grams are clickable The result is that the concept details are displayed in the concept specification frame If the concept is a picture link a hypertext link or a reference to an Objectiver document clicking that concept will open the referred document e a text document frame for displaying the Objectiver text documents The refer ences appearing in the text are hyperlinks that change the current text displayed reference to another text change the current diagram displayed reference to diagrams or display concept information in the concept specification frame ref erence to a con
24. control units Each control unit can be locked and unlocked for edition by the user Locking a control unit pro vides the user with the guarantee that nobody else can edit the control unit while he she is modifying it The tool informs the user about the control unit status i e whether the control unit is locked or unlocked who is locking a control unit and when a control unit is locked and unlocked The next sections are structured as follows e Section 19 1 defines control units and explains how they are managed by the tool e Section 19 2 and Section 19 3 explain how to define and use control units in Objectiver e Section 19 4 provides hints about how to use control units on large projects Overview Definition Section 7 3 has shown how to decompose an Objectiver model into packages Pack ages are containers for model concepts That enables the analysts to put related con cepts at the same location in the model This conceptual proximity of concepts in a same package means also that the analysts often need to edit several concepts at a time in the same package Therefore the package appears also to be the best level at which a group of concepts must be locked by one user for edition so that all the other users are prevented from editing the same concepts at the same time Control units in Objectiver are a particular case of packages they are contain ers that can be locked by a user to edit alone the concepts contained in
25. disabled it means that you haven t locked it See Section 19 3 3 for how to do it 2 ocu files are not deleted by Objectiver It is up to you to delete ocu files which are no longer in use Locking a control unit for edition Locking a control unit for edition means that you acquire a lock on the control unit The lock guarantees that nobody else can change the contents of the control unit To edit a control unit Right click the control unit and select the Control unit Edit entry Make sure the control unit you want to edit is free that is with a Green Dim status Objectiver changes the status of the control unit to Green Plain If other users are editing the same project as you Objectiver notifies then about the fact that another user you has started editing the control unit by changing the status of the control unit in their environment the status changes from Green Dim to Orange Dim You can also learn who is locking a control unit by looking at the tip appearing when you put the mouse on the control unit entry in the explorer The tip has the Respect IT sa Objectiver User Manual 105 Control units 19 3 4 19 3 5 following shape Control Unit Control unit name in Package or control Unit name gt edited by user Once you have locked a control unit you can change its contents see Section 19 3 6 When you have finished the edition session you can do one of the fol
26. doc 3 Edit MyReqsDoc doc and go to the location at which the generated requirements document should appear Respect IT sa Objectiver User Manual 87 Requirements Document Generator Pro and Enterprise Edition only Macros ME TT Macro name Cancel Step Into Edit Create I Delete Organizer Macros in Ja active templates and documents Description enregistr e le 05 09 02 par ROUSSEL Jean luc FIGURE 63 Macros 16 4 4 4 Select the Word function Insert Text File and specify RD content rtf as the file to be inserted Inserting Objectiver diagrams manually in a Word document You should have the Adobe SVGViewer plugin Version 3 0 installed Publish the Web based documentation see Section 12 2 Then there are two possibilities By opening the Web documentation 1 Open the Web documentation see Section 12 3 and look for the diagram to insert in Word Right click in the SVG diagram and select Copy SVG 2 In Word choose Edit gt Paste special 3 Select Paste and Bitmap Note To get a snapshot of the diagram on a white background right click on the link to the diagram in the document index and select Open In New Window Then proceed as described above By using Windows Explorer Simply drag the SVG file you want to insert from Windows Explorer to your open Word document Objectiver User Manual Respect IT sa Requirements Document Gen
27. eer Per P Bean toa ie Mea a ee a en R are eine 6 PART A Working with Objectiver 8 3 0 4 0 5 0 Project level Operations 9 31 About projects Sere Rp SV Sie Sia ea Baha Reste a ees Ve SA RR ERR Nes 9 32 Creating anew project 2444444 edad dink Pa endo d Co ee PN EE ES Fr RET 9 3 3 Openinig an existing project srir iue OR LEV de ete Res ee Sea eee Ea 9 3 4 Saving a project oe ete eerie ERE tre eee ane deen cae deditque eae Dt Se DA Spee 10 3 5 Saving a project under a different file name 10 3 6 Working with shortc ts s tue mine l ment net wee hae tee pees 10 3 57 Closinga project iucielrepebee oe bees PEDIS OPISESD nl tale es 10 3 8 Renamimngaptoject x x 9 e REDIERE VR VES HOS RSS RV es REE See ES 10 39 Exitng ODJectiver ioni e eoe ea rt Pd eed perdes 11 Document level Operations 12 41 About document art iis ete wet one ep ern etu e bos Goede ew AR a ds 12 4 2 cCreating a docum nt ies so suture APO RE Eget EN Peck pea ers dad 12 437 Opening a documento sales se RU p Rene RR sn a TERN 13 44 Savng document osea ve phe Sale Secs Sieg eU RSS a Ub CHE 14 45 Cloning documents ex px Dey e rire ans nee BASE AN E ol dede ge 14 46 Deletinga document caches entree DC Ree HERMES ES MODE CEREREM e eS 14 47 Renammgadocument i sack aes ens Rr RITE Re
28. enter 22 6 7 3 INOleSssad aveo ti i PEOR ERE REVERSE YER ESPERE SIEUT DRE nre its 23 6 8 Layouts so Grodan tess thay ania nat Peo ee eae OPUS ERU Ne NE TR 23 6 9 Copy a diagram to the clipboard 23 6 10 Deleting and removing items 24 6 10 1 Deleting a diagram x eisdem he eter ien ede e re ee ee ger deep 24 6 10 2 Removing concepts from a diagram seine 24 6 10 3 Deleting concepts and relationships from the model ss 24 6 11 Set Preferences for the Diagram Editor 24 Exploring the model 26 7 1 e About the explorer eee nb Sys Bich oe See IRE HERE Seed RUE dr Mert 26 72 The explorer Contents oi errero c dew ey na OPERA Xie ONE EIU NER E wha obs 26 Objectiver User Manual Respect IT sa Introduction 8 0 9 0 10 0 4 3 PACKAGES vuol ete tea fte st be dut bem sce t bot oen e 26 7 3 1 About packages tee ete ee rete eei E de ie Rene 26 7 3 2 Import Export package Professional and Enterprise Edition only 27 TA Openumgadocument i an er ERE Hee aE RR ED ERE ER ERO NS HER E REESE ES 28 ES Addu gidtems eire a Ene RE ER eH ERR MODOUP RR TUE DLEN S De Ra PA 28 7 5 1 Adding a concept or document reference to a diagram 29 7 5 2 Adding a concept or document reference to a text document 29
29. folders containing the web doc Objectiver automatically creates a copy of the file to make the distribution easier 2 The table below shows how documents are referenced inside generated docu ments TABLE 4 Hypertext links inside generated documents Objectiver document Web doc see Section 12 0 RTF PDF doc see Section 13 0 URL Hyperlink inserted in the page It points to Hyperlink inserted in the doc It points to the the URL URL 36 Objectiver User Manual Respect IT sa Text Edition TABLE 4 Hypertext links inside generated documents Objectiver document Web doc see Section 12 0 RTF PDF doc see Section 13 0 Absolute path Hyperlink inserted in the page It points to Hyperlink inserted in the doc It points to the the file referred by the absolute path file referred by the absolute path Relative path with the Objectiver file Hyperlink inserted in the page The address is relative to the folder in the generated web doc Hyperlink inserted in the doc The address is relative to the report file the tool does not copy the referred file When relative paths are used it is up to the user to structure his her workspace so that the hypertext links point to the right files The following structure makes the relative paths always valid the model the reports and the WebDoc are put in sepa rate directories all belonging to the same
30. in the model and all references to it as well Converting a TXT document into an OO Text document You can upgrade a TXT document into an OO Text document by using the Convert to OO Text function Respect IT sa 57 Editing texts with Open Office 1 Select the TXT document you want to convert in the explorer 2 Right click the entry and select Convert to OO Text in the explorer see Figure 44 1 Source Documents Interview Stakeholder 1 amp Goal e Be Reports FIGURE 44 Converting a TXT document into an OO text document File Edit View Insert Format Table Tools Window Help interview Stakeholder 1 517 68 U Baa SE amp kel mes E foime e Lara js Es u 8 El Goal Main goals Pe Hu UON 2 MASS KA Aa YO apne g Goal i x Goal Refinement Goal2 g Goal2 we Goal2 Refinement Goals 1 interview S k h Id r 2 amp Goald 7 od Goal3 Refinement Goal g Goal4 g Goals Goal Re of 1 1 Context of the interview 4 Goal8 z H 3 Reports j E Location d Date Stakeholder Role in the organisation 1 1 1 Main facts G E a D 1 1 2 Other facts FIGURE 45 Result of the conversion to OO Text 58 Objectiver User Manual Respect IT sa Editing texts with Open Office 11 11 Converting an OO Text document into a TXT document You
31. its own separate editor may be necessary when you need to access functions such as the style bar that are not available in the report editor When creating new reports manually we recommend to first create a new package then create your report in that package By default all new documents created within the report editor shall appear in this package You can insert any document from any package in your model To for instance insert a title a list of contributors or a reference list you can create a document right from the report tool As indicated above these shall appear as doc uments in the package where the report resides We also recommend that you do not number the section titles manually You should use the predefined styles of the text editor instead e g Obj Title1 These styles can later be mapped to styles of the target word processor once the report is exported See Section 16 4 1 for how to apply a Word template NOTE All references appearing in documents and reports are kept synchronized with the model content which means that if you modify the name of a goal for instance all texts diagrams and reports making references to that goal shall auto matically be updated for you Template based report generation 72 Objectiver User Manual Respect IT sa For long requirements documents a custom report generation as described in Section 14 1 can quickly become cumbersome even if you needn t create more tha
32. ments Displayed patient s location read and Patient s location displayed on Model View E request IB Models Sj 1 Goal Model Levels 1 and 2 are predefined which means they are always present what Le ever the model Level 3 lists the actual concepts in your model ae The package View Packages are concept containers They are hierarchically Goal structured Section 7 3 details the notion of packages and how to defined them FRO Refinement The explorer see Figure 12 displays the package hierarchy and the concept RS instances present in each package It is similar to the file system of your operat i Refinement ing system where packages stand for directories Several filter buttons located in GRequirement the upper left part of the explorer enable you to show or hide the concepts G7 Displayed patient s loce according to the model category you are interested in Note if a concept is rele v REDE vant to several model categories it will be hidden only if all the corresponding Resolution 7 SoftGoal filters are activated 2 Object Model 3 Agent Responsibility Model You can switch between views by clicking the tabs in the upper part of the explorer 4 Operation Model 5 Other Concepts Pe 7 3 Packages D N 3 1 About packages Kaos includes the notion of package that gives an extra level of flexibility in struc turing the content of an Objectiver project Packa
33. ob file the tool reconciles in memory the ob file with all the ocu file Notes 1 ocu files are intended to be used with the same original ob file from which they come ocu files may not be shared between different projects 2 The ob file is split into several pieces so that Objectiver can manage concurrent accesses to each piece by using a locking mechanism on the files General rules Access rights are defined on the control units to restrict modifications to one single user at a time namely the one who has locked the control unit R1 A user can change the contents of a control unit only if he she has locked it Only one user at a time can lock a control unit If control units limit writing accesses to concepts they do not introduce any limita tion on reading accesses to them Respect IT sa Objectiver User Manual 101 Control units R2 All concepts packages control units and documents in a project are always visible to any user having opened the project whatever the loca tion of those items is in packages or in locked unlocked control units To manage concurrent accesses to the global project as for a single control unit the root text of the package hierarchy behaves like a control unit R3 In any project the root text of the package hierarchy namely Concept Index behaves like a control unit Control units can also contain packages but cannot contain other control units We need therefore to
34. project name followed by a backup identification number followed by the ob bak file exten sion This allows you to retrieve an older version of your project file Objectiver manages backup files as follows the last ten saved versions identified by a number file XX ob bak e g file 45 ob bak are kept older backup files are erased except one backup file for each day of the last week and one backup file per preceding week daily and weekly backup file names are identified by a date file 2003 12 15 ob bak for instance Saving a project under a different file name Choose File gt Save Project As Working with shortcuts You can create shortcuts to files or folders you frequently edit Shortcuts can be cre ated when you invoke the File manager dialogue from the Open Project or Save Project As menu Proceed as follows 1 Choose File gt Open Project or File gt Save Project As 2 Select the file or folder for which you want to create a shortcut 3 Click Add in the Shortcuts panel A shortcut is added to the shortcuts list You can give alias names to long shortcuts by entering a string in the alias field and by clicking Set You can also assign a color to specific entries by preceding the alias name with the color name followed by the pound character e g red QualityISO Closing a project Choose File Close Project Renaming a project 1 Make sure the project is not being edited with Objective
35. specify how a lock put on a control unit propagates to the pack ages defined inside it R4 Locking a control unit A locks all the packages included in A Sub pack ages and the concepts they contain are also locked in a recursive way For instance consider the following project structure Figure 69 Package View Model View z Concept Index Properties R pome FIGURE 69 Packages and control units Entries with a blue box icons A A2 B1 and B2 stand for packages Entries with a green box icons Control Index A1 and B stand for control units Locking the Concept Index also locks package A and package A2 Control units A1 B and package B1 B2 are not locked They can be locked by any other user The next rules explains how control units impact information display in documents R5 In any diagram all the concept references belonging to a control unit you haven t locked are dimmed and read only All the concept references belonging to a control unit you have locked are displayed in plain text R6 In a diagram belonging to a control unit not locked by you no concept ref erences can be added deleted from the model removed from the diagram or moved 102 Objectiver User Manual Respect IT sa Control units 19 2 R7 In a diagram belonging to a control unit you have locked references to concepts defined in any control unit on which you don t have the lock can
36. template window displayed in Figure 61 pops up 3 Proceed as above to specify the template you want to use 16 4 2 Word macros The word templates provided contain Word macros that might be useful to post process your generated requirements documents To use those macros check first that macro execution is enabled in your Word program refer to the Word documen tation to learn how to turn on this functionality 1 Choose Tools gt Macro gt Macros to activate the Macros frame Figure 63 shows a screenshot of this 2 Select the Macro you want to execute for instance e BuiltTable to build requirements and expectations table InsertTOC to insert a table of contents at the cursor location 3 Click Run 86 Objectiver User Manual Respect IT sa Requirements Document Generator Pro and Enterprise Edition only taj GenReqDocModified rtf Microsoft Word Eile Edit view Insert Format Tools Table Window Help D susak mne eam 0 don 1 1 Glossary type free text for document P E12 Description g n rale El1 2 Needs Inventory B 1 Optimal Welfare for B 2 Efficient medical fol B 3 Quality of welcome B 4 Patient s allocated E B 5 Medical secrecy pro O3 Annexes 1 3 Table of requirements 1 4 Statistical report for e 1 Introduction Table of Content E TOO eoe up EIER URS NEI OEE SRMIRESMIEERNE OUR OS 1 1 Glossary 2 Description g n rale 24 Ne
37. the difference between a goal and a requirement e at the model level e g what is the meaning of a specific goal A user manual dedicated to reviewers comes with the Objectiver Reviewer Edition This manual specifies how to use the tool for reviews and provides a short defini tion of the types of concepts that can appear in an Objectiver model Model structure This section is important as an Objectiver model is a network of concepts and reviewers might need some guidance to start the review This section therefore should explain how the model is structured and should propose a traversal order for it Typically it consists of a table of contents listing the documents to review 96 Objectiver User Manual Respect IT sa Review process Review activities This section describes what is expected from the reviewer for instance review the source documents e g interview summaries in order to validate how they have been parsed and linked to the model traceability links review goal diagrams to validate correctness and completeness of the description are the goal refinements complete and correct etc review responsibility diagrams to check completeness and agreement on what is assigned to each agent review definitions of the object model Annotation style Types of reviewer annotations can be typically classified into three categories opinion e g disagreement about a requirement about a note
38. the explorer see Section 7 6 2 Renaming a document Use the property editor or the explorer to rename a document refer to Section 7 7 to perform this operation 14 Objectiver User Manual Respect IT sa Help 5 0 Help 5 1 Displaying the Help window Choose Help gt Help or press F1 Objectiver opens the Help window If you press F1 while an editor has the focus the help window displays the documentation corre sponding to this editor 5 2 Using the context help To get help for a menu item you need to first click Help on item in the help menu then open the menu that contains the item of interest using the keyboard accelerator sequence e g Alt f for the File menu Finally use your mouse and click the item to get the help for it Note if you attempt to open the menu using the mouse the help window shall be displayed for it instead 5 3 Senda problem description or a suggestion to support Choose Help Problem or Suggestion Figure 7 shows a screenshot of the Send To Support frame If you use a Proxy server you will have to fill in the connection preferences see Figure 23 i x Please fill in a short description of the problem and how to reproduce it The provided information will be sent to our support team Name vanbrabant Company cediti How to reproduce the problem Connection Cancel FIGURE 7 Send to support Respect IT sa
39. the requirements document wizard see Section 14 3 14 2 2 Creating a diagram report You can create a report for a diagram that shall contain all related documentation As an option to the diagram report a glossary of all the concepts appearing in the diagram can be requested The concepts are presented in an alphabetical order and for each of them their definition attribute is included To create a diagram report proceed as follows 1 Right click on a diagram in the Explorer 2 Select Generate Diagram Report and if you need the glossary select the with glossary option in the submenu Objectiver creates a report named according to the diagram name followed by Explanation The generated report contains the following four documents the title which is the diagram name the diagram itself an explanation text optionally the glossary section If the diagram has got an explanation text already see Section 14 2 1 it appears within the report Otherwise the explanation text document is created for you and appears empty in the report The glossary is stored in a text document named after the diagram name with a Generated glossary suffix 14 2 3 Creating package report Professional and Enterprise Edition only You can create a package report that shall contain all diagrams and related docu mentation that exist in a package An option lets you include all the diagrams exist ing under any of the sub p
40. two or more goals These 2 rules are not exclusive Respect IT sa Objectiver User Manual 81 FIGURE 57 The first window of the Wizard Respect IT sa 82 Requirements Document Generator Pro and Enterprise Edition only Req Doc Generator H xj fi introduction choose introduction section parameters 2 User req choose goal model visist strategy B User req define goal section structure Use defaut structure Propose new structure v Create a section for each diagram Create section for each shared goal lt lt back nex gt gt FIGURE 58 The second window of the Wizard 16 2 4 The third window of the Wizard define the goal section structure The wizard follows the following rules for deciding how to structure your require ments document 1 The structure results from visiting the goal graph from top to bottom and from left to right this is a pre order traversal strategy The goal graph is converted into a set of hierarchical structures including refer ences to goals instead of duplicated goals that is each goal or requirement will be defined once in one place in the reqs doc but it can be referred to from many other places in the requirements document Each root text of a hierarchical structure will lead to a subsection of the User Requirements Section If the Create a section for each shared goal option is selected each shared goal
41. us NN MO t B default Times New Roman 12 B xu amp 2 Go ER iy tei pag Le von b a e egei g 1 Goal3 Goal Goals amp Goals T 4g Goal A S Stoel 1 1 Interview Stakeholder 1 SR Obstacle E Er 1 1 Context of the interview amp Requirement x amp Resolution m Location 47 SoftGoal 5 Date Stakeholder Role in the organisation Boob 9 Ses hk U D 00D B Q 80 Be Documents 1 2 Interview summa containing a Reference Vestam references x elaine CEN NA 1 2 1 Main facts zm TRUE Goa Documents si e Document 2 Eum surement m a Main goals NI Dh 7weTeo09 O o iu 99 ag FIGURE 39 Inserting a concept reference into an OO Text document 11 8 11 9 Locating a concept from an OO Text document You can locate a concept in the Objectiver model from any reference to it in an OO Text document 1 In the OO Text document right click the concept reference you want to locate in the model 2 Select Objectiver gt Locate concept in the popup menu see Objectiver locates the concept in the explorer and in the property editor Note Be sure to set unset the explorer filters correctly in order to allow the tool localize concepts See Section 7 2 for more details on the explorer filters Note Do not confuse location with search Location aims at locating in the model a concept for which you provide a refere
42. verify that all the objects you want to be listed in the glossary have got a definition When generating the requirements document an option allows you to include in the glossary the only objects that have got a definition Proceed as follows to provide a definition to objects 1 Activate the query tool see Section 10 0 2 Select and execute the query Find concepts without Def after having specified Object for the meta concept name parameter 3 Enable edition of the result set by clicking the Refresh results and enable edition button 4 Edit the Definition attributes for all the objects you want to have included to the glossary Use the Find button to retrieve the context in which the object has been defined see Section 10 1 3 for details Defining the User Requirements section When the requirements document is generated each generated subsection of the User Requirements section is composed of a diagram and its explanation text Depending on the model walking strategy selected during the requirements docu ment generation see Section 16 2 3 the included diagrams are either pre existing or generated on the fly Proceed as explained in Section 14 2 1 to document existing diagrams prior to the generation Defining the System Requirements section The system requirements section is generated as explained in Section 15 4 1 Applying the wizard Section 16 0 details the steps that you ll have to walk through with the wizard
43. with its informal definition see Table 5 Predefined concept properties The parameter Glossary Name allows you to give a name to the new text docu ment The parameter Package allows you to choose the destination package 15 4 3 Goal model diagram The generator creates a diagram containing all the goals and refinements of the model The parameter Diagram Name allows you to give a name to the new diagram The parameter Package allows you to choose the destination package 15 4 4 Issue text list The generator creates a text containing a list of each concept in the model in alpha betical order with a non empty issue property value along with its issue see Table 5 Predefined concept properties The parameter Issues Document Name allows you to give a name to the new text document The parameter Package allows you to choose the destination package 15 4 5 Whole specification report A report is generated that consists of all the diagrams followed by all the texts ordered by name in the model The parameter Report Name prompts you to give a name to the report The parameter Package allows you to choose the destination package 15 4 6 Diagram Document dependency diagram The generator creates a diagram of all diagram document dependencies The dia gram contains all the visible diagrams documents in the specification as well as their dependencies The parameter Document Name allows you to give a name to the new diagram
44. your OO Text document and click Save Objectiver then copies your OO Text document into a new OO Text file named according to your input 50 Objectiver User Manual Respect IT sa Editing texts with Open Office FIGURE 34 Importing an OO Text document Concept Index 9 Gg 1 Source Documents B CHEN FIGURE 35 Exporting an OO Text document Note The export function does not remove the OO Text document from your model 11 5 Inserting a reference into an OO Text document You can insert a reference to an existing concept of your model into an OO Text document quite easily 1 Put the cursor to the location in the OO Text document where you want to insert a reference 2 Right click and select Objectiver gt Insert Concept Reference see Figure 36 3 A dialog Select a concept pops up Select the concept you want to insert in the list and click Add Alternatively to locate a concept quicker in a large list type the name of the concept in the input field or use the auto completion mode by Respect IT sa Objectiver User Manual 51 Editing texts with Open Office es oyectiver nsert Concept Reference File Edit View Insert Format Table Default Formatting Locate Concept in model PE DN Bo amp 9 X zs Rename Concept o o sir bi Create Concept i default x Times 5 4 c i iz TA Size Search Concept in document i eo E
45. 3 Objectiver does not save the control units on which the user does not own the lock 4 The operation does not impact locks all users keep all the locks they have Respect IT sa Objectiver User Manual 107 Control units 19 3 9 19 3 10 19 4 Note The File gt Save Project command is enabled only if the user has locked the Concept Index that allows the tool to write the ob file Saving a project in another file The File gt Save Project As command provides the user with the opportunity of creating a completely new copy of the project When Objectiver writes the copy of the project all the control units are converted into packages in the copy This feature provides the user with a quick way to remove all control units from a project Ending a session There are many ways for ending a project session in Objectiver by invoking File gt Quit by invoking File gt Close project by invoking File gt Open or File Reopen by invoking File gt New project All those operations ask the user to confirm the command if changes to the project have not been saved If you decide to save those changes the tool invokes the File gt Save project com mand see Section 19 3 8 In both cases the tool arrives up to a point where it has to quit If the user has locks on control units those locks are released and the other users are notified as follows 1 If you have a control unit with the Orange Dim status and if t
46. 7 1 About the explorer An explorer allows you to browse the model You can browse the model through the package structure package view or you can browse the model according to the con cept types model view You can locate a concept in the package structure from the diagram or text editor or Show Hide concepts by providing its name of this model CES EE 7 2 The explorer Contents log Concept Index The explorer contains a tree view of all the elements a project is made of Gg Other Diagrams There are two different views Optimal welfare for patient Patient s location displayed The Model View is a hierarchical concept index providing Q Sg Package with all concepts Sj Etticiert administrative on the Ist level the following 5 model categories BL 1 Efficient sinas 1 Goal model Ly Efficient administrativ amp Patient records easily 2 Object model amp Quick patient identifica 3 Agent Responsibility model e Sg other concepts 4 0 del Gg Tets A peration mode 5 Other concepts CZ D on the 2nd level the list of concept types present in the category For instance Figure 13 shows that the concept types relevant to the Goal model category are Conflict DomProp Expectation Goal O Refinement etc FIGURE 12 Package View on the 3rd level the list of concept instances present in the model For instance Figure 13 shows that the current model contains only two require
47. G viewer Zooming in and out To zoom in Hold down the Ctrl key the cursor changes to a zoom in symbol and click on the diagram To zoom in on a defined region 1 Hold down the Ctrl key and drag the mouse to draw a selection rectangle around a defined region 2 Release the mouse button and the Ctrl key Note To restore the diagram to its original size select Original View To zoom out Select Zoom out from the context menu Finding the diagrams in which a concept appears 1 Select the concept name in the index of concepts frame 2 Go to the concept specification frame and select the Referencing diagrams radio button You can see the list of all diagrams where the concept appears The referencing diagrams radio button is not displayed if the concept does not appear in any diagram Finding the text documents in which a concept is referenced 1 Select the concept name in the index of concepts frame 2 Go to the concept specification frame and select the Referencing texts radio but ton You can see the list of all text documents where the concept appears and the position where the concept appears within them The referencing texts radio button is not displayed if the concept does not appear in any text document Locating a concept in an index 1 Click on Concept index or Concepts by type 2 Press Ctrl F or use another shortcut depending on your browser 3 Type the concept name or a part of it The
48. Handling notes To be sure to have taken into account all notes you can for example 1 When a note has been reviewed change the state of this one in the property edi tor from Pending to Reviewed And possibly remove it from the diagram 2 Checking all notes have been reviewed The query Search notes to review see Section 10 0 displays all pend ing notes Right click a reviewer in the explorer in the Reviewers package and click Get notes to display all notes submitted by that reviewer 98 Objectiver User Manual Respect IT sa Reviewing operations PART G Team working with Objectiver tEnterprise Edition only Respect IT sa Objectiver User Manual 99 Control units 19 0 Control units 19 1 19 1 1 19 1 2 In large organizations the requirements engineering phase has to be performed by several analysts working in team The duration of the requirements engineering phase can indeed be significantly reduced if several analysts collect the information in parallel interviews system observa tion reading documents e if they can feed the Objectiver model concurrently with the information collected if the effort for merging the contribution of each analyst by removing potential duplicates is not too high The teamwork features of Objectiver have been designed with these goals in mind The main points are the following ones An Objectiver model can be decomposed into
49. IT sa Control units 19 3 2 19 3 3 2 Select Control unit Transform into control unit in the pop up menu Objectiver opens the file manager dialogue window to prompt you to enter a name for the control unit 3 Select a location for the control unit and type its name Click OK Objectiver then creates a ocu file and transfers the contents of the control unit from the ob file to the ocu file The status of the container changes from Blue Plain to Green Plain Notes 1 A good practice consists in putting all control units in a directory defined at the same level as the ob file 2 To convert a package into a control unit you need to have locked the Concept Index See Section 19 3 3 for how to acquire it the package to transform cannot be inside another control unit the project must already be saved If one of these conditions is not valid the Control unit Transform into control unit entry will be disabled Converting a control unit back to a package Control units can be converted back into packages 1 Right click the package you want to convert into a control unit 2 Select Control unit Transform into package in the pop up menu Objectiver then merges in memory the contents of the ocu file associated to the control unit with the contents of ob file Notes 1 To convert a control unit into a package you need to have locked the Concept Index If the Control unit 2 Transform into package entry is
50. Main facts Goal2 E Hew concept FIGURE 47 Result of the conversion into TXT with the loss of style information Respect IT sa Objectiver User Manual 59 Editing texts with Open Office PART D Reporting functions 60 Objectiver User Manual Respect IT sa Web based Documentation 12 0 Web based Documentation 12 1 About Web based documentation Objectiver makes it possible to publish documentation in a Web compatible format This Web formatted documentation includes all the information contained in the project It can be distributed and is easy to navigate by using a standard web browser The next sections explain how Web formatted documentation can be published and how it can be browsed through 12 2 Publishing documentation 1 Choose File Publish HTML Figure 48 shows the available options x Output folder Ic Kaos grailtemp Sd Title _ Set title initial documents J Initial diagram 2m Initial text Limit diagram scaling to 200 96 normal size 1 Delete previous publication in output folder vi Open in browser after publication Cancel FIGURE 48 Documentation generation options 2 To change the default Output folder click on the button A file dialog box called Select output folder appears 1 In version 3 0 the following browsers fully support the rendering of the web documenta tion in pa
51. RR eee E Pre DRE 101 19 2 Status of Controkunits sss ere nus pe tede detegere pe Me ced deba o dete asp ie 103 19 3 Operating control Units 5 eese kr sented PERROS Ree Re Coke aes ga darte le s 104 193 1 CLEANS Control WIE oeste eie ee ee eec e urged nest rte 104 19 3 2 Converting a control unit back to a package 105 19 3 3 Locking a control unit for edition ss 105 19 3 4 Committing a control unit iii 106 19 3 5 Refreshing control units recentiore tnde daa eee th e saita oes 106 19 3 6 Editing the contents of control units ss 107 19 3 7 Opening PIO CCE iicet aie e iret hee en iE a Que vey Eee AES ERO FERRARI 107 VIA Duae 107 19 3 9 Saving a project in another file ss 108 19 3 10 Ending a session esce seis arn ROT PR i ee E EEEa 108 19 5 How to use control units 108 PART H Appendices c so ses So s Ets Haute n ee ew ace eos TETTE 20 0 Appendix A Additional information 112 20 1 Memory usage Status os eue ging e red Saco gp made ec Te e n lo ae te i n ae UN eg e 112 202 System Requirements esse Aa eee ea ele Rx eun Eee RU PE EE OPES 112 20 2 1 Required RAM sr ennemie e ESO XA e Ne ORCA aan RAAB ALE 112 202 2 Java VM Configuration eee ec nien eh en ee HR ER e eene a enn ep 112 20 2 3 SVG plugin ies e ERR REPRE REPRE ESI RH Fere rea etes 112 20 3 Bug Repottz oo ere valet ee CIS Reti OE d
52. Selecting the concept to look for inside the do cument 56 Objectiver User Manual Respect IT sa m Ed sn ins File Edit View Insert Format Table Tools Window Help default 4 e x a Buo Meare sE v9 ea 2 bd v Times New Roman ee ee ce Pa Saree ae 2 He O Sa Hell 5 E ee ME is f FIGURE 42 Navigating from an occurrence to another File Edit View Tools Document Views Help a6 a pxu ald 1 Concept Index e 1 Source Documents interview Stakeholder 9 GB 2 Requirements Model a Goal Main goals g Goal Goall Refinement Goal2 Goal2 Goal Refinement Goal g Goal Goal3 Refinement Goa Goals Goals g Goab Goal y Goal G3 Reports hy Bas B aag E xop S B e en F lefault x Times New Roman xi 2 x B 1 U E afi ir 8g 1975 1582119 4 Insert Concept Reference Default Formatting Rename Concept A Eont Create Concept A Size l Search Concept in document Style D Alignment FIGURE 43 11 10 Locating a concept in the model 3 The tool activates the Objectiver rename dialog Provide a new name for the concept and click OK The concept is renamed
53. UN 15 Style BE RECO 11 3 09 F oca 101 Alignment m Date Line Spacing gt Stakeho B Character A Role in EN Paragraph I Page vi 4 2 l I 8 Numbering Bullets a a E Case Characters X or usd 2 1 Edit Paragraph Style al e Paste ik m Tee 7l rx 9 u Pagel 1 J Default French France LINSRT STD QLI FIGURE 36 Inserting a concept reference typing only the first characters of the concept name followed by a space charac ter see Figure 37 52 Objectiver User Manual Respect IT sa Editing texts with Open Office t Bos aasevg dr fad default e Times New Roman E Location Date Stakeholder Role in the organisation zzz Goal4 2 Requirements Model 7 Goal5 2 Requirements Model 7 Goal 2 Requirements Model 47 Goal7 2 Requirements Model 1 2 Interview s 1 2 1 Main facts FIGURE 37 11 6 Selecting the concept you want to refer to Observe how Objectiver inserts a reference in the OO Text document see In the Property editor for the concept observe that the OO Text document is now listed as one of the document that contains a reference to the concept Creating a new concept from an OO Text document You can create a new concept in the model directly from an OO Text document as follows 1 Put the cursor to the location in the
54. access to the fol lowing functions adding a reference to an existing concept e removing the selected concept references from this diagram applying an automatic layout algorithm to your diagram 3 Vm owe Fit A to Zoom put window Zoom in Add an existing Apply layout to the graph concept Remove selected items from diagram FIGURE 8 Diagram Editor toolbar 6 4 About the concept palette There are five main types of modelling activities in Objectiver the goal modelling the obstacle analysis the object modelling the agent modelling and the operation Respect IT sa Objectiver User Manual 17 Diagram Edition e Change the type of activity At Concepts De O08 IO 6 5 j Undefined Relationship Binary fl Relationships And Or Rela tionships He to te d FIGURE 9 Concept Palette 6 6 6 6 1 modelling Concept icons are grouped by activity in the Concept palette On top of the concept palette there are seven toggle buttons to choose the modelling activity The sixth one provides access to additional notations that are not specifically related to the methodology for instance notes and the last one enables you to attach review notes to some concepts Figure 9 shows the obstacle analysis palette Note about the palette orientation You can control the palette orientation hori zontal or vertical from the Preferences menu To change the palette orientation proceed as
55. ackages Objectiver User Manual Respect IT sa Requirements Documents 14 2 4 14 2 5 Proceed as follows to create a package report 1 Right click in the Explorer a package name 2 Select Generate Package Report The package report includes the following documents the report title which is the package name alist of diagram reports for the package itself alist of diagram reports for all sub packages e a glossary Each diagram report is the result of applying the Generate Diagram Report func tion described in Section 14 2 2 without glossary The package reports for subpackages are generated by applying the Generate pack age report recursively The glossary consists of all the concepts appearing in the diagrams of the package The concepts appearing in sub packages will be incorporated in the glossary of the sub package reports Generating specific sections of the requirements documentation Objectiver includes a document generator that can produce pieces of information ready for insertion into a requirements document For instance the document gener ator allows you to produce the responsibility diagrams one for each agent in your model Those diagrams can be included in your requirements document as explained in Section 14 1 You can also generate a flat glossary of all the concepts in the Object model Section 15 0 explains how to use the document generator Updating generated reports and document
56. amp Check Tool 10 1 1 About the query amp Check Tool The tool provides a series of predefined queries you can run on your model 10 1 2 Opening the Query amp Check window Choose Tools gt Query amp Check A screenshot of the Query amp Check window is shown in Figure 29 Query Find Concepts By Name and Type Description For example to find all goals beginning by System type Goal as Meta Concept Name and System as Concept Name Parameters Concept Name The name of the type of concept to search for r m Li NI DLL CT Parameters Meta Concept Name Goal Concept Name Patient Query Close FIGURE 29 Query Editor 10 1 3 How to perform queries 1 Opening the Query amp Check window Choose a query in the combo box 2 3 If needed give a value to the parameters 4 Click Query Objectiver returns the result set associated with your query in the Result set field The number of results is displayed in the query status bar see Figure 30 Notes 1 Click on a column header to sort the result set 2 If you want to save the results copy and paste it in a document text document in Objectiver or Excel sheet for example 3 Two wildcards can be used matches any character and matches any chain of characters 44 Objectiver User Manual Respect IT sa Analysing the model and solving modeling issues Pro amp Enterprise Edition 4 Cl
57. an drag the mouse in its direction The window will automatically scroll until you find the destination concept and release the mouse button on it If you select the undefined relationship in the Concept palette and drag the mouse from a concept to another one the model will be queried to determine which rela tionship s can be created between the concepts If more than one relationship can be selected a pop up window prompts the user to select one of them If there is no relationship available or if the user cancels the selection in the pop up window the tool proposes him her to create a relationship in the other direction if it is possible If only one relationship is possible this one is automatically created Changing relationship arguments To change a relationship from concept A to concept B to a relationship from con cept A to concept C proceed as follows 1 Select the relationship Respect IT sa Objectiver User Manual 19 Diagram Edition 6 6 4 2 Drag the point connecting the relationship line to B and drop it on the center of C you must see a hollow rectangle around C while you drop the connection point Creating AndOr relationships You create AndOr relationships in the same way you create binary ones 1 Select the type of relationship to create from the Concept Palette Refer to the following list TABLE 2 Types of AndOr relationships Type Father So
58. ars see Figure 57 First wizard window specify the introduction section parameters You can include Objectiver texts in the introduction of your report see Figure 57 for the Purpose Scope References Overview Click the radio button to select the corresponding text The section Definitions acronyms and abbrevia tions will be automatically generated It contains the definition of the concepts of the Object model Entities Agents N Ary Associations Events An option permits to exclude from this section all undefined concepts concepts with no Def property value Second wizard window choose a strategy for visiting the goal model Choose a strategy for visiting the goal model see Figure 58 This will define the goal section structure see Figure 59 On next step you will be able to modify the structure of the goal section For the first option Use default structure a section will be created for each goal which is a root text of the goal model The second option will reuse a previous structure This option is only available if a requirements document was previously generated for the selected package Select the third option to allow Objectiver to reuse the diagrams that already exist Select the rule Create a section for each diagram to propose section entry for each diagram Select the rule Create a section for each shared goal to propose section entry for each shares Goal meaning a Goal refining
59. atient records easily retrieved 9 a ony of Welcome goal reference referenced goal refinement goal D Patient s waiting time minimised Q9 Accompanying people kept informed oy Patient s allocated bed known shared goal Patient s allocated bed known Ul Patient s location displayed on request O Displayed patient s location read FIGURE 59 The third window of the Wizard 16 3 You can fold and unfold the structure to display the following information goals goal references shared goals Before launching the generation you can reorganise the structure by dragging and dropping items according to constraints defined in your model A context menu item Create section is available for a goal appearing inside the tree but not on root text goals Selecting this action will create a new section at the end of the tree The action Join referred section is available on goal references and can be used to swap the goal reference with the goal to which it refers Updating the generated report inside the Report Editor As any report see Section 13 5 the report generated according to the structure pre viously defined in the generation wizard see Figure 59 can be edited So before publishing a report you can modify diagrams and texts You can also add and remove documents Figure 60 shows a screenshot of the generated report 84 Objectiver User Manual Respect IT sa Requiremen
60. ation Generated documents consist of two types of information references to documents that exist elsewhere in the model documents generated on purpose to produce the report such as titles glossaries etc or even text documents you insert yourself in the generated report The update of a document in your model is automatically reflected in all the reports that contain the document However if your report contains generated items these are not automatically updated when the model evolves For example if you have generated a responsibility diagram for an agent and if you add a new responsibility to this agent somewhere in the model this agent s responsibility diagram will not be updated You need to regenerate the diagram and discard the previous version Sim ilarly if you have generated a glossary modifications to the underlying model can cause your glossary to become obsolete Similarly if you edit a report that was previously generated all these modifications might get lost if you regenerate the report It in fact depends on the documents you modify in the report if you modify a document such as a goal diagram that is part of the model the modifications are preserved since the document is not the result of a generation process if you modify a document that was generated along with a report any modifica tion to this document shall get lost when the same report is generated once again The report title is stored in su
61. ay concept properties Note When you select a concept for deletion from the model see Section 7 6 Objectiver displays its attributes in the property editor so that you can check whether it s the right concept to delete 9 2 Displaying the Property Editor Lock this editor on the currently The Property Editor is located under the explorer see Figure 1 You can also activate floating property editors Choose Tools gt Property Editor Figure 24 shows a screenshot of the property editor once activated close button displayed con Documents cept tab pane Concept neighbor hood tab pane User defined attributes Domlnvar Predefined tab pane ormalDominvar properties tab pane DomainAttribute FIGURE 24 Floating Property Editor for an entity 9 3 The lock icon shown in Figure 24 prevents the property editor from refreshing its window when you select another concept Displaying a concept properties There are two ways for displaying a concept properties in the property editor from the explorer or from any document window Respect IT sa Objectiver User Manual 39 Concept Property Edition 9 3 1 From the explorer In the explorer select the concept for which you want to edit the properties Objec tiver shows the current properties for the selected concept in the property editor Figure 24 shows an example of ent
62. can convert an OO Text document into a TXT document As a TXT document offers less formatting capabilities be prepared to loose not only formatting informa tion but also some contents that TXT documents are unable to support 1 Select the OO Text document you want to convert in the explorer 2 Right click the entry and select Convert to Text in the explorer see Figure 46 Concept Index 9 g 1 Source Documents interview Stakeholder 1 9 GB 2 Requirements Model B Goal Main goals g Goal oa Goal1 Refinement God g Goal2 X cu Cir X Goa2 Refinement Gog cov g Goal a e a Goal3 Refinement God 8 paste amp Goal4 g GoalS Goal g Goal amp Goals FIGURE 46 Converting an OO Text document into TXT Text document is converted into the TXT document In particular no 3 Limitation In this release 3 0 only the text contained into the OO style is applied on the converted text see Figure 47 Concept Index 9 IN 1 Source Documents Interview Stakeholder 1 interview Stakeholder 2 9 Q2 Requirements Model El Goal Main goals Goall Goal2 Goal Goal4 GoalS Goal Goal Goal e 3 Reports e Goall Refinement Goal2 a Goal2 Refinement Goal e a Goal3 Refinement Goal Interview Stakeholder 2 Context of the interview Stakeholder Role in the organisation
63. cept Objectiver User Manual Respect IT sa Web based Documentation Text uonejueuinoop peseq qeM ev SAYNDIS document Graphical document umeuog uj Mojag paquasap aie sjeoh asayy esuvysisse jeoipaw ejenbapy eAenpy E suoja M Jo ANNE spal Burouasayay 9 sweubeig Hulsuasayay 3 up eto 5v pur Seed 10 810 pundo ue apiaoid 0j si uonesiuefio anues Aauafiawa mau ay Woy payaadxe sjeof ulew ay jo aug J TI I ejdoed Buifueduioooe pue syuened 107 aseyjam eundo oS ET See mE ufr C ad Aq sydeouo fl ETIMETET ENTER aouejsisse jeoipaui ayenbapy E oui dax ajdoad Dur amp ueduioa2 v uuojul day aidoad Huduedwosoy E em pes peso spend X pul jdesuoD EN F y pe 40 axe jeundo TE spo Da Uo padeidsip uoneao syuaned all Je sjuaned 40 euejjeAs eundo roo eAneasiumipe payg fl sueibeig f 5 vis pote t supe en ptio syiaunaoq fj ajdoad BulAuedwoosse pue sjuaijed 104 auejjam ewido STEEL Te a quay xapurduaqyreu5 soet 2 eere papes peus XM M its t Concept details Concepts by type Concept Index Index of documents 63 Objectiver User Manual Respect IT sa Web based Documentation 12 5 12 5 1 12 5 2 12 5 3 12 5 4 12 5 5 12 5 6 Panning Click and drag your mouse while holding the Alt key down Working with diagrams SV
64. cess 2 22 e ee eee eee eee eee eens 90 171 Types OF Tevie Was er et e blat auc tn ne Bie tach o p ll que CERRAR RP ED T HS 90 17 2 Organizing a model review 90 17 2 4 Sequential VIEWS eee tro reset i Sy eee ev een dre I A a Sp eR ERES 91 17 2 2 Parallelireyiews s ee RR nte eee 91 17 2 3 Combined schema ie ee teet e rt epa nep tere tea 92 17 2 4 Review mode comparison rer 93 14 3 TOOL Supports 4 54 se Reed RE RERUM tot Ene eH REDI CORREOS RE E s 93 17 3 1 Review based on the Web based documentation ss 93 17 3 2 Review based on Objectiver reports eese tne 93 17 3 3 Review based on the Reviewer Edition of Objectiver 17 4 Review InstQuctionis s ete Weber re pen autre DS LR P DTE Ere Reviewing operations IST Generating review files i n etcetera Gd ano Ma Deed ete Ra he torn da 18 2 Merging Teview files Lu oom steh pce bebe bebe E ORA eB NI Oei o ted tes 98 18 3 Handling notes ec rrr EDU eso T EG tn ans OE Bie hearths pr VP 98 PART G Team working with Objectiver Enterprise Edition only 99 19 0 Control units ru ree 100 LOU OVELVIeW 2 s Suse bci SINUS D P PARC e d ted ding Ss reete be Brak ibe yita Pe e ue 100 URNAM Dm 100 19 1 2 Representation of control units ire 100 LOS General r les ie eripiet i ee e ga
65. ch a document This means that you ll need to Respect IT sa Objectiver User Manual 75 Requirements Documents 14 3 14 3 1 update the report title each time the report is generated if you re not happy with the default title that the report is given by the tool Wizard based report generation Section 14 1 presents some way of building your requirements documents while retaining full control of the report structure and content Section 14 2 explains how this process can be partially automated by having the tool generate specific parts of the final report In this section we ll see the use of a wizard that takes the generation to a new level of automation While the use of a wizard offers less flexibility it pro vides a much faster way to generate reports since most of the tasks are left to the responsibility of the tool The wizard available in the current release of the tool supports the generation of requirements documents whose structure is derived from the one proposed by the IEEE 830 specification Please refer to Section 3 7 Requirements document gener ation of the Kaos Tutorial document pp 36 38 This document is available from the Objectiver web site It is also installed on your hard drive when you run the Objectiver installer Here re some additional details about the generation process e Part of the introduction section the Purpose Scope References and Overview sections are generated from dedicat
66. ctiver User Manual Respect IT sa Requirements Document Generator Pro and Enterprise Edition only 16 0 Requirements Document Generator Pro and Enterprise Edition only 16 1 16 2 16 2 1 16 2 2 16 2 3 About the Requirements Document Generator The Requirements Document Generator produces structured requirements docu ments from the model It generates a report Section 13 0 It uses templates to query the model and help you define the order in which documents are assembled The report that is generated should be considered as a draft of your final require ments document Please refer to Section 14 3 to understand what the generated requirements docu ment consists of The following section explains how to use the wizard to generate the report Section 16 2 optionally make modifications Section 16 3 and finally publish it by exporting it to one of the RTF or PDF file formats Section 16 4 Using the wizard to generate the Requirements Document Opening the Req Doc Generator 1 Select a package in the explorer The goal section of the report that shall be gen erated includes the goals present in this package and subpackages All goals refining the package goals are also included Note You can select another package later on step 3 2 Choose Tools Req Doc Generator 3 Enter the report name Change the generated document destination package if needed and click OK The first window of the wizard appe
67. d since the last time the user has loaded it Notation In the following sections status of control units will be represented with a couple of values for instance Blue Plain Operating control units This section specifies two groups of operations on control units The first group consists of specific operations on control units They are listed in the following table TABLE 9 19 3 1 Operations on control units Name Effect transform into control unit convert a package into a control unit transform into package convert a control unit into a package edit lock a control unit for edition commit save changes made on the control units and release the lock refresh load the latest saved version of the control units The second group of operations consists of operations existing in the Objectiver environment that impact the management of control units namely opening a project saving a project and quitting They address the following topics what are the status of packages and control units when you open a project how does the Save project command behave regarding control units what happens when a user who has edited some control units quits or close the project Creating a control unit Control units are created by transforming packages as follows 1 Right click the package you want to convert into a control unit 104 Objectiver User Manual Respect
68. dding an existing document 1 Open the context menu and select the Insert item to add a document before the selected document in the report or the Append item to add a document to the end of the report OR Click the Insert a document or the Append a document button in the report editor toolbar 2 Select the type of document you want to add You can add a diagram a text or even another report A dialog box containing the list of all documents of the selected type appears 3 Select the document you want to add 66 Objectiver User Manual Respect IT sa Report Edition and Publication You can also add a document by selecting it in the explorer and dragging it to the report Drop it where you want to insert it A screenshot of a report is shown Figure 52 HB Fst Report 2k0 222 HID 2 E Optimal welfare for patients and accompanying people 2 fel Optimal welfare for patients and accompanying people ipeum gt rex 9 Remove from report H Report Print First Report X Patient it ELITR FIGURE 52 Report Editor 13 4 2 Creating a new document Open the context menu and select the Insert New item to add a new document before the selected document in the report or the Append New item to add a new document to the end of the report OR Click the Insert a new document or the Append a new document button in the report editor toolbar Select the type of document you want to create Yo
69. diagrams vi Open report after publication FIGURE 54 Report generation options 3 If you want to change the default Output file or the Output format click on the a button A file dialog box called Select output file appears Figure 55 4 Locate the folder where you want report files to be stored or create a folder if needed Select a type for your document either RTF or OO Text Type a name for your document Click Select output file Choose a template for your Word or OpenOffice document The dot or ott tem plates provided with Objectiver can be found either under the Objectiver installa tion directory by default C Program Files Objectiver3 0 templates or installed in the directories used by MS Word or OpenOffice for templates the location of those directories depends on your operating system if you have checked this option during the tool installation set up oN Oo OC diagrams in your document gif format or a vectorial representation of your diagram emf format 9 Check the Output format option to include either a bitmap representation of 10 If you select the option Output diagrams as files diagrams that appear in the report will also be output as individual files in a directory structure correspond ing to the package tree of your project 11 To publish the files click OK It can take a significant amount of time to com plete Respect IT sa Objectiver User Manual
70. directory MyProject Model MyProject ob MyProject ob bak MyProject 01 ob bak Web 1 0 index html Web 1 1 index html Reports MyProject rtf MyProject pdf References ReferencedDocumentl doc ReferencedDocument2 doc Note about Proxy server If you use a Proxy server you will have to fill in the connection preferences in order to include images coming from the web in your reports Proceed as follows 1 Choose Tools Preferences 2 Select the Connection tab see Figure 11 3 Fill in the address and port fields Respect IT sa Objectiver User Manual 37 Text Edition CR Use HTTP Proxy yj Proxy Host Name 47216 5 14 Proxy Port Number 8000 FIGURE 23 Preferences concerning the connections 38 Objectiver User Manual Respect IT sa Concept Property Edition 9 0 Concept Property Edition 9 1 About the Property Editor The property editor allows you to describe concepts by specifying values for predefined Properties to specify the names and types of user defined Attributes that all concept instances will have to visualize the concept neighborhood that is the concepts to which the selected concept is related to visualize the documents in which the selected concept appears These functionalities are explained in sections 9 4 to 9 8 Section 9 2 describes how the property editor can be activated and closed Section 9 3 explains how to displ
71. e 45 PART C Working with Open Office 47 11 0 Editing texts with Open Office 48 IXI About Open Office Text sii ere eee eser Oe epe RA TU Ree e er Vierte de 48 11 2 Create open clone delete and rename an OO Text document 48 11 3 Save an OO Text document 2 oses ner eer eR Grade CU POE bie A eer RI CE RES 49 11 4 Importing and exporting an OO Text document 50 11 5 Inserting a reference into an OO Text document 51 11 6 Creating a new concept from an OO Text document 53 11 7 Searching for a concept reference in an OO Text document 54 11 8 Locating a concept from an OO Text document 55 11 9 Renaming Conceptos vines eee a ER NU eR TESTE Aeon RO AP NY IB P 55 11 10 Converting a TXT document into an OO Text document 57 11 11 Converting an OO Text document into a TXT document 59 Respect IT sa Objectiver User Manual 3 Introduction PART D Reporting functions 60 12 0 13 0 Web based Documentation 61 12 1 About Web based documentation 61 12 2 Publishing documentation
72. e current dia gram Recommendation Apply Tree or Clan layout strategy to Goal diagrams Apply Spring layout strategy to Operation and Responsibility diagrams Notes You can change the layout spacing in Objectiver s Preferences see Section 6 11 Like all operations that make changes to the project applying a layout can be undone Copy a diagram to the clipboard To insert a diagram bitmap in the clipboard right click in the diagram background and select Copy to clipboard You can then paste it in another program Respect IT sa Objectiver User Manual 23 Diagram Edition 6 10 6 10 1 6 10 2 6 10 3 6 11 Deleting and removing items Deleting a diagram Deleting a diagram from a specification can be done from the explorer See Section 7 6 2 Removing concepts from a diagram 1 Select the concept to remove 2 Click Remove from diagram from the diagram editor toolbar Figure 8 or Press Delete The concept and all attached relationships disappear from the dia gram 3 If the concept does not appear on any other diagram or text Objectiver suggests you deleting it from the project see Figure 15 Notes 1 This operation only removes concepts from a diagram not from the model Deleting a concept from the model is explained in the next section 2 Relationships removed without their linked concept s are not really removed but simply hidden To display them again use the context men
73. ed text documents Part of the introduction section the Definitions acronyms and abbreviations sections are generated from the object model An index of all objects is created along with their definitions The overall description section User Requirements is generated by exploring the goal model from the high level goals to the low level goals and requirements according to a built in strategy for running through the model see below The system requirements section is also automatically generated Each subsec tion contains a list of requirements for some agent in the model In the following sections we ll explain how to prepare and generate requirements document using the wizard Providing content for the Introduction The introduction contains the following subsections for which you ll have to pro vide the content 1 1 Document purpose 1 2 system purpose 1 3 Definitions acronyms and abbreviations 1 4 References 1 5 Overview Proceed as follows to define the subsections 1 1 1 2 1 4 and 1 5 1 Optional Create a package named for instance ReqDocIntro 2 For each subsection create a text document see Section 14 2 1 in the package created in step 1 and name the document according to what it will contain e g Document purpose 3 Provide the content for each of these sections 76 Objectiver User Manual Respect IT sa Requirements Documents 14 3 2 14 3 3 14 3 4 For subsection 1 3
74. eds Inventory B1 Optimal Welfare for patients and accompanying people B2 Efficient medical follow up B3 Quality of welcome B4 Patient s allocated bed known B5 Medical secrecy protected d amp ds Lo Lo Lo Lo L9 NO N Table of figures Figure 1 Optimal Welfare for patients and accompanying people 3 Figure 2 Efficient medical follow p LN RS ANAN sedente ra costes et Figure 3 Quality ob welioms uon HL HARI REESE TENOR Figure 4 Patient s allocated bed known ag Figure 5 Medical secrecy protected 11 Glossary write free intro text for Glossary Page Sec J At Ln Co REC ree ExT OVE English UK gt FIGURE 62 Report exported in Word 16 4 3 Using your own template You can use predefined templates for producing requirements documents that com ply with your comapny standards for instance We provide a generic template to this aim in the distribution You can customise it to fit your needs or use any other doc file In the foillowing we explain how to use our generic template Directory C Program Files Objectiver templates contains a file named RD tem plate doc You can use it as a genric template to produce your own requirements document as follows 1 Customise the RD template doc file to meet your needs add your company logo etc 1 Generate your requirements as usual in a file let s say RD content rtf 2 Copy the RD template doc file to a file let s say MyReqsDoc
75. el proceed as follows Respect IT sa Objectiver User Manual 29 Exploring the model 1 In the explorer select the concept s you want to delete Alternatively Alt click the concept in a document text or diagram The last selected concept is dis played in the property editor 2 Choose Edit gt Delete or Press Ctrl Shift Delete and then confirm the deletion OR 1 In the explorer Right click the concept s you want to delete to open the context menu 2 In the popup window select Delete and then confirm the deletion Important notes All references to the concept in text documents are replaced by a string Deleted lt Concept name gt It allows you to rework the text easily When a concept is deleted all attached binary relationships are deleted 7 6 2 Deleting a document In order to delete a document from the model proceed as follows 1 In the explorer select the document you want to delete 2 Choose Edit gt Delete or Press Ctrl Shift Delete and then confirm the deletion 3 Objectiver asks whether you want to delete all the concepts that are no longer referenced that is the concepts which do no longer appear in any diagram or text Figure 15 shows a screenshot of this dialog By default all items are selected for deletion You can deselect items by clicking their name while holding the Ctrl key down i Delete the unreferenced concepts x 7 Displayed patient s location read Q Ef
76. eporting important messages to you LA 2 2 Q File format Objectiver projects are saved as OB files which are compressed XML files Objectiver User Manual Respect IT sa console memory recovery button a query editor Overview a floating property editor gt Be A E E E E AR E eunjoid eqojB eu HL 3unboi S S CE SSS fas the default property editor ga uopesojy pag E E uoneaois peg lt gt jag lt a OYUAAOUYUP gt iuri pego pi waned Burdueduioase pue squared 40 24843A et ag ajsjuasouxurr AUT pago waed PE aouejsisse jeaipaui ayenbapy aoupjsissp i jul dax ajdoad Hulduedypaeg O 9 papaw ayenbapy Du day ajdoacbsem f eduoaa 7 sjdaouo2 uo BD uoneounuapi paned yono 7 uoneaolg pag RS MI uonsaffuoo a91A18S oN Er graphical editor text editor OJO eAmeagstumupe 348l21J3 p SAngejsiumupe menu f sydaauos ye ypas abeyoeg fly nba uo pe e dsip uoneao Swale pe pue sjualjed 10 aJ6j aA mene sweubeig 43410 din mojoj jeoipatu patoa i uogeuejdxg 35414 explorer gt i epeptTee es eeux 9 6 amp daH SsMopu i pawnoog sool Main W3 ai Objectiver User Manual Respect IT sa PART A Working with Objectiver Respect IT sa Project level Operations 3 0 Project level Operations 3 1 About projects Objectiver is used to build requirements models Each Objectiver project contains exactly one
77. er User Manual Respect IT sa Editing texts with Open Office d File Edit View Tools Document ooo Help a Bae wlee aj e n er Sd Concept Index 1 Source Documents j 2 Requirements Model gj 3 Reports FIGURE 32 Creating an Open Office Text document 11 3 Save an OO Text document When you choose File gt Save Project Objectiver saves all the concepts in your model and all documents including OO Text documents in a unique ob file on disk see Section 3 4 The OO Text windows which contain your OO Text documents have also a Save function named OO Text Save in the following This OO Text Save function must be used to tell Objectiver that the current OO Text document you are editing is ready to be saved in the ob file Please note that the OO Text Save function has no impact on the ob file So a typical and recommended session would be like the following one 5 Objectiver save interview Stakeholder EST 3 we File Edit View Insert Format Table Tools Window Hep a Bae Baan EF Times New Roman 3 Open Office Text save 1 Interview Stakeholder 1 1 1 Context of the interview Location Date Stakeholder Role in the organisation 1 2 Interview summary nes ne mwmecTeeo G o W 9 x mug Page1 1 Defaut French France INSRT STD __ 8 BB FD e
78. er always displays in plain text the name of the packages and control units locked by the user R11 The explorer always displays in dimmed text the name of the packages and control units not locked by the user that is locked by another user or free to edit R12 The tip appearing on top of a control unit entry in the explorer provides the name of the user who has locked the control unit The following color codes are used to inform the user about the status of a control unit TABLE 7 Color codes for control units Color code Status of the control unit Blue package Green control unit edited by the user or free for edition Orange control unit edited by another user Purple control unit that has been saved by another user since the last time the user has loaded it Respect IT sa Objectiver User Manual 103 Control units The following table combines the text and color attributes for control units TABLE 8 19 3 Status of the control unit Status Plain Dim Blue package belonging to a control package belonging to a control unit you have locked for edi unit nobody or another user has tion locked for edition Green control unit you have locked control unit nobody has locked for for edition edition Orange NA control unit locked by another user Purple NA control unit that has been or is still being locked by another user and that has been save
79. erator Pro and Enterprise Edition only PART F Reviewing Objectiver Models eo ana Enterprise Edition only Respect IT sa Objectiver User Manual 89 Review process 17 0 Review process 17 1 17 2 The topics covered by this section are the following ones e Section 17 1 presents the different techniques that can be used during the review phase of a Requirements Analysis project e Section 17 2 focuses on a particular kind of review the reviews of an objectiver model and describes different ways to organize them e Section 17 3 explains how Objectiver can be used to support the review process e Section 17 4 prompts the analyst to provide the reviewers with adequate infor mation for the review A structure and contents for a review instructions guide is proposed Types of review There are three core activities for an Objectiver analyst collecting information from all stakeholders by interviewing them by reading documentation by observing systems etc analyzing the information collected and building a requirements model deriving a requirements document from the model In most cases adopting a black box approach for these core activities is not the best way to proceed as earlier feedback from the stakeholders may be profitable for get ting a higher quality result Feedback from the stakeholders is classically achieved by means of reviews With Objectiver stakeholders have the oppo
80. ers by selecting them 2 From the style combo box select the style you want to apply to the paragraph Objectiver then applies it to the current paragraph 8 3 3 Defining styles for concept and document references Character styles can be defined for concept references For instance you can apply this feature to your text documents so that references to goals appear in blue and Respect IT sa Objectiver User Manual 33 Text Edition x Style name Emphasis v Times New Roman i ho v J Bold J talic Underline Color Sample Text Always apply this style to the selected references Agent um Assignment AssignmentToAgent gt Association Cause z Concerns Conflict zx FIGURE 20 Style manager Selection List references to actions appear in red Concepts having the same type must share the same style Once a style is associated with a concept type it will automatically be applied to all references to concepts of that type in all documents Proceed as fol lows to define a character style for concept references 1 In the current character style text field enter a new name for the character style you want to create We recommend you give the same name to the style as to the concept type for instance Goal 2 Press Return Objectiver then asks you whether you want to create a new style Figure 19 Click New 3 Click Styles Objectiver then opens the style manager Fig
81. et rid of all the or i icons from the diagram by selecting the corresponding button located at the top right of the diagram window Respect IT sa Objectiver User Manual 65 Report Edition and Publication 13 0 Report Edition and Publication 13 1 About Reports A report consists of a sequence of documents All document types can be inserted in a report The report editor enables you to define the sequence and edit the docu ments composing the report Reports can be composed manually by taking documents from the model they can also be generated automatically from the explorer by using the context menu by using the document generator using templates see Section 15 0 or by using the requirements document generator see Section 16 0 This section describes manually composed reports and how to use the report pub lisher in order to create printable reports see Section 13 7 13 2 Basic Operations Refer to Section 4 0 to learn how to create open delete or rename a report 13 3 Report Editor toolbar Insert append a document Figure 51 shows the buttons of the toolbar which are associated with a report editor Functions activated from the toolbar can also be activated from the context menu see Figure 52 amp A X Iv FA ShowHide all titles Collapse expand all documents Remove a document Insert append a new document 13 4 13 4 1 FIGURE 51 Report Editor toolbar Adding a document to a report A
82. eu on el eue Eur ds 14 Help reer rere eee eee 15 51 Displaying the Help window ose he IRE UL E TRIER e keds Peete as 15 9 2 Using the context help ssr eee heo ue te e T ou Ibe Bee ee des 15 5 3 Senda problem description or a suggestion to support 15 PART B Basic Modelling functions 16 6 0 7 0 Diagram Edition e 17 6 1 About diagrams cuis seo x OR bI ERA RENI REX eR Neid ns 17 6 2 B sic Operations ee xac Re Res cs as Rte Mace e eR edere Re qe Rp 17 63 Diagram Editortoolbat ene cde demain RE IDA ER EC OUR RES ES D eh eee 17 64 About the concept palette i ehe rr Re EE ae ER DH IRA GR TREE Dees teg 17 6 5 Diagram activity CyDe i i ote oppo eI RI pue Ru T ES SOS SIS E lat eee on 18 6 6 Creating ems Loue VIRO hn es pe dre ath PP asec ta ahd bel aT ded 18 GOL Greating Concepts eee OH MIR OR EAE GIA OEE Sad 18 6 6 2 Creating binary relationships 19 6 6 3 Changing relationship arguments ss 19 6 6 4 Creating AndOr relationships sise 20 6 6 5 Creating HyperText Picture and Documentation Links 21 6 6 6 Refine a goal in a new diagram eese nennen ennt 21 6 75 Addingitems v So Se Ep EXE REO Ede ew SER OU IRE one OSEE eid 22 6 7 1 Adding references to existing concepts into a diagram eee 22 6 7 2 Auto completion mode esee ete
83. ewing the model A typical structure for this review manual is as follows 1 Review management 1 1 Scope of the review 1 2 Reviewers 1 3 Review process 1 4 Deadline 1 5 Support 2 Technical aspects 2 1 Model structure 2 3 Review activities 2 2 Annotation style The next paragraphs below explain the contents of each section in detail Scope of the review This section aims at specifying which part of the model is to be reviewed For large projects it can be interesting to split reviews in different phases for instance the current and the next system and or the user requirements and the system requirements Reviewers This section provides the list of people appointed to the review The list for instance could provide the following information for each reviewer name organization position contact information Review process This section describes how the review is organized sequential in parallel or a mix of both It specifies a partial or total order for the reviewers to be involved If some reviewers have to review only parts of the model this section specifies it Deadline This section provides information on when the review is expected to be achieved for each reviewer or set of reviewers Support This section describes how reviewers can find support during the review and where they can find additional documentation e at the tool level e g how to annotate a diagram at the methodological level e g what is
84. ficient medical follow up Refinement Adequate medical assistance L7 Medical secrecy protected 4 Medical secrecy protected Conflict Accompanying people kept informed Q Optimal welfare for patients and accompanying people Refinement Efficient medical follow up Q Patient s allocated bed known Refinement Displayed patient s location read L7 Patient s waiting time minimised Delete none FIGURE 15 Delete the unreferenced concepts 7 7 Renaming documents and concepts In order to rename documents and concepts proceed as follows 1 Display the property editor see Section 9 2 2 Select the document or concept in the explorer see Section 7 2 the attribute names and values for the document or concept are displayed in the property edi tor 3 Modify the value of the Name in the Properties tab by typing the new document or concept name in the corresponding field Objectiver User Manual Respect IT sa Exploring the model 7 8 7 9 Or more easily 1 In the explorer Right click on the concept you want to rename to open the con text menu 2 In the popup window select Rename 3 Type the new document or concept name Modifying the type of a concept In order to modify the type of a concept proceed as follows 1 Right click a concept in the explorer or a document and choose Modify type from the context menu 2 In the dialog that pops up select the new concept type from the list
85. first reviewer transfers the reviewed model to the second reviewer in the list and so on The last reviewer sends the reviewed model with the contribution of all reviewers back to the analyst Parallel reviews In this mode the analyst dispatches the model to review to all reviewers simultane ously Each reviewer reviews the model independently and returns the reviewed Respect IT sa Objectiver User Manual 91 Review process model to the analyst The analyst merges the contribution of each reviewer Figure 65 shows a parallel review organized by one analyst with 5 reviewers 4 3 5 Q Analyst 2 e Reviewer 1 FIGURE 65 Parallel review 17 2 3 Combined schema The sequential and parallel review modes can be combined in many ways The fol lowing combination could represent for instance a multi site review The analyst dispatches the model to review on each site Reviewers of each site reviews the model in turn and then sends a site consolidated reviewed model back to the ana lyst The analyst has then only to consolidate as many reviews as there are sites instead of as there are reviewers in the parallel review mode Figure 66 shows for Q Analyst Reviewer FIGURE 66 Combined review mode instance a review located on 3 different sites each site having 6 reviewers The ana lyst has to merge 3 reviews instead of 18 as with the parallel mode 92 Objectiver User Manual Respect IT sa Review proces
86. follows 1 Select Tools Preferences 2 Select the wished orientation for the palette by unfolding the combo box named Palette orientation in the General tab Diagram activity type When you create a diagram you can choose an activity type The activity name shall later be shown near the diagram name in the tool If the lockedType property is checked you may only create and add in this diagram concepts and relationships belonging to the associated activity Section 6 4 provides the list of the diagram activity types If the lockedType property is unchecked you may introduce any type of concept or relationship in the diagram Each time you modify a diagram Objectiver changes the activity type according to the diagram content Creating Items Creating concepts 1 In the Concept palette select the type of concept 2 Click inside the diagram window where you want to create a concept 3 Give the concept a meaningful name 4 Press Return Notes You can lock the editor in a mode allowing you to create several con cepts of the same type in a row Shift click or click twice on an item of the Con cept palette to enter the multi concept creation mode e You can exit this mode by clicking on the palette button once again e Please refer to the section concerning the notation in the Guide to using the web generated doc manual for a description of the different types of concepts availa ble An alternative way of creating
87. ges are containers for any type of concepts including documents Sub packages can also be created offering a tree structure of containers which the analyst can use to best suit his needs FIGURE 13 Model View 26 Objectiver User Manual Respect IT sa Exploring the model 7 3 2 Packages are created and visible in the package view Inside a package all the ele ments must have a different name Concept Index stands for the root text package and cannot be renamed To create a new package use the context menu Right click the package in which you want to create a sub package You can move the documents and the concepts between packages using drag and drop When you create a document it is added in the package currently selected in the explorer if you don t change the destination package see Figure 4 When you create a concept in a document the concept is created in the same package as the document When you add concepts already existing in the model to a document those con cepts remain in their current packages they are never moved by the add opera tion Therefore if the document belongs to another package than the one containing the added concepts the document will refer to concepts that are out side the package which contains it This property impacts the package import export as explained below see Section 7 3 2 Note Multiple selection is possible in the explorer press the Shift or Ctrl Ke
88. he tool displays also the owner s name of the review notes Figure 67 shows a typical review process in which the analyst and the reviewer cooperate to produce a consolidated review Section 18 0 explains how to perform each step of this process Review instructions Reviewers working on their own need some guidance specially if it is the first time they are reviewing a model with Objectiver Therefore we recommend to brief them on the methodology on what is expected from them and how they can review the model with the tool The best way of doing it is probably whenever possible to organize a meeting with the reviewers to explain them the review objectives and to expose them the tool Respect IT sa 94 Review process Model 0b orv to review performs performs Objectiver model reviewerN reviewer1 ob n ob performs Reviewer i ob Full edition m Orv performs orv orv Last reviewer in loop Next reviewer in loop FIGURE 67 Review process with Objectiver Respect IT sa Objectiver User Manual 95 Review process Even if such a meeting is organized it is a good practice to provide the reviewers with a document they can refer at any time during the review and which contains all the information they need This document can be appended to the model as a text document so that reviewers can refer to it at any time while revi
89. he user who locks this control unit quits Objectiver changes the status of this control unit from Orange Dim to Green Dim 2 Control units with the Purple Dim status are unaffected by the fact that other users quit How to use control units The teamwork facility of Objectiver is powerful but can become tricky if not man aged in an appropriate way Here follows advices based on past experiments you might consider interesting if you plan to use those facilities for the first time 1 Choose a person responsible for defining the control units even if any user can define control units in the current release The project leader is a good candidate for it 2 Keep it simple 3 Define a teamwork strategy There is no strategy that works for any project in any company Here follows a strategy which has been used successfully in the past At the beginning of the project 1 Define a package Model that will contain the final shared model Structure the package according to your needs by defining a hierarchy of empty packages 2 Export the Model package in a Model opk file see Section 7 3 2 108 Objectiver User Manual Respect IT sa Control units 3 Define a package Workspace username to contain the workspace dedicated to a specific user Import the Model opk file to replicate your standard model struc ture in the workspace 4 Define as many workspace packages as they are users having to wo
90. ick on the Locate button to find the concept in the explorer tool Name Find Goal Patient records easily retrieved Find Gosl Patient s allocated bed known Requirement Patient s location di Goal Patient s waiting tine a Refresh results ex Refresh results and enable edition Query button Query status bar Result set field for editable Locate button results set FIGURE 30 An example of query with editable results set 10 1 4 Editing the result of a query 1 Perform your query as explained in Section 10 1 3 2 Enable edition of the result set by clicking Refresh results and enable edi tion 3 Click the buttons to edit the corresponding value 10 2 Solving duplicates 10 2 1 Finding duplicate concepts To find concepts with name similarity proceed as follows 1 Choose Tools gt Duplicate solver to open the solver see Figure 31 2 Adjust the name similarity threshold by moving the horizontal slider a value of 100 means exact matching decreasing the slider value weakens the matching cri terion It is advised to start looking for duplicates by providing a high slider value 100 or close to 100 then to decrease the value progressively The lower the slider value is the more Objectiver will spend time to retrieve potential duplicates 3 Click Find to display the result Respect IT sa Objectiver User Manual 45 Analysing the model and solving modeling issues Pro amp Enterprise Editi
91. ity properties 9 3 2 From any document text or diagram window In a document click a concept to display its properties in the property editor Notes If you Alt click a concept the concept is also located in the concept index When you select a concept all the property editors you did not lock see Figure 24 display the properties of this concept 9 4 Predefined properties Predefined properties associated with each concept type are described in the follow ing table TABLE 5 Predefined concept properties Concept Relationship type Property name Object Name Def DomInvar FormalDomInvar Issue DomainAttrib ute Agent same attributes as Object plus Load Category Event same attributes as Object plus Frequency DomProp Name Def Issue Category FormalDef Objective same attributes as DomProp plus Pattern Priority Obstacle same attributes as DomProp plus Likelihood Criticality Operation Name Def DomPre DomPost FormalDomPre FormalDom Post Issue Cause Delay Link Multiplicity Role RoleOrder Resolution ResolutionType Conflict BoundaryCondition Binary Association Type Directed Label Client Role Client Multiplicity Supplier Role Supplier Multiplicity Ordered Control Monitoring WhichAtt OperationalizationActionSon FormalReqPost FormalReqTrig FormalReqPre ReqPost ReqTrig ReqTrig ReqPre Refinement Pattern AltName Complete a Object is a generic name for Agents Entities Events and N Ary Associations Those co
92. iver prompts you to give a name attribute type An attribute type is created and appears in the explorer 3 Specify the Domain Integer Real String or Enumeration 4 If needed give the values of the enumeration 5 Click Apply and close the attribute type editor 42 Objectiver User Manual Respect IT sa Concept Property Edition From now on the type you have defined is added to the list of types you can assign to an attribute see Section 9 5 1 9 7 Displaying the concept neighborhood Choose a relationship type from the combo box menu to display the concepts partic ipating to these relationships with the selected concept Figure 28 shows the con cepts related to the Bed concept via the Linked To relationship Note The concept names can be modified from here El Property Editor att o Bed Entity s Neighborhood Di dco Linked To Link ed Location ed Allocation FIGURE 28 Linked To relationship 9 8 Displaying the documents in which a concept appears Display the documents in which the selected concept appears by clicking on the document tab pane Note You can open any of these documents by clicking on the Open button Respect IT sa Objectiver User Manual 43 Analysing the model and solving modeling issues Pro amp Enterprise Edition 10 0 Analysing the model and solving modeling issues Pro amp Enterprise Edition only 10 1 Query
93. jectiver text editor TXT editor makes it possible to edit such documents 8 2 Basic Operations Refer to Section 4 0 to learn how to create open clone delete or rename a diagram Figure 17 shows you a new TXT document Package View c Loo lof ofthe main goals expected from the new emergency service organisation is to provide an Optimal welfare for patients and accompanying people E Optimal welfare for patient To achieve this goal the following subgoals have been identified Efficient medical follow u Quality of Welcome Style pane Text pane These qoals are described below Concept creation pane Create concept button Make reference button FIGURE 17 A text document A TXT editor consists of three panes a style pane showing all standard and user defined character styles that can be applied to sequences of characters atext pane where text and references to concepts can be entered freely e a concept creation pane allowing you to create concepts and references from the text editor 8 3 Working with character styles There are three standard predefined text styles bold italic and underlined You can also define your own styles and apply them to any sequence of characters to paragraphs or to references to concepts or documents Figure 18 shows the character style pane The following sections describe how to create a new character s
94. l by creating a custom report by hand using a template to guide the generation using the report generation wizard Whatever method that is used in the end a report is produced that can be exported to either the RTF or the ODT file format the file format used for OO Text docu ments see Section 13 0 Creating custom reports by hand Objectiver provides you with the means to create your requirements document man ually Using this method you can insert any existing Objectiver document diagram or text in the report being built You can reorder the items as needed by dragging the component name You can create new documents directly from the report edi tor Finally you can modify the content of all component documents including dia grams part of a report Many of the functions of the text and diagram editors are also available when the document appears in a report Beware that the original doc ument is also modified since Objectiver by default does not create copies of the documents that are inserted into reports You re directly editing the one and only copy of the document That also means that if any document gets updated later on any report including it shall automatically be updated Notice also that you can open the component document with the text or diagram editor at the same time as a report editor is open You ll then get several views on the same document synchronizing on each other Opening a component document in
95. lationship creation refer to Section 6 6 2 In the concept palette select the DocumentationLink relationship from under the Other Concepts Pal ette Concepts having HyperTextLink PictureLink or DocumentReference concepts associated with them through documentation links are displayed in bold in the Objectiver explorer see Section 7 0 The hyperlinks and Objectiver documents linked to those concepts can be opened directly from the explorer by right clicking the concept and selecting Open document in the context menu Refine a goal in a new diagram 1 In a diagram right click a goal and select Refine in new diagram in the con text menu 2 Objectiver prompts you to specify the name and package of the new diagram The operation removes the refinement subtree of the selected goal from the diagram including all other concepts and relationships such as operationalization responsibility and operationalisation linked to it in the diagram recreate it in a new diagram introduces cross references between the created diagram and the source dia gram by means of two DocumentReference concepts linked to the selected goal one document reference per diagram pointing to the other Model elements from the subtree connected to other elements in the source diagram including the selected goal remains in the source diagram This operation available on any goal offers a powerful way to restructure quickly a complex goal hierarchy a
96. lowing save your changes and release the lock see Section 19 3 4 save the project you need the lock on Concept Index see Section 19 3 8 and Section 19 3 9 quit the project without saving it in that case all your changes made since your last save operation will be lost see Section 19 3 10 Notes 1 It can take a few seconds to be notified about a status change in a control unit 2 Control units that have the Orange Dim or Purple Dim status can be locked by you as well This feature shall only be used to recover from crashes or to acquire locks from people having forgotten to release them Acquiring locks in those conditions implies actually to steal the lock to another user and shall only be used if no other way can be found Committing a control unit Committing a control unit means saving the changes made on all the edited control units and release the lock on this one A control unit can only be committed if you have a lock on it see Section 19 3 3 To commit a control unit Right click the control unit you want to commit and select Control unit gt Commit Objectiver then saves all the edited control units and releases the lock on only that control unit Objectiver informs you that you have released the lock on the control unit by changing its status from Green Plain to Green Dim f other users are editing the same project as you Objectiver notifies them about the fact that a new versio
97. mong different diagram in order to produce clear requirement documents Respect IT sa Objectiver User Manual 21 Diagram Edition 6 7 Adding items 6 7 1 Adding references to existing concepts into a diagram 1 Click Add existing from the diagram editor group of buttons in the toolbar Figure 8 A popup window appears with a list of all the concepts that can be inserted in this diagram see for instance Figure 10 Select an item EU x Auto completing filter expression List of existing concepts _ Case sensitive v Search all words v Regular expression y Accompanying people kept informed Package with all concepts Other concepts Q Accompanying people kept informed Refinement Patient s allocated bed known y Adequate medical assistance Package with all concepts Other concepts ni Bed Package with all concepts Other concepts Bed Allocation Package with all concepts Other concepts aBed Allocation Link lt UnknownRole gt Bed aBed Allocation Link lt UnknownRole gt Patient E Bed Allocation DB Package with all concepts Other concepts b gt Bed Allocation DB Input Display Room Number Bed Allocation Manager Package with all concepts Other concepts Q aBed Allocation Manager Performance Display Room Number Bed Location Package with all concepts Other concepts o aBed Location Link lt UnknownRole gt Bed aBed Location Link lt UnknownRole gt Room Number
98. n cept types inherit the properties defined on Objects b Objective is a generic name for Goals Requirements Expectations SoftGoals 40 Objectiver User Manual Respect IT sa Concept Property Edition 9 4 1 9 4 2 Setting values for concept properties In the property tab pane enter a value in the Value field If the value type is String by clicking on at the right of the value field you activate a popup window that will allow you to input text in a more convenient way Setting strengthened conditions for actions To display the properties for Strengthened conditions in the Property Editor click the edge part of an Operationalization relationship between the action and the operationalization circle PTE A to Display Room Number Operationaization Properties Documents Name StrengthenedPostinformalDet StrengthenedPreFormalDet Patient s location displayed on request StrengthenedTriggerFormalDef StrengthenedPostFormalDef StrengthenedPreinformalDef StrengthenedTriggerInformalDet Bed Allocation DB gt EL M Ll click this edge to dis FIGURE 25 9 5 9 5 1 play strengthened con Strengthened conditions ditions put on the ope rationalization Working with user defined attributes Attributes can only be added to Objects To create or delete a user defined attribute display the attributes tab pane by click ing on it Figure 26
99. n a single document The generation of requirements documents can however be automated in different ways By systematically documenting diagrams Automatic generation of diagram reports Automatic generation of package reports Automatic generation of some of the requirements document sec tions Here s a description of each possibility Respect IT sa 73 Requirements Documents 14 2 1 Diagram explanation texts Un It s a recommended practice that a text be associated with each diagram in your model When such explanation texts exist Objectiver includes them automatically within the generated reports wherever the corresponding diagrams are inserted Objectiver helps you do it systematically as follows 1 Right click the name of the diagram you want to explain in the Explorer 2 Select Explain from the context menu and select whether you want to explain the diagram with a simple Text or with an OO Text document Objectiver then creates a text or an OO text document the name of which is the diagram name followed by text explanation Pjated 3 Open the document to enter the explanation text You can copy paste concept ref erences from the diagram or from the Explorer see Section 7 5 2 Note The diagram and explanation text documents are associated This association is recognized when you build a diagram report Section 14 2 2 when you build package reports Section 14 2 3 and also when using
100. n of the control units is available by changing the status of the control units in their environment the status changes from Orange Dim to Purple Dim Note It can take a few seconds to be notified about a status change in a control unit Refreshing control units Refreshing control units allows you to get access to the latest available version of control units that have been edited by another user A control unit can only be refreshed if its current status is Purple Dim Click the Refresh button in the toolbar i to refresh control units Objectiver will save all your changes to the disk prior to refresh the model 106 Objectiver User Manual Respect IT sa Control units 19 3 6 19 3 7 19 3 8 Objectiver then replaces in memory the current version of all the control units to be refreshed it has with the ones it gets by reading the ocu files associated with the control units Objectiver will also inform the user about the status of the refreshed control units Two cases are possible the control units are still locked by another user In this case Objectiver changes the control units status from Purple Dim to Orange Dim the control units are no longer locked by another user In this case Objec tiver changes the control units status from Purple Dim to Green Dim Editing the contents of control units Once you have acquired a lock on a control unit see Section 19 3 3 you can cha
101. n s Color Assignment Objective Agent only one pink son Operationalization Requirement Operation blue Expectation Refinement Objective Objective DomProp yellow O Refinement Obstacle Obstacle orange Responsibility Requirement Agent only one red son a Objective is a generic name for Goals Requirements Expectations SoftGoals 2 Drag the mouse starting from the Son concept to the Father concept If you want to add a concept to an existing AndOr relationship drag the mouse from the Son concept to the circle representing the relationship Recommendation The Father concept is typically drawn above the Son concepts An alternative and quick way of creating refinements with many sons makes use of the context menu as follows 1 Select the Son concepts click and drag to select several concepts 2 Right Shift click on the Father concept to get the context menu 3 Select Refine with selection Notes 1 Goal refinement alternatives can be named Or refinements can be named by giving a value to the Alt Name attribute of the refinement in the property editor the name is displayed on top of the refinement symbol 2 Goal refinements can be marked as complete And refinements can be marked as being complete by setting the Complete check box in the property editor for the And refinement A check mark v is displayed in the middle of the refinement symbol 20 Objectiver User Manual Respect IT sa Diagram Edition 6 6
102. nce Search aims at locating a concept ref erence in an OO Text document Renaming a concept A concept can be directly renamed in an OO Text editor by renaming any reference to it appearing in the OO Text document 1 Search the concept reference corresponding to the concept who want to rename 2 Right click on it and select Objectiver rename concept in the popup menu Respect IT sa Objectiver User Manual 55 Editing texts with Open Office File Edit View Insert Format Table Tools Window Help Etes v mS S e D 6 ES E 7 x Times New Roman Ele eeo p A Insert Concept Reference Locate Concept in model Alignment Line Spacing Rename Concept Create Concept icept in document he interview Character Paragraph Page Case Characters Numbering Bullets Fields Edit Paragraph Style 3 fal FIGURE 40 Looking for other occurrences in the document Intervie Erea File Edit View Insert Format Table Tools Window Help x a Buo eean v E xse v9 es SETS 3 gt E default x Times New Roman lz 12 x 8 U E El er 1 CX 1 2 ag we gg wepln Ug vg pxgsta M F 1 Interview Ider 1 4 1 1 Context of the interview m Location Z Goal 2 Requirements Model 8 Toal a7 Goal8 2 Requirements Model FIGURE 41
103. new concepts makes use of the context menu as fol lows 1 Right click in the diagram 2 Select New then the concept type you want to create 18 Objectiver User Manual Respect IT sa Diagram Edition 6 6 2 Creating binary relationships Prior to creating a binary relationship between two concepts make sure that both concepts are part of the current diagram 1 In the Concept palette select the type of binary relationship you want to create Refer to the following list TABLE 1 6 6 3 Types of binary relationships Type From To Binary Association Object Object Cause Event Operation Concerns Objective Object Conflict Objective DomProp Objective DomProp Control Agent Object Input Object Operation IsA Object Object Link N Ary Association Object Monitoring Agent Object Obstruction Obstacle Objective Output Operation Object Performance Agent Operation Resolution Objective Obstacle Restoration Operation Requirement a Object is a generic name for Agents Entities Events and N Ary Associations b Objective is a generic name for Goals Requirements Expectations SoftGoals 2 In the diagram drag the mouse from the origin concept to the destination concept in accordance with the previous table Note If the destination concept you want to connect to is present in the diagram but not currently visible in the editor window you c
104. nge its contents by creating adding moving or deleting documents in the control unit by changing the documents contents In particular you can create a new package only at a location belonging to a control unit you have locked you can delete a package only if the package belongs to a control unit you have locked Section 19 1 3 explains the rules in force to display and modify concepts in docu ments you have locked Opening a project This section aims at describing precisely which is the status of each package and control unit when a user loads a project When you open a project Objectiver sets the package and control unit status as fol lows 1 All control units and the Concept Index are set to Green Dim or Orange Dim if somebody else is editing it you do not own the lock on the control units 2 All packages are set recursively to Blue Dim 3 However the status of the Concept Index is set to Green Plain if the project doesn t contain any control unit and nobody else is editing it This is true in par ticular if you are the first user to open the project In that case each package in the Concept Index is set to Blue Plain recursively all along the hierarchy of package subpackages Saving a project When a user invokes the File gt Save Project command the tool proceeds as fol lows 1 Objectiver saves the ob file 2 Objectiver saves all the control units on which the user owns the lock
105. of another reviewer about how the model is structured etc request for change e g add a goal rename a concept etc advices e g refer to additional information etc In any case constructive notes are generally the most appreciated Just annotating the model by qualifying some concepts as wrong bad etc will not help the analyst very much to improve the model A good note not only raises an issue but also suggests a solution or hints to a solution for it Respect IT sa Objectiver User Manual 97 Reviewing operations 18 0 Reviewing operations 18 1 18 2 18 3 This section describes the operations an analyst has to do with the tool in order to implement a review mainly how to generate a review file and how to merge reviews from several reviewers Description of how the reviewers can annotate models is provided in the user man ual dedicated to reviewers Reviewing an Objectiver model Generating a review file Choose File Create Review file A file dialog window pops up and prompts you to enter a filename A file with the orv extension is created Merging review files After having loaded the file to review import each review file like this 1 Choose File gt Import Review 2 Select the directory where your review file resides 3 Double click the file corresponding to your review Notes are placed in the Review Notes package and are added inside diagrams
106. olute file path for example E Objectiver adocument doc or asterix pro jets Objectiver adocument doc Respect IT sa Objectiver User Manual 35 Text Edition e a relative file path for example adocument doc Figure 22 shows a text and a property editor with an hypertext link Properties Name f ame cediti ddress http Avwew cediti bel Eel FOOD oOo One of the main goals expected fram the new emergency service organisation is to provide an Optimal welfare for patients and accompanying people a FIGURE 22 Hypertext Link Notes 1 The table below shows how pictures are inserted inside generated documents TABLE 3 Picture links inside generated documents Objectiver document Web doc see Section 12 0 RTF PDF doc see Section 13 0 URL The picture is displayed when the page is The picture is inserted in the doc at generation loaded The browser retrieves the picture time It can require the specification of an http by following the URL proxy to allow the tool to retrieve the picture Absolute path The picture is displayed when the page is The picture is inserted in the doc at generation loaded The browser retrieves the picture time by following the path Relative path The picture is displayed when the page is The picture is inserted in the doc at generation loaded The browser retrieves the picture time from the
107. ome specificities for Word 16 4 1 Word Templates You can also assign a template explicitly to your document once it is opened as fol lows in Word 97 2003 and earlier versions as follows 1 Choose Tools Templates and Add Ins see Figure 61 2 Check the box in front of the adapted dot template if any is displayed else click the Add button and select the template A default dot template adapted to your specific MS Word release can be found under the Objectiver installation directory by default C Program Files Objectiver templates Respect IT sa Objectiver User Manual 85 Requirements Document Generator Pro and Enterprise Edition only Templates and Add ins d 2 xl Document template Burton Projets Graillite Documentationt Attach IV Automatically update document styles Global templates and add ins Checked items are currently loaded 2 Add Ei Full path Organizer FIGURE 61 Templates and Add ins MS Word Figure 62 shows a screenshot of a report exported to the RTF file format and mak ing use of the word2002 EN template You can also assign a template explicitly to your document once it is opened as fol lows in Word 2007 as follows 1 Select the Office button in Word and click the Word options button at the bottom of the window 2 Select the Add In entry select Templates in the combo box at the bottom of the dialog window and click GoTo The
108. on Second concep Goal Optimal welfare with sub Goals Othe EL Optimal welfare with sub Goals Texts _ amp Bed Location Package with all concepts Ot XQ Bed Allocation Package with all concepts O Options Considered duplicate 0 Ignore duplicate documents i FIGURE 31 Duplicate solver 46 Objectiver User Manual Respect IT sa PART C Working with Open Office Respect IT sa Editing texts with Open Office 11 0 Editing texts with Open orc Bee About Open Office Texts Section 8 0 has described how to use the Objectiver Text TXT editor to explain diagrams and to write simple text documents The TXT editor has the great benefit of being light and easy to use but has the major drawback of limited formatting capabilities as for instance in the following situations For some specific complex diagram explanations you may want to insert tables diagrams images etc in the explanations e Some requirements analyses need to be based on some sophisticated input docu ment to which you want to trace your model The TXT component does not provide any support or very poor support on those matters That s precisely why Objectiver has been seamlessly interfaced with the Open Office Text Editor OO Text editor The OO Text editor allows you to do a o the following write simple texts as before insert images and objects compose drawings define
109. oncept properties ose sm nn a AR PRU HOC HERD ER Ee DC EIE Y 39 9 5 1 Fromthe explorf r iacet eee eie REPRE ERR TERRE XE Ferr 40 9 3 2 From any document text or diagram window 40 94 Predefined properties S os od eyed Abe hg Gs NU E I ead cone RIMS Mor ste 40 9 4 1 Setting values for concept properties ner 41 9 4 2 Setting strengthened conditions for actions ss 41 9 5 Working with user defined attributes 41 9 5 1 Creating an dttrib le cesa cie iet e EE Vere SESA EE Aide siisi 41 9 52 Deleting an Attributes rime Tan a a EERE EE ATA A 42 9 6 Attribute type editors ss veo so vp Gey Ure UP OU ERWERBEN S 42 9 6 1 Displaying the attribute type editor siennes 42 9 62 Creating a new attribute type is 9 7 Displaying the concept neighborhood 43 9 8 Displaying the documents in which a concept appears 43 Analysing the model and solving modeling issues Pro amp Enterprise Edition only 44 101 Query L Check TOOL errei hs eee dete Be aes artes Marea ge Ke Send ne Eee The 44 10 1 1 About the query amp Check Tool rennes 44 10 1 2 Opening the Query amp Check window eese 44 10 1 3 How to perform queries ss 44 10 1 4 Editing the result of a query inner 45 102 Solving duplicates tiee head Fhe eee Ra Ren RR d SP Te men LL 45 10 2 1 Finding duplicate concepts eene tette tne nennen nenne enn
110. probably the most efficient 90 Objectiver User Manual Respect IT sa Review process 17 2 1 17 2 2 way of validating a model as the feedback is immediate and a consensus can be negotiated on the spot For larger organisations and larger projects it is more difficult to review models interactively for the following reasons itis not easy to schedule a common meeting which will put all reviewers together several meetings should be planned in order to browse the model entirely all stakeholders are probably not involved in all aspects of the model Attending all these meetings can be perceived as a lost of time Therefore in those situations it is probably more efficient to adopt another style of review by distributing the model to review to all reviewers and ask them to review the model individually There are typically two ways of organizing such reviews sequentially or in parallel Sequential reviews In this mode a total order is defined on the set of reviewers so that there is a first reviewer a second reviewer and a last reviewer Each reviewer will review the model in turn Each reviewer will benefit from the reviews of the other reviewers preceding him her in the list Figure 64 illustrates a sequential review with 5 4 A 3 Q Analyst 3 D Reviewer za 1 FIGURE 64 Sequential review reviewers The analyst sends the model to the first reviewer who reviews the model Then the
111. r 10 Objectiver User Manual Respect IT sa Project level Operations Open E Qualit Is09000 D Mod leKAOS 2003 06 11 Mod lekA0s 2003 06 26 E GrailLite Tests TestCases Format 0 3 2 Ly Mod lekaos 2003 07 04 emergency folderTest 3 Mod lekAOS 0b QualitylSO z t Add Delete Alias Qualiiso Set File Name ModBleKAOS xml Files of Type All Files X om a FIGURE 2 Creating a shortcut to a file 2 Rename the file in which your project resides the one with the ob extension by using the appropriate operating system command 3 9 Exiting Objectiver Choose File gt Quit If the current project has not been saved since your last modifications Objectiver asks you whether you want to save the project before terminating the application Respect IT sa Objectiver User Manual 11 Document level Operations 4 0 Document level Operations 4 1 About documents An Objectiver project consists of a set of interrelated concepts and documents There are three kinds of documents diagrams texts and reports Diagrams repre sent different concepts and the relationships among them Text documents contain textual information with references to the concepts in the model Styles can be used like in most general purpose text processors Reports are composite documents combining texts diagrams and reports They are either created man
112. r iconize the top windows to check whether the pop up is not hidden behind Note You can store large OO Text documents in your model with no consequence at start time When Objectiver opens a ob file it parses your model and loads it into memory OO Text documents are not parsed by the tool at loading time So large OO Text documents will just inflate the size of your ob file Importing and exporting an OO Text document OO Text documents can be imported from outside Objectiver to an Objectiver model and conversely can be exported from an Objectiver model to an Open Office file Import To import an OO Text document from outside Objectiver proceed as fol lows 1 In the Objectiver explorer select the folder in which you want to import the OO Text file 2 Right click the folder name and select Import OO Text file from the pop up menu see Figure 34 3 With the File interaction dialog select the OO Text file you want to import a file with a OO Text suffix and click Open Objectiver then copies the file into a new Objectiver OO Text document Note The Import function does not delete the source file on disk It physically cop ies the OO file into the ob file Export To export an OO Text document outside Objectiver proceed as follows 1 In the Objectiver explorer select the OO Text document you want to export 2 Right click on it and select Export see Figure 35 3 Give a name for the OO Text file you want to save
113. re corresponding views selecting one element in the left hand side list will imply the selection of the cor responding concept s in the right hand side list and conversely For instance in Figure 14 the selection of the diagram optimal welfare with sub Goals in the left Respect IT sa Objectiver User Manual 27 Exploring the model Solve the dependancies xj Concepts inside the package having a dependancy outside Concepts outside the package referenced from inside of it of it 7 Accompanying people kept informed Goal Optimal welfare for patients and accompanying ped Accompanying people kept informed Refinement Pati Goal Optimal welfare with sub Goals L7 Adequate medical assistance Bed Allocation DB Input Display Room Number o Bed Optimal welfare for patients and accompanying people T K aBed Link lt UnknownRole gt Bed Allocation Patient s location displayed on request 4 aBed Link lt UnknownRole gt Bed Location Bed Allocation o Bed Allocation DB FIGURE 14 7 4 7 5 Solve the dependencies hand side column implies the selection of three concepts in the right hand side column 2 Include dangling concepts in the package to be exported Or Exclude from the package to be exported relationships or documents that con tain dangling concepts In that case choose the package where you wish to move out the concepts relationships or documents 3
114. requirements model The whole project is stored in one file the name of which ends with the ob exten sion Only one project can be opened at the same time for editing Modifications to the project are written back to file when the project is saved 3 2 Creating a new project Choose File gt New Project to start a new project If a project is open and has been modified Objectiver will ask you to save the cur rent project before resetting the tool You cannot indeed have two projects open at the same time Note a new project is automatically created when you start Objectiver 3 3 Opening an existing project 1 Choose File Open Project If a project is currently being open and modified Objectiver will ask you to save it before resetting the tool 2 Select the directory where your project file resides 3 Double click the file corresponding to your project When you open a project a lock is set to prevent other users from editing the same file at the same time If someone attempts to open a locked project file Objectiver opens it in a read only mode and the icon beside Concept Index is orange Note If the project contains at least one control unit see Section 19 0 Control units Objectiver doesn t lock the project and opens it in a read only mode To edit it right click Concept Index and select Control Unit gt Edit in the context menu To edit a locked project file 1 Right click Concept Index and select Control Unit gt
115. rk together 5 Convert the Model package and all the workspace packages into control units Figure 70 shows an example of project structure containing one shared model and two worskspaces Package View Model View FIGURE 70 Project structure with shared model and worskspaces In large organisations each workspace can be shared by different users Control units can be defined lower in the hierarchy to identify the contribution of each user in the workspace if needed Similarly for the shared model it is possible to assign parts of the model to differ ent users For instance the Object model could be put under the responsibility of one user and the Goal model under the responsibility of another one During the project Each user works inside his her workspace He she is strongly encouraged to refer as often and as early as possible the shared model in which he she has full reference access but no permission for changing it It is therefore a good idea to start building a first shared model with the set of concepts that will be used by most of the users at the very beginning of the project At synchronization steps At regular time intervals the user responsible for the shared model reviews the con tribution of each user in his her workspace He she can decide to move concepts from the user workspace to the shared model Respect IT sa Objectiver User Manual 109 Control units
116. rticular the SVG diagrams Internet Explorer version 6 and above with Adobe SVG Viewer only available on Windows Firefox version 2 and above available on most OSes Respect IT sa Objectiver User Manual 61 Web based Documentation 12 3 12 4 3 Locate the folder where you want the output files to be stored It is recommended to create documentation in its own folder that is not to store other files in that folder 4 Click Select folder 5 To set a title at the html document with additional information about the version appended check the corresponding options and type a title 6 To choose the diagram and the text document that shall be displayed when open ing the web documentation check the corresponding options and choose the doc uments 7 To limit the maximal scaling value of generated diagrams check that option 8 When the checkbox Delete previous generation in output folder is checked Objectiver deletes the files resulting of a previous generation 9 To launch the html publisher click OK It can take a significant amount of time to complete Browsing through the web formatted documentation 1 Go to the directory containing the specification documentation 2 Double click on the file named index html to open it with your favourite browser Figure 49 shows a screenshot of the web documentation as displayed in Internet Explorer Note To be able to visualize diagrams the SVG plug in must
117. rtunity of review ing three kinds of results reviewing interview summaries It could be interesting for the stakeholders to review the summaries of the interviews they attend to check that their point of view has been correctly and completely understood by the analyst reviewing the model Experience with Objectiver has shown that reviewing the model is worth the value for the stakeholders for the following reasons validating models is generally more efficient than reading a large textual document model reviews by the stakeholders contribute to make them more involved in the project conflicts between stakeholders can pop up more easily be more focused and more easily solved because they are clearly objectified A lot of time can be lost by the analyst while going around in circles if conflicts are not addressed in an adequate way reviewing the requirements document The requirements document written once the requirements model has been validated results from a large consensus The modifications to bring on the draft to review are generally very localized and do not question large sections of the document This section explains how to achieve the model reviews with Objectiver Organizing a model review For small organizations and small projects reviews can be organized interactively A review meeting is planned and all reviewers attend it The analyst browses the model and collects feedback from the reviewers This is
118. s 17 2 4 Review mode comparison The following table sums up some benefits and drawbacks of each mode TABLE 6 17 3 17 3 1 17 3 2 17 3 3 Review mode comparison sequential parallel combined Rapidity of feedback Independence of reviews Analyst s workload to consolidate reviews Tool support Review based on the Web based documentation The Web based documentation generated by Objectiver can be used by each reviewer as a support for their reviews Once the model to review is ready the ana lyst generates the Web documentation see Section 12 0 zip the files of which the Web documentation consists into one archive and dispatches the archive to the reviewer s according to the reviewing mode selected see Section 17 2 As the Web documentation is read only the reviewer has to write his her comments in a separate file With the archive the analyst can therefore also prepare and send a review file that will contain the review notes from the reviewer Depending on the review mode the reviewer having filled in his her comments has next to send the review file back to the analyst or to the next reviewer Alternatively the Web documentation and review file can be made available to the reviewers on a Web site intranet or extranet This way of proceeding becomes quickly cumbersome for large projects On the one hand one has
119. s an existing concept name you can click the Refer ence button to replace the text with a reference to the existing concept Auto completion You can use the auto completion mode to easily add an existing concept to a text document see Figure 21 Type the first letters of the concept to which you want to refer Press Ctrl Space bar Choose the concept to insert from the list that pops up Se 0 N a Package with all concepts Other concepts Bed Allocation Package with all concepts Other concepts Bed Allocation DB Package with all concepts Other concepts Bed Allocation Manager FIGURE 21 8 5 8 6 Auto completion inside a text document Note see also Section 7 5 2 for adding references to a document Finding missing concept reference From the context menu choose Find missing concept references to search in the text for words that match existing concept names and propose to replace them by references to the related concepts Hypertext and Picture Link Creating hypertext or picture links in texts is done in the same way as concept crea tion refer to Section 8 4 In the concept palette you can select HypertextLink or PictureLink from under the Other Concepts Palette Then click the concept in order to fill in the address property in the property editor with one of the following a Web link URL for example http www objectiver com adocument doc an abs
120. search is done in the selected frame on the visible concepts Locating a concept in a diagram 1 Find the diagrams in which the concept you are looking for appears see Section 12 5 3 2 Click on the diagram name in the list of Referencing diagrams returned by Objectiver The diagram appears and a big circle shows the position of the con cept in the diagram see for instance Figure 50 64 Objectiver User Manual Respect IT sa Web based Documentation Y Optimal welfare for patients and accompanying people 2I E Help Optimal welfare for patients and accompanying people FIGURE 50 Concept location Move the cursor on the circle to make the circle disappear 12 5 7 Printing a diagram To print the content of the graphical frame displaying the diagram in the documen tation proceed as follows 1 Display the diagram in the graphical frame 2 If needed resize the diagram to fit the size of the graphical frame see Section 12 5 2 3 Click the print this diagram icon the button is located in the upper right corner of the diagram This causes the Print dialog of your browser to pop up 12 5 8 Show informal defs and issues in diagrams When a issue or an definition have been specified on some concepts the diagram sports a or a i icon respectively near the concept If you position the mouse cur sor over such an icon the underlying information issue for instance is displayed You get however g
121. sponsibility diagrams 15 4 2 Flat Glossary text 15 4 3 Goal model diagram 15 4 4 Issue text list 15 4 5 Whole specification report ne 79 15 4 6 Diagram Document dependency diagram 79 15 4 7 Goal diagram dependency diagram 79 15 5 Updating the generated documents 80 Requirements Document Generator Pro and Enterprise Edition only 81 16 1 About the Requirements Document Generator 81 16 2 Using the wizard to generate the Requirements Document 81 16 2 1 Opening the Req Doc Generator 81 16 2 2 First wizard window specify the introduction section parameters 81 16 2 3 Second wizard window choose a strategy for visiting the goal model 81 16 2 4 The third window of the Wizard define the goal section structure 83 16 3 Updating the generated report inside the Report Editor 84 16 4 Publishing your requirements document in RTF or ODT 85 Objectiver User Manual Respect IT sa Introduction 16 4 1 Word Templates 5 16 4 2 Word macros 86 16 4 3 Using your own template sa 87 16 4 4 Inserting Objectiver diagrams manually in a Word document 88 PART F Reviewing Objectiver Models Pro and Enterprise Edition only 89 17 0 18 0 Review pro
122. tables introduce formulas in elementary spreadsheets Additionally the editor contains a spelling checker function that can be configured to automatically check your text on the fly Within Objectiver you can edit several OO Text documents simultaneously Each OO Text document will be edited in a separated window Those windows will work independently from the main Objectiver window They are not pinned to the Objec tiver document frame That allows you to use several screens for your best conven ience for instance you can display an Objectiver diagram in one screen and its explanation in another screen This section does not intend to explain in detail how the OO Text editor works Please refer to the on line Open Office help coming with the editor to learn how to use the advanced editor features Create open clone delete and rename an OO Text document As OO Text documents are just Objectiver documents you can create open clone delete and rename an OO Text document as any other Objectiver document simple text diagram Figure 32 shows how to initiate the creation of a new document Please refer to Section 4 0 to learn how to do those basic operations Note Creating or opening the first OO Text document during a session will require some delay rather longer than for the next creation and opening operations The reason is that an Open Office server needs to be started and connected to Objectiver 48 Objectiv
123. the con trol unit The following two sections explain how control units are stored in Objectiver and general principles that are worth knowing in order to work with control units in an appropriate way Representation of control units In Objectiver each control unit is stored in a separate file When the user defines a control unit on top of a package Objectiver splits the ob file containing the whole original project into two pieces 100 Objectiver User Manual Respect IT sa Control units a ocu file containing all the information related to the control unit a ob file containing all the remaining information Figure 68 shows an example of a project containing two packages A and B which the user wants to convert into control units Section 19 3 1 and Section 19 3 2 explain how to convert a package into a control unit and conversely The figure shows the state before and after the transformation Package View Mod hy Package View a A amp Concept Index A B m amp Concept Index B PKG CU PR RIRE Package Properties j heic C ame name 4 T ea N a al EJ 4 ocu 4 ocu lock B ocu B ocu lock Project ob Sty nutus are D Project ob Project ob loc k FIGURE 68 Project with and without Control Units 19 1 3 When a user opens an Objectiver project
124. the documents tab 3 Click the Open button on the line corresponding to the OO Text document in which you want to look after the concept reference see Figure 39 Objectiver opens the document and goes to the first location of the concept it meets from the beginning of the document To retrieve other locations of the concept in the OO Text document please use the Search function described below From the search function In the OO Text document in which you want to locate a concept reference proceed as follows 1 Right click and select Objectiver Search concept in document see Figure 40 2 Type the concept name fully or only the first characters of it and select the con cept from the auto completion pop up list see Figure 41 Objectiver locates the first occurrence of a reference to the concept in the document You can navigate from a reference to the next or the previous one to the first or the last one by using the corresponding buttons gt lt gt gt see Figure 42 54 Objectiver User Manual Respect IT sa Editing texts with Open Office Sg 4 Operation Model Sd 2 Object Model Sg 3 Agent Responsibility Model QB 5 Other Concepts A ver NE KG viodels 9 Gi Goal Model p File Edit View Insert Format Table Tools Window Help Conflict E 3 z lice Selected concepta t8 Ho sa amp s ve amp e4 9 c eu A
125. to read the model and the notes of other reviewers in separate documents On the other hand one has to put review notes at the right place in the review file Review based on Objectiver reports Another way to support a review consists for the analyst in generating from the model a MS Word report containing all the needed information Each reviewer annotates the report in turn according to the selected review mode Annotating Objectiver diagrams in Word can be a bit tricky Moreover the analyst has to map the review notes back in the model Review based on the Reviewer Edition of Objectiver The Reviewer Edition of Objectiver aims at helping the analyst and the reviewers to cooperate efficiently during reviews On the one hand unlike the Web documenta tion the reviewer can annotate the diagrams directly while browsing the model Review sessions during which a group of reviewers annotate the model together can be organized On the other hand the tool automates the merge of the review notes coming from different reviewers in the model itself The Reviewer Edition is a limited version of Objectiver It allows a reviewer to annotate an Objectiver model by adding review notes and by linking those notes to elements of the model The reviewer is not allowed to modify the model contents Respect IT sa Objectiver User Manual 93 17 4 The analyst can import review notes one by one in his her model and visualize them all on the spot T
126. ts Document Generator Pro and Enterprise Edition only E Pana ails document _ i Z Requirements document TitleFreeText RS Requirements documentntroduction Heading Section zr La El Requirements documentintroduction Glossary_Section _ E Requirements document Overall description HeadingText fe Requirements document Overall description_HeadingFreelntroText a Requirements document Overall Description Medical secrecy protected_ExplanationHeading ns document Overall Description Medical secrecy protected ExplanationDiagramSection E Requirements document Overall Description Optimal Welfare for patients and accompanying people Optimal Welfare for patients and accompanying people Quality of welcome Efficient medical follow up Rz ee zem 0 92 JlSlozvoauooo Booo 4 oso ose ok FIGURE 60 Generated report Warning If you later modify your model some of your reports may no longer be up to date In that case you ll have to regenerate your reports and all manual modifi cations that you have made for the first version of the report might need to be repeated on the newly generated report In a future release of Objectiver support will be provided to automatically keep generated reports in sync with the model content 16 4 Publishing your requirements document in RTF or ODT Paz Section 13 7 explains how Objectiver allows you to export reports in the RTF or ODT file format Here follow s
127. tyle and how to apply it to a paragraph in a text pane or to references to concepts or documents Objectiver User Manual Respect IT sa Text Edition Note In this release character styles are local to your model You cannot reuse the character styles you define in another model ie Style standard current menu ed character style name bution styles FIGURE 18 Character style pane 8 3 4 Defining a new character style 1 In the style name field enter a new name for the character style you want to cre ate for instance Emphasis 2 Press Return Objectiver asks you whether you want to create a new style see Figure 19 Click New ompanying people ALO 00700000 0 77 A B3 E One ofthe main goals Wil stre creation LLL x vide an Optimal welfare for patients and z ai Do you wish to create a new style named Emphasis To achieve this goal the fc Efficient medical follow new EE ee eka new erame carea FIGURE 19 Style creation 3 Click Styles Objectiver then opens the style manager see Figure 20 4 Enter values for style parameters including font size variation bold italic underline color 5 Click Apply 8 3 2 Applying a style to a paragraph or to a sequence of characters 1 Select the paragraph to which you want to apply a character style by clicking anywhere within the paragraph You can also apply a style to a sequence of char act
128. u Add hidden rela tions Deleting concepts and relationships from the model 1 Select the concept s or relationship s to delete 2 From the context menu choose Delete from model or Press Ctrl Shift Delete and then confirm the deletion You can also use the Explorer to delete elements see Section 7 6 1 Important notes e After deletion from the model all occurrences of the concept are removed from all diagrams and all attached binary relationships are deleted Allreferences to the concept in text documents see Section 8 0 are replaced by a string Deleted lt Concept name gt Set Preferences for the Diagram Editor 1 Choose Tools Preferences 2 Select the Diagram Editor tab see Figure 11 Different options are available on this tab to adjust the diagram editor to your needs Tooltips are defined on each field to help you understand their meaning Objectiver User Manual Respect IT sa Diagram Edition Preferences loc Diagram Editor T Show grid lvi Snap to grid Ivi Show cursor coordinates Default zoom ratio 100 Default width of concepts 140 Layout horizontal spacing 35 Layout vertical spacing 25 Spring layout desired spacing 100 Automatic position of And Or nodes v Show tooltips te FIGURE 11 Preferences concerning the diagram editor Respect IT sa Objectiver User Manual 25 Exploring the model 7 0 Exploring the model
129. u can add a diagram a text or another report 13 5 Handling documents inside the report Unc Reports are managed by Objectiver internally and kept consistent with the rest of the specification If you want to modify a document directly from the report editor you can do it the diagrams and the text documents within a report are editable The report editor pro vides you the same functionalities as the diagram and text editors Unfolding a report entry that refers to an OO Text document see Section 11 0 will start the OO Text editor on the document in a separate window The unfolded entry displays the first text lines of the OO Text document if any and a hypertext link Respect IT sa Objectiver User Manual 67 Report Edition and Publication Con eg cept Index 1 Source Documents emen Stakehoilder 2 Ti Interview Stakeholder1 2 Requirements Model 3 Reports m Interview report document outline uoopsguggscsg g Pwr FF 810 U that allows you to reopen the OO Text document from the unfolded entry see Figure 53 1 interview st ler Fie Edit View Insert Format Table Tools Window Help 2 00 mess TE 6 9 c fad default Times New Roman Iz 12 1 Interview Stakeholder 1 1 4 Context of the interview Location Date Stakeholder Role in the organisation 4 n r IR ZweeToSeo0 G e iu 9 x Page1 2 Default French France INSRT STD
130. u e e a E e CERE RE 112 Respect IT sa Objectiver User Manual 5 Overview 2 0 Overview 2 1 Objectiver components Composants Objectiver Objectiver version 3 0 is made up of a number of components including diagram editor to represent the concepts and their relationships see Section 6 0 an explorer to browse through diagrams text documents and concepts see Section 7 0 e a simple text editor to write simple textual descriptions for instance to write down interview summaries see Section 8 0 simple text editor for instance complex diagram explanations including tables e a rich text editor to write more sophisticated textual descriptions than with the hei figures and images see Section 11 0 property editor to assign values to the predefined attributes of a concept You can create your own attributes see Section 9 0 a query tool to run queries against the current model see Section 10 1 areporting tool suite including a web publisher to create a distributable web version of your model see Section 12 0 areport editor to create composite documents see Section 13 0 areport publisher to export reports in different formats see Section 13 7 adocument generator to generate diagrams texts or reports see Section 15 0 requirements document generation wizard to create an editable version of the requirements document see Section 16 0 e a console used for r
131. ually or auto matically based on predefined templates All documents are stored in the project file They can be manipulated using the Document menu and the Document toolbar This section details the common operations provided to manipulate documents Specific operations for Diagrams are detailed at Section 6 0 operations for Texts at Section 8 0 and operations for Reports at Section 13 0 4 2 Creating a document 1 Click the New Document icon in the toolbar Help Tant oje o FIGURE 3 Create a new document 2 Choose whether you want to create a diagram a text or a report 3 Objectiver prompts you to specify the document name package and type Figure 4 Creating a Document x Name of the Choose package package in which button the document Diagram Type will be created FIGURE 4 Enter the document name 12 Objectiver User Manual Respect IT sa Document level Operations 4 To select the package in which the document will be created click the but ton select a package and click Select Figure 5 The package selected by default is the one currently selected in the explorer choose the destination package Concept Index Other Diagrams Package with all concepts Texts FIGURE 5 Choose the destination package 5 When you create a diagram you can associate an activity type to this one You will learn more about activit
132. ure 20 4 Enter values to style parameters including font size variation bold italic underline color 5 Select the concept type you want to associate a style with e g Goal 6 Transfer your selection in the selection list on the right by clicking on gt 7 Click Apply Note To define a character style for document references instead of concepts select Diagramor Text at step 6 8 4 Creating concepts and adding references to them You can create concepts directly from the text editor Proceed as follows 1 Select the concept name in the text pane type it before if needed 2 There are two different cases f the selection does not match any concept name then by clicking a concept type in the palette Objectiver creates a new concept named after the selected text and inserts a reference to this concept in the text Objectiver User Manual Respect IT sa Text Edition 3 Bed lt Bed Allocation 3 Bed Allocation DB lt lt Bed Allocation Manager Bed Allocation Link LInkno aBed Allocation Link LInkno Bed Allocation DB Input Dis Q aBed Allocation Manager Perf Package View Model View If an item was previously selected in the palette before the text selection was made you can click the New concept button that appears on the bottom of the text editor The button name actually reflects the currently selected palette item If the text selection matche
133. xt editor notepad 3 Change the line containing the flag Xmx and specify the size of the heap you want for instance Xmx1000M allows the tool to require 1 Gb max for the heap size You need to restart Objectiver for this change to take effect 20 2 3 SVG plugin To visualize diagrams in the web generated version of your specifications the SVG plugin must be installed and configured to work with your browser To get and install the plugin please go Adobe s web site at the following address http www adobe com svg and follow the instructions 20 3 Bug Report If a bug report appears click Ignore to skip the error and return to Objectiver Click Save Project As first to be sure not to lose data If you want to send the bug report to support if you use a Proxy server you will have to fill in the connection preferences see Figure 23 112 Objectiver User Manual Respect IT sa Appendix A Additional information Objectiver Bug Report xj at java awt LightweightDispatcher dispatchEvent Container java 3095 at java awt Container dispatchEventlmpl Container java 1609 at java awt Window dispatchEventimpl Vvindow java 1585 at java awt Component dispatchEvent Component java 3439 Stack Trace Write Log File Save Project As Send to support Quit Objectiver FIGURE 71 Bug Report Window Respect IT sa Objectiver User Manual 113
134. y dur ing your selection Import Export package Professional and Enterprise Edition only Import export capabilities enables you to import and export packages between projects Exported packages must be self contained It means that all dependencies of the concepts in the package to be exported on concepts outside of it must be resolved The tool will help you build self contained packages by listing the documents and concepts for which there is a dependency relationship to solve To export a package 1 Right click a package and click Export Package A control Wizard pops up see Figure 14 The left hand side column lists all the relationships that are defined in the package to be exported and that link some concept defined outside the package For instance see Figure 14 it can be an input relationship for which the operation is defined in the package to be exported and the object is defined outside dangling concept all the documents of the package to be exported that contain dangling con cepts that is concepts defined in another package The right hand side column lists all the dangling concepts including documents that are defined outside the package to be exported and that are referred from inside the package For instance continuing the previous example the object which is the input of the operation will appear in the right hand side column The left hand side and the right hand side columns a
135. y type in Section 6 4 and Section 6 5 6 Click OK An editor window opens up 4 3 Opening a document 1 Click the Open Document icon in the toolbar Concept Index 1 Source Documents 2 Requirements Model 3 Reports FIGURE 6 Open an existing document 2 Select the document type A dialog box containing the list of all documents of this type in the project appears 3 Select the document you want to open by clicking on its name in the list You can also use the Auto completion mode to select the document name see Section 6 7 1 4 Click OK or double click the document name Objectiver then loads the docu ment A document can also be opened by double clicking on its name in the explorer see Section 7 4 Respect IT sa Objectiver User Manual 13 Document level Operations 4 4 4 5 4 6 4 7 Saving a document Documents are project components hence they are saved on disk when you save your project Cloning documents 1 In the explorer Right click the document you want to clone 2 Select Clone in the context menu Objectiver prompts you to specify the docu ment name Figure 4 3 Enter the document name and click OK You can also click Clone Document in the toolbar to duplicate the currently selected document If you only want to copy some concepts from a diagram to another refer you to Section 6 7 3 Deleting a document Deleting a document from a specification can be done from

Objectiver User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents